skill-forge-hub 1.0.4 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +82 -150
  3. package/annual-report/SKILL.md +23 -3
  4. package/annual-report/resources/data-collection.md +20 -4
  5. package/annual-report/resources/disk-and-html.md +3 -3
  6. package/annual-report/resources/reference.html +31 -10
  7. package/annual-report/resources/usage-guide.md +8 -0
  8. package/annual-report/user-config.md +5 -5
  9. package/article-to-html/SKILL.md +26 -7
  10. package/article-to-html/design-system.md +9 -3
  11. package/article-to-html/resources/reference.html +631 -0
  12. package/article-to-html/resources/usage-guide.md +9 -1
  13. package/article-to-html/user-config.md +6 -3
  14. package/cli.js +2 -2
  15. package/daily-report/SKILL.md +23 -3
  16. package/daily-report/resources/content-rules.md +1 -1
  17. package/daily-report/resources/data-collection.md +24 -4
  18. package/daily-report/resources/disk-and-html.md +2 -2
  19. package/daily-report/resources/reference.html +24 -3
  20. package/daily-report/resources/usage-guide.md +8 -0
  21. package/daily-report/user-config.md +5 -5
  22. package/deck-stage/SKILL.md +15 -4
  23. package/deck-stage/resources/cover-template.html +3 -3
  24. package/deck-stage/resources/data-schema.md +11 -1
  25. package/deck-stage/resources/pptx-builder.js +1 -1
  26. package/deck-stage/resources/usage-guide.md +9 -2
  27. package/docs/architecture.md +89 -0
  28. package/docs/images/article-to-html.png +0 -0
  29. package/docs/images/daily-report.png +0 -0
  30. package/docs/images/deck-stage.png +0 -0
  31. package/docs/images/magic-deck.png +0 -0
  32. package/docs/images/meeting-minutes.png +0 -0
  33. package/docs/images/prompt-pouch.png +0 -0
  34. package/docs/install.md +71 -0
  35. package/magic-deck/SKILL.md +23 -8
  36. package/magic-deck/resources/content-guide.md +5 -4
  37. package/magic-deck/resources/deck-spec.md +18 -11
  38. package/magic-deck/resources/reference.html +110 -32
  39. package/magic-deck/resources/usage-guide.md +10 -2
  40. package/magic-deck/user-config.md +4 -4
  41. package/meeting-minutes/SKILL.md +51 -0
  42. package/meeting-minutes/resources/content-rules.md +57 -0
  43. package/meeting-minutes/resources/disk-and-html.md +26 -0
  44. package/meeting-minutes/resources/meeting-type-dictionary.md +24 -0
  45. package/meeting-minutes/resources/reference.html +436 -0
  46. package/meeting-minutes/resources/usage-guide.md +63 -0
  47. package/meeting-minutes/user-config.md +56 -0
  48. package/meta-forge/SKILL.md +6 -6
  49. package/meta-forge/resources/forge-rules.md +55 -10
  50. package/meta-forge/resources/usage-guide.md +7 -3
  51. package/meta-forge/user-config.md +1 -1
  52. package/monthly-report/SKILL.md +62 -0
  53. package/monthly-report/resources/content-rules.md +40 -0
  54. package/monthly-report/resources/data-collection.md +44 -0
  55. package/monthly-report/resources/date-parsing.md +18 -0
  56. package/monthly-report/resources/disk-and-html.md +29 -0
  57. package/monthly-report/resources/industry-dictionary.md +21 -0
  58. package/monthly-report/resources/reference.html +531 -0
  59. package/monthly-report/resources/usage-guide.md +75 -0
  60. package/monthly-report/user-config.md +53 -0
  61. package/package.json +9 -2
  62. package/prompt-pouch/SKILL.md +17 -2
  63. package/prompt-pouch/resources/data-format.md +1 -1
  64. package/prompt-pouch/resources/reference.html +56 -24
  65. package/prompt-pouch/resources/usage-guide.md +10 -3
  66. package/quarterly-report/SKILL.md +63 -0
  67. package/quarterly-report/resources/content-rules.md +42 -0
  68. package/quarterly-report/resources/data-collection.md +46 -0
  69. package/quarterly-report/resources/date-parsing.md +19 -0
  70. package/quarterly-report/resources/disk-and-html.md +22 -0
  71. package/quarterly-report/resources/industry-dictionary.md +21 -0
  72. package/quarterly-report/resources/reference.html +509 -0
  73. package/quarterly-report/resources/usage-guide.md +76 -0
  74. package/quarterly-report/user-config.md +53 -0
  75. package/spec-doc2spec/SKILL.md +21 -22
  76. package/spec-doc2spec/resources/checklist.md +7 -0
  77. package/spec-doc2spec/resources/images.md +14 -5
  78. package/spec-doc2spec/resources/structure.md +19 -10
  79. package/spec-doc2spec/resources/usage-guide.md +10 -8
  80. package/spec-doc2spec/user-config.md +2 -2
  81. package/spec-spec2doc/SKILL.md +4 -4
  82. package/spec-spec2doc/resources/checklist.md +6 -0
  83. package/spec-spec2doc/resources/pdf-path.md +1 -0
  84. package/spec-spec2doc/resources/usage-guide.md +2 -2
  85. package/template/SKILL.md +1 -1
  86. package/weekly-report/SKILL.md +23 -3
  87. package/weekly-report/resources/content-rules.md +1 -1
  88. package/weekly-report/resources/data-collection.md +24 -4
  89. package/weekly-report/resources/disk-and-html.md +2 -2
  90. package/weekly-report/resources/reference.html +24 -3
  91. package/weekly-report/resources/usage-guide.md +8 -0
  92. package/weekly-report/user-config.md +5 -5
