skill-forge-hub 1.0.4 → 1.0.5

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

@@ -1,10 +1,29 @@
 # 数据收集
 
-先检测当前系统（macOS：`uname -s` 返回 Darwin；Windows：`node -e "console.log(process.platform)"` 返回 win32），再 Read 同目录外的 `user-config.md` 顶部「默认配置」的 DATA_SOURCES 清单，按清单逐项收集（空清单 = 只按会话/文字内容生成）。每项按 type 分三种行为：
+先检测当前系统（macOS：`uname -s` 返回 Darwin；Windows：`node -e "console.log(process.platform)"` 返回 win32），再 Read 同目录外的 `user-config.md` 顶部「默认配置」的 DATA_SOURCES 清单，按清单逐项收集（空清单 = 只按会话/文字内容生成）。清单形状（每项 name 唯一名称 + type 类型 + 路径；完整填写说明见 user-config.md「默认配置」的 DATA_SOURCES 注释）：
+
+```yaml
+DATA_SOURCES:
+  - name: 主项目仓库          # name = 唯一 key（重名视为同一数据源；口述「只聚合 xxx」按 name 匹配）
+    type: git                # git = 代码仓库（git log 聚合提交）
+    mac: ~/Projects/main-app  # macOS 路径（绝对路径或 ~ 开头）
+    win: D:\Projects\main-app # Windows 路径；「-」= 该系统不存在，自动跳过
+  - name: 周例会纪要
+    type: file               # file = 普通文件/目录（直接 Read 内容聚合）
+    mac: ~/Documents/meeting-notes.md
+    win: -
+  - name: 数据接口
+    type: remote             # remote = 远程网络源（联网拉取 url 内容）
+    url: https://example.com/data.json
+```
+
+每项按 type 分三种行为：
 
 - git = 代码仓库：取 mac / win 中当前系统对应路径（「-」= 该系统不存在，跳过；当前系统全部为「-」的陌生机器时跳过 git 收集，只按会话/文字内容生成），用下方命令模板聚合该仓本周（周一至周结束日 WEEK_END，默认周五）提交，聚合产出；同时统计上周同范围（周一至上周周结束日）提交数/完成任务数，供概览卡环比行使用。只汇总有提交的仓库
-- file = 普通文件/目录：直接 Read 内容（文档/纪要/日志等素材），提取要点并入
-- remote = 远程网络源：AI 联网拉取 url 内容提取要点（仅收集时联网，HTML 产物仍零外链）
+- file = 普通文件/目录：路径指向文件 → Read 全文提取要点；指向目录 → 列目录逐个 Read 文本文件（md/txt/csv/日志等，二进制/超大文件跳过）；路径无效或全部不可读 → 静默跳过该数据源（不报错、不写入）
+- remote = 远程网络源：只需 url 字段（mac/win 忽略）；AI 联网拉取 url 内容（网页或数据接口均可）提取要点；拉取失败/超时 → 静默跳过该数据源不阻塞生成；仅收集时联网，HTML 产物仍零外链
+- 未知 type（拼写错误/未支持）→ 忽略该项，生成时一句话提示用户该项未识别（不猜、不中断）
+- 多来源合并：同件事去重合并——量化数字以 git 提交统计为准、定性描述以口述/文件要点为准；file/remote 提取要点与口述同等对待
 
 命令模板：
 
@@ -14,11 +33,12 @@ git -C <仓库路径> log --since="YYYY-MM-DD 00:00:00" --until="YYYY-MM-DD 23:5
 
 - 日期范围取本周周一 00:00 至周结束日（WEEK_END，默认周五）23:59，缺省参数时以当前日期所在周为准
 - 汇总每个提交涉及的**文件数**与**增删行数**（来自 --stat），作为量化数据
-- **行数统计口径（防生成物噪音）**：统计增删行数前必须先剔除生成物路径（如 `.speccore/code-graph/` 下的 graph.json：单文件可能贡献数十万行，会撑爆指标）；numstat 输出为 `add\tdel\tpath` 三列，用 `grep -vE $'\t\.speccore/code-graph/'` 按制表符+路径过滤（正则匹配行首无效）；统计后若行数仍异常巨大（>5 万行），用 `sort -rn | head -8` 定位元凶文件再排除；周报指标卡（提交数/活跃天数/涉及文件/代码行数）与 HTML 热力图/柱图均用过滤后口径
+- **行数统计口径（防生成物噪音）**：统计增删行数前必须先剔除生成物路径（如 `.build/code-graph/` 下的 graph.json：单文件可能贡献数十万行，会撑爆指标）；numstat 输出为 `add\tdel\tpath` 三列，用 `grep -vE $'\t\.build/code-graph/'` 按制表符+路径过滤（正则匹配行首无效）；统计后若行数仍异常巨大（>5 万行），用 `sort -rn | head -8` 定位元凶文件再排除；周报指标卡（提交数/活跃天数/涉及文件/代码行数）与 HTML 热力图/柱图均用过滤后口径
 - 同主题多日提交合并为一条任务点，量化数据累加
 - 提交记录无法给出实际耗时，用时取合理估算值，允许用户事后修正
 - 本周无提交的仓库不写入周报
 - 仓库路径（当前系统字段）不存在/非代码仓库时静默跳过该仓库（不报错、不写入）
 - 用户说「只写 xxx 的周报 / 只聚合 xxx」时按 name 匹配只收集指定数据源
 - 提交记录之外的默认来源：本次会话中用户已提及/口述的工作内容（任务、进度、风险等对话信息）一并聚合，与 提交记录去重合并
