@capyclaw/ppt-suite（PPT 工作台套件）
一键安装的入口包。内部包含 PPT 运行时、技能、文档工作台框架和 4 个公共基建插件，套件负责锁定兼容版本。
dsh-ppt-suite
├─ @capyclaw/service-host 公共基建：HTTP 宿主/健康/指标/锁/复用
├─ @capyclaw/tool-host 公共基建：能力 DSL/注册表/契约/MCP
├─ @capyclaw/asset-service 公共基建：sha256 对象资产/`/assets`
├─ @capyclaw/editor-host 公共基建：编辑器托管/租约/心跳
├─ @capyclaw/document-workbench 文档框架库：会话/命令/桥路由/编辑器客户端（非 row）
├─ @capyclaw/ppt-workbench 运行时：relay + editor + 18 个 ppt_* MCP 工具
├─ @capyclaw/ppt-skill-ppt 路由
├─ @capyclaw/ppt-skill-narrative 叙事
├─ @capyclaw/ppt-skill-design 审美
├─ @capyclaw/ppt-skill-api 工具手册
├─ @capyclaw/ppt-skill-authoring 成稿
├─ @capyclaw/ppt-skill-editing 纯执行
├─ @capyclaw/ppt-skill-visual-check 审计
└─ @capyclaw/ppt-skill-research 研究
安装后这 4 个公共插件会作为独立 row 出现在 profile 中；@capyclaw/ppt-suite 通过
components 引用它们自己的 suite manifest，不再复制 packages/rows。capyclaw-ppt-workbench 优先通过
ctx.serviceHost / ctx.toolHost / ctx.assets / ctx.editorHost
使用它们，独立运行时再回退到 server/shared 快照。
PPT 的 journal/checkpoint 由 server/store/* + @capyclaw/document-workbench 直接落盘，
不依赖 ctx.state，因此套件不安装 @capyclaw/state-service。
组合层是标准件 packages/capyclaw-suite-kit 的第一个实例：
dsh-suite.json是唯一真源（packages / rows / checks / 端口 / 能力）；cordis.patch.yml由 manifest 生成，不手写；- 安装、组合、doctor 都用同一套 CLI，后续别的组合可以复用。
安装
# 本地开发（推荐；在 bridges/ppt-bridge 下执行）：
cd bridges/ppt-bridge
node scripts/install-plugin-suite.mjs --profile web
# 会建 suite/公共插件/workbench/skills 的 junction 并清旧 patch 块
# 发布/打包后也可走 dsh 插件安装
dsh plugin --profile <profile> install /path/to/dsh-ppt-suite
安装后：
- MCP 工具组
mcp__ppt__*出现； - 本机 39311 端口起 relay；
- 浏览器打开
http://127.0.0.1:39311/即为实时编辑器； - 会话 skill 目录出现 8 个 PPT skill。
标准件命令
# 在 workspace 根目录
node packages/capyclaw-suite-kit/bin/dsh-suite.mjs validate bridges/ppt-bridge/plugin/dsh-ppt-suite
node packages/capyclaw-suite-kit/bin/dsh-suite.mjs compose bridges/ppt-bridge/plugin/dsh-ppt-suite --out /tmp/ppt-suite
node packages/capyclaw-suite-kit/bin/dsh-suite.mjs doctor --profile web \
--dsh-bin core-harness/deepseek-harness/node_modules/.bin/dsh.cmd
doctor 会检查 ppt-health 和 ppt-contract（contractVersion major=2），并检查组合后 row id 是否重复。
不要重复装
套件已经包含 workbench 和 8 个 skill 包的 patch 行。再单独安装 capyclaw-ppt-workbench 或任一 capyclaw-ppt-skill-* 会产生重复的 ppt-workbench-host / ppt-skill-* 行。二选一：
- 普通用户：只装
@capyclaw/ppt-suite； - 开发者：单独装
capyclaw-ppt-workbench/ 某个capyclaw-ppt-skill-*，方便分别调试。
版本策略
PPT 包组版本同步从 2.2.0 起步；4 个公共基建插件独立版本（当前 ^0.1.0），由套件锁定兼容范围：
- Workbench 工具契约不兼容变化 → contract major +1，workbench 与 8 个 skill 包 major 同步；
- 单个 skill 只改文案/流程 → 该
capyclaw-ppt-skill-*单独升 minor/patch； - 公共插件升级 → 同步更新
server/shared/快照并重新验证 PPT； - 本地开发用
scripts/install-plugin-suite.mjs建 suite/公共插件/workbench/8 个 skill 包的 junction；发布到 npm 时依赖按各自版本正常安装。
验证
# 在 ppt-bridge 根目录
node scripts/build-plugin.mjs
node --test test/plugin.test.mjs test/skills.test.mjs test/packages.test.mjs