@topmindspace/tms-skills 0.3.9 → 0.5.0

package/CHANGELOG.md

@@ -1,3 +1,117 @@
+## [0.5.0] - 2026-09-29
+
+> 根包 0.4.1 → **0.5.0**（minor，本轮是功能轮）；技能版本：topmind-x-article 0.1.0 → **0.2.0**、
+> topmind-cover 保持 0.2.0（纯文档新增）、topmind-wechat-post 保持 0.1.0（纯文档）、top-ppt-html 保持 0.2.1（无变更）。
+
+### topmind-x-article 0.2.0（新功能：HTML 一键复制发布链路）
+
+- 新增 `scripts/md2x-html.py`：原稿 → 单文件 HTML（内联样式 + 配图 base64 内嵌 +
+  页顶「一键复制全文」+ 每图 `[图N]` 编号/下载按钮 + 每提示词块「复制提示词」按钮 + 封面仅预览/下载）
+- 按 X 编辑器真实语法重写（v3）：提示词块改 `<blockquote>`（X 不识别粘贴的 `<pre>` 为代码块，
+  原生代码块只能走 Insert 菜单）；`#` 标题不进剪贴板（手动填 X 标题栏）；复制前 JS 自动剥离按钮/UI；
+  GFM 表格转列表（X 粘贴丢弃 `<table>`）；新增有序列表、裸链接转超链接
+- 提示词复制双通道文档：作者侧用 HTML「复制提示词」按钮（发布前取用文本）；
+  读者侧一键复制必须转为 X 原生 Code 块（Insert → Code 手动逐块转换，原生代码块带 native copy button）
+- README 中英重写用法（HTML 首选、txt 兜底）
+
+### topmind-cover（文档，保持 0.2.0）
+
+- 新增 `references/cover-prompts.md`（436 行）：11 风格可直接拷贝的中文提示词手册 +
+  参考图复刻学习区（设计语言拆解 + 学习版提示词 + 原创红线）+ 外部调研
+  （小红书六大高互动类型各 1 条、YouTube 高 CTR 范式、公众号/X 规则，8 个来源链接）+
+  14 种内容类型场景组合推荐表 + 通用负面提示词中英 + 变量速查表
+
+### topmind-wechat-post（文档，保持 0.1.0）
+
+- `references/wechat-constraints.md`：已发布正文不可能保留 JS 复制按钮（JS 被剥离，
+  第三方排版器的复制按钮只存在于其本地预览页）；代码围栏只负责高亮/折行/可读性，
+  不得在正文中承诺「一键复制」；需复制即用走评论区置顶/附件/小程序文档等站外链路
+
+### 文档与元数据
+
+- 根 README 中英：技能表（x-article 0.2.0 + 新描述）、安装器版本 0.5.0、钉版本示例 `@0.5.0`
+- 四技能 README 中英「同 tag」引用全部 → `@topmindspace/tms-skills@0.5.0`
+- `docs/PUBLISHING.md`：当前线（安装器 0.5.0、x-article 0.2.0）与整仓同 tag 示例 v0.5.0
+
+## [0.4.1] - 2026-09-29
+
+> **本版备发**（tag v0.4.1 待打；npm 待发布；commit = 本轮审计报告落盘时的 `git log` 首条）。
+> 根包 0.4.0 → **0.4.1**（patch）；技能版本：top-ppt-html 0.2.0 → **0.2.1**（修技能数据 bug 则 patch）、
+> topmind-cover 保持 0.2.0（仅换样张图+描述文案，无功能变更）、topmind-wechat-post / topmind-x-article 保持 0.1.0。
+> 本轮是第十三轮集成轮（A 文档抛光 + B 示例与描述 + C 新代码复审），改动最小、无新功能。
+> 另含第十四轮集成轮（wechat-post/x-article 真 bug 修复 + installer 测试扩展）：**不 bump 版本**，全部并入 0.4.1。
+
+### 安装器 bug 修复（高危 · Worker C 复审发现）
+
+- `uninstall`/`install` 的 `assertDestOutsideSource` 守卫被符号链接绕过：`path.resolve` 不解析软链，
+  `--to <软链指向包根>` 会跟随链接 `rmSync` 删掉包内技能源目录（已实测验证旧代码确会删源）
+- 修复：`bin/tms-skills.js` 改用 `realpath` 归一化比对（`realOrResolved()`：dest 不存在时向上找最深存在祖先），+25/−4
+- `scripts/test_installer_cli.js` 新增 case11/case12（uninstall/install 经软链指包根 → 拒绝、源目录完好），12 用例全过
+
+### top-ppt-html 0.2.1（Worker C 复审发现 · 低危数据 bug）
+
+- `assets/icons/index.json`：「组织」图标关键词含裸「架构」，会把「系统架构」类标题配上人物组织图 → 已收窄为「组织架构」
+
+### 文档抛光（Worker A）
+
+- topmind-cover/SKILL.md：冲击力自检清单 10→9（合并逐字正确项）、设计铁律去重
+- impact-language.md：删除与 cover-styles.md 重复的「白色清新」章节（只在 cover-styles 保留，出处回指用户参考图）
+- 根 README 中英：封面技能描述 8 种风格 → 11 种；top-ppt-html README 中英版本口径改为与 `@topmindspace/tms-skills@0.4.1` 同 tag
+
+### 示例与描述（Worker B）
+
+- `white-clean-alt.png`（white-clean-2）已重生成：标题「极简收纳全攻略」摆正、逐字正确；配套
+  `white-clean-alt-wechat.png`（900×383）新增落盘并纳入 git；示例目录 README 计数同步为 26 张
+- 4 处 description 更新（cover package.json + SKILL frontmatter 加「11 种风格模板」；ppt-html package.json + SKILL frontmatter 加「48 图标 + 弹性版式」）；overview alt 文案 8→11
+- cover 安装文案复核：`list` 输出已准确，未动安装器
+
+### 第十四轮集成（Worker A/B/C）——不 bump 版本，全部并入 0.4.1
+
+- **topmind-wechat-post 修 6 真 bug**（`scripts/md2wechat.py`，Worker A 专审发现）：
+  - yaml/diff 代码块高亮正则在分支内误用 `(?m)` → `re.error` 崩溃（编译期统一 `re.M|re.S`，分支内去掉）
+  - URL 含平衡括号被截断 → 新增括号嵌套匹配扫描器替代旧正则
+  - `[文字](url "title")` 带 title 链接认不出 → 链接解析支持 title
+  - 脚注 URL 的 `&` 被转义两次 → 修正转义顺序
+  - 坏主题 JSON 的 Traceback → 干净报错；目录当输入的报错文案修正
+  - 嵌套围栏被提前闭合 → 围栏匹配支持嵌套
+  - `scripts/negative_tests.py` 新增 6 个 case，15/15 绿
+- **topmind-x-article 修嵌套围栏**（`scripts/md2x.py`，Worker A 专审发现）；
+  `scripts/negative_tests.py` 新增 2 个 case，8/8 绿
+- **installer 回归测试扩展**（Worker C）：`scripts/test_installer_cli.js` 新增 case13–22，
+  覆盖 symlink 守卫纵深（realpath 归一化）与 installer 回归，72 断言全绿；`bin/` 未动，无真实绕过
+- **分发体积与性能**（Worker B）：无真问题。0.4.1 tarball 解包 29.1MB（0.3.9 18.4MB，
+  +10.7MB 系封面示例画廊预期增量）；top10 大文件全合法素材；48 图标 PNG 最大 27.4KB 无异常；
+  install 耗时 0.3s 不需优化；`sync_npm_files.js --check` 通过
+- 技能版本号保持：wechat-post / x-article 保持 0.1.0（纯 bug 修复按技能版本规则不 bump）；
+  cover 保持 0.2.0、ppt-html 保持 0.2.1、根包保持 0.4.1
+
+## [0.4.0] - 2026-09-29
+
+> **本版备发**（tag v0.4.0 待打；npm 待发布；commit = 本轮审计报告落盘时的 `git log` 首条）。
+> 根包 0.3.9 → **0.4.0**（minor，本轮是功能轮）；技能版本：top-ppt-html 0.1.19 → **0.2.0**、topmind-cover 0.1.0 → **0.2.0**、topmind-wechat-post / topmind-x-article 保持 0.1.0。
+> 本轮是"对标业界+浅色封面+图标包版式"的功能轮（第十二轮）。
+
+### 安装器（Worker A）
+
+- 新增 `uninstall <id> [--to]` 命令：卸载已安装技能，`--to` 指向文件/缺目录时干净报错 exit 1
+- `install` 已装版本感知：已装同版本拒绝安装并给出三行摘要（当前版本/来源/提示 uninstall 或覆盖），不再静默覆盖
+- `scripts/test_installer_cli.js`：10 用例 38 断言，覆盖 install/uninstall/list/负向输入
+- `--help` 更新、根 README.md/README.en.md 安装章节重写（`github:` 口径、钉版本示例同步 0.4.0）
+- `.github/workflows/ci.yml` 新增 "Installer CLI tests" step
+
+### topmind-cover 0.2.0（Worker B）
+
+- 新增 3 个浅色风格：`white-clean`（排第一，标题冲击目标 1/3 字高）、`bg-blur`（背景虚化突出前景）、`paper-collage`（纸拼贴质感）
+- `cover-styles.md` 11 风格重排为浅色优先；`impact-language.md` 补条目；SKILL.md 新增"直出/讨论"决策流
+- 6 张新风格样张 + `overview.png` 重建；`references/ref-white-clean-1/2.png` 新增参考图
+
+### top-ppt-html 0.2.0（Worker C）
+
+- 内置原创图标包 `assets/icons/`：48 SVG + 48 PNG + `index.json` 映射，7 个默认图标兜底；`scripts/check_icons.py`（`--strict`）做图标一致性门禁；`references/icons.md` 文档化
+- 3 种 layout variant：bento-grid / timeline / 2-col-feature（`references/layout-variants.md`）；`references/style-pack.md` 风格包文档化
+- `validate_report.py` 新增内容覆盖率检查（<95% WARN）；随门禁修复 6 个真实丢字 bug
+- `scripts/layout-constants.json` 加 adaptiveText 弹性文本规则；HTML/PPTX 弹性适配减少溢出截断
+
 ## [0.3.9] - 2026-09-29
 
 > **本版备发**（tag v0.3.9 待打；npm 待发布；commit = 本轮审计报告落盘时的 `git log` 首条）。

