dsh-pstack 0.2.0 → 0.2.2

package/README.md

@@ -15,13 +15,13 @@
 <p align="center">
   <a href="https://npmx.dev/package/dsh-pstack"><img src="https://img.shields.io/npm/v/dsh-pstack?style=flat-square&colorA=080f12&colorB=1fa669" alt="npm version" /></a>
   <a href="https://npmx.dev/package/dsh-pstack"><img src="https://img.shields.io/npm/dm/dsh-pstack?style=flat-square&colorA=080f12&colorB=1fa669" alt="npm downloads" /></a>
-  <a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/dsh-0.2.2--alpha.2-1f6feb?style=flat-square" alt="dsh 0.2.2-alpha.2" /></a>
+  <a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/dsh-%3E%3D0.2.1--rc.5-1f6feb?style=flat-square" alt="dsh >=0.2.1-rc.5" /></a>
   <a href="https://github.com/cursor/plugins/tree/main/pstack"><img src="https://img.shields.io/badge/pstack-0.15.36-d97706?style=flat-square" alt="pstack 0.15.36" /></a>
 </p>
 
 <p align="center">
   <a href="https://github.com/l246804/dsh-pstack/blob/main/LICENSE"><img src="https://img.shields.io/github/license/l246804/dsh-pstack?style=flat-square&colorA=080f12&colorB=1fa669" alt="license" /></a>
-  <a href="https://bundlephobia.com/result?p=dsh-pstack"><img src="https://img.shields.io/bundlephobia/minzip/dsh-pstack?style=flat-square&colorA=080f12&colorB=1fa669&label=minzip" alt="minzip size" /></a>
+  <a href="https://npmx.dev/package/dsh-pstack"><img src="https://img.shields.io/npm/unpacked-size/dsh-pstack?style=flat-square&colorA=080f12&colorB=1fa669" alt="unpacked size" /></a>
   <a href="https://www.jsdocs.io/package/dsh-pstack"><img src="https://img.shields.io/badge/jsdocs-reference-080f12?style=flat-square&colorA=080f12&colorB=1fa669" alt="JSDocs" /></a>
 </p>
 
@@ -30,7 +30,7 @@
     <tr>
       <td align="center"><strong>58</strong><br /><sub>pstack skills</sub></td>
       <td align="center"><strong>23</strong><br /><sub>playbooks</sub></td>
-      <td align="center"><strong>4</strong><br /><sub>native tools</sub></td>
+      <td align="center"><strong>5</strong><br /><sub>native tools</sub></td>
       <td align="center"><strong>2</strong><br /><sub>agent presets</sub></td>
       <td align="center"><strong>5</strong><br /><sub>bundled scripts</sub></td>
     </tr>
@@ -42,10 +42,11 @@
   <a href="#capabilities">Capabilities</a> ·
   <a href="#skills-directory">Skills directory</a> ·
   <a href="#optional-dsh-plugins">Optional DSH plugins</a> ·
-  <a href="#compatibility">Compatibility</a>
+  <a href="#compatibility">Compatibility</a> ·
+  <a href="#friendly-links">Friendly Links</a>
 </p>
 
