Pavan-Gopa/Pavans-Workflow-DSH

Pavan 工作流 — DeepSeek Harness 版

一个由人类监督、多模型协作的软件开发工作流，适用于 DeepSeek Harness，与 Pavan 的工作流 v3.4.2 保持一致。

下载桌面应用

首选的发行方式是 Pavan Workflow Desktop。它内置了官方的 DeepSeek Harness 运行时，因此普通用户无需 Node.js、npm、npx、git clone 或终端即可启动应用。

打开本仓库的 Releases 页面，下载适用于你的 Mac 的 macOS 版本：

- Pavan-Workflow-0.3.0-alpha.2-macos-arm64.dmg — Apple Silicon（M1/M2/M3/M4 及后续机型）
- Pavan-Workflow-0.3.0-alpha.2-macos-x64.dmg — Intel Mac

然后打开 DMG，将 Pavan Workflow 拖入 Applications，并启动它。首次启动时：

1. 选择你想要处理的项目文件夹；
2. Pavan Workflow 会安装其项目本地的技能和工作流状态，且不会覆盖已有的 .dsh/roles.yaml；
3. 内置的 DeepSeek Harness 会在桌面应用内本地启动；
4. 在 Settings -> Models 中配置模型提供方；
5. 在 Settings -> Plugins -> Subagent model selection 中授权子路由；
6. 启动一个新会话并使用 pavan-workflow 技能。

macOS alpha 签名： 构建版本采用临时签名（ad-hoc signed），但未经过 Apple Developer ID 签名/公证。因此 macOS 可能需要在 System Settings -> Privacy & Security 中选择 Open Anyway。要实现无警告的双击安装，仍需完成正式的 Developer ID 签名和公证。

桌面应用实际包含的内容

Pavan Workflow.app
-> Electron 桌面外壳
-> 内置官方 @deepseek-ai/dsh 运行时
-> 内置 pnpm + 应用自有的 Node/pnpm shims
-> 原生窗口内的本地 DSH Web UI
-> Pavan Workflow 项目技能 + 状态模板
-> 可选的 Codegraph + 用量/配额插件设置

DeepSeek Harness 仍然是引擎。桌面外壳负责启动、项目选择、工作流安装、本地运行时生命周期、工具链引导以及原生应用窗口。

核心工作流

Human  Main
|
+-> fresh Coder
|      |
|      v
|   Main verifies source + diff + Objective Gates
|      |
+-> fresh Reviewer
|      |
|      v
|   Main verifies findings against real source
|      |
+-> fresh Tester
|
v
Main verifies tests + acceptance -> next step

Main 是唯一的路由器。Worker 之间不直接交接工作，不修改规范工作流状态，不提交/推送，也不静默切换模型路由。每次重试都使用全新的专家会话。

多模型路由

随附的推荐首次运行预设使用三条独立路由：

| 角色 | 主路由 |
| --- | --- |
| Coder | deepseek-official / deepseek-v4-pro |
| Reviewer | anthropic / claude-opus-4-8 |
| 测试员 | openai / gpt-5.5 |
| 架构师 | anthropic / claude-opus-4-8 |
| 安全 | openai / gpt-5.5 |
| 设计顾问 | anthropic / claude-opus-4-8 |
| 设计师 | openai / gpt-5.5 |

备份是跨提供商的，且仅限人工授权。不允许自动故障转移。

确切的路由仅为示例，并非强制要求。如果你配置的提供商暴露了不同的模型 ID，请编辑项目本地的 .dsh/roles.yaml，以匹配 DSH 暴露的确切 ID。

流水线配置

- standard — 编码员 -> 审查员 -> 测试员（默认）。
- quick — 可在绿色 Objective Gates 后关闭，但禁止用于高风险或 auth/credential/API/schema/migration/trust-boundary 差异。
- critical — 审查员和测试员保持开启；Main 在必要时提供限定范围的安全检查。

参见 PIPELINE.md。

OMP -> DSH 映射

| 原始概念 | DSH 版本 |
| --- | --- |
| 主会话 | DSH 根会话 |
| 全新任务代理 | 原生可选模型的 subagent 子级 |
| 各角色别名 | .dsh/roles.yaml 确切提供商/模型路由 |
| Agent Hub | DSH 子会话 / 轨迹 |
| Todo/仪表盘 | DSH todo_write + 文件支持的规范状态 |
| Graphify | dsh-plugin-codegraph + 原生 LSP/源验证 |
| Ponytail | 项目本地 DSH ponytail 技能 |
| Grilling | 项目本地 DSH grilling 技能 |
| UI 设计师 | 项目本地 DSH ui-designer 技能 + 设计角色 |
| 上下文经济 | DSH 原生压缩/令牌压力系统 |
| omp usage | dsh-quota Web 插件 |

为什么常规门控循环使用 subagent

常规流水线有意按顺序分派专家。Main 必须在编码员之后重新获得控制权，检查实际工作区/差异，重新运行确定性门控，然后才分派审查员。同样的规则也适用于测试员之前。

DSH workflow / parallel() 对于独立的只读研究或对抗性分析仍然有用，因为在这些场景中子级不依赖于先前的变更。

规范状态

项目覆盖层将持久状态保存在以下位置：

AI_Workflow_Kit/docs/AI/STATE.yaml
AI_Workflow_Kit/docs/STEPS.md
AI_Workflow_Kit/docs/DECISIONS.md
AI_Workflow_Kit/docs/AI/FEEDBACK.md

只有 Main 拥有语义工作流状态。

开发者 / CLI 安装

桌面应用是首选最终用户路径，但覆盖层仍可手动安装：

git clone https://github.com/Pavan-Gopa/Pavans-Workflow-DSH.git
cd Pavans-Workflow-DSH
./install.sh --target /path/to/project --preset recommended
cd /path/to/project
npx @deepseek-ai/dsh web

参见 FIRST_RUN.md 和 ROUTING_TEST.md。

桌面开发

npm install
npm test
npm run desktop:check
npm run desktop

使用以下命令构建 macOS 安装程序：

npm run desktop:dist:mac -- --arm64
npm run desktop:dist:mac -- --x64
GitHub Actions 会构建两种架构，并对打包后的 DSH 运行时、捆绑的 pnpm 以及 macOS 代码签名进行冒烟测试——而不仅仅是源码树。

安全不变量

1. Main 是唯一的工作流状态写入者和路由器。
2. 对话历史不是权威依据；规范文件和真实仓库状态才是。
3. Main 在路由之前会验证每个 worker 的结果。
4. 新 worker 会收到有界的、自包含的任务分配。
5. 备份须经 Human 授权，绝不自动执行。
6. 提供方/模型故障不计为实现失败。
7. 三次实质相同的无进展失败会停止自动重试。
8. quick 的优先级永远不会高于安全或公共契约风险。
9. 除非 Human 明确更改契约，否则 worker 绝不提交/推送。
10. 有效的子路由证据是门禁的一部分。

状态

本项目与 DeepSeek Harness 均处于开发者预览阶段。桌面外壳有意保持轻量，以便上游 DSH 可以在无需维护永久分支的情况下升级。

许可证

MIT。参见 LICENSE。