@topmindspace/tms-skills 0.5.0 → 0.7.0

package/topmind-wechat-post/SKILL.md

@@ -1,20 +1,17 @@
 ---
 name: topmind-wechat-post
-version: 0.1.0
-description: "管一篇公众号文章从选题/底稿到发布的完整生命周期：交付包搭建、审校改写、质量三关（事实/逻辑/去AI味）、状态同步、微信内联排版与发布清单。Use when 写公众号、公众号排版、公众号定稿、发公众号。Do NOT use for 只改错别字、小红书/知乎、纯网页发布、封面配图（→topmind-cover）、X 长文（→topmind-x-article）。"
+version: 0.2.0
+description: "管一篇公众号文章从选题/底稿到发布的完整生命周期：交付包搭建、审校改写、质量三关（事实/逻辑/去AI味）、状态同步、微信内联排版与发布清单。Use when 写公众号、公众号排版、公众号定稿、发公众号。Do NOT use for 只改错别字、小红书/知乎、纯网页发布。"
 action_category: write
 triggers:
   - 公众号
   - 微信排版
-  - 微信编辑器
   - 公众号排版
   - 公众号稿
   - 排版这篇文章
-  - 粘贴到公众号
   - 定稿
   - 发公众号
   - 公众号交付
-  - 状态同步
   - wechat
   - mp format
 triggers_cn:
@@ -29,7 +26,7 @@ updated: 2026-09-29
 
 # topmind-wechat-post · 公众号创作技能
 
-管一篇公众号文章从选题/底稿到发布清单的完整生命周期。
+**公众号专用写作技能**。管一篇公众号文章从选题/底稿到发布清单的完整生命周期。
 
 ```
 选题/底稿 → 创作 → 质量三关 → 定稿(状态+目录) → 排版 → 发布清单 →（可选）回推 notes
@@ -37,6 +34,14 @@ updated: 2026-09-29
 
 > 用户明确说公众号 / 微信排版时进本技能；通用长文写作不在本技能范围内。
 
+## 语言铁律
+
+- **默认中文**：标题、正文、配图文案一律用中文写作，这是默认行为，不需要用户每次声明。
+- **英文是例外**：只有用户**明确说**"写英文文章"时才用英文。用户消息里夹杂英文词、
+  给英文参考素材、引用英文原文，都不算"要求写英文"。
+- 引用英文一手素材（官方公告、模型卡、论文标题）时保留英文原文，正文主体仍是中文，
+  必要时在旁给中文翻译。
+
 ## 脚本（真源）
 
 | 脚本 | 用途 |
@@ -50,22 +55,23 @@ updated: 2026-09-29
 | `scripts/scan_ai_flavor.py` | 中文去 AI 味扫描（与 `qu-aiwei-zh` 同源） |
 
 ```bash
-# 路径解析：CLI --base → env TOPMIND_WECHAT_BASE / TOPMIND_WORKSPACE / TOPSTREAM_ROOT → 惯例
+# 路径解析：CLI --base/--workspace → env TOPMIND_WECHAT_BASE / TOPMIND_WORKSPACE / TOPSTREAM_ROOT → 惯例
 export TOPMIND_WORKSPACE=/path/to/workspace   # 推荐
 python3 scripts/new-article.py --slug demo --title "标题" --direction reverse
 python3 scripts/lint-wechat.py --input <包>/公众号稿.md --fix
 python3 scripts/scan_ai_flavor.py <包>/公众号稿.md          # 目标 ≥85