package/annual-report/resources/usage-guide.md CHANGED
@@ -65,3 +65,11 @@
65
65
  | CONFIRM | 落盘前先出效果确认 | never（直接生成不确认，默认）/ text（纯文字整理模式确认）/ always（所有生成都确认） |
66
66
  - 优先级：临时口头要求（不落盘/写到桌面/只要 md/只要内容区截图/这次不截图/别开浏览器/临时换模板等）永远优先于默认配置，仅对当次生效、不改配置
67
67
  - DIR（按系统解析）指向的目录/盘符不存在时，自动回退到用户主目录下 reports（macOS=~/reports、Windows=%USERPROFILE%\reports）
68
+
69
+ ## 效果不对怎么办
70
+
71
+ - 页面效果不对（布局乱 / 样式错 / 交互异常 / 内容显示不全），直接对 AI 说「这个页面效果不对，对照参考模板修复」，把问题描述清楚（哪一节、什么现象，能截图最好）
72
+ - 本技能的设计标准答案就在技能目录里：`resources/reference.html`（双击可直接打开看标准效果），AI 修复时以此为唯一对照
73
+ - AI 的处理流程固定：先打开 reference.html 作标准 → 再读你那份问题 html 文件 → 逐处比对找出跑偏的地方 → 以 reference 为准修复 → 用浏览器自动截图对比修复前后，自证修好了再交付
74
+ - 效果对了但内容不对（数字/条目写错）同样说「内容有误：xxx 应该是 xxx」，AI 只改数据不动版式；参考模板本身有缺陷时（生成结果与 reference 一模一样但仍有问题）说一句「参考模板也有这个问题」，AI 会连模板一起修并同步回 reference.html
75
+ - 修复后想要永久按修复效果生成：说「以后都按这个效果生成」即可
package/annual-report/user-config.md CHANGED
@@ -16,21 +16,21 @@ DIR: auto # 落盘根目录：auto = 按当前系统自动
16
16
  DIR_MAC: ~/reports # macOS 落盘根目录（自动按目标年度建子目录 annual-YYYY；目录不存在时回退用户主目录下 reports）
17
17
  DIR_WIN: %USERPROFILE%\reports # Windows 落盘根目录（自动按目标年度建子目录 annual-YYYY；目录/盘符不存在时回退用户主目录下 reports）
18
18
  OPEN_HTML: true # 落盘后是否自动用浏览器打开 html（FORMATS 不含 html 时忽略）
