dsh-subagent-cursor

English | 简体中文（中文为准，英文翻译可能滞后）

DeepSeek Harness 的 Cursor-as-subagent 提供方插件：一次本地 one-shot @cursor/sdk 运行、摘要优先的结果展示、可无人值守的 Profile Bundle。

• Subagent 提供方 — 向 ctx.subagents 注册一个提供方（默认名 cursor），每次运行是一次父会话 cwd 下的本地 one-shot @cursor/sdk 查询。
• 宿主平面 Profile Bundle — 与官方 Claude Code / Codex 提供方同族；对模型可见的工具由独立的 dsh-tool-subagent 行提供并指定本提供方。
• 摘要优先结果 — 软解析 + summary / <details> 呈现，父代理一眼看到结论。

安装

dsh plugin add dsh-subagent-cursor

本插件注册一个 ctx.subagents 提供方（默认名 cursor）。每次运行是一次父会话 cwd 下的本地 one-shot @cursor/sdk 查询。属于 host 平面的 Profile Bundle，与官方 Claude Code / Codex 提供方同族；对模型可见的工具由独立的 dsh-tool-subagent 行提供并指定本提供方。

最小启用

在 Profile Bundle / 部署配置中挂上本包，并暴露 tool-subagent 行（工具名可自定）：

plugins:
  - package: dsh-subagent-cursor
    config:
      providerName: cursor
      model: composer-2.5
      env:
        CURSOR_API_KEY: ${CURSOR_API_KEY}
  - package: dsh-tool-subagent
    config:
      tools:
        - name: subagent_cursor
          provider: cursor

需要本机有效的 CURSOR_API_KEY（Cursor Dashboard → Integrations）。单测用 fake SDK，不依赖 Key。

配置

字段	默认	含义
providerName	cursor	注册到 ctx.subagents 上的提供方名
model	composer-2.5	传给 SDK 的 Cursor 模型 id
env	{}	叠加在凭据清洗后的父 env 之上的显式子进程/SDK 环境；在此提供 CURSOR_API_KEY
disposeGraceMs	3000	关闭等待的正向宽限（ms）

为什么用本地 one-shot

每次委派都是父会话 cwd 下的独立 Cursor 查询，天然隔离、不污染父上下文；SDK 门面可注入（createAgent），单测用 fake SDK，不触网、无需 CURSOR_API_KEY。

开发

npm ci --legacy-peer-deps
npm run build       # tsc → lib/
npm run typecheck   # 严格类型检查
npm test            # vitest：fake SDK 契约覆盖（completed / aborted / error / missing key）

详见 DEVELOPMENT.md 与 CONTRIBUTING.md。

设计

完整设计笔记（模块职责、SDK 契约、错误分类、结果格式）见 docs/DESIGN.md；后续路线图见 docs/ROADMAP.md。

⭐ 支持

如果这个插件对你有帮助，欢迎到 GitHub 仓库 点个 ⭐ Star——它是我持续维护的动力。也欢迎提 issue / PR 一起改进。

License

MIT