-python3 scripts/md2wechat.py --input <包>/公众号稿.md --out-dir <包> --slug demo --embed-images
+python3 scripts/md2wechat.py --input <包>/公众号稿.md --out-dir <包> --slug demo \
+  --asset-root <素材根> --embed-images
 python3 scripts/sync-status.py --set 定稿 <包> --apply
 ```
 
-细节见 `references/workflow.md` · `references/known-pits.md`。
+细节见 [`references/workflow.md`](references/workflow.md) · [`references/known-pits.md`](references/known-pits.md)。
 
 ## 路径默认
 
 | 用途 | 解析 |
 |------|------|
-| 交付包根 | `--base` → `TOPMIND_WECHAT_BASE` → `{ws}/40-创作/<当年>-公众号`（如 2026-公众号）或 `{ws}/20-专题/<当年>-公众号` |
+| 交付包根 | `--base` → `TOPMIND_WECHAT_BASE` → `{ws}/40-创作/2026-公众号` 或 `{ws}/20-专题/2026-公众号` |
 | 工作区 | `TOPMIND_WORKSPACE` |
 | 底稿/回推 | `--topstream` → `TOPSTREAM_ROOT` → 可选；不存在则跳过 notes 校验 |
 | 终稿交付 | 可 `save-output` 拷贝到 role:delivery（`88-交付/`），包仍留在创作类专题 |
@@ -90,9 +96,13 @@ python3 scripts/sync-status.py --set 定稿 <包> --apply
 
 ### 站外拉取（转载整合 / 在线精选站）
 
-源不在本工作区、也不在 topstream `notes/` 时，**仍落 `reverse` + `target_file: pending`**。
+源不在本工作区、也不在 topstream `notes/` 时，**仍落 `reverse` + `target_file: pending`**。  
 **不要用 `forward`**：它要求 `source_file` 以 `notes/` 开头且文件真实存在，站外源必然过不了 `sync-mapping.py`。
 
+```bash
+python3 scripts/new-article.py --slug <中文短名> --title "<标题>" --direction reverse
+```
+
 取源坑（RSC 载荷、图片 hash 映射、`md5` 去重、截图裁切）见 `references/workflow.md`「站外拉取取源注意」；差异与口径写进包内 `README.md`。
 
 **回推纪律**：notes 保持纯 Markdown（`:::` 容器 / 徽章 / `==高亮==` 只进公众号稿）；回推**务必带 `--assets`**（否则 GitHub 上 `images/` 死链）。命令串见 `references/workflow.md`「收尾」。
@@ -119,6 +129,9 @@ target_file: pending    # reverse：pending | notes/xxx.md
 word_count: 0           # 纯中文字数，sync-status 维护
 ```
 
