# @capyclaw/ppt-suite 中文文档

规范地址：https://npmcn.com/package/%40capyclaw/ppt-suite/

版本：2\.4\.10
npm 元数据更新时间：2026-11-05T13:07:34.279Z
中文译文更新时间：2026-11-09T17:57:51.155Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40capyclaw/ppt-suite
原文对照：https://npmcn.com/package/%40capyclaw/ppt-suite/?lang=original
项目主页：https://github.com/capyclaw/dsh-plugins
源码仓库：https://github.com/Maple496/capyclaw

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：62.9 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：16 个
- 首次发布：2026-11-04T13:02:56.328Z
- 最新版本发布：2026-11-05T13:07:33.956Z
- 近 30 天下载量：2035（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

PPT 工作台套件：workbench + 8 个独立 skill 包 + 4 个公共基建插件，一键安装、锁定已验证版本。

## 安装

```sh
npm install @capyclaw/ppt-suite
```

也可以使用：`pnpm add @capyclaw/ppt-suite`、`yarn add @capyclaw/ppt-suite`、`bun add @capyclaw/ppt-suite`

## README

# @capyclaw/ppt-suite（PPT 工作台套件）

一键安装的入口包。内部包含 PPT 运行时、技能、文档工作台框架和 4 个公共基建插件，套件负责锁定兼容版本。

```text
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，后续别的组合可以复用。

## 安装

```bash
# 本地开发（推荐；在 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。

## 标准件命令

```bash
# 在 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 时依赖按各自版本正常安装。

## 验证

```bash
# 在 ppt-bridge 根目录
node scripts/build-plugin.mjs
node --test test/plugin.test.mjs test/skills.test.mjs test/packages.test.mjs
```

## 常见问题

### @capyclaw/ppt-suite 是什么？

PPT 工作台套件：workbench \+ 8 个独立 skill 包 \+ 4 个公共基建插件，一键安装、锁定已验证版本。

### 如何安装 @capyclaw/ppt-suite？

在项目目录运行 npm install @capyclaw/ppt-suite，或使用 pnpm add / yarn add / bun add。

### @capyclaw/ppt-suite 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/capyclaw\_\_ppt-suite 是否存在。

### @capyclaw/ppt-suite 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @capyclaw/ppt-suite 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @capyclaw/ppt-suite 可以商用吗？

@capyclaw/ppt-suite 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @capyclaw/ppt-suite 的下载量有多少？

根据 npm 官方下载统计，@capyclaw/ppt-suite 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,035 次，日均约 68 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @capyclaw/ppt-suite 还在维护吗？

最新版本 2\.4\.10 发布于 2026/11/05（4 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/11/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。