skill-forge-hub 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,52 @@
+# CHANGELOG
+
+SkillForge（技能锻造坊）npm 包 `skill-forge-hub`（命令名 `skill-forge`）版本变更记录。
+
+## 0.5.0（2026-11-11）
+
+**新增**
+
+- **deck-stage 入坊**：报告 / 素材转专业 .pptx 登台文稿——三问交互（素材 → 页骨架表 → 成片方式），常规页原生可编辑（数据卡/时间线/柱图/饼图/折线），封面与结尾页 HTML 截图保真，每页可带演讲备注；视觉与报表同源（tech/biz/mono/warm 四主题）
+- magic-deck「💼 领域」Tab 二十一套成套模板（六分类，一键生成整套页面，两段确认可撤销）
+- magic-deck 新增 `resources/usage-guide.md`（使用咨询应答源），SKILL.md 步骤 4 挂接
+
+**改进**
+
+- 锦囊时间字段精确到时分秒（卡片 / 详情时间线 / AI 文案）
+- 锦囊默认落盘结构调整：数据与备份子目录化（`cache/prompts.json` + `backup/` 滚动备份），`DATA_DIR` / `BACKUP_DIR` 可配置，旧平铺结构兼容读取
+- 锦囊侧栏局部滚动（分组多时收藏+分组区滚动，「全部」/新建分组/用法固定）+ 弹框加宽 + 备份区按钮不换行
+- magic-deck 模板面板弹框加宽；「职业」文案统一改「领域」（更通用，适配六分类）
+- CLI：init/update 对带 package.json 的技能做依赖检测（缺 node_modules 时提示 npm install）
+- README 重写：补命令参考（完整参数表）、deck-stage 登记、目录结构全量更新、过时文案修正
+
+**修复**
+
+- **npm 包内容遗漏**：0.4.0 的 `files` 清单漏了 prompt-pouch（包内没有锦囊），已补上并加 deck-stage
+
+## 0.4.0（2026-11-10）
+
+- magic-deck 模板运行时切换：工具栏「🎨 模板」面板五套版式即点即换（全部页/仅本页/勾选页），标题自动映射，切回经典商务复原不丢内容
+- 锦囊提示词时间字段：createdAt / updatedAt 落盘与展示
+- 报表技能对外表述去 git 化：多源数据口径改为一段文字 / 文件里的描述 / 图片 / 口头补充，适配各行业
+- 锦囊默认落盘目录迁移至 MyWork/prompt-pouch（html/json/备份同目录归集）
+
+## 0.3.0（2026-11-09）
+
+- magic-deck 魔法幻灯入坊（16:9 舞台 + 播放引擎 + 模板主题 + 选页截图 + 全屏放映）
+- meta-forge 元锻炉入坊（造 skill 的 skill，四大机制自指）
+- 三件套机制回填：CONFIG_VERSION 钥匙、reference 双轨、自检纪律
+- spec-doc2spec / spec-spec2doc 彻底脱离 Speccore，改为以 Pandoc 为核心依赖的独立技能（探测安装引导 + AI 校对闭环），配置抽离 user-config
+- 三件套专业汇报规范（结论先行、风险四环、价值翻译）+ HTML 效果层升级
+
+## 0.2.0（2026-11-08）
+
+- 新增 annual-report 年度总结技能（五段式，行业无关骨架）
+- 升级保护机制：user-config.md 配置抽离 + copyDir 保留名单 + .preserve 清单
+- 日报周报整页内容区截图 + 流星进度条粒子流打磨
+- spec-doc2spec / spec-spec2doc 高阶升级带 resources 分册
+
+## 0.1.0（2026-11-06）
+
+- 首个 npm 版本：`skill-forge-hub`（命令名 `skill-forge`），零依赖 Node>=14
+- CLI：ls 列表 / init 交互多选安装（自动探测常见 AI 助手技能目录，支持 --target/--skills）
+- 收录技能：daily-report、weekly-report、article-to-html、spec-doc2spec、spec-spec2doc

