daizihan233/dsh-my-go

MyGO!!!!! 编排调度 | DSH

My tasks, where to GO?????

dsh-my-go 是构建在 DeepSeek Harness (DSH) 之上的智能体编排系统。

它以星型 + 单线嵌套拓扑把 DSH 主会话（Sisyphus）与 7 个专业子智能体组织起来：Sisyphus 负责调度、审查与驳回，子智能体负责执行与汇报。参考了 oh-my-openagent 的编排设计，针对 DSH 进行了优化调整。

上游作者开发手记（原项目背景，非 fork 文档）：https://khbit.cn/posts/dsh-my-go/

特性

- 星型拓扑：所有子智能体（叶子）不直接通信，全部经 Sisyphus 中转。
- 单线阻塞：同一时段只有一个子智能体运行，便于审查，增强可观测性。
- 7 个专业工种：Hermes（快速执行）、Explore（检索）、Librarian（文档）、Multimodal Looker（看图）、Hephaestus（写代码）、Prometheus（规划）、Oracle（最后手段：疑难/极端复杂问题的架构调试，仅当其他工种无法胜任时启用；验收是 Sisyphus 的质检本职）。
- 按工种绑定模型：快活小工配便宜模型，重活配强模型——默认不绑任何模型（继承环境路由），按工种分流见下文「工种模型绑定」。
- 4 个通信工具：go_work（派发）、continue（驳回/追问）、need_help（求助挂起）、forward（转发），加 orchestration_status（状态总览）和 list_subagents（列出已有 sub-agent 及其最后 prompt）。
- 步骤级调度：Prometheus 把需求拆成步骤序列，Sisyphus 逐步骤选择最省 token 的工种——按任务难度分配（不按需求难度）：指令明确、步骤具体的执行活优先派 Hermes，需要设计/推理的才升级 Hephaestus，仅疑难/极端复杂才到 Oracle；同工种上下文连续则 continue 复用。
- Sisyphus 质检：结论不达标驳回重做，被驳回的子智能体保留上下文继续。
- WebUI 配置：每个工种的模型 / 思考档位 / DSV4P0813 补丁开关，均可在 DSH 设置页配置。
- 错峰路由（peak routing）：勾选后按北京时间高峰/非高峰时段在两个渠道+模型组合间自动切换——高峰（周一至五 09:00-12:00、14:00-18:00）走「梁文峰」子配置，其余时段走「梁文谷」子配置。
- DSH 适配：权限请求、问题询问由主智能体执行。
- 节省主会话上下文：Sisyphus 主会话不加载 Skill 工具（子智能体仍保留），跳过 Skill catalog 注入以压缩主会话上下文。
- DSV4P0813 补丁开关：内置过拟合补丁，让 DeepSeek V4 Pro 0813 发挥最大的实力。

_真正实现 “按量付费”_

环境要求

理论最低要求

- DeepSeek Harness 0.1.0-rc.6+（基于 agent/request waterfall 与 continuable subagent API）
- Node.js 20+
- 一个可用的 LLM provider
- Windows / macOS / Linux（DSH 均支持）

开发时的环境

- DSH 0.1.0-rc.8 + Windows 11 + Node.js 22（作者实际组合）

快速开始

安装（推荐：npm 插件）

一条命令安装到 web profile
dsh plugin --profile web add dsh-my-go@latest --config.minimumReleaseAge=0
重启 dsh web 生效
dsh web

安装后 broker 插件（编排工具 + 模型绑定 + 树状图面板 + 设置页）自动挂载；
会话预设「MyGO!!!!! 模式」提供 Sisyphus 的完整编排。

最小示例

新开一个 DSH 会话，预设选择 MyGO!!!!! 模式
然后对 Sisyphus 说：

告诉我这个项目是干啥的。

运行

dsh web   # 启动 Web GUI，新会话选择 MyGO!!!!! 模式

架构

用户 ──► Sisyphus（调度+质检）──► Hermes / Explore / Librarian / Looker
│                        Hephaestus / Prometheus / Oracle
└── 单线阻塞队列 ◄── 所有子智能体结论回流

