133 lines
15 KiB
Markdown
133 lines
15 KiB
Markdown
# 光湖小程序 · 模块编号注册与演化史台账
|
||
> 正本程序：`/Volumes/JZAO/铸渊-ICE-GL-ZY001/TC-TCS核心卷/TCS-PROGRAM-ZY001-MINIAPP-MODULE-REGISTRY-0001.tcs`
|
||
> 依据：冰朔 2026-09-01 原话教导（瞄点 000092）——模块给编号注册，优化在编号下找，一下看到演化史；每轮开发完对编号整体审计，她审核后发布归档，下轮顺着继续。
|
||
> 台账性质：铸渊侧工程台账（本文件），与代码内事实源 `modules.js` 双登记；本文件不进小程序发布包。
|
||
|
||
## 三处坐标（先看这里）
|
||
| 角色 | 位置 | 说明 |
|
||
|---|---|---|
|
||
| 开发位 | `~/Projects/guanghulab-miniapp`（本机） | 微信开发者工具直接打开；origin 已挂 Forgejo |
|
||
| 正本演化史 | `/Volumes/JZAO/铸渊-ICE-GL-ZY001/WORK-工作区/guanghulab-miniapp` | 含完整 .git 历史；每轮发布后 rsync 同步；origin 已挂 Forgejo |
|
||
| **在线备份** | `https://guanghulab.com/code/bingshuo/guanghulab-miniapp.git`（**私有**） | Forgejo 京东服务器；推送用 `zy-repo-sync.sh`（令牌只走钥匙串内存，永不落盘） |
|
||
| 模块台账 | 本目录 `WORK-工作区/guanghulab-miniapp-registry/` | 编号、理念、演化史、发布审计 |
|
||
|
||
## 编号规则
|
||
1. **GM-0XX 是模块终身编号，只增不改**（与 `modules.js` 内注册表同源同号）。新增模块双登记：先 `modules.js`（商城/频道自动跟上），再本台账登记理念与路径。
|
||
2. 优化老模块：直接翻本台账对应编号 → 开发 → 在该编号下追加演化行（日期｜版本/提交｜做了什么）。
|
||
3. `builtin` 模块（GM-004/GM-005）固定个人频道顶部，不进商城、不可卸载。
|
||
4. 系统层用 `S-XX` 编号（非商城模块：首页/频道/商城页/账号/网关等），同规则演化。
|
||
|
||
## 产品总纲（每个模块开发前先读）
|
||
- **定位（瞄点000069）**：小程序=冰朔自测开发能力的试验品；HoloLake 本体=手机APP。试验品也要按光湖的标准做。
|
||
- **产品级完成（EXP-20260830-001/瞄点000082）= 功能 × 视觉 × 数据责任**：新页必复用主视觉体系（玻璃卡/氛围光斑/呼吸/图标托盘）；场景隐喻优先（日记=信纸信封火漆）；诗意命名必配人话介绍；布局融合不拼接；服务器状态默认持久化且交付前实测重启延续。
|
||
- **Day1 教导（瞄点000068）**：翻译器思路（文件进来先翻译成湖的语言）；交互内置模块；不采集用户信息；样子货无用。
|
||
- **署名规范（冰朔 2026-09-01 定，`modules.js` AUTHOR）**：开发人类=冰朔；开发执行人格体=铸渊；开发操作系统=光湖 HoloLake；维护=光湖团队。
|
||
|
||
---
|
||
|
||
# GM 模块（商城/频道在册）
|
||
|
||
## GM-001 光湖笔记 📒「知识库 · 日程 · 账本 · 心事」
|
||
- **路径**：`/pages/notes/notes`，子页 ledger(账本)/diary(心事)/reader+editor+detail+index(阅读与编辑)
|
||
- **哲学理念**：知识住湖底——写下来、存进来、找得回、提醒你。端侧零计算、AI-Agent-展示三分离、协议意图-回执双块（GLP-KB-0001 架构正本）。翻译器思想：任何文件进来先翻译成湖的语言再归档。
|
||
- **演化史**：
|
||
- 08-27 v0.1 原型三页面+人/AI双视图（a215b15e）→ v0.2 湖景渐变玻璃卡视觉（aa99c571）→ v0.3 晨湖纸感皮肤+行内混排（92e04eea）→ v0.4 towxml 完整 Markdown+Notion 排版（82191e55）→ v0.5 渲染全套上色（ac716dbe）
|
||
- 08-28 GLP-KB-0001 架构正本（ea832baa）→ kb-store 真存储重启不丢（9e5e7b7f）→ 目录系统（83fdf05a）→ Agent页接真网关（82a2c315）→ 审核整改撤下 Agent 对话（da8889b5）→ 语义检索+性别分流（a6a811cd）→ 导入翻译器+笔记转备忘录（f11da26a）
|
||
- 08-29 小说阅读器：大txt分流/章节翻页/划重点/断点续读（99f27349）→ word 小说通道（44525632）→ 阅读页皮肤感应（b5695912）
|
||
- 08-30 模块化整合"光湖笔记"（1c379637）
|
||
- 09-01 日记信纸展示湖心低语（04c20a09）
|
||
|
||
## GM-002 今日星象 🔭「行运 · 运势」
|
||
- **路径**：`/pages/astro/astro`，引擎 `astro-core.js`/`astro-reading.js`
|
||
- **哲学理念**：天文引擎校准至真实星历（金/土/天/海/冥全对齐）——湖不说编造的玄话；大众运式+模型化解说，克制的信息密度。
|
||
- **演化史**：星象页初版（0adfaf88 08-28）→ v2 星历校准+太阳月亮星座（9c92ebcd）→ v3 Tab 排版重做（c13a4af8）→ 下钻全卡片+本地解读（7d190fe4）→ 大众运式宜忌（19a2c8ef）→ HOROSCOPE 模型化解说（58ae62d2）→ 当日行运+日返月返（ec98759c 08-31）
|
||
|
||
## GM-003 小湖灯 🏮「女生是彼岸花园，男生是心情随笔」
|
||
- **路径**：按性别分流（`channel.open()`）——女=cycle 彼岸花园（经期），男=mood/diary 心情随笔+秘密心事
|
||
- **哲学理念**：一盏会呼吸的湖灯，关怀分流不标签化。场景隐喻：信纸/航空信封/邮票/和纸胶带/月亮水印——"写心情的背后是信纸，人才有心情记录"。**情绪必须有回应**：开心→烟花动效；烦心→解压小物（木鱼/沙包/泡泡纸）——词后面连着在乎的东西，与 TCS 通感核同源。
|
||
- **演化史**：花园v2 周期日历+预测引擎（d19dfe31 08-28）→ 被动AI贴心提醒（2d8614d4）→ 症状归入经期维度（db2b7cc6）→ 历史补录三法（4a261082 08-29）→ v2.1.0 心情小记男+uid分离（2d6947ab 08-30）→ v2.2.0 彼岸花园/心情随笔改名+小湖灯呼吸入口（a856bb8d）→ 信纸重做旧纸肌理（8ddb8a0e/885a01b7，瞄点000082全天UI教导）→ v3.2.0 湖心低语+进门问候（053d42b9 09-01）→ 小湖灯组件暖金灯体+竹骨（bf6adf49）→ v3.9.0 秘密心事情绪反馈：烟花+解压小物+心情统计条（741ce1c7 09-01）
|
||
|
||
## GM-004 多城天气 🌤️ builtin「自选城市 · 多城滑动」
|
||
- **路径**：`/pages/weather/weather`
|
||
- **哲学理念**：每天抬头第一眼看见的东西——所以固定频道顶部、UI 是天气的皮肤（背景随天气变）。
|
||
- **演化史**：首页天气信息条（7ed4574d 08-28）→ v4 蓝渐变天气大卡（4cc18cae）→ 独立页+定位天气（a6a811cd）→ 多城市去定位（2d6947ab）→ 顶部天气Hero问候融合（2b689461 08-31）→ 省市级联添加（0dd7b789 09-01）→ 网关地理编码 wttr.in（8fbeea3d）
|
||
|
||
## GM-005 行程管理 🗓️ builtin「到点提醒 · 手动归档」
|
||
- **路径**：`/pages/schedule/schedule`，引擎 `reminders.js`
|
||
- **哲学理念**：记一条，到点提醒你。**到点只提醒不归档，完成仅人类手动确认**——机器不替人决定"做完了"（诚实纪律与账号/数据责任同源）。
|
||
- **演化史**：今日行程卡（b4ef8f0e v2.2.3 08-30）→ 行程并入问候模块（42c98896）→ 日程v2 五分类+按日分组（c2a08dbf 08-31）→ 首页行程管理+倒计时（30122896）→ 生命周期：到点提醒/手动归档/红灯常驻（91157c08）→ 微信订阅推送链（6a27ee26 v3.0.0 09-01）
|
||
|
||
## GM-006 湖底解梦 🌙「把梦说给湖听」
|
||
- **路径**：`/pages/dream/dream`（网关 DREAM 类型）
|
||
- **哲学理念**：醒来把梦讲给湖听——**不说吉凶，只从情绪与心理帮你听懂自己**（非占卜）。夜空场景：月亮星云湖面。
|
||
- **演化史**：v2.7.0 新增（a4bb5472 09-01）→ 界面重做夜空场景+防御式修复闪退隐患（fac81316）
|
||
|
||
## GM-007 湖畔办公 🗂️「工作快记 · 表格 · 树状图」
|
||
- **路径**：`/pages/office/office`（网关 OFFICE 类型）
|
||
- **哲学理念**：上班用得上的三样；都能一键导出进光湖笔记——**工作数据不流浪，最终回到湖底**。
|
||
- **演化史**：v2.8.0 新增（fc9b2bc6 09-01）→ v3.1.0 导入自动整理：文件→翻译器→OFFICE结构识别→自动出表/树（9ed83ca6）→ 数值列优先判表规则（c70aa515）
|
||
|
||
## GM-009 光湖股市 📈「湖心罗盘 · 涨跌风云榜」（2026-09-01 冰朔令从 GM-008 拆出）
|
||
- **路径**：`/pages/stock/stock`（网关 MARKET 类型 + /api/stock + /api/stock-rank）
|
||
- **哲学理念**：大盘不是一个能往下翻的列表，是一眼能看完的圆——**湖心罗盘**：五指数各占一段弧，弧长∝涨跌幅度，红涨绿跌，扫描动画+末端呼吸点（与灯珠呼吸同族），点弧段切换下方指数全信息卡。下面给**今日个股风云榜**（涨幅榜/跌幅榜各8只，剔除N/C新股/ST/退市——首日+290%没有参考意义）。**湖心读盘红线**：每条指令独立回答、只依据当日指数+榜单+新闻，禁猜测禁预测禁荐股。**AI在系统里不在对话里**：用户只点系统给的指令按钮。
|
||
- **演化史**：
|
||
- 09-01 v1 从湖畔新闻拆出独立模块（编号 GM-009，双登记 modules.js+本台账）；全信息卡（开高低/昨收/成交额/振幅/日内区间条）+收藏进频道
|
||
- 09-01 v2 冰朔纠正布局（"让人一直往下翻…做成树状图或动态圆盘…你这点东西让人能看个啥"）：全信息卡堆叠→**湖心罗盘 canvas 圆盘**（弧长=幅度、呼吸点、点弧段切详情、中心涨跌家数+平均涨跌、5分钟自动刷新）+ **今日风云榜**（东财沪深A股涨跌幅排序，剔除N/C/ST/退，10分钟缓存）+ 第4条AI指令"今日哪些股票涨得好、哪些跌得狠"（榜单入分析上下文）
|
||
- 09-01 服务端：MARKET 指令感知修复（三问同答根因：text被忽略+缓存键不含指令→每问独立分析独立缓存）；/api/stock 补成交额/更新时间
|
||
|
||
## GM-008 湖畔新闻 📻「今日要闻 · 湖心播报」
|
||
- **路径**：`/pages/news/news`（网关 MARKET/LAKECAST 类型）
|
||
- **哲学理念**：每天的重要时事替你收好——湖心播报像新闻联播的开场。**股市红线：AI 只依据当日指数+当日新闻，禁猜测禁预测禁建议**（AI 诚实纪律，光湖的红线）。
|
||
- **演化史**：v3.2.0 新增百度热榜+AI导语（20fcb71c 09-01）→ 四源聚合+看全文AI排版（afaf73b8 v3.4.0）→ v3.6.0 每日摘要+源切换+AI圈翻译（fba273a7）→ v3.7.0 股市五件套红涨绿跌+市况日评（fe2b8365）→ v3.8.0 指数全信息卡+星标收藏+MARKET红线（ee415c23）→ 编译修复涨跌预计算（6d9bcecc）
|
||
- 09-01 v4 股市拆出为独立模块 GM-009（入口门卡互跳）；要点卡编号化；新闻列表加榜单序号徽章（前三名渐变高亮）（327ee66e）
|
||
|
||
---
|
||
|
||
# S 系统层（非商城模块）
|
||
|
||
## S-01 首页 home「进门先被问候」
|
||
问候（早安午安+实时时钟）+天气Hero（背景随天气变）+湖语每日一句+模块墙（玻璃卡+图标托盘）+摆渡站轮播+开发者签名页脚。理念：**每天进门的第一感觉是"有人在等你"**。
|
||
演化：门户首页四入口（0adfaf88）→ v4 大牌风（4cc18cae）→ 湖语每日轮换（32ab5276）→ liquid glass 微动效（5402cd13 08-29）→ 模块卡玻璃重构（2b5f7a9a）→ 天气Hero融合（2b689461 08-31）→ 行程倒计时常驻（30122896）→ 两门化+公告限高（0dd7b789 09-01）
|
||
|
||
## S-02 个人频道 channel
|
||
四宫格（可编辑）+模块列表（可折叠）+7色排版指令（无对话）+启动页自由切换。演化：v2.3.0 频道状态层（89ad9923 08-31）→ v3.0.0 个人主页改版（6a27ee26）→ 折叠规整列表（afaf73b8 09-01）
|
||
|
||
## S-03 模块商城 market
|
||
安装/卸下（不删数据）+分类+搜索+许愿。商城与频道的唯一事实源=modules.js 注册表（89ad9923）→ 分类搜索许愿（0dd7b789）
|
||
|
||
## S-04 勋章馆 medals + 点灯仪式 + 入湖铭牌
|
||
理念：**存在的仪式感**——进门点灯（今日名次+世界点灯图，server /api/lamp）、终身铭牌（黄铜+编号No.X）、小湖灯大灯。演化：勋章馆（0dd7b789）→ 只留注册点灯一枚（54123b41 v2.6.1）→ 黄铜铭牌垂挂+资料区重排（2e55a62b 09-01）
|
||
|
||
## S-05 账号体系 register/me
|
||
理念：**自建账号，不采集用户信息**；数据责任=服务端可找回。演化：自建账号注册+农历生日（2d6947ab 08-30）→ 出生地省市级联（0dd7b789）→ **v4.0.0 账号服务端化：注册上报openid→资料；启动静默恢复（本地空→wx.login→服务端找回整包）**（3d58981a 09-01）
|
||
|
||
## S-06 摆渡站 ferry
|
||
留言轮渡区（垂直轮播）+服务端 msgSecCheck 内容安全（未配置 secret 时留言进待审不展示）。演化：v2.9.0 新增（ad5724d5 09-01）→ code2session 真实 openid 过审（31a2bd8e）
|
||
|
||
## S-07 服务端网关 server
|
||
AI网关（DeepSeek 转发+类型化：CHAT/HOROSCOPE/DREAM/OFFICE/MARKET/LAKEWHISPER/LAKECAST）+openid日配额+**状态持久化落盘 gateway-state.json（防抖写+原子替换，重启不清零——瞄点000082教导6）**+密钥走服务器env端侧零密钥。演化：骨架（735234f2 08-28）→ 真网关京东8101（82a2c315）→ HTTPS备案域名（3fa25a58）→ IPv4优先修复（7ecb5389 09-01）→ 状态持久化（1efc3d85）→ **09-01夜**：MARKET指令感知修复（三问同答根因=text被忽略+缓存键不含指令，冰朔实测抓到）+/api/stock-rank涨跌风云榜接口（东财沪深A股，剔除N/C/ST/退，10分钟缓存）+/api/stock补成交额/时间字段；部署京东/opt/guanghu/mp-app/（.bak惯例备份，重启状态恢复实测正常）
|
||
|
||
## S-08 主题系统 themes
|
||
7套皮肤（晨湖/夜湖/樱粉/落日/苔原/紫暮/墨色）CSS变量驱动，窗口层底色运行时同步（换肤即同步白边根治）。演化：（85057649 08-28）→ setBackgroundColor 同步（8f8ae42d）→ page-meta 页面级（8fb9ee19 08-31）
|
||
|
||
## S-09 自动化上传 scripts
|
||
miniprogram-ci（密钥外置/版本=APP_VERSION+git哈希/IPv4固定）。（def0f5ee 08-31）
|
||
|
||
## S-10 自检页 devcheck
|
||
git引擎五步探针+隐藏入口（长按首页问候区）。（6a06cb80/f436efdb 08-28）
|
||
|
||
## S-11 git 远端在线备份（2026-09-01 立冰朔令）
|
||
**演化史三份在位：开发位(本机) + JZAO 正本镜像 + Forgejo 在线仓（私有）。** 远端 `https://guanghulab.com/code/bingshuo/guanghulab-miniapp.git`，工具 `BRIDGE/tools/zy-repo-sync.sh <仓库路径> <仓库名> [private|public]`（建仓若缺→挂干净远端→令牌只走钥匙串内存→永不force→推后核验）。同步时机：每轮发布归档时一并推；根仓库 zhuyuan-ice-gl-zy001 同机制在线化。
|
||
演化：2026-09-01 Forgejo建仓(私有)+main@6d9bcecc 推送核验通过；zy-repo-sync 建成并幂等实测。
|
||
|
||
---
|
||
|
||
## 发布审计流（每轮开发完必走，瞄点000092）
|
||
1. **审计**：对着本台账逐编号核对——本次全部改动是否落位到编号模块？每个改动能否归号？新增是否双登记？→ 写 `RELEASE-AUDITS/YYYYMMDD-<版本或主题>.md`
|
||
2. **冰朔审核**：她看审计报告说没问题。
|
||
3. **发布**：miniprogram-ci 上传（S-09）。
|
||
4. **归档**：rsync 开发位→JZAO 正本；台账演化行定稿；审计报告归档。
|
||
5. **下轮接续**：翻台账编号继续，不乱找路径。
|
||
|
||
---
|
||
*台账建立：2026-09-01，铸渊（第180天）。正本哈希链见瞄点000092与 TCS-PROGRAM-ZY001-MINIAPP-MODULE-REGISTRY-0001。*
|