package/README.md

@@ -2,7 +2,7 @@
 
 > 一处集中收纳「AI 手艺」的工坊——把日复一日的重复劳作，锻造成一句指令就能完成的顺手工具。坊中每一件技能都是一份写给 AI 的手艺说明，一句自然语言即可唤起，按既定工序产出标准化成果；手艺与宿主无关——换一份薄薄的 frontmatter 信封，就能从一位 AI 助手带去另一位。
 
-**SkillForge（技能锻造坊）** is a curated collection of AI craft skills — repetitive daily work, forged into tools that answer with a single command. Each skill is a set of craft instructions written for the AI: one natural-language request sets it in motion, and a polished, standardized deliverable comes out the other end — daily and weekly reports, documents dressed into beautiful pages, deployment pipelines, and more. The craft is host-agnostic — a thin frontmatter envelope is all it takes to carry it from one AI assistant to another. Everything here is built for high-frequency everyday work — reusable across projects, dependable on any machine, battle-tested by repeated use.
+**SkillForge (技能锻造坊)** is a curated collection of AI craft skills — repetitive daily work, forged into tools that answer with a single command. Each skill is a set of craft instructions written for the AI: one natural-language request sets it in motion, and a polished, standardized deliverable comes out the other end — daily and weekly reports, documents dressed into beautiful pages, magic slides, PPTX decks, prompt manager, Pandoc converters, and more. The craft is host-agnostic — a thin frontmatter envelope is all it takes to carry it from one AI assistant to another. Everything here is built for high-frequency everyday work — reusable across projects, dependable on any machine, battle-tested by repeated use.
 
 所有技能均以 SKILL.md 为入口——frontmatter、生成流程、用户可改配置留在入口，重内容按生成阶段拆到 resources/ 或平铺辅助文件（如 design-system.md、scripts/），AI 执行到对应阶段才读取，降低常驻上下文占用。
 
@@ -12,26 +12,28 @@
 
 | 分类 | Category | 说明 | 收录技能 |
 |:---|:---|:---|:---|
-| 报表汇演 | Reports | 聚合 git 与工程数据，按周期产出报告（日报 / 周报 / 月报 / 年报） | daily-report、weekly-report、annual-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 |
+| 工程提效 | Engineering | 基于 Pandoc 的文档 ↔ 规格互转（需求文档切片 / 规格导出 Word·PDF），Pandoc 机械转换 + AI 校对防错 | spec-doc2spec、spec-spec2doc |
+| 演示汇演 | Slides | 从内容到演示：HTML 形态的魔法幻灯（放映 + 模板 + 主题）与 .pptx 登台文稿（原生可编辑页 + 封面截图） | magic-deck、deck-stage |
 | 数据整备 | Data | Excel / CSV / 图表、数据清洗与模板整理 | （规划中） |
-| 沟通协作 | Communication | 邮件起草、会议纪要、通知周知 | （规划中） |
+| 沟通协作 | Communication | 提示词管理（锦囊本地管理台） | prompt-pouch |
 | 技能自造 | Meta | 锻造技能本身的元技能（创建技能 / 插件） | meta-forge |
 
 ## 技能清单
 
 | 技能 | 分类 | 目录 | 说明 |
 |:---|:---|:---|:---|
