dsh-project-supervisor

dsh-project-supervisor · DSH「项目主管」

⚠️ Beta / 测试中：这个插件仍在测试阶段，界面与配置字段可能变化；欢迎试用并反馈问题。
⚠️ Beta / under test: UI and config fields may still change; feedback is welcome.

把 DSH 变成项目主管：常驻作业规则 + 并行对话框调度 + Web「主管」面板。 A project supervisor for DeepSeek Harness: standing rules, parallel teammate dialogs, and a supervisor panel.

截图为脱敏版：工作区名/路径已替换为占位符。 / Screenshots are redacted.

它是什么 / What it is

• 常驻规则包：把 AGENTS.md、两个技能（项目主管、提示词润色）和《主管手册》装进任意工作区——开会话就自动以「主管」方式工作：拆目标、登记任务板、用 Agent Teams 并行打开对话框架、验收产物。
• Web「主管」面板（本仓库根目录即 DSH 插件包）：工程底线自检、主管工作流、快捷口令、三个可持久化开关（零基础保护 / 提示词润色 / 新项目需求追问）和页面最上端的工作模式选择（效率优先 / 严格派发）。
• 分享包内容（kit/）：一条命令把主管装进任意工作区（macOS/Linux/Windows）；含模板、调研报告与可选权限补丁。维护/打包脚本在源工作区，不随公开仓库分发。
• 可选权限补丁：给单个对话框按风险传沙箱范围（read-only / workspace-write / danger-full-access）与只读工具白名单。

快速开始 / Quick start

1) 安装 DSH Web 面板（本仓库即插件包）

市场收录后可在 DSH 插件市场（插件 → 发现）搜索 项目主管；当前处于测试期、市集审核中，可直接从 GitHub 安装：

dsh plugin --profile web add github:Midnight-1991/dsh-project-supervisor
# 然后重启 dsh web，并在侧栏打开「主管」

本地开发也可以 link: 安装本仓库：dsh plugin --profile web add link:/path/to/dsh-project-supervisor（详见 kit/安装说明.md 与插件 README.md）。

插件安装需要 pnpm 在 PATH（dsh plugin 会把参数转发给 pnpm）。

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（PowerShell / CMD）
node install-supervisor.mjs C:\path\to\your-workspace --with-research

两条路线装出的内容相同；zip 路线的插件安装是 cd plugin/dsh-project-supervisor，仓库路线是 cd kit/plugin/dsh-project-supervisor。

装完用 DSH 打开该工作区、新建会话（cwd 必须是该目录），直接说目标即可。

3) 试试

帮我做一个记账小工具

主管会先追问关键需求（可在面板关掉），再给 MVP、拆任务、按需并行开对话框、验收后汇报。

面板里有什么 / Panel

区域	说明
主管工作模式	最上端：效率优先（默认）/ 严格派发；写入 .dsh/supervisor.config.json 的 dispatchMode
选择项目	按会话 cwd 去重，默认选含 AGENTS.md 的项目；可手动切换
工程底线自检	9 项探测：.git、README.md、.gitignore、DECISIONS.md、AGENTS.md、.env.example、research/、setup/、.dsh/skills
三张开关卡片	零基础保护、提示词润色、新项目需求追问；默认全开，可折叠并存住选择
快捷动作	复制开工口令、复制套件安装命令、复制规则路径；每项带可展开说明

严格派发模式下：任何文件写入都交给对话框，主管只拆解、评审、验收、集成。

兼容性 / Compatibility

• macOS：完整实测（DSH 0.2.0-rc.2，Chrome/Web GUI）。
• Windows：安装器与路径/HTTP 链路有 compat-check 32 项离线断言（仓库 scripts/ 与 kit 插件副本内均有），但尚未在真实 Windows 机器上端到端实测；装了遇到崩溃请附 ~/.dsh 日志反馈。
• Linux：未实测；安装脚本只需 Node.js（推荐 node kit/install-supervisor.mjs 或 bash kit/install-supervisor.sh，均不需要 python3）；可选的对话框权限补丁另需 python3。

仓库结构 / Layout

.                     # DSH 插件包（package.json 含 dsh.bundle / dsh.client）
├── index.js          # host 半侧：配置 endpoint（GET/POST，同源 + $HOME 校验 + 原子写）
├── client.js         # 「主管」面板 client 半侧（手写 bundle，无构建步骤）
├── cordis.patch.yml  # 插件注册行
├── install-plugin.*  # 本地安装器（.sh / .mjs，Windows 用 .mjs）
├── scripts/          # smoke / host-smoke / e2e-screenshot / compat-check
├── screenshots/
└── kit/              # 规则包与分享包内容（装到别的工作区用；zip 解压后的根目录）
    ├── install-supervisor.sh / .mjs
    ├── AGENTS.supervisor.md
    ├── 主管手册.md
    ├── 安装说明.md / 朋友测试指南.md
    ├── VERSION / CHANGELOG.md / THIRD_PARTY_NOTICES.md / LICENSE
    ├── skill/                  # 主管技能（SKILL.md + templates/）
    ├── skill-improving-prompts/  # 提示词润色技能完整目录
    ├── research/               # 调研报告 01–04/07/09 + README（内部评审不随包分发）
    ├── patches/team-permissions/
    └── plugin/dsh-project-supervisor/  # 可选 Web 面板（README/screenshots/scripts 齐全）

开发与自测 / Development

# 插件本体
node scripts/smoke.mjs          # client bundle 离线注册断言
node scripts/host-smoke.mjs     # host endpoint 16 项断言（假 ctx/req/res）
node scripts/compat-check.mjs   # Windows/路径/HTTP 崩溃安全 32 项（干净克隆下应 0 FAIL）

# 分享包安装器（在仓库根目录）
bash kit/install-supervisor.sh /tmp/test-workspace --with-research   # macOS/Linux
node kit/install-supervisor.mjs /tmp/test-workspace --with-research  # Windows/跨平台

浏览器 e2e 脚本 scripts/e2e-screenshot.mjs 需要本机 DSH 地址与 token（见脚本头注释），只用于开发者。

状态 / Status

Beta（测试中）。当前：插件 0.5.1 / 规则套件 1.8.4（对外文档修复版）。已完成：面板 UI、四类配置、跨平台崩溃安全、工作流硬化 14 条 + 技能模板分发（v1.8.0）、套件安装/分享、独立评审修复、安装器审查修复（dry-run 零写入 / force 升级 / 无 python3，v1.8.1）、协作纪律 wait_agent 超时语义与长任务拆分（v1.8.2）、配置生效语义（每任务重读 / 切换只影响后续 / 开工选项留档，v1.8.3）、公开仓库审查修复（zip 路线命令、版本状态、断链与自测路径，v1.8.4）；未完成：Windows 真机 e2e、更多真实项目演练、DSH 版本升级后的兼容回归。

许可证与第三方 / License

本仓库采用 MIT License，全文见 LICENSE。

第三方组件与致谢：

• improving-prompts 技能来自 theultimate-dev/skills，MIT © 2026 Igor Wnek；
• 工作流机制参考 obra/superpowers（MIT © 2025 Jesse Vincent）：本项目的「工作流硬化」借鉴其流程思想（计划落文件、实现/评审分离、完成声明过验证门、有界返工、任务账本等），规则与模板为独立撰写，未复制其代码或长段原文。

完整清单、各自 MIT 全文与使用范围见 THIRD_PARTY_NOTICES.md 及 kit/skill-improving-prompts/LICENSE。

这不是 DeepSeek 官方项目；DSH 与 DeepSeek 是其各自权利人的商标。