package/README.en.md

@@ -39,14 +39,14 @@ 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. **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).
+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). 11-style index and recipes: [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md).
 
 ```bash
 npx @topmindspace/tms-skills install topmind-cover
 ```
 
 <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" />
+  <img src="https://github.com/topmindspace/tms-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 11 cover-style overview" width="960" />
 </p>
 
 > Let ideas fly — make good thinking visible.
@@ -61,12 +61,12 @@ npx @topmindspace/tms-skills install topmind-cover
 
 | Skill | Version | What it does |
 |-------|---------|--------------|
-| [`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 |
+| [`top-ppt-html`](./top-ppt-html/) | **0.2.1** | 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 + 16 dual-size example images + 1 style overview |
+| [`topmind-x-article`](./topmind-x-article/) | **0.2.0** | X long-form one-click publish: Markdown → one-click-copy HTML (images/prompt copy) / plain-text fallback + cover + checklist |
+| [`topmind-cover`](./topmind-cover/) | **0.2.0** | Cover art for X / WeChat: striking, theme-focused; 11-style cover style library + 26 example images (incl. 3 alt samples) + 1 style overview |
 
-Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) is **0.3.9** (whole-repo same-tag releases).
+Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) is **0.5.0** (whole-repo same-tag releases).
 
 ## Install
 
@@ -76,7 +76,8 @@ Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspa
 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.9 install top-ppt-html   # pin
+npx @topmindspace/tms-skills@0.5.0 install top-ppt-html   # pin
+npx @topmindspace/tms-skills uninstall top-ppt-html --to ./.claude/skills
 ```
 
 ```bash
@@ -84,7 +85,9 @@ npx @topmindspace/tms-skills@0.3.9 install top-ppt-html   # pin
 npx github:topmindspace/tms-skills install top-ppt-html
 ```
 
-Default probe order: `./.agents` → `./.claude` → `./.cursor` → `./.codex` → `./.mimocode`, then user-level `~/.claude`, etc. Or pass `--to`. Do not `npm install top-ppt-html` (skill id is not a standalone package).
+Default probe order: `./.agents` → `./.claude` → `./.cursor` → `./.codex` → `./.mimocode`, then user-level `~/.claude`, etc. Or pass `--to`. When `--to` is omitted, the install summary explicitly prints the auto-detected target directory. Do not `npm install top-ppt-html` (skill id is not a standalone package).
+
+`install` details: if a same-named skill already exists, the installed version is reported and overwriting is refused — pass `--force` to replace (or `uninstall` first). On success, a three-line summary is printed: where it was installed / installed skill version and installer version / next steps.
 
 PPTX export needs `npm install` in the skill folder (pptxgenjs). HTML generation uses Python stdlib only.
 
@@ -93,7 +96,7 @@ PPTX export needs `npm install` in the skill folder (pptxgenjs). HTML generation
 ```
 tms-skills/
 ├─ top-ppt-html/             # skill (SKILL.md + assets + references + scripts)
-├─ bin/tms-skills.js         # CLI: list / install
+├─ bin/tms-skills.js         # CLI: list / install / uninstall
 ├─ docs/                     # publishing · showcase shots · banner · Pages source
 ├─ scripts/                  # repo gates / privacy scan
 ├─ package.json              # @topmindspace/tms-skills

package/README.md

@@ -37,14 +37,14 @@ npx @topmindspace/tms-skills install topmind-x-article
 
 ### topmind-cover · 封面配图生成
 
-X 长文与公众号共用的封面图：震撼、醒目、主题突出。**选风格 → 看示例 → 按配方组 prompt** 三步出图，`crop-cover.py` 一键裁出双平台尺寸（X 1200×675、公众号 900×383）。8 种风格索引与配方见 [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md)。
+X 长文与公众号共用的封面图：震撼、醒目、主题突出。**选风格 → 看示例 → 按配方组 prompt** 三步出图，`crop-cover.py` 一键裁出双平台尺寸（X 1200×675、公众号 900×383）。11 种风格索引与配方见 [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md)。
 
 ```bash
 npx @topmindspace/tms-skills install topmind-cover
 ```
 
 <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" />
+  <img src="https://github.com/topmindspace/tms-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 11 封面风格总览" width="960" />
 </p>
 
 > 让 idea 飞，好想法被看见。
@@ -59,12 +59,12 @@ npx @topmindspace/tms-skills install topmind-cover
 
 | 技能 | 版本 | 做什么 |
 |------|------|--------|
-| [`top-ppt-html`](./top-ppt-html/) | **0.1.19** | 正式商务演示：HTML 可翻页 + 16:9 可编辑 PPTX；双交付 · MD3 密度克制；三模式 × 九风格；strict 0/0 |
+| [`top-ppt-html`](./top-ppt-html/) | **0.2.1** | 正式商务演示：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 风格封面风格库 + 16 张双尺寸示例图 + 1 张风格总览图 |
+| [`topmind-x-article`](./topmind-x-article/) | **0.2.0** | X 长文一键发布：Markdown 原稿 → 一键复制 HTML（含配图/提示词复制）/ 纯文本兜底 + 封面图 + 发布清单 |
+| [`topmind-cover`](./topmind-cover/) | **0.2.0** | 文章封面配图（X / 公众号共用）：震撼醒目主题突出；11 风格封面风格库 + 26 张示例图（含 3 张 alt 样张） + 1 张风格总览图 |
 
-安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 为 **0.3.9**（整仓同 tag 发版）。
+安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 为 **0.5.0**（整仓同 tag 发版）。
 
 > SKILL.md frontmatter 除标准 `name`/`description` 外，本仓库扩展了 `action_category` / `triggers` / `triggers_cn` / `updated` 字段供安装器与路由使用。
 
@@ -76,7 +76,8 @@ 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.9 install top-ppt-html   # 钉版本
+npx @topmindspace/tms-skills@0.5.0 install top-ppt-html   # 钉版本
+npx @topmindspace/tms-skills uninstall top-ppt-html --to ./.claude/skills
 ```
 
 ```bash
@@ -84,7 +85,9 @@ npx @topmindspace/tms-skills@0.3.9 install top-ppt-html   # 钉版本
 npx github:topmindspace/tms-skills install top-ppt-html
 ```
 
-默认探测：`./.agents` → `./.claude` → `./.cursor` → `./.codex` → `./.mimocode`，再用户级 `~/.claude` 等；也可用 `--to`。不要 `npm install top-ppt-html`（技能 id 不是独立包）。
+默认探测：`./.agents` → `./.claude` → `./.cursor` → `./.codex` → `./.mimocode`，再用户级 `~/.claude` 等；也可用 `--to`。未给 `--to` 时安装摘要会明确打印探测到的目标目录。不要 `npm install top-ppt-html`（技能 id 不是独立包）。
+
+`install` 细节：若同名技能已存在，会报出已装版本并拒绝覆盖，需加 `--force` 才替换（或先 `uninstall` 再装）。安装成功后打印三行摘要：装到哪里 / 装的技能版本与安装器版本 / 下一步。
 
 PPTX 精导需在技能目录 `npm install`（pptxgenjs）。HTML 生成仅 Python 标准库。
 
@@ -93,7 +96,7 @@ PPTX 精导需在技能目录 `npm install`（pptxgenjs）。HTML 生成仅 Pyth
 ```
 tms-skills/
 ├─ top-ppt-html/             # 技能（SKILL.md + assets + references + scripts）
-├─ bin/tms-skills.js         # CLI：list / install
+├─ bin/tms-skills.js         # CLI：list / install / uninstall
 ├─ docs/                     # 发布规范 · showcase 截图 · banner · Pages 源
 ├─ scripts/                  # 仓库级门禁 / 隐私扫描
 ├─ package.json              # @topmindspace/tms-skills

package/bin/tms-skills.js

@@ -10,6 +10,7 @@
  *   npx @topmindspace/tms-skills install top-ppt-html
  *   npx @topmindspace/tms-skills install top-ppt-html --to ./skills-out
  *   npx @topmindspace/tms-skills install top-ppt-html --force
+ *   npx @topmindspace/tms-skills uninstall top-ppt-html --to ./skills-out
  *   npx github:topmindspace/tms-skills install top-ppt-html   # follow repo HEAD
  */
 'use strict';
@@ -69,6 +70,30 @@ function readSkillMeta(skillId) {
   return { id: skillId, description: String(desc).slice(0, 120) };
 }
 
+/** 读技能目录下 SKILL.md frontmatter 的 version 字段（读不到返回 ''，调用方兜底）。 */
+function readSkillVersion(skillPath) {
+  try {
+    const p = path.join(skillPath, 'SKILL.md');
+    if (!fs.existsSync(p)) return '';
+    const text = fs.readFileSync(p, 'utf8');
+    const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!m) return '';
+    const v = m[1].match(/^version:\s*(.+?)\s*$/m);
+    return v ? v[1] : '';
+  } catch {
+    return '';
+  }
+}
+
+function installerVersion() {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8'));
+    return pkg.version || 'unknown';
+  } catch {
+    return 'unknown';
+  }
+}
+
 function resolveDefaultTarget() {
   const home = process.env.HOME || process.env.USERPROFILE || '';
   const candidates = [
@@ -112,15 +137,34 @@ function normPath(p) {
   return process.platform === 'win32' ? s.toLowerCase() : s;
 }
 
+/** realpath 能解析就解析（跟符号链接），失败回退 path.resolve。
+ *  dest 可能还不存在（install 流程）：往上找最深存在的祖先解析后再拼回。
+ *  否则 --to 经符号链接指向包内时，词法比对会被绕过（rmSync 会跟链接删掉源）。 */
+function realOrResolved(p) {
+  let cur = path.resolve(p);
+  const tail = [];
+  for (;;) {
+    try {
+      return path.join(fs.realpathSync(cur), ...tail);
+    } catch {
+      const parent = path.dirname(cur);
+      if (parent === cur) return path.join(cur, ...tail);
+      tail.unshift(path.basename(cur));
+      cur = parent;
+    }
+  }
+}
+
 /** 安装目标守卫（审计 严重-2）：
  *  dest == 技能源目录  → --force 会先 rmSync 删掉源目录，再"成功"装出空目录（数据丢失 + 虚假成功）；
  *  dest 在源目录内部  → copyDir 无限递归复制直至 ENAMETOOLONG，并留下垃圾目录树。
- *  path.resolve 归一化后比对（dest === src，或 dest 以 src + 路径分隔符开头），
+ *  realpath 归一化后比对（dest === src，或 dest 以 src + 路径分隔符开头），
+ *  防止 --to 经符号链接指向包内绕过词法比对；
  *  Windows 下额外做大小写归一。无论是否 --force，一律拒绝。
  */
 function assertDestOutsideSource(src, dest) {
-  const absSrc = normPath(src);
-  const absDest = normPath(dest);
+  const absSrc = normPath(realOrResolved(src));
+  const absDest = normPath(realOrResolved(dest));
   if (absDest === absSrc || absDest.startsWith(absSrc + path.sep)) {
     die(
       `Refusing to install into the skill's own directory tree.\n` +
@@ -132,7 +176,7 @@ function assertDestOutsideSource(src, dest) {
   }
 }
 
