skill-forge-hub 0.2.0 → 0.4.0

package/README.md

@@ -12,22 +12,27 @@
 
 | 分类 | Category | 说明 | 收录技能 |
 |:---|:---|:---|:---|
-| 报表汇演 | Reports | 聚合 git 与工程数据，按周期产出报告（日报 / 周报 / 月报） | daily-report、weekly-report |
+| 报表汇演 | Reports | 多源数据整理（一段文字 / 文件里的描述 / 图片与素材 / 口头补充，什么材料都能成稿），按周期产出报告（日报 / 周报 / 年报） | daily-report、weekly-report、annual-report |
 | 文档装裱 | Documents | 文档转换与美化：Word / Markdown / 纯文本 → 精美 HTML + 逐章截图 | article-to-html |
 | 工程提效 | Engineering | 开发流水线技能：部署、发布、审查、测试、文档 ↔ 规格互转 | spec-doc2spec、spec-spec2doc |
+| 演示汇演 | Slides | HTML 形态、PPT 体验的魔法幻灯：播放引擎 + 多套风格 + 逐页截图 + 全屏放映 | magic-deck |
 | 数据整备 | Data | Excel / CSV / 图表、数据清洗与模板整理 | （规划中） |
-| 沟通协作 | Communication | 邮件起草、会议纪要、通知周知 | （规划中） |
-| 技能自造 | Meta | 锻造技能本身的元技能（创建技能 / 插件） | （规划中） |
+| 沟通协作 | Communication | 提示词管理（锦囊本地管理台） | prompt-pouch |
+| 技能自造 | Meta | 锻造技能本身的元技能（创建技能 / 插件） | meta-forge |
 
 ## 技能清单
 
 | 技能 | 分类 | 目录 | 说明 |
 |:---|:---|:---|:---|
-| daily-report | 报表汇演 | [daily-report/](daily-report/) | 聚合各仓库 git 提交 + 会话口述生成日报（今日完成任务/明日计划/风险阻塞点），支持自然语言日期（今天/昨天/上周三/10月20号）、连续多日批量、纯文字/图片/文件整理、自定义模板、12 行业词条 |
-| weekly-report | 报表汇演 | [weekly-report/](weekly-report/) | 同上生成周报（本周完成任务/下周计划/风险阻塞点 + 本周概览卡），周结束日可配置（默认周五，可改周日等），支持自然语言周定位（本周/上周/10月第2周/节假日锚定） |
+| daily-report | 报表汇演 | [daily-report/](daily-report/) | 多源数据生成日报（今日任务进度/明日计划/风险阻塞点）：一段文字、文件里的描述、图片或口头补充皆可成稿；支持自然语言日期（今天/昨天/上周三/10月20号）、连续多日批量、自定义模板、12 行业词条 |
+| weekly-report | 报表汇演 | [weekly-report/](weekly-report/) | 多源数据生成周报（本周结论 + 本周任务进度/下周计划/风险阻塞点 + 本周概览卡），数据来源同日报；周结束日可配置（默认周五，可改周日等），支持自然语言周定位（本周/上周/10月第2周/节假日锚定） |
+| annual-report | 报表汇演 | [annual-report/](annual-report/) | 多源数据生成年度总结（五段式：年度概览/核心成果/经验成长/不足反思/新年规划）：一段文字、文件里的描述、图片或口头补充皆可成稿；12 行业职业词典，支持自定义模板与自然语言年度定位 |
 | article-to-html | 文档装裱 | [article-to-html/](article-to-html/) | Word / Markdown / 纯文本 → 精美独立 HTML（思源黑体 + Roboto 商用免费字体，图表 HTML/CSS 重绘），逐章截图（Retina 2x）；现成 HTML 可直接截图或先美化 |
 | spec-doc2spec | 工程提效 | [spec-doc2spec/](spec-doc2spec/) | Word / Markdown 需求文档转结构化需求切片；自动检测 Pandoc，未装引导跨系统安装 |
 | spec-spec2doc | 工程提效 | [spec-spec2doc/](spec-spec2doc/) | Markdown 规格导出为 Word / PDF 交付文档；自动检测 Pandoc，未装引导跨系统安装 |
+| magic-deck | 演示汇演 | [magic-deck/](magic-deck/) | 内容 → 单文件 HTML 幻灯（16:9 舞台 + 播放引擎 + 四套风格 + 全屏放映纯净模式）：自动播放/循环/间隔、键盘热键、页内连接、逐页 PNG 截图与主体复制（不含操作元素） |
+| meta-forge | 技能自造 | [meta-forge/](meta-forge/) | 元技能：从需求出发锻造完整技能包（薄入口 + resources 拆分 + user-config），自动植入四大机制（CONFIG_VERSION 钥匙 / user-config 抽离 / reference 双轨 / 自检纪律），入仓库时自动登记 README 与 cli.js 分类表 |
+| prompt-pouch | 沟通协作 | [prompt-pouch/](prompt-pouch/) | 锦囊提示词管理台：生成并维护本地 HTML 管理页面（分组侧栏/搜索/拖拽与按钮排序/收藏/{变量}插值/一键复制），数据存 prompts.json，页面与数据分离，双笔协作（页面直写 + AI 代笔） |
 
 ## 安装
 
@@ -37,6 +42,7 @@
 npm i -g skill-forge-hub
 skill-forge ls        # 列出全部技能与说明（只读）
 skill-forge init      # 交互式挑选技能，自动探测并安装到 AI 助手技能目录