+**交付铁律**：发布/分享时直接用交付包里的 HTML 原文件原样呈现，
+不临时重新生成版本；`公众号稿.md` 是唯一改稿入口，改稿后重建 HTML 再交付。
+
 状态与目录名**不要手改**：
 
 ```bash
@@ -129,14 +142,16 @@ python3 scripts/sync-status.py --set 定稿 <包> --apply
 
 ### 关 1 · 事实
 
-- 承重数字回**一手来源**；厂商口径 / 据报道 分开写；查不到一手来源的传闻**删**
-- 改稿续写：正文已有数字**回源重核**（上一轮文本最不可信）
-- 多口径显式拆开；表格从数据源生成，禁止手抄
-- 外部工具改过的稿：**先核数字再动文字**；「比值对但绝对值错」= 全段重核
+- 承重数字回**一手来源**；厂商口径 / 据报道 分开写  
+- 查不到一手来源的传闻**删**  
+- 改稿续写：正文已有数字**回源重核**（上一轮文本最不可信）  
+- 多口径（主轮/复跑）显式拆开；表格从数据源生成，禁止手抄  
+- 外部工具改过的稿：**先核数字再动文字**；「比值对但绝对值错」= 全段重核  
 
 ### 关 2 · 逻辑
 
-- 单边结论旁配反方证据；结构前后一致；同一事实多处同值
+- 单边结论旁配反方证据  
+- 结构前后一致；同一事实多处同值  
 
 ### 关 3 · 文字（去 AI 味）
 
@@ -149,17 +164,17 @@ python3 scripts/scan_ai_flavor.py <包>/公众号稿.md   # ≥85（人话）
 - **口语化 ≠ 有人味**：删社交垫词（元叙述、空转过渡、姿态句）  
 - 判据：**这句话删掉之后，读者少知道了什么？**  
 
-详见 `references/writing-quality.md`。
+详见 [`references/writing-quality.md`](references/writing-quality.md)。
 
 ## 排版要点（写稿时）
 
-- 开头 150 字内钩子；单段 ≤110 字；列表项 ≤70 字
-- 二级标题不手写序号（排版层自动生成）；容器：`::: stat|pull|note|tip|warn|danger|dialogue`
-- **`::: stat` 内必须是 `数值 | 说明` 管道行**，否则静默丢弃
-- 评测稿：**图承担数据，正文只解读**；健康密度 **300–450 字/图**
-- 个股用词红线：禁用 买入/推荐/目标价…；文末投资声明
+- 开头 150 字内钩子；单段 ≤110 字；列表项 ≤70 字  
+- 二级标题不手写序号（排版层自动生成）；容器：`::: stat|pull|note|tip|warn|danger|dialogue`  
+- **`::: stat` 内必须是 `数值 | 说明` 管道行**，否则静默丢弃  
+- 评测稿：**图承担数据，正文只解读**；健康密度 **300–450 字/图**  
+- 个股用词红线：禁用 买入/推荐/目标价…；文末投资声明  
 
-更多：`references/typography-rules.md` · `references/wechat-constraints.md`。
+更多：[`references/typography-rules.md`](references/typography-rules.md) · [`references/wechat-constraints.md`](references/wechat-constraints.md)。
 
 ## 排版与导出（必读）
 
@@ -172,26 +187,32 @@ python3 scripts/md2wechat.py \
 
 1. **永远 `--embed-images`**，否则粘贴丢图（相对路径被序列化成 file://）  
 2. **图片 basename 铁律**：正文引用名 = `images/` 目标名；禁止两套同名图共处  
-3. 行内图片（段落里的 `![alt](x.png)`）同样走图片管线：复制到 `images/`、进上传清单、可被内嵌  
-4. 外链三种形态：默认 `footnote`（正文上标 `[n]` + 文末「参考链接」）；`--link-mode inline`（文字正常、URL 灰小字）；`--link-mode note`（整块灰小字，标签与 URL 同降）  
-5. 合规自检出现 `✗` 改生成器，不要手改 HTML  
-
-坑清单：`references/known-pits.md`。
+3. 合规自检出现 `✗` 改生成器，不要手改 HTML  
+4. **配图位置铁律**（2026-10-01 九月全景教训）：图片必须紧跟它证明的那段文字
+   （最多隔一段）；改稿移动段落时图片行一起搬。构建后必跑：嵌入图数量=文档图数量、
+   嵌入图顺序=文档出现顺序（逐张解码与源文件比对）；每张图前后 6 行做主题关键词
+   邻近检查，不通过则人工核对。
+5. **双版一致性校验**（2026-10-01 九月全景教训 B）：同一选题出 X 版后，
+   必跑 X 内嵌图序列 vs 公众号内嵌图序列的逐字节/逐像素比对（X 去掉封面后应完全一致）。
+   X 侧图片顺序必须用 `--images-from 公众号稿.md` 派生，禁止手工拼 `--images`
+   （曾因文件名排序 ≠ 文档顺序，导致 X 版从第六节起整段配图错位）。
+
+坑清单：[`references/known-pits.md`](references/known-pits.md)。
 
 ## 主题
 
-| 文件 | 风格 | 适用（= 各主题 genre 声明） |
+| 文件 | 风格 | 适用 |
 |------|------|------|
-| `assets/themes/minimal-ink.json`（默认） | 黑白灰 + 砖红 | 观点 / 深度分析 / 随笔 |
-| `assets/themes/tech-blue.json` | 科技蓝 | 教程 / 实操 / 工具测评 |
-| `assets/themes/newsprint.json` | 报纸衬线 | 复盘 / 特稿 / 行业观察 / 长文 |
-| `assets/themes/graphite.json` | 石墨克制 | 技术说明 / 专业评论 / 方法 / 原理 |
-| `assets/themes/amber-review.json` | 琥珀评测 | 评测 / 模型评测 / 数据对比 / 榜单 / 速览 |
+| `assets/themes/minimal-ink.json`（默认） | 黑白灰 + 砖红 | 深度研析 / 观点 / 随笔 |
+| `assets/themes/tech-blue.json` | 科技蓝 | AI/技术 |
+| `assets/themes/newsprint.json` | 报纸衬线 | 人文评论 |
+| `assets/themes/graphite.json` | 石墨克制 | 严肃报告 |
+| `assets/themes/amber-review.json` | 琥珀评测 | 产品评测 |
 
-`md2wechat.py --list-themes` 看全部；`--theme genre:评测` 可按题材自动选。
-渲染规格见 `references/element-spec.md` · 主题映射见 `references/theme-map.md`。
+`md2wechat.py --list-themes` 看全部；`--theme genre:评测` 可按题材自动选。  
+渲染规格见 [`references/element-spec.md`](references/element-spec.md) · 主题映射见 [`references/theme-map.md`](references/theme-map.md)。
 
-**平台红线速查**（详见 `references/wechat-constraints.md`）：禁 `div`/`pre`/`h1`/`figure`/`thead`/flex/float/gradient/shadow；表格 `table-layout` 不写 fixed；列数 ≥4 转卡片。
+**平台红线速查**（详见 [`references/wechat-constraints.md`](references/wechat-constraints.md)）：禁 `div`/`pre`/`h1`/`figure`/`thead`/flex/float/gradient/shadow；表格 `table-layout` 不写 fixed；列数 ≥4 转卡片。
 
 ## 与 Desktop「公众号创作」
 
@@ -200,7 +221,7 @@ python3 scripts/md2wechat.py \
 ## 外部依赖
 
 以下技能**不在本仓库**（一般随用户侧 workbuddy 环境提供）；缺失时对应路由能力不可用，
-本仓库脚本功能不受影响：
+本仓库脚本（交付包、排版、发布清单等）功能不受影响：
 
 - `humanizer-zh`：中文去 AI 味的保真边界（「只去 AI 味不排版」路径用）。
 - `qu-aiwei-zh`：中文去 AI 味扫描定位；本仓库 `scan_ai_flavor.py` 与其同源，
@@ -213,3 +234,18 @@ python3 scripts/md2wechat.py \
 - 通用长文交付 → 不在本技能范围
 - 封面配图 → `topmind-cover`；X 长文 → `topmind-x-article`
 - 只去 AI 味不排版 → 中文走 `humanizer-zh`（先立保真边界）+ `qu-aiwei-zh`（再扫描定位）；英文走 `humanizer`
+
+## 实战沉淀（2026-10-01 九月全景项目）
+
+- **文字精炼原则**：月度盘点类文章，文字只给"看图能看清的简单结论或事实"，
+  不发散论述。删掉的典型："9 月没发生的那件事可能是最重要的"（评论腔）、
+  "是同一道题的两种解法"（比喻发散）。每段压到 1–2 句，只留时间、主体、数字、来源。
+- **第三方客观素材优先**：官方产品截图 > 官方基准图 > 第三方榜单截图 > 自制图表。
+  自制图只用于时间线、价格对比、总结盘点。9 月项目新增：OpenAI DevDay 官方
+  Codex 四图（CLI/Cloud/Code Review/Security）、DeepSeek Harness 官方图标+
+  第三方实测截图。
+- **模型信息核实**：Muse Spark、Step 5 Preview 等新模型，分数/价格必须回官方模型卡
+  或 Artificial Analysis 原页，不直接采用二手报告数字。榜单文字与榜单截图日期对齐
+  （如 AA 9/28 快照），分数不跨期比较。
+- **frontmatter 状态诚实**：`status: 定稿` 必须等事实/逻辑/文字三关全过才写，
+  构建流水线跑通不等于定稿；`word_count` 用脚本实算，不手填。

package/topmind-wechat-post/package.json

@@ -1,6 +1,6 @@
 {
   "name": "topmind-wechat-post",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": true,
   "description": "公众号文章全生命周期：交付包、审校改写、质量三关、状态同步、微信内联排版与发布清单。",
   "license": "MIT",

package/topmind-wechat-post/references/element-spec.md

@@ -124,9 +124,10 @@
 | `on` | 无条件追加 |
 | `off` | 只在显式写了 `::: sign` 时渲染 |
 
-- 署名用占位 `{{作者名}}`，**不替用户编造人名**；`--author` / `--author-bio` 可填
+- 署名区**不再渲染"自我介绍"行**（2026-10-01 用户要求去掉"我是{{作者名}}，{{一句话简介}}"）；
+  只保留三连 CTA。`--author` / `--author-bio` 参数保留仅为兼容旧调用，不再使用
 - 判定「已自带」的口径：正文末尾 8 个非空段落内出现
-  `点赞 / 在看 / 三连 / 点个关注 / 欢迎关注 / 关注「 / 扫码 / 分享给 / 我是…，`
+  `点赞 / 在看 / 三连 / 点个关注 / 欢迎关注 / 关注「 / 扫码 / 分享给`
 
 ---
 

package/topmind-wechat-post/scripts/md2wechat.py

@@ -1340,20 +1340,15 @@ def render_toc(titles, theme):
 
 
 def render_signature(theme, author="", bio=""):
-    """尾部签名区。默认用占位署名，交付时提示用户替换，不替用户编造人名。"""
-    name = esc(author.strip() or "{{作者名}}")
-    blurb = esc(bio.strip() or "{{一句话简介}}")
+    """尾部签名区。2026-10-01 起默认不再渲染"自我介绍"行（我是{{作者名}}，{{一句话简介}}）；
+    只保留三连 CTA。author/bio 参数保留仅为兼容旧调用，不再使用。"""
     return ('<section style="margin:34px 0 0;padding:16px 18px;background:%s;'
             'border-top:2px solid %s;border-radius:%s;">'
-            '<p style="margin:0 0 8px;font-size:14px;line-height:1.75;'
-            'color:%s;word-break:break-word;">我是 <span style="font-weight:600;'
-            'color:%s;">%s</span>，%s</p>'
             '<p style="margin:0;font-size:14px;line-height:1.75;color:%s;'
             'word-break:break-word;">如果你觉得今天这篇有收获，欢迎'
             '<span style="font-weight:600;color:%s;">点赞、在看、转发</span>'
             '三连，我们下篇见。</p></section>'
             % (theme["surface"], theme["accent"], theme["radius"],
-               theme["text"], theme["text_strong"], name, blurb,
                theme["text"], theme["accent"]))
 
 

package/topmind-x-article/README.en.md

@@ -4,7 +4,7 @@
 
 Turn a Markdown draft into a "copy → paste → publish" X long-form (Article) package.
 
-- Version: **v0.2.0** (same tag as `@topmindspace/tms-skills@0.5.0`)
+- Version: **v0.4.0** (same tag as `@topmindspace/tms-skills@0.7.0`)
 
 ## Install
 
@@ -17,7 +17,11 @@ npx @topmindspace/tms-skills install topmind-x-article
 ```bash
 # 1. Draft → one-click-copy HTML (preferred)
 python3 scripts/md2x-html.py <draft>.md --out <package>/X长文.html \