19
- THEME: tech # html 页面主题：tech 深蓝科技（默认）/ biz 浅色商务 / mono IDEA 黑亮 / light IDEA 白亮 / warm 温暖渐变；生成时写 <html data-theme="THEME值"> 定默认，页面右下角换肤坞五色点随点随换（浏览器本地记忆，?shot 截图模式自动隐藏，打印隐藏）
19
+ THEME: tech # html 页面主题：tech 深蓝科技（默认）/ biz 浅色商务 / mono IDEA 黑亮 / light IDEA 白亮 / warm 温暖渐变；生成时写 <html data-theme="THEME值"> 定默认，页面右下角换肤坞五色点随点随换（浏览器本地记忆（键按页内嵌唯一 ID 隔离、多份产物互不串台、改名/移动目录记忆不丢；生成时头部写 `<meta name="annual-id" content="<UUID>">`，每次新 UUID），?shot 截图模式自动隐藏，打印隐藏）
20
20
  TEMPLATE: default # 报告模板：default = 内置五段式（年度概览/核心成果与里程碑/经验与成长/不足与反思/新年展望与规划）；custom = 使用下方「📝 自定义模板」节；口头临时指定模板仅当次生效
21
21
  ROLE: 全栈开发工程师（企业内技术开发） # 用户默认职业角色与主要工作内容（两者并存：职业名 + 括号内工作内容，生成内容/术语/量化指标/里程碑/风险话术全部按此画像走）；用户随口描述职业时（如「我搞装修的，天天跑工地」）→ AI 提炼为规范表述（装修项目经理（负责工地现场管理、施工进度与质量巡检））更新此处；说「以 XX 的身份写」→ 当次临时换角色不改配置；说「以后默认用 XX 角色 / 我的职业是 XX / 我的主要工作是 XX」→ 永久更新此处
22
22
  CONFIRM: never # 落盘前确认：never = 直接生成落盘不确认（默认）；text = 纯文字整理模式先出效果确认后再落盘；always = 任何方式生成都先确认；临时说「先看看效果」当次先确认、说「不用确认」当次跳过
23
- DATA_SOURCES: [] # 数据源清单（升级不覆盖；AI 每次生成前 Read 本文件按此清单收集；空清单 = 只按会话/文字内容生成）。每项：name 唯一名称 + type 类型 + 路径。三种类型示例（把下方 # 注释示例改成你的真实数据源后填入上方数组）：
23
+ DATA_SOURCES: [] # 数据源清单（升级不覆盖；AI 每次生成前 Read 本文件按此清单收集；空清单 = 只按会话/文字内容生成）。每项：name 唯一名称 + type 类型 + 路径。三种类型示例（把下方 # 注释示例改成你的真实数据源后填入上方数组；未知 type（拼写错误）忽略该项并在生成时一句话提示，不中断）：
24
24
  # - name: 主项目仓库 # 名称：唯一 key（重名视为同一数据源；口述「只聚合 xxx」按 name 匹配）
25
- # type: git # git = 代码仓库（git log 聚合提交）
25
+ # type: git # git = 代码仓库（git log 聚合提交；路径不存在/非代码仓库时静默跳过）
26
26
  # mac: ~/Projects/main-app # macOS 路径（绝对路径或 ~ 开头）
27
27
  # win: D:\Projects\main-app # Windows 路径；「-」= 该系统不存在，自动跳过
28
28
  # - name: 周例会纪要
29
- # type: file # file = 普通文件/目录（直接 Read 内容聚合，适合文档/纪要/日志素材）
29
+ # type: file # file = 普通文件/目录（文件 Read 全文、目录逐个 Read 文本文件，二进制跳过；路径无效静默跳过）
30
30
  # mac: ~/Documents/meeting-notes.md
31
31
  # win: -
32
32
  # - name: 数据接口
33
- # type: remote # remote = 远程网络源（AI 联网拉取 url 内容；仅生成时联网，HTML 产物仍零外链）
33
+ # type: remote # remote = 远程网络源（只需 url 字段忽略 mac/win；AI 联网拉取内容提取要点；失败静默跳过不阻塞；仅收集时联网，HTML 产物仍零外链）
34
34
  # url: https://example.com/data.json
