23 KiB
光湖小程序 · 模块编号注册与演化史台账
正本程序：
/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/ |
编号、理念、演化史、发布审计 |
编号规则
- GM-0XX 是模块终身编号，只增不改（与
modules.js内注册表同源同号）。新增模块双登记：先modules.js（商城/频道自动跟上），再本台账登记理念与路径。 - 优化老模块：直接翻本台账对应编号 → 开发 → 在该编号下追加演化行（日期｜版本/提交｜做了什么）。
builtin模块（GM-004/GM-005）固定个人频道顶部，不进商城、不可卸载。- 系统层用
S-XX编号（非商城模块：首页/频道/商城页/账号/网关等），同规则演化。
产品总纲（每个模块开发前先读）
- 定位（瞄点000069）：小程序=冰朔自测开发能力的试验品；HoloLake 本体=手机APP。试验品也要按光湖的标准做。
- 产品级完成（EXP-20260830-001/瞄点000082）= 功能 × 视觉 × 数据责任：新页必复用主视觉体系（玻璃卡/氛围光斑/呼吸/图标托盘）；场景隐喻优先（日记=信纸信封火漆）；诗意命名必配人话介绍；布局融合不拼接；服务器状态默认持久化且交付前实测重启延续。
- Day1 教导（瞄点000068）：翻译器思路（文件进来先翻译成湖的语言）；交互内置模块；不采集用户信息；样子货无用。
- 署名规范（冰朔 2026-09-01 定，
modules.jsAUTHOR）：开发人类=冰朔；开发执行人格体=铸渊；开发操作系统=光湖 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教导） - 09-01 深夜 v3.9.0（未发布）：秘密心事情绪反馈——开心→烟花动效；烦心→解压小物面板（木鱼功德/沙包连击/泡泡纸48粒全破重铺）+心情统计条（741ce1c7）；此前同日：湖心低语+进门问候（053d42b9）、小湖灯组件暖金灯体+竹骨（bf6adf49）
- 09-02凌晨 v3.9.2 冰朔令优化（调研Daylio/Moodistory/心岛日记/Notion模板后落三件）：本月心情日历（每天一格心色点、今天描边、点有信的日子筛选那天的信——月历式视图是竞品分析第一建议）；今日一问（8个引导问题随机上信纸，点一下换一问——引导式写作模板）；解压小物常驻入口（不再藏在统计卡，不挑心情随时进）；烟花6束→10束铺满湖面（3d0491a8）
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 补成交额/更新时间
- 09-02凌晨 v3 冰朔令"榜单点进去要看曲线和数据"：个股详情页（分时曲线canvas：昨收基准虚线/渐变填充/高中低标注/末端呼吸点/扫入动画+全数据格8项）+ 榜单行可点（服务端/api/stock-detail快照+分时，东财push2，5分钟缓存，榜单带市场前缀f13）；修罗盘空白bug（Page误用.createSelectorQuery().in(this)→去掉+失败重试3次）；修时间显示20260→HH:MM；部署事故一次如实记：坏文件曾致网关停90秒，语法检查后重部恢复（3d0491a8）
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）
- 审计：对着本台账逐编号核对——本次全部改动是否落位到编号模块？每个改动能否归号？新增是否双登记？→ 写
RELEASE-AUDITS/YYYYMMDD-<版本或主题>.md - 冰朔审核：她看审计报告说没问题。
- 发布：miniprogram-ci 上传（S-09）。
- 归档：rsync 开发位→JZAO 正本；台账演化行定稿；审计报告归档。
- 下轮接续：翻台账编号继续，不乱找路径。
台账建立：2026-09-01，铸渊（第180天）。正本哈希链见瞄点000092与 TCS-PROGRAM-ZY001-MINIAPP-MODULE-REGISTRY-0001。
本轮演化追加 · 2026-09-02 晨（注册口子统一+GM-001/004/005数据增强）
- GM-001 v4.1：光湖笔记首页从行列表改 2×2 玻璃卡（teal/blue/amber/violet 四色光斑+数据行：条数/到点/预算/篇数）（2ccdab7d）
- GM-005 +数据：统计行加"今日完成率%"第四格
- 账本（GM-001子能力）+数据：总览加"N笔·日均¥"；流水行加分类图标
- S-05 注册口子统一（冰朔令，本轮核心）：①me页删昵称showModal弹窗——已注册用户不再被"怎么称呼你"类注册窗打扰，资料编辑只走注册页一个口子（老用户进注册页自动变"编辑资料"模式预填，regAt不变）；②头像改为微信官方chooseAvatar（自定义图或微信头像均可），base64入档（≤300KB）随账号服务端同步、恢复整包带回，无头像时昵称首字渐变圆兜底，程序生成的海浪占位图退场；③注册表单整体做大（输入88rpx高、标题44rpx、头像区176rpx圆）；④老用户升级同步：启动静默恢复已有（本地空→wx.login→服务端找回整包），home注册引导已有"等服务端找回再决定+一次不再弹"护栏，本轮未动
本轮演化追加 · 2026-09-02 午（湖语服务端化+主题收编）
- S-01 湖语v2：从本地数组轮换改为服务器每日生成（/api/lake-daily，DeepSeek光湖语气≤22字：安静有画面、贴时节、禁口号禁鸡汤，按天缓存全用户共享不涉个人信息；客户端当天缓存+离线本地兜底）。首日实测："风从芦苇间穿过，捎来一句凉薄。"
- S-08 主题v2（调研design-system语义token实践后落法）：7套皮补--rise/--fall/--rise-bg/--fall-bg/--mask全局token；全站语义硬编码收编（灰字/涨跌色/涨跌底色，5个wxss文件）；换肤选择器从小圆点升级双色预览卡（底色+主色+选中描边）。病根诊断：token体系本就齐全（阴影/玻璃/代码块都有），low感来自页面绕过token硬编码——本轮收编语义色，场景美术色（灯体金/信纸米/夜空蓝）保留原样属有意设计
本轮演化追加 · 2026-09-02 午后（行情提速+写作陪伴+频道统计）
- GM-009 v4 行情提速（冰朔令：股市占的就是时间）：服务端 /api/stock 缓存10min→30s、/api/stock-detail 5min→45s；客户端罗盘30s/个股详情15s自动刷新；"延迟行情"文案改"实时快照"（e73973bb）
- GM-003 v3.9.3 写作陪伴（冰朔令：写的时候不是一个人）：LAKEWHISPER 加 stage=writing——写下十来个字时湖轻声说一句（16字内、第二人称、禁指导禁评价禁鸡汤，每封信只一次，AI仍不对话只在系统后面）；信纸下方"〰 湖在你旁边"条。实测首句："嗯，我在呢，慢慢写出来吧。"
- S-02 频道v3.1：安装模块数显性化（hero行"已装N个模块·启动首页·DIY提示"+模块列表计数）；DIY四宫格与设启动首页本就有，本轮补统计展示
- 遗留（如实）：冰朔报开发者工具报错但静态体检全绿（括号/标签/表达式/JS全平衡）——待她提供报错原文定位；建议先 工具→清除缓存→全部清除→重新编译。心情随笔(mood页)的写作陪伴本轮只落了秘密心事(diary)，mood页下轮跟进
本轮演化追加 · 2026-09-02 凌晨（开发者工具报错+预览不可见+首页四症状修复轮）
- 修复A · WXSS编译错（预览看不到前置根因，bde763e遗留闭环）：05f0c754收编脚本给app.wxss七主题行拼接token时残留7处双分号
;;——本地WXSS编译器编译失败，渲染层报「编译.wxss文件错误/route is not defined」，页面帧挂掉=模拟器与预览全不可见。上轮修的自引用是同一次机械替换的邻居雷。清缓存无法解决（已实测），改单分号后模拟器立即恢复。教训追加：拼接生成后必须对产物做结构diff（;;、空声明、未闭合），机械替换两轮雷都埋在同一段代码 - 修复B · 首页四症状（冰朔报：换肤换不了/每日湖语没了/问好没了/年月日时间没了）：home.js fetchLakeWord(150行)把Page方法todayStr()裸调用（不带this.）→ ReferenceError打断onShow → 湖语/themes.apply/tick全没执行；tick(203行)另拿todayStr函数引用当值比较致缓存湖语永不命中。两处改this.后Errors 2→0。同族扫描：mood/schedule/weather三页todayStr为模块级函数定义合法无雷
- 现场验证（DOM级+视觉双证）：渲染层body挂回真实页面组件；「晚上好/9月2日 星期二 01:31/〰湖面平静的时候，最适合听自己说话。」全显示；换肤面板7皮加载，午夜实测整页换色成功
- 修复提交：c73d08ef（v4.1.0线上开发版5dadb833带病——云端编译不查运行时错，真机首页同样空，需随下版重传）
- 遗留（如实）：①预览二维码：WXSS修复后预览包上传成功（日志progressSuccess 9.2s）但二维码面板未弹出，工具已无error——待冰朔再点一次预览复测；若仍无码，嫌疑=本机Clash代理(127.0.0.1:7897)拦微信长连接，按网络排查技能R4取证 ②模拟器皮肤停在午夜（验证换色所致），冰朔一键可切回 ③mood页写作陪伴仍欠（上轮遗留继续挂）
本轮演化追加 · 2026-09-02（GM-008湖畔新闻下线·审核合规轮）
- GM-008 湖畔新闻 下线（编号冻结不再复用）：v4.1.0提审驳回，原因=展示新闻资讯信息内容需资质，个人主体无新闻类目资质；冰朔令"这个去掉吧"。移除范围（958cbb63，11文件-291行）：pages/news四件套删除、app.json页面注册移除、modules.js模块条目移除（已装用户经installed()未知id过滤安全降级，商城/频道自动不再出现）、首页湖畔新闻tile与/api/news要闻计数移除、频道页「我的自选」卡跳转从news页改直罗盘stock页、stock页撤新闻要点分析上下文与「结合今日新闻看市场」快捷指令（MARKET分析context不再带titles）
- 保留：server端/api/news与/api/news-detail暂留（服务端不在微信审核范围，客户端已无任何调用；是否物理下线待冰朔定）
- 视觉遗留（如实）：首页下排grid现仅剩摆渡站单方卡（原与新闻并排），右半留白——布局收整方案待她拍板（方案候选：摆渡站tile改通栏/再补一格）
- 验证：app.json全页面四件套齐全、全部WXML事件绑定在JS中存在、node --check全过、客户端grep无news残留（towxml第三方与server除外）