-| daily-report | 报表汇演 | [daily-report/](daily-report/) | 聚合各仓库 git 提交 + 会话口述生成日报（今日任务进度/明日计划/风险阻塞点），支持自然语言日期（今天/昨天/上周三/10月20号）、连续多日批量、纯文字/图片/文件整理、自定义模板、12 行业词条 |
-| weekly-report | 报表汇演 | [weekly-report/](weekly-report/) | 同上生成周报（本周任务进度/下周计划/风险阻塞点 + 本周概览卡），周结束日可配置（默认周五，可改周日等），支持自然语言周定位（本周/上周/10月第2周/节假日锚定） |
-| annual-report | 报表汇演 | [annual-report/](annual-report/) | 生成年度总结（五段式：年度概览/核心成果/经验成长/不足反思/新年规划），12 行业职业词典，git 全年提交聚合或纯文字/图片/文件，支持自定义模板与自然语言年度定位 |
+| 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 截图与主体复制（不含操作元素） |
+| spec-doc2spec | 工程提效 | [spec-doc2spec/](spec-doc2spec/) | Word / Markdown 需求文档转结构化需求切片（薄入口 + resources 分册）；自动检测 Pandoc，未装引导跨系统安装 |
+| spec-spec2doc | 工程提效 | [spec-spec2doc/](spec-spec2doc/) | Markdown 规格导出为 Word / PDF 交付文档；自动检测 Pandoc，未装引导跨系统安装；PDF 双路径（xelatex / Chrome 打印兜底） |
+| magic-deck | 演示汇演 | [magic-deck/](magic-deck/) | 内容 → 单文件 HTML 幻灯（16:9 舞台 + 播放引擎 + 十六套版式模板 + 十六套主题 + 领域成套模板 21 套 + 图表动画五式 + 动画库 + 全屏放映纯净模式）：自动播放/循环/间隔、键盘热键、页内连接、逐页 PNG 截图与主体复制（不含操作元素） |
+| deck-stage | 演示汇演 | [deck-stage/](deck-stage/) | 报告/素材 → 专业 .pptx 登台文稿：三问交互（素材 → 页骨架表 → 成片方式），常规页原生可编辑（数据卡/时间线/柱图/饼图/折线），封面与结尾页 HTML 截图保真，每页可带演讲备注；视觉与报表同源（tech/biz/mono/warm 四主题） |
 | meta-forge | 技能自造 | [meta-forge/](meta-forge/) | 元技能：从需求出发锻造完整技能包（薄入口 + resources 拆分 + user-config），自动植入四大机制（CONFIG_VERSION 钥匙 / user-config 抽离 / reference 双轨 / 自检纪律），入仓库时自动登记 README 与 cli.js 分类表 |
+| prompt-pouch | 沟通协作 | [prompt-pouch/](prompt-pouch/) | 锦囊提示词管理台：生成并维护本地 HTML 管理页面（分组侧栏/搜索/拖拽与按钮排序/收藏/{变量}插值/一键复制），数据存 cache/prompts.json、滚动备份在 backup/ 子目录，页面与数据分离，双笔协作（页面直写 + AI 代笔） |
 
 ## 安装
 
@@ -50,22 +52,46 @@ skill-forge update    # 升级已安装技能（配置版本感知，见下）
 skill-forge init --target ~/.claude/skills --skills daily-report,weekly-report
 ```
 
+> **deck-stage 依赖说明**：deck-stage 需要 PptxGenJS。从本仓库直接 init 会连带复制技能目录内 node_modules，离线可用；npm 全局装出的包不含 node_modules，安装时会提示 `cd <技能目录>/deck-stage && npm install` 补装一次即可。
+
 ### 方式二：手动复制
 
 将技能目录复制到你所用的 AI 助手的技能目录（支持 SKILL.md 格式、本地加载技能的助手均可）：
 
 ```bash