+- 会议纪要文件也可作为素材：会议行动项可直接列为本周任务或进度来源（汇报链源头）
 - 用户明确说"只整理这段文字/只按这段"时，忽略提交记录与会话上下文，只用指定文字

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

@@ -8,9 +8,9 @@
 - 每次生成落盘哪些文件读取顶部「默认配置」的 `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 检测后仅统一 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 + 结论卡片~150 + 概览卡片~120 + 每节卡片(45+条目数×70+40，含各卡片 margin-bottom 18) + 余量~15，底部留白仅 body 下 padding 40px、与顶部对称，余量只防截断不可多给），截图后用 Read 校验：头部标题卡片、概览卡片与三张分节卡片整体完整在图内、四周留白对称合适、不截断，底部留白过大则减高度、截断则加高度重截
-- md/txt/html 均含生成时间行，精确到时分秒（如 2026-10-22 19:10:38）；HTML 采用参考图式深蓝面板风格 + ask 同款发光动效的融合样式（不换其它色系，颜色全部用 CSS 变量统一主题令牌：29 令牌 × 5 主题（tech 深蓝科技（默认，色值与旧 ask 色板一致）/biz 浅色商务/mono IDEA 黑亮（JetBrains New UI Dark 官方色系：编辑区 #1e1f22 + 面板 #2b2d30）/light IDEA 白亮（IntelliJ Light 官方色系：白编辑区 + 浅灰面板）/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 + 流星粒子 --cp-a/--cp-b/--cp-tip/--cp-glow0/--cp-glow1 与 --cpd-a/--cpd-b/--cpd-tip/--cpd-glow0/--cpd-glow1（跨主题统一白色系：本体白热尖端 + 柔和白青光晕，深浅两带只差光晕强度）；生成时按 THEME 配置写 data-theme 定默认，页面右下角换肤坞五色点随点随换、localStorage 记忆、?shot 截图模式与打印隐藏）：图表渲染用 echarts@5.5.1（body 末尾主 script 之前引入 `<script src="https://cdn.jsdelivr.net/npm/echarts@5.5.1/dist/echarts.min.js"></script>`，页面唯一网络引用；离线/内网无外网加载失败时图表容器显示 data-off 降级提示文字、页面其余内容正常浏览不受影响）；除 echarts 外禁用任何 CDN 与外部网络引用（@import、外链 CSS/图片/网络字体一律禁止），字体全用系统本地字体栈 ui-monospace/'SF Mono'/SFMono-Regular/Menlo/Consolas/'Microsoft YaHei'/monospace（macOS 走 SF Mono/Menlo、Windows 走 Consolas，中文回退 Microsoft YaHei；字母数字等宽自带科技感），正文同栈 400、标题同栈 900 渐变文字（var(--title-grad)，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(var(--scan-dim) 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, var(--scan-dim) 2px 4px)，z-index 999 罩最上层，pointer-events none；三层均 fixed 不随滚动，营造星野+网格+扫描的科技氛围，不破坏参考图纯深蓝黑质感）；内容区宽度响应窗口自适应（.wrap width:clamp(640px, 60%, 1200px) + margin:0 auto：最小 640px、最大 1200px、中间按窗口 60% 缩放，页面左右留白对称）；头部卡片参考图式实心深蓝底（var(--panel-solid) 实心 #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 后直接收尾，不加底部细线/装饰光带，避免悬空多余线）；header-card 下独立「本周结论」卡（.section.sec-concl 复用分节卡质感：紫色左缘色条 linear-gradient(180deg,#a78bfa,#6366f1) + 靶心图标（conclGrad 紫渐变）+ h2 紫色 #a78bfa secGlowPurple 发光 + 右上角副标「判断优先 · 先结论后流水」+ 三行 concl-row（concl-tag 紫/橙 t2/青 t3 三色标签 + concl-text 13px 正文）：最重要的结果/值得处理的变化/下周优先的动作，TXT 复制源与 md/txt 正文同含本周结论三句）；标题与徽章下加 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；摘要带判断给结论——整体节奏/主要风险/下周重点，不罗列条目）；数字选择：用户口述的业务结果指标（响应时间/错误率/转化率/成功率等）优先写入，提交统计（提交数/文件数/行数）仅在无业务指标时兜底，两者都有时业务指标在前、提交统计后置或省略；数字凡有对比基准必带（环比/同比/目标完成度至少其一，如「+18%」「达目标 90%」），无基准来源时不作要求 - 「本周概览」摘要卡片 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-ech 容器（88px；echarts pie 环形图 radius ['66%','82%']、value=已完成项数、--accent2→--accent 渐变描边 + glow 光晕；track 底环由 .ring-ech::before 绘制 var(--tag-bg) 7px 圆环）+ 中央大数字 .ring-num（HTML 保留、生成时替换数字）+ .ring-label「N/N 项已交付」小字）+ 提交热力图卡（.heat-card 跨 col2/4 row1：标题行「提交热力图」+ .heat-card .ech echarts heatmap 容器 150×112px（x 轴 上午/下午/晚上、y 轴 周一~周五（category 数组倒序写——周五在底、周一在顶）、visualMap show:false min 0 max 3 四档色阶 var(--tag-bg)/var(--glow)/var(--heat)/var(--accent2)、数据项 {value:[x,y,次数], name:"周X上/下午/晚上"} tooltip 深蓝底青边显示「周X上/下/晚 · N 次」、格子 borderWidth 2 transparent 留缝）+ .heat-legend 图例（.hl-swatch[data-v="0"~"3"] 四档色块静态））+ 四个 .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-row 内 .ech echarts bar 容器 86px 高、5 根柱周一到周五、柱高按提交数、tooltip 显示「周X · N 次提交 · 主题词」——文本取 IIFE 内 DAY_TIPS 数组按 dataIndex 对应）+ 分节卡片同参考图式质感（实心深蓝底 #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、青色细边 var(--border)、背景 var(--tag-bg)，如 2026-10-19 ~ 2026-10-25；徽章周范围与周报标题/目录名/提交记录收集范围完全同源、同步跟随 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 淡青底 var(--tag-bg) 与文字间留 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）+ .owner 责任与时间行（12px 紫色 #a78bfa 小字，「责任与时间：」加粗前缀，margin-top 4px，口述无责任信息时省略此行）；md/txt 版同条目依次写问题、影响、建议、责任与时间（第四项口述有时必写），文本格式不变+ 青色渐变 40px 大胶囊「一键复制」按钮（var(--accent)→var(--accent2)，30px 青色光晕，hover 45px 光晕上浮，模板同款；flex 居中布局，内置 16px 内联 SVG 双矩形复制图标（白色 currentColor 描边、图标与文字 gap 8px、禁用 emoji 图标），复制成功后图标切换为对勾 SVG、文字短暂变「已复制」）；头部 speccore ask 风格发光特效（与 ask 页面完全同款）：四边 1px 青色浮光线，渐变 transparent→var(--accent)→transparent 整条线平移扫动（亮段长、无 box-shadow 光晕，四边亮段构成顺时针环绕循环，与 ask 看板卡片完全同款（上横线 scanX 左→右、右竖线 scanY 上→下、下横线 scanX-rev 右→左、左竖线 scanY-rev 下→上，四线同周期同速度 3s linear 单向平移）；实现为 1px 整线渐变元素平铺整条边（上/下横线 left:0/right:0 + height:1px + linear-gradient(90deg, transparent, var(--accent), transparent)；左/右竖线 top:0/bottom:0 + width:1px + linear-gradient(180deg, transparent, var(--accent), 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% var(--glow)→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）；滚动入场：初始视口外的卡片滚到视口才上浮渐显（html.js 门控 + IntersectionObserver，translate 独立属性不碰 transform——hover 3D 偏转零冲突，stagger 70ms 封顶 280ms、入场完即清 delay 不拖慢 hover 偏转，2s 兜底强制显示；无 JS/打印/截图模式一律全显）；窄屏收敛：<680px 视口 wrap 满宽流式、边距收窄、h1 统一 26px（clamp 640px 下限在窄窗不再横向溢出）；三张 echarts 图表默认开启动画（柱图生长、环形 sweep 扫描、热力格淡入）；?shot 截图模式（location.search 含 shot=）下统一 animation:false 直接渲染终态（headless 虚拟时间下动画帧不推进会停在初始帧导致截图空白）；按钮弹入（卡片入场动画 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(224,254,255,.3),rgba(224,254,255,.6) 55%,#fff) 铺底（形状内不得透底）+ 右前缘白青冷光 radial-gradient(ellipse 70% 85% at 74% 45%,rgba(224,254,255,.85),transparent) + 青白核 radial-gradient(circle 12px at 66% 50%,#fff,rgba(224,254,255,.95) 45%,rgba(224,254,255,.5) 75%,transparent)（circle 半径必须显式 12px——自动半径按最远角计、四角渐隐至透明会露出轨道深色背景成「黑三角」，显式半径让光核饱满），box-shadow 双圈柔光 0 0 5px 2px rgba(186,230,253,.75) + 0 0 12px 4px rgba(224,254,255,.35)——光晕总高控制在 2~2.5 倍条高以内，不用 drop-shadow；整体前大后收窄的扫帚流星：头部 20×11 大头 → ::after 彗尾 right:40%、84×12px 细长锥形拖尾 linear-gradient(90deg,transparent,rgba(224,254,255,.25) 26%,rgba(224,254,255,.75) 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.2 + 深色带 7 粒 by +5.5~+8 贴光核下缘）椭圆小块前大后小（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 与主体 1.8s 呼吸非整数倍错开，禁止同频齐步闪）；粒子 z-index:1 在彗尾之上（尾 z-index:0）、opacity:0 起步呼吸发光分层不同频：主体光核 1.8s 与彗尾 2.4s 周期呼吸（comet 双动画 cometFade + glowPulse 1.8s ease-in-out infinite：纯白晕光晕 0%↔50% 周期扩缩（50% 时白晕最盛 = 白色呼吸，扫过 1.1s 内可见一轮明暗）；::after 挂 tailGlow 2.4s ease-in-out infinite：filter blur(1px) brightness(1) ↔ blur(1.5px) brightness(1.28) 亮度呼吸），粒子 1.5~1.8s 明灭与主体 1.8s 呼吸非整数倍错开（视觉错落不同频）；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 1.8s 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:var(--panel)，不支持的老浏览器走默认实心深蓝不白屏）；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 之下一层）；卡片级 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 + 隐藏右下角主题换肤坞（其余元素一律保留），供整页内容区截图用、保证截图四周留白对称合适）
+- md/txt/html 均含生成时间行，精确到时分秒（如 2026-10-22 19:10:38）；HTML 采用参考图式深蓝面板风格 + ask 同款发光动效的融合样式（不换其它色系，颜色全部用 CSS 变量统一主题令牌：29 令牌 × 5 主题（tech 深蓝科技（默认，色值与旧 ask 色板一致）/biz 浅色商务/mono IDEA 黑亮（JetBrains New UI Dark 官方色系：编辑区 #1e1f22 + 面板 #2b2d30）/light IDEA 白亮（IntelliJ Light 官方色系：白编辑区 + 浅灰面板）/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 + 流星粒子 --cp-a/--cp-b/--cp-tip/--cp-glow0/--cp-glow1 与 --cpd-a/--cpd-b/--cpd-tip/--cpd-glow0/--cpd-glow1（跨主题统一白色系：本体白热尖端 + 柔和白青光晕，深浅两带只差光晕强度）；生成时按 THEME 配置写 data-theme 定默认，页面右下角换肤坞五色点随点随换、localStorage 记忆（键按页内嵌唯一 ID 隔离、多份产物互不串台、改名/移动目录记忆不丢；生成时头部写 `<meta name="weekly-id" content="<UUID>">`，每次新 UUID）、?shot 截图模式与打印隐藏）：图表渲染用 echarts@5.5.1（body 末尾主 script 之前引入 `<script src="https://cdn.jsdelivr.net/npm/echarts@5.5.1/dist/echarts.min.js"></script>`，页面唯一网络引用；离线/内网无外网加载失败时图表容器显示 data-off 降级提示文字、页面其余内容正常浏览不受影响）；除 echarts 外禁用任何 CDN 与外部网络引用（@import、外链 CSS/图片/网络字体一律禁止），字体全用系统本地字体栈 ui-monospace/'SF Mono'/SFMono-Regular/Menlo/Consolas/'Microsoft YaHei'/monospace（macOS 走 SF Mono/Menlo、Windows 走 Consolas，中文回退 Microsoft YaHei；字母数字等宽自带科技感），正文同栈 400、标题同栈 900 渐变文字（var(--title-grad)，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 同款）；全屏背景叠加 科技仪表盘同款三层科技感底纹：60px 网格底纹（.grid-pattern fixed inset 0，background-image linear-gradient(var(--scan-dim) 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, var(--scan-dim) 2px 4px)，z-index 999 罩最上层，pointer-events none；三层均 fixed 不随滚动，营造星野+网格+扫描的科技氛围，不破坏参考图纯深蓝黑质感）；内容区宽度响应窗口自适应（.wrap width:clamp(640px, 60%, 1200px) + margin:0 auto：最小 640px、最大 1200px、中间按窗口 60% 缩放，页面左右留白对称）；头部卡片参考图式实心深蓝底（var(--panel-solid) 实心 #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 后直接收尾，不加底部细线/装饰光带，避免悬空多余线）；header-card 下独立「本周结论」卡（.section.sec-concl 复用分节卡质感：紫色左缘色条 linear-gradient(180deg,#a78bfa,#6366f1) + 靶心图标（conclGrad 紫渐变）+ h2 紫色 #a78bfa secGlowPurple 发光 + 右上角副标「判断优先 · 先结论后流水」+ 三行 concl-row（concl-tag 紫/橙 t2/青 t3 三色标签 + concl-text 13px 正文）：最重要的结果/值得处理的变化/下周优先的动作，TXT 复制源与 md/txt 正文同含本周结论三句）；标题与徽章下加 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；摘要带判断给结论——整体节奏/主要风险/下周重点，不罗列条目）；数字选择：用户口述的业务结果指标（响应时间/错误率/转化率/成功率等）优先写入，提交统计（提交数/文件数/行数）仅在无业务指标时兜底，两者都有时业务指标在前、提交统计后置或省略；数字凡有对比基准必带（环比/同比/目标完成度至少其一，如「+18%」「达目标 90%」），无基准来源时不作要求 - 「本周概览」摘要卡片 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-ech 容器（88px；echarts pie 环形图 radius ['66%','82%']、value=已完成项数、--accent2→--accent 渐变描边 + glow 光晕；track 底环由 .ring-ech::before 绘制 var(--tag-bg) 7px 圆环）+ 中央大数字 .ring-num（HTML 保留、生成时替换数字）+ .ring-label「N/N 项已交付」小字）+ 提交热力图卡（.heat-card 跨 col2/4 row1：标题行「提交热力图」+ .heat-card .ech echarts heatmap 容器 150×112px（x 轴 上午/下午/晚上、y 轴 周一~周五（category 数组倒序写——周五在底、周一在顶）、visualMap show:false min 0 max 3 四档色阶 var(--tag-bg)/var(--glow)/var(--heat)/var(--accent2)、数据项 {value:[x,y,次数], name:"周X上/下午/晚上"} tooltip 深蓝底青边显示「周X上/下/晚 · N 次」、格子 borderWidth 2 transparent 留缝）+ .heat-legend 图例（.hl-swatch[data-v="0"~"3"] 四档色块静态））+ 四个 .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-row 内 .ech echarts bar 容器 86px 高、5 根柱周一到周五、柱高按提交数、tooltip 显示「周X · N 次提交 · 主题词」——文本取 IIFE 内 DAY_TIPS 数组按 dataIndex 对应）+ 分节卡片同参考图式质感（实心深蓝底 #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、青色细边 var(--border)、背景 var(--tag-bg)，如 2026-10-19 ~ 2026-10-25；徽章周范围与周报标题/目录名/提交记录收集范围完全同源、同步跟随 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 淡青底 var(--tag-bg) 与文字间留 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）+ .owner 责任与时间行（12px 紫色 #a78bfa 小字，「责任与时间：」加粗前缀，margin-top 4px，口述无责任信息时省略此行）；md/txt 版同条目依次写问题、影响、建议、责任与时间（第四项口述有时必写），文本格式不变+ 青色渐变 40px 大胶囊「一键复制」按钮（var(--accent)→var(--accent2)，30px 青色光晕，hover 45px 光晕上浮，模板同款；flex 居中布局，内置 16px 内联 SVG 双矩形复制图标（白色 currentColor 描边、图标与文字 gap 8px、禁用 emoji 图标），复制成功后图标切换为对勾 SVG、文字短暂变「已复制」）；头部 指令面板风格发光特效（与参考面板完全同款）：四边 1px 青色浮光线，渐变 transparent→var(--accent)→transparent 整条线平移扫动（亮段长、无 box-shadow 光晕，四边亮段构成顺时针环绕循环，与 ask 看板卡片完全同款（上横线 scanX 左→右、右竖线 scanY 上→下、下横线 scanX-rev 右→左、左竖线 scanY-rev 下→上，四线同周期同速度 3s linear 单向平移）；实现为 1px 整线渐变元素平铺整条边（上/下横线 left:0/right:0 + height:1px + linear-gradient(90deg, transparent, var(--accent), transparent)；左/右竖线 top:0/bottom:0 + width:1px + linear-gradient(180deg, transparent, var(--accent), 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% var(--glow)→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）；滚动入场：初始视口外的卡片滚到视口才上浮渐显（html.js 门控 + IntersectionObserver，translate 独立属性不碰 transform——hover 3D 偏转零冲突，stagger 70ms 封顶 280ms、入场完即清 delay 不拖慢 hover 偏转，2s 兜底强制显示；无 JS/打印/截图模式一律全显）；窄屏收敛：<680px 视口 wrap 满宽流式、边距收窄、h1 统一 26px（clamp 640px 下限在窄窗不再横向溢出）；三张 echarts 图表默认开启动画（柱图生长、环形 sweep 扫描、热力格淡入）；?shot 截图模式（location.search 含 shot=）下统一 animation:false 直接渲染终态（headless 虚拟时间下动画帧不推进会停在初始帧导致截图空白）；按钮弹入（卡片入场动画 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 AI TEAM · <周范围>（动态跟随 WEEK_END，如 GENERATED BY AI 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(224,254,255,.3),rgba(224,254,255,.6) 55%,#fff) 铺底（形状内不得透底）+ 右前缘白青冷光 radial-gradient(ellipse 70% 85% at 74% 45%,rgba(224,254,255,.85),transparent) + 青白核 radial-gradient(circle 12px at 66% 50%,#fff,rgba(224,254,255,.95) 45%,rgba(224,254,255,.5) 75%,transparent)（circle 半径必须显式 12px——自动半径按最远角计、四角渐隐至透明会露出轨道深色背景成「黑三角」，显式半径让光核饱满），box-shadow 双圈柔光 0 0 5px 2px rgba(186,230,253,.75) + 0 0 12px 4px rgba(224,254,255,.35)——光晕总高控制在 2~2.5 倍条高以内，不用 drop-shadow；整体前大后收窄的扫帚流星：头部 20×11 大头 → ::after 彗尾 right:40%、84×12px 细长锥形拖尾 linear-gradient(90deg,transparent,rgba(224,254,255,.25) 26%,rgba(224,254,255,.75) 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.2 + 深色带 7 粒 by +5.5~+8 贴光核下缘）椭圆小块前大后小（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 与主体 1.8s 呼吸非整数倍错开，禁止同频齐步闪）；粒子 z-index:1 在彗尾之上（尾 z-index:0）、opacity:0 起步呼吸发光分层不同频：主体光核 1.8s 与彗尾 2.4s 周期呼吸（comet 双动画 cometFade + glowPulse 1.8s ease-in-out infinite：纯白晕光晕 0%↔50% 周期扩缩（50% 时白晕最盛 = 白色呼吸，扫过 1.1s 内可见一轮明暗）；::after 挂 tailGlow 2.4s ease-in-out infinite：filter blur(1px) brightness(1) ↔ blur(1.5px) brightness(1.28) 亮度呼吸），粒子 1.5~1.8s 明灭与主体 1.8s 呼吸非整数倍错开（视觉错落不同频）；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 1.8s 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:var(--panel)，不支持的老浏览器走默认实心深蓝不白屏）；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 之下一层）；卡片级 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`）另存不覆盖
-- 落盘完成后，对话回复必须向用户报告落盘位置：列出实际写入的目录完整路径与文件清单（如「已落盘到 /Users/.../reports/2026-10-23/：weekly-report-20261019~20261025.md、.txt、.html、-content.png」），并注明 html 是否已在浏览器打开、截图是否跳过（Chrome/Edge 都不存在时）；DISK=false 或未落盘时注明「本次仅对话输出，未落盘」
+- 落盘完成后，对话回复必须向用户报告落盘位置：列出实际写入的目录完整路径与文件清单（如「已落盘到 ~/reports/2026-10-23/：weekly-report-20261019~20261025.md、.txt、.html、-content.png」），并注明 html 是否已在浏览器打开、截图是否跳过（Chrome/Edge 都不存在时）；DISK=false 或未落盘时注明「本次仅对话输出，未落盘」
 - 落盘文件清单以顶部 FORMATS 为准；显式格式参数（如 `/weekly-report 20261020 md`）只影响对话输出形态，不影响落盘清单