-  --images <img1> <img2> ... [--cover cover-1200x675.png]
+  --images-from 公众号稿.md [--cover cover-1500x600.png]
+# --images-from derives image order from the WeChat draft in document order
+# (required when the X draft is derived from it);
+# never hand-assemble --images (filename sort order != document order —
+# this once misplaced a whole section's images).
 # Open X长文.html in a browser → click the top 「一键复制全文」 button → paste into the X Article editor body
 # (the first # heading is excluded from the clipboard — fill it into X's title field by hand;
 #  upload the cover separately via X's dedicated cover entry)

package/topmind-x-article/README.md

@@ -4,7 +4,7 @@
 
 把 Markdown 原稿变成"复制 → 粘贴 → 发"的 X 长文（Article）发布包。
 
-- 版本：**v0.2.0**（与 `@topmindspace/tms-skills@0.5.0` 同 tag）
+- 版本：**v0.4.0**（与 `@topmindspace/tms-skills@0.7.0` 同 tag）
 
 ## 安装
 
@@ -17,7 +17,9 @@ npx @topmindspace/tms-skills install topmind-x-article
 ```bash
 # 1. 原稿转一键复制 HTML（首选）
 python3 scripts/md2x-html.py <原稿>.md --out <包>/X长文.html \
-  --images <图1> <图2> ... [--cover cover-1200x675.png]
+  --images-from 公众号稿.md [--cover cover-1500x600.png]
+# --images-from 从公众号稿按文档顺序派生图片（X 稿由公众号稿派生时必用）；
+# 禁止手工拼 --images 列表（文件名排序 ≠ 文档顺序，曾导致整段配图错位）。
 # 浏览器打开 X长文.html → 点页顶「一键复制全文」→ 粘贴进 X Article 编辑器正文
 # （首个 # 标题不进剪贴板，手动填入 X 标题栏；封面在 X 独立入口单独上传）
 

package/topmind-x-article/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-x-article
-version: 0.2.0
+version: 0.4.0
 description: "X 长文（Article）一键发布：Markdown 原稿 → 可直接复制的 X长文.html（富文本一键复制+配图内嵌）/ X发布稿.txt + 封面图 + 发布清单。沉淀自实战。Use when X 长文、发 X 文章、X article、长文发 X。Do NOT use for 短推文（→ topmind-x）、公众号（→ topmind-wechat-post）。"
 action_category: write
 triggers:
@@ -33,19 +33,33 @@ updated: 2026-09-29
 原稿.md → md2x.py     → X发布稿.txt（纯文本兜底）
 ```
 