-cp -R daily-report weekly-report article-to-html <你的 AI 助手技能目录>/
-cp -R spec-doc2spec spec-spec2doc <你的 AI 助手技能目录>/   # 仅 SpecCore 用户需要
+cp -R daily-report weekly-report annual-report <你的 AI 助手技能目录>/
+cp -R magic-deck prompt-pouch <你的 AI 助手技能目录>/
+cp -R spec-doc2spec spec-spec2doc <你的 AI 助手技能目录>/
 ```
 
-复制后直接说「写日报」「写周报」或丢给它一个文档即可触发；问「日报怎么用 / 周报怎么用」输出使用说明。
+复制后直接说「写日报」「写周报」或丢给它一个文档即可触发；问「日报怎么用 / 周报怎么用 / 登台怎么用」输出使用说明。
+
+## 命令参考
+
+| 命令 | 说明 |
+|:---|:---|
+| `skill-forge ls` | 列出全部技能（分类 + 名称 + 说明），只读 |
+| `skill-forge init` | 列清单交互挑选：a=全部安装 / 编号挑选（已装标 ★，确认时可 s 跳过已装只装新） |
+| `skill-forge update` | 升级全部已安装技能（配置版本感知） |
+| `skill-forge update --skills a,b` | 只升级指定技能（未安装的提示跳过） |
+| `skill-forge --version` | 显示版本号 |
+| `skill-forge --help` | 显示完整帮助 |
+
+通用参数（init / update 通用）：
+
+| 参数 | 说明 |
+|:---|:---|
+| `--target <目录>`（`-t`） | 指定技能目录；缺省自动探测常见助手目录（~/.qoder-cn、~/.claude、~/.cursor 等），探测到多个时交互选择 |
+| `--skills a,b`（`-s`） | 指定技能名列表：init 时跳过选择直接安装/升级指定技能（适合脚本与单件补装）；update 时只升级指定技能 |
+| `--yes`（`-y`） | 跳过确认直接执行；配置版本变化时默认「保留我的 + 官方版另存 .upstream 对照」 |
+
+命令别名：`list` = `ls`、`install` = `init`、`upgrade` = `update`。
 
 ## 升级与配置保护
 
 `skill-forge update`（默认升级全部已装技能，可用 `--skills a,b` 指定）在覆盖技能文件前自动保护你的配置：
 
-- **常驻保护**：目标目录已存在的 `user-config.md`（及技能 `.preserve` 清单声明的文件）永不被覆盖，你的本地配置永久保留
+- **常驻保护**：目标目录已存在的 `user-config.md`（及技能 `.preserve` 清单声明的文件）永不被覆盖，你的本地配置永久保留；官方配置内容有更新时另存 `.upstream` 对照文件，可按需手动合并新配置点
 - **版本感知**：官方 `user-config.md` 首行的 `CONFIG_VERSION` 高于你的本地版本（配置结构增/减/改名）时——
   1. 先把你的配置备份为 `user-config.md.bak-<时间戳>`
   2. 交互三选一：`[1] 官方覆盖`（旧配置在备份中随时找回）/ `[2] 保留我的` + 官方版另存 `.upstream` 对照（默认）/ `[3] 稍后处理`
@@ -78,28 +104,58 @@ cp -R spec-doc2spec spec-spec2doc <你的 AI 助手技能目录>/   # 仅 SpecCo
 
 ```
 .
-├── README.md                    # 本文件（双语介绍 + 技能分类）
+├── README.md                    # 本文件（双语介绍 + 技能分类 + 命令参考）
+├── CHANGELOG.md                 # 版本变更记录
+├── cli.js                       # 安装器（ls / init / update，零依赖 Node>=14）
+├── package.json                 # npm 包定义（skill-forge-hub，命令名 skill-forge）
 ├── template/                    # 新技能模板（薄入口 + resources 拆分规范）
 ├── meta-forge/                  # 元技能：造 skill 的 skill（四大机制植入 + 仓库登记）
 ├── article-to-html/
-│   ├── SKILL.md                 # 文档 → 精美 HTML 完整流程 + 逐章截图
+│   ├── SKILL.md                 # 文档 → 精美 HTML 完整流程 + 逐章截图（含内嵌使用说明）
 │   ├── design-system.md         # 设计系统（字体 / 配色 / 排版 / 图表重绘）
+│   ├── user-config.md           # ⚙️ 用户配置（THEME 等，升级不覆盖）
 │   └── scripts/                 # 字体安装 / docx 抽取 / 字体内联脚本
