Menghuan1918/dsh-apollo

Name: Menghuan1918/dsh-apollo
Author: Menghuan1918

Plugin插件 Native原生 ⭐ 4 GPL-3.0 Productivity & Tasks效率与任务 Sessions & Context会话与上下文

把单一会话不可能的巨任务拆成无数可验证子系统，大规模并行有纪律执行

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This is a plugin for DeepSeek Harness (DSH). It provides workflow skills for splitting large tasks and an "Engineering Mode" agent preset for coding work. It breaks down large tasks into independently verifiable subtasks for wave-by-wave execution. Suitable for large coding and infrastructure tasks. Note that skills and presets have no hot update, changes require a DSH restart.

这是DeepSeek Harness（DSH）的插件，提供拆分大任务的流程技能和面向编码任务的「工程模式」Agent预设，可将一次做不完的大型任务拆分为可独立验证的子任务逐波执行。适用于处理大型编码与基础设施任务，注意技能和预设无热更新，修改后需重启DSH进程生效。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我了解并安装插件：【dsh-apollo】【https://github.com/Menghuan1918/dsh-apollo】

Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add github:Menghuan1918/dsh-apollo

把 Menghuan1918/dsh-apollo 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

10.6 KB · 缓存于 2026-09-12 19:38:13 · 10.6 KB

dsh-apollo

一次会话做不完的大任务，拆成可独立实现、可独立验证的子任务：逐波并行执行 → 子代理只读审查 → 验证通过才合入。

DSH（DeepSeek Harness）插件，包含两部分：

流程技能：把大型需求拆成协同 Spec，逐波 worktree 执行、内置子代理代码审查、验证后合入；单个边界明确的任务走 main-agent-driven-development，其实现节点依赖本包捆绑的 tdd 与 diagnosing-bugs。全部节点基于 DSH 原生能力（subagent / workflow / 后台任务），不依赖外部执行后端，对任何 preset 生效。
「工程模式」（eng）agent 预设：面向编码与基础设施任务的 preset（工具目录、委派、压缩与提示词组合），带退出守卫——回合结束前仍有运行中的子代理或后台任务时不允许收尾（默认关闭，在 eng.json 或设置面板里打开）。
设置面板：设置页 → Plugins → 「工程模式」，读写退出守卫开关，保存即时生效。

零依赖、无构建步骤，纯 ESM。

安装

# 从 GitHub 装（推荐）
dsh plugin --profile <name> add github:Menghuan1918/dsh-apollo

# 或本地目录
dsh plugin --profile <name> add link:/path/to/dsh-apollo

dsh --profile <name> --dump-config   # 应出现 "# == dsh-apollo" 层与 apollo-skills 行

重启该 profile 的 dsh 进程后生效：

新会话的技能目录包含下列流程技能（技能注册在全局层，任何挂载 tool-skill 的 preset 都看得到）；
包内 presets/eng/ 被同步进 <dshHome>/.agent-presets/eng，预设选择器里出现「工程模式」。预设根虽在启动早期扫描，但同步发生在首个请求之前，一次重启即可（2026-09-12 在隔离 DSH_HOME 上实测：首次启动后副本已存在且与包内校验和一致）。

把工程模式设为默认（用户级设置，不随仓库分发）：

# ~/.dsh/settings.yaml
agent-presets:
  default: eng

卸载：

dsh plugin --profile <name> remove dsh-apollo
# 同步副本不会自动删除，需要时手动清理：
rm -rf ~/.dsh/.agent-presets/eng

流程技能

技能	入口	职责
brainstorming	`/brainstorming`	把大型需求设计为获批的主 Spec + 子 Spec
exec	`/exec`	逐 Spec worktree、波次 workflow 执行、合并、最终代码审查
dev	被 `/exec` 引用	实现与审查节点的 prompt 契约、报告 schema、失败语义
main-agent-driven-development	`/main-agent-driven-development`	单个边界明确的实现任务（预建/独立 worktree 模式）
tdd	被 `main-agent-driven-development` 引用	红→绿循环的参考：好测试的标准、seam 选择、反模式
diagnosing-bugs	被 `main-agent-driven-development` 引用	难 bug 的诊断纪律：先建反馈循环，再假设、定位、修复
code-review	`/code-review`	双轴（Standards/Spec）并行子代理代码审查
handoff	`/handoff`	把当前对话压缩成交接文档