- 子智能体 = DSH continuable subagent（subagents.startContinuable），
持久化独立 Session，支持 followup 续接。
- 模型绑定 = 创建时 agentOptions + agent/request waterfall 覆盖
reasoningEffort（跟随 DSH 模型目录：只设置该模型实际支持的思考档位；
模型无思考选项或档位不支持时不设置，走模型默认）。
- 单线阻塞 = broker 编排状态机（当前运行 / 队列 / 求助 / 历史）。
- 详细设计见 docs/ARCHITECTURE.md。

配置

host 半（lib）注册 settings 命名空间 dsh-my-go，client 半提供设置页
（WebUI「MyGO 编排」），broker 半只读取：

| 配置项                          | 默认值         | 说明                                                                    |
|---------------------------------|----------------|-------------------------------------------------------------------------|
| agents..provider        | 不指定（继承） | 该工种的 provider 路由；缺省时继承父会话渠道                            |
| agents..model           | 不指定（继承） | 该工种的模型；缺省时继承父会话模型                                      |
| agents..reasoningEffort | 不指定         | 期望思考档位（如 high/max）；只在模型实际支持时应用，否则走模型默认 |
| agents..dsv4p0813       | false          | 是否对该工种启用 DSV4P0813 两阶段引导补丁                               |
| agents..peakRouting     | false          | 是否启用错峰路由（按北京时间高峰/非高峰切换 provider/model）             |
| agents..peakProvider    | 不指定（继承） | 高峰时段（梁文峰）渠道；缺省继承父会话渠道                              |
| agents..peakModel       | 不指定（继承） | 高峰时段（梁文峰）模型；缺省继承父会话模型                              |
| agents..offpeakProvider | 不指定（继承） | 非高峰时段（梁文谷）渠道；缺省继承父会话渠道                            |
| agents..offpeakModel    | 不指定（继承） | 非高峰时段（梁文谷）模型；缺省继承父会话模型                            |

错峰路由（peak routing）

勾选「错峰路由」后，该工种在派发时按北京时间（UTC+8，无夏令时）判断当前时段：

- 高峰时段（周一至周五 09:00-12:00、14:00-18:00，含 09:00/14:00、不含 12:00/18:00）→ 使用「梁文峰」子配置（peakProvider / peakModel）；
- 其余时段（周末、午休 12:00-14:00、夜间与凌晨）→ 使用「梁文谷」子配置（offpeakProvider / offpeakModel）。

未勾选时行为与旧版完全一致（只用顶层 provider / model）。未配置的
peak/offpeak 字段保持「继承父会话（Sisyphus）」语义，与顶层字段相同。
思考档位与 DSV4P0813 补丁开关不受错峰路由影响，两个时段共用。

工种模型绑定

自 tisitan.7 起，插件不再内置任何模型名/渠道名——所有工种默认空绑定，
子代理完全继承环境默认路由（与 Sisyphus 同渠道同模型）。需要按工种分流
（快活走便宜模型、重活走强模型）时，在 DSH 设置页「MyGO 编排」逐工种填写，
或直接编辑 ~/.dsh/settings.yaml：

dsh-my-go:
hermes:
model: your-cheap-model        # 高频体力活：便宜快模型
explore:
model: your-cheap-model
librarian:
model: your-cheap-model
looker:
model: your-multimodal-model   # 看图需要多模态能力
hephaestus:
provider: your-gateway         # provider 缺省 = 继承父会话渠道
model: your-mid-model
reasoningEffort: high          # 仅当该模型实际支持此档位时应用
prometheus:
provider: your-gateway
model: your-strong-model
reasoningEffort: max
oracle:
provider: your-gateway
model: your-strong-model
reasoningEffort: max

字段缺省即不覆盖。model 在派发前会经 llm.listModels 校验真实存在
才应用（不存在则跳过并回落父会话模型，日志 warn）；reasoningEffort
跟随 DSH 模型目录，模型不支持所配档位时留空走适配器默认。

建议分工：Sisyphus / Hephaestus 用中等能力模型，Hermes / Explore /
Librarian / Looker 用便宜轻量模型，Prometheus / Oracle 用最强模型。

插件 config 键（broker 行为调参）

以下为插件级 config（dsh plugin add 的 config / bundle 层），与上面的
settings 命名空间正交；默认值即旧硬编码口径（tisitan.8 起截断阈值可配）：

