skill-forge-hub 0.1.0 → 0.3.0

package/spec-spec2doc/resources/checklist.md

@@ -0,0 +1,24 @@
+# AI 回验清单（转换后必做）
+
+机械产物不直接交付。AI 转换后必须回验，发现问题修正源稿重新转换，直到通过。
+
+## 回验方法
+
+- Word 内容比对：`pandoc <输出.docx> -t gfm` 反向转回 md，与源 md 逐段比对（章节/段落/表格/列表是否完整无遗漏）
+- 图片嵌入核对：`unzip -l <输出.docx> | grep media` 确认图片全部嵌入；数量与源 md 引用数一致
+- 文件可开性：docx 大小异常（接近 0KB 或数倍膨胀）→ 转换失败信号，重转排查
+- PDF 回验：`pdftotext <输出.pdf> - | wc -l` 文本行数合理（非 0 非异常少）；必要时截图查看版式
+
+## 检查项
+
+- 内容完整：无章节/段落/表格遗漏（反向转换比对）
+- 标题层级：各级标题样式正确，目录（TOC）条目与正文一致
+- 表格：不超宽溢出、无拆裂（超宽表 AI 提前拆分为多表或改列表呈现）
+- 图片：全部嵌入且显示正常（EMF/WMF 源图同样先转 PNG 再转 Word，转换链同 doc2spec 的 images.md：soffice headless → qlmanage → magick）
+- 中文显示：PDF 中文不豆腐块（LaTeX 路径需 CJK 字体，见 pdf-path.md）
+- 乱码/格式错乱：特殊字符、公式、代码块变形 → 修正源稿重转
+
+## 重转纪律
+
+- 每轮回验记录问题清单；修正源稿 → 重新转换 → 再次回验
+- 重转不超过 3 轮；仍不通过时如实报告用户「哪些项无法修复 + 原因」，不交付带错文档

package/spec-spec2doc/resources/images-and-template.md

@@ -0,0 +1,14 @@
+# 图片与模板
+
+## 图片路径
+
+- Pandoc 解析 md 图片相对路径以**当前工作目录**为基准：转换前 cd 到源 md 所在目录，或用 `--resource-path=.:<额外图片目录>` 声明搜索路径
+- 图片缺失时 Pandoc 报「[WARNING] Could not fetch resource」→ AI 核对路径后重转
+- EMF/WMF 源图浏览器/Word 均不可靠：先跨系统转 PNG 再转 Word（转换链同 doc2spec 的 images.md：LibreOffice `soffice --headless --convert-to png` → macOS `qlmanage -t` → Windows `magick`）
+- 转换后回验图片全部嵌入（`unzip -l <输出.docx> | grep media`）
+
+## Word 模板（--reference-doc）
+
+- 探测链（TEMPLATE_DOCX=auto）：<源目录>/template.docx → <源目录>/reference.docx → 无模板用 Pandoc 默认样式
+- 生成默认模板供定制：`pandoc -o <template.docx> --print-default-data-file reference.docx`（用户可在 Word 中改样式后保存为 template.docx 放源目录，永久生效）
+- 指定模板转换：`pandoc <输入.md> -f gfm -t docx -o <输出.docx> --reference-doc=<template.docx> [--toc --toc-depth=3]`

package/spec-spec2doc/resources/pdf-path.md

