前言¶
在 DeepSeek Harness(DSH)里做多步开发,常见做法是单会话里自己拆任务、自己改文件。任务一多,规则容易丢、并行对话难调度、工程目录是否齐全也缺少统一检查。社区插件 dsh-project-supervisor(DSH「项目主管」)把「常驻作业规则、并行对话框调度、Web 主管面板」打包在一起,让会话默认按主管流程工作:拆目标、登记任务板、用 Agent Teams 并行开对话、验收产物。插件当前标注为 Beta / 测试中,界面与配置字段可能变化。
这是什么¶
dsh-project-supervisor 由维护者 Midnight-1991 发布,分类为工作流,采用 MIT 许可证。仓库同时是 DSH Web 插件包,并附带可装进任意工作区的规则套件(kit/)。
它解决三类问题:
- 规则常驻:通过
AGENTS.md、主管技能、提示词润色技能与《主管手册》,在新会话里自动以「主管」方式协作。 - 并行调度:配合 DSH Agent Teams,按任务并行打开对话框框架,主管侧重拆解、评审、验收与集成。
- 可视化面板:在 DSH Web 侧栏提供「主管」面板,做工程底线自检、工作流说明、快捷口令与可持久化开关。
核心功能¶
常驻规则包¶
安装套件后,工作区会具备主管所需的规则与技能模板。开会话且 cwd 指向该工作区 时,可直接用自然语言说目标;主管会先追问关键需求(可在面板关闭),再给出 MVP、拆任务、按需并行开对话框并验收汇报。
Web「主管」面板¶
面板主要区域如下(配置写入 .dsh/supervisor.config.json):
| 区域 | 说明 |
|---|---|
| 主管工作模式 | 最上端:效率优先(默认)/ 严格派发(dispatchMode) |
| 选择项目 | 按会话 cwd 去重,默认选含 AGENTS.md 的项目 |
| 工程底线自检 | 9 项探测:.git、README.md、.gitignore、DECISIONS.md、AGENTS.md、.env.example、research/、setup/、.dsh/skills |
| 三张开关卡片 | 零基础保护、提示词润色、新项目需求追问;默认全开,可折叠并存住选择 |
| 快捷动作 | 复制开工口令、复制套件安装命令、复制规则路径 |
严格派发模式下:任何文件写入交给对应对话框,主管只拆解、评审、验收、集成。
分享包与可选权限补丁¶
kit/ 提供跨平台安装脚本(macOS/Linux 用 shell,Windows 用 Node 脚本)。可选权限补丁可为单个对话框按风险设置沙箱范围(read-only / workspace-write / danger-full-access)与只读工具白名单(补丁路径见仓库 kit/patches/team-permissions/)。
版本与依赖¶
- 插件版本:0.5.1(
package.json) - 规则套件对外文档:1.8.4
- peer 依赖:
@deepseek-ai/dsh>= 0.2.0-rc.2 - Node:>= 18;插件安装需
pnpm在 PATH(dsh plugin会转发给 pnpm)
安装与启用¶
1. 安装 DSH Web 面板插件¶
市集审核前可直接从 GitHub 安装;安装后需重启 dsh web,并在侧栏打开「主管」。
dsh plugin --profile web add github:Midnight-1991/dsh-project-supervisor
# 然后重启 dsh web,并在侧栏打开「主管」
本地开发可用 link: 指向本仓库路径(详见仓库 kit/安装说明.md 与插件 README.md)。
2. 给工作区建立主管规则(推荐)¶
A. 从未解压的仓库(含 kit/ 目录)
# macOS / Linux
bash kit/install-supervisor.sh /path/to/your-workspace --with-research
# Windows(PowerShell / CMD)
node kit/install-supervisor.mjs C:\path\to\your-workspace --with-research
B. 从 Releases 下载 zip(解压后包根无 kit/)
unzip project-supervisor-kit-*.zip
cd project-supervisor-kit-*
# macOS / Linux
bash install-supervisor.sh /path/to/your-workspace --with-research
# Windows
node install-supervisor.mjs C:\path\to\your-workspace --with-research
两条路线装出内容相同。zip 路线安装插件时进入 plugin/dsh-project-supervisor;仓库路线进入 kit/plugin/dsh-project-supervisor。
装完后用 DSH 打开该工作区、新建会话(cwd 必须是该目录)。
典型用法¶
README 给出的试跑示例:在新会话中直接说:
帮我做一个记账小工具
主管会先追问关键需求(可在面板关掉),再给 MVP、拆任务、按需并行开对话框、验收后汇报。面板上的「复制开工口令」等快捷动作可用于对齐同一套流程。
适用场景与注意¶
适合:希望在 DSH 里用固定工作流做多任务协作、需要工程目录自检与可切换「效率优先 / 严格派发」的团队或个人。
兼容性(仓库自述):
- macOS:在 DSH
0.2.0-rc.2与 Chrome/Web GUI 上完整实测。 - Windows:安装器与路径/HTTP 有
compat-check32 项离线断言,但尚未在真实 Windows 机器上端到端实测。 - Linux:未实测;安装脚本仅需 Node.js(可选权限补丁另需 python3)。
安全与信任:插件以当前 dsh 进程权限运行;host 侧配置 endpoint 含同源与 $HOME 校验与原子写(见仓库 index.js 说明)。安装前请阅读 源码与 MIT 许可证,并知悉 Beta 阶段 UI 与配置可能变更。
DSH 生态理念是「一切皆插件」;SkillHub 目录页 为社区收录站点,与 DeepSeek / 幻方无官方从属关系。本项目亦非 DeepSeek 官方项目。
结尾¶
dsh-project-supervisor 把主管规则、并行对话调度与 Web 面板合成一套工作流插件:先装 Web 插件打开「主管」,再按需把 kit/ 装进目标工作区,即可在 DSH 里用结构化方式推进多步开发。