dsh-cursor-dev 0.11.0 → 0.11.1

package/README.md

@@ -55,9 +55,9 @@ flowchart LR
 3. 按 DSH 提示完成加载；涉及后台代码更新时重启 DSH，然后刷新页面。在 Cursor 面板中选择模型并保存。
 4. 明确告诉父模型使用 `cursor_code`，或者用下面的斜杠命令派发第一个任务。
 
-**版本说明（2026-10-17 核对）：** `0.11.0` 已推送到公开仓库的 `main`，适配 DSH `0.2.1-rc.2`：插件改用新的外部子智能体契约（`startActivation`、必须返回未被占用的子会话 id、External 行由宿主写入），在包顶层声明 `engines.dsh: ^0.2.0-rc.1`，并清理了 DSH 0.2.1 已删除的工具配置项。插件市场（dshmarket）已收录本插件（目录条目合并于 2026-10-17），可以直接在市场里找到并安装；`0.11.0` 也已发布到 npm 公共源（包名 `dsh-cursor-dev`），按包名安装不再返回 404，目录下一次探测后市场卡片会显示版本和 `DSH ^0.2.0-rc.1` 宿主要求。要跟进后续改动请用 Git 来源；`.tgz` 是某一刻的固定快照。详见[安装来源与版本](docs/INSTALL.md#2-选择安装来源)。
+**版本说明（2026-10-17 核对）：** `0.11.1` 已推送到公开仓库的 `main`，适配 DSH `0.2.1-rc.2`：插件改用新的外部子智能体契约（`startActivation`、必须返回未被占用的子会话 id、External 行由宿主写入），在包顶层声明 `engines.dsh: >=0.2.1-rc.2 <0.3.0-0`（只覆盖实际实现并验证过的契约；`-0` 让 `0.3.0` 的预发布也不匹配），并清理了 DSH 0.2.1 已删除的工具配置项。插件市场（dshmarket）已收录本插件（目录条目合并于 2026-10-17），可以直接在市场里找到并安装；`0.11.1` 已发布到 npm 公共源（包名 `dsh-cursor-dev`），按包名安装不再返回 404，目录下一次探测后市场卡片会显示版本和 `DSH >=0.2.1-rc.2 <0.3.0-0` 宿主要求。要跟进后续改动请用 Git 来源；`.tgz` 是某一刻的固定快照。详见[安装来源与版本](docs/INSTALL.md#2-选择安装来源)。
 
-运行要求：DSH 包声明 `^0.2.0-rc.1`（已在 `0.2.1-rc.2` 上验证）；Node.js `^22.19.0 || >=24.0.0`；已登录且可访问服务的 Cursor CLI。原生子智能体功能需要 DSH 的 `subagents`、`agents` 服务，后台任务还需要对应任务服务，建议使用当前 DSH 桌面版。CLI 安装方法见 [Cursor 官方文档](https://cursor.com/docs/cli)。
+运行要求：DSH `>=0.2.1-rc.2 <0.3.0-0`（已在 `0.2.1-rc.2` 上验证）；Node.js `^22.19.0 || >=24.0.0`；已登录且可访问服务的 Cursor CLI。原生子智能体功能需要 DSH 的 `subagents`、`agents` 服务，后台任务还需要对应任务服务，建议使用当前 DSH 桌面版。CLI 安装方法见 [Cursor 官方文档](https://cursor.com/docs/cli)。
 
 ### 三个入口
 
@@ -220,9 +220,9 @@ See the [installation guide](docs/INSTALL.md) for detailed setup and troubleshoo
 3. Restart DSH when backend changes require it, then refresh the page. Open the Cursor panel under `/plugins/dsh-cursor-dev/`, select a model and save it.
 4. Ask the parent to use `cursor_code`, or send `/cursor-subagent` followed by a complete task. The command dispatches directly and hands a completion or failure summary back to the original parent.
 
-As checked on **2026-10-17**, version `0.11.0` is pushed to `main` on the public repository and adapts the plugin to DSH `0.2.1-rc.2`: it follows the new external-subagent contract (`startActivation`, a child id the host has not registered yet, and the `External` catalog row written by the host), declares `engines.dsh: ^0.2.0-rc.1` at the package top level, and drops the tool-config keys that DSH 0.2.1 removed. The dsh-market catalog already lists this plugin (entry merged 2026-10-17), so it can be installed from the market; version `0.11.0` is also published to the public npm registry as `dsh-cursor-dev`, so a bare package-name installation works and the market card shows the version and the `DSH ^0.2.0-rc.1` host requirement after the catalog's next probe. Use the Git source to follow later changes; a `.tgz` is a fixed snapshot.
+As checked on **2026-10-17**, version `0.11.1` is pushed to `main` on the public repository and adapts the plugin to DSH `0.2.1-rc.2`: it follows the new external-subagent contract (`startActivation`, a child id the host has not registered yet, and the `External` catalog row written by the host), declares `engines.dsh: >=0.2.1-rc.2 <0.3.0-0` at the package top level (only the contract it actually implements and tests; the `-0` suffix also excludes `0.3.0` prereleases), and drops the tool-config keys that DSH 0.2.1 removed. The dsh-market catalog already lists this plugin (entry merged 2026-10-17), so it can be installed from the market; version `0.11.1` is published to the public npm registry as `dsh-cursor-dev`, so a bare package-name installation works and the market card shows the version and the `DSH >=0.2.1-rc.2 <0.3.0-0` host requirement after the catalog's next probe. Use the Git source to follow later changes; a `.tgz` is a fixed snapshot.
 
-Requirements: DSH metadata declares `^0.2.0-rc.1` (verified against `0.2.1-rc.2`); Node.js `^22.19.0 || >=24.0.0`; an authenticated Cursor CLI account with service access. Native dispatch additionally needs DSH's `subagents` and `agents` services, and background runs need the host's job services. A current DSH desktop installation is recommended.
+Requirements: DSH `>=0.2.1-rc.2 <0.3.0-0` (verified against `0.2.1-rc.2`); Node.js `^22.19.0 || >=24.0.0`; an authenticated Cursor CLI account with service access. Native dispatch additionally needs DSH's `subagents` and `agents` services, and background runs need the host's job services. A current DSH desktop installation is recommended.
 
 ### Parent-to-child contract
 

package/docs/INSTALL.md

@@ -11,7 +11,7 @@
 - 可正常对话的 DSH，以及一个支持工具调用的父模型。
 - 插件使用的 Node.js 满足 `^22.19.0 || >=24.0.0`。桌面版应检查其自带运行时，终端里的 `node --version` 不一定是桌面程序使用的版本。
 - 当前版 Cursor CLI，已完成登录，并有执行任务所需的账号权限、额度和网络连接。
-- 原生子智能体入口需要 DSH 的 `subagents`、`agents` 服务；后台运行还需要宿主任务服务。包声明的 DSH 版本为 `^0.2.0-rc.1`（已在 `0.2.1-rc.2` 上验证），建议使用当前桌面版及其标准 profile。
+- 原生子智能体入口需要 DSH 的 `subagents`、`agents` 服务；后台运行还需要宿主任务服务。包声明的 DSH 版本为 `>=0.2.1-rc.2 <0.3.0-0`（已在 `0.2.1-rc.2` 上验证），建议使用当前桌面版及其标准 profile。
 
 父模型的 API 配置与 Cursor 登录分别管理。插件使用本机 CLI 的登录状态，无需再向插件填写一份 Cursor API Key。
 
@@ -38,15 +38,15 @@ agent status --format json
 
 ## 2. 选择安装来源
 
-**发布状态（2026-10-17 核对）：** 公共 GitHub 仓库存在，`0.11.0` 已推送到 `main`（适配 DSH `0.2.1-rc.2` 的外部子智能体契约、顶层 `engines.dsh`、面板模型锁定、父级专属的 `maxChildDepth` 递归限制，以及本指南都在其中）。插件市场（dshmarket）的目录条目已于 2026-10-17 合并，可以直接在市场里找到本插件；`0.11.0` 也已发布到 npm 公共源（包名 `dsh-cursor-dev`），按包名安装不再返回 404，目录下一次探测后市场会显示版本和 `DSH ^0.2.0-rc.1` 宿主要求。
+**发布状态（2026-10-17 核对）：** 公共 GitHub 仓库存在，`0.11.1` 已推送到 `main`（适配 DSH `0.2.1-rc.2` 的外部子智能体契约、顶层 `engines.dsh: >=0.2.1-rc.2 <0.3.0-0`、面板模型锁定、父级专属的 `maxChildDepth` 递归限制，以及本指南都在其中）。插件市场（dshmarket）的目录条目已于 2026-10-17 合并，可以直接在市场里找到本插件；`0.11.1` 已发布到 npm 公共源（包名 `dsh-cursor-dev`），按包名安装不再返回 404，目录下一次探测后市场会显示版本和 `DSH >=0.2.1-rc.2 <0.3.0-0` 宿主要求。
 
 | 你要安装的内容 | 安装来源 |
 | --- | --- |
 | 插件市场里的本插件 | 市场条目解析为 `github:Dclef/dsh-cursor-dev`，安装后会跟随仓库默认分支 |
-| npm 公共源上的已发布版本 | `dsh-cursor-dev`（`0.11.0` 起可用，按包内 `files` 白名单安装） |
+| npm 公共源上的已发布版本 | `dsh-cursor-dev`（`0.11.0` 起可用，按包内 `files` 白名单安装，当前为 `0.11.1`） |
 | 公开仓库的当前版本（推荐） | `git+https://github.com/Dclef/dsh-cursor-dev.git` |
 | 你本地的源码目录 | 该目录的绝对路径，例如 `D:/plugins/dsh-cursor-dev` |
-| 维护者提供的源码快照或发布包 | `.tgz` 文件的绝对路径，例如 `D:/Downloads/dsh-cursor-dev-0.11.0.tgz` |
+| 维护者提供的源码快照或发布包 | `.tgz` 文件的绝对路径，例如 `D:/Downloads/dsh-cursor-dev-0.11.1.tgz` |
 
 表中本地路径是示例，需要换成实际位置。npm 来源取 registry 上发布的最新版本；Git 来源会取得仓库默认分支的最新提交；`.tgz` 是某一刻的固定快照——要跟进后续改动就用 Git 来源。
 
@@ -88,7 +88,7 @@ dsh plugin add "/home/you/plugins/dsh-cursor-dev"
 安装收到的包：
 
 ```powershell
-dsh plugin add "D:/Downloads/dsh-cursor-dev-0.11.0.tgz"
+dsh plugin add "D:/Downloads/dsh-cursor-dev-0.11.1.tgz"
 ```
 
 终端没有 `dsh` 命令时，使用桌面插件管理即可。不要把在任意项目目录执行 `npm install` 当成已经在 DSH 当前 profile 中启用插件。
@@ -189,7 +189,7 @@ continueSession 设为 true。让 Cursor 说明上一轮做了什么，再核对
 
 | 现象 | 检查与处理 |
 | --- | --- |
-| 按包名安装返回 404 | `0.11.0` 起已发布到 npm 公共源；仍 404 时确认 registry 指向公共源且包名拼写为 `dsh-cursor-dev`，或改用插件市场、上面的 Git 来源、已取得的源码目录或安装包 |
+| 按包名安装返回 404 | `0.11.0` 起已发布到 npm 公共源（当前 `0.11.1`）；仍 404 时确认 registry 指向公共源且包名拼写为 `dsh-cursor-dev`，或改用插件市场、上面的 Git 来源、已取得的源码目录或安装包 |
 | DSH 报告找不到 Cursor CLI | 检查 `agent status --format json`；确认 CLI 位于 DSH 可见的 PATH 或常见安装目录，然后重启 DSH。仍找不到时，在插件配置里设置 `command` 为可启动二进制、安装根目录、`agent.cmd`，或 `"node.exe" "index.js"`（非空时只走该路径） |
 | 未登录或账号不可用 | 在运行 DSH 的同一操作系统用户下执行 `agent login`，检查账号和网络状态 |
 | 面板选了 Auto，实际仍是其他模型 | 当前任务不会中途切换；新版请保存“锁定面板模型”。查看返回的 `modelSource` 与 `requestedModel`，确认是否有显式调用参数 |

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-cursor-dev",
   "displayName": "Cursor 子智能体",
-  "description": "把 Cursor CLI 当作子编码智能体来写业务代码：每次运行都在 DSH 里开一个真实的子会话（点开就是完整对话），可按任务选模型、会话在 DSH 重启后仍能续聊、返回逐步工具时间线与真实文件 diff，并自带额度/模型/会话面板。",
-  "version": "0.11.0",
+  "description": "把 Cursor CLI 当作子编码智能体来写业务代码：cursor_code 每次运行都在 DSH 里开一个真实的、可点开的子会话，cursor_subagent 则显示为宿主写入的 External 记录；可按任务选模型、会话在 DSH 重启后仍能续聊、返回逐步工具时间线与真实文件 diff，并自带额度/模型/会话面板。",
+  "version": "0.11.1",
   "license": "MIT",
   "type": "module",
   "main": "lib/index.js",
@@ -22,7 +22,7 @@
   ],
   "engines": {
     "node": "^22.19.0 || >=24.0.0",
-    "dsh": "^0.2.0-rc.1"
+    "dsh": ">=0.2.1-rc.2 <0.3.0-0"
   },
   "scripts": {
     "test": "node --test --test-force-exit \"test/**/*.test.mjs\""