@@ -0,0 +1,21 @@
+# PDF 双路径
+
+## 路径 A：LaTeX（排版质量高，需安装引擎）
+
+- 引擎探测：`xelatex --version`（xelatex 原生支持 UTF-8 中文）
+- 安装（跨系统）：macOS `brew install --cask basictex`（体积小，装完按需 `sudo tlmgr install ctex`）；Windows `winget install MiKTeX.MiKTeX`；Linux Debian/Ubuntu `sudo apt-get install texlive-xetex texlive-lang-chinese`
+- CJK 字体：`pandoc <输入.md> -o <输出.pdf> --pdf-engine=xelatex -V CJKmainfont="<字体>"`
+  - 字体探测：macOS `fc-list :lang=zh`（常见 Songti SC / PingFang SC）；Windows SimSun / Microsoft YaHei；Linux Noto Sans CJK SC
+  - 未指定时列出可用字体让用户选；探测不到中文字体时放弃 LaTeX 路径走 Chrome 打印路径
+- 转换：`pandoc <输入.md> -o <输出.pdf> --pdf-engine=xelatex -V CJKmainfont="<字体>" -V geometry:margin=2.5cm [--toc]`
+
+## 路径 B：Chrome headless 打印（免 LaTeX，跨系统兜底）
+
+- 流程：`pandoc <输入.md> -s --self-contained -o <输出.html>` → Chrome headless `--headless --print-to-pdf=<输出.pdf> --no-pdf-header-footer <输出.html>`（--no-pdf-header-footer 去掉默认页眉页脚；不支持的老版本 Chrome 用 --print-to-pdf-no-header）
+- Chrome 路径探测（跨系统）：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`；Linux `google-chrome` / `chromium`；均无则换 Edge（路径同族探测）
+- 版式：可加 `--css=<样式.css>` 定制打印版式（页边距、字体）
+- 引擎决策：PDF_ENGINE=auto 时先探测 xelatex，无则走 Chrome 打印路径并在报告注明「PDF 由 HTML 打印生成」
+
+## 引擎缺失兜底
+
+- xelatex 与 Chrome 都缺失：先出 Word（主路径），提示用户用 Word「另存为 PDF」

package/spec-spec2doc/resources/usage-guide.md

@@ -0,0 +1,32 @@
+# spec2doc 使用指南
+
+## 能干什么
+
+把 Markdown 规格 / 技术文档导出为 Word / PDF 交付文档：AI 先整理排版，Pandoc 机械转换，AI 回验纠错直到通过。Word 支持模板（默认探测源目录 template.docx，可配置）；PDF 双路径（LaTeX 或 Chrome 打印，免装 LaTeX 也有兜底）；输出默认与源文档同目录，可配置。
+
+## 使用方式
+
+1. 直接说「把这份规格导出成 Word」「生成 PDF 交付文档」并给出文件路径
+2. 未装 Pandoc 时按引导安装（macOS brew / Windows winget / Linux apt-get）
+3. AI 整理排版（标题层级/表格/图片路径），Pandoc 输出 .docx（主路径）或 .pdf（xelatex / Chrome 打印双路径）
+4. AI 回验内容完整与格式正确（发现问题修正重转，≤3 轮）后交付
+
+## 支持格式
+
+- 输出 Word（.docx，主路径，支持模板与目录）
+- 输出 PDF（.pdf，LaTeX 引擎或 Chrome 打印）
+
+## 常用说法
+
+- 「输出到桌面」→ 临时改输出目录
+- 「用公司模板」+ 路径 → 指定 Word 模板
+- 「不要目录」→ 去掉 TOC
+- 「必须用 LaTeX 出 PDF」→ 强制 LaTeX 路径（无引擎则引导安装）
+
+## 产出
+
+与源文档同目录的 .docx / .pdf，附回验结论与兜底说明。
+
+## 触发词
+
+导出成 Word / 生成 PDF / 规格转文档 / 打包交付文档 / /spec2doc

package/spec-spec2doc/user-config.md

@@ -0,0 +1,22 @@
+# 用户配置（升级技能时本文件不会被覆盖）
+
+> 你的个人配置全放在这里。skill-forge 升级技能时官方只更新 SKILL.md 与 resources/，
+> 本文件始终保留你的版本——输出目录、模板与引擎策略、确认方式放心改。
+> 官方升级若带来新配置点，会另存 `user-config.md.upstream` 对照文件到同目录，
+> 你按需查看并手动合并新配置点到本文件。
+
+
+## ⚙️ 默认配置（用户可手动修改；临时口头要求永远优先）
+
+```yaml
+CONFIG_VERSION: 1              # 配置结构版本：skill 升级时若配置结构变化会递增；AI 每次执行前对比 SKILL.md「配置版本机制」节声明的当前版本，不一致时按 SKILL.md 的迁移规则处理（先备份本文件为带时间戳 .bak，再迁移，最后对话告知用户）
+OUTPUT_DIR: auto              # 输出目录：auto = 与源 md 同目录；可写死绝对路径
+TEMPLATE_DOCX: auto           # Word 模板：auto = 依次探测 <源目录>/template.docx → reference.docx → 无则 Pandoc 默认样式；可指定模板路径
+TOC: true                     # Word/PDF 是否生成目录（--toc --toc-depth=3）
+PDF_ENGINE: auto              # PDF 引擎：auto = 探测 xelatex（有则 LaTeX 路径）→ 无则 Chrome 打印路径
+```
+
+> 临时口头要求（仅对当次生效，不修改上方配置）：说「输出到 XX」→ 当次改 OUTPUT_DIR；说「用这个模板」+ 路径 → 当次换模板；说「不要目录」→ 当次 TOC=false；说「必须用 LaTeX 出 PDF」→ 当次 PDF_ENGINE=xelatex（无引擎则引导安装）。
+
+---
+> 更多用法见 SKILL.md 的「生成流程」与 resources/ 分册。

package/weekly-report/SKILL.md

@@ -1,16 +1,17 @@
 ---
 name: weekly-report
-description: 聚合各仓库 git 提交生成周报（默认本周完成任务/下周计划/风险阻塞点三段结构，中文顿号序号，1D=8H）。支持纯文字/图片/文件整理（无 git 也适用）、自定义模板（可永久或临时指定）、周结束日可配置（默认周五，可改周日等）。支持自然语言定位周（本周/上周/10月第2周/10月20号所在周等）。当用户请求写周报、本周周报、上周周报、生成周报、/weekly-report，或询问周报用法（周报怎么用/周报使用说明/周报有哪些使用方式）时使用。
+description: 生成工作周报（默认本周任务进度/下周计划/风险阻塞点三段结构，中文顿号序号，1D=8H），适配各行业（内置 12 行业职业词典，可指定角色身份）。数据来源灵活：各仓库 git 提交聚合、纯文字、图片或文件整理，无 git 也适用。支持自定义模板（可永久或临时指定）、周结束日可配置（默认周五，可改周日等）。支持自然语言定位周（本周/上周/10月第2周/10月20号所在周等）。当用户请求写周报、本周周报、上周周报、生成周报、/weekly-report，或询问周报用法（周报怎么用/周报使用说明/周报有哪些使用方式）时使用。
 allowed-tools: Bash, Read, Write
 disable-model-invocation: false
 ---
 
 # 周报生成
 
-聚合各仓库 git 提交 + 本次会话口述内容生成三段式周报（本周完成任务/下周计划/风险阻塞点 + 本周概览卡），对话输出 md 正文 + 落盘 md/txt/html/content-png 并自动打开 html。
+聚合各仓库 git 提交 + 本次会话口述内容生成三段式周报（本周任务进度/下周计划/风险阻塞点 + 本周概览卡），对话输出 md 正文 + 落盘 md/txt/html/content-png 并自动打开 html。
 
 ## 生成流程
 
+0. **读用户配置**（DISK/FORMATS/DIR/OPEN_HTML/TEMPLATE/ROLE/CONFIRM/CONFIG_VERSION、自定义模板）→ 先 Read 同目录 `user-config.md`
 1. **解析周**（自然语言 → 目标周：周一起点、WEEK_END 结束日）→ 读 `resources/date-parsing.md`
 2. **收集数据**（本周 git + 会话口述 + 口头补充，合并去重；同取上周数据供概览环比）→ 读 `resources/data-collection.md`
 3. **内容归类与润色**（聚合来源 / 补充任务 / 纯文字模式 / 输出格式 / 写作风格）→ 读 `resources/content-rules.md`
@@ -18,38 +19,28 @@ disable-model-invocation: false
 5. **落盘与截图**（md/txt/html/content-png + 自动打开 html）→ 读 `resources/disk-and-html.md`
 6. **使用咨询**（用户只问「周报怎么用」等用法、未要求生成）→ 读 `resources/usage-guide.md`，将其内容原样输出（首行标题改为「周报生成器使用指南」），不收集 git、不生成报告、不落盘、不开浏览器
 
-## ⚙️ 默认配置（用户可手动修改；临时口头要求永远优先）
+## ⚙️ 配置与自定义模板
 
-```yaml
-DISK: true                     # 是否落盘写文件；false = 默认只在对话输出，不写文件不开浏览器
-FORMATS: [md, txt, html, content-png] # 落盘哪些格式（数组，可删减/增，如 [md, html] / [md, txt, html]（不截图）；content-png = 内容区截图（仅本周概览卡片与本周完成任务/下周计划/风险阻塞点卡片，不含头部标题/复制按钮/页脚），删除该项即不截图；不影响对话中的 md 正文输出）
-DIR: auto                      # 落盘根目录：auto = 按当前系统自动选 DIR_MAC / DIR_WIN（也可直接写死某个绝对路径）
-DIR_MAC: /Users/luzhaosheng/MyWork/智慧食堂/reports    # macOS 落盘根目录（日报按目标日期、周报按当周最后一天建子目录；目录不存在时回退用户主目录下 reports）
-DIR_WIN: d:\Workspace_QCoder\reports                   # Windows 落盘根目录（日报按目标日期、周报按当周最后一天建子目录；目录/盘符不存在时回退用户主目录下 reports）
-OPEN_HTML: true                # 落盘后是否自动用浏览器打开 html（FORMATS 不含 html 时忽略）
-TEMPLATE: default              # 报告模板：default = 内置三段式（本周完成任务/下周计划/风险阻塞点）；custom = 使用下方「📝 自定义模板」节；口头临时指定模板仅当次生效
-ROLE: 全栈开发工程师（企业内技术开发）  # 用户默认职业角色与主要工作内容（两者并存：职业名 + 括号内工作内容，生成内容/术语/量化指标/热力图/柱图/风险话术全部按此画像走）；用户随口描述职业时（如「我搞装修的，天天跑工地」）→ AI 提炼为规范表述（装修项目经理（负责工地现场管理、施工进度与质量巡检））更新此处；说「以 XX 的身份写」→ 当次临时换角色不改配置；说「以后默认用 XX 角色 / 我的职业是 XX / 我的主要工作是 XX」→ 永久更新此处
-WEEK_END: friday               # 周结束日（当周最后一天）：friday = 每周五（默认）；可改 sunday = 每周日、saturday 等；周范围、落盘子目录名均按该天日期
-CONFIRM: never                 # 落盘前确认：never = 直接生成落盘不确认（默认）；text = 纯文字整理模式先出效果确认后再落盘；always = 任何方式生成都先确认；临时说「先看看效果」当次先确认、说「不用确认」当次跳过
-```
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DISK/FORMATS/DIR/OPEN_HTML/TEMPLATE/ROLE/CONFIRM/CONFIG_VERSION）与自定义模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
 
-> 临时口头要求（仅对当次生效，不修改上方配置）：说「不落盘/别写文件」→ 当次 DISK=false；说「写到桌面/存到 ~/report（macOS）或 D:\report（Windows）」→ 当次改用该 DIR；说「只要 md / 只出 html / 只要内容区截图」→ 当次只落指定格式；说「这次不截图」→ 当次不生成内容区截图；说「只要截图/重新截个图」→ 当次只对现有 html 执行内容区截图（不重新收集 git、不重写 md/txt/html 内容文件）；说「别开浏览器」→ 当次 OPEN_HTML=false；说「这周按周日收尾/这周算到周日」→ 当次 WEEK_END=sunday（当次周范围与目录名跟随）；说「这次按 xxx 模板来」→ 当次临时换模板（不改配置）；说「以后都用这个模板」→ 自动写入下方「📝 自定义模板」节并把 TEMPLATE 改为 custom（永久生效）；说「先看看效果/先出效果再落盘」→ 当次先出效果确认后再落盘；说「不用确认/直接落盘」→ 当次跳过确认直接落盘。
+## 配置版本机制（升级保护）
 
-## 📝 自定义模板（TEMPLATE: custom 时启用，用户可手改，适配各类岗位）
+本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明的当前版本不一致：
 
-把顶部 TEMPLATE 改为 custom 后，按下面结构生成报告（段名、段数、条目格式均可改）：
+1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
+3. 更新 CONFIG_VERSION 为当前版本
+4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」
 
-```text
-段一：本周工作内容（每条：工作描述 - 完成情况）
-段二：存在问题与困难（只列描述）
-段三：下周工作计划（每条：计划描述 - 预计完成时间）
-```
+升级本 skill 时，配置结构如有变化必须同步更新本节的当前版本号与迁移说明；禁止在未声明版本变更的情况下静默修改配置语义。
 
-> 只写段结构与条目格式即可；未写明的细节（中文顿号序号、生成时间行、落盘行为、HTML 样式）沿用默认规范。
+## 文档同步自检纪律（维护者必读）
+
+修改本 skill 任一文件（SKILL.md / user-config.md / resources/*）后，必须 grep 全文核对相关关键词在各文件间一致（如章节名/字段名/效果参数改名时新旧词全仓核对，旧词零残留才算完成）。修改 HTML 效果必须同步更新 `resources/reference.html` 与 `disk-and-html.md` 对应描述，三者以 reference.html 为真相源；改完后互相 grep 关键参数确认对齐。
 
 ## 规则速览
 
-- 完成任务 5-15 点、每点 30-60 字；序号用中文顿号（1、2、3）
+- 任务进度 5-15 点、每点 30-60 字；序号用中文顿号（1、2、3）
 - 三段兜底写「暂无」；计划点带进度百分比与预估用时；风险阻塞点三环（问题+影响+建议）
 - 用时单位 X.XD（天，1D=8H），估算值注明「约」；落盘子目录名 = 当周最后一天（WEEK_END）日期
 - 完整规则（聚合来源 / 纯文字模式 / 写作风格约束 / 使用提示）见 `resources/content-rules.md`

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

@@ -1,24 +1,24 @@
 # 内容规则
 
 ## 输出内容与数据来源
-- 三段结构：本周完成任务（5-15 点）/ 下周计划 / 风险阻塞点
+- 三段结构：本周任务进度（5-15 点）/ 下周计划 / 风险阻塞点
 - 任务点格式：1、任务描述（量化数据：文件数/行数/提交次数）- 进度XX% - 用时X.XD（1D=8H）
 - 任务来源（默认）：各仓库本周 git 提交自动聚合（同主题多日提交合并为一条）+ 本次会话中用户已提及/口述的工作内容 + 用户口头补充，全部合并去重；仅当用户明确说"只整理这段文字/只按这段"时才忽略 git 与会话上下文、只用指定文字（见「纯文字整理模式」）
-- 「下周计划」取材双通道：①用户口述/文字补充的计划（优先并入）；②一次生成多周周报、或后续日期日报已生成时（本次批量生成中下一周的周报，或 reports 目录中已存在的后续日报/下周周报），从下一周周报的「本周完成任务」（无下周周报时从下周各日报的完成任务）中抽取任务作为「下周计划」（抽取数量灵活、不设死上限：下周完成任务多且连续性强时可多抽至 5-6 条，少则抽 2-3 条，与下一周内容形成呼应即可），描述改写为计划语气（完成态改进行态：如「完成 XX 重构」→「推进 XX 重构」「继续 XX 开发」，去掉量化数据/进度/用时）；批量多周时优先保证跨周连续性：抽取时尽量让本周「下周计划」与下一周「本周完成任务」形成「计划→完成」的同主题承接链（如本周计划「启动 XX 重构」→ 下周完成「完成 XX 重构」，长期任务串成连续的工作链）；无后续数据时，该段按口述或「暂无」处理
+- 「下周计划」取材双通道：①用户口述/文字补充的计划（优先并入）；②一次生成多周周报、或后续日期日报已生成时（本次批量生成中下一周的周报，或 reports 目录中已存在的后续日报/下周周报），从下一周周报的「本周任务进度」（无下周周报时从下周各日报的任务进度）中抽取任务作为「下周计划」（抽取数量灵活、不设死上限：下周完成任务多且连续性强时可多抽至 5-6 条，少则抽 2-3 条，与下一周内容形成呼应即可），描述改写为计划语气（完成态改进行态：如「完成 XX 重构」→「推进 XX 重构」「继续 XX 开发」，去掉量化数据/进度/用时）；批量多周时优先保证跨周连续性：抽取时尽量让本周「下周计划」与下一周「本周任务进度」形成「计划→完成」的同主题承接链（如本周计划「启动 XX 重构」→ 下周完成「完成 XX 重构」，长期任务串成连续的工作链）；无后续数据时，该段按口述或「暂无」处理
 - 量化数据取自 git --stat（文件数、增删行数）；用时为合理估算（git 不记录耗时，估算值注明"约"，可口头修正）
 - 数据收集范围（按当前系统自动选择，另一系统的仓库自动跳过）：macOS = NearCast / nearcast-server / nearcast-go / nearcast-admin / SmartCanteenConsumerMachineApp / TrustPay 共 6 个仓库；Windows = srf-app / srf-manage / srf-operation / srf-service / srf-web-user / srf-web-operation / srf-web-wx / srf-web-h5-teacher / srf-web-uop / Spec-Core-Smart-Canteen 共 10 个仓库；本周无提交的仓库不写入
-- HTML 版为参考图式深蓝面板卡片美化样式（实心深蓝卡片 + 细密水平条纹 + 上下边缘高光线 + 左缘节色条，保留 ask 同款发光动效）：附「本周概览」Bento 卡片（完成率圆环大卡 + 提交热力图 5天×3时段 + 提交数/活跃天数/涉及文件/代码行数四指标 + 提交节奏柱图带 hover 明细 + 环比行）、顶部「一键复制」按钮（复制纯文本版）+ TL;DR 摘要行、「本周完成任务」标题右侧带周范围徽章（跟随 WEEK_END）+ 进度条终点圆点与流星扫描填充 + 液态玻璃卡片（@supports 兜底）+ CRT 扫描光带 + 全页 3D 微倾斜（±0.75°）、页脚署名 GENERATED BY SPECCORE TEAM（周范围动态跟随 WEEK_END），并随 FORMATS 默认落一张内容区截图 content-png（概览与卡片整体 + 四周留白 + 周范围徽章）
+- HTML 版为参考图式深蓝面板卡片美化样式（实心深蓝卡片 + 细密水平条纹 + 上下边缘高光线 + 左缘节色条，保留 ask 同款发光动效）：附「本周概览」Bento 卡片（完成率圆环大卡 + 提交热力图 5天×3时段 + 提交数/活跃天数/涉及文件/代码行数四指标 + 提交节奏柱图带 hover 明细 + 环比行）、顶部「一键复制」按钮（复制纯文本版）+ TL;DR 摘要行、「本周任务进度」标题右侧带周范围徽章（跟随 WEEK_END）+ 进度条终点圆点与流星扫描填充 + 液态玻璃卡片（@supports 兜底）+ CRT 扫描光带 + 全页 3D 微倾斜（±0.75°）、页脚署名 GENERATED BY SPECCORE TEAM（周范围动态跟随 WEEK_END），并随 FORMATS 默认落一张内容区截图 content-png（概览与卡片整体 + 四周留白 + 周范围徽章）
 
 ## 用户补充任务
 
 用户调用时可能口头追加任务（如"还有一件事：这周处理了两天的支付问题"），按以下规则处理：
 
 - **触发**：话术含"补充/加上/还有/另外/以及/对了"等追加词，或直接口述任务内容（说"整理成周报/只整理这段文字/只按这段/不用 git"时走「纯文字整理模式」，不是追加）
-- **分段**：补充内容带分段词时按段并入——"下周计划/计划：xxx"→ 下周计划段；"风险/阻塞：xxx"→ 风险阻塞点段（说"风险暂无/无风险"→ 风险段写「暂无」）；不带分段词默认并入"本周完成任务"
+- **分段**：补充内容带分段词时按段并入——"下周计划/计划：xxx"→ 下周计划段；"风险/阻塞：xxx"→ 风险阻塞点段（说"风险暂无/无风险"→ 风险段写「暂无」）；不带分段词默认并入"本周任务进度"
 - **拆条**：按语义主题拆分，一个主题一条；拆分信号：时间词（周几/上几天）、追加连接词、分号顿号列举、数字列举（1、2、3）
 - **润色**：口语整理为规范任务描述（动词开头、说清对象与结果）；周报粒度较粗，多条零散小任务合并为一个周交付物条目（30-60 字）；用户未给量化数据时，优先从 git 提交补文件数/行数，无记录则省略量化、只写进度与用时（估算值注明"约"）
 - **去重**：与 git 聚合任务合并时，同一件事只保留一条
-- **格式**：与 git 聚合条目同格式，接在"本周完成任务"下继续编号
+- **格式**：与 git 聚合条目同格式，接在"本周任务进度"下继续编号
 
 ## 纯文字整理模式（用户贴一段文字，无 git 提交）
 
@@ -29,14 +29,14 @@
 - **三段归类**（用户文字没按段写明时用信号词归类）：
   - 含"下周/接下来/计划/准备/打算/将要/待办" → 下周计划
   - 含"风险/阻塞/问题/卡住/困难/待定/依赖/遗留" → 风险阻塞点
-  - 其余 → 本周完成任务；全段无任何信号词 → 全部归入本周完成任务
+  - 其余 → 本周任务进度；全段无任何信号词 → 全部归入本周任务进度
   - 用户已明确分段（"本周完成：A；下周计划：B；风险：C"）→ 按用户分段，不猜
 - **拆条**：按语义主题拆分，一个主题一条；拆分信号：时间词（周几/前几天）、连接词（还有/另外/以及）、分号顿号列举、数字列举（1、2、3）、换行/段落边界
 - **润色**：口语整理为规范任务描述（动词开头、说清对象与结果）；周报粒度较粗，多条零散小任务合并为一个周交付物条目（30-60 字）
 - **量化数据**：无 git 提交 → 不写文件数/行数/提交次数；格式退化为「1、任务描述 - 进度XX% - 用时X.XD」
 - **进度与用时**：文字没给进度时，完成任务默认 100%、计划默认 0%；用时/预估用时仅在用户文字给出时才写，没给就省略（不瞎编估算值）
 - **风险阻塞点**：只列描述
-- **周定位/落盘/HTML**：与常规流程一致（默认本周、md/txt/html 三文件 + 内容区截图落盘、html 自动打开）；html 概览卡片无 git 数据时只显示完成任务/计划/风险条数统计
+- **周定位/落盘/HTML**：与常规流程一致（默认本周、md/txt/html 三文件 + 内容区截图落盘、html 自动打开）；html 概览卡片无 git 数据时只显示任务进度/计划/风险条数统计
 
 ## 输出格式
 
@@ -45,7 +45,7 @@
 
 > 生成时间：YYYY-MM-DD HH:MM:SS
 
-## 本周完成任务
+## 本周任务进度
 1、任务描述（量化数据：文件数/行数/提交次数）- 进度XX% - 用时X.XD
 
 ## 下周计划
@@ -57,9 +57,9 @@
 
 ## 规则
 
-- 完成任务 5-15 点，每点 30-60 字；序号用中文顿号（1、2、）
+- 任务进度 5-15 点，每点 30-60 字；序号用中文顿号（1、2、）
 - 聚合后任务数超上限（15 点）时，同类小任务合并压缩到上限内；用户说「精简点/太长了」→ 条目数取下限、每点压缩到 30 字左右；说「详细点」→ 条目数取上限、每点写足 60 字
-- 三段兜底：完成任务默认进度 100%；本周完成任务/下周计划/风险阻塞点无任何内容时该段写「暂无」（默认聚合时下周计划无 git 来源，用户没给计划就写「暂无」）
+- 三段兜底：任务进度默认 100%；本周任务进度/下周计划/风险阻塞点无任何内容时该段写「暂无」（默认聚合时下周计划无 git 来源，用户没给计划就写「暂无」）
 - 计划每点带进度百分比与预估用时
 - 风险阻塞点三环结构：问题+影响+建议，不写进度用时
 - 用时单位：X.XD（天，1D=8H），估算值注明"约"

package/weekly-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` 与本文档的对应描述，禁止只改一处。
+
 # 本地落盘（默认行为）
 
 - 落盘根目录读取顶部「默认配置」的 `DIR`（默认 `auto`：按当前系统自动选 `DIR_MAC` / `DIR_WIN`），按当周最后一天（WEEK_END 对应的日期，默认周五）建子目录（macOS：`<DIR>/YYYY-MM-DD/`；Windows：`<DIR>\YYYY-MM-DD\`，目录不存在则自动创建）；改配置节里的 DIR / DIR_MAC / DIR_WIN 即可改变全局默认位置，改 WEEK_END 即可改变目录锚点日期
@@ -5,8 +7,8 @@
 - 使用时用户临时指明位置（如"写到桌面"、"存到 ~/report（macOS）/ D:\report（Windows）"，覆盖 DIR、仅当次生效）：以用户指定位置为根目录，同样按当周最后一天日期子目录；"桌面"映射：macOS=`~/Desktop`、Windows=`%USERPROFILE%\Desktop`；目录不存在自动创建
 - 每次生成落盘哪些文件读取顶部「默认配置」的 `FORMATS`（默认 md/txt/html/content-png 四个，md/txt/html 文件名 `weekly-report-YYYYMMDD~YYYYMMDD.<格式>`、截图文件名 `weekly-report-YYYYMMDD~YYYYMMDD-content.png`；txt 为纯文本版）；`DISK: false` 时全部不落盘
 - 对话中照常输出 md 正文（不受 FORMATS 影响）；`OPEN_HTML: true` 且本次落盘了 html 时，自动打开浏览器（macOS：`open <html文件>`；Windows PowerShell：`Start-Process <html文件>`）
-- FORMATS 含 content-png 时额外生成内容区截图 `weekly-report-YYYYMMDD~YYYYMMDD-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 + 概览卡片~120 + 每节卡片(45+条目数×70+40，含各卡片 margin-bottom 18) + 余量~15，底部留白仅 body 下 padding 40px、与顶部对称，余量只防截断不可多给），截图后用 Read 校验：概览与三张卡片整体完整在图内、无头部/按钮/页脚残留、四周留白对称合适、不截断，底部留白过大则减高度、截断则加高度重截
-- md/txt/html 均含生成时间行，精确到时分秒（如 2026-10-22 19:10:38）；HTML 采用参考图式深蓝面板风格 + ask 同款发光动效的融合样式（不换其它色系，颜色全部用 CSS 变量统一 ask 色板：--cyan #0ea5e9、--bg #0a1929、--card #0b1e37、--border rgba(14,165,233,.15)、--text #bae6fd、--muted #5b7fa5、--green #14b8a6、--orange #f97316、--purple #6366f1、--rose #f43f5e）：禁用任何 CDN 与外部网络引用（@import、外链 CSS/JS/图片/网络字体一律禁止，页面必须公司内网离线双击可打开、零外部依赖），字体全用系统本地字体栈 ui-monospace/'SF Mono'/SFMono-Regular/Menlo/Consolas/'Microsoft YaHei'/monospace（macOS 走 SF Mono/Menlo、Windows 走 Consolas，中文回退 Microsoft YaHei；字母数字等宽自带科技感），正文同栈 400、标题同栈 900 渐变文字（var(--cyan) #0ea5e9→var(--purple) #6366f1，background-clip:text，发光用 ask-result 模板同款 text-shadow 双圈（titleGlow 动画 3s 呼吸：基线 20px/.4 + 60px/.15 ↔ 峰值 30px/.7 + 80px/.3，h1 留静态基线；24px 小字同参数观感与官方一致，禁止改三圈小模糊——会糊在字内边界不清））；页面背景纯深蓝黑 #0a1929（参考图同款色值）、正文浅青 #bae6fd、全屏极轻微噪点纹理（body::before fixed 覆盖层，background-image 用 SVG feTurbulence data URI（<svg xmlns='http://www.w3.org/2000/svg' width='240' height='240'><filter id='n'><feTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='2' stitchTiles='stitch'/><feColorMatrix type='saturate' values='0'/></filter><rect width='100%' height='100%' filter='url(#n)'/></svg>），opacity .04，pointer-events:none，z-index 0 在卡片之下，消除大面积纯色死板感），body 纯 #0a1929 背景不加径向辉光（onboarding 同款）；全屏背景叠加 speccore dashboard 同款三层科技感底纹：60px 网格底纹（.grid-pattern fixed inset 0，background-image linear-gradient(rgba(0,240,255,.03) 1px, transparent 1px) 纵横双向、background-size 60px 60px、z-index 0）+ 彩色星点层（.stars fixed inset 0，8 个 1-1.5px 星点 radial-gradient(1px 1px at <位置>, <色>, transparent) 多背景组合：白色 rgba(255,255,255,.3-.4) 与青色 rgba(0,240,255,.45-.5)、紫色 rgba(168,85,247,.4)、绿色 rgba(0,255,136,.4)，位置分散 10%-90%，z-index 0）+ 全屏 2px 周期细扫描线（.scanlines fixed inset 0，repeating-linear-gradient(0deg, transparent 0 2px, rgba(0,240,255,.015) 2px 4px)，z-index 999 罩最上层，pointer-events none；三层均 fixed 不随滚动，营造星野+网格+扫描的科技氛围，不破坏参考图纯深蓝黑质感）；内容区宽度响应窗口自适应（.wrap width:clamp(640px, 60%, 1200px) + margin:0 auto：最小 640px、最大 1200px、中间按窗口 60% 缩放，页面左右留白对称）；头部卡片参考图式实心深蓝底（var(--card) 实心 #0b1e37，略亮于背景、更偏蓝）+ 8px 周期细密水平条纹（background-image 叠加 repeating-linear-gradient(180deg, rgba(255,255,255,.012) 0 1px, transparent 1px 8px)）+ 上下边缘 1px 微亮描边（border-top/border-bottom 1px solid #0f3350，参考图「边缘点亮一线」效果，与 ask 四边浮光扫描线动画共存、动画层在上）+ 圆角 6px + 外发光与 inset 内发光（0 0 20px rgba(14,165,233,.08) + inset 0 1px 24px rgba(14,165,233,.04)），overflow:hidden，标题区仅标题与青色胶囊生成时间徽章（badge 后直接收尾，不加底部细线/装饰光带，避免悬空多余线）；标题与徽章下加 TL;DR 一句话摘要行（.summary-line flex 布局 max-width 540px 居中：左侧 .summary-tag「TL;DR」青色小标签 系统等宽 10px 粗体、rgba(14,165,233,.35) 细边圆角 4px、rgba(14,165,233,.07) 底、青色 text-shadow 光晕 + 右侧 .summary-text 12.5px 浅青正文 line-height 1.75 text-align left；摘要带判断给结论——整体节奏/主要风险/下周重点，不罗列条目）；「本周概览」摘要卡片 Bento 网格布局（参考图式质感：实心深蓝底 #0b1e37 + 8px 周期细密水平条纹 + 上下边缘 1px 微亮描边 + 左缘 8px 亮蓝色条 linear-gradient(180deg,#38bdf8,#0ea5e9) 带同色光晕 + 圆角 6px + overflow:hidden + 内放 .card-glow 光斑层；.ov-bento display:grid、grid-template-columns:104px 1fr 1fr、grid-template-rows:auto auto auto、gap:10px）：完成率圆环大卡（.ring-box 跨 col1 row1/4 整列贯穿、内放青色渐变描边完成率圆环 + 中央大数字 + .ring-label「N/N 项已交付」小字）+ 提交热力图卡（.heat-card 跨 col2/4 row1：标题行「提交热力图」+ .heat-grid 5天×3时段（上午/下午/晚上）15 格 GitHub 式色阶 .hm[data-v="0"~"3"] 四档（0 rgba(14,165,233,.07) 底 / 1 rgba(14,165,233,.3) / 2 rgba(14,165,233,.55) / 3 rgba(34,211,238,.8) 带 glow）+ .heat-days 底部周几标签（padding-left:26px 补偿时段标签列）+ .htip hover 浮层（深蓝底青边圆角 tooltip 显示「周X上/下/晚 · N 次」）；热力图格子 JS 入场错峰 animationDelay .55+i*.04s）+ 四个 .ov-item 指标胶囊（自动流排入剩余格：提交数 data-count、活跃天数 data-count、涉及文件 data-count、代码行数 .ov-num-static 双行（主数字 +18.4k + small 行 −12.7k 删行 --rose 玫红），每个 .ov-item 胶囊细边单元格 rgba(14,165,233,.12) 1px 边 + rgba(14,165,233,.03) 底，.ov-num 系统等宽 24px 青色发光数字 + .ov-label 11px 青灰标签）+ 底部 .ov-compare 环比行（11.5px 青灰小字居中「vs 上周：提交 14 → 18（+29%）· 完成任务 3 → 5（+67%）」，上涨用 --green 绿、下跌用 --rose 红；环比数据来自上周同范围 git log 与完成条目统计）+ 提交节奏柱图（.cb-col 5 根柱周一到周五、柱高按提交数、position:relative 柱上带 .cb-tip hover 浮层显示「周X · N 次提交 · 主题词」）+ 分节卡片同参考图式质感（实心深蓝底 #0b1e37 + 8px 周期细密水平条纹 + 上下边缘 1px 微亮描边 #0f3350 + 圆角缩小至 6px + overflow:hidden，保留阴影与 inset 内发光，去掉原全框青色细边），每张分节卡片左侧带参考图式左缘色条（8px 宽竖线贯穿整卡高度，节色渐变带同色光晕：完成 linear-gradient(180deg,#5eead4,#14b8a6) / 计划 linear-gradient(180deg,#fdba74,#f97316) / 风险 linear-gradient(180deg,#fda4af,#e11d48)，box-shadow 0 0 12px 同色 30% 透明度；卡片内容 padding-left 24px 避让色条），节标题带 18px 同色渐变 SVG 语义图标+文字微光晕（h2 flex 布局 gap 10px，图标替换原竖向短条：完成=圆形对勾、计划=日历、风险=三角警示；inline SVG 内 linearGradient 同节色系渐变 完成 #5eead4→#14b8a6 / 计划 #fdba74→#f97316 / 风险 #fda4af→#e11d48 + 白色描边细节 + drop-shadow 同色光晕；标题色：完成青绿 #5eead4、计划橙 #fdba74、风险玫红 #fda4af + h2 文字同色双圈发光字 3s 呼吸 secGlow 动画（基线 14px/.45+40px/.18 ↔ 峰值 22px/.75+60px/.3，各节动画用本节主题色，与主标题同节奏；仅节标题文字发光，SVG 图标与日期徽章不加））+ 「本周完成任务」节标题右侧带周范围小胶囊徽章 sec-date（margin-left:auto 推右、flex:0 0 auto；11px var(--muted) 字、padding 3px 10px、圆角 999px、青色细边 rgba(14,165,233,.18)、背景 rgba(14,165,233,.05)，如 2026-10-19 ~ 2026-10-25；徽章周范围与周报标题/目录名/git 收集范围完全同源、同步跟随 WEEK_END 配置（含临时说「这周按周日收尾」）；仅完成节显示、计划/风险节不加，让截图自带具体周范围）+ 条目 3D 立体圆球序号徽章（28px 白字，立体感克制的柔和球面——弱化版三段收窄色阶：受光球面渐变 radial-gradient（受光点 circle at 30% 28%，浅亮→主色→深色：完成 #7dd9cf→#14b8a6→#0d9488、计划 #fdc69a→#f97316→#ea580c、风险 #fdaab4→#f43f5e→#e11d48）+ inset 右下内暗影 -3px -4px 6px rgba(0,0,0,.3) 与左上内亮缘 1px 2px 3px rgba(255,255,255,.2) + ::before 左上椭圆高光点（position:relative 定位，top 5px/left 7px、8x6px、rotate -28deg、白色径向渐隐 rgba(255,255,255,.7)→0）+ 底部投影 0 2px 4px rgba(0,0,0,.25) 与同色光晕 0 0 8px + 数字 text-shadow 0 1px 1px rgba(0,0,0,.25) 贴球面） + 条目内部留白：li 水平 padding 10px（hover 淡青底 rgba(14,165,233,.06) 与文字间留 10px 间距）+ 序号圆形徽章 28px（数字距圆边约 8px，不贴圆边）+ 列表轻微缩进 12px（ol/ul padding 0 12px）+ 描述与进度双层错落排版（描述 15px、进度用时 12px 青灰小字 #5b7fa5、百分比加粗强调且两侧 margin 0 2px 呼吸留白、进度与用时之间用「 - 」连接（与 md/txt 版一致，不用 · ）、条目间青色虚线分隔）；风险节条目三环展开：desc 主行（问题）+ meta 影响行（12px 青灰小字「影响：xxx」）+ .advice 建议行（12px 青色小字，「建议：」加粗前缀，margin-top 6px）；md/txt 版同条目依次写问题、影响、建议，文本格式不变+ 青色渐变 40px 大胶囊「一键复制」按钮（var(--cyan)→#0284c7，30px 青色光晕，hover 45px 光晕上浮，模板同款；flex 居中布局，内置 16px 内联 SVG 双矩形复制图标（白色 currentColor 描边、图标与文字 gap 8px、禁用 emoji 图标），复制成功后图标切换为对勾 SVG、文字短暂变「已复制」）；头部 speccore ask 风格发光特效（与 ask 页面完全同款）：四边 1px 青色浮光线，渐变 transparent→var(--cyan)→transparent 整条线平移扫动（亮段长、无 box-shadow 光晕，四边亮段构成顺时针环绕循环，与 ask 看板卡片完全同款（上横线 scanX 左→右、右竖线 scanY 上→下、下横线 scanX-rev 右→左、左竖线 scanY-rev 下→上，四线同周期同速度 3s linear 单向平移）；实现为 1px 整线渐变元素平铺整条边（上/下横线 left:0/right:0 + height:1px + linear-gradient(90deg, transparent, var(--cyan), transparent)；左/右竖线 top:0/bottom:0 + width:1px + linear-gradient(180deg, transparent, var(--cyan), transparent)），随线体 translateX/translateY 平移 ±100%（相对线长）：scanX -100%→100%、scanX-rev 100%→-100%、scanY -100%→100%、scanY-rev 100%→-100%；亮段（线中央渐变段）完整穿越卡片后消失于两端界外（卡片 overflow:hidden 裁剪），带「出现→穿越→消失」节奏；禁止自创 background-position 滚动/常驻辉光/往返摆动/亮段半嵌常驻等变体）+ 顶部光斑 ask 同款 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 循环）；入场动画：头部淡入下滑、卡片依次错峰上浮淡入（完成 0.26s/计划 0.4s/风险 0.54s）、按钮弹入；hover 微交互：卡片上浮+阴影加深+inset 发光增强、条目淡青底、序号徽章放大微旋、按钮上浮/按压回缩；页脚 10px muted 文字（无分隔线、不加边框），署名固定 GENERATED BY SPECCORE TEAM · <周范围>（动态跟随 WEEK_END，如 GENERATED BY SPECCORE TEAM · 20261019 ~ 20261025）；三段分节列表，任务点保持中文顿号序号；进度条终点圆点 + 流星扫描填充（.pbar-fill 必须 display:block + position:relative——行内 span 忽略 width/height 会变成 0×0，填充与圆点全部不可见；.pbar-fill::before 终点圆点 7px 径向渐变圆 right:0 + transform:translate(50%,-50%) 骑在填充右缘（done 青绿 radial-gradient(circle at 35% 30%,#a7f3d0,#2dd4bf 62%,#0d9488)、plan 橙 #fdba74/#f97316/#c2410c，box-shadow 同色光晕、z-index:2；.pbar-track/.pbar-fill 均不得加 overflow:hidden——圆点右半伸出填充 3.5px 骑边渲染）；流星 = JS 注入 .pbar-track 内的 .pbar-sweep（absolute 左贴轨道、width:0 起点隐藏、height:16px、transform:translateY(-50%) 垂直居中、z-index:1、pointer-events:none）+ 其右缘 .pbar-comet 光体（13×7px 小号横向椭圆青白光核（高度仅约 1.4 倍条高、宽度约 2.6 倍条高，严禁 20px 大圆球形态）background 双层 radial-gradient：右前缘青蓝冷光 radial-gradient(ellipse 60% 70% at 72% 45%,rgba(125,211,252,.85),transparent) + 青白核 radial-gradient(circle at 40% 40%,#fff,rgba(224,254,255,.95) 45%,rgba(153,246,228,.5) 75%,transparent)，box-shadow 双圈柔光 0 0 5px 2px rgba(186,230,253,.75) + 0 0 12px 4px rgba(45,212,191,.3)——光晕总高控制在 2~2.5 倍条高以内，不用 drop-shadow；::after 彗尾 right:62%、78×7px 细长锥形拖尾 linear-gradient(90deg,transparent,rgba(153,246,228,.18) 26%,rgba(186,230,253,.55) 64%,rgba(255,255,255,.9)) + clip-path:polygon(0 42%,100% 0,100% 100%,0 58%) 向左收尖成 1px 尖点 + blur 1px——长度约 6 倍头宽、白→青→透明三段渐变的「细尾亮头」流星形，禁椭圆水滴块、禁矩形方块形；::before 星屑仅尾后少量细碎粒子：2px 白点 + 6 颗 box-shadow 星屑（x -40~+7 / y -5~+4 沿尾散布、rgba(255,255,255,.4~.85) 近亮远淡）+ starTwinkle .8s ease-in-out infinite alternate 明灭闪烁——禁止十几颗大星屑环绕头部成大团；opacity:0 常驻隐藏）；.pbar-track.sheen-on 时 sweep transition:width 1.1s cubic-bezier(.3,.8,.4,1) 生长（comet 贴 sweep 右缘 left:100% 随宽度从左扫到右），comet 同步 animation:cometFade 1.1s（7% 淡入、86% 保持、100% 到终点消失）；扫动终点按各条目标进度 data-w：sheen 内 sweep inline width 终点 = data-w（done 条 100% 扫满轨道、有进度的 plan 条如 30% 即 30% 停在进度点不越界）——sweep 宽度过渡与 fill 宽度过渡同参数天然同步，comet 与彗尾/星屑无需任何反向补偿（scaleX 压缩方案会把彗尾一同拉长数倍，禁用）；填充同步生长：入场 sheen(el,'wave') 给 fill 设 transition width 1.1s 同 easing + width 0→data-w，与流星同步——流星扫到哪、填充长到哪，流星到终点消失、留下各自进度，之后填充保持不再变化；圆点 .pbar-done/.pbar-plan .pbar-fill.sheen-on::before animation:dotPulse 1.1s（90% 处 filter:brightness(2) + 白光 drop-shadow 爆亮，done/plan 通用）流星到达终点时爆亮；流星注入与入场波浪覆盖完成条 + 有进度的计划条（JS 遍历 .pbar-track：plan 且进度<=0 的条 return 跳过——0 进度的计划条不注入流星、不扫、保持静态），其余条 data-w 记录目标进度后 fill 归零；入场波浪：setTimeout 1500+i*420ms 逐条 sheen(el,'wave') 错峰（上→下必然可见）；hover 重扫：li 上 mouseenter+pointerenter 双监听，sheen(el,'hover') 只 remove/add fill 与 track 的 sheen-on 类重放流星扫过（comet 再扫一遍，0 进度的 plan 条同样跳过），fill 宽度与颜色完全不重置（进度不再变化），sheen(el,src) 按来源独立节流（wave 1s / hover 300ms）；重启动画 remove 类→sweep inline 归零 width:0（transition:none 无过渡）→void offsetWidth 强制回流→同步 add 类→sweep inline 目标 width=data-w（恢复 transition；双 RAF 在 headless 虚拟时间下不推进，不可用））；液态玻璃（@supports((backdrop-filter:blur(1px)) or (-webkit-backdrop-filter:blur(1px))) 内 .overview/.section 加 backdrop-filter:blur(16px) saturate(1.35) + background-color:rgba(11,30,55,.42)，不支持的老浏览器走默认实心深蓝不白屏）；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 之下一层）；全页 3D 微倾斜（body 添加 perspective(900px)，页面容器 transform:rotateY(calc(var(--mx)*1.5deg)) rotateX(calc(var(--my)*-1.5deg))（±0.75° 极轻微），JS 监听 mousemove 更新 --mx/--my（-1~1 归一化，平滑过渡 transition transform .18s ease-out），移动端无 mousemove 保持 0 不倾斜）；禁止写 @media (prefers-reduced-motion: reduce) 禁用动画的媒体查询块（官方模板无此块，用户系统开启减少动画时该块会禁用全部动效，是竖线不动/发光不呼吸的根因）；页面 JS 需支持 `?shot=content` 参数（检测 location.search 含 shot=content 时给 header-card、copy-wrap、footer 设 display:none，body 四周 padding 统一 40px，供主体内容整体截图用、保证截图四周留白对称合适）
+- FORMATS 含 content-png 时额外生成内容区截图 `weekly-report-YYYYMMDD~YYYYMMDD-content.png`：整页内容区截图一张（头部标题卡片 + 本周概览卡片与本周任务进度/下周计划/风险阻塞点分节卡片整体截出，头部卡片必须带上，图片四周保留对称合适的外边距约 40px 留白）：html 内置 `?shot=content` 参数（页面 JS 检测后仅统一 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 + 头部标题卡片~180 + 概览卡片~120 + 每节卡片(45+条目数×70+40，含各卡片 margin-bottom 18) + 余量~15，底部留白仅 body 下 padding 40px、与顶部对称，余量只防截断不可多给），截图后用 Read 校验：头部标题卡片、概览卡片与三张分节卡片整体完整在图内、四周留白对称合适、不截断，底部留白过大则减高度、截断则加高度重截
+- md/txt/html 均含生成时间行，精确到时分秒（如 2026-10-22 19:10:38）；HTML 采用参考图式深蓝面板风格 + ask 同款发光动效的融合样式（不换其它色系，颜色全部用 CSS 变量统一 ask 色板：--cyan #0ea5e9、--bg #0a1929、--card #0b1e37、--border rgba(14,165,233,.15)、--text #bae6fd、--muted #5b7fa5、--green #14b8a6、--orange #f97316、--purple #6366f1、--rose #f43f5e）：禁用任何 CDN 与外部网络引用（@import、外链 CSS/JS/图片/网络字体一律禁止，页面必须公司内网离线双击可打开、零外部依赖），字体全用系统本地字体栈 ui-monospace/'SF Mono'/SFMono-Regular/Menlo/Consolas/'Microsoft YaHei'/monospace（macOS 走 SF Mono/Menlo、Windows 走 Consolas，中文回退 Microsoft YaHei；字母数字等宽自带科技感），正文同栈 400、标题同栈 900 渐变文字（var(--cyan) #0ea5e9→var(--purple) #6366f1，background-clip:text，发光用 ask-result 模板同款 text-shadow 双圈（titleGlow 动画 3s 呼吸：基线 20px/.4 + 60px/.15 ↔ 峰值 30px/.7 + 80px/.3，h1 留静态基线；24px 小字同参数观感与官方一致，禁止改三圈小模糊——会糊在字内边界不清））；页面背景纯深蓝黑 #0a1929（参考图同款色值）、正文浅青 #bae6fd、全屏极轻微噪点纹理（body::before fixed 覆盖层，background-image 用 SVG feTurbulence data URI（<svg xmlns='http://www.w3.org/2000/svg' width='240' height='240'><filter id='n'><feTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='2' stitchTiles='stitch'/><feColorMatrix type='saturate' values='0'/></filter><rect width='100%' height='100%' filter='url(#n)'/></svg>），opacity .04，pointer-events:none，z-index 0 在卡片之下，消除大面积纯色死板感），body 纯 #0a1929 背景不加径向辉光（onboarding 同款）；全屏背景叠加 speccore dashboard 同款三层科技感底纹：60px 网格底纹（.grid-pattern fixed inset 0，background-image linear-gradient(rgba(0,240,255,.03) 1px, transparent 1px) 纵横双向、background-size 60px 60px、z-index 0）+ 彩色星点层（.stars fixed inset 0，8 个 1-1.5px 星点 radial-gradient(1px 1px at <位置>, <色>, transparent) 多背景组合：白色 rgba(255,255,255,.3-.4) 与青色 rgba(0,240,255,.45-.5)、紫色 rgba(168,85,247,.4)、绿色 rgba(0,255,136,.4)，位置分散 10%-90%，z-index 0）+ 全屏 2px 周期细扫描线（.scanlines fixed inset 0，repeating-linear-gradient(0deg, transparent 0 2px, rgba(0,240,255,.015) 2px 4px)，z-index 999 罩最上层，pointer-events none；三层均 fixed 不随滚动，营造星野+网格+扫描的科技氛围，不破坏参考图纯深蓝黑质感）；内容区宽度响应窗口自适应（.wrap width:clamp(640px, 60%, 1200px) + margin:0 auto：最小 640px、最大 1200px、中间按窗口 60% 缩放，页面左右留白对称）；头部卡片参考图式实心深蓝底（var(--card) 实心 #0b1e37，略亮于背景、更偏蓝）+ 8px 周期细密水平条纹（background-image 叠加 repeating-linear-gradient(180deg, rgba(255,255,255,.012) 0 1px, transparent 1px 8px)）+ 上下边缘 1px 微亮描边（border-top/border-bottom 1px solid #0f3350，参考图「边缘点亮一线」效果，与 ask 四边浮光扫描线动画共存、动画层在上）+ 圆角 6px + 外发光与 inset 内发光（0 0 20px rgba(14,165,233,.08) + inset 0 1px 24px rgba(14,165,233,.04)），overflow:hidden，标题区仅标题与青色胶囊生成时间徽章（badge 后直接收尾，不加底部细线/装饰光带，避免悬空多余线）；标题与徽章下加 TL;DR 一句话摘要行（.summary-line flex 布局 max-width 540px 居中：左侧 .summary-tag「TL;DR」青色小标签 系统等宽 10px 粗体、rgba(14,165,233,.35) 细边圆角 4px、rgba(14,165,233,.07) 底、青色 text-shadow 光晕 + 右侧 .summary-text 12.5px 浅青正文 line-height 1.75 text-align left；摘要带判断给结论——整体节奏/主要风险/下周重点，不罗列条目）；「本周概览」摘要卡片 Bento 网格布局（参考图式质感：实心深蓝底 #0b1e37 + 8px 周期细密水平条纹 + 上下边缘 1px 微亮描边 + 左缘 8px 亮蓝色条 linear-gradient(180deg,#38bdf8,#0ea5e9) 带同色光晕 + 圆角 6px + overflow:hidden + 内放 .card-glow 光斑层；.ov-bento display:grid、grid-template-columns:104px 1fr 1fr、grid-template-rows:auto auto auto、gap:10px）：完成率圆环大卡（.ring-box 跨 col1 row1/4 整列贯穿、内放青色渐变描边完成率圆环 + 中央大数字 + .ring-label「N/N 项已交付」小字）+ 提交热力图卡（.heat-card 跨 col2/4 row1：标题行「提交热力图」+ .heat-grid 5天×3时段（上午/下午/晚上）15 格 GitHub 式色阶 .hm[data-v="0"~"3"] 四档（0 rgba(14,165,233,.07) 底 / 1 rgba(14,165,233,.3) / 2 rgba(14,165,233,.55) / 3 rgba(34,211,238,.8) 带 glow）+ .heat-days 底部周几标签（padding-left:26px 补偿时段标签列）+ .htip hover 浮层（深蓝底青边圆角 tooltip 显示「周X上/下/晚 · N 次」）；热力图格子 JS 入场错峰 animationDelay .55+i*.04s）+ 四个 .ov-item 指标胶囊（自动流排入剩余格：提交数 data-count、活跃天数 data-count、涉及文件 data-count、代码行数 .ov-num-static 双行（主数字 +18.4k + small 行 −12.7k 删行 --rose 玫红），每个 .ov-item 胶囊细边单元格 rgba(14,165,233,.12) 1px 边 + rgba(14,165,233,.03) 底，.ov-num 系统等宽 24px 青色发光数字 + .ov-label 11px 青灰标签）+ 底部 .ov-compare 环比行（11.5px 青灰小字居中「vs 上周：提交 14 → 18（+29%）· 完成任务 3 → 5（+67%）」，上涨用 --green 绿、下跌用 --rose 红；环比数据来自上周同范围 git log 与完成条目统计）+ 提交节奏柱图（.cb-col 5 根柱周一到周五、.cb-bar width:32px 柱宽（太小显细弱）、柱高按提交数、position:relative 柱上带 .cb-tip hover 浮层显示「周X · N 次提交 · 主题词」）+ 分节卡片同参考图式质感（实心深蓝底 #0b1e37 + 8px 周期细密水平条纹 + 上下边缘 1px 微亮描边 #0f3350 + 圆角缩小至 6px + overflow:hidden，保留阴影与 inset 内发光，去掉原全框青色细边），每张分节卡片左侧带参考图式左缘色条（8px 宽竖线贯穿整卡高度，节色渐变带同色光晕：完成 linear-gradient(180deg,#5eead4,#14b8a6) / 计划 linear-gradient(180deg,#fdba74,#f97316) / 风险 linear-gradient(180deg,#fda4af,#e11d48)，box-shadow 0 0 12px 同色 30% 透明度；卡片内容 padding-left 24px 避让色条），节标题带 18px 同色渐变 SVG 语义图标+文字微光晕（h2 flex 布局 gap 10px，图标替换原竖向短条：完成=圆形对勾、计划=日历、风险=三角警示；inline SVG 内 linearGradient 同节色系渐变 完成 #5eead4→#14b8a6 / 计划 #fdba74→#f97316 / 风险 #fda4af→#e11d48 + 白色描边细节 + drop-shadow 同色光晕；标题色：完成青绿 #5eead4、计划橙 #fdba74、风险玫红 #fda4af + h2 文字同色双圈发光字 3s 呼吸 secGlow 动画（基线 14px/.45+40px/.18 ↔ 峰值 22px/.75+60px/.3，各节动画用本节主题色，与主标题同节奏；仅节标题文字发光，SVG 图标与日期徽章不加））+ 「本周任务进度」节标题右侧带周范围小胶囊徽章 sec-date（margin-left:auto 推右、flex:0 0 auto；11px var(--muted) 字、padding 3px 10px、圆角 999px、青色细边 rgba(14,165,233,.18)、背景 rgba(14,165,233,.05)，如 2026-10-19 ~ 2026-10-25；徽章周范围与周报标题/目录名/git 收集范围完全同源、同步跟随 WEEK_END 配置（含临时说「这周按周日收尾」）；仅完成节显示、计划/风险节不加，让截图自带具体周范围）+ 条目 3D 立体圆球序号徽章（28px 白字，立体感克制的柔和球面——弱化版三段收窄色阶：受光球面渐变 radial-gradient（受光点 circle at 30% 28%，浅亮→主色→深色：完成 #7dd9cf→#14b8a6→#0d9488、计划 #fdc69a→#f97316→#ea580c、风险 #fdaab4→#f43f5e→#e11d48）+ inset 右下内暗影 -3px -4px 6px rgba(0,0,0,.3) 与左上内亮缘 1px 2px 3px rgba(255,255,255,.2) + ::before 左上椭圆高光点（position:relative 定位，top 5px/left 7px、8x6px、rotate -28deg、白色径向渐隐 rgba(255,255,255,.7)→0）+ 底部投影 0 2px 4px rgba(0,0,0,.25) 与同色光晕 0 0 8px + 数字 text-shadow 0 1px 1px rgba(0,0,0,.25) 贴球面） + 条目内部留白：li 水平 padding 10px（hover 淡青底 rgba(14,165,233,.06) 与文字间留 10px 间距）+ 序号圆形徽章 28px（数字距圆边约 8px，不贴圆边）+ 列表轻微缩进 12px（ol/ul padding 0 12px）+ 描述与进度双层错落排版（描述 15px、进度用时 12px 青灰小字 #5b7fa5、百分比加粗强调且两侧 margin 0 2px 呼吸留白、进度与用时之间用「 - 」连接（与 md/txt 版一致，不用 · ）、条目间青色虚线分隔）；风险节条目三环展开：desc 主行（问题）+ meta 影响行（12px 青灰小字「影响：xxx」）+ .advice 建议行（12px 青色小字，「建议：」加粗前缀，margin-top 6px）；md/txt 版同条目依次写问题、影响、建议，文本格式不变+ 青色渐变 40px 大胶囊「一键复制」按钮（var(--cyan)→#0284c7，30px 青色光晕，hover 45px 光晕上浮，模板同款；flex 居中布局，内置 16px 内联 SVG 双矩形复制图标（白色 currentColor 描边、图标与文字 gap 8px、禁用 emoji 图标），复制成功后图标切换为对勾 SVG、文字短暂变「已复制」）；头部 speccore ask 风格发光特效（与 ask 页面完全同款）：四边 1px 青色浮光线，渐变 transparent→var(--cyan)→transparent 整条线平移扫动（亮段长、无 box-shadow 光晕，四边亮段构成顺时针环绕循环，与 ask 看板卡片完全同款（上横线 scanX 左→右、右竖线 scanY 上→下、下横线 scanX-rev 右→左、左竖线 scanY-rev 下→上，四线同周期同速度 3s linear 单向平移）；实现为 1px 整线渐变元素平铺整条边（上/下横线 left:0/right:0 + height:1px + linear-gradient(90deg, transparent, var(--cyan), transparent)；左/右竖线 top:0/bottom:0 + width:1px + linear-gradient(180deg, transparent, var(--cyan), transparent)），随线体 translateX/translateY 平移 ±100%（相对线长）：scanX -100%→100%、scanX-rev 100%→-100%、scanY -100%→100%、scanY-rev 100%→-100%；亮段（线中央渐变段）完整穿越卡片后消失于两端界外（卡片 overflow:hidden 裁剪），带「出现→穿越→消失」节奏；禁止自创 background-position 滚动/常驻辉光/往返摆动/亮段半嵌常驻等变体）+ 顶部光斑 ask 同款 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 循环）；入场动画：头部淡入下滑、卡片依次错峰上浮淡入（完成 0.26s/计划 0.4s/风险 0.54s）、按钮弹入（卡片入场动画 fadeDown/fadeUp/riseIn 的 fill-mode 必须用 backwards 严禁 both——both 使动画结束后最后一帧 transform:none 永久覆盖 hover 的 3D 偏转 transform，CSS 动画 applied 值优先级高于普通声明，hover 偏转会完全失效；cometFade 与按钮 pop 保持 both 不受此限）；hover 微交互：卡片上浮+阴影加深+inset 发光增强、条目淡青底、序号徽章放大微旋（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)）、按钮上浮/按压回缩；页脚 10px muted 文字（无分隔线、不加边框），署名固定 GENERATED BY SPECCORE TEAM · <周范围>（动态跟随 WEEK_END，如 GENERATED BY SPECCORE TEAM · 20261019 ~ 20261025）；三段分节列表，任务点保持中文顿号序号；进度条终点圆点 + 流星扫描填充（.pbar-fill 必须 display:block + position:relative——行内 span 忽略 width/height 会变成 0×0，填充与圆点全部不可见；.pbar-fill::before 终点圆点 7px 径向渐变圆 right:0 + transform:translate(50%,-50%) 骑在填充右缘（done 青绿 radial-gradient(circle at 35% 30%,#a7f3d0,#2dd4bf 62%,#0d9488)、plan 橙 #fdba74/#f97316/#c2410c，box-shadow 同色光晕、z-index:2；.pbar-track/.pbar-fill 均不得加 overflow:hidden——圆点右半伸出填充 3.5px 骑边渲染）；流星 = JS 注入 .pbar-track 内的 .pbar-sweep（absolute 左贴轨道、width:0 起点隐藏、height:16px、transform:translateY(-50%) 垂直居中、z-index:1、pointer-events:none）+ sweep 右缘 .pbar-comet 光体（absolute left:100% 贴 sweep 右缘随宽度移动，严禁 right:62%/right:100% 等右侧定位——彗星会停在轨道中段、进度 100% 时也到不了终点；子弹头形光核：20×11px 横向泪滴 border-radius:55% 100% 100% 55% / 85% 100% 100% 85%（右端全圆弧=前进弹头、左端 55%/85% 大圆角=后部饱满钝圆接尾不露尖（比 35%/60% 更钝，禁尖窄收尾），严禁 13×7 小椭圆方块感、严禁 20px 大圆球形态）background 三层：底层 linear-gradient(90deg,rgba(153,246,228,.3),rgba(224,254,255,.6) 55%,#fff) 铺底（形状内不得透底）+ 右前缘青蓝冷光 radial-gradient(ellipse 70% 85% at 74% 45%,rgba(125,211,252,.9),transparent) + 青白核 radial-gradient(circle 12px at 66% 50%,#fff,rgba(224,254,255,.95) 45%,rgba(153,246,228,.5) 75%,transparent)（circle 半径必须显式 12px——自动半径按最远角计、四角渐隐至透明会露出轨道深色背景成「黑三角」，显式半径让光核饱满），box-shadow 双圈柔光 0 0 5px 2px rgba(186,230,253,.75) + 0 0 12px 4px rgba(45,212,191,.3)——光晕总高控制在 2~2.5 倍条高以内，不用 drop-shadow；整体前大后收窄的扫帚流星：头部 20×11 大头 → ::after 彗尾 right:40%、84×12px 细长锥形拖尾 linear-gradient(90deg,transparent,rgba(153,246,228,.18) 26%,rgba(186,230,253,.55) 64%,rgba(255,255,255,.9)) + clip-path:polygon(4% 40%,16% 24%,100% 0,100% 100%,16% 76%,4% 60%)（左端收成 2.4px 高平口钝头、右端全高平接光核、16% 处起渐收——远窄近宽，禁矩形方块形、禁 1px 尖点）+ blur 1px + z-index:0——长度约 4 倍头宽；剥落粒子流（JS 为每颗 .pbar-comet 注入 30 个 span.cp，绝对定位在光核中后段出生）：30 粒三带分布（上方飘散带 17 粒 by -6~-0.5 向上飘散 + 中部渗漏带 6 粒 by +0.5~+5.5 + 深蓝带 7 粒 by +7~+9.5 贴光核下缘）椭圆小块前大后小（3.2×2.2 → 1.2×0.9px，宽高不等 + rotate -12°~12° 不规则椭圆，禁用标准圆形、禁用 box-shadow 静态星屑——静态点没有剥落飘散的生命感），出生点从头部稍靠后（left 9~17px）开始，y 紧贴中心水平线（中线 ±2.5px，各粒角度基本一致不散乱），cpFlow 1.5~1.8s cubic-bezier(.2,.05,.55,1) infinite + 负延迟 -0.1~-1.5s 错峰：0%→10% 淡入渐现（渐渐出现）、10%→100% 沿水平线加速向后飘 translate3d(-45~-62px, dy, 0)（加速向后）、55% 后 opacity 渐隐 + scale(.16) 渐小（向尾部消失）、dy 三带取值：上方 -3.5~-7 上飘展开（用户反馈上方粒子少且飘散不够远，13→17 再加密、dy 再扩大，下方相对合适不增）、中部 +1.5~+3.5 向下渗漏、深蓝 +5~+7 向后甩出（深蓝带 cp-deep 深蓝渐变+深蓝光晕、dur 1.06~1.25s 更久停留），box-shadow 光晕 0%→55% 增强再减弱（每粒生命期一次明灭=呼吸发光，周期 1.5~1.8s 与主体 2.4s 呼吸非整数倍错开，禁止同频齐步闪）；粒子 z-index:1 在彗尾之上（尾 z-index:0）、opacity:0 起步呼吸发光分层不同频：主体光核与彗尾 2.4s 周期呼吸（comet 双动画 cometFade + glowPulse 2.4s ease-in-out infinite：box-shadow 双圈光晕 0%↔50% 周期扩缩；::after 挂 tailGlow 2.4s ease-in-out infinite：filter blur(1px) brightness(1) ↔ blur(1.5px) brightness(1.28) 亮度呼吸），粒子 1.5~1.8s 明灭与主体 2.4s 呼吸非整数倍错开（视觉错落不同频）；opacity:0 常驻隐藏）；.pbar-track.sheen-on 时 sweep transition:width 1.1s cubic-bezier(.3,.8,.4,1) 生长（comet 贴 sweep 右缘 left:100% 随宽度从左扫到右），comet 的 animation 严禁写在 .pbar-comet 基类（基类动画页面加载 t=0 即播、1.1s 后 both 定格 opacity:0，而扫动 setTimeout 1.5s 才开始——时序错位会让流星全程不可见）；必须挂在 .pbar-track.sheen-on .pbar-comet 选择器上（cometFade 1.1s ease-out both, glowPulse 2.4s ease-in-out infinite 逗号并列双动画：cometFade 7% 淡入、86% 保持、100% 到终点消失、glowPulse 光晕呼吸循环；::after 彗尾另挂 tailGlow 2.4s ease-in-out infinite 亮度呼吸），靠 playSweep 内 remove/add sheen-on 类切换重启动画，与 dotPulse 同机制；扫动终点按各条目标进度 data-w：sheen 内 sweep inline width 终点 = data-w（done 条 100% 扫满轨道、有进度的 plan 条如 30% 即 30% 停在进度点不越界）——sweep 宽度过渡与 fill 宽度过渡同参数天然同步，comet 与彗尾/星屑无需任何反向补偿（scaleX 压缩方案会把彗尾一同拉长数倍，禁用）；填充同步生长：入场 sheen(el,'wave') 给 fill 设 transition width 1.1s 同 easing + width 0→data-w，与流星同步——流星扫到哪、填充长到哪，流星到终点消失、留下各自进度，之后填充保持不再变化；圆点 .pbar-done/.pbar-plan .pbar-track.sheen-on .pbar-fill::before animation:dotPulse 1.1s（90% 处 filter:brightness(2) + 白光 drop-shadow 爆亮，done/plan 通用）流星到达终点时爆亮——dotPulse 选择器必须与 JS 加类位置一致：JS 把 sheen-on 加在 .pbar-track 上，严禁写 .pbar-fill.sheen-on::before（JS 从不在 fill 上加类，选择器永不命中、爆亮不触发）；流星注入与入场波浪覆盖完成条 + 有进度的计划条（JS 遍历 .pbar-track：plan 且进度<=0 的条 return 跳过——0 进度的计划条不注入流星、不扫、保持静态），其余条 data-w 记录目标进度后 fill 归零；入场波浪：setTimeout 1500+i*420ms 逐条 sheen(el,'wave') 错峰（上→下必然可见）；hover 重扫：li 上 mouseenter+pointerenter 双监听，sheen(el,'hover') 只 remove/add fill 与 track 的 sheen-on 类重放流星扫过（comet 再扫一遍，0 进度的 plan 条同样跳过），fill 宽度与颜色完全不重置（进度不再变化），sheen(el,src) 按来源独立节流（wave 1s / hover 300ms）；重启动画 remove 类→sweep inline 归零 width:0（transition:none 无过渡）→void offsetWidth 强制回流→同步 add 类→sweep inline 目标 width=data-w（恢复 transition；双 RAF 在 headless 虚拟时间下不推进，不可用））；液态玻璃（@supports((backdrop-filter:blur(1px)) or (-webkit-backdrop-filter:blur(1px))) 内 .overview/.section 加 backdrop-filter:blur(16px) saturate(1.35) + background-color:rgba(11,30,55,.42)，不支持的老浏览器走默认实心深蓝不白屏）；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 之下一层）；卡片级 3D 微倾斜（严禁全页级 mousemove 倾斜——页面容器整页旋转会让所有卡片一起偏转，与「仅当前卡片响应」不符）：每张卡片 hover 时仅该卡片随鼠标偏转，卡片 transform 写 perspective(900px) + rotateY(calc(var(--mx,0)*2.5deg)) rotateX(calc(var(--my,0)*-2.5deg))（±1.25° 极轻微），与 hover 上浮 translateY(-2px) 合并写同一条 transform（严禁拆两条相互覆盖）；hover 态选择器带 tilt（header-card/overview/section 或 header-card/card），非 hover 卡片不倾斜；JS 对每张卡片监听 mousemove 计算卡内相对位置（(clientX-rect.left)/rect.width*2-1 归一化 -1~1）只更新该卡 --mx/--my，mouseleave 归零回正，transition transform .18s 平滑；移动端无 mousemove 保持 0 不倾斜）；禁止写 @media (prefers-reduced-motion: reduce) 禁用动画的媒体查询块（官方模板无此块，用户系统开启减少动画时该块会禁用全部动效，是竖线不动/发光不呼吸的根因）；页面 JS 需支持 `?shot=content` 参数（检测 location.search 含 shot=content 时仅统一 body 四周 padding 40px（不隐藏任何元素），供整页内容区截图用、保证截图四周留白对称合适）
 - HTML 顶部带「一键复制」按钮：点击复制的是 txt 版纯文本全文（复制源必须用 txt 文件内容：含换行、无 #/##/> 等 Markdown 符号，严禁用 md 内容当复制源），按钮短暂变"已复制"；JS 用 navigator.clipboard.writeText，失败回退隐藏 textarea + document.execCommand('copy')（兼容 file:// 打开）
 - 用户临时说"不落盘/别写文件"时（覆盖 DISK）：只在对话输出，不写文件、不开浏览器；临时说"写到桌面/存到 X"（覆盖 DIR）、"只要 md/只出 html/只要内容区截图/只要截图/这次不截图"（覆盖 FORMATS）、"别开浏览器"（覆盖 OPEN_HTML）同理，均只对当次生效、不改配置
 - 同名目录处理：周日期子目录已存在时直接复用（不重建、不清空），仅覆盖 FORMATS 清单内的同名文件（md/txt/html/content-png），目录内其它文件（时间戳另存的历史文件、用户自放文件）一律保留不动、绝不删除或清空（该目录可能是用户此前自建、作其它用途的目录，我们只并列写入自己的专属命名文件，不与用户文件冲突混淆）；落盘前查看目录内已有内容，若存在非本 skill 命名的其它文件（daily-report-/weekly-report- 前缀之外），对话中提示用户「该目录内已有其它文件，本次周报已与它们并列存放，未做任何改动」；同一周重复生成默认直接覆盖原文件，用户说"保留之前的/另存/不覆盖"时，文件名追加时间戳（如 `weekly-report-20261019~20261025-1530.html`）另存不覆盖

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

@@ -16,4 +16,4 @@
 - 永久换角色：说「以后默认用 XX 角色 / 我的职业是 XX / 我的主要工作是 XX」→ 更新顶部 ROLE 配置（永久生效）；词典没有的角色按用户描述新增词条
 - 声明+临时指标覆盖：说「这次指标看拜访数和签约额」→ 词条 + 临时指标（仅当次）；说「以后都用这套指标」→ 固化进词典（永久）
 - 兜底：词典外的行业（工地施工、医生值班等）→ 骨架 + 用户素材（文字/图片/文件）现场生成词条（工作单元/指标从素材提取），本次生效；说「记住这个行业」→ 固化为新词条
-- 行业/角色切换只换内容与指标，HTML 骨架/色板/动效/落盘规范全部不变；纯文字整理模式同样适用词典；无 git 数据时概览卡只显示完成任务/计划/风险条数统计；优先级：临时角色声明 > 顶部 ROLE 配置 > 词典表
+- 行业/角色切换只换内容与指标，HTML 骨架/色板/动效/落盘规范全部不变；纯文字整理模式同样适用词典；无 git 数据时概览卡只显示任务进度/计划/风险条数统计；优先级：临时角色声明 > 顶部 ROLE 配置 > 词典表