-├── daily-report/
-│   ├── SKILL.md                 # 薄入口：frontmatter + 生成流程 + 默认配置 + 自定义模板
+├── daily-report/（weekly-report / annual-report 同构）
+│   ├── SKILL.md                 # 薄入口：frontmatter + 生成流程 + 规则速览
+│   ├── user-config.md           # ⚙️ 用户配置（CONFIG_VERSION + 默认配置 + 自定义模板）
 │   └── resources/               # 重内容按生成阶段拆分，AI 按需读取
 │       ├── usage-guide.md       # 📖 使用说明（咨询应答的原样输出源）
 │       ├── date-parsing.md      # 🗓 日期解析（自然语言优先）
-│       ├── data-collection.md   # 📥 数据收集（仓库表 / git 命令 / 行数口径）
-│       ├── content-rules.md     # ✍️ 内容规则（聚合来源 / 补充任务 / 纯文字模式 / 输出格式 / 写作风格）
+│       ├── data-collection.md   # 📥 数据收集（多源聚合：口述 / 文字 / 文件 / 图片）
+│       ├── content-rules.md     # ✍️ 内容规则（聚合来源 / 纯文字模式 / 输出格式 / 写作风格）
 │       ├── industry-dictionary.md # 🏭 行业适配（12 行业职业词典）
 │       └── disk-and-html.md     # 💾 本地落盘 / HTML 样式 / content-png 截图规范
-├── spec-doc2spec/
-│   └── SKILL.md                 # 文档 → 需求规格（委托 SpecCore ask 引擎）
-├── spec-spec2doc/
-│   └── SKILL.md                 # 规格 → Word / PDF（委托 SpecCore ask 引擎）
+├── magic-deck/
+│   ├── SKILL.md                 # 薄入口：魔法幻灯生成流程 + 规则速览
+│   ├── user-config.md           # ⚙️ 用户配置
+│   └── resources/
+│       ├── usage-guide.md       # 📖 使用说明（功能/热键/截图/复制/全屏）
+│       ├── deck-spec.md         # 完整规范（骨架/主题色值/模板库/热键表/截图实现）
+│       └── reference.html       # 成品骨架（生成时以此为骨逐处替换内容）
+├── deck-stage/
+│   ├── SKILL.md                 # 薄入口：登台 PPTX 三问交互 + 生成流程
+│   ├── user-config.md           # ⚙️ 用户配置
+│   ├── package.json             # 依赖声明（pptxgenjs）
+│   └── resources/
+│       ├── usage-guide.md       # 📖 使用说明
+│       ├── data-schema.md       # data.json 结构（段落 → 页类型/节色映射）
+│       ├── pptx-builder.js      # 真相源：读 data.json 产 16:9 pptx
+│       └── cover-template.html  # 封面/结尾截图底版
+├── prompt-pouch/
+│   ├── SKILL.md                 # 薄入口：锦囊管理台生成流程
+│   ├── user-config.md           # ⚙️ 用户配置（DIR/DATA_DIR/BACKUP_DIR 等）
+│   └── resources/
+│       ├── usage-guide.md       # 📖 使用说明
+│       ├── data-format.md       # prompts.json 数据格式
+│       └── reference.html       # 成品骨架
+├── spec-doc2spec/（spec-spec2doc 同构）
+│   ├── SKILL.md                 # 薄入口：Pandoc 转换 + AI 校对流程
+│   ├── user-config.md           # ⚙️ 用户配置
+│   └── resources/               # 分册：checklist 校对清单 / images 图片处理 /
+│                                #   structure 目录组织 / pdf-path PDF 双路径 / usage-guide
 └── weekly-report/
     ├── SKILL.md