-`dsh-pstack` ports [pstack](https://github.com/cursor/plugins/tree/main/pstack) to [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH). It keeps the upstream pstack skills, playbooks, and reference documents. Four native tools replace the interfaces that DSH lacks, while an adaptation layer maps Cursor's tool names, subagent fields, model slugs, and paths to DSH.
+`dsh-pstack` ports [pstack](https://github.com/cursor/plugins/tree/main/pstack) to [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH). It keeps the upstream pstack skills, playbooks, and reference documents. Five native tools fill the gaps in DSH's interfaces, while an adaptation layer maps Cursor's tool names, subagent fields, model slugs, and paths to DSH.
 
 Most upstream pstack skills declare `disable-model-invocation: true`. `poteto-mode` routes to those hidden skills by name, but DSH's `skill` tool only exposes the model-visible catalog. DSH also has no equivalents for Cursor's model slugs, `subagent_type`, `readonly`, and Bun scripts. dsh-pstack handles those differences in the plugin layer. You can start with `/poteto-mode` after installation.
 
@@ -96,6 +97,7 @@ See [`pstack/README.md`](./pstack/README.md) for the full capability map, gaps,
 |---|---|
 | `pstack_skill` | Loads a hidden skill registered by this plugin by name, and reads relative resources inside the skill directory. |
 | `pstack_models` | Read-only list of the providers, models, and efforts DSH actually offers, used by `/setup-pstack`. |
+| `pstack_roles` | Read-only list of every pstack role's shape and whether it is an automatic panel, so a `pstack_subagent` call passes the right `roleIndex`. |
 | `pstack_subagent` | Reads `$DSH_HOME/pstack-models.mdc` per role, parses `provider/model [effort]`, selects a preset by `agent`, and can start several subagents at once. |
 | `pstack_script` | Runs bundled Node scripts by fixed id without Bun or shell scripts. |
 
@@ -124,7 +126,7 @@ Open **Plugins → Installed plugins → dsh-pstack** and click **Configure** in
 
 ## Optional DSH plugins
 
-DSH ships with the following plugins, which are disabled by default. dsh-pstack does not require them during installation. Some pstack flows need these plugins to run end to end. To enable a plugin, enter its package name in **Add plugin** on the Plugins page. Alternatively, run `dsh plugin --profile <profile> add <package>`, then restart the profile. Except for `@deepseek-ai/dsh-mcp-client`, the bundles and providers here are experimental.
+DSH provides the following optional plugins, which are disabled by default. Most ship with DSH; `@deepseek-ai/dsh-cua-bundle` installs on demand. dsh-pstack does not require them during installation. Some pstack flows need these plugins to run end to end. To enable a plugin, enter its package name in **Add plugin** on the Plugins page. Alternatively, run `dsh plugin --profile <profile> add <package>`, then restart the profile. Except for `@deepseek-ai/dsh-mcp-client`, the bundles and providers here are experimental.
 
 > [!NOTE]
 > Without an optional plugin, the pstack skills still load. Steps that need the plugin print `Skipped in DeepSeek Harness: <step>. <reason>.` and continue. Missing `gh`, Java/TLC, or video tools also cause the corresponding steps to report blocked or degrade to screenshots. dsh-pstack never marks an unrun step as passed.
@@ -135,7 +137,7 @@ DSH ships with the following plugins, which are disabled by default. dsh-pstack
 |---|---|---|
 | `@deepseek-ai/dsh-experimental-session-search` | Five read-only tools search and trace historical Sessions for `/recall`, `/reflect`, and `/show-me-your-work`: `session_search`, `session_event_search`, `session_trace`, `session_event_trace`, and `session_event_read`. | Matches only Sessions with the same `cwd`; use `session_event_search` for the current Session; there is no Cursor `.jsonl` transcript path. |
 | `@deepseek-ai/dsh-experimental-worktree`<br />`@deepseek-ai/dsh-experimental-tool-worktree` | `create_worktree` creates a local branch and worktree and switches the current Session directory, isolating parallel candidates for `/arena`, `/swarm`, and `/architect`. | `from` reads only local refs and does not fetch; there is no cloud VM; creating worktrees repeatedly changes `cwd`; it does not automatically give each subagent its own tree. |
-| `@deepseek-ai/dsh-experimental-forge-bundle` | PR panel, checks, review, mark ready, merge, and Session binding, plus starting a Session from the composer with a new worktree, serving `/babysit`, `/shipping`, and `/autopilot-*`. | GitHub only, requires `gh` login; there is no take tool on the model side; there is no stack verdict or `origin` CLI; it can coexist with the worktree bundle. |
+| `@deepseek-ai/dsh-experimental-forge-bundle` | PR panel, checks, review, mark ready, merge, and Session binding, plus starting a Session from the composer with a new worktree, serving `/babysit`, `/shipping`, and `/autopilot-*`. | GitHub only, requires `gh` login; there is no model-side change-request tool; there is no stack verdict or `origin` CLI; it can coexist with the worktree bundle. |
 
 ### Verification and evidence
 
@@ -143,16 +145,16 @@ Choose one of three browser providers: `@deepseek-ai/dsh-experimental-browser-us
 
 | Plugin | Capability when enabled | Boundaries and conflicts |
 |---|---|---|
-| `@deepseek-ai/dsh-browser-use` + one provider | Navigation, clicking, typing, screenshots, and ARIA snapshots; Stagehand also provides act, find, and extract, for verification skills and UI reproduction. | The base package does nothing without a provider; one provider per Session; screenshots need an image model; no video; Stagehand needs Chromium and a non-DeepSeek model. |
-| `@deepseek-ai/dsh-cua-bundle` | macOS app clicking, typing, screenshots, and permission pages, for desktop app verification. | macOS PTC only; Windows is incomplete; no video. |
-| `@deepseek-ai/dsh-experimental-terminal-bundle` | Six global terminal tools that keep a shell or REPL alive across calls and support background send, for CLI and TUI verification. | Terminal only; added to every Agent; persistent state must be cleaned up; switching invalidates the KV cache. |
+| `@deepseek-ai/dsh-browser-use` + one provider | Navigation, clicking, typing, screenshots, and ARIA snapshots; Stagehand also provides act, observe, and extract, for verification skills and UI reproduction. | The base package does nothing without a provider; one provider per Session; screenshots need an image-capable model; no video; Stagehand needs Chromium and a non-DeepSeek model. |
+| `@deepseek-ai/dsh-cua-bundle` | macOS app clicking, typing, screenshots, permission pages, and session-level authorization, for desktop app verification. | macOS PTC only; single computer-use provider slot; Windows is incomplete; no video. |
+| `@deepseek-ai/dsh-experimental-terminal-bundle` | Six global terminal tools that keep a shell or REPL alive across calls, support background send, and isolate terminals by owner, for CLI and TUI verification. | Terminal only; added to every Agent; persistent state must be cleaned up; switching invalidates the KV cache. |
 | `@deepseek-ai/dsh-mcp-client` | Mounts MCP servers; tools appear as `mcp__<server>__<tool>`, and `mcp-resources` lists servers with resources, serving evidence investigation for `/why` and `/teach`. | No default server; configuration is per server; no automatic category discovery. |
 
 ### Multi-agent
 
 | Plugin | Capability when enabled | Boundaries and conflicts |
 |---|---|---|
-| `@deepseek-ai/dsh-experimental-agent-team-profile` | Lead and teammate roles, a shared task board, nine team tools, and a Web roster, serving `/orchestrate` and `/autopilot-*`. | Disables `subagent` and `subagent_fork`. Conflicts with `pstack_subagent`. See the warning below. |
+| `@deepseek-ai/dsh-experimental-agent-team-profile` | Lead and teammate roles, a shared task board, nine team tools, and a Web roster, serving `/orchestrate` and `/autopilot-*`. | Disables `subagent` and `subagent_fork`. Conflicts with `pstack_subagent`. There is no pstack PR frontier, ledger, or stack verdict. See the warning below. |
 | `@deepseek-ai/dsh-experimental-ralph-bundle` | Global `ralph`, a foreground loop with a fresh child each round, serving `/autonomous-run`. | Not a persistent loop in the same Session; no event watcher; does not replace goals, heartbeats, or the decision log. |
 
 > [!WARNING]
@@ -163,7 +165,7 @@ Choose one of three browser providers: `@deepseek-ai/dsh-experimental-browser-us
 | Item | Version | Notes |
 |---|---|---|
 | DSH | `>=0.2.1-rc.5` | Minimum supported version; verified through the `0.2.2-alpha.2` baseline |
-| pstack | `0.15.36` | Upstream baseline commit `4dd1d05` |
+| pstack | `0.15.36` | Upstream baseline commit `ae5650f` |
 | Node.js | `>=24.21.1` | Runtime requirement |
 | Cordis | `~4.0.6-alpha.1` | Peer dependency |
 
@@ -183,7 +185,11 @@ A worktree Session has a different `cwd` from the original Session. The session-
 
 Upstream pstack adapts Claude Code with `docs/harness/claude-code.md`. It preserves the skill bodies. A separate host adaptation table maps `Task`, `AskQuestion`, todo, model slugs, and paths to the target host. The generator adds a one-line Claude Code adaptation note to skills that use Cursor names. Unsupported capabilities report `Skipped in Claude Code: <step>. <reason>.`
 
-dsh-pstack follows the same approach. The main adaptation document is [`pstack/harness/docs/harness/dsh.md`](./pstack/harness/docs/harness/dsh.md). It covers Tools, Subagent fields, Models, setup-pstack, Paths, and Cursor-only features. The `pstack_*` tools, agent presets, and Node scripts replace fields that DSH lacks. At build time, upstream pstack and the local adaptation tree are rendered into `pstack/pstack/`, then packaged with `src/*.ts` and `skills/` into `dist/`.
+dsh-pstack follows the same approach. The main adaptation document is [`pstack/harness/docs/harness/dsh.md`](./pstack/harness/docs/harness/dsh.md). It covers Tools, Subagent fields, Models, setup-pstack, Paths, Cursor-only features, Local replacements, and Optional plugins. The `pstack_*` tools, agent presets, and Node scripts replace fields that DSH lacks. At build time, upstream pstack and the local adaptation tree are rendered into `pstack/pstack/`, then packaged with `src/*.ts` and `skills/` into `dist/`.
+
+## Friendly Links
+
+[LinuxDo](https://linux.do/) — the new ideal community
 
 ## Credits
 

package/README.zh.md

@@ -15,13 +15,13 @@
 <p align="center">
   <a href="https://npmx.dev/package/dsh-pstack"><img src="https://img.shields.io/npm/v/dsh-pstack?style=flat-square&colorA=080f12&colorB=1fa669" alt="npm version" /></a>
   <a href="https://npmx.dev/package/dsh-pstack"><img src="https://img.shields.io/npm/dm/dsh-pstack?style=flat-square&colorA=080f12&colorB=1fa669" alt="npm downloads" /></a>
-  <a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/dsh-0.2.2--alpha.2-1f6feb?style=flat-square" alt="dsh 0.2.2-alpha.2" /></a>
+  <a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/dsh-%3E%3D0.2.1--rc.5-1f6feb?style=flat-square" alt="dsh >=0.2.1-rc.5" /></a>
   <a href="https://github.com/cursor/plugins/tree/main/pstack"><img src="https://img.shields.io/badge/pstack-0.15.36-d97706?style=flat-square" alt="pstack 0.15.36" /></a>
 </p>
 
 <p align="center">
   <a href="https://github.com/l246804/dsh-pstack/blob/main/LICENSE"><img src="https://img.shields.io/github/license/l246804/dsh-pstack?style=flat-square&colorA=080f12&colorB=1fa669" alt="license" /></a>
-  <a href="https://bundlephobia.com/result?p=dsh-pstack"><img src="https://img.shields.io/bundlephobia/minzip/dsh-pstack?style=flat-square&colorA=080f12&colorB=1fa669&label=minzip" alt="minzip size" /></a>
+  <a href="https://npmx.dev/package/dsh-pstack"><img src="https://img.shields.io/npm/unpacked-size/dsh-pstack?style=flat-square&colorA=080f12&colorB=1fa669" alt="unpacked size" /></a>
   <a href="https://www.jsdocs.io/package/dsh-pstack"><img src="https://img.shields.io/badge/jsdocs-reference-080f12?style=flat-square&colorA=080f12&colorB=1fa669" alt="JSDocs" /></a>
 </p>
 
@@ -30,7 +30,7 @@
     <tr>
       <td align="center"><strong>58</strong><br /><sub>pstack 技能</sub></td>
       <td align="center"><strong>23</strong><br /><sub>playbook</sub></td>
-      <td align="center"><strong>4</strong><br /><sub>原生工具</sub></td>
+      <td align="center"><strong>5</strong><br /><sub>原生工具</sub></td>
       <td align="center"><strong>2</strong><br /><sub>agent preset</sub></td>
       <td align="center"><strong>5</strong><br /><sub>随包脚本</sub></td>
     </tr>
@@ -42,10 +42,11 @@
   <a href="#能力">能力</a> ·
   <a href="#skills-目录">skills 目录</a> ·
   <a href="#可选-dsh-插件">可选 DSH 插件</a> ·
-  <a href="#兼容性">兼容性</a>
+  <a href="#兼容性">兼容性</a> ·
+  <a href="#友情链接">友情链接</a>
 </p>
 
-`dsh-pstack` 是 [pstack](https://github.com/cursor/plugins/tree/main/pstack) 的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）移植。它保留上游 pstack 的技能、playbook 与参考文档。4 个原生工具替代 DSH 缺少的接口，适配层则把 Cursor 的工具名、子代理字段、模型 slug 和路径映射到 DSH。
+`dsh-pstack` 是 [pstack](https://github.com/cursor/plugins/tree/main/pstack) 的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）移植。它保留上游 pstack 的技能、playbook 与参考文档。5 个原生工具补上 DSH 的接口缺口，适配层则把 Cursor 的工具名、子代理字段、模型 slug 和路径映射到 DSH。
 
 上游 pstack 的技能大多声明 `disable-model-invocation: true`。`poteto-mode` 按名称路由到这些隐藏技能，但 DSH 的 `skill` 工具只暴露模型可见目录。DSH 也没有与 Cursor 的模型 slug、`subagent_type`、`readonly` 和 Bun 脚本对等的接口。dsh-pstack 在插件层处理这些差异，安装后可以从 `/poteto-mode` 开始工作。
 
@@ -96,6 +97,7 @@
 |---|---|
 | `pstack_skill` | 按名称加载本插件注册的隐藏技能，也能读取技能目录内的相对资源。 |
 | `pstack_models` | 只读列出 DSH 实际提供的 provider、model 和 effort，供 `/setup-pstack` 使用。 |
+| `pstack_roles` | 只读列出每个 pstack 角色的 shape 与是否为自动面板，帮助 `pstack_subagent` 调用传对 `roleIndex`。 |
 | `pstack_subagent` | 按角色读取 `$DSH_HOME/pstack-models.mdc`，解析 `provider/model [effort]`，按 `agent` 选择 preset，一次可启动多个子代理。 |
 | `pstack_script` | 用固定 id 运行随包 Node 脚本，不依赖 Bun 或 shell 脚本。 |
 
@@ -124,7 +126,7 @@
 
 ## 可选 DSH 插件
 
-以下插件随 DSH 提供，默认关闭。安装 dsh-pstack 时不要求安装这些插件，但部分 pstack 流程需要它们才能完整执行。要启用插件，在「插件」页面用**添加插件**输入包名。也可以运行 `dsh plugin --profile <profile> add <package>`，然后重启 profile。除 `@deepseek-ai/dsh-mcp-client` 外，本节列出的 bundle 与 provider 都是实验性的。
+DSH 提供以下可选插件，默认关闭。多数随 DSH 提供，`@deepseek-ai/dsh-cua-bundle` 需按需安装。安装 dsh-pstack 时不要求安装这些插件，但部分 pstack 流程需要它们才能完整执行。要启用插件，在「插件」页面用**添加插件**输入包名。也可以运行 `dsh plugin --profile <profile> add <package>`，然后重启 profile。除 `@deepseek-ai/dsh-mcp-client` 外，本节列出的 bundle 与 provider 都是实验性的。
 
 > [!NOTE]
 > 未启用可选插件时，pstack 技能仍可加载。需要插件的步骤会输出 `Skipped in DeepSeek Harness: <step>. <reason>.` 后继续。缺少 `gh`、Java/TLC 或视频工具时，对应步骤会报告 blocked 或降级为截图。dsh-pstack 不会把未运行的步骤标记为通过。
@@ -135,7 +137,7 @@
 |---|---|---|
 | `@deepseek-ai/dsh-experimental-session-search` | 5 个只读工具：`session_search`、`session_event_search`、`session_trace`、`session_event_trace`、`session_event_read`，搜索和追踪历史会话，服务 `/recall`、`/reflect`、`/show-me-your-work`。 | 只匹配同一 `cwd` 的会话；当前会话用 `session_event_search`；没有 Cursor 的 `.jsonl` 转写路径。 |
 | `@deepseek-ai/dsh-experimental-worktree`<br />`@deepseek-ai/dsh-experimental-tool-worktree` | `create_worktree` 建本地分支和工作树，切换当前 Session 目录，用于 `/arena`、`/swarm`、`/architect` 的并行候选隔离。 | `from` 只读本地 ref，不 fetch；无云 VM；连续建树会改 `cwd`；不会自动给每个子代理分树。 |
-| `@deepseek-ai/dsh-experimental-forge-bundle` | PR 面板、checks、review、mark ready、merge、Session 绑定，也能从 composer 用新 worktree 启动 Session，服务 `/babysit`、`/shipping`、`/autopilot-*`。 | 仅 GitHub，需 `gh` 登录；模型侧没有 take 工具；没有 stack verdict，也没有 `origin` CLI；可与 worktree bundle 共存。 |
+| `@deepseek-ai/dsh-experimental-forge-bundle` | PR 面板、checks、review、mark ready、merge、Session 绑定，也能从 composer 用新 worktree 启动 Session，服务 `/babysit`、`/shipping`、`/autopilot-*`。 | 仅 GitHub，需 `gh` 登录；模型侧没有变更请求工具；没有 stack verdict，也没有 `origin` CLI；可与 worktree bundle 共存。 |
 
 ### 验证与证据
 
@@ -143,16 +145,16 @@
 
 | 插件 | 打开后的能力 | 边界与冲突 |
 |---|---|---|
-| `@deepseek-ai/dsh-browser-use` + 一个 provider | 导航、点击、输入、截图和 ARIA snapshot；Stagehand 另有 act、find、extract，用于验证技能和 UI 复现。 | 基础包没有 provider 时不生效；每个 Session 一个 provider；截图要图像模型；无视频；Stagehand 需要 Chromium 和非 DeepSeek 模型。 |
-| `@deepseek-ai/dsh-cua-bundle` | macOS 应用点击、输入、截图和权限页，用于桌面应用验证。 | 仅 macOS PTC；Windows 未完成；无视频。 |
-| `@deepseek-ai/dsh-experimental-terminal-bundle` | 6 个全局终端工具，跨调用保持 shell / REPL，支持后台 send，用于 CLI / TUI 验证。 | 只覆盖终端；会加到所有 Agent；持久状态要清理；切换会失效 KV cache。 |
+| `@deepseek-ai/dsh-browser-use` + 一个 provider | 导航、点击、输入、截图和 ARIA snapshot；Stagehand 另有 act、observe、extract，用于验证技能和 UI 复现。 | 基础包没有 provider 时不生效；每个 Session 一个 provider；截图要图像模型；无视频；Stagehand 需要 Chromium 和非 DeepSeek 模型。 |
+| `@deepseek-ai/dsh-cua-bundle` | macOS 应用点击、输入、截图、权限页和会话级授权，用于桌面应用验证。 | 仅 macOS PTC；单 computer-use provider 槽；Windows 未完成；无视频。 |
+| `@deepseek-ai/dsh-experimental-terminal-bundle` | 6 个全局终端工具，跨调用保持 shell / REPL，支持后台 send 和按 owner 隔离，用于 CLI / TUI 验证。 | 只覆盖终端；会加到所有 Agent；持久状态要清理；切换会失效 KV cache。 |
 | `@deepseek-ai/dsh-mcp-client` | 挂载 MCP server，工具以 `mcp__<server>__<tool>` 出现，`mcp-resources` 列出带资源的 server，服务 `/why`、`/teach` 的证据调查。 | 无默认 server；需逐项配置；无自动类别发现。 |
 
 ### 多代理
 
 | 插件 | 打开后的能力 | 边界与冲突 |
 |---|---|---|
-| `@deepseek-ai/dsh-experimental-agent-team-profile` | Lead / teammate、共享任务板、9 个团队工具和 Web roster，服务 `/orchestrate`、`/autopilot-*`。 | 禁用 `subagent` 和 `subagent_fork`，与 `pstack_subagent` 冲突。见下方警告。 |
+| `@deepseek-ai/dsh-experimental-agent-team-profile` | Lead / teammate、共享任务板、9 个团队工具和 Web roster，服务 `/orchestrate`、`/autopilot-*`。 | 禁用 `subagent` 和 `subagent_fork`，与 `pstack_subagent` 冲突。没有 pstack 的 PR frontier、ledger 或 stack verdict。见下方警告。 |
 | `@deepseek-ai/dsh-experimental-ralph-bundle` | 全局 `ralph`，每轮 fresh child 的 foreground 循环，服务 `/autonomous-run`。 | 不是同一 Session 常驻循环；无事件 watcher；不替代 goal、心跳和 decision log。 |
 
 > [!WARNING]
@@ -163,7 +165,7 @@
 | 项目 | 版本 | 说明 |
 |---|---|---|
 | DSH | `>=0.2.1-rc.5` | 最低支持版本；已验证至 `0.2.2-alpha.2` 基线 |
-| pstack | `0.15.36` | 上游基线提交 `4dd1d05` |
+| pstack | `0.15.36` | 上游基线提交 `ae5650f` |
 | Node.js | `>=24.21.1` | 运行时要求 |
 | Cordis | `~4.0.6-alpha.1` | peer dependency |
 
@@ -183,7 +185,11 @@ worktree Session 的 `cwd` 与原 Session 不同。session-search 插件只匹
 
 上游 pstack 用 `docs/harness/claude-code.md` 适配 Claude Code。它保留技能正文，另用宿主适配表把 `Task`、`AskQuestion`、todo、模型 slug 和路径映射到目标宿主。生成器为使用 Cursor 名称的技能添加一行 Claude Code 适配提示。不支持的能力会报告 `Skipped in Claude Code: <step>. <reason>.`
 
-dsh-pstack 沿用这套做法。主适配文档是 [`pstack/harness/docs/harness/dsh.md`](./pstack/harness/docs/harness/dsh.md)，覆盖 Tools、Subagent fields、Models、setup-pstack、Paths 和 Cursor-only features。`pstack_*` 工具、agent preset 和 Node 脚本替代 DSH 缺少的字段。构建时，上游 pstack 与本地适配树被渲染到 `pstack/pstack/`，再与 `src/*.ts`、`skills/` 一起打包到 `dist/`。
+dsh-pstack 沿用这套做法。主适配文档是 [`pstack/harness/docs/harness/dsh.md`](./pstack/harness/docs/harness/dsh.md)，覆盖 Tools、Subagent fields、Models、setup-pstack、Paths、Cursor-only features、Local replacements 和 Optional plugins。`pstack_*` 工具、agent preset 和 Node 脚本替代 DSH 缺少的字段。构建时，上游 pstack 与本地适配树被渲染到 `pstack/pstack/`，再与 `src/*.ts`、`skills/` 一起打包到 `dist/`。
+
+## 友情链接
+
+[LinuxDo](https://linux.do/) —— 新的理想型社区
 
 ## 鸣谢
 

package/cordis.patch.yml

@@ -5,6 +5,8 @@
 # `pstack-models` registers the read-only model/effort directory used by `/setup-pstack`.
 # `pstack-roles` exposes the same role file to the Plugins configuration page through a
 # Typert Remote service; its browser half is declared by `dsh.client` in package.json.
+# `pstack-role-catalog` registers `pstack_roles`, the read-only capability query that
+# reports each role's shape and autoPanel so a caller sets `roleIndex` correctly.
 # `pstack-subagent` registers `pstack_subagent`, which re-reads the role file on every
 # delegation and selects one of the pstack agent presets below.
 # `pstack-script` registers `pstack_script`, the only supported way to run the bundled
@@ -21,6 +23,8 @@
       name: dsh-pstack/models
     - id: pstack-roles
       name: dsh-pstack/roles
+    - id: pstack-role-catalog
+      name: dsh-pstack/role-catalog
     - id: pstack-subagent
       name: dsh-pstack/subagent
       config:

package/dist/client.mjs

@@ -7,6 +7,98 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		let react_jsx_runtime = require("react/jsx-runtime");
 		let react_dom = require("react-dom");
+		// src/internal/role-manifest.ts
+		/** The 17 roles, in manifest order. */
+		const ROLE_MANIFEST = [
+			{
+				key: "feature, refactoring",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "bug-fix",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "perf-issue",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "hillclimb",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "judgment and prose",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "hardest tasks",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "how explorer",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "how explainer",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "why investigators",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "why synthesizer",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "reflect tooling",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "reflect judgment, divergent, synthesizer",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "arena runners",
+				shape: "list",
+				autoPanel: true
+			},
+			{
+				key: "arena cross-judge pool",
+				shape: "list",
+				autoPanel: false
+			},
+			{
+				key: "swarm workers",
+				shape: "list",
+				autoPanel: false
+			},
+			{
+				key: "architect runners",
+				shape: "list",
+				autoPanel: true
+			},
+			{
+				key: "interrogate reviewers",
+				shape: "list",
+				autoPanel: true
+			}
+		];
+		function isRoleKey(value) {
+			return ROLE_MANIFEST.some((role) => role.key === value);
+		}
 		// src/remote.ts
 		/** npm package that owns these methods. */
 		const REMOTE_PACKAGE = "dsh-pstack";
@@ -79,7 +171,7 @@ window.__ModuleLoader__.load({
 		}
 		function parseRoleView(value, index) {
 			const record = parseRecord(value, `roles[${index}]`);
-			if (typeof record["key"] !== "string") throw new TypeError(`roles[${index}].key must be a string`);
+			if (typeof record["key"] !== "string" || !isRoleKey(record["key"])) throw new TypeError(`roles[${index}].key is not in the role manifest`);
 			if (record["shape"] !== "single" && record["shape"] !== "list") throw new TypeError(`roles[${index}].shape is unknown`);
 			if (typeof record["configured"] !== "boolean") throw new TypeError(`roles[${index}].configured must be a boolean`);
 			const routes = record["routes"];
@@ -310,6 +402,10 @@ window.__ModuleLoader__.load({
 				bundle: "@deepseek-ai/dsh-experimental-ralph-bundle"
 			}
 		];
+		/** The default recommendation ids, in catalogue order. */
+		function defaultRecommendationIds() {
+			return OPTIONAL_PLUGINS.filter((plugin) => plugin.recommended === true).map((plugin) => plugin.id);
+		}
 		// src/client/optional-plugins-state.ts
 		/**
 		* Pure state and small async operations for the optional-plugin recommendation
@@ -527,6 +623,7 @@ window.__ModuleLoader__.load({
 		/** Render the recommendation section; all decisions come from props. */
 		function OptionalPluginsView(props) {
 			const { rows, status, loadError, busyId, bulkBusy = false, messages, summary, onToggle, onEnableRecommended, onRetry, t } = props;
+			const recommendationIds = defaultRecommendationIds();
 			const offRecommended = rows.filter((row) => row.definition.recommended === true && row.status === "off").length;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 				"data-optional-plugins": true,
@@ -600,7 +697,7 @@ window.__ModuleLoader__.load({
 									color: COLOR_CAPTION$1,
 									fontSize: 12
 								},
-								children: t("recommendedHint")
+								children: t("recommendedHint", { ids: recommendationIds.join(t("listSeparator")) })
 							})
 						]
 					}),
@@ -1222,10 +1319,7 @@ window.__ModuleLoader__.load({
 		/** Localized role name and usage, keyed by the exact role-file key. */
 		function rolePresentation(key, t) {
 			const copy = roleCopyKeys[key];
-			return copy === void 0 ? {
-				name: key,
-				description: ""
-			} : {
+			return {
 				name: t(copy.name),
 				description: t(copy.description)
 			};
@@ -1257,6 +1351,17 @@ window.__ModuleLoader__.load({
 				color: primary ? "var(--dsw-alias-label-primary-foreground)" : COLOR_TEXT$1
 			};
 		}
+		function dangerButtonStyle() {
+			return {
+				border: `1px solid color-mix(in srgb, ${COLOR_ERROR} 55%, transparent)`,
+				borderRadius: 8,
+				padding: "5px 12px",
+				cursor: "pointer",
+				font: "inherit",
+				background: `color-mix(in srgb, ${COLOR_ERROR} 10%, transparent)`,
+				color: COLOR_ERROR
+			};
+		}
 		function fieldStyle(basis, fullWidth = false) {
 			return {
 				flex: fullWidth ? "1 1 auto" : `1 1 ${basis}px`,
@@ -1414,7 +1519,7 @@ window.__ModuleLoader__.load({
 					routes.length > 1 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 						type: "button",
 						style: {
-							...buttonStyle(),
+							...dangerButtonStyle(),
 							justifySelf: "start"
 						},
 						onClick: () => onRemove(index),
@@ -2166,7 +2271,8 @@ window.__ModuleLoader__.load({
 				enableRecommended: "Enable recommended plugins",
 				enablingRecommended: "Enabling recommended plugins…",
 				recommendedSummary: "{applied} applied, {restart} need a restart, {failed} failed, {skipped} skipped",
-				recommendedHint: "Default recommendations: OPT-01, OPT-06.",
+				recommendedHint: "Default recommendations: {ids}.",
+				listSeparator: ", ",
 				enablePlugin: "Enable",
 				disablePlugin: "Disable",
 				pluginWorking: "Working…",
@@ -2226,7 +2332,8 @@ window.__ModuleLoader__.load({
 				enableRecommended: "一键启用推荐项",
 				enablingRecommended: "正在启用推荐项…",
 				recommendedSummary: "成功 {applied} 项，需重启 {restart} 项，失败 {failed} 项，跳过 {skipped} 项",
-				recommendedHint: "默认推荐 OPT-01、OPT-06。",
+				recommendedHint: "默认推荐 {ids}。",
+				listSeparator: "、",
 				enablePlugin: "启用",
 				disablePlugin: "关闭",
 				pluginWorking: "处理中…",