在 DeepSeek Harness (DSH) 的工程化场景中,Agent 需要在项目范围内发现任务、评估变更影响、执行后台任务并收集验证结果。dsh-project-ops 插件旨在解决这些问题,它不修补 Harness 源码,也不绕过审批流程,而是通过 Agent 工具为项目任务提供有边界的管理和回执机制。
插件定位¶
该插件由开发者 Missher12 维护,开源协议为 MIT。它是一个独立的 Cordis 项目执行插件,兼容 DeepSeek Harness 0.1.5-rc.2 / Cordis 4.0.2。其核心价值在于为 Agent 提供一个受控的任务发现、计划与执行环境,确保任务运行在 Harness 的现有 Jobs 运行时和沙箱中,而不是创建新的引擎或绕过权限。
兼容性与前置要求¶
使用前需确认宿主环境满足以下版本与配置要求:
- DeepSeek Harness: 0.1.5-rc.2
- Cordis: @deepseek-ai/cordis 4.0.2
- Node.js: ^22.19.0 或 >=24.0.0
- Profile 服务: 当前 Profile 必须提供
fs、tools、jobs和systemPrompt服务。
安装与启用¶
在 Web Profile 环境下,使用以下命令安装插件包:
dsh plugin --profile web add https://github.com/Missher12/Missher-DSH-Project-Ops/releases/download/v0.3.1/dsh-project-ops-0.3.1.tgz
安装完成后,请确保 Profile 已重新加载。需要注意的是,Git 仓库中的代码更新不会自动替换本地已安装的插件,如需更新,需手动重新执行上述安装命令。
核心能力与工具¶
安装成功后,Agent 可使用以下四个主要工具进行任务管理:
-
missher_project_ops_task_list
- 功能: 列出项目任务。
- 行为: 从当前会话的根目录和声明的包工作区中发现任务。返回结果包含任务身份、源清单、SHA-256 校验和、相对工作区、可选的包名、推断用途、依赖任务 ID 和运行状态。该工具不会返回具体的任务命令文本。
-
missher_project_ops_task_plan
- 功能: 任务计划与影响分析。
- 行为: 接受 1 到 256 个相对工作区的
changedFiles和目标(verify/build/all)。它会找出直接受影响的包、反向依赖、任务依赖和匹配的根任务,并返回稳定的拓扑排序、受影响的工作区名称、诊断信息以及基于项目内容和快照的摘要。
-
missher_project_ops_task_run
- 功能: 后台任务执行。
- 行为: 接受任务 ID、清单校验和以及可选模式(
foreground/background/auto)。它会通过 Harness 的 Jobs 运行时执行任务,并返回执行回执。
-
missher_project_ops_verification_gate
- 功能: 验证回执收集。
- 行为: 收集并评估任务执行后的验证结果。
注意事项¶
- 权限与边界: 插件复用宿主的命令权限和沙箱,不创建新的 Shell 或作业注册表。它不会绕过审批流程。
- 环境隔离: 插件以当前 Profile 的权限运行,因此安装前应仔细检查源码与许可证。
- Agent 工作流: Agent 应遵循固定流程:先列出任务,再基于变更文件进行计划,最后仅运行返回的任务声明并收集回执。