+## 语言铁律
+
+- **默认中文**：标题、正文、配图文案一律用中文写作，这是默认行为，不需要用户每次声明。
+- **英文是例外**：只有用户**明确说**"写英文文章/帖子"时才用英文。用户消息里夹杂英文词、
+  给英文参考素材、引用英文原文，都不算"要求写英文"。
+- 引用英文一手素材（官方公告、模型卡、论文标题）时保留英文原文，正文主体仍是中文，
+  必要时在旁给中文翻译。
+
 ## 工作流
 
 1. **转 HTML**（一键复制的核心，首选）：
    ```bash
    python3 scripts/md2x-html.py <原稿>.md --out <包>/X长文.html \
-     --images <图1> <图2> ... [--cover cover-1200x675.png]
+     --images-from 公众号稿.md [--cover cover-1500x600.png]
    ```
+   `--images-from` 从公众号稿按文档顺序派生图片（X 稿永远由公众号稿派生时必用）。
+   **禁止手工拼 `--images` 列表**：文件名数字顺序 ≠ 文档顺序
+   （如 `14-kling` 与 `15-china-models` 按名排序会错位），手工传参曾导致整段配图错乱。
+   只有无公众号稿可派生的纯 X 原创稿，才允许用 `--images <图1> <图2> ...`，
+   此时必须逐张核对文件名与 `[图N]` 的对应关系。
    单文件 HTML：内联样式 + 配图 base64 内嵌。浏览器打开后点页顶
    「一键复制全文」，富文本（含格式）进剪贴板，去 X 文章编辑器粘贴。
    转换规则见 `references/x-html-format.md`。
    - `#` 首个标题**不进剪贴板**：手动填入 X 标题栏（工具栏有三步话术提示）。
    - 每张配图自动编号 `[图N]`；图片 data-URI 内嵌，能随粘贴带入编辑器最好，
      带不进去时用图下「下载图片」按钮按编号下载再上传——不用找文件、不用对顺序。
