@topmindspace/tms-skills 0.1.9 → 0.1.10

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 (17) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/README.en.md +142 -0
  3. package/README.md +27 -10
  4. package/package.json +2 -1
  5. package/top-ppt-html/README.en.md +77 -0
  6. package/top-ppt-html/README.md +23 -6
  7. package/top-ppt-html/SKILL.md +23 -12
  8. package/top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html +409 -33
  9. package/top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.model.json +207 -9
  10. package/top-ppt-html/assets/showcase/showcase-cover.png +0 -0
  11. package/top-ppt-html/assets/showcase/showcase-gates.png +0 -0
  12. package/top-ppt-html/assets/showcase/showcase-modes.png +0 -0
  13. package/top-ppt-html/assets/showcase/showcase-split.png +0 -0
  14. package/top-ppt-html/assets/showcase/showcase-toolbar.png +0 -0
  15. package/top-ppt-html/package-lock.json +2 -2
  16. package/top-ppt-html/package.json +1 -1
  17. package/top-ppt-html/scripts/hydrate_charts.py +341 -0
package/CHANGELOG.md CHANGED
@@ -1,3 +1,18 @@
1
+ ## 0.1.10 — 2026-09-26
2
+
3
+ ### Showcase · header toolbar docs · bilingual README
4
+
5
+ - **产品 Showcase 加厚**：`2026-09-26-topmind-tms-skills-showcase` 扩为 Mode A · 12 内容页；**5 种图表**（`bar` / `donut` / `line` / `waterfall` / `hbar`）经 `render_from_model` + `hydrate_charts` 回填；含 **Header 工具栏专页**（控件 × 快捷键 × 行为表）；`validate_report --strict` **0/0**。
6
+ - **Header 工具栏文档**：`SKILL.md` 交付物表（T/P/H/F/B + 9 风格 + Esc/翻页 + `REPORT_MODEL` 同步）；根 README / 技能 README（中英）显著说明。
7
+ - **双语 README**：保持 **`README.md` = 中文默认**；新增 **`README.en.md`** 全量英文平行；`top-ppt-html/README.en.md` 用户向摘要；文首互链。
8
+ - **截图**：刷新 `docs/showcase/topmind-showcase/*` 与 `top-ppt-html/assets/showcase/`（含 `showcase-toolbar.png`）。
9
+ - **维护工具**：新增 `scripts/hydrate_charts.py`（核心图类型占位 SVG → 模型数据绘形，供样张重建）。
10
+ - **Live**：`docs/showcase.html` / Pages 源与 github.io `tms-skills/` 同步本版 showcase。
11
+ - 版本对齐 **0.1.10**（根 + 技能 package/lock / SKILL metadata / README / PUBLISHING）。
12
+
13
+ ### 红线未动
14
+ 反截断、图表多样性地板、Mode A craft、runtime SHA 同版本门禁、中文「演示文稿」术语、整仓 npm 发版、motion=none。
15
+
1
16
  ## 0.1.9 — 2026-09-26
2
17
 
3
18
  ### Docs · banner · theme overview · live showcase