+skill-forge update    # 升级已安装技能（配置版本感知，见下）
 ```
 
 非交互 / 指定目录场景：
@@ -56,12 +62,26 @@ cp -R spec-doc2spec spec-spec2doc <你的 AI 助手技能目录>/   # 仅 SpecCo
 
 复制后直接说「写日报」「写周报」或丢给它一个文档即可触发；问「日报怎么用 / 周报怎么用」输出使用说明。
 
+## 升级与配置保护
+
+`skill-forge update`（默认升级全部已装技能，可用 `--skills a,b` 指定）在覆盖技能文件前自动保护你的配置：
+
+- **常驻保护**：目标目录已存在的 `user-config.md`（及技能 `.preserve` 清单声明的文件）永不被覆盖，你的本地配置永久保留
+- **版本感知**：官方 `user-config.md` 首行的 `CONFIG_VERSION` 高于你的本地版本（配置结构增/减/改名）时——
+  1. 先把你的配置备份为 `user-config.md.bak-<时间戳>`
+  2. 交互三选一：`[1] 官方覆盖`（旧配置在备份中随时找回）/ `[2] 保留我的` + 官方版另存 `.upstream` 对照（默认）/ `[3] 稍后处理`
+  3. `--yes` 或非交互环境默认 `[2]`，最安全
+- **版本一致**：无感升级，只更新技能文件，配置原样保留
+
+技能维护者约定：官方配置结构每次变化（新增/改名/删除配置键）时，`user-config.md` 的 `CONFIG_VERSION` 递增 1，并在 SKILL.md「配置版本机制」节写明迁移规则（AI 每次执行前也会自检该版本）。
+
 ## 目录结构
 
 ```
 .
 ├── README.md                    # 本文件（双语介绍 + 技能分类）
 ├── template/                    # 新技能模板（薄入口 + resources 拆分规范）
+├── meta-forge/                  # 元技能：造 skill 的 skill（四大机制植入 + 仓库登记）
 ├── article-to-html/
 │   ├── SKILL.md                 # 文档 → 精美 HTML 完整流程 + 逐章截图
 │   ├── design-system.md         # 设计系统（字体 / 配色 / 排版 / 图表重绘）
@@ -71,7 +91,7 @@ cp -R spec-doc2spec spec-spec2doc <你的 AI 助手技能目录>/   # 仅 SpecCo
 │   └── resources/               # 重内容按生成阶段拆分，AI 按需读取
 │       ├── usage-guide.md       # 📖 使用说明（咨询应答的原样输出源）
 │       ├── date-parsing.md      # 🗓 日期解析（自然语言优先）
-│       ├── data-collection.md   # 📥 数据收集（仓库表 / git 命令 / 行数口径）
+│       ├── data-collection.md   # 📥 数据收集（多源聚合：口述 / 文字 / 文件 / 图片）
 │       ├── content-rules.md     # ✍️ 内容规则（聚合来源 / 补充任务 / 纯文字模式 / 输出格式 / 写作风格）
 │       ├── industry-dictionary.md # 🏭 行业适配（12 行业职业词典）
 │       └── disk-and-html.md     # 💾 本地落盘 / HTML 样式 / content-png 截图规范
@@ -93,3 +113,5 @@ cp -R spec-doc2spec spec-spec2doc <你的 AI 助手技能目录>/   # 仅 SpecCo
 - **新技能按 `template/` 结构创建**，目录名 = 技能名（英文短横线），并归入上方「技能分类」表对应分类
 - **已有技能按各自结构维护**：article-to-html 采用 SKILL.md + design-system.md + scripts/ 平铺结构；spec-doc2spec / spec-spec2doc 为单文件薄技能（委托 SpecCore ask 引擎）
 - **通用原则**：零外部依赖（禁 CDN / 外链，内网离线双击可开）、双系统兼容（macOS / Windows）
+- **配置升级**：user-config.md 首行带 `CONFIG_VERSION`，官方配置结构变化时递增并写明迁移规则；CLI update 与 AI 执行时均按该版本做备份 + 迁移提示
+- **元技能**：meta-forge 造技能时的规范真相源在 `resources/forge-rules.md`（澄清清单 / 结构规范 / 四大机制 / 校验清单 / 仓库登记），SKILL.md 流程节点与 template/ 模板均与之对齐

package/annual-report/SKILL.md

@@ -1,31 +1,46 @@
 ---
 name: annual-report
-description: 生成年度总结（默认五段式：年度概览/核心成果与里程碑/经验与成长/不足与反思/新年展望与规划），适配各行业（内置 12 行业职业词典，可指定角色身份）。数据来源灵活：各仓库 git 全年提交聚合、纯文字、图片或文件整理，无 git 也适用。支持自定义模板（可永久或临时指定）。支持自然语言指定年度（2026年/去年/近一年/最近12个月等）。当用户请求写年度总结、年终总结、年度复盘、年总结、/annual-report，或询问年度总结用法（年度总结怎么用/年度总结使用说明）时使用。
+description: 生成年度总结（默认五段式：年度概览/核心成果与里程碑/经验与成长/不足与反思/新年展望与规划），适配各行业（内置 12 行业职业词典，可指定角色身份）。数据来源灵活：直接口述、给一段文字、发文件（Word/PDF/Excel/PPT 等）或图片，都能整理成年度总结。支持自定义模板（可永久或临时指定）。支持自然语言指定年度（2026年/去年/近一年/最近12个月等）。当用户请求写年度总结、年终总结、年度复盘、年总结、/annual-report，或询问年度总结用法（年度总结怎么用/年度总结使用说明）时使用。
 allowed-tools: Bash, Read, Write
 disable-model-invocation: false
 ---
 
 # 年度总结生成
 