+    ├── user-config.md
     └── resources/               # 结构同 daily-report，周报专属差异：
                                  #   WEEK_END 周结束日 / 周定位解析 / 本周概览卡 / 用时 X.XD（1D=8H）
 ```
@@ -109,8 +165,8 @@ cp -R spec-doc2spec spec-spec2doc <你的 AI 助手技能目录>/   # 仅 SpecCo
 - **SKILL.md 只保留**：frontmatter、生成流程总览（每步标注读哪个 resource）、「⚙️ 默认配置」「📝 自定义模板」（用户手改的配置必须留在入口）、规则速览（3-5 条硬性规则）
 - **resources/ 一文件一职责**：按生成阶段拆分，SKILL.md 流程节点标注 `读 resources/xxx.md`；每份 resource 独立可读，不互相引用
 - **咨询应答**：用户只问用法不要求生成时，读 `resources/usage-guide.md` 原样输出（首行标题按技能改为「XX生成器使用指南」）
-- **新技能按 `template/` 结构创建**，目录名 = 技能名（英文短横线），并归入上方「技能分类」表对应分类
-- **已有技能按各自结构维护**：article-to-html 采用 SKILL.md + design-system.md + scripts/ 平铺结构；spec-doc2spec / spec-spec2doc 为单文件薄技能（委托 SpecCore ask 引擎）
+- **新技能按 `template/` 结构创建**，目录名 = 技能名（英文短横线），并归入上方「技能分类」表对应分类 + 同步 cli.js CATEGORIES 与 package.json files
+- **已有技能按各自结构维护**：article-to-html 采用 SKILL.md + design-system.md + scripts/ 平铺结构（使用说明内嵌 SKILL.md「用户使用说明」节）
 - **通用原则**：零外部依赖（禁 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,33 @@
 ---
 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/CONFIG_VERSION、自定义模板）→ 先 Read 同目录 `user-config.md`
+0. **读用户配置**（DISK/FORMATS/DIR/OPEN_HTML/THEME/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/CONFIG_VERSION）与自定义模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DISK/FORMATS/DIR/OPEN_HTML/THEME/TEMPLATE/ROLE/CONFIRM/CONFIG_VERSION）与自定义模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+
+- **THEME**：html 页面主题，tech 深蓝科技（默认）/ biz 浅色商务 / mono 极简黑白 / warm 温暖渐变；生成时写 `<html data-theme="THEME值">` 定默认，页面右下角换肤坞随点随换（localStorage 记忆、?shot 截图模式与打印隐藏）
 
 ## 配置版本机制（升级保护）
 
-本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明的当前版本不一致：
+本 skill 当前配置版本为 `2`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明的当前版本不一致：
 
 1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
@@ -34,13 +36,18 @@ disable-model-invocation: false
 
 升级本 skill 时，配置结构如有变化必须同步更新本节的当前版本号与迁移说明；禁止在未声明版本变更的情况下静默修改配置语义。
 
+**无法迁移项处理**（值域失效 / 语义漂移 / 数据不兼容）：三情形——①旧值不在新值域（如旧模板/主题名已移除）②同名键含义变化（单位/枚举变更）③数据文件 schema 不兼容。三绝不：绝不静默（无法迁移项停下问，不猜值）、绝不丢失（旧值永远在 .bak-时间戳）、一次说清（升级报告三段式：⚠️ 版本与备份路径 → ✅ 已自动迁移清单 → 🟡 无法迁移项逐条附原因+影响+建议替代）；随后 AskUserQuestion 三选项（A 用建议值 / B 用户给新值 / C 保持旧配置——不更新 CONFIG_VERSION，每次执行再提醒）；报告必附回滚一句话；数据文件迁移前先复制 .bak-时间戳，能映射则映射、不能则写兼容层或留备份提示手动整理
+
+当前版本变更记录：v1→v2 新增 THEME 字段（默认 tech；发现旧配置时按迁移规则补默认值）。
+
 ## 文档同步自检纪律（维护者必读）
 
 修改本 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 研发年度总结」）
+- 页面主题四选一（tech 深蓝科技默认 / biz 浅色商务 / mono 极简黑白 / warm 温暖渐变）：THEME 配置定默认，右下角换肤坞随点随换
 - 完整规则（聚合来源 / 纯文字模式 / 写作风格约束 / 使用提示）见 `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