-function install(skillId, targetRoot, { force = false } = {}) {
+function install(skillId, targetRoot, { force = false, defaultTarget = false } = {}) {
   assertSkillId(skillId);
   const src = skillDir(skillId);
   if (!fs.existsSync(path.join(src, 'SKILL.md'))) {
@@ -151,22 +195,74 @@ function install(skillId, targetRoot, { force = false } = {}) {
   }
   if (fs.existsSync(dest)) {
     if (!force) {
+      // 已装过：报出已装版本，要求 --force 才覆盖（不静默覆盖）。
+      const installedVer = readSkillVersion(dest) || 'unknown';
+      const packageVer = readSkillVersion(src) || 'unknown';
       die(
-        `Destination already exists: ${dest}\n` +
-          'Refusing to overwrite. Pass --force (or -f) to replace.'
+        `Already installed: ${dest}\n` +
+          `  installed version: ${installedVer} (this package ships ${packageVer})\n` +
+          'Refusing to overwrite. Pass --force (or -f) to replace, or remove it first:\n' +
+          `  tms-skills uninstall ${skillId} --to ${targetRoot}`
       );
     }
     fs.rmSync(dest, { recursive: true, force: true });
   }
   copyDir(src, dest);
+  // 安装摘要三行：装到哪里 / 装了什么版本 / 下一步。
+  const toNote = defaultTarget ? '  (default, auto-detected — no --to given)' : '';
+  const skillVer = readSkillVersion(dest) || 'unknown';
   console.log(`Installed ${skillId}`);
-  console.log(`  from ${src}`);
-  console.log(`  to   ${dest}`);
+  console.log(`  to:      ${dest}${toNote}`);
+  console.log(`  version: skill ${skillVer} (installer ${installerVersion()})`);
+  console.log(`  next:    ${nextStep(skillId, dest)}`);
+}
+
+function nextStep(skillId, dest) {
   if (skillId === 'top-ppt-html') {
-    console.log('');
-    console.log('Optional (PPTX export only):');
-    console.log(`  cd "${dest}" && npm install`);
+    return `optional (PPTX export only): cd "${dest}" && npm install — then restart your agent so it picks up the skill`;
+  }
+  return 'restart your agent so it picks up the skill';
+}
+
+/** 列出目标根目录下已安装的技能（有 SKILL.md 的子目录）。 */
+function listInstalledIds(targetRoot) {
+  try {
+    return fs
+      .readdirSync(targetRoot, { withFileTypes: true })
+      .filter((d) => d.isDirectory() && fs.existsSync(path.join(targetRoot, d.name, 'SKILL.md')))
+      .map((d) => d.name)
+      .sort();
+  } catch {
+    return [];
+  }
+}
+
+function uninstall(skillId, targetRoot) {
+  assertSkillId(skillId);
+  const src = skillDir(skillId);
+  const dest = path.join(targetRoot, skillId);
+  // 守卫：--to 指到包内时，dest 会命中安装器自带的技能源目录 → 一律拒绝，
+  // 防止把仓库自身的技能目录删掉（同 install 的 assertDestOutsideSource）。
+  if (fs.existsSync(path.join(src, 'SKILL.md'))) {
+    assertDestOutsideSource(src, dest);
+  }
+  if (!fs.existsSync(dest)) {
+    const installed = listInstalledIds(targetRoot);
+    die(
+      `Nothing to uninstall: ${dest}\n` +
+        `  skill '${skillId}' is not installed under ${targetRoot}.` +
+        (installed.length ? `\n  installed here: ${installed.join(', ')}` : '')
+    );
   }
+  if (!fs.existsSync(path.join(dest, 'SKILL.md'))) {
+    die(
+      `Refusing to uninstall: ${dest}\n` +
+        `  not a skill directory (missing SKILL.md) — will not delete arbitrary folders.`
+    );
+  }
+  fs.rmSync(dest, { recursive: true, force: true });
+  console.log(`Uninstalled ${skillId}`);
+  console.log(`  from ${dest}`);
 }
 
 function usageText() {
@@ -175,16 +271,33 @@ function usageText() {
 Usage:
   tms-skills list|ls
   tms-skills install <skill-id> [--to|-t <dir>] [--force|-f]
+  tms-skills uninstall <skill-id> [--to|-t <dir>]
   tms-skills help
 
+Behavior:
+  install    copies <skill-id>/ into <dir>/<skill-id>/. If the skill is already
+             installed, the installed version is reported and --force is required
+             to overwrite. Prints where/what-version/next-steps when done.
+  uninstall  removes <dir>/<skill-id>/ (refuses: not installed, not a skill
+             directory, or the package's own skill source).
+  No --to: the target directory is auto-detected (probe order below) and
+  printed explicitly in the install summary.
+
+Target probe order (no --to): ./.agents/skills, ./.claude/skills,
+  ./.cursor/skills, ./.codex/skills, ./.mimocode/skills, then
+  ~/.claude/skills, ~/.agents/skills, ~/.cursor/skills, ~/.codex/skills.
+
 Examples (npm recommended when published):
   npx @topmindspace/tms-skills list
   npx @topmindspace/tms-skills install top-ppt-html
   npx @topmindspace/tms-skills install top-ppt-html --to ./.agents/skills
   npx @topmindspace/tms-skills install top-ppt-html --force
+  npx @topmindspace/tms-skills uninstall top-ppt-html --to ./.agents/skills
 
   # Follow repo HEAD:
   npx github:topmindspace/tms-skills install top-ppt-html
+
+Privacy: the installer is fully local — it never collects or uploads anything.
 `;
 }
 
@@ -233,7 +346,26 @@ function main(argv) {
       }
     }
     const targetRoot = to ? path.resolve(to) : resolveDefaultTarget();
-    install(skillId, targetRoot, { force });
+    install(skillId, targetRoot, { force, defaultTarget: !to });
+    return;
+  }
+
+  if (cmd === 'uninstall') {
+    const skillId = args[1];
+    if (!skillId || skillId.startsWith('-')) {
+      die('Missing skill id.\n\n' + usageText());
+    }
+    let to = null;
+    for (let i = 2; i < args.length; i++) {
+      if (args[i] === '--to' || args[i] === '-t') {
+        to = args[++i];
+        if (!to) die('Option --to requires a directory path.');
+      } else {
+        die(`Unknown option: ${args[i]}\n\n` + usageText());
+      }
+    }
+    const targetRoot = to ? path.resolve(to) : resolveDefaultTarget();
+    uninstall(skillId, targetRoot);
     return;
   }
 

package/package.json

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

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

@@ -10,7 +10,7 @@
 **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.
 
 - Skill id: `top-ppt-html`; brand: **TopPPT HTML**
-- Version: **v0.1.19** (same tag as `@topmindspace/tms-skills@0.3.9`)
+- Version: **v0.2.1** (same tag as `@topmindspace/tms-skills@0.5.0`)
 - **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
 
@@ -55,7 +55,7 @@ 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.9 install top-ppt-html
+npx @topmindspace/tms-skills@0.5.0 install top-ppt-html
 npx github:topmindspace/tms-skills install top-ppt-html
 ```
 

package/top-ppt-html/README.md

@@ -10,7 +10,7 @@
 **让 idea 飞，好想法被看见。** 为**演示报告 / 正式商务演示**而生的高品质演示文稿技能：**HTML + PPT 双交付**——日常用可翻页 HTML 等同幻灯片；需要时再导出**版式保真可编辑 PPTX**。参考 **MD3**：合适信息密度、克制文字/图形/颜色。核心工艺是版式、排版、色彩与内容组织——不是 gadget 堆砌。
 
 - 技能标识：`top-ppt-html`；品牌名：**TopPPT HTML**
-- 版本：**v0.1.19**（与 `@topmindspace/tms-skills@0.3.9` 同 tag）
+- 版本：**v0.2.1**（与 `@topmindspace/tms-skills@0.5.0` 同 tag）
 - **智能体入口**：`SKILL.md` → `references/playbook.md`（L1）→ L2 按需
 - **人类维护者**：本 README（安装 / 命令 / 目录）；勿把本文件当生成规范
 

package/top-ppt-html/SKILL.md

@@ -17,10 +17,10 @@ triggers:
   - 培训课件
   - 答辩
   - fast
-description: "为正式商务演示把材料做成可视化报告：零外链可翻页 HTML（日常上台）+ 高保真可编辑 16:9 PPTX（按需）双交付；MD3 式密度克制；三模式（A 演示 / B 研究 / C 架构）× 9 风格。Use when 用户要做报告、演示、汇报、PPT、slides、deck、路演，或写研究报告、分析报告、咨询报告、白皮书、调研、评测、对标、经营分析、复盘、项目汇报、商务/HTML/网页报告，或做架构图、拓扑图、流程图、泳道图、方案图，或把材料做成可视化报告并导出 HTML/PPT/PPTX，或优化报告的排版/版式/配色/图文布局，或做报告时说快速模式/fast/直接生成/一键出稿/少问一句。Do NOT use for 纯代码工程、非报告类网页或应用开发、视频/图片生成、直接改写已有 Word/PPT 源文件本身、封面配图（→topmind-cover）。"
+description: "为正式商务演示把材料做成可视化报告：零外链可翻页 HTML（日常上台）+ 高保真可编辑 16:9 PPTX（按需）双交付；MD3 式密度克制；三模式（A 演示 / B 研究 / C 架构）× 9 风格；内置 48 原创线性图标 + bento/timeline/2col 弹性版式。Use when 用户要做报告、演示、汇报、PPT、slides、deck、路演，或写研究报告、分析报告、咨询报告、白皮书、调研、评测、对标、经营分析、复盘、项目汇报、商务/HTML/网页报告，或做架构图、拓扑图、流程图、泳道图、方案图，或把材料做成可视化报告并导出 HTML/PPT/PPTX，或优化报告的排版/版式/配色/图文布局，或做报告时说快速模式/fast/直接生成/一键出稿/少问一句。Do NOT use for 纯代码工程、非报告类网页或应用开发、视频/图片生成、直接改写已有 Word/PPT 源文件本身、封面配图（→topmind-cover）。"
 license: MIT
 compatibility: "Python 3 stdlib for HTML generation; Node >=18 + pptxgenjs for PPTX; optional playwright for browser regression / theme captures."
-version: 0.1.19
+version: 0.2.1
 author: TopMindspace
 ---
 # TopPPT HTML
@@ -51,7 +51,7 @@ author: TopMindspace
 | 篇幅 | A=10 / B=12 / C=6 | |
 | format | **html only**（用户要 PPT/PPTX 才开 B 通道） | |
 
-**跳过** Gate 0/六项/完整大纲；**仍须**最小大纲→模型单写→strict 0/0→`quality_gate --deliver`（反截断、图表多样、Mode A craft 不降）。L0+L1（A/Fast 可加 L1.5）；代码一律 `extract_snippet`。一行宣布「Fast 选用：…」→ playbook §二；声明已跳过参考图。**标准模式**仍强制 Gate 0 + 六项。
+**跳过** Gate 0/六项/完整大纲；**仍须**最小大纲→模型单写→strict 0/0→`quality_gate --deliver`（反截断、图表多样、Mode A craft 不降）。L0+L1（A/Fast 可加 L1.5）；一行宣布「Fast 选用：…」→ playbook §二；声明已跳过参考图。**标准模式**仍强制 Gate 0 + 六项。
 
 ## 唯一入口流程
 
@@ -82,7 +82,7 @@ author: TopMindspace
 | **轻量**（默认） | 页数不多、材料单一完整、关键判断已敲定 | 最小大纲 → 1 张规划卡（`outline-design.md`「轻量最小集」） |
 | **完整** | 长篇、材料杂、含未敲定关键判断、用户要看框架 | 证据盘点 → 故事线 → 主张树 → 逐页规划卡 → 大纲确认（1 轮） |
 
-精确判定条件与完整步骤见 `references/playbook.md` §二。完整路径确认只做一次；确认后只改指定处。
+精确判定条件与完整步骤详见 playbook §二。完整路径确认只做一次；确认后只改指定处。
 
 ## 变更与中断（过程可控 · 不重启六项问询）
 
@@ -105,7 +105,8 @@ author: TopMindspace
 - 模式契约与锁定版式 → `references/modes.md` · 完整路径七步 → `references/outline-design.md`
 - A/Fast L1.5 → `default-surface.md` + `presentation-craft.md` · 骨架 `layout-grammar.md` · 插画规范 → `illustration-layout.md`
 - 组件/版式**代码** → `components.md` · 页型表 `page-type-matrix.md` · 图表门面 `charts.md` + 决策树 `chart-decision-tree.md` · 信息图 → `infographics.md`
-- 配色/主题/字阶 → `styles.md` + `design-system.md` · 写作 → `content-rules.md` · 图标语义 → `icons.md`
+- 配色/主题/字阶 → `styles.md` + `design-system.md` · 写作 → `content-rules.md` · 图标语义 → `icons.md`（48 原创图标包 `assets/icons/`：HTML 内联 SVG / PPTX 用 PNG；`icon:<名>` 或 `data-icon`；按内容选图标，选不出用默认 7 个）
+- 风格包 → `references/style-pack.md`（`layout-constants.json` token 单源）· 布局变体 → `references/layout-variants.md`（`layoutVariants` 注册表：`bento-grid` / `timeline` / `2-col-feature`，section 字段 `variant` 指定）
 - PPTX 精导 → `references/pptx-export.md` · 深度高保真 → `references/high-fidelity.md` · 修复顺序 → `references/failure-modes.md` · 技能维护 → `references/tech-design.md`
 
 **操作方式**：定模式/页型/组合/图 → 只读 `playbook.md`；取代码 → **必须** `extract_snippet.py`。整读 = FAIL：`layouts-combo` / `components-atoms` / `charts-basic` / `charts-extended` / `content-rules` 全文 / `pptx-export` / 模式模板 HTML（走 scaffold）。
@@ -117,11 +118,11 @@ author: TopMindspace
 1. **单文件零外链**——无 CDN/外部字体/外部图片；图形一律内联 SVG；`<img src>` 仅 `data:` 或带 `alt` 的相对路径（单图 ≤1.5MB、全篇 ≤8MB）；无素材图用配图占位（`components.md` §11c-3），不留空。
 2. **模式先定后写**——从对应模式模板起步；`data-mode` = `REPORT_MODEL.mode`；页面无模式切换；PPTX 字号走三模式独立比例尺。
 3. **亮暗双主题一致**——CSS 变量整块换肤 + header 切换 + 文件级记忆；`REPORT_MODEL.theme` 与页面一致，PPTX 同主题导出；强调带只用 accent 家族；**末页禁 `band--deep`**。
-4. **每页一屏 + 高度稳定**——`section.band` ≥ 一屏；主内容不得溢出画布或压进结论条/注释带。放不下按「重构承载 → 拆页/分章 → 换布局形态 → 有限缩字号」；**禁**静默截断或为疏朗删结论条/证据。**大纲 = 3–7 章（每章 1+ 页），禁逐页标题罗列**。结论条 = MD3 tonal surface（无「So what」标签、**无左侧 accent 轨**）。
+4. **每页一屏 + 高度稳定**——`section.band` ≥ 一屏；主内容不得溢出画布或压进结论条/注释带。放不下按「重构承载 → 拆页/分章 → 换布局形态 → 有限缩字号」；**禁**静默截断或为疏朗删结论条/证据。**大纲 = 3–7 章（每章 1+ 页），禁逐页标题罗列**。结论条 = MD3 tonal surface（无「So what」标签、**无左侧 accent 轨**）。**内容覆盖率**：模型文本 → 渲染文本 ≥95%（`validate_report.py` WARN；标点不计，8 字窗口部分计分）；**PPTX 弹性文本**：长标题/列表/表格按 `layout-constants.json → containers.adaptiveText` 单源规则自动收紧字号/间距（标题按字符量分档、列表按条目数、表格有字号上限与行高下限）。
 5. **PPT 式翻页 + 骨架固定**——`section.band` 即一页；方向键翻页、页码可点；Agenda 第二页（arch 内容页 ≤4 可省）；页头只留 eyebrow+标题+可选导语，页脚全文一个。
 6. **标题与字号**——主标题粗体；research=结论句（≥12 字）；**presentation=主张/行动句**（禁话题标签）；字号随模式，`clamp()`；图表不缩水。
 7. **组合版式 + 细节保全**——默认一页 = 主件+从件+注释层；先判定决策必需信息再定形态，**禁砍口径列/时间列/维度**；密度 L/M/H 禁连续 3 页同档；同一版式不连用超 2 页。
-8. **列表优先 + 去 AI 味 + 图标克制**——大段文字转列表（research 双/三栏正文除外）；`aiFlavor` 词表零命中；图标每屏 3–8 个。
+8. **列表优先 + 去 AI 味 + 图标克制**——大段文字转列表（research 双/三栏正文除外）；`aiFlavor` 词表零命中；图标每屏 3–8 个；**按内容选图标**（`assets/icons/` 48 个，`icon_lib.js` 按关键词/标签匹配），选不出用 7 个默认图标；**只在必须/有必要用图标的场景使用，不要为装饰而堆图标**。
 9. **图表够大 + 够多样 + 双通道**——尺寸 ≥ `charts.minSize`；`data-chart` 须在 `charts.registry`（36 种）登记；多样性下限与相邻不同型按 `charts.variety`（playbook §五）；原生通道 `addChart` 双击可编辑数据，形状通道按登记策略附数据表。
 10. **引用与待核实**——外部数据 `[n]` + 文末参考资料（来源+时间+口径）双向对齐；**只列真实来源，无则省略整节，禁占位**；research 关键图表 Exhibit N 连续编号 + 来源行；`.tbd` 强调色必须配图例，单页 ≤12 处；只标色不解释即不合格。
 11. **容器级门禁 + 语义字号**——溢出按**归属容器**判定，越过容器即失败；容器保留内边距，不缩字号解溢出；表格正文用 `body`，`micro` 只给轴标签/单位/短标签；连续句不拆文本框。