+     点击图片弹出 lightbox 放大看原图（右键可另存/截图，不拦截右键菜单）。
    - 每个 ``` 提示词块渲染为引用块（X 可识别）+ 右上角「复制提示词」按钮，
      一键复制该块纯文本。**复制分双通道**：作者侧用 HTML 里的按钮（发布前取用文本）；
      读者侧一键复制只能来自 X 原生代码块，需在编辑器里 Insert → Code 手动逐块转换
@@ -57,7 +71,7 @@ updated: 2026-09-29
    规则见 `references/x-format.md`。HTML 复制异常时的备用入口。
    转完**通读一遍**：X 不渲染 markdown，标记剥离后断句、emphasis 全靠文字本身，
    读不顺就回原稿改。
-3. **封面图**：调 `topmind-cover`，平台选 `x`，得 1200×675 主图。
+3. **封面图**：调 `topmind-cover`，平台选 `x`，得 1500×600 主图。
 4. **发布清单**：按 `references/publish-checklist.md` 逐项过。
 5. **发布**：用户在 X Article 编辑器粘贴全文、上传封面与配图（按 `[图N]` 编号），
    人工点发布。**API 不发长文**（topmind-x 的 xurl 只覆盖短推文）。
@@ -70,12 +84,19 @@ updated: 2026-09-29
 ├── 原稿.md            # 输入（或复用既有原稿）
 ├── X长文.html         # 首选复制入口：浏览器打开，一键复制全文
 ├── X发布稿.txt        # 纯文本兜底入口
-├── cover-1200x675.png # 封面（topmind-cover 产出，X 编辑器单独上传）
+├── cover-1500x600.png # 封面（topmind-cover 产出，X 编辑器单独上传）
 └── 发布清单.md        # 本次发布 checklist（含时间、链接）
 ```
 
 ## 实战沉淀
 