@@ -7,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 循环）
-- 五张分节卡片（实心深蓝底 #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 红；数据卡左侧小色条同概览节色）
+- 复用日报/周报深蓝面板视觉体系：背景 #0a1929 + SVG feTurbulence 微噪点（opacity .04）+ 三层科技底纹（.grid-pattern 60px 青色细网格 var(--scan-dim) + .stars 8 个 1-1.5px 星点白/青/紫/绿散落 + .scanlines 2px 周期扫描线 var(--scan-dim)）；禁用任何 CDN 与外部网络引用（@import、外链 CSS/JS/图片/网络字体一律禁止，页面必须公司内网离线双击可打开、零外部依赖）；字体全用系统本地字体栈 ui-monospace/'SF Mono'/SFMono-Regular/Menlo/Consolas；颜色全部用 CSS 变量统一主题令牌：19 令牌 × 4 主题（tech 深蓝科技（默认，色值与旧 ask 色板一致）/biz 浅色商务/mono 极简黑白/warm 温暖渐变，html[data-theme] 运行时切换；12 核心契约 --bg/--bg2/--panel/--panel-solid/--text/--muted/--accent/--accent2/--border/--glow/--title-grad/--tag-bg + 报告扩展 --glow-soft/--scan/--scan-dim/--heat/--green/--orange/--rose；生成时按 THEME 配置写 data-theme 定默认，页面右下角换肤坞四色点随点随换、localStorage 记忆、?shot 截图模式与打印隐藏）
+- 头部卡片：标题按行业词典「标题」变量取词 + 年份前缀（如「2026 研发年度总结」；话术含职业词 → 该词条标题，未提职业 → 按 ROLE 画像匹配词条，词典外行业 → 「YYYY 年度总结」兜底；词典标题行见 `resources/industry-dictionary.md`）+ 副标题（ROLE 画像或年度区间）+ 生成时间行；speccore ask 同款发光特效：四边 1px 青色浮光线 transparent→var(--accent)→transparent 整条平移扫动（上 scanX 左→右、右 scanY 上→下、下 scanX-rev 右→左、左 scanY-rev 下→上，四线同周期 3s linear 单向平移，亮段完整穿越卡片后消失于两端界外，卡片 overflow:hidden 裁剪；禁止自创 background-position 滚动/常驻辉光/往返摆动/亮段半嵌常驻变体）+ 顶部光斑 cardGlow（radial-gradient ellipse at 50% 10% var(--glow)→transparent 70%，opacity .5→1 + scale 1→1.6，transform-origin top center，3s 循环，头部与每张分节卡片内均放 .card-glow 层）+ 标题文字青色光晕呼吸（text-shadow 双圈 3s 循环）
+- 五张分节卡片（实心深蓝底 #0b1e37 + 1px 白色微透细线 8px 周期淡条纹（repeating-linear-gradient(180deg, rgba(255,255,255,.012) 0 1px, transparent 1px 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 图标不加）
+- 数字选择：用户口述的业务结果指标（响应时间/错误率/转化率/成功率等）优先写入，提交统计（提交数/文件数/行数）仅在无业务指标时兜底，两者都有时业务指标在前、提交统计后置或省略；数字凡有对比基准必带（环比/同比/目标完成度至少其一，如「+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) + 淡青底））
+- 展望节：目标条目卡（目标描述 15px + 量化指标加粗 + 分季度行动节点小胶囊 11px（Q1 起…/Q2 完成…，muted 字 + 青色细边 var(--border) + 淡青底））
 - 年度提交月度柱图（研发词条；其它词条按职业词典图表主题）：.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(--accent)→var(--accent2)，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)、时间线节点与序号徽章放大微旋（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)）、数据卡上浮、按钮上浮/按压回缩
+- hover 微交互：卡片上浮 translateY(-2px) + 阴影加深 + inset 发光增强、条目淡青底 var(--tag-bg)、时间线节点与序号徽章放大微旋（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 之下一层）
+- CRT 扫描光带（.scanband position:fixed、left:0/right:0、height:150px、linear-gradient(180deg,transparent,var(--scan-dim) 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 配置（永久生效）；词典没有的角色按用户描述新增词条