35
35
  ```
36
36
 
package/article-to-html/SKILL.md CHANGED
@@ -13,11 +13,11 @@ Turn any Word/Markdown/plain-text article into a standalone styled HTML page and
13
13
 
14
14
  ## ⚙️ 配置与自定义主题
15
15
 
16
- **执行本 skill 前必须先 Read 同目录 `user-config.md`**：`THEME` 配置决定 A 款页面的默认主题色（tech 科技蓝 / gold 暖棕金 / forest 墨绿 / plum 梅紫）。升级技能时 user-config.md 不会被覆盖，你的修改永久保留。
16
+ **执行本 skill 前必须先 Read 同目录 `user-config.md`**：`THEME` 配置决定 A 款页面的默认主题色（tech 科技蓝 / gold 暖棕金 / forest 墨绿 / plum 梅紫）；`DIR` 配置决定产物落盘根目录（auto 按系统选 DIR_MAC/DIR_WIN，目录不存在时回退用户主目录，用户口头指定目录永远优先）。升级技能时 user-config.md 不会被覆盖，你的修改永久保留。
17
17
 
18
18
  ## 配置版本机制（升级保护）
19
19
 
20
- 本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明不一致：
20
+ 本 skill 当前配置版本为 `2`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明不一致：
21
21
  1. 将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`
22
22
  2. 保留用户全部自定义字段，按本节「当前版本变更记录」逐项改写旧字段
23
23
  3. 更新 CONFIG_VERSION 为当前版本
@@ -27,7 +27,12 @@ Turn any Word/Markdown/plain-text article into a standalone styled HTML page and
27
27
 
28
28
  **无法迁移项处理**（值域失效 / 语义漂移 / 数据不兼容）：三情形——①旧值不在新值域（如旧模板/主题名已移除）②同名键含义变化（单位/枚举变更）③数据文件 schema 不兼容。三绝不：绝不静默（无法迁移项停下问，不猜值）、绝不丢失（旧值永远在 .bak-时间戳）、一次说清（升级报告三段式：⚠️ 版本与备份路径 → ✅ 已自动迁移清单 → 🟡 无法迁移项逐条附原因+影响+建议替代）；随后 AskUserQuestion 三选项（A 用建议值 / B 用户给新值 / C 保持旧配置——不更新 CONFIG_VERSION，每次执行再提醒）；报告必附回滚一句话；数据文件迁移前先复制 .bak-时间戳，能映射则映射、不能则写兼容层或留备份提示手动整理
29
29
 
30
- 当前版本变更记录：暂无（初始版本 1，含 THEME 字段）。
30
+ 当前版本变更记录：
31
+ - v1→v2：新增 `DIR: auto` + `DIR_MAC: ~/articles` + `DIR_WIN: %USERPROFILE%\articles`（产物落盘根目录，auto 按系统选、目录不存在回退用户主目录、口头指定优先）；其余字段不变。
32
+
33
+ ## 产物升级（回炉）
34
+
35
+ 生成 HTML 时头部写版本戳 `<meta name="sf-template" content="article-to-html@2">`（模板升级时递增 @N 并同步 reference.html 与本文档）。用户说「升级旧产物/回炉旧页面/旧文章页换新样式」时：扫落盘目录下本技能生成的 html，读版本戳筛出旧版（无版本戳或缺少 `<meta name="article-id">` 稳定 ID 的产物视为 v0 最旧版，一并进清单）→ 列清单（文件/旧版本/手改状态——html 与同目录 md 底稿正文对比，不一致视为可能手改过；无 md 底稿时标记「无法比对」）→ AskUserQuestion 选全部或部分 → 逐份升级：浅升级（仅 CSS/JS 变化）对旧页替换 `<style>` 块与交互脚本、正文内容原样保留；深升级（DOM 结构变化）从 md 底稿按当前 reference.html 重建（无 md 底稿则提取旧 html 正文重建），先备份旧版 `.bak-时间戳` → 报告三段式：✅ 已升级清单 / ⚠️ 手改保留说明 / 🟡 失败项原因。模板改动分级：业务改动（板块/段落/标题体系）、数据格式改动（字段/存储结构）、页面改动（样式/布局/交互）任一发生即模板升级，版本戳 +1 并同步 reference.html 与本文档；纯措辞润色不 bump。每次生成 HTML 时顺扫落盘目录读版本戳：发现旧版产物（vN-1 或无版本戳的历史产物）主动告知「技能模板已升级至 vN，检测到 X 份旧版文章页，说『把我旧文章页都升级成新样式』即可一键升级」，不让用户背触发语。
31
36
 