+- **事实铁律**：承重事实（数字、排名、发布日期、融资额）逐条回一手来源
+  （官方公告/模型卡/论文/财报）；厂商给的数字标"厂商口径"或"官方口径"；
+  媒体转引标"据 XX 报道"；查不到一手来源的传闻删；推测必须显式标"（推测）"，
+  与事实段落切割，不混写。改稿续写时正文已有数字回源重核（上一轮文本最不可信）。
+- **文字铁律**：去 AI 味、精炼、不编造；看图即得的简单事实不再展开复述；
+  多用第三方客观素材，观点可以撞、表达必须原创。
+- **交付铁律**：发布/分享时直接用交付的 HTML 原文件原样呈现，不临时重新生成版本。
 - 补充信息（邀请码、链接、勘误）**不挤正文**，发在发布后首条评论并置顶
 - 标题 ≤140 字符，首段 3 行内出钩子；配图逐张按 `[图N]` 顺序上传，传完对照清单点一遍
 - 事实修正只改发布包，不回头改已发原文（除非勘误）
@@ -99,3 +120,37 @@ updated: 2026-09-29
 
 - `topmind-x`：280 字短推文发布（xurl 只覆盖短推文，不发长文）。
 - `topmind-capture`：「只想存档不发布」时的收录路由。
+
+## 实战沉淀（2026-10-01 九月全景项目）
+
+- **HTML 占位符映射铁律**：`md2x-html.py --cover` 注入封面到 `__COVER__`，正文图按序注入
+  `__IMG_01__`–`__IMG_N__`。曾出现错位 bug（封面位置注入 `__IMG_01__`、正文图整体后移、
+  最后一张图跑到 `__COVER__`），原因是占位符替换顺序错误。修复后验收标准：
+  第一张 base64 图解码为 1500×600（封面尺寸），无占位符残留。
+- **X发布稿.txt 图序**：由 `md2x.py` 从 X长文.md 生成，`[图N]` 编号与 HTML 正文图顺序一致，
+  封面不占编号（X 编辑器单独上传封面）。
+
+## 实战沉淀（2026-10-01 九月全景·配图错位修复）
+
+- **错位症状 A**：Grok 4.7 配图落在 Meta 段落之后；"国产模型一览"落在手机段落之后。
+  原因：改稿时只动文字不动图，图片 markdown 行被"落下"到下一段。
+- **铁律**：图片必须紧跟它证明的那段文字（最多隔一段）；改稿移动段落时，图片行一起搬。
+- **错位症状 B（根本原因）**：旧版 X 构建从"六、工具与 Agent"起配图全错
+  （Codex 段配 OpenRouter 图、Harness 段配 AA 榜单图……）。
+  原因：`X长文.md` 里只有裸 `[图N]` 标记，图片靠 `--images` 命令行手工传参；
+  构建时按 `images/*` 文件名排序传入，而文件名数字顺序 ≠ 文档顺序
+  （`14-kling`/`15-china-models` 建图顺序与文档顺序相反；`21-codex`/`22-harness`
+  是后加的，排在 `16-openrouter` 之后）。从图 14 起全部错位一格，
+  图 14/15 互换不易察觉，到图 16（Codex 段）才明显暴露。
+- **根治**：`md2x-html.py` 新增 `--images-from 公众号稿.md`，
+  从公众号稿的 `![]()` 按文档顺序自动派生图片，**不再允许手工排序**；
+  脚本内置校验：`[图N]` 必须连续编号且数量 = 图片数，否则直接报错退出
+  （不静默生成错版）。
+- **构建后必跑三项校验**（缺一不可）：
+  1. 脚本自校验通过（数量/连续性）。
+  2. 嵌入图顺序校验：逐张解码 base64，与源文件按文档顺序比对（像素或字节一致即过）。
+  3. 图文邻近校验：每张图前后各取 6 行，检查是否出现该图主题关键词
+     （如 Grok 图邻近必须有"Grok"）；章节题图（节首图）只查节标题相关性。
+- **派生纪律**：`X长文.md` 永远由 `公众号稿.md` 重新派生（脚本重排 `[图N]`），
+  不手工改编号；派生后 `X发布稿.txt` 同步重生成。
+  `公众号稿.md` 是唯一真源：改图先改公众号稿，再重派生 X 稿，两边永不独立改图。

