@topmindspace/tms-skills 0.3.1 → 0.3.5

package/CHANGELOG.md

@@ -1,3 +1,162 @@
+## [0.3.5] - 2026-09-29
+
+> **本版备发中**（未 push、未打 tag、npm 无此版本）。
+> 根包 0.3.4 → **0.3.5**（patch）；4 个技能 `version` 保持不动（top-ppt-html 0.1.19，其余 0.1.0）。
+> 注：0.3.2、0.3.3、0.3.4 均未发布，全部内容已并入本版。
+
+### 性能实测与优化（第七轮 Worker 4）
+
+- **实测基线**（中等规模真实输入）：`md2x.py` 300KB/8814 行 0.33s；`md2wechat.py` 218KB/3219 行/
+  80 图 0.42s（`--embed-images` 0.47s）；`crop-cover.py` 4000×2250 主图 1.79s；
+  安装器 `install`/`list` 均 <0.5s（含 7.9MB 的 top-ppt-html）。
+- **修 5 处 low-hanging fruit**（输出逐字节一致，已 diff 验证，无行为改动）：
+  - `md2wechat.py audit_inline()`：8 次全正文 `re.search` 合并为一次预编译单遍扫描
+    （原为大正文耗时的 ~47%，cProfile 实测）；
+  - `md2wechat.py render_inline()`：10 个行内模式预编译到模块级
+    （原每行 10 次 `re` 字符串模式缓存查找，666k 行调用时 667 万次）；
+  - `md2wechat.py highlight()`：语言联合正则按语言缓存（原每代码块重编译一次）；
+  - `md2wechat.py link_repl()`：脚注 url→序号改字典索引（原每链接两次全表扫描，O(n²)→O(n)）；
+  - `md2x.py _inline()`：同理预编译全部行内模式。
+- **实测提升**（交错对比，user CPU 时间）：md2wechat 11MB 输入 13.8s → 10.0s（-27%）；
+  md2x 49MB 输入 62.5s → 42.2s（-32%）；300KB 输入 md2x 0.33s → 0.29s。
+  crop-cover（PIL 解码/resize 主导）与安装器（node 启动 + 文件拷贝主导）无冗余工作，未改动。
+
+### 可靠性矩阵（第七轮 Worker 4：三个技能 + 安装器）
+
+- **修 2 个明确 bug**：
+  - `md2x.py` / `md2wechat.py` 非法 UTF-8 输入原抛 `UnicodeDecodeError` Traceback，
+    现干净报错（非零退出、无 Traceback）；读取期 `OSError`（如权限不足）同理。
+  - `md2wechat.py` 交付物写入改原子写（临时文件 + `os.replace`）：磁盘满等中途失败时
+    不再留下半截 HTML/清单（实测大文件写盘失败曾留下截断 HTML）。
+- 矩阵其余项全部干净（非零退出、无 Traceback、无半截输出）：空文件、49MB 超大文件、
+  特殊字符文件名（空格/引号/中文）、图片缺失（含 `--embed-images` 的"未内嵌"提示）、
+  非图片/0 字节/缺失输入、缺 Pillow 干净提示、非法 skill id、装进技能源目录树被拒、
+  未知命令/缺参数。
+- 安装器经确认零网络调用（纯 `fs`/`path`），本地安装天然离线可用；断网仅影响
+  `npx github:` 拉取，属 npm 侧报错，非本仓库代码路径。
+
+### 发版准备 0.3.5
+
+- 根 `package.json` 0.3.4 → **0.3.5**；9 处版本引用同步（根 README 中英钉版本示例、
+  `docs/PUBLISHING.md` 当前线与版本策略、6 份技能 README 的"同 tag"行）；4 技能各自
+  `version` 不动。
+- 待办：`top-ppt-html/README{,.en}.md` 的 3 处 `@0.3.4` 引用由其审核 worker 同步
+  （本轮未动 `top-ppt-html/` 目录）。
+
+### 全门禁（第七轮 Worker 4，改完后跑）
+
+- `ci_privacy_scan.py` PASS（200 文件）；`sync_npm_files.js --check` PASS；
+  `ci_skill_gates.sh --with-pptx` 全绿；4 技能 `negative_tests.py` 全部通过；
+  `run_skill_gates.js versions` PASS；`test_install_guards.js` 全部通过。
+
+## [0.3.4] - 2026-09-29
+
+> **本版备发中**（未 push、未打 tag、npm 无此版本）。
+> 根包 0.3.3 → **0.3.4**（patch）；4 个技能 `version` 保持不动（top-ppt-html 0.1.19，其余 0.1.0）。
+> 注：0.3.2、0.3.3 均未发布，全部内容已并入本版。
+
+### top-ppt-html：全面审查 + 必要优化（第六轮）
+
+- **渲染管线实跑**：虚构测试稿走完 render → hydrate_charts → data URI 内联 → validate --strict
+  （95 PASS / 0 WARN / 0 FAIL）；故意注入 3 类缺陷（超大图片、布局溢出、空 alt）全部被抓；
+  PPTX 11 slides 实跑，16:9、微软雅黑、中文原生文本、原生图表，strict 0 error / 0 warning；
+  ELEMENT_OVERLAP / LAYOUT_FILL 门禁经真实 PPTX 注入验证有效。
+- **build_pptx.js 修 6 处**：KPI 竖分隔线越过注释带、KPI/donut/image 页 `sec.points` 被丢弃、
+  image 页图片底边越过注释带、cards 要点无脑 shrink 被 TEXT_OVERFLOW 抓、
+  points 纯字符串/`{t,d}` 形态渲染为空或 `[object Object]`。
+- **hydrate_charts.py**：空 labels/values、非数字 values、长度不一致原抛 Traceback，
+  现干净报错（`ChartDataError`，带 section 定位），禁静默截断。
+- **validate_report.py 修 2 处**：`alt=""` 视同缺失；图片体积按 data URI **解码后字节数**计量
+  （原按标签字符串长度，属 bug；级别保持 WARN，strict 已拦截）。
+- **SKILL.md/文档**：修 `（=?）` 编辑残留；README（中英）补 3 分钟最小示例；
+  修 13 处死引用（错乱脚本路径、`docs/archive/…` 改 `../docs/archive/…` 等）；
+  9 风格抽 3 套（品牌红/靛紫/光谱彩色）实跑渲染全部成功。
+- 零用户可见行为改动。遗留候选：render_from_model 不同步 style/theme（需产品决策）、
+  超长中文图表标签不截断、图片超限 WARN 不升级 FAIL、代码块页型缺失。
+
+### 全仓横扫（第六轮）
+
+- **修真 bug**：第五轮重写 `topmind-cover/references/cover-styles.md` 时把截断输出写进文件
+  （ip-fun 尾部丢失、news-flash/minimal/magazine 三节整节丢失），已按审计文档+样张实物补齐。
+- **docs/PUBLISHING.md**：补 HTTPS+PAT 推送方式（SSH 隧道被代理墙掐断后的实际走法；
+  GitHub git 接口不认 Bearer 只认 Basic）、tag↔package.json 校验、NPM_TOKEN/E409 加固的文档记载。
+- 三个新技能 README（中英）补版本号行；根 README.en 示例图体积与实测对齐（~8.9MB）。
+- 四技能 description 触发边界复核：互不重叠、无真空（"X 长文封面"良性重叠已写清委托关系）。
+- 隐私扫描 PASS（199 文件）；安装器四技能回归全过。
+
+## [0.3.3] - 2026-09-29
+
+> **本版未发布**（备发中：未 push、未打 tag、npm 无此版本）。
+> 根包 0.3.2 → **0.3.3**（patch）；4 个技能 `version` 保持不动（top-ppt-html 0.1.19，其余 0.1.0）。
+> 注：0.3.2 未发布，已并入本版。
+
+### topmind-cover：6 张样张版式级重设计（差异化纠偏）
+
+- 用户指出第四轮样张仍是"翻版"（版式结构照搬 7 张参考封面，只换文案形象）。
+  本轮按**版式级标准**重做：只保留抽象原则（标题是视觉重心/信息分层/留白呼吸感），
+  6 张重设计（gan-huo 居中构图+深炭灰暖橙、big-type 单行超大书法字+奶油亮底、
+  brand-launch 深海军蓝+荧光绿、tutorial-steps 横向时间线+墨色题字、
+  ip-fun 数字改右下角印章+橙黄暖色、news-flash 纯黑单色+纸纹+俯视静物大改），
+  2 张保留微调（minimal「慢思考」、magazine「创造者访谈」）。
+- 8 张主配色互不相同，且不与 7 张参考图主配色（浅蓝/黑红/粉紫/红白/蓝白）撞车；
+  每张过双重目检（中文正确性 + 路人测试：描述画面后追问"像哪张参考图"，答不出才算过）。
+- `references/cover-styles.md`：设计语言收紧为抽象原则，删除"左文右图""底部标签条"等
+  具体版式描述；**原创铁律升级**：版式与配色也不得与第三方封面构成实质相似，
+  只学原则不学版式。
+
+### topmind-wechat-post / topmind-x-article：第二轮深审（质量）
+
+- wechat-post：修 5 处文档与实现/规范打架（`---` 渲染文档落后于实现、主题表 genre 漏项、
+  最小示例缺放图前置步骤、`--link-mode note` 档无文档、加粗密度两份规范打架按 lint 对齐）；
+  零行为改动。遗留 3 个需改行为候选：缺图是否进合规自检、border-radius WARN 去噪、
+  h2 序号剥离残留标点。
+- x-article：文档×脚本 14/14 规则实测一致；补 x-format.md 4 处"脚本有行为、文档没写"缺口；
+  SKILL.md 触发词补 `X 发长文`/`推特长文`/`twitter 长文`；README.en 表格标点精确化；
+  零行为改动。遗留 4 个行为变化候选：无前导 `|` 表格、`~~~` 围栏、标题 140 字符检查
+  （超长分段经评估不需要）。
+
+## [0.3.2] - 2026-09-29
+
+> **本版未发布**（未打 tag、未发 npm），全部内容已并入 0.3.3。以下为当时记录：
+
+> 根包 0.3.1 → **0.3.2**（patch）；4 个技能 `version` 保持不动（top-ppt-html 0.1.19，其余 0.1.0）。
+> 整仓同 tag 发版，技能 `version` 独立演进（见 docs/PUBLISHING.md）。
+
+### topmind-cover：样张原创重制（纠偏）
+
+- 上一版 16 张样张被指出"照搬参考封面"（文案与形象临摹第三方爆款图），本轮推倒重做：
+  设计语言保留（巨型标题字/数字彩色突出/三层文字结构/中央 60% 安全区），
+  **8 种风格全部换上原创标题与视觉**："7天玩转提示词"（纸飞机机器人）、"AI效率手册"
+  （抽象光影几何）、"星尘 OS 3.0"（虚构品牌发布）、"从想法到产品"（步骤卡片）、
+  "30天AI绘画挑战"（狐狸画家 IP）、"AI早报！"（报纸咖啡）、"慢思考"（银杏留白）、
+  "创造者访谈"（杂志肖像）。
+- `assets/examples/` 16 张（8 主图 + 8 公众号裁剪版）+ `overview.png` 全部重拼重检：
+  中文逐字正确、无乱码、与参考图不构成临摹；`README.md` 声明样张为原创设计、
+  标题/数字/品牌均为虚构演示。
+- `references/cover-styles.md` 新增**原创铁律**：prompt 配方是设计语言，
+  禁止照抄任何第三方封面的文案与形象；8 风格示例小节同步换为本轮原创标题。
+
+### topmind-wechat-post：全面优化 + 4 处修复
+
+- `scripts/md2wechat.py` 修复：**行内图片绕过图片管线**（现统一经管线解析、复制到
+  `images/`、登记上传清单、可被 `--embed-images` 内嵌）；分隔线不再触发自家合规
+  WARN（改用块级 `<section>` 居中，视觉一致）；标题手写序号剥离支持大写数字
+  （壹贰叁肆伍陆柒捌玖拾）；图片 `title` 属性（`![a](x "t")`）不再导致整段源码泄漏。
+- SKILL.md：主题表"适用"列与各主题 JSON 的 `genre` 声明对齐；补行内图片走图片管线
+  说明；补 `--link-mode` 参数说明（默认脚注上标 / `inline` 括号注）。
+- README（中/英）：新增 9 行"最小示例"（输入→输出片段）+ `md2wechat` 参数表。
+- `negative_tests.py` 5→8 项，全过。
+
+### topmind-x-article：全面优化 + 12 处转换 bug 修复
+
+- `scripts/md2x.py` 修复 12 处：标题/引用/表格内行内标记残留、引用式链接与图片
+  （`[文字][ref]`/`![alt][img]` 及定义行）、URL 含括号断裂、`\` 转义符残留、
+  Setext 标题残留、带空格分割线（`* * *`）不识别、代码块内 `---` 误判分割线、
+  文首 `---` 被 frontmatter 误吞、BOM 头、文档以代码块开头时首行缩进丢失。
+- SKILL.md：description 补 `Do NOT use for 公众号（→ topmind-wechat-post）`，与短推文
+  路由对称；`references/x-format.md` 转换规则表与脚本行为对齐。
+- README（中/英）：转换规则更新 + 新增 10 行"最小示例"（输出经实测逐字一致）。
+
 ## [0.3.1] - 2026-09-29
 
 > 根包 0.3.0 → **0.3.1**（patch）；4 个技能 `version` 保持不动（top-ppt-html 0.1.19，其余 0.1.0）。

package/README.en.md

@@ -19,6 +19,8 @@ Built for **demo reports / formal business decks**: **HTML + PPT dual delivery**
 npx @topmindspace/tms-skills install top-ppt-html
 ```
 