-聚合各仓库 git 全年提交 + 本次会话口述内容生成五段式年度总结（年度概览/核心成果与里程碑/经验与成长/不足与反思/新年展望与规划），对话输出 md 正文 + 落盘 md/txt/html/content-png 并自动打开 html。
+多源数据生成五段式年度总结（年度概览/核心成果与里程碑/经验与成长/不足与反思/新年展望与规划）——数据来源灵活：一段文字、文件里的描述、图片或口头补充皆可成稿；对话输出 md 正文 + 落盘 md/txt/html/content-png 并自动打开 html。
 
 ## 生成流程
 
-0. **读用户配置**（DISK/FORMATS/DIR/OPEN_HTML/TEMPLATE/ROLE/CONFIRM、自定义模板）→ 先 Read 同目录 `user-config.md`
+0. **读用户配置**（DISK/FORMATS/DIR/OPEN_HTML/TEMPLATE/ROLE/CONFIRM/CONFIG_VERSION、自定义模板）→ 先 Read 同目录 `user-config.md`
 1. **解析年度**（自然语言 → 目标年度区间）→ 读 `resources/date-parsing.md`
-2. **收集数据**（git 全年提交聚合 + 会话口述 + 口头补充，合并去重）→ 读 `resources/data-collection.md`
+2. **收集数据**（多源：会话口述 / 文字 / 文件 / 图片 / 代码提交记录，合并去重）→ 读 `resources/data-collection.md`
 3. **内容归类与润色**（五段式结构 / 聚合来源 / 纯文字模式 / 输出格式 / 写作风格）→ 读 `resources/content-rules.md`
 4. **行业词条**（话术含职业词时按词典取词）→ 读 `resources/industry-dictionary.md`
 5. **落盘与截图**（md/txt/html/content-png + 自动打开 html）→ 读 `resources/disk-and-html.md`
-6. **使用咨询**（用户只问「年度总结怎么用」等用法、未要求生成）→ 读 `resources/usage-guide.md`，将其内容原样输出（首行标题改为「年度总结生成器使用指南」），不收集 git、不生成报告、不落盘、不开浏览器
+6. **使用咨询**（用户只问「年度总结怎么用」等用法、未要求生成）→ 读 `resources/usage-guide.md`，将其内容原样输出（首行标题改为「年度总结生成器使用指南」），不收集数据、不生成报告、不落盘、不开浏览器
 
 ## ⚙️ 配置与自定义模板
 