package/README.en.md ADDED
@@ -0,0 +1,142 @@
1
+ # tms-skills
2
+
3
+ **[中文](./README.md)** | English
4
+
5
+ > Language note: **Chinese is the default** (`README.md`). This file is the full English parallel.
6
+
7
+ [![Release](https://img.shields.io/github/v/release/topmindspace/tms-skills?style=flat-square&color=blue)](https://github.com/topmindspace/tms-skills/releases)
8
+ [![npm](https://img.shields.io/npm/v/@topmindspace/tms-skills?style=flat-square)](https://www.npmjs.com/package/@topmindspace/tms-skills)
9
+ [![CI](https://img.shields.io/github/actions/workflow/status/topmindspace/tms-skills/ci.yml?style=flat-square&label=CI)](https://github.com/topmindspace/tms-skills/actions/workflows/ci.yml)
10
+ [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](LICENSE)
11
+
12
+ **TopMindspace agent-skills monorepo** — turn good ideas into stage-ready deliverables.
13
+
14
+ Primary skill **[top-ppt-html](./top-ppt-html/)**: elegant, atmospheric **presentation decks** for formal occasions (single-file HTML + layout-faithful editable PPTX).
15
+
16
+ > Let ideas fly — make good thinking visible.
17
+
18
+ <p align="center">
19
+ <img src="docs/assets/tms-skills-banner.png" alt="tms-skills — TopMindspace agent skills" width="960" />
20
+ </p>
21
+
22
+ > **Warning**: do not install `@topmindspace/tms-skills@^2` (2.0.0–2.1.1 deprecated). Current line is **0.1.x** (`latest`).
23
+
24
+ ## Craft at a glance
25
+
26
+ ### Theme overviews (Gate 0)
27
+
28
+ <p align="center">
29
+ <img src="top-ppt-html/assets/theme-overview.png" alt="Presentation mode · business-blue theme overview" width="900" /><br/>
30
+ <sub>Presentation · business-blue</sub>
31
+ </p>
32
+
33
+ <p align="center">
34
+ <img src="top-ppt-html/assets/theme-overview-research.png" alt="Research mode · mckinsey theme overview" width="900" /><br/>
35
+ <sub>Research · mckinsey</sub>
36
+ </p>
37
+
38
+ <p align="center">
39
+ <img src="top-ppt-html/assets/theme-overview-architecture.png" alt="Architecture mode · graphite-dark theme overview" width="900" /><br/>
40
+ <sub>Architecture · graphite-dark</sub>
41
+ </p>
42
+
43
+ ### Style covers
44
+
45
+ | Presentation · business-blue | Research · mckinsey | Architecture · graphite-dark |
46
+ |:---:|:---:|:---:|
47
+ | ![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) |
48
+
49
+ ### Product showcase (Mode A · multi-chart · header toolbar)
50
+
51
+ | Cover | Three modes | Quality gates | Header toolbar |
52
+ |:---:|:---:|:---:|:---:|
53
+ | ![cover](docs/showcase/topmind-showcase/showcase-cover.png) | ![modes](docs/showcase/topmind-showcase/showcase-s4.png) | ![gates](docs/showcase/topmind-showcase/showcase-s8.png) | ![toolbar](docs/showcase/topmind-showcase/showcase-s11.png) |
54
+
55
+ **Live**
56
+
57
+ - Landing: [topmindspace.github.io/tms-skills/](https://topmindspace.github.io/tms-skills/)
58
+ - Full deck: [showcase.html](https://topmindspace.github.io/tms-skills/showcase.html)
59
+ - Style gallery: [style-gallery.html](https://topmindspace.github.io/tms-skills/style-gallery.html)
60
+ - In-repo gallery: [top-ppt-html/assets/style-gallery.html](./top-ppt-html/assets/style-gallery.html)
61
+ - 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)
62
+ - More shots: [docs/showcase/](./docs/showcase/)
63
+
64
+ ### HTML header toolbar (ready when you open the file)
65
+
66
+ | Control | Shortcut | Behavior |
67
+ |---------|----------|----------|
68
+ | Theme toggle | **T** | Light / dark; per-file memory; syncs `REPORT_MODEL.theme` |
69
+ | Style picker | 9 styles | Live visual skins; write back `REPORT_MODEL.style` before deliver |
70
+ | PPTX preview | **P** | WYSIWYG page sequence + copyable agent prompt |
71
+ | Generation guide | **H** | Dual-channel + environment notes |
72
+ | Fullscreen | **F** | Immersive present mode |
73
+ | Collapse toolbar | **B** | Mini bar (brand + expand); remembers per file |
74
+
75
+ See [top-ppt-html/README.md](./top-ppt-html/README.md) and [SKILL.md](./top-ppt-html/SKILL.md).
76
+
77
+ ## Skills
78
+
79
+ | Skill | Version | What it does |
80
+ |-------|---------|--------------|
81
+ | [`top-ppt-html`](./top-ppt-html/) | **0.1.10** | Formal presentation decks: paginated HTML + editable 16:9 PPTX; 3 modes × 9 styles; strict 0/0 gates |
82
+
83
+ Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) is also **0.1.10** (whole-repo same-tag releases).
84
+
85
+ ## Install
86
+
87
+ **npm = pinned snapshot**; **GitHub = track repo HEAD**.
88
+
89
+ ```bash
90
+ npx @topmindspace/tms-skills list
91
+ npx @topmindspace/tms-skills install top-ppt-html
92
+ npx @topmindspace/tms-skills install top-ppt-html --to ./.claude/skills
93
+ npx @topmindspace/tms-skills@0.1.10 install top-ppt-html # pin
94
+ ```
95
+
96
+ ```bash
97
+ # track HEAD
98
+ npx github:topmindspace/tms-skills install top-ppt-html
99
+ ```
100
+
101
+ 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).
102
+
103
+ PPTX export needs `npm install` in the skill folder (pptxgenjs). HTML generation uses Python stdlib only.
104
+
105
+ ## Golden examples
106
+
107
+ | Mode | File |
108
+ |------|------|
109
+ | A Presentation | [`2026-09-09-presentation-business-blue`](./top-ppt-html/assets/examples/2026-09-09-presentation-business-blue.html) |
110
+ | B Research | [`2026-09-09-research-mckinsey`](./top-ppt-html/assets/examples/2026-09-09-research-mckinsey.html) |
111
+ | C Architecture | [`2026-09-09-architecture-graphite-dark`](./top-ppt-html/assets/examples/2026-09-09-architecture-graphite-dark.html) |
112
+ | Product showcase | [`2026-09-26-topmind-tms-skills-showcase`](./top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html) (5 chart types · toolbar page) |
113
+
114
+ ## Repo layout
115
+
116
+ ```
117
+ tms-skills/
118
+ ├─ top-ppt-html/ # skill (SKILL.md + assets + references + scripts)
119
+ ├─ bin/tms-skills.js # CLI: list / install
120
+ ├─ docs/ # publishing · showcase shots · banner · Pages source
121
+ ├─ scripts/ # repo gates / privacy scan
122
+ ├─ package.json # @topmindspace/tms-skills
123
+ └─ LICENSE · CHANGELOG.md · README.md · README.en.md
124
+ ```
125
+
126
+ ## Release & CI
127
+
128
+ | Action | GitHub | npm |
129
+ |--------|:------:|:---:|
130
+ | push main | live | **unchanged** |
131
+ | tag `vX.Y.Z` | Release + zip | **auto publish** |
132
+
133
+ ```bash
134
+ npm run check && npm run audit && npm run privacy
135
+ # PPTX smoke (incl. McKinsey): bash scripts/ci_skill_gates.sh --with-pptx
136
+ ```
137
+
138
+ See [docs/PUBLISHING.md](./docs/PUBLISHING.md) · [docs/ci.md](./docs/ci.md).
139
+
140
+ ## License
141
+
142
+ MIT © TopMindspace — [LICENSE](./LICENSE)
package/README.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # tms-skills
2
2
 
3
+ [English](./README.en.md) | 中文
4
+
3
5
  [![Release](https://img.shields.io/github/v/release/topmindspace/tms-skills?style=flat-square&color=blue)](https://github.com/topmindspace/tms-skills/releases)
4
6
  [![npm](https://img.shields.io/npm/v/@topmindspace/tms-skills?style=flat-square)](https://www.npmjs.com/package/@topmindspace/tms-skills)
5
7
  [![CI](https://img.shields.io/github/actions/workflow/status/topmindspace/tms-skills/ci.yml?style=flat-square&label=CI)](https://github.com/topmindspace/tms-skills/actions/workflows/ci.yml)
@@ -42,11 +44,11 @@
42
44
  |:---:|:---:|:---:|
43
45
  | ![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) |
44
46
 
45
- ### 产品 Showcase 样张（Mode A · ~10 页）
47
+ ### 产品 Showcase 样张（Mode A · 多图 · Header 工具栏）
46
48
 
47
- | Cover | 三模式 | 质量门禁 |
48
- |:---:|:---:|:---:|
49
- | ![cover](docs/showcase/topmind-showcase/showcase-cover.png) | ![modes](docs/showcase/topmind-showcase/showcase-s4.png) | ![gates](docs/showcase/topmind-showcase/showcase-s6.png) |
49
+ | Cover | 三模式 | 质量门禁 | Header 工具栏 |
50
+ |:---:|:---:|:---:|:---:|
51
+ | ![cover](docs/showcase/topmind-showcase/showcase-cover.png) | ![modes](docs/showcase/topmind-showcase/showcase-s4.png) | ![gates](docs/showcase/topmind-showcase/showcase-s8.png) | ![toolbar](docs/showcase/topmind-showcase/showcase-s11.png) |
50
52
 
51
53
  **在线体验**
52
54
 
@@ -57,13 +59,28 @@
57
59
  - 仓库内 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)
58
60
  - 更多截图：[docs/showcase/](./docs/showcase/)
59
61
 
62
+ ### HTML Header 工具栏（打开即用）
63
+
64
+ 生成的演示文稿顶栏提供快捷操作（样张内有专页说明）：
65
+
66
+ | 控件 | 快捷键 | 做什么 |
67
+ |------|--------|--------|
68
+ | 亮暗主题 | **T** | 浅/深切换，按文件记忆，同步 `REPORT_MODEL.theme` |
69
+ | 风格选择 | 9 套 | 九风格实时换肤；交付前写回 `REPORT_MODEL.style` |
70
+ | 预览 PPTX | **P** | 页序列预览 + 可复制精导提示词 |
71
+ | PPT 生成指引 | **H** | 双通道与环境说明 |
72
+ | 全屏 | **F** | 沉浸演示 |
73
+ | 收起工具栏 | **B** | 折叠为迷你条 |
74
+
75
+ 详见 [top-ppt-html/README.md](./top-ppt-html/README.md#html-header-工具栏) · [SKILL.md 交付物](./top-ppt-html/SKILL.md)。
76
+
60
77
  ## 技能一览
61
78
 
62
79
  | 技能 | 版本 | 做什么 |
63
80
  |------|------|--------|
64
- | [`top-ppt-html`](./top-ppt-html/) | **0.1.9** | 正式场合演讲/汇报演示文稿：HTML 可翻页 + 16:9 可编辑 PPTX；三模式 × 九风格；strict 0/0 门禁 |
81
+ | [`top-ppt-html`](./top-ppt-html/) | **0.1.10** | 正式场合演讲/汇报演示文稿：HTML 可翻页 + 16:9 可编辑 PPTX；三模式 × 九风格；strict 0/0 门禁 |
65
82
 
66
- 安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 同为 **0.1.9**（整仓同 tag 发版）。
83
+ 安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 同为 **0.1.10**（整仓同 tag 发版）。
67
84
 
68
85
  ## 安装
69
86
 
@@ -73,7 +90,7 @@
73
90
  npx @topmindspace/tms-skills list
74
91
  npx @topmindspace/tms-skills install top-ppt-html
75
92
  npx @topmindspace/tms-skills install top-ppt-html --to ./.claude/skills
76
- npx @topmindspace/tms-skills@0.1.9 install top-ppt-html # 钉版本
93
+ npx @topmindspace/tms-skills@0.1.10 install top-ppt-html # 钉版本
77
94
  ```
78
95
 
79
96
  ```bash
@@ -92,7 +109,7 @@ PPTX 精导需在技能目录 `npm install`（pptxgenjs）。HTML 生成仅 Pyth
92
109
  | A 演示 | [`2026-09-09-presentation-business-blue`](./top-ppt-html/assets/examples/2026-09-09-presentation-business-blue.html) |
93
110
  | B 研究 | [`2026-09-09-research-mckinsey`](./top-ppt-html/assets/examples/2026-09-09-research-mckinsey.html) |
94
111
  | C 架构 | [`2026-09-09-architecture-graphite-dark`](./top-ppt-html/assets/examples/2026-09-09-architecture-graphite-dark.html) |
95
- | 产品 Showcase | [`2026-09-26-topmind-tms-skills-showcase`](./top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html) |
112
+ | 产品 Showcase | [`2026-09-26-topmind-tms-skills-showcase`](./top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html)（5 种图表 · Header 工具栏专页） |
96
113
 
97
114
  ## 仓库结构
98
115
 
@@ -100,10 +117,10 @@ PPTX 精导需在技能目录 `npm install`（pptxgenjs）。HTML 生成仅 Pyth
100
117
  tms-skills/
101
118
  ├─ top-ppt-html/ # 技能（SKILL.md + assets + references + scripts）
102
119
  ├─ bin/tms-skills.js # CLI：list / install
103
- ├─ docs/ # 发布规范 · showcase 截图 · banner
120
+ ├─ docs/ # 发布规范 · showcase 截图 · banner · Pages 源
104
121
  ├─ scripts/ # 仓库级门禁 / 隐私扫描
105
122
  ├─ package.json # @topmindspace/tms-skills
106
- └─ LICENSE · CHANGELOG.md · README.md
123
+ └─ LICENSE · CHANGELOG.md · README.md · README.en.md
107
124
  ```
108
125
 
109
126
  ## 发布与 CI
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@topmindspace/tms-skills",
3
- "version": "0.1.9",
3
+ "version": "0.1.10",
4
4
  "description": "TopMindspace 智能体技能 monorepo — 通过 npm / GitHub npx 安装技能（top-ppt-html：优雅大气正式场合演讲/汇报演示文稿等）。",
5
5
  "license": "MIT",
6
6
  "author": "TopMindspace",
@@ -27,6 +27,7 @@
27
27
  "files": [
28
28
  "bin",
29
29
  "README.md",
30
+ "README.en.md",
30
31
  "LICENSE",
31
32
  "CHANGELOG.md",
32
33
  "top-ppt-html"
package/top-ppt-html/README.en.md ADDED
@@ -0,0 +1,77 @@
1
+ # TopPPT HTML
2
+
3
+ **[中文](./README.md)** | English
4
+
5
+ [![Release](https://img.shields.io/github/v/release/topmindspace/tms-skills?style=flat-square&color=blue)](https://github.com/topmindspace/tms-skills/releases)
6
+ [![npm](https://img.shields.io/npm/v/@topmindspace/tms-skills?style=flat-square)](https://www.npmjs.com/package/@topmindspace/tms-skills)
7
+ [![CI](https://img.shields.io/github/actions/workflow/status/topmindspace/tms-skills/ci.yml?style=flat-square&label=CI)](https://github.com/topmindspace/tms-skills/actions/workflows/ci.yml)
8
+ [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](../LICENSE)
9
+
10
+ **Let ideas fly — make good thinking visible.** A high-craft skill for **formal presentations**: elegant, atmospheric, stage-ready decks as paginated HTML + layout-faithful editable PPTX. Core craft is layout, typography, color, and content structure — restrained charts/icons, not gadget soup or consulting dumps by default.
11
+
12
+ <p align="center">
13
+ <img src="assets/showcase/showcase-cover.png" alt="TopMind × tms-skills showcase cover" width="720" />
14
+ </p>
15
+
16
+ - Skill id: `top-ppt-html`; brand: **TopPPT HTML**
17
+ - Version: **v0.1.10** (same tag as `@topmindspace/tms-skills@0.1.10`)
18
+ - **Agent entry**: `SKILL.md` → `references/playbook.md` (L1) → L2 on demand
19
+ - **Human maintainers**: this README (install / commands / layout); do not treat it as the generation spec
20
+
21
+ ### Theme overviews (Gate 0)
22
+
23
+ <p align="center">
24
+ <img src="assets/theme-overview.png" alt="Presentation · business-blue" width="860" /><br/>
25
+ <sub>Presentation · business-blue</sub>
26
+ </p>
27
+
28
+ ### Style × mode
29
+
30
+ | business-blue · Presentation | mckinsey · Research | graphite-dark · Architecture |
31
+ |:---:|:---:|:---:|
32
+ | ![bb](assets/showcase/style-business-blue-cover.png) | ![mk](assets/showcase/style-mckinsey-cover.png) | ![gr](assets/showcase/style-graphite-cover.png) |
33
+
34
+ | Dual deliverable | Three modes | Quality gates | Header toolbar |
35
+ |:---:|:---:|:---:|:---:|
36
+ | ![sp](assets/showcase/showcase-split.png) | ![md](assets/showcase/showcase-modes.png) | ![gt](assets/showcase/showcase-gates.png) | ![tb](assets/showcase/showcase-toolbar.png) |
37
+
38
+ **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)
39
+
40
+ - In-repo gallery: [`assets/style-gallery.html`](./assets/style-gallery.html)
41
+ - Product showcase: [`assets/examples/2026-09-26-topmind-tms-skills-showcase.html`](./assets/examples/2026-09-26-topmind-tms-skills-showcase.html) (Mode A · 12 content pages · **5 chart types** · toolbar page)
42
+ - Repo shot pack: [`docs/showcase/`](../docs/showcase/)
43
+
44
+ ## Skill snapshot
45
+
46
+ | Dimension | Capability |
47
+ |-----------|------------|
48
+ | Output | Single-file HTML (paginated, light/dark, **header toolbar T/P/H/F/B + 9 styles**) + 16:9 editable PPTX (precision channel) |
49
+ | Modes | A Presentation · B Research · C Architecture |
50
+ | Styles | 9 packs (`styles.md`) |
51
+ | Charts | Core 8 by default + full registry; variety / anti-truncation / Mode A craft |
52
+ | Quality | `validate_report --strict` · `validate_pptx --strict` · `quality_gate --deliver` |
53
+
54
+ ## HTML header toolbar
55
+
56
+ | Control | Shortcut | Behavior |
57
+ |---------|----------|----------|
58
+ | Theme toggle | **T** | Light / dark; per-file memory; syncs `REPORT_MODEL.theme` |
59
+ | Style picker | 9 styles | Live visual skins; write back `REPORT_MODEL.style` before deliver |
60
+ | PPTX preview | **P** | WYSIWYG sequence + copyable agent prompt |
61
+ | Generation guide | **H** | Dual-channel + environment notes |
62
+ | Fullscreen | **F** | Immersive present |
63
+ | Collapse toolbar | **B** | Mini bar; remembers per file |
64
+
65
+ Also: arrow-key paging; **Esc** closes modals. After style/theme change, re-run `validate_report --strict` (do not rewrite content).
66
+
67
+ ## Install
68
+
69
+ ```bash
70
+ npx @topmindspace/tms-skills install top-ppt-html
71
+ npx @topmindspace/tms-skills@0.1.10 install top-ppt-html
72
+ npx github:topmindspace/tms-skills install top-ppt-html
73
+ ```
74
+
75
+ PPTX needs `npm install` in this folder (pptxgenjs). HTML generation: Python stdlib only.
76
+
77
+ Full Chinese maintainer docs (directory map, command cookbook): see [`README.md`](./README.md). Agent rules live in `SKILL.md` / `playbook.md`.
package/top-ppt-html/README.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # TopPPT HTML
2
2
 
3
+ [English](./README.en.md) | 中文
4
+
3
5
  [![Release](https://img.shields.io/github/v/release/topmindspace/tms-skills?style=flat-square&color=blue)](https://github.com/topmindspace/tms-skills/releases)
4
6
  [![npm](https://img.shields.io/npm/v/@topmindspace/tms-skills?style=flat-square)](https://www.npmjs.com/package/@topmindspace/tms-skills)
5
7
  [![CI](https://img.shields.io/github/actions/workflow/status/topmindspace/tms-skills/ci.yml?style=flat-square&label=CI)](https://github.com/topmindspace/tms-skills/actions/workflows/ci.yml)
@@ -12,7 +14,7 @@
12
14
  </p>
13
15
 
14
16
  - 技能标识：`top-ppt-html`；品牌名：**TopPPT HTML**
15
- - 版本：**v0.1.9**（与 `@topmindspace/tms-skills@0.1.9` 同 tag）
17
+ - 版本：**v0.1.10**（与 `@topmindspace/tms-skills@0.1.10` 同 tag）
16
18
  - **智能体入口**：`SKILL.md` → `references/playbook.md`（L1）→ L2 按需
17
19
  - **人类维护者**：本 README（安装 / 命令 / 目录）；勿把本文件当生成规范
18
20
 
@@ -39,25 +41,40 @@
39
41
  |:---:|:---:|:---:|
40
42
  | ![bb](assets/showcase/style-business-blue-cover.png) | ![mk](assets/showcase/style-mckinsey-cover.png) | ![gr](assets/showcase/style-graphite-cover.png) |
41
43
 
42
- | Showcase · HTML+PPTX | 三模式 | 质量门禁 |
43
- |:---:|:---:|:---:|
44
- | ![sp](assets/showcase/showcase-split.png) | ![md](assets/showcase/showcase-modes.png) | ![gt](assets/showcase/showcase-gates.png) |
44
+ | Showcase · 双交付 | 三模式 | 质量门禁 | Header 工具栏 |
45
+ |:---:|:---:|:---:|:---:|
46
+ | ![sp](assets/showcase/showcase-split.png) | ![md](assets/showcase/showcase-modes.png) | ![gt](assets/showcase/showcase-gates.png) | ![tb](assets/showcase/showcase-toolbar.png) |
45
47
 
46
48
  **在线体验** · [落地页](https://topmindspace.github.io/tms-skills/) · [Showcase 演示文稿](https://topmindspace.github.io/tms-skills/showcase.html) · [风格画廊](https://topmindspace.github.io/tms-skills/style-gallery.html)
47
49
 
48
50
  - 交互画廊（仓库内）：[`assets/style-gallery.html`](./assets/style-gallery.html)
49
- - 产品 Showcase（仓库内）：[`assets/examples/2026-09-26-topmind-tms-skills-showcase.html`](./assets/examples/2026-09-26-topmind-tms-skills-showcase.html)（Mode A · business-blue · ~10 页）
51
+ - 产品 Showcase（仓库内）：[`assets/examples/2026-09-26-topmind-tms-skills-showcase.html`](./assets/examples/2026-09-26-topmind-tms-skills-showcase.html)（Mode A · business-blue · 12 内容页 · **5 种图表** · Header 工具栏专页）
50
52
  - 仓库级大图集：[`docs/showcase/`](../docs/showcase/)（不进技能 zip）
51
53
 
52
54
  ## 一、技能简介（人类速览）
53
55
  | 维度 | 能力 |
54
56
  |------|------|
55
- | 产出 | 单文件 HTML（可翻页、亮暗双主题、header 工具栏）+ 16:9 可编辑 PPTX（精导通道） |
57
+ | 产出 | 单文件 HTML（可翻页、亮暗双主题、**Header 工具栏 T/P/H/F/B + 9 风格**）+ 16:9 可编辑 PPTX（精导通道） |
56
58
  | 三模式 | A 演示 · B 研究 · C 架构（页型/字号/密度契约见 `playbook.md` §一） |
57
59
  | 风格 | 9 套（`styles.md`）；编码色板 c1–c5 随风格 |
58
60
  | 图表 | 核图 8 默认 + registry 全量；多样性 / 反截断 / Mode A 工艺见 playbook + `presentation-craft.md` |
59
61
  | 质量 | `validate_report --strict`（A 隐含 layout-qa）· `validate_pptx --strict` · `quality_gate --deliver` |
60
62
 
63
+ ## HTML Header 工具栏
64
+
65
+ 打开交付的 HTML 即可使用顶栏快捷操作（产品 Showcase 有专页演示）：
66
+
67
+ | 控件 | 快捷键 | 行为 |
68
+ |------|--------|------|
69
+ | 亮暗主题 | **T** | 浅色外发 / 深色大屏；**按文件记忆**；同步 `REPORT_MODEL.theme` |
70
+ | 风格选择 | 9 套下拉 | 九风格实时切换（纯视觉，不动内容）；交付前 `data-style` = `REPORT_MODEL.style` |
71
+ | 预览 PPTX | **P** | 页序列所见即所得；可复制提示词回对话走精导 |
72
+ | PPT 生成指引 | **H** | 双通道说明与环境依赖（与 `?` 同效） |
73
+ | 全屏 | **F** | 沉浸演示 |
74
+ | 收起工具栏 | **B** | 折叠为迷你条；锚点自适应并按文件记忆 |
75
+
76
+ 另：方向键翻页；**Esc** 关闭预览/帮助模态。风格或主题变更后须重跑 `validate_report --strict`（不重写内容）。
77
+
61
78
  生成规范、页型/图表穷举、铁律 **不在本文件**——智能体读 `SKILL.md` / playbook；选型大表见 `page-type-matrix.md` / `chart-decision-tree.md`。
62
79
 
63
80
  **核心架构**：HTML 与 PPTX 出自同一内容模型 `window.REPORT_MODEL`（唯一事实源）；页面只预览不导出，PPTX 由智能体走「精导通道」生成（extract → build → strict 校验）。阈值与几何全部单源化：`scripts/layout-constants.json`（常量）+ `scripts/model-schema.json`（页型 DSL）。
package/top-ppt-html/SKILL.md CHANGED
@@ -4,7 +4,7 @@ description: "Use when 用户要做报告、演示、汇报、PPT、slides、dec
4
4
  license: MIT
5
5
  compatibility: "Python 3 stdlib for HTML generation; Node >=18 + pptxgenjs for PPTX; optional playwright for browser regression / theme captures."
6
6
  metadata:
7
- version: "0.1.9"
7
+ version: "0.1.10"
8
8
  author: TopMindspace
9
9
  ---
10
10
  # TopPPT HTML
@@ -114,20 +114,31 @@ metadata:
114
114
 
115
115
  ## 交付物与验收
116
116
 
117
- - **HTML**：单文件零外链、可翻页可演示、每页一屏高；header 工具栏（T 亮暗 / 9 风格即切 / P 预览 / H 指引 / F 全屏 / B 折叠）。
118
- - **PPTX（B 通道交付）**：`extract_model` → `build_pptx.js` → `validate_pptx --strict`；16:9 全原生可编辑。**A 通道不交付**（仅预览 / `cross_verify`；细则 playbook §九）。
119
- - **验收**：HTML strict 0/0；含 PPTX 再加 PPTX 0/0；失败给**定向修复指引**。
120
- - **交付说明**：`quality_gate.py --deliver`（含 PPTX 带 `--pptx/--model`；子门禁并行）出七要素，缺一 FAIL——勿手拼。
117
+ - **HTML**：零外链可翻页、每页一屏。**Header 工具栏**（样张专页）：
118
+
119
+ | 键 | 控件 | 要点 |
120
+ |----|------|------|
121
+ | **T** | 亮暗 | 按文件记忆；同步 `REPORT_MODEL.theme` |
122
+ | 9 套 | 风格 | 实时换肤；交付前写回 `REPORT_MODEL.style` |
123
+ | **P** | 预览 PPTX | 页序列 + 精导提示词 |
124
+ | **H** | 生成指引 | 双通道说明（=?） |
125
+ | **F**/**B** | 全屏/折叠 | 沉浸演示；迷你条记忆 |
126
+ | 方向键/**Esc** | 翻页/关模态 | PPT 式翻页 |
127
+
128
+ > 改风格/主题后同步 `REPORT_MODEL` 并重跑校验（不重写）。
129
+ - **PPTX（B 通道）**：`extract_model` → `build_pptx.js` → `validate_pptx --strict`；16:9 可编辑。**A 不交付**（仅预览/`cross_verify`；playbook §九）。
130
+ - **验收**：HTML strict 0/0；含 PPTX 再加 PPTX 0/0；失败给定向修复指引。
131
+ - **交付说明**：`quality_gate.py --deliver`（PPTX 带 `--pptx/--model`）出七要素，缺一 FAIL。
121
132
 
122
133
  ## 版本口径
123
134
 
124
- 包 semver（现 0.1.9）≠ 布局 schema 线（layout-constants / model-schema 的 version，现 `0.1`）；patch 不抬 schema。
135
+ 包 semver（现 0.1.10）≠ schema 线（layout-constants / model-schema，现 `0.1`）；patch 不抬 schema。
125
136
 
126
137
  ## 环境依赖
127
138
 
128
- - **零依赖可用**：HTML 生成与全部 Python 脚本只用 **Python 标准库**。
129
- - **PPTX 精导**：另需 Node + pptxgenjs（安装与 `TOP_PPT_NODE_EXE`/`TOP_PPT_NODE_PATH` 探测细节见 `pptx-export.md` 环境备注，探测失败会打印指引）。
130
- - **硬门禁**：标签泄漏/空页/极偏图/简单大图 → `scripts/layout-constants.json`（qualityGates）+ `failure-modes.md`。
131
- - **可选**：浏览器页高/裁切真值、参考图重生成需 playwright（`regression.py` 自动探测，缺失即跳过）。
132
- - **一键回归**：`scripts/regression.py`——模板/常量/schema/运行时/示例改动后必跑。
133
- - **技能自检**：`audit_skill.py`（体积/披露/Gate 0/内容重复）· `audit_docs.py`（§ 引用 + 任务路由可解析）· `audit_styles.py`（9 风格 × 亮暗 token 与对比度）· `audit_css.py`（CSS 类覆盖率 · 报告制）。
139
+ - **零依赖可用**：HTML 与全部 Python 脚本仅用标准库。
140
+ - **PPTX 精导**：Node + pptxgenjs（`TOP_PPT_NODE_EXE`/`TOP_PPT_NODE_PATH`；见 `pptx-export.md`）。
141
+ - **硬门禁**：标签泄漏/空页/极偏图/简单大图 → `layout-constants.json` + `failure-modes.md`。
142
+ - **可选**：页高/裁切真值与参考图重生成需 playwright（`regression.py` 探测，缺失跳过）。
143
+ - **一键回归**：`scripts/regression.py`（模板/常量/schema/运行时/示例改后必跑）。
144
+ - **技能自检**：`audit_skill.py` · `audit_docs.py` · `audit_styles.py` · `audit_css.py`。