约定：

Spec 落盘优先 .workspace-docs/specs/（工作区有该约定时），否则目标仓库自己的 specs 目录；写入 .workspace-docs/ 时带 OKF 头。
交接文档（/handoff）同理落 .workspace-docs/notes/，会话内已有交接则整篇复写。
质量档 = 本会话可用的最强模型，在 exec 的 workflow 脚本顶部一处定义（quality 常量）；留空即由子代理继承父会话路由，任何环境都能跑。要固定档位就在那一处写 provider / model。
可视化辅助写自包含静态 HTML 到系统临时目录，不起服务；DSH 界面直接打开预览，反馈走对话。

工程模式预设（eng）

presets/eng/ 是一棵完整的 preset 树，启动时同步进用户预设根：

文件	作用
`agent.cordis.yml`	preset 组合（改编自 DSH 内置 standard preset，MIT，见 `presets/eng/NOTICE`）：工具、委派、plan mode、压缩与提示词段
`preset.yml`	预设元数据（名称「工程模式」）
`plugins/exit-guard/`	退出守卫：`agent/turn-stopping` 时若有运行中的直接子代理或后台任务，注入提醒强制回合继续
`plugins/wait-subagent/`	`wait_subagent` 工具：一次调用并发等待全部直接子代理，只回短 done 行，内容交还框架的 settlement notice
`plugins/mode-instructions/`	eng 专属提示词段：退出守卫契约 + 子代理委派/编排纪律（只写其它表面未述的 delta；委派纪律原在全局 `~/.dsh/AGENTS.md`，2026-09-11 迁入；模型档位留在全局，因其跟随本机路由配置）
`plugins/lib/atlas-config.js`	`<dshHome>/eng.json` 读取（旧名 `atlas.json` 只读回退）

预设是内置 standard 的整棵拷贝（DSH 没有 extends/include 机制，插件也无法新增预设根）。拷贝就会漂移：node --test 里的 tests/upstream-drift.test.mjs 拿本机 DSH 的 standard 对照，上游有而 eng 没有的行直接判失败并列出该补哪一行，并挡住未声明的配置差异。2026-09-12 补回的上游行是 @deepseek-ai/dsh-tool-present（缺失时静默没有 present 工具）。

同步是整体覆盖：包内树与副本不一致时整棵重写，并删除源树没有的文件。不要把自己的内容放进 <dshHome>/.agent-presets/eng——首次启动就被清掉。

运行时配置

<dshHome>/eng.json：

{
  "exitGuard": false
}

exitGuard（默认 false，显式开关）：退出守卫总开关。每次回合结束前重读，改配置即时生效，无需重启。
旧文件名 atlas.json 仍会被读取（仅当 eng.json 缺失或损坏）；写入永远落 eng.json，面板首次保存即完成迁移。
文件缺失/损坏/形状非法一律回退默认关闭，绝不抛错：配置故障既不该让守卫意外生效，也不该让回合结束路径崩溃。

守卫只在开启时介入，且只看 DSH 本地的 job 注册表与直接子代理：需要跨回合常驻的服务（dev server、watcher）用 pm2/systemd/nohup 等脱离 job 注册表的方式管理，或保持开关关闭。用户中断（Esc）不受守卫影响。

设置面板

设置页 → Plugins 分区 → 「工程模式」标签页（开关 + 保存，即时生效）。面板经 host 半边的自有路由 /eng-panel/api/config 读写 eng.json，默认仅接受 loopback Host + 同源标志（DNS-rebinding / 跨站防御）。

经反向代理域名访问 GUI 时，把该权威加入 profile 层这一行的 config：