32
37
  ## Prerequisites（新用户准备）
33
38
 
@@ -86,12 +91,13 @@ Turn any Word/Markdown/plain-text article into a standalone styled HTML page and
86
91
  - 通读解析出的内容，判断文章气质（科技 / 文艺 / 教程 / 科普 / 报道 / 商业等），从 [design-system.md](design-system.md)「0. 风格菜单」的六款版式中选一款
87
92
  - 默认款（暗色封面长文风）适用于大多数科技 / 产品文；文艺散文选文艺排版风；教程干货选极简白；硬核技术选终端极客风；科普清单选卡片流；深度报道选报纸分栏
88
93
  - 拿不准或用户有明确偏好时，用 AskUserQuestion 让用户在 2-4 款候选里挑（每款附一句话气质描述），不替用户做有风格争议的决定
89
- - A 款页面主题色默认取 user-config.md 的 `THEME` 值写入 `<html data-theme>`，页面右下角换肤坞四色点随点随换（浏览器本地记忆）
94
+ - A 款页面主题色默认取 user-config.md 的 `THEME` 值写入 `<html data-theme>`，页面右下角换肤坞四色点随点随换（浏览器本地记忆，键按页内嵌唯一 ID 隔离、多份产物互不串台、改名/移动目录记忆不丢（生成时头部写 `<meta name="article-id" content="<UUID>">`，每次 crypto.randomUUID() 生成标准 UUID v4（8-4-4-4-12 十六进制，禁止手写变体、禁止沿用占位与旧值）；落盘写文件前顺扫落盘目录下本技能命名的 html，读各文件 id meta 查重，撞号重掷至不重复））
90
95
  - 任何风格都不许引入第三个字体：文艺排版风同样只用思源黑体，文艺感靠排版营造（大行距、留白、首字下沉、细分割线），不得改用宋体
91
96
  - 无论哪款风格：字体白名单锁死（Roboto + 思源黑体）、零兜底、第 3.5 步核查照跑
92
97
 
93
98
  ### 3. Build the HTML
94
99
 
100
+ - **先 Read `resources/reference.html`**（A 款骨架与 18 组件全集，设计真相源）再动手——骨架结构、组件用法、主题令牌以 reference.html 为准，与 design-system.md 冲突时 reference.html 说了算
95
101
  - 先写入当前工作区（如 `outputs/<标题>.html`），完成后用 Bash `cp` 到用户目标目录——Write 工具被沙盒限制在工作区内
96
102
  - 大文件分片写：Write 创建文件（head + 封面 + 前几章），后续用 SearchReplace 以文件末尾 `</section>\n</div>\n</body>\n</html>` 为锚点追加章节
97
103
  - 使用 [design-system.md](design-system.md) 中的 CSS 变量与组件模式；源文档中每张图表必须有对应的 HTML/CSS 组件；表格 `td` 一律 `vertical-align:middle`
@@ -158,7 +164,7 @@ grep -nE "PingFang|YaHei|apple-system|sans-serif|serif|monospace|SF Mono|Menlo|M
158
164
  - 截图对象：封面 `.hero` + `.wrap` 内每个 `section`（引言 + 各章 + 写在最后 + 作者），一章节一张
159
165
  - **统一宽度**：JS 注入 `.hero` → `width:730px;margin:0 auto;padding:112px 16px 104px;box-sizing:border-box`；每个 section → `padding:72px 16px 24px`；DPR=2 时所有图宽度一致（1460px）
160
166
  - 元素级截图，截前先 `scrollIntoView`；四周 16px 内边距保证 box-shadow 阴影完整显示
