dsh-tower
提供基于Git工作区隔离的任务交付协议 适合需要对Git仓库进行多任务拆分、隔离写入和合并审查的开发场景。
同名套件的其他儲存庫
安裝
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:louifinn/dsh-tower說明文件
閱讀完整 README ↗何时使用 Tower
Tower 是面向 Git 仓库变更的交付协议,不是所有多代理场景的默认答案。它适合:
- 一个特性/重构能拆成 2–8 个 scope 清晰、可独立审查的 mission;
- 有依赖顺序、需要分支新鲜度与 scope 约束的迁移;
- 敏感仓库、发布绑定变更,或需要"可审计合并 + 测试证据"(需要时开启独立审查)的工作;
- 跨上下文压缩、重启、多天协作,需要从本地状态恢复的工作;
- 需要把"完成"定义成任务 + 测试(可选独立审查),而不是聊天里的一句"好了"。
不适合:单文件/一行 hotfix、需求仍在探索、开放式研究、大量极小的独立任务、交互式 UI 配对、或跨仓库工作。判断标准:如果你不会为它开 PR,Tower 很可能太重。
与其他模式的区别(详见完整指南):
- 普通并行子代理:便宜、灵活,适合只读探索/试方案;没有 worktree、审查与合并门禁。
- Agent Teams:共享任务板与多人/多 agent 协作,适合设计、研究、横切决策;集成通常由人做,没有 Git 隔离的硬门禁。
- Ralph 循环:用新鲜 agent 对同一目标反复尝试,适合迭代搜索/修复;没有 mission 契约与合并审查。
- Workflow 编排:脚本化高扇出/流水线,适合批量分析、审计、验证;不做 Git 分支隔离与合并门禁。
- Tower:少量 mission + 隔离写入 + 可选独立审查 + 证据 + 合并门禁,适合"决定要做、需要安全落地"的仓库变更。
Tower 模式会拒绝 Team/Workflow/Ralph/普通 subagent 工具并清除 plan mode,避免两套编排协议同时驱动一个会话;请按阶段组合,例如先用 Workflow/Team 分析决策,再用 Tower 执行仓库变更。
配置
- id: tower
name: 'dsh-tower'
config:
section: '(可选,兼容别名)覆盖 Tower 模式系统提示文案'
allowAgentControl: true # 兼容别名;等价于 mode.allowAgentControl
mode:
allowAgentControl: true
autoPauseGoal: true
denyTools: [create_goal, todo_write, team_task_create, team_task_update, team_task_reopen, spawn_teammate]
review:
requireReview: false # 默认审查可选;需要强制独立审查时改为 true
maxRoundsPerReviewer: 5
merge:
timeoutMs: 900000
worktrees:
root: '' # 空 = /.dsh-tower-worktrees/
spawn:
workerPreset: tower-worker
reviewerPreset: tower-reviewer
maxDepth: 1
- 代码中
mode.allowAgentControl默认false;随包cordis.patch.yml设为true:模型可在用户意图/任务状态明确时自行进出,但必须给出理由;设为false时只有人类能切换。随包 patch 还默认开启mode.workspaceLock(单活塔)、send.interruptDefault、init.autoGitInit,并把spawn.staleMs设为 15s。 /tower base可设置会话级 init base 偏好;/tower on会清除活跃 plan mode(mode.planModePolicy:"refuse"则拒绝进入),保证 plan/tower 互斥。- 仓库级配置:在
/dsh-tower/config.json(通常是.git/dsh-tower/config.json)放入同样的 JSON 结构,可覆盖review/merge/worktrees/spawn;优先级为代码默认 < profile < 仓库配置 < 工具参数。mode.*属于会话级,只在 profile 生效。 - 所有键与默认值见 docs/reference/config.md;未知顶层键会被拒绝(防止拼写错误静默失效),嵌套分组内的未知键会被忽略。工具错误码见 docs/reference/errors.md。