# ~/.dsh/profiles/<name>/cordis.patch.yml
- id: apollo-skills
  config:
    trustedHosts: [dsh.example.com]
    # 可选：让官方 client 把反代页面视作 loopback，设置页回到 host 持久化。
    # 安全边界随反代信任，仅在受信代理下开启。
    declareOwnsHost: true

机制

cordis.patch.yml 只插入一行宿主插件 apollo-skills（裸包名 dsh-apollo）。单行是硬约束，不是偏好：

浏览器半边（dsh.client → exports["./client"]）由该行的包清单发现，而 dsh-client-modules 只接受裸包名或两段 scoped 名，并且拒绝第二个解析到同一包名的活跃行；
DSH 只扫描内置预设根与 <dshHome>/.agent-presets，profile patch 无法新增预设根——所以包内预设只能在上电时同步进用户根（sync-on-boot，参照 dsh-web 生态的 dsh-liangshen）。

因此这一行的 node 半边（src/index.js）承担三件事：

src/index.js — 扫描包内 skills/*/SKILL.md，解析 frontmatter（name / description / whenToUse / disable-model-invocation / user-invocable，其余键进 metadata），以 rank 600 注册到 ctx.skills 全局层。技能正文中的相对资源引用按该技能目录解析。
src/preset-sync.js — 把 presets/ 逐字节幂等同步进 <dshHome>/.agent-presets：已一致则跳过，变更整体重写并清理源树不含的多余文件，不触碰插件不拥有的预设目录。
src/panel.js — 注册 /eng-panel/api/config 路由；declareOwnsHost: true 时装配 <head> 注入 tap。

无 watcher：技能与预设内容随包版本走，改动在进程重启后生效。

已知限制

技能内容与预设无热更新，改完需重启对应 profile 的 dsh 进程。
exec 的 quality 常量默认为空（子代理继承父会话路由），要固定质量档就在 skills/exec/SKILL.md 脚本顶部那一处写 provider / model；会话若启用了 subagent-model-selection 策略，路由必须落在本机允许清单内，否则显式档位会被直接拒绝。
presets/eng/agent.cordis.yml 逐行引用上游 @deepseek-ai/dsh-* 包名，跨版本升级 DSH 后先 node --test：漂移自检会列出上游新增而 eng 未跟上的行；再重启。
package.json 只声明了 react peer，没有声明 @deepseek-ai/cordis 与各 @deepseek-ai/dsh-* 的版本 peer——同生态插件（如 dsh-better-sidebar）会声明这些，缺了它们升级 DSH 时没有版本门禁，pnpm 的严格 peer 配置下也可能装不上。
技能正文是中文的（含进技能目录的 description），/exec 注入子代理的 prompt 也是中文；非中文用户需要自行改文案。
本包按 link: 或本地路径安装使用；未发布到任何 registry，仓库也还没有 remote。

开发

node --test          # 72 例：技能 provider、捆绑技能目录、预设同步、预设漂移自检、配置读取、退出守卫、wait_subagent、面板路由

presets/eng/ 是仓库内的唯一事实源，<dshHome>/.agent-presets/eng 是启动时同步出来的副本——不要直接编辑副本，下次启动会被覆盖。跑 node --test 会顺带把源树同步进副本（漂移自检的一部分），所以改完预设先跑测试再重启。

许可

本包整体以 GPL-3.0-or-later 发布，全文见 LICENSE。

捆绑的两部分来自 MIT 许可的上游，其原始许可与署名一并保留（GPL-3.0 与 MIT 兼容）：

内容	来源	许可
`presets/eng/agent.cordis.yml`（改编自 DSH 内置 `standard` 预设）	DeepSeek Harness	MIT，见 `presets/eng/NOTICE` 与 `third-party/LICENSE-MIT-dsh-standard-preset`
`skills/tdd/`、`skills/diagnosing-bugs/`	mattpocock/skills	MIT，Copyright © 2026 Matt Pocock，见 `third-party/NOTICE-mattpocock-skills`

渲染基于仓库 Menghuan1918/dsh-apollo 的 README.md。在 GitHub 查看原文 →

CLI Install命令行安装 Copy Install复制安装命令