161
- - 命名与顺序：`C00-封面.png`、`C00-引言.png`、`C01-<章节短名>.png` … `C13-作者介绍.png`，保存到 `<目标目录>/文章截图/章节截图/`
167
+ - 命名与顺序：`C00-封面.png`、`C00-引言.png`、`C01-<章节短名>.png` … `C13-作者介绍.png`，保存到 `<目标目录>/文章截图/<标题slug>/`（slug 用简洁英文或拼音；每篇文章一个目录，多篇文章截图互不覆盖；同一目标目录下已有同 slug 目录时对话确认归属，同名不同篇则 slug 追加 -2/-3 序号）
162
168
  - 若子代理报浏览器窗口不可见（`NATIVE_BROWSER_VIEWPORT_UNAVAILABLE`），请用户把浏览器窗口置前，然后重新派发子代理；不要无限重试
163
169
 
164
170
  - **窗口不可见时的 headless 兜底**（三轮置前失败后直接走此路，无需可见窗口）：
@@ -187,7 +193,7 @@ grep -nE "PingFang|YaHei|apple-system|sans-serif|serif|monospace|SF Mono|Menlo|M
187
193
  - 等价于「更新模式」的「仅改样式保留内容」：只动 CSS（配色/间距/字号/组件样式），不动正文；若外来 HTML 缺章节骨架，可顺手改造成自家骨架（文字不动）
188
194
  - **每轮调整后重跑第 3.5 步核查**，防调整引入新字体污染
189
195
  - 第 4.5 步双确认闭环照跑：美化完先 RunPreview 问满意，点头才进入截图；至多 3 轮
190
- - 美化 A 款自家骨架时保留换肤坞（坞 HTML + 坞 JS + [data-theme] 块）；被误删时按 design-system.md 骨架模板补装
196
+ - 美化 A 款自家骨架时保留换肤坞（坞 HTML + 坞 JS + [data-theme] 块）；被误删时按 reference.html 的坞 HTML/坞 JS 补装
191
197
  - 美化定稿后用户要截图 → 转 6.3；单文件版如需要，用 inline_fonts.py 重铸
192
198
 
193
199
  **6.3 只截图**
@@ -203,15 +209,28 @@ grep -nE "PingFang|YaHei|apple-system|sans-serif|serif|monospace|SF Mono|Menlo|M
203
209
 
204
210
  ## Output conventions
205
211
 
212
+ <目标目录> = 用户口头指定的目录；未指定时取 user-config.md 的 DIR（auto 按系统选 DIR_MAC/DIR_WIN，目录不存在时回退用户主目录）。
213
+
206
214
  ```
207
215
  <目标目录>/
208
216
  ├── <标题>.html # 标准版（依赖 assets/fonts）
209
217
  ├── <标题>-单文件版.html # 字体全内嵌，双击即开
210
218
  ├── assets/fonts/roboto-latin-{400,500,700,900}-normal.woff2
211
- └── 文章截图/章节截图/
219
+ └── 文章截图/<标题slug>/ # 每篇文章一个目录，互不覆盖
212
220
  ├── C00-封面.png C00-引言.png C01-*.png … C13-作者介绍.png
213
221
  ```
214
222
 
223
+
224
+ ## 🔧 报修处理流程（用户报页面问题时）
225
+
226
+ 用户说「页面 / 截图效果不对 / 第 X 章有 XX 问题 / 布局乱了」（常附截图或指出具体现象）→ 按以下流程处理：
227
+
228
+ 1. **立标准**：先 Read `resources/reference.html`——A 款骨架与组件全集就是本 skill 的设计真相源；六款版式参数对照根目录 `design-system.md`；两者冲突以 reference.html 为准
229
+ 2. **找问题**：Read 那份问题 html，对照 design-system.md 逐处比对（版式结构 / --accent 令牌 / 字体白名单 / 图表组件），定位跑偏处；用户给了截图则按截图现象反查
230
+ 3. **修复**：以 design-system.md 为准修复（只修跑偏处）；改完重跑「3.5 交付前零侵权核查」grep 扫描——任何字体污染命中必须清零
231
+ 4. **自证**：按第 5 步规格重截问题章节（1460px 统一宽度），Read 自查恢复标准效果；用户给了问题截图时尽量复现同视角截图做前后对比
232
+ 5. **汇报**：一句话说清问题根因 + 修复了什么 + 附截图；若根因在 design-system.md 或 reference.html 自身（版式规范本身有缺陷），顺修这两个文件保持同步（reference.html 是真相源）并在汇报中说明「设计标准已同步修正」
233
+
215
234
  ## Pitfalls