package/weekly-report/resources/reference.html

@@ -3,6 +3,8 @@
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="sf-template" content="weekly-report@2">
+<meta name="weekly-id" content="REF-WEEKLY-0000">
 <title>本周周报 - 20261102 ~ 20261106</title>
 <style>
 /* ═══ 五主题令牌：12 核心契约（与 magic-deck 一致）+ 报告扩展（发光/氛围/热力/语义色）；html[data-theme] 运行时切换，THEME 生成时定默认 ═══ */
@@ -753,7 +755,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
     </div>
   </div>
 
-  <div class="footer">GENERATED BY SPECCORE TEAM · 20261102 ~ 20261106</div>
+  <div class="footer">GENERATED BY AI TEAM · 20261102 ~ 20261106</div>
 </div>
 
 <!-- 主题换肤坞（五色点） -->
@@ -1003,6 +1005,25 @@ function sheen(track, src){
   window.addEventListener('resize', function(){ charts.forEach(function(c){ c.chart.resize(); }); });
 })();
 // 主题换肤：五套配色随点随换；记忆上次选择（localStorage，失败静默）；?shot 截图模式隐藏坞
+
+/* 稳定身份命名空间：localStorage 键按页内嵌唯一 ID（meta weekly-id）命名——Chrome/Safari 下 file:// 与 localhost 共享同源存储，固定键名会导致多份产物互相串台；ID 与文件路径解耦，改名/移动目录记忆不丢 */
+var SF_ID = ((document.querySelector('meta[name="weekly-id"]') || {}).content || 'REF-WEEKLY-0000').trim();
+/* ID 格式自愈（格式定死执行层）：meta 非法或缺失（占位残留/手写变体/误沿用旧值）时按路径键自愈为 crypto.randomUUID() 标准 v4，同路径跨打开稳定；合法 UUID 原样使用（复制文件副本=同一身份共享数据，是特性） */
+if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(SF_ID)) {
+  var __sfHealKey = 'sf-heal:' + location.pathname;
+  try { SF_ID = localStorage.getItem(__sfHealKey) || SF_ID; } catch (e) {}
+  if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(SF_ID)) {
+    try { SF_ID = crypto.randomUUID(); } catch (e) {
+      SF_ID = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c){ var r = Math.random()*16|0, v = c === 'x' ? r : (r&0x3|0x8); return v.toString(16); });
+    }
+    try { localStorage.setItem(__sfHealKey, SF_ID); } catch (e) {}
+  }
+  var __sfMeta = document.querySelector('meta[name="weekly-id"]');
+  if (__sfMeta) __sfMeta.setAttribute('content', SF_ID);
+  console.warn('[weekly-report] meta weekly-id 非法或缺失，已自愈为标准 v4 ID（' + SF_ID + '），建议重新生成页面固化');
+}
+
+var SF_NS = 'weekly:' + SF_ID;
 (function(){
   var THEMES = ['tech','biz','mono','light','warm'];
   var dock = document.getElementById('themeDock');
@@ -1010,10 +1031,10 @@ function sheen(track, src){
   if (location.search.indexOf('shot=') !== -1){ dock.style.display = 'none'; }
   function apply(t){ document.documentElement.setAttribute('data-theme', t);
     dock.querySelectorAll('.th-dot').forEach(function(d){ d.classList.toggle('on', d.getAttribute('data-theme') === t); });
-    try{ localStorage.setItem('sf-report-theme', t); }catch(e){}
+    try{ localStorage.setItem(SF_NS + '-theme', t); }catch(e){}
     if (window.__sfEchartsTheme) window.__sfEchartsTheme(); }
   var cur = document.documentElement.getAttribute('data-theme');
-  var saved = null; try{ saved = localStorage.getItem('sf-report-theme'); }catch(e){}
+  var saved = null; try{ saved = localStorage.getItem(SF_NS + '-theme') || localStorage.getItem('sf:' + location.pathname + '-theme'); }catch(e){}
   if (saved && THEMES.indexOf(saved) !== -1 && saved !== cur){ apply(saved); }
   else{ dock.querySelectorAll('.th-dot').forEach(function(d){ d.classList.toggle('on', d.getAttribute('data-theme') === (cur || 'tech')); }); }
   dock.querySelectorAll('.th-dot').forEach(function(d){ d.addEventListener('click', function(){ apply(d.getAttribute('data-theme')); }); });

package/weekly-report/resources/usage-guide.md

@@ -66,3 +66,11 @@
 | CONFIRM | 落盘前先出效果确认 | never（直接生成不确认，默认）/ text（纯文字整理模式确认）/ always（所有生成都确认） |
 - 优先级：临时口头要求（不落盘/写到桌面/只要 md/只要内容区截图/这次不截图/别开浏览器/临时换模板/临时改周结束日等）永远优先于默认配置，仅对当次生效、不改配置
 - DIR（按系统解析）指向的目录/盘符不存在时，自动回退到用户主目录下 reports（macOS=~/reports、Windows=%USERPROFILE%\reports）
+
+## 效果不对怎么办
+
+- 页面效果不对（布局乱 / 样式错 / 交互异常 / 内容显示不全），直接对 AI 说「这个页面效果不对，对照参考模板修复」，把问题描述清楚（哪一节、什么现象，能截图最好）
+- 本技能的设计标准答案就在技能目录里：`resources/reference.html`（双击可直接打开看标准效果），AI 修复时以此为唯一对照
+- AI 的处理流程固定：先打开 reference.html 作标准 → 再读你那份问题 html 文件 → 逐处比对找出跑偏的地方 → 以 reference 为准修复 → 用浏览器自动截图对比修复前后，自证修好了再交付
+- 效果对了但内容不对（数字/条目写错）同样说「内容有误：xxx 应该是 xxx」，AI 只改数据不动版式；参考模板本身有缺陷时（生成结果与 reference 一模一样但仍有问题）说一句「参考模板也有这个问题」，AI 会连模板一起修并同步回 reference.html
+- 修复后想要永久按修复效果生成：说「以后都按这个效果生成」即可

package/weekly-report/user-config.md

@@ -16,22 +16,22 @@ DIR: auto                      # 落盘根目录：auto = 按当前系统自动
 DIR_MAC: ~/reports                               # macOS 落盘根目录（日报按目标日期、周报按当周最后一天建子目录；目录不存在时回退用户主目录下 reports）
 DIR_WIN: %USERPROFILE%\reports                   # Windows 落盘根目录（日报按目标日期、周报按当周最后一天建子目录；目录/盘符不存在时回退用户主目录下 reports）
 OPEN_HTML: true                # 落盘后是否自动用浏览器打开 html（FORMATS 不含 html 时忽略）
-THEME: tech                    # html 页面主题：tech 深蓝科技（默认）/ biz 浅色商务 / mono IDEA 黑亮 / light IDEA 白亮 / warm 温暖渐变；生成时写 <html data-theme="THEME值"> 定默认，页面右下角换肤坞五色点随点随换（浏览器本地记忆，?shot 截图模式自动隐藏，打印隐藏）
+THEME: tech                    # html 页面主题：tech 深蓝科技（默认）/ biz 浅色商务 / mono IDEA 黑亮 / light IDEA 白亮 / warm 温暖渐变；生成时写 <html data-theme="THEME值"> 定默认，页面右下角换肤坞五色点随点随换（浏览器本地记忆（键按页内嵌唯一 ID 隔离、多份产物互不串台、改名/移动目录记忆不丢；生成时头部写 `<meta name="weekly-id" content="<UUID>">`，每次新 UUID），?shot 截图模式自动隐藏，打印隐藏）
 TEMPLATE: default              # 报告模板：default = 内置四段式（本周结论 + 本周任务进度/下周计划/风险阻塞点）；custom = 使用下方「📝 自定义模板」节；口头临时指定模板仅当次生效
 ROLE: 全栈开发工程师（企业内技术开发）  # 用户默认职业角色与主要工作内容（两者并存：职业名 + 括号内工作内容，生成内容/术语/量化指标/热力图/柱图/风险话术全部按此画像走）；用户随口描述职业时（如「我搞装修的，天天跑工地」）→ AI 提炼为规范表述（装修项目经理（负责工地现场管理、施工进度与质量巡检））更新此处；说「以 XX 的身份写」→ 当次临时换角色不改配置；说「以后默认用 XX 角色 / 我的职业是 XX / 我的主要工作是 XX」→ 永久更新此处
 WEEK_END: friday               # 周结束日（当周最后一天）：friday = 每周五（默认）；可改 sunday = 每周日、saturday 等；周范围、落盘子目录名均按该天日期
 CONFIRM: never                 # 落盘前确认：never = 直接生成落盘不确认（默认）；text = 纯文字整理模式先出效果确认后再落盘；always = 任何方式生成都先确认；临时说「先看看效果」当次先确认、说「不用确认」当次跳过
-DATA_SOURCES: []               # 数据源清单（升级不覆盖；AI 每次生成前 Read 本文件按此清单收集；空清单 = 只按会话/文字内容生成）。每项：name 唯一名称 + type 类型 + 路径。三种类型示例（把下方 # 注释示例改成你的真实数据源后填入上方数组）：
+DATA_SOURCES: []               # 数据源清单（升级不覆盖；AI 每次生成前 Read 本文件按此清单收集；空清单 = 只按会话/文字内容生成）。每项：name 唯一名称 + type 类型 + 路径。三种类型示例（把下方 # 注释示例改成你的真实数据源后填入上方数组；未知 type（拼写错误）忽略该项并在生成时一句话提示，不中断）：
   # - name: 主项目仓库          # 名称：唯一 key（重名视为同一数据源；口述「只聚合 xxx」按 name 匹配）
-  #   type: git                # git = 代码仓库（git log 聚合提交）
+  #   type: git                # git = 代码仓库（git log 聚合提交；路径不存在/非代码仓库时静默跳过）
   #   mac: ~/Projects/main-app  # macOS 路径（绝对路径或 ~ 开头）
   #   win: D:\Projects\main-app # Windows 路径；「-」= 该系统不存在，自动跳过
   # - name: 周例会纪要
-  #   type: file               # file = 普通文件/目录（直接 Read 内容聚合，适合文档/纪要/日志素材）
+  #   type: file               # file = 普通文件/目录（文件 Read 全文、目录逐个 Read 文本文件，二进制跳过；路径无效静默跳过）
   #   mac: ~/Documents/meeting-notes.md
   #   win: -
   # - name: 数据接口
-  #   type: remote             # remote = 远程网络源（AI 联网拉取 url 内容；仅生成时联网，HTML 产物仍零外链）
+  #   type: remote             # remote = 远程网络源（只需 url 字段忽略 mac/win；AI 联网拉取内容提取要点；失败静默跳过不阻塞；仅收集时联网，HTML 产物仍零外链）
   #   url: https://example.com/data.json
 ```