| config 键               | 默认值 | 说明                                                                 |
|-------------------------|--------|----------------------------------------------------------------------|
| disposeEndGraceMs     | 500    | agent/disposed 后等待 subagent/end 的宽限期，超时兜底清槽推进队列 |
| queueRetryBaseMs      | 1000   | 队列派发失败回补后的线性退避基数（1×/2×/3×，上限 3 次后放弃）         |
| statusHistoryLimit    | 12     | orchestration_status 展示的历史条数                                 |
| statusConclusionMax   | 400    | orchestration_status 单条结论截断长度（failed 记录不截断）      |
| helpContentMax        | 240    | orchestration_status 单条求助内容截断长度                           |
| subagentPromptMax     | 200    | list_subagents prompt 摘要及会话 label 的 prompt 摘要截断长度       |

编排台账（history，上限 200 条）持久化在
/dsh-my-go/orchestration-ledger.json（DSH_HOME 缺省
~/.dsh），进程重启后读回——跨重启 continue 已完工子代理经 harness
coldResume 续聊可用。

智能体 Prompt

每个工种的完整 persona / 职责 / 汇报格式见 prompts/：

| 文件                                           | 工种            |
|------------------------------------------------|-----------------|
| prompts/sisyphus.md     | 总调度 + 质检官 |
| prompts/hermes.md         | 快速执行        |
| prompts/explore.md       | 快速检索        |
| prompts/librarian.md   | 文档查询        |
| prompts/looker.md         | 多模态识别      |
| prompts/hephaestus.md | 代码编写        |
| prompts/prometheus.md | 需求规划        |
| prompts/oracle.md         | 架构调试（疑难兜底）|

目录结构

dsh-my-go/
├── AGENTS.md              # 本项目的编排规格（Sisyphus 系统）
├── README.md              # 本文档
├── package.json           # npm 包声明（dsh.bundle.patch → cordis.patch.yml）
├── cordis.patch.yml       # bundle patch（dsh plugin add 后自动挂载 host 插件）
├── lib/index.js           # npm 包 host 半（编排工具 + 状态机 + 模型绑定）
├── src/client.js          # client 半源码（树状图面板 / 设置页 / 自动跳转）
├── scripts/build-client.mjs  # esbuild 打包 client → dist/client.js
├── dist/                  # 构建产物（发布时生成）
├── preset/                # agent preset「MyGO!!!!! 模式」（复制到 ~/.dsh/.agent-presets/）
│   ├── preset.yml
│   ├── agent.cordis.yml
│   └── tools/broker.mjs   # 自包含 host 插件（工具 + 模型绑定 + 状态机）
├── broker/                # broker 插件 TS 源码（参考实现）
├── prompts/               # 8 个智能体 prompt
└── docs/ARCHITECTURE.md   # 架构设计

贡献

git clone git@github.com:Tisitan/dsh-my-go.git
cd dsh-my-go
bun install
bun run build:client    # 构建 client bundle
bunx tsc --noEmit       # 类型检查
bun run test            # 冒烟测试

致谢

感谢以下开发者对 dsh-my-go 生态的独立维护与贡献：

- Tisitan/dsh-my-go：@Tisitan 的维护性 fork。
- 本项目 cherry-pick 了此下游的部分提交，尽管由于分支作者没有设置公开 Email 并禁用了 Issue 故未能取得联系，特此致谢！感谢您对开源项目的贡献。

开源的意义在于接力，感谢每一位在暗处推动轮子前进的人。

维护状态

- 仍在积极开发中，可能有少量 Bug 尚存，欢迎提交 Issue
- 已知限制：
- 子智能体模型绑定依赖 agent/request waterfall（DSH 未原生支持动态子代理模型，
见 dsh-handbook 9.2）；
- 结论注入依赖 subagent/end 事件；reportFrom 为子→父补充通道。
- 单线阻塞由 broker 状态机执行；Sisyphus 需遵守编排规则（由 system-prompt section 约束）。
- 感谢以下三位开发者：（排名不分先后）
- DeepSeek V4 Flash 0731
- DeepSeek V4 Pro 0813
- MiMo V2.5

许可证

MIT © dsh-my-go contributors