216
235
 
217
236
  1. **Write 沙盒限制**：工作区外无法直接 Write → 写工作区 `outputs/` 再 `cp` 到目标目录
package/article-to-html/design-system.md CHANGED
@@ -2,6 +2,8 @@
2
2
 
3
3
  本文件提供文章 HTML 的设计系统：CSS 变量 + 组件类名 + 关键样式片段。执行时按需复制到 `<style>` 中，并根据文章内容裁剪不需要的组件。
4
4
 
5
+ > ⚠️ **真相源铁律**：本文件与 `resources/reference.html` 构成双轨——reference.html 是 A 款完整组装示范（骨架 + 18 组件实例 + 换肤坞），本文件提供六款版式参数与裁剪说明。生成 / 修复任何 A 款页面前必须先 Read 两份，**冲突以 reference.html 为准**；修改 CSS 时两份必须同步更新。
6
+
5
7
  ## 0. 风格菜单（构建前按文章气质选一款）
6
8
 
7
9
  六款版式范式，每款给适用气质与关键参数。选定后其余章节的组件按需裁剪。字体白名单锁死为 Roboto + 思源黑体，任何风格都不许引入其他字体。
@@ -378,7 +380,7 @@ td.hl{font-weight:700;color:var(--ink)}
378
380
  <meta charset="UTF-8">
379
381
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
380
382
  <title>文章标题</title>
381
- <style>/* 按需复制上面的变量与组件样式（A 款含四主题 data-theme 块与换肤坞 CSS） */</style>
383
+ <style>/* 按需复制上面的变量与组件样式（A 款含四主题 data-theme 块与换肤坞 CSS）；完整组装示范见 resources/reference.html */</style>
382
384
  </head>
383
385
  <body>
384
386
  <div class="hero">…封面…</div>
@@ -400,6 +402,10 @@ td.hl{font-weight:700;color:var(--ink)}
400
402
  </div>
401
403
  <script>
402
404
  /* 主题换肤：html[data-theme] 切换 + 记忆上次选择（localStorage，失败静默）；?shot 截图模式隐藏坞 */
405
+
406
+ /* 稳定身份命名空间：localStorage 键按页内嵌唯一 ID（meta article-id）命名——Chrome/Safari 下 file:// 与 localhost 共享同源存储，固定键名会导致多份产物互相串台；ID 与文件路径解耦，改名/移动目录记忆不丢 */
407
+ var SF_ID = ((document.querySelector('meta[name="article-id"]') || {}).content || 'ref-article').trim();
408
+ var SF_NS = 'article:' + SF_ID;
403
409
  (function(){
404
410
  var THEMES=['tech','gold','forest','plum'];
405
411
  var dock=document.getElementById('themeDock');
@@ -408,11 +414,11 @@ td.hl{font-weight:700;color:var(--ink)}
408
414
  function apply(t){
409
415
  document.documentElement.setAttribute('data-theme',t);
410
416
  dock.querySelectorAll('.th-dot').forEach(function(d){ d.classList.toggle('on',d.getAttribute('data-theme')===t); });
411
- try{ localStorage.setItem('sf-article-theme',t); }catch(e){}
417
+ try{ localStorage.setItem(SF_NS + '-theme',t); }catch(e){}
412
418
  }
413
419
  var cur=document.documentElement.getAttribute('data-theme');
414
420
  var saved=null;
415
- try{ saved=localStorage.getItem('sf-article-theme'); }catch(e){}
421
+ try{ saved=localStorage.getItem(SF_NS + '-theme') || localStorage.getItem('sf:' + location.pathname + '-theme'); }catch(e){}
416
422
  if(saved && THEMES.indexOf(saved)!==-1 && saved!==cur){ apply(saved); }
417
423
  else{ dock.querySelectorAll('.th-dot').forEach(function(d){ d.classList.toggle('on',d.getAttribute('data-theme')===(cur||'tech')); }); }
418
424
  dock.querySelectorAll('.th-dot').forEach(function(d){ d.addEventListener('click',function(){ apply(d.getAttribute('data-theme')); }); });