@capyclaw/ppt-suite 0.0.0-stage → 2.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CapyClaw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,90 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# dsh-ppt-suite（PPT 工作台套件）
+
+一键安装的入口包。内部包含 PPT 运行时、技能、文档工作台框架和 4 个公共基建插件，套件负责锁定兼容版本。
+
+```text
+dsh-ppt-suite
+├─ dsh-service-host    公共基建：HTTP 宿主/健康/指标/锁/复用
+├─ dsh-tool-host       公共基建：能力 DSL/注册表/契约/MCP
+├─ dsh-asset-service   公共基建：sha256 对象资产/`/assets`
+├─ dsh-editor-host     公共基建：编辑器托管/租约/心跳
+├─ dsh-document-workbench 文档框架库：会话/命令/桥路由/编辑器客户端（非 row）
+├─ dsh-ppt-workbench   运行时：relay + editor + 18 个 ppt_* MCP 工具
+├─ dsh-ppt-skill-ppt          路由
+├─ dsh-ppt-skill-narrative    叙事
+├─ dsh-ppt-skill-design       审美
+├─ dsh-ppt-skill-api          工具手册
+├─ dsh-ppt-skill-authoring    成稿
+├─ dsh-ppt-skill-editing      纯执行
+├─ dsh-ppt-skill-visual-check 审计
+└─ dsh-ppt-skill-research     研究
+```
+
+安装后这 4 个公共插件会作为独立 row 出现在 profile 中；`dsh-ppt-suite` 通过
+`components` 引用它们自己的 suite manifest，不再复制 packages/rows。`dsh-ppt-workbench` 优先通过
+`ctx.serviceHost` / `ctx.toolHost` / `ctx.assets` / `ctx.editorHost`
+使用它们，独立运行时再回退到 `server/shared` 快照。
+
+PPT 的 journal/checkpoint 由 `server/store/*` + `dsh-document-workbench` 直接落盘，
+不依赖 `ctx.state`，因此套件不安装 `dsh-state-service`。
+
+组合层是标准件 `packages/dsh-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/dsh-suite-kit/bin/dsh-suite.mjs validate bridges/ppt-bridge/plugin/dsh-ppt-suite
+node packages/dsh-suite-kit/bin/dsh-suite.mjs compose bridges/ppt-bridge/plugin/dsh-ppt-suite --out /tmp/ppt-suite
+node packages/dsh-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 行。再单独安装 `dsh-ppt-workbench` 或任一 `dsh-ppt-skill-*` 会产生重复的 `ppt-workbench-host` / `ppt-skill-*` 行。二选一：
+
+- 普通用户：只装 `dsh-ppt-suite`；
+- 开发者：单独装 `dsh-ppt-workbench` / 某个 `dsh-ppt-skill-*`，方便分别调试。
+
+## 版本策略
+
+PPT 包组版本同步从 `2.2.0` 起步；4 个公共基建插件独立版本（当前 `^0.1.0`），由套件锁定兼容范围：
+
+- Workbench 工具契约不兼容变化 → contract major +1，workbench 与 8 个 skill 包 major 同步；
+- 单个 skill 只改文案/流程 → 该 `dsh-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
+```

package/composition.lock.json

@@ -0,0 +1,108 @@
+{
+  "suite": "capyclaw-ppt-suite",
+  "suiteVersion": "2.4.0",
+  "packages": {
+    "dsh-asset-service": {
+      "version": "0.1.0",
+      "apiVersion": "1.0.0",
+      "path": "..\\..\\..\\..\\..\\packages\\dsh-asset-service",
+      "sha256": "ffcbe90232fd02526a33e5347a6d83a04c2c46dda8500a50a14854a65bce1f19"
+    },
+    "dsh-document-workbench": {
+      "version": "0.1.0",
+      "apiVersion": null,
+      "path": "../../../../../packages/dsh-document-workbench",
+      "sha256": "98cbdb74f92d517848ff457ea7707b956cf74fdc065734af8ee26a713009540f"
+    },
+    "dsh-editor-host": {
+      "version": "0.1.0",
+      "apiVersion": "1.0.0",
+      "path": "..\\..\\..\\..\\..\\packages\\dsh-editor-host",
+      "sha256": "390cfe391b2ec8123155061a1cd01dce60b84212e4ad0753981aed3e0dff6959"
+    },
+    "dsh-plugin-kit": {
+      "version": "0.2.0",
+      "apiVersion": null,
+      "path": "../../../../../packages/dsh-plugin-kit",
+      "sha256": "d07757e4cc0fd37363bc51c8e1b3cb9566be13c483b71e219041d0c435ae757a"
+    },
+    "dsh-ppt-skill-api": {
+      "version": "2.2.0",
+      "apiVersion": null,
+      "path": "../dsh-ppt-skill-api",
+      "sha256": "cc71305324660e7d2ac65c6617336cb579bd02318c71c02e7e71251cb59e4b8f"
+    },
+    "dsh-ppt-skill-authoring": {
+      "version": "2.2.0",
+      "apiVersion": null,
+      "path": "../dsh-ppt-skill-authoring",
+      "sha256": "90adb2540d0606b27578af7fdbc04cee35a089cd5db1d6363113f689e6d1e74d"
+    },
+    "dsh-ppt-skill-design": {
+      "version": "2.2.0",
+      "apiVersion": null,
+      "path": "../dsh-ppt-skill-design",
+      "sha256": "922d081b35ac7053a479bf327f4309d208e09bd5c7f8982a92deecd7b97767a1"
+    },
+    "dsh-ppt-skill-editing": {
+      "version": "2.2.0",
+      "apiVersion": null,
+      "path": "../dsh-ppt-skill-editing",
+      "sha256": "15e3f7ea5247553b763992d80fce3b7b3f544400ee3284fc2b65f11b1862e36f"
+    },
+    "dsh-ppt-skill-narrative": {
+      "version": "2.2.0",
+      "apiVersion": null,
+      "path": "../dsh-ppt-skill-narrative",
+      "sha256": "e52c7988f9862876e1009030443307bef29656399ff2a4e215ec15892e984e76"
+    },
+    "dsh-ppt-skill-ppt": {
+      "version": "2.2.0",
+      "apiVersion": null,
+      "path": "../dsh-ppt-skill-ppt",
+      "sha256": "981e93c969e620ca6b3f0012cd4500d20acb8242d3bf5596ef1fe75145877f60"
+    },
+    "dsh-ppt-skill-research": {
+      "version": "2.2.0",
+      "apiVersion": null,
+      "path": "../dsh-ppt-skill-research",
+      "sha256": "636281492b1c9368b9d546c1043a2bc2d5e925ed49e704a3d35e42cd14e61f11"
+    },
+    "dsh-ppt-skill-visual-check": {
+      "version": "2.2.0",
+      "apiVersion": null,
+      "path": "../dsh-ppt-skill-visual-check",
+      "sha256": "2f2a264fb1356b3441a5ef5ac750d85ee998e13b73601063b8e6b8b3e7d57742"
+    },
+    "dsh-ppt-workbench": {
+      "version": "2.4.0",
+      "apiVersion": null,
+      "path": "../dsh-ppt-workbench",
+      "sha256": "168e7d8b753c3b199beae9bacd9e73aae10a1eafb96da2f7e211b6aa59053af6"
+    },
+    "dsh-service-broker": {
+      "version": "0.1.0",
+      "apiVersion": "1.0.0",
+      "path": "../../../../../packages/dsh-service-broker",
+      "sha256": "497e55304f2869e5be0cb915e527bcf2e81f81c6b4ef6fd41dbc28153f10153c"
+    },
+    "dsh-service-host": {
+      "version": "0.1.0",
+      "apiVersion": "1.0.0",
+      "path": "..\\..\\..\\..\\..\\packages\\dsh-service-host",
+      "sha256": "23a19887598819f0f62355bb5771afac9c425406773b5afe1664b32b00674604"
+    },
+    "dsh-skills-service": {
+      "version": "0.1.0",
+      "apiVersion": null,
+      "path": "../../dsh-skills-service",
+      "sha256": "c3645d7f64e88ce1868d9a6741375ceffbe42c7468ba1773697d8d7e1e63a30e"
+    },
+    "dsh-tool-host": {
+      "version": "0.1.0",
+      "apiVersion": "1.0.0",
+      "path": "..\\..\\..\\..\\..\\packages\\dsh-tool-host",
+      "sha256": "6d40f9e0b1f9427552df6b14c2f9ad64c77d5f6ce3493160ca667e85d9160b29"
+    }
+  }
+}