dsh-plugin-deck-studio 0.2.3 → 0.2.4

package/README.md

@@ -10,7 +10,10 @@ DSH（DeepSeek Harness）的 **image deck 工作台插件**：左侧原生 Chat
 dsh --profile deckline --from-default-profile web
 
 # 2) 安装本插件（安装后会自动注册 bundle，无需手动改配置文件）
-dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.3
+dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.4
+
+# 国内网络建议走镜像（否则从 npmjs.org 拉 20 MB 包可能很慢）
+npm_config_registry=https://registry.npmmirror.com dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.4
 
 # 3) 启动，浏览器打开终端打印的带 token 链接
 dsh --profile deckline --port 13090
@@ -22,6 +25,8 @@ dsh --profile deckline --port 13090
 dsh --profile deckline --dump-config | grep -c "preset-deck-critic"
 ```
 
+在 npmjs.com 搜 `deckline` 或 `ppt dsh` 也能找到。也可以在 DSH「插件 → 发现」里加索引源 `https://cdn.jsdelivr.net/gh/yuna78/dsh-deck-studio@main/market-index.json` 后点安装。
+
 从源码 / Git 安装、Windows、以及完整配置（数据目录 / deck 源 / 出图节点 / key）见仓库文档：
 
 - [docs/install.md](https://github.com/yuna78/dsh-deck-studio/blob/main/docs/install.md)（中文）

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-plugin-deck-studio",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "private": false,
-  "description": "Deckline：DSH image deck 工作台插件 —— 原生 Chat + 整页图片 deck 工作区 + 设计风格（design）库；出图按页留痕、可点名批量连出，产物本地可追踪。",
+  "description": "Deckline：DSH 的 image deck / PPT 工作台插件——原生 Chat + 整页图片 deck 工作区 + 设计风格库；用对话做 PPT、按页出图、版本可追踪、导出 PDF/PPTX。",
   "license": "MIT",
   "type": "module",
   "main": "./index.js",
@@ -19,7 +19,14 @@
     "image-deck",
     "presentation",
     "slides",
-    "deckline"
+    "ppt",
+    "pptx",
+    "powerpoint",
+    "ai-ppt",
+    "slide-deck",
+    "deckline",
+    "幻灯片",
+    "演示文稿"
   ],
   "engines": {
     "node": "^22.19.0 || >=24.0.0",

package/seeds/docs/compat.md

@@ -79,42 +79,35 @@ agent 工具链路与真出图待下批补验。支持声明暂不收紧到 0.2.
 挂好（脚本直接 `goto` 会误判「工作台没加载」）；等插件 patch 应用完成或先 warm-up 一次再跑自动化。
 `/plugins/events` 仍是导航时 `ERR_ABORTED`，功能正常。
 
-## 本地环境升级记录（2026-10-21 已执行）
+## 升级记录（0.2.1-rc.2，验证机）
 
-**升级前**：全局 `@deepseek-ai/dsh@0.1.7-rc.2`（2026-09-27 安装），本机默认 Node `v23.11.0`，
-运行中的服务靠 `~/.local/bin/dsh` 启动壳固定 Node `v24.21.0`。
-**升级后**：`0.2.1-rc.2`（npm `latest`），启动壳不变（仍固定 Node 24）。
+**升级前**：全局 `@deepseek-ai/dsh@0.1.7-rc.2`；**升级后**：`0.2.1-rc.2`（npm `latest`）。
 
 ```bash
-# 备份（仓库外）
-~/dsh-upgrade-backup-20261020/{profiles.tar.gz, dsh-0.1.7-rc.2/}
-# 用 Node 24 的 npm 升级全局包（保持 /opt/homebrew 前缀，启动壳路径不变）
-~/.nvm/versions/node/v24.21.0/bin/npm i -g --prefix /opt/homebrew @deepseek-ai/dsh@0.2.1-rc.2
-# 重启 deck-studio（进程环境带 relay keys，见下）
-cd <repo> && dsh --profile deck-studio --no-open
+# 建议先备份 profile（仓库外）
+tar -czf ~/dsh-profiles-backup.tgz -C ~/.dsh profiles
+# 升级全局包（Node 需 ^22.19 || >=24）
+npm i -g @deepseek-ai/dsh@0.2.1-rc.2
+# 重启 profile
+dsh --profile deckline --no-open
 ```
 
 **回归结果**：
 
 | 检查项 | 结果 |
 |---|---|
-| `dsh --version`（经启动壳） | ✅ `0.2.1-rc.2` |
-| `--dump-config --profile deck-studio` | ✅ 0 stderr，插件/预设/tools 条目不丢 |
-| deck-studio 启动 13090 | ✅ 正常打印 token，无迁移报错 |
-| 既有数据 | ✅ 迁移成功：decks 5 / designs 11 / 资源库 2 / Conversations 20，会话与治理数据都在 |
-| Deckline 应用 | ✅ 首页 / Design 列表 / Deck 工作台（意图/脚本/Design/日志… + image storyboard） |
-| 出图节点 | ✅ 工作台显示「默认节点 / gpt-image-2.5-sunburst 等 3 个模型」；节点 `/v1/models` 探活 200 |
-| 页面异常 | ✅ 0 pageerror；首次加载有 2 条资源 404，二次加载 0 条（判断为瞬时，记录观察） |
-| `/plugins/events` SSE | ⚠️ 导航时 `ERR_ABORTED`（与隔离测试一致，功能正常，继续观察） |
-
-**升级后必须知道的运行要求**：
-- **启动进程要带 relay keys**：`WOCHENG_API_KEY`（LLM，来自本机 `relays.secret.env` 的 `RELAY_B_WOCHENG_KEY`）
-  与 出图节点 key（profile 里 `apiKeyEnv` 指定的环境变量）。不带 key 时服务能起，但 chat / 出图会失败。
-  本机以 `set -a; . ~/.agents/skills/gpt-image/relays.secret.env; set +a; export WOCHENG_API_KEY="$RELAY_B_WOCHENG_KEY"` 后再启动。
-- 开发用 `web`（3080）进程仍是升级前启动的旧版，下次重启自动用 0.2.1。
-
-**回滚**：`~/.nvm/versions/node/v24.21.0/bin/npm i -g --prefix /opt/homebrew @deepseek-ai/dsh@0.1.7-rc.2`
-（或从备份目录恢复包）→ 解压 `profiles.tar.gz` 覆盖 `~/.dsh/profiles` → 重启。
+| `dsh --version` | ✅ `0.2.1-rc.2` |
+| `--dump-config` | ✅ 0 stderr，插件 / 预设 / tools 条目不丢 |
+| 启动 13090 | ✅ 正常打印 token，无迁移报错 |
+| 既有数据 | ✅ 升级后 decks / designs / 资源库 / Conversations / 治理数据都在 |
+| Deckline 应用 | ✅ 首页 / Design 列表 / Deck 工作台（意图 / 脚本 / Design / 日志… + image storyboard） |
+| 出图节点 | ✅ 节点 `/v1/models` 探活 200 |
+| 页面异常 | ✅ 0 pageerror |
+
+**运行要求**：LLM 与出图节点的 key 由 profile / 环境变量提供（出图节点见 `apiKeyEnv`）。不带 key 时服务能起，
+但 chat / 出图会失败；fake 模式下不配 key 也能走完整流程。
+
+**回滚**：`npm i -g @deepseek-ai/dsh@0.1.7-rc.2` → 解压备份的 `profiles` 覆盖 `~/.dsh/profiles` → 重启。
 
 ## 已知安装失败：缺 DSH 内置包
 

package/seeds/docs/install.en.md

@@ -15,7 +15,7 @@ assets / conversations on the right. It is not a standalone app — it runs on a
 | Node.js | `^22.19` or `≥ 24` | Same as the DSH runtime; Node 23 is not supported |
 | pnpm | 10+ | DSH uses pnpm to manage profile dependencies |
 | DSH | `≥ 0.1.7 < 0.3` | `npm i -g @deepseek-ai/dsh`; verified on 0.1.7-rc.2 / 0.2.1-rc.2, see [compat.md](compat.md) |
-| An LLM provider key | — | e.g. `WOCHENG_API_KEY` (configured in the profile, see DSH docs) |
+| An LLM provider key | — | e.g. `DEEPSEEK_API_KEY` / `OPENAI_API_KEY` (configured in the profile, see DSH docs) |
 | An image node key | — | For real renders; the fake mode lets you try the flow first (section 4) |
 
 ```sh

package/seeds/docs/install.md

@@ -16,7 +16,7 @@ Deckline（`dsh-plugin-deck-studio`）是 DeepSeek Harness（DSH）的 **image d
 | Node.js | `^22.19` 或 `≥ 24` | 与 DSH 运行时一致；Node 23 不在支持范围 |
 | pnpm | 10+ | DSH 用 pnpm 管理 profile 依赖 |
 | DSH | `≥ 0.1.7 < 0.3`（0.1.5 不支持） | **用 npm 全局安装的发行版**：`npm i -g @deepseek-ai/dsh@0.2.1-rc.2`；已验证 0.2.1-rc.2，见 [compat.md](compat.md)。从源码自编译的 dsh 若缺内置包（如 `@deepseek-ai/dsh-agent-preset`）会启动失败，见 4.3 |
-| 一个 LLM provider key | — | 例：`WOCHENG_API_KEY`（profile 里配置，见 DSH 文档） |
+| 一个 LLM provider key | — | 例：`DEEPSEEK_API_KEY` / `OPENAI_API_KEY`（profile 里配置，见 DSH 文档） |
 | 一个 image 节点 key | — | 生成整页图用；可先用 fake 模式体验（见第 4 节） |
 
 ```sh
@@ -27,14 +27,48 @@ node -v && pnpm -v && dsh --version
 
 ### A. 从 npm 安装（推荐，所有人同一条命令）
 
+> 在 [npmjs.com](https://www.npmjs.com/) 搜 `deckline` 或 `ppt dsh` 也能找到本包（关键词已含 PPT / PPTX / PowerPoint / 幻灯片）。
+
 ```sh
 # 1) 建一个 deckline profile（基于 DSH 自带 web 模板）
 dsh --profile deckline --from-default-profile web
 
 # 2) 装插件；dsh plugin add 会自动把组合包加入 profile 并默认启用
-dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.3
+dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.4
 ```
 
+> 国内网络直连 `registry.npmjs.org` 可能很慢（20 MB 包实测约 19 KB/s，要十几分钟）。换镜像会快很多：
+> ```sh
+> npm_config_registry=https://registry.npmmirror.com dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.4
+> ```
+> 或一次性 `npm config set registry https://registry.npmmirror.com`。
+
+### A2. 从 DSH 插件市场安装（图形化，等价于 A）
+
+DSH 目前没有官方插件市场，市场是「索引源」模式：添加下面这个索引，就能在「插件 → 发现」里搜到 Deckline 并安装。
+
+1. 侧栏 **插件** → 「实验性插件」旁 **更多** → 启用 **自定义插件市场**；重新打开插件页，出现 **发现** 标签。
+2. **发现** → **添加索引源**，填：
+
+   ```
+   https://cdn.jsdelivr.net/gh/yuna78/dsh-deck-studio@main/market-index.json
+   ```
+
+   国内网络用上面这条；能直连 GitHub 也可以用：
+
+   ```
+   https://raw.githubusercontent.com/yuna78/dsh-deck-studio/main/market-index.json
+   ```
+
+3. 搜索 `Deckline` 或 `PPT` → **安装**，会安装 `dsh-plugin-deck-studio@0.2.4`（索引里声明了国内镜像 registry）。
+4. 之后同 A 的第 3 步启动。
+
+索引文件就是仓库根目录的 [`market-index.json`](../market-index.json)（格式 1），新版本发布后更新版本号即可。
+
+> 注意：DSH 的实验性插件市场是可选组件，版本需与当前 DSH 配套。若「发现」页提示市场组件不兼容（或插件被自动禁用），
+> 直接用上面的 A（npm 命令）安装，效果相同。
+
+
 ### B. 从 Git 仓库安装（可选；仓库未公开时需要 GitHub 权限）
 
 ```sh