package/topmind-x-article/package.json

@@ -1,6 +1,6 @@
 {
   "name": "topmind-x-article",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "private": true,
   "description": "X 长文（Article）一键发布：Markdown 原稿转可直接粘贴的纯文本 + 封面图 + 发布清单。",
   "license": "MIT",

package/topmind-x-article/references/publish-checklist.md

@@ -9,7 +9,7 @@
 - [ ] `X发布稿.txt` 通读一遍：断句顺、无 markdown 残留标记（HTML 复制异常时的兜底）
 - [ ] 标题 ≤140 字符；首段 3 行内出钩子
 - [ ] 承重数字与原稿一致（转格式不改数字）
-- [ ] 封面图 1200×675 已备好，标题字无错别字
+- [ ] 封面图 1500×600 已备好，标题字无错别字
 - [ ] 配图按 `[图N]` 顺序排好，清单与文件一一对应
 - [ ] 话题标签想好（放文末，不超过 3 个）
 - [ ] 提示词密集型文章：规划好哪些提示词块要在 X 里转原生代码块

package/topmind-x-article/references/x-html-format.md

@@ -48,11 +48,23 @@
 
 ## 图片约定
 
-- `--images` 按顺序对应 `[图1]`、`[图2]`…；`--cover` 只做页顶预览 + 下载，**不占 `[图N]` 编号**
+- 图片来源：有公众号稿可派生时一律用 `--images-from 公众号稿.md`，
+  从源 md 的 `![]()` 按文档顺序自动取图；**禁止手工拼 `--images` 顺序**
+  （文件名数字排序 ≠ 文档顺序，2026-10-01 九月全景曾因此从第六节起整段错位）。
+  无源可派生的纯 X 原创稿才允许 `--images` 手工传参，且须逐张核对。
+  脚本内置校验：`[图N]` 须连续编号且数量 = 图片数，否则报错退出。
+- `--cover` 只做页顶预览 + 下载，**不占 `[图N]` 编号**
 - 配图建议先压缩到宽 900px 左右的 JPEG（单张 <100KB），11 张图总 HTML 约 800KB，
   直接双击打开不卡
 - 下载按钮用 JS 取同图 `src` 触发下载，data-URI 在 HTML 里只存一份（体积减半）
 
+## 点击放大（lightbox）
+
+- 正文每张配图、封面预览图均可点击，弹出全屏 lightbox 放大查看原图
+- lightbox 内提供「新标签页打开原图」（Blob URL，绕开浏览器对 data: URL 顶层导航的限制）、
+  「下载原图」按钮；**刻意不拦截右键菜单**，放大后可右键图片另存，或直接截图
+- lightbox 位于 `#article` 之外，「一键复制全文」不会把它带入剪贴板
+
 ## 复制行为
 
 - 「一键复制全文」：`ClipboardItem` 同时写 `text/html` + `text/plain`，