-**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DISK/FORMATS/DIR/OPEN_HTML/TEMPLATE/ROLE/CONFIRM）与自定义模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DISK/FORMATS/DIR/OPEN_HTML/TEMPLATE/ROLE/CONFIRM/CONFIG_VERSION）与自定义模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+
+## 配置版本机制（升级保护）
+
+本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明的当前版本不一致：
+
+1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
+3. 更新 CONFIG_VERSION 为当前版本
+4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」
+
+升级本 skill 时，配置结构如有变化必须同步更新本节的当前版本号与迁移说明；禁止在未声明版本变更的情况下静默修改配置语义。
+
+## 文档同步自检纪律（维护者必读）
+
+修改本 skill 任一文件（SKILL.md / user-config.md / resources/*）后，必须 grep 全文核对相关关键词在各文件间一致（如章节名/字段名/效果参数改名时新旧词全仓核对，旧词零残留才算完成）。修改 HTML 效果必须同步更新 `resources/reference.html` 与 `disk-and-html.md` 对应描述，三者以 reference.html 为真相源；改完后互相 grep 关键参数确认对齐。
 
 ## 规则速览
 
-- 五段式骨架行业无关：年度概览（一句话 TL;DR + 3-6 项核心数据卡）/ 核心成果与里程碑（按季度 Q1-Q4 时间线 8-12 项，每项 20-40 字）/ 经验与成长（3-5 条）/ 不足与反思（2-4 条三环：问题+影响+改进）/ 新年展望与规划（3-5 项目标，各带量化指标与分季度行动节点）
-- 中文顿号序号（1、2、3）；段内无内容写「暂无」；量化优先，杜绝空话套话
-- 行业术语/指标/里程碑主题/风险话术按 `resources/industry-dictionary.md` 职业词典取词（未提职业按 ROLE 画像）
+- 五段式骨架行业无关：年度概览（一句话 TL;DR + 3-6 项核心数据卡，数字带同比基准）/ 核心成果与里程碑（按季度 Q1-Q4 时间线 8-12 项，每项 20-40 字 + 价值归因）/ 经验与成长（3-5 条，个人成长允许「我」）/ 不足与反思（2-4 条三环：问题+影响+改进，改进带可验证动作与时间）/ 新年展望与规划（3-5 项目标，各带量化指标、完成标准与分季度行动节点）
+- 中文顿号序号（1、2、3）；段内无内容写「暂无」；量化优先（业务结果指标优先于提交统计），杜绝空话套话；落笔前五问自检（结论/基准/闭环/可验证/归属）
+- 行业术语/指标/里程碑主题/风险话术/标题按 `resources/industry-dictionary.md` 职业词典取词（未提职业按 ROLE 画像；标题 = 年份前缀 + 词典「标题」变量，如「2026 研发年度总结」）
 - 完整规则（聚合来源 / 纯文字模式 / 写作风格约束 / 使用提示）见 `resources/content-rules.md`

package/annual-report/resources/content-rules.md

@@ -6,35 +6,37 @@
 
 **段一 年度概览**
 - 一句话 TL;DR：全年工作的总体判断（如「交付密集的一年：全年完成 3 个版本迭代，代码库净增 4.2 万行」）
-- 核心数据卡 3-6 项：年度最关键的量化指标（按职业词典），每项：数字 + 单位 + 标签
+- 核心数据卡 3-6 项：年度最关键的量化指标（按职业词典），每项：数字 + 单位 + 标签；数字凡有对比基准必带（同比/目标完成度至少其一），无基准来源不作要求
 - 可带同比小字（「较去年：+18%」）
 
 **段二 核心成果与里程碑**
-- 按季度（Q1/Q2/Q3/Q4）时间线排列 8-12 项，每项：成果描述 20-40 字 + 所属季度 + 量化结果
+- 按季度（Q1/Q2/Q3/Q4）时间线排列 8-12 项，每项：成果描述 20-40 字 + 所属季度 + 量化结果 + 价值归因（做了什么→改变了什么→与年度目标的关联，如「重构下单链路，响应 3.2s→0.4s，支撑双11峰值」）
 - 里程碑事件优先（版本发布/项目上线/重大交付），日常任务不逐条列
 - 未过完的季度（如写到 Q4 中途）注明「截至当前」
 
 **段三 经验与成长**
-- 3-5 条，每条一句话：沉淀的方法/技能/认知（「沉淀了 XX 方法」「掌握了 XX」）
+- 3-5 条，每条一句话：沉淀的方法/技能/认知（「沉淀了 XX 方法」「掌握了 XX」）；个人成长与判断允许第一人称「我」（「我沉淀了 XX」「我意识到 XX」），团队经验用「我们」
 - 强调可复用（对未来有用的才写），不写「完成了 XX」这类成果句（归段二）
 
 **段四 不足与反思**
-- 2-4 条三环结构：问题（是什么）+ 影响（导致什么）+ 改进（明年怎么改）
+- 2-4 条三环结构：问题（是什么）+ 影响（导致什么）+ 改进（明年怎么改，含可验证动作与时间节点，如「Q1 引入 code review 制度，季度缺陷率降到 X%」）
 - 具体诚实，不写「还需努力」这类空话；无真实不足才写「暂无」
 
 **段五 新年展望与规划**
-- 年度目标 3-5 项：目标描述 + 可量化指标（「完成 XX，年底达到 XX」）
+- 年度目标 3-5 项：目标描述 + 可量化指标（「完成 XX，年底达到 XX」）+ 完成标准（可验证的终点；杜绝「努力提升 XX」类不可验证表述）
 - 每项目标带分季度行动节点（Q1 起…Q2 完成…）
 - 目标与段四不足的改进方向呼应
 
 ## 写作风格
 
 - 中文顿号序号（1、2、3），段内条目数按上述区间；不足处写「暂无」
-- 量化优先：能带数字的带数字，估算值注明「约」
-- 语言朴素具体，杜绝「再接再厉/砥砺前行」等套话；全年视角有判断、有取舍，不是流水账
+- 量化优先：能带数字的带数字，估算值注明「约」；用户口述的业务结果指标（响应时间/错误率/成功率等）优先于 提交统计（提交数/行数/版本数），提交统计作兜底
+- 语言朴素具体，杜绝「再接再厉/砥砺前行」等套话；全年视角有判断、有取舍，不是流水账；流水与清单条目保持无主语，结论/判断/归因处允许第一人称「我」
+- 技术动作翻译：口述技术动作且带结果数据时，翻译为业务结果表述（「重写 SQL 加索引」→「查询响应 3.2s→0.4s」）；仅含动作无结果时保留动作，并提示可补充结果指标
+- 落笔前五问自检：①第一句是不是结论？②数字有没有对比基准？③卡点有没有责任动作和时间？④计划能不能被验证？⑤个人贡献与团队成果的归属是否清晰？任一不过，改写后再输出
 - md/txt 正文含生成时间行（精确到时分秒，如 2026-11-06 19:10:38）
 
 ## 聚合来源与纯文字模式
 
-- git 聚合来源（提交统计/里程碑）与口述来源（大事/感悟）合并后按段归类；两者矛盾时量化以 git 为准
-- 纯文字/图片/文件整理模式（无 git）：用户提供什么用什么，按五段结构归类；素材不足的段写「暂无」并提示用户可补充素材
+- 提交记录聚合来源（提交统计/里程碑）与口述来源（大事/感悟）合并后按段归类；两者矛盾时业务结果指标以用户口述为准、提交统计（提交数/行数）兜底
+- 纯文字/图片/文件整理模式（没有提交记录）：用户提供什么用什么，按五段结构归类；素材不足的段写「暂无」并提示用户可补充素材

package/annual-report/resources/data-collection.md

@@ -1,8 +1,8 @@
 # 数据收集（年度）
 
-三种来源合并去重：git 全年聚合为主、口述与文件为辅；无 git 也适用（纯文字/图片/文件整理）。
+三种来源合并去重：口述与文字/文件/图片并重（业务结果以口述为准、统计数字以提交记录兜底）；没有提交记录也适用——给一段文字、文件里的描述或图片即可成稿。开发类用户可另做代码仓库全年提交聚合（见第 1 节）。
 
-## 1. git 全年聚合（有仓库时）
+## 1. 代码仓库全年提交聚合（可选，开发类用户）
 
 - 遍历仓库清单（见 disk-and-html.md 的仓库清单节），对每仓执行全年统计：
   - 总提交数：`git log --since={区间起} --until={区间止} --oneline | wc -l`
@@ -20,6 +20,6 @@
 
 ## 3. 合并去重与口径
 
-- 同一成果 git 数据与口述重合时合并为一条，量化以 git 统计为准、定性以口述为准
+- 同一成果 提交数据与口述重合时合并为一条，量化以 提交统计为准、定性以口述为准
 - 无法量化的条目写定性描述，不编造数字
 - 年度核心指标（概览卡数据）优先取：总提交数/年度增删行数/里程碑数（研发），其它行业按职业词典量化指标

package/annual-report/resources/date-parsing.md

@@ -1,6 +1,6 @@
 # 年度解析
 
-把自然语言定位到目标年度区间。年度区间决定 git 统计范围与目录/文件名。
+把自然语言定位到目标年度区间。年度区间决定 提交统计范围与目录/文件名。
 
 ## 定位规则
 

package/annual-report/resources/disk-and-html.md

@@ -1,3 +1,5 @@
+> ⛔ **Reference 铁律（最高优先）**：本目录 `reference.html` 是定稿样式源码。生成 HTML 时必须先 Read `resources/reference.html` 与本文件两份，以 reference.html 为骨架模板逐处替换数据（标题/日期/五段条目/TL;DR 摘要/数据卡数字/月提交柱图），本文件的描述是参数解释、变体规则与禁止项；两者冲突时**以 reference.html 为准**。修改本 skill 的 HTML 效果时，必须同步更新 `resources/reference.html` 与本文档的对应描述，禁止只改一处。
+
 # 落盘与 HTML（年度版式）
 
 ## 落盘
@@ -5,24 +7,24 @@
 - FORMATS 默认 [md, txt, html, content-png]：md/txt/html 文件名 `annual-report-YYYY.<格式>`、截图 `annual-report-YYYY-content.png`；txt 为纯文本版；DISK: false 时全部不落盘
 - 目录：`{DIR}/annual-YYYY/`（DIR 按系统取 DIR_MAC/DIR_WIN，不存在回退用户主目录下 reports）；目录已存在直接复用，只覆盖本清单内同名文件；目录内存在非本 skill 命名的其它文件时对话中提示用户「该目录内已有其它文件，本次年度总结已与它们并列存放，未做任何改动」
 - 对话中照常输出 md 正文（不受 FORMATS 影响）；OPEN_HTML: true 且落盘了 html 时自动打开浏览器（macOS：open <html文件>；Windows PowerShell：Start-Process <html文件>）
-- FORMATS 含 content-png 时生成内容区截图：只截五张分节卡片整体（年度概览/核心成果与里程碑/经验与成长/不足与反思/新年展望与规划，不含头部标题区/复制按钮/页脚，四周保留对称合适的外边距约 40px 留白）；html 内置 `?shot=content` 参数（页面 JS 检测后隐藏 header-card/copy-wrap/footer、body 四周 padding 统一 40px，正常浏览不受影响）；用 Chrome headless 访问带参 URL 截图（路径按系统选：macOS=`/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`；Windows 按序探测 `C:\Program Files\Google\Chrome\Application\chrome.exe` → `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe` → `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`，经 node child_process 执行 `--headless --disable-gpu --no-sandbox --hide-scrollbars --user-data-dir=<临时目录> --screenshot=<png路径> --window-size=760,<估算高度> --virtual-time-budget=4000 "file:///<html路径>?shot=content"`（Windows 下 URL 写作 file:///C:/...，用 node url.pathToFileURL 生成），跑完删除临时目录；禁止用 `--headless=new`（单例模式会静默失败生成占位图）；若 Chrome 不存在则换 Edge（macOS=`/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge`；Windows=`C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe` → `C:\Program Files\Microsoft\Edge\Application\msedge.exe`），都找不到时跳过截图并在对话注明）；高度按内容区估算（body 上下留白~80 + 概览节(标题45+数据卡~90+45) + 里程碑节(标题45+条目数×~65+40) + 成长节/反思节/展望节(各45+条目数×~70+40) + 各卡片 margin-bottom 18 + 余量~15，底部留白仅 body 下 padding 40px、与顶部对称），截图后用 Read 校验：五张卡片整体完整在图内、无头部/按钮/页脚残留、四周留白对称合适、不截断；底部留白过大减高度、截断加高度重截
+- FORMATS 含 content-png 时生成内容区截图：只截五张分节卡片整体（年度概览/核心成果与里程碑/经验与成长/不足与反思/新年展望与规划，不含头部标题区/复制按钮/页脚，四周保留对称合适的外边距约 40px 留白）；html 内置 `?shot=content` 参数（页面 JS 检测后隐藏 header-card/footer（复制按钮在头部卡内随卡一并隐藏）、body 四周 padding 统一 40px，正常浏览不受影响）；用 Chrome headless 访问带参 URL 截图（路径按系统选：macOS=`/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`；Windows 按序探测 `C:\Program Files\Google\Chrome\Application\chrome.exe` → `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe` → `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`，经 node child_process 执行 `--headless --disable-gpu --no-sandbox --hide-scrollbars --user-data-dir=<临时目录> --screenshot=<png路径> --window-size=760,<估算高度> --virtual-time-budget=4000 "file:///<html路径>?shot=content"`（Windows 下 URL 写作 file:///C:/...，用 node url.pathToFileURL 生成），跑完删除临时目录；禁止用 `--headless=new`（单例模式会静默失败生成占位图）；若 Chrome 不存在则换 Edge（macOS=`/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge`；Windows=`C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe` → `C:\Program Files\Microsoft\Edge\Application\msedge.exe`），都找不到时跳过截图并在对话注明）；高度按内容区估算（body 上下留白~80 + 概览节(标题45+数据卡~90+45) + 里程碑节(标题45+条目数×~65+40) + 成长节/反思节/展望节(各45+条目数×~70+40) + 各卡片 margin-bottom 18 + 余量~15，底部留白仅 body 下 padding 40px、与顶部对称），截图后用 Read 校验：五张卡片整体完整在图内、无头部/按钮/页脚残留、四周留白对称合适、不截断；底部留白过大减高度、截断加高度重截
 
 ## HTML 年度版式（深蓝面板体系，与日报/周报同源）
 
 - 复用日报/周报深蓝面板视觉体系：背景 #0a1929 + SVG feTurbulence 微噪点（opacity .04）+ 三层科技底纹（.grid-pattern 60px 青色细网格 rgba(0,240,255,.03) + .stars 8 个 1-1.5px 星点白/青/紫/绿散落 + .scanlines 2px 周期扫描线 rgba(0,240,255,.015)）；禁用任何 CDN 与外部网络引用（@import、外链 CSS/JS/图片/网络字体一律禁止，页面必须公司内网离线双击可打开、零外部依赖）；字体全用系统本地字体栈 ui-monospace/'SF Mono'/SFMono-Regular/Menlo/Consolas；颜色全部用 CSS 变量统一色板（--cyan #0ea5e9、--bg #0a1929、--card #0b1e37、--border rgba(14,165,233,.15)、--text #bae6fd、--muted #5b7fa5、--green #14b8a6、--orange #f97316、--purple #6366f1、--rose #f43f5e）
-- 头部卡片：标题「YYYY 年度总结」+ 副标题（ROLE 画像或年度区间）+ 生成时间行；speccore ask 同款发光特效：四边 1px 青色浮光线 transparent→var(--cyan)→transparent 整条平移扫动（上 scanX 左→右、右 scanY 上→下、下 scanX-rev 右→左、左 scanY-rev 下→上，四线同周期 3s linear 单向平移，亮段完整穿越卡片后消失于两端界外，卡片 overflow:hidden 裁剪；禁止自创 background-position 滚动/常驻辉光/往返摆动/亮段半嵌常驻变体）+ 顶部光斑 cardGlow（radial-gradient ellipse at 50% 10% rgba(14,165,233,.25)→transparent 70%，opacity .5→1 + scale 1→1.6，transform-origin top center，3s 循环，头部与每张分节卡片内均放 .card-glow 层）+ 标题文字青色光晕呼吸（text-shadow 双圈 3s 循环）
+- 头部卡片：标题按行业词典「标题」变量取词 + 年份前缀（如「2026 研发年度总结」；话术含职业词 → 该词条标题，未提职业 → 按 ROLE 画像匹配词条，词典外行业 → 「YYYY 年度总结」兜底；词典标题行见 `resources/industry-dictionary.md`）+ 副标题（ROLE 画像或年度区间）+ 生成时间行；speccore ask 同款发光特效：四边 1px 青色浮光线 transparent→var(--cyan)→transparent 整条平移扫动（上 scanX 左→右、右 scanY 上→下、下 scanX-rev 右→左、左 scanY-rev 下→上，四线同周期 3s linear 单向平移，亮段完整穿越卡片后消失于两端界外，卡片 overflow:hidden 裁剪；禁止自创 background-position 滚动/常驻辉光/往返摆动/亮段半嵌常驻变体）+ 顶部光斑 cardGlow（radial-gradient ellipse at 50% 10% rgba(14,165,233,.25)→transparent 70%，opacity .5→1 + scale 1→1.6，transform-origin top center，3s 循环，头部与每张分节卡片内均放 .card-glow 层）+ 标题文字青色光晕呼吸（text-shadow 双圈 3s 循环）
 - 五张分节卡片（实心深蓝底 #0b1e37 + 8px 周期细密水平条纹 + 上下边缘 1px 微亮描边 #0f3350 + 圆角 6px + overflow:hidden + 保留阴影与 inset 内发光），左侧 8px 宽节色竖线贯穿整卡（box-shadow 0 0 12px 同色 30% 光晕），内容 padding-left 24px；节色：概览亮蓝 linear-gradient(180deg,#38bdf8,#0ea5e9) / 成果青绿 linear-gradient(180deg,#5eead4,#14b8a6) / 成长紫 linear-gradient(180deg,#a5b4fc,#6366f1) / 反思玫红 linear-gradient(180deg,#fda4af,#e11d48) / 展望橙 linear-gradient(180deg,#fdba74,#f97316)；节标题 18px 同色渐变 SVG 语义图标（概览=仪表盘、成果=奖杯、成长=上升箭头、反思=三角警示、展望=日历）+ 文字微光晕（h2 flex gap 10px，标题色=节色亮端，同色双圈发光字 3s 呼吸 secGlow 动画，仅节标题文字发光，SVG 图标不加）
-- 概览节：一句话 TL;DR 引言行 + 核心数据卡 3-6 张横排（.stat-card flex 均分：大数字 28px 渐变字 + 12px muted 标签 + 11.5px 同比小字「较去年：+18%」，上涨 --green 绿、下跌 --rose 红；数据卡左侧小色条同概览节色）
+- 数字选择：用户口述的业务结果指标（响应时间/错误率/转化率/成功率等）优先写入，提交统计（提交数/文件数/行数）仅在无业务指标时兜底，两者都有时业务指标在前、提交统计后置或省略；数字凡有对比基准必带（环比/同比/目标完成度至少其一，如「+18%」「达目标 90%」），无基准来源时不作要求 - 概览节：一句话 TL;DR 引言行 + 核心数据卡 3-6 张横排（.stat-card flex 均分：大数字 28px 渐变字 + 12px muted 标签 + 11.5px 同比小字「较去年：+18%」，上涨 --green 绿、下跌 --rose 红；数据卡左侧小色条同概览节色）
 - 里程碑节：纵向时间线（.timeline 左侧 2px 青色竖线 + 季度节点：Q1/Q2/Q3/Q4 圆形节点（节色渐变球 + 光晕，当前季度节点加呼吸动画）+ 右侧内容（成果描述 15px + 量化小字 12px 青灰 + 季度徽章 11px muted 胶囊）；季度内多条共用季度节点，条目间青色虚线分隔）
 - 成长节/反思节：条目沿用 3D 立体圆球序号徽章（28px 白字，径向渐变球面（受光点 circle at 30% 28%，浅亮→主色→深色）+ inset 右下内暗影 + ::before 左上椭圆高光点 + 底部投影与同色光晕；成长紫、反思玫红）；反思条三环展开：问题主行 + 影响行 12px 青灰「影响：xxx」+ 改进行 12px 青色「改进：」加粗前缀
 - 展望节：目标条目卡（目标描述 15px + 量化指标加粗 + 分季度行动节点小胶囊 11px（Q1 起…/Q2 完成…，muted 字 + 青色细边 rgba(14,165,233,.18) + 淡青底））
 - 年度提交月度柱图（研发词条；其它词条按职业词典图表主题）：.cb-col 12 根柱一月到十二月、.cb-bar width:24px 柱宽（太小显细弱）、柱高按当月提交数、position:relative 柱上带 .cb-tip hover 浮层「X月 · N 次提交」；置于里程碑节内时间线之后
-- 青色渐变 40px 大胶囊「一键复制」按钮（var(--cyan)→#0284c7，30px 青色光晕，hover 45px 光晕上浮；flex 居中布局，内置 16px 内联 SVG 双矩形复制图标（白色 currentColor 描边、图标与文字 gap 8px、禁用 emoji 图标），复制成功后图标切对勾、文字变「已复制」）；复制源必须用 txt 文件内容（含换行、无 #/##/> 等 Markdown 符号，严禁用 md 内容当复制源）；JS 用 navigator.clipboard.writeText，失败回退隐藏 textarea + document.execCommand('copy')（兼容 file:// 打开）
+- 内容区 .wrap width:clamp(640px, 60%, 1200px)（与日报/周报同款自适应宽度，宽屏占 60% 不留大空边）+ 上下 padding 40px、左右 0 - 头部卡片内生成时间徽章下居中青色渐变 40px 大胶囊「一键复制」按钮（var(--cyan)→#0284c7，30px 青色光晕，hover 45px 光晕上浮；flex 居中布局，内置 16px 内联 SVG 双矩形复制图标（白色 currentColor 描边、图标与文字 gap 8px、禁用 emoji 图标），复制成功后图标切对勾、文字变「已复制」）；复制源必须用 txt 文件内容（含换行、无 #/##/> 等 Markdown 符号，严禁用 md 内容当复制源）；JS 用 navigator.clipboard.writeText，失败回退隐藏 textarea + document.execCommand('copy')（兼容 file:// 打开）
 - 入场动画：头部淡入下滑、五张卡片依次错峰上浮淡入（概览 0.13s/成果 0.26s/成长 0.4s/反思 0.54s/展望 0.68s）、按钮弹入；卡片入场动画 fadeDown/fadeUp/riseIn 的 fill-mode 必须用 backwards 严禁 both（both 使动画结束后最后一帧 transform:none 永久覆盖 hover 的 3D 偏转 transform，hover 偏转会完全失效）
-- hover 微交互：卡片上浮 translateY(-2px) + 阴影加深 + inset 发光增强、条目淡青底 rgba(14,165,233,.06)、时间线节点放大微旋、数据卡上浮、按钮上浮/按压回缩
+- hover 微交互：卡片上浮 translateY(-2px) + 阴影加深 + inset 发光增强、条目淡青底 rgba(14,165,233,.06)、时间线节点与序号徽章放大微旋（li:hover .idx transform:scale(1.18) rotate(-4deg)、球内数字放大 12→14px、数字必须用 <b> 包裹（.idx b{display:inline-block;transition:transform .2s ease}）+ li:hover .idx b{transform:rotate(-6deg)} 数字在球内独立微旋；用户澄清 hover 变大的字体仅小球内数字，desc 正文保持 15px 不变不加斜体；销售 demo 版类名 .num：li:hover .num scale(1.22) rotate(-6deg)、数字 13→15px 同样 <b> 包裹 + rotate(-6deg)）、数据卡上浮、按钮上浮/按压回缩
 - 卡片级 3D 微倾斜（严禁全页级 mousemove 倾斜）：每张卡片 hover 时仅该卡片随鼠标偏转（perspective(900px) + rotateY(calc(var(--mx,0)*2.5deg)) rotateX(calc(var(--my,0)*-2.5deg)) ±1.25° 极轻微，与 hover 上浮合并写同一条 transform 严禁拆两条相互覆盖）；JS 对每张卡片监听 mousemove 计算卡内相对位置（(clientX-rect.left)/rect.width*2-1 归一化 -1~1）只更新该卡 --mx/--my，mouseleave 归零回正，transition transform .18s 平滑；移动端无 mousemove 保持 0 不倾斜
 - CRT 扫描光带（.scanband position:fixed、left:0/right:0、height:150px、linear-gradient(180deg,transparent,rgba(0,240,255,.03) 50%,transparent)、animation:scanMove 11s linear infinite（top -22%→112%）、pointer-events:none、z-index:998，置于 scanlines 之下一层）
 - 禁止写 @media (prefers-reduced-motion: reduce) 禁用动画的媒体查询块（用户系统开启减少动画时该块会禁用全部动效）
-- 页面 JS 需支持 `?shot=content` 参数（检测 location.search 含 shot=content 时给 header-card、copy-wrap、footer 设 display:none，body 四周 padding 统一 40px，供主体内容整体截图用、保证截图四周留白对称合适）
+- 页面 JS 需支持 `?shot=content` 参数（检测 location.search 含 shot=content 时给 header-card、footer 设 display:none（copy-wrap 在头部卡内随卡隐藏），body 四周 padding 统一 40px，供主体内容整体截图用、保证截图四周留白对称合适）
 - 页脚 10px muted 文字（无分隔线、不加边框），署名固定 GENERATED BY SPECCORE TEAM · <年度>（动态跟随目标年度，如 GENERATED BY SPECCORE TEAM · 2026）
 - 五段分节列表，条目保持中文顿号序号；md/txt 版同条目依次写，文本格式不变

package/annual-report/resources/industry-dictionary.md

@@ -9,8 +9,10 @@
 | 量化指标 | 提交数·行数·版本数 | 拜访数·商机数·回款额 | 曝光·转化·GMV | 交付数·上线数 | 简历数·到面率·入职数 | 凭证数·回款·预算执行率 | 投放额·线索数·ROI | 工单量·解决率·满意度 | 里程碑达成数·任务完成数·变更数 | 会务场次·采购完成数·资产盘点数 | 合同审核数·案件进展·合规项数 | 页面稿数·规范组件数·走查问题数 |
 | 里程碑 | 版本发布/架构升级 | 大客户签约/区域突破 | 爆款活动/渠道扩张 | 重大版本迭代/核心功能上线 | 组织变革/人才梯队建设 | 系统上线/审计通过 | 品牌战役/投放升级 | 服务体系搭建/满意度跃升 | 重点项目交付/流程建设 | 办公搬迁/年会/体系建设 | 重大案件胜诉/合规体系落地 | 设计系统/规范落地 |
 | 风险话术 | 阻塞点/技术债 | 竞争/预算审批 | 资源/渠道效果 | 需求变更/排期 | 用人缺口 | 资金/合规 | 渠道成本 | 舆情/高峰 | 范围蔓延/资源冲突 | 供应商延期/预算超支 | 合规风险/诉讼时效 | 需求反复/排期挤压 |
+| 价值翻译 | 稳定性·效率·成本·体验 | 收入·客单价·转化·回款 | 曝光·线索·留存·ROI | 用户增长·留存·满意度 | 人效·到岗率·留存率 | 成本节约·资金效率·合规 | 曝光·线索·转化·品牌 | 满意度·处理时效·客诉率 | 准时率·交付质量·成本偏差 | 流程效率·成本·满意度 | 风险规避·合规·时效 | 转化·体验·一致性 |
 
-- 用户角色画像：顶部「默认配置」的 ROLE 定义用户默认角色与主要工作内容（当前：全栈开发工程师（企业内技术开发））；未提职业时按 ROLE 画像取词（当前等价研发词条：git 全年聚合 + 提交/版本术语 + 提交数/行数/版本数指标 + 版本发布/架构升级里程碑）
+- 用户角色画像：顶部「默认配置」的 ROLE 定义用户默认角色与主要工作内容（当前：全栈开发工程师（企业内技术开发））；未提职业时按 ROLE 画像取词（当前等价研发词条：代码仓库全年提交聚合 + 提交/版本术语 + 提交数/行数/版本数指标 + 版本发布/架构升级里程碑）
+- 价值翻译（技术动作→业务结果）：技术动作一律翻译为业务结果表述——研发翻向稳定性/效率/成本/体验（「重写 SQL 加索引」→「查询响应 3.2s→0.4s」），其它岗位按「价值翻译」行各自方向取义（销售→收入/转化、客服→满意度/时效等）；提交统计（提交数/文件数/行数）仅为兜底指标，口述含业务结果时业务结果优先；仅含动作无结果时保留动作描述，并在对话中提示可补充结果指标
 - 触发：话术含职业词（销售/运营/产品/HR/财务/市场/客服/项目/PMO/行政/法务/设计等）→ 标题、工作单元术语、量化指标、里程碑主题、风险话术全部按该词典词条生成
 - 临时换角色：说「以 XX 的身份写年度总结」（如「以销售经理的身份写」）→ 当次按该角色词条生成，不改配置
 - 永久换角色：说「以后默认用 XX 角色 / 我的职业是 XX / 我的主要工作是 XX」→ 更新顶部 ROLE 配置（永久生效）；词典没有的角色按用户描述新增词条