+Live: [landing](https://topmindspace.github.io/tms-skills/) · [full deck](https://topmindspace.github.io/tms-skills/showcase.html) · [style gallery](https://topmindspace.github.io/tms-skills/style-gallery.html); golden examples in [`top-ppt-html/assets/examples/`](./top-ppt-html/assets/examples/).
+
 ### topmind-wechat-post · WeChat article authoring
 
 Full lifecycle for WeChat articles: delivery package, review & rewrite, three quality gates (facts / logic / de-AI-flavor), WeChat inline typography (images must be embedded), publish checklist and status sync. Python stdlib only — zero dependencies.
@@ -37,29 +39,16 @@ npx @topmindspace/tms-skills install topmind-x-article
 
 ### topmind-cover · Cover art generation
 
-Shared cover art for X long-form and WeChat: striking, eye-catching, theme-focused. Built-in **8-style cover style library** (viral dry-goods / giant-type manifesto / brand launch / tutorial steps / fun IP / news flash / minimalist / editorial magazine — each with use cases, hex palettes, font suggestions, Chinese+English prompt recipes) + **17 dual-size example images** (`assets/examples/`, shipped with the package): **pick a style → check the example → compose the prompt from the recipe**, then one-click crop to both platform sizes with `crop-cover.py` (X 1200×675, WeChat 900×383).
+Shared cover art for X long-form and WeChat: striking, eye-catching, theme-focused. **Pick a style → check the example → compose the prompt from the recipe**, then one-click crop to both platform sizes with `crop-cover.py` (X 1200×675, WeChat 900×383). 8-style index and recipes: [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md).
 
 ```bash
 npx @topmindspace/tms-skills install topmind-cover
 ```
 
-**Style gallery** (8-style overview; full-size per-style shots in `topmind-cover/assets/examples/<style>.png`, recipes in [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md)):
-
 <p align="center">
   <img src="https://github.com/topmindspace/tms-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 8 cover-style overview" width="960" />
 </p>
 
-| Style | Best for |
-|-------|----------|
-| Viral dry-goods `gan-huo` | Tested picks, reviews, roundups; default for first-person "I tried it all for you" posts |
-| Giant-type manifesto `big-type` | Opinion pieces, deep essays, launch manifestos; default for one-sentence-stance pieces |
-| Brand launch `brand-launch` | Product launches, version updates, official best practices / whitepapers; first choice when a brand is the subject |
-| Tutorial steps `tutorial-steps` | Tutorials, onboarding guides, step-by-step walkthroughs, beginner-proof recipes |
-| Fun IP `ip-fun` | Case studies, data recaps, retrospectives, series (part 1 / part 2) |
-| News flash `news-flash` | News, flashes, hot-topic explainers, interview teasers, "myth-busting" angles |
-| Minimal `minimal` | Essays, book reviews, light takes, lifestyle musings; WeChat "light reading" pieces |
-| Editorial magazine `magazine` | In-depth interviews, profiles, business analysis, year-in-review; when "craft / trust" matters |
-
 > Let ideas fly — make good thinking visible.
 
 <p align="center">
@@ -68,49 +57,6 @@ npx @topmindspace/tms-skills install topmind-cover
 
 > **Warning**: do not install `@topmindspace/tms-skills@^2` (2.0.0–2.1.1 deprecated). Current line is **0.2.x** (`latest`).
 
-## Craft at a glance
-
-### Theme overview (Gate 0)
-
-<p align="center">
-  <img src="top-ppt-html/assets/theme-overview.png" alt="Presentation mode · business-blue theme overview" width="900" /><br/>
-  <sub>Presentation · business-blue (default) · also <a href="./top-ppt-html/assets/style-gallery.html">style-gallery</a> · <a href="./top-ppt-html/assets/theme-overview-research.png">research overview</a> · <a href="./top-ppt-html/assets/theme-overview-architecture.png">architecture overview</a></sub>
-</p>
-
-### Style covers
-
-| Presentation · business-blue | Research · mckinsey | Architecture · graphite-dark |
-|:---:|:---:|:---:|
-| ![bizblue](docs/showcase/presentation-business-blue/bizblue-cover.png) | ![mckinsey](docs/showcase/research-mckinsey/mckinsey-cover.png) | ![graphite](docs/showcase/architecture-graphite-dark/graphite-cover.png) |
-
-### Product showcase (Mode A · dual-delivery narrative · multi-chart · header toolbar)
-
-| Positioning | Dual delivery | Charts | Header toolbar |
-|:---:|:---:|:---:|:---:|
-| ![pos](docs/showcase/topmind-showcase/showcase-s1.png) | ![split](docs/showcase/topmind-showcase/showcase-s3.png) | ![charts](docs/showcase/topmind-showcase/showcase-s5.png) | ![toolbar](docs/showcase/topmind-showcase/showcase-s11.png) |
-
-**Live**
-
-- Landing: [topmindspace.github.io/tms-skills/](https://topmindspace.github.io/tms-skills/)
-- Full deck: [showcase.html](https://topmindspace.github.io/tms-skills/showcase.html)
-- Style gallery: [style-gallery.html](https://topmindspace.github.io/tms-skills/style-gallery.html)
-- In-repo gallery: [top-ppt-html/assets/style-gallery.html](./top-ppt-html/assets/style-gallery.html)
-- Showcase HTML: [top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html](./top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html)
-- More shots: [docs/showcase/](./docs/showcase/)
-
-### HTML header toolbar (ready when you open the file)
-
-| Control | Shortcut | Behavior |
-|---------|----------|----------|
-| Theme toggle | **T** | Light / dark; per-file memory; syncs `REPORT_MODEL.theme` |
-| Style picker | 9 styles | Live visual skins; write back `REPORT_MODEL.style` before deliver |
-| PPTX preview | **P** | WYSIWYG page sequence + copyable agent prompt |
-| Generation guide | **H** | Dual-channel + environment notes |
-| Fullscreen | **F** | Immersive present mode |
-| Collapse toolbar | **B** | Mini bar (brand + expand); remembers per file |
-
-See [top-ppt-html/README.md](./top-ppt-html/README.md#html-header-toolbar) and [SKILL.md](./top-ppt-html/SKILL.md).
-
 ## Skills
 
 | Skill | Version | What it does |
@@ -118,15 +64,9 @@ See [top-ppt-html/README.md](./top-ppt-html/README.md#html-header-toolbar) and [
 | [`top-ppt-html`](./top-ppt-html/) | **0.1.19** | Formal business decks: paginated HTML + editable 16:9 PPTX; dual delivery · MD3-inspired density; 3 modes × 9 styles; strict 0/0 |
 | [`topmind-wechat-post`](./topmind-wechat-post/) | **0.1.0** | WeChat article lifecycle: package, review, 3 quality gates, inline typography & publish checklist |
 | [`topmind-x-article`](./topmind-x-article/) | **0.1.0** | X long-form one-click publish: Markdown → paste-ready plain text + cover + checklist |
-| [`topmind-cover`](./topmind-cover/) | **0.1.0** | Cover art for X / WeChat: striking, theme-focused; 8-style cover style library + 17 dual-size example images, size specs + crop tooling |
+| [`topmind-cover`](./topmind-cover/) | **0.1.0** | Cover art for X / WeChat: striking, theme-focused; 8-style cover style library + 17 dual-size example images |
 
-Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) is **0.3.1** (whole-repo same-tag releases).
-
-### topmind-cover · Cover style library
-
-Style index and the 8-grid overview are in the topmind-cover skill intro above.
-
-**Three steps to a cover**: ① pick 1 of 8 styles by topic → ② check the matching example in [`topmind-cover/assets/examples/`](./topmind-cover/assets/examples/) → ③ compose the prompt from that style's recipe in [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md). 17 example images (8 styles × 1200×675 master + 900×383 WeChat center-crop + `overview.png` 8-grid overview, ~7.5MB) ship with the npm package; **safe-zone rule**: title text and key subject must stay inside the central vertical 60% safe zone.
+Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) is **0.3.5** (whole-repo same-tag releases).
 
 ## Install
 
@@ -136,7 +76,7 @@ Style index and the 8-grid overview are in the topmind-cover skill intro above.
 npx @topmindspace/tms-skills list
 npx @topmindspace/tms-skills install top-ppt-html
 npx @topmindspace/tms-skills install top-ppt-html --to ./.claude/skills
-npx @topmindspace/tms-skills@0.3.1 install top-ppt-html   # pin
+npx @topmindspace/tms-skills@0.3.5 install top-ppt-html   # pin
 ```
 
 ```bash
@@ -148,15 +88,6 @@ Default probe order: `./.agents` → `./.claude` → `./.cursor` → `./.codex`
 
 PPTX export needs `npm install` in the skill folder (pptxgenjs). HTML generation uses Python stdlib only.
 
-## Golden examples
-
-| Mode | File |
-|------|------|
-| A Presentation | [`2026-09-09-presentation-business-blue`](./top-ppt-html/assets/examples/2026-09-09-presentation-business-blue.html) |
-| B Research | [`2026-09-09-research-mckinsey`](./top-ppt-html/assets/examples/2026-09-09-research-mckinsey.html) |
-| C Architecture | [`2026-09-09-architecture-graphite-dark`](./top-ppt-html/assets/examples/2026-09-09-architecture-graphite-dark.html) |
-| Product showcase | [`2026-09-26-topmind-tms-skills-showcase`](./top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html) (dual-delivery narrative · 5 chart types · toolbar page) |
-
 ## Repo layout
 
 ```
@@ -178,7 +109,6 @@ tms-skills/
 
 ```bash
 npm run check && npm run audit && npm run privacy
-# PPTX smoke (incl. McKinsey): bash scripts/ci_skill_gates.sh --with-pptx
 ```
 
 See [docs/PUBLISHING.md](./docs/PUBLISHING.md) · [docs/ci.md](./docs/ci.md).

package/README.md

@@ -17,6 +17,8 @@
 npx @topmindspace/tms-skills install top-ppt-html
 ```
 
+在线体验：[落地页](https://topmindspace.github.io/tms-skills/) · [完整演示文稿](https://topmindspace.github.io/tms-skills/showcase.html) · [风格画廊](https://topmindspace.github.io/tms-skills/style-gallery.html)；黄金样张见 [`top-ppt-html/assets/examples/`](./top-ppt-html/assets/examples/)。
+
 ### topmind-wechat-post · 公众号创作
 
 公众号文章全生命周期：交付包、审校改写、质量三关（事实 / 逻辑 / 去 AI 味）、微信内联排版（图片必内嵌）、发布清单与状态同步。脚本纯 Python 标准库，零依赖。
@@ -35,29 +37,16 @@ npx @topmindspace/tms-skills install topmind-x-article
 
 ### topmind-cover · 封面配图生成
 
-X 长文与公众号共用的封面图：震撼、醒目、主题突出。内置 **8 种封面风格库**（爆款干货 / 巨字宣言 / 品牌发布 / 教程步骤 / IP 趣味 / 资讯快报 / 极简留白 / 杂志编辑，含适用场景、配色 hex、字体建议、中英 prompt 配方）+ **17 张双尺寸示例图**（`assets/examples/`，随包发布）：**选风格 → 看示例 → 按配方组 prompt** 三步出图，`crop-cover.py` 一键裁出双平台尺寸（X 1200×675、公众号 900×383）。
+X 长文与公众号共用的封面图：震撼、醒目、主题突出。**选风格 → 看示例 → 按配方组 prompt** 三步出图，`crop-cover.py` 一键裁出双平台尺寸（X 1200×675、公众号 900×383）。8 种风格索引与配方见 [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md)。
 
 ```bash
 npx @topmindspace/tms-skills install topmind-cover
 ```
 
-**封面风格样张**（8 宫格总览；单风格大图见 `topmind-cover/assets/examples/<风格>.png`，配方见 [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md)）：
-
 <p align="center">
   <img src="https://github.com/topmindspace/tms-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 8 封面风格总览" width="960" />
 </p>
 
-| 风格 | 适用场景 |
-|------|----------|
-| 爆款干货 `gan-huo` | 干货清单、评测、盘点、实测筛选；"我替你试完了/筛完了"类第一人称实测文默认选它 |
-| 巨字宣言 `big-type` | 观点评论、深度长文、产品/版本发布宣言；"一句话立场"类文章默认选它 |
-| 品牌发布 `brand-launch` | 产品发布、版本更新、官方最佳实践/白皮书；有明确品牌主体的内容首选 |
-| 教程步骤 `tutorial-steps` | 教程、上手指南、分步实操、保姆级攻略 |
-| IP 趣味 `ip-fun` | 实战案例、数据战报、复盘、系列连载（上/下篇） |
-| 资讯快报 `news-flash` | 资讯、快讯、热点解读、人物专访预告、"祛魅/揭秘"类选题 |
-| 极简留白 `minimal` | 随笔、书评、轻观点、生活感悟；公众号"轻阅读"类文章 |
-| 杂志编辑 `magazine` | 深度访谈、人物特写、商业分析、年度盘点；需要"质感/信任感"时用它 |
-
 > 让 idea 飞，好想法被看见。
 
 <p align="center">
@@ -66,49 +55,6 @@ npx @topmindspace/tms-skills install topmind-cover
 
 > **警告**：不要安装 `@topmindspace/tms-skills@^2`（2.0.0–2.1.1 已弃用）。当前线 **0.2.x**（`latest`）。
 
-## 一眼看到工艺
-
-### 主题总览（Gate 0）
-
-<p align="center">
-  <img src="top-ppt-html/assets/theme-overview.png" alt="演示模式 · business-blue 主题总览" width="900" /><br/>
-  <sub>演示 · business-blue（默认）· 另见 <a href="./top-ppt-html/assets/style-gallery.html">style-gallery</a> · <a href="./top-ppt-html/assets/theme-overview-research.png">研究总览</a> · <a href="./top-ppt-html/assets/theme-overview-architecture.png">架构总览</a></sub>
-</p>
-
-### 风格封面
-
-| 演示 · business-blue | 研究 · mckinsey | 架构 · graphite-dark |
-|:---:|:---:|:---:|
-| ![bizblue](docs/showcase/presentation-business-blue/bizblue-cover.png) | ![mckinsey](docs/showcase/research-mckinsey/mckinsey-cover.png) | ![graphite](docs/showcase/architecture-graphite-dark/graphite-cover.png) |
-
-### 产品 Showcase（Mode A · 双交付叙事 · 多图 · Header 工具栏）
-
-| 定位 | 双交付 | 图表 | Header 工具栏 |
-|:---:|:---:|:---:|:---:|
-| ![pos](docs/showcase/topmind-showcase/showcase-s1.png) | ![split](docs/showcase/topmind-showcase/showcase-s3.png) | ![charts](docs/showcase/topmind-showcase/showcase-s5.png) | ![toolbar](docs/showcase/topmind-showcase/showcase-s11.png) |
-
-**在线体验**
-
-- 落地页：[topmindspace.github.io/tms-skills/](https://topmindspace.github.io/tms-skills/)
-- 完整演示文稿：[showcase.html](https://topmindspace.github.io/tms-skills/showcase.html)
-- 风格画廊：[style-gallery.html](https://topmindspace.github.io/tms-skills/style-gallery.html)
-- 仓库内交互画廊：[top-ppt-html/assets/style-gallery.html](./top-ppt-html/assets/style-gallery.html)
-- 仓库内 Showcase：[top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html](./top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html)
-- 更多截图：[docs/showcase/](./docs/showcase/)
-
-### HTML Header 工具栏（打开即用）
-
-| 控件 | 快捷键 | 做什么 |
-|------|--------|--------|
-| 亮暗主题 | **T** | 浅/深切换，按文件记忆，同步 `REPORT_MODEL.theme` |
-| 风格选择 | 9 套 | 九风格实时换肤；交付前写回 `REPORT_MODEL.style` |
-| 预览 PPTX | **P** | 页序列预览 + 可复制精导提示词 |
-| PPT 生成指引 | **H** | 双通道与环境说明 |
-| 全屏 | **F** | 沉浸演示 |
-| 收起工具栏 | **B** | 折叠为迷你条 |
-
-详见 [top-ppt-html/README.md](./top-ppt-html/README.md#html-header-工具栏) · [SKILL.md 交付物](./top-ppt-html/SKILL.md)。
-
 ## 技能一览
 
 | 技能 | 版本 | 做什么 |
@@ -116,15 +62,11 @@ npx @topmindspace/tms-skills install topmind-cover
 | [`top-ppt-html`](./top-ppt-html/) | **0.1.19** | 正式商务演示：HTML 可翻页 + 16:9 可编辑 PPTX；双交付 · MD3 密度克制；三模式 × 九风格；strict 0/0 |
 | [`topmind-wechat-post`](./topmind-wechat-post/) | **0.1.0** | 公众号文章全生命周期：交付包、审校改写、质量三关、微信内联排版与发布清单 |
 | [`topmind-x-article`](./topmind-x-article/) | **0.1.0** | X 长文一键发布：Markdown 原稿转可直接粘贴的纯文本 + 封面图 + 发布清单 |
-| [`topmind-cover`](./topmind-cover/) | **0.1.0** | 文章封面配图（X / 公众号共用）：震撼醒目主题突出；8 风格封面风格库 + 17 张双尺寸示例图，尺寸规范 + 裁剪落盘 |
-
-安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 为 **0.3.1**（整仓同 tag 发版）。
-
-### topmind-cover · 封面风格库
+| [`topmind-cover`](./topmind-cover/) | **0.1.0** | 文章封面配图（X / 公众号共用）：震撼醒目主题突出；8 风格封面风格库 + 17 张双尺寸示例图 |
 
-风格索引与 8 宫格总览样张见上文 topmind-cover 技能介绍处。
+安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 为 **0.3.5**（整仓同 tag 发版）。
 
-**三步出图**：① 按题材从 8 风格选 1 → ② 看 [`topmind-cover/assets/examples/`](./topmind-cover/assets/examples/) 对应示例图 → ③ 按 [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md) 该风格的 prompt 配方组 prompt。17 张示例图（8 风格 × 1200×675 主图 + 900×383 公众号中央裁剪版 + `overview.png` 8 宫格总览，约 7.5MB）随 npm 包发布；**安全区铁律**：标题字与关键主体必须落在画面中央垂直 60% 安全区内。
+> SKILL.md frontmatter 除标准 `name`/`description` 外，本仓库扩展了 `action_category` / `triggers` / `triggers_cn` / `updated` 字段供安装器与路由使用。
 
 ## 安装
 
@@ -134,7 +76,7 @@ npx @topmindspace/tms-skills install topmind-cover
 npx @topmindspace/tms-skills list
 npx @topmindspace/tms-skills install top-ppt-html
 npx @topmindspace/tms-skills install top-ppt-html --to ./.claude/skills
-npx @topmindspace/tms-skills@0.3.1 install top-ppt-html   # 钉版本
+npx @topmindspace/tms-skills@0.3.5 install top-ppt-html   # 钉版本
 ```
 
 ```bash
@@ -146,15 +88,6 @@ npx github:topmindspace/tms-skills install top-ppt-html
 
 PPTX 精导需在技能目录 `npm install`（pptxgenjs）。HTML 生成仅 Python 标准库。
 
-## 黄金样张
-
-| 模式 | 文件 |
-|------|------|
-| A 演示 | [`2026-09-09-presentation-business-blue`](./top-ppt-html/assets/examples/2026-09-09-presentation-business-blue.html) |
-| B 研究 | [`2026-09-09-research-mckinsey`](./top-ppt-html/assets/examples/2026-09-09-research-mckinsey.html) |
-| C 架构 | [`2026-09-09-architecture-graphite-dark`](./top-ppt-html/assets/examples/2026-09-09-architecture-graphite-dark.html) |
-| 产品 Showcase | [`2026-09-26-topmind-tms-skills-showcase`](./top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html)（双交付叙事 · 5 种图表 · Header 工具栏） |
-
 ## 仓库结构
 
 ```
@@ -176,7 +109,6 @@ tms-skills/
 
 ```bash
 npm run check && npm run audit && npm run privacy
-# PPTX 冒烟（含 McKinsey）：bash scripts/ci_skill_gates.sh --with-pptx
 ```
 
 详见 [docs/PUBLISHING.md](./docs/PUBLISHING.md) · [docs/ci.md](./docs/ci.md)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/tms-skills",
-  "version": "0.3.1",
+  "version": "0.3.5",
   "description": "TopMindspace 智能体技能 monorepo — 通过 npm / GitHub npx 安装技能（top-ppt-html：HTML+PPT 双交付，正式商务演示文稿）。",
   "license": "MIT",
   "author": "TopMindspace",

package/top-ppt-html/README.en.md

@@ -9,16 +9,8 @@
 
 **Let ideas fly — make good thinking visible.** A high-craft skill for **demo reports / formal business presentations**: **HTML + PPT dual delivery** — day-to-day, present with paginated HTML like slides; export **layout-faithful editable PPTX** when needed. **MD3-inspired**: fitting information density, restrained type / shapes / color. Core craft is layout, typography, color, and content structure — not gadget soup.
 
-### Why top-ppt-html
-
-Plenty of PPT skills exist. This one is for **formal business presenting**: clear, atmospheric, multi-style, **high-fidelity editable PPTX** (charts carry annotatable data) — stage-ready output.
-
-<p align="center">
-  <img src="assets/showcase/showcase-cover.png" alt="TopMind × tms-skills showcase cover" width="720" />
-</p>
-
 - Skill id: `top-ppt-html`; brand: **TopPPT HTML**
-- Version: **v0.1.19** (same tag as `@topmindspace/tms-skills@0.3.1`)
+- Version: **v0.1.19** (same tag as `@topmindspace/tms-skills@0.3.5`)
 - **Agent entry**: `SKILL.md` → `references/playbook.md` (L1) → L2 on demand
 - **Human maintainers**: this README (install / commands / layout); do not treat it as the generation spec
 
@@ -29,16 +21,6 @@ Plenty of PPT skills exist. This one is for **formal business presenting**: clea
   <sub>Presentation · business-blue (default) · also <a href="./assets/style-gallery.html">style-gallery</a> · <a href="./assets/theme-overview-research.png">research</a> · <a href="./assets/theme-overview-architecture.png">architecture</a></sub>
 </p>
 
-### Style × mode
-
-| business-blue · Presentation | mckinsey · Research | graphite-dark · Architecture |
-|:---:|:---:|:---:|
-| ![bb](assets/showcase/style-business-blue-cover.png) | ![mk](assets/showcase/style-mckinsey-cover.png) | ![gr](assets/showcase/style-graphite-cover.png) |
-
-| Positioning | Dual delivery | Charts | Header toolbar |
-|:---:|:---:|:---:|:---:|
-| ![pos](assets/showcase/showcase-positioning.png) | ![sp](assets/showcase/showcase-split.png) | ![ch](assets/showcase/showcase-charts.png) | ![tb](assets/showcase/showcase-toolbar.png) |
-
 **Live** · [Landing](https://topmindspace.github.io/tms-skills/) · [Showcase deck](https://topmindspace.github.io/tms-skills/showcase.html) · [Style gallery](https://topmindspace.github.io/tms-skills/style-gallery.html)
 
 - In-repo gallery: [`assets/style-gallery.html`](./assets/style-gallery.html)
@@ -73,10 +55,27 @@ Also: arrow-key paging; **Esc** closes modals. After style/theme change, re-run
 
 ```bash
 npx @topmindspace/tms-skills install top-ppt-html
-npx @topmindspace/tms-skills@0.3.1 install top-ppt-html
+npx @topmindspace/tms-skills@0.3.5 install top-ppt-html
 npx github:topmindspace/tms-skills install top-ppt-html
 ```
 
 PPTX needs `npm install` in this folder (pptxgenjs). HTML generation: Python stdlib only.
 
+### Minimal example (~3 min)
+
+```bash
+cd top-ppt-html
+python3 scripts/scaffold_report.py --mode research --style mckinsey \
+  --title "Sample report" --sections 8 --out report.html
+# Open report.html, fill in window.REPORT_MODEL only (single source of truth), then:
+python3 scripts/render_from_model.py report.html --inplace
+python3 scripts/validate_report.py report.html --strict   # ship only at 0 errors / 0 warnings
+# For PPTX (after npm install):
+python3 scripts/extract_model.py report.html report.model.json
+node scripts/build_pptx.js report.pptx --model=report.model.json
+python3 scripts/validate_pptx.py report.pptx --strict --model=report.model.json
+```
+
+Swap modes: `--mode presentation --style business-blue` (A) / `--mode architecture --style graphite-dark` (C).
+
 Full Chinese maintainer docs (directory map, command cookbook): see [`README.md`](./README.md). Agent rules live in `SKILL.md` / `playbook.md`.