DSH 超级代理编排器
为命令行编码代理设置准入门槛、观察模式和人工审批,让自主工作先经过可审计的授权流程。
- Star 数
- ★ 26
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 67/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API(部分支持)
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 维护多个代码仓库的个人开发者,希望先在 observe 模式审阅代理会接手的请求,再逐步启用自动执行。
- 不适合
- 不希望自行托管守护进程和本地数据库的团队
- 需要工作者在沙箱内直接联网的团队
- 维护状态
- 近 30 天有提交最近提交 2026-11-20近 7 天每天 +0.6 ★
- 源码审查
- 67/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
这是 DeepSeek Super-agent 编排设计的独立实现,面向 Claude Code、Codex、opencode 等命令行编码代理,不要求使用 DSH 或 DeepSeek 模型。GitHub、飞书、Slack、微信、Telegram 和定时例程产生的触发会经过确定性准入门控;推断请求还可进入可选的 OpenAI 兼容评估层。SQLite 引擎维护决策、工单、来源游标和回复发件箱,观察模式只记录“本会接受”的结果,不启动工作。获准工单由任意 CLI 子进程在独立 Git worktree 中执行,可通过 PR 交付,并由审批、变更行数及可选 CI 条件控制自动合并。它以 Node.js CLI 和守护式 watch 循环部署,并提供本机面板查看待办和审计记录。
运行 dsh watch 或单次 poll 时,GitHub 及已配置的 IM Source 和 routines 读取新消息或到期任务,并使用 admission table、允许名单及 explicit/inferred 强度经 Fast Path 判定;推断候选可由 OpenAI 兼容 /chat/completions 端点评估,失败时拒绝。observe 模式写入 shadow decision 而不执行;auto 模式可创建 Ticket。dsh work 将工单交给配置的命令行 Executor,在每张工单的 worktree 和沙箱中运行,保存报告,并可推送分支及创建 PR。Engine 将状态和事件保存在 SQLite 中,Panel 展示待人工处理事项,Watchdog 可发送提醒但不授予准入权限;配置启用后,Merge Gate 按审批、head SHA、行数上限及可选 CI 条件合并 PR。
- 维护多个代码仓库的个人开发者,希望先在 observe 模式审阅代理会接手的请求,再逐步启用自动执行。
- 在多台机器运行编码代理的维护者,希望把 GitHub 和聊天消息统一进入工单流程,并通过手机 IM 审批待处理事项。
- 希望为自有仓库配置贡献机器人的团队,需要隔离 worktree、失败时不交付的工作者和带审批门槛的 PR 合并。
- 需要从代理会话日志定期生成报告的维护者,可用 routine 触发任务,并让报告以 PR 形式接受人工审核。
- 要跨工单保存仓库约定的团队,可启用两层记忆;观察模式先记录待注入事实,自动模式再将其附加到后续提示。
如何安装或部署这个 Agent?
需要 Node.js 20 或更高版本、Git 和目标仓库的 GitHub 访问凭据。README 提供 npm 启动方式,也提供从源码克隆安装的方式;init 会生成策略和 Executor 配置,默认采用 observe 模式。
如何使用这个 Agent?
npm 安装后的首次配置和运行:
这个 Agent 有哪些优点和局限?
- 准入由宿主代码强制执行,消息和引用文档不能自行授予权限;observe 模式可先积累决策证据。
- Executor 是子进程边界,可配置 Claude Code、Codex、opencode、aider 或自定义 shell 命令,并为每张工单创建独立 worktree。
- SQLite 保存工单及来源状态,支持重启恢复;PR 合并门可核验审批对应的 head SHA、变更行数及可选 CI。
- 支持 GitHub、飞书、Slack、微信和 Telegram 等来源,并可通过 OpenAI 兼容接口接入推断评估。
- 需要自行部署 Node.js 守护进程、配置策略和 Executor,并提供 GitHub 凭据;实际 IM 渠道还需各自的应用或机器人配置。
- LLM 评估依赖用户配置的 OpenAI 兼容端点和凭据;README 未说明托管模型费用。
- 默认沙箱要求 Linux 上的 bwrap 或 macOS 上的 sandbox-exec;沙箱默认禁止工作者联网,且仅允许指定环境变量。
- auto-merge 依赖 GitHub 审批身份和 PR 条件;单人操作时 README 建议使用 GitHub App 身份。
这个 Agent 与同类方案有什么区别?
README 将本项目与 Baton、Emdash、Agent Orchestrator、Claude Squad 等 CLI 编排器,以及仅面向 DSH 的官方 dsh-superagent-prototype 比较。它强调自身采用任意 CLI 子进程作为 Worker;官方原型则更深入集成 DSH session。README 所列其他编排器缺少正式准入控制,具体能力可能随项目演进。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| DSH 超级代理编排器 当前 | 67 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 26 | 1 天前 | TypeScript | — |
| Foremerge | 76 · 表现良好 | 命令行工具免费 | ★ 410 | 8 天前 | Rust | Codex · Claude Code |
| Bernstein | 74 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.2k | 今天 | Python | Codex · Claude Code · OpenAI API |
| Superset | 66 · 存在缺口 | 桌面应用免费版 + 付费版 | ★ 16k | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
信任维度整体有真实设计支撑:准入表、explicit/inferred 二分、observe→auto 阶梯、破坏性动作双键确认、合并门要求允许名单非机器人审批且钉住 head SHA,这些都在 README 与设计文档中具体描述,测试文件也覆盖了数字形状、双键、过期等语义,故 user_confirmation 给 3。但 least_privilege 只到 2:执行器以任意 CLI 子进程运行,沙箱默认开启但仅凭 README 断言,未见沙箱实现源码;blockedCommands 与 30 分钟进程组超时是加分项。data_flow_transparency 给 2:README 说明了数据流向(GitHub/飞书/Slack/微信/Telegram、SQLite、OpenAI 兼容端点),但未系统列出哪些数据被发送到外部 LLM 端点。sensitive_data_handling 仅 1:涉及 GITHUB_TOKEN、App 私钥、微信登录凭据、IM token,README 提到凭据存于 engine db 与每小时轮换的安装令牌,但未见加密、脱敏或日志中密钥处理的证据。dependency_security 仅 1:依赖含 better-sqlite3、Slack/飞书 SDK、qrcode 等,package.json 用 ^ 范围且未见审计或漏洞缓解说明,CI 仅做 npm ci 与测试。external_effects 给 2:外部副作用(开 PR、合并、发消息)有门控与默认关闭的 auto-merge,但副作用面很宽。rollback 给 2:停止即终态、PR 可回退、promote 产生 PR 而非直接合并,但未见对已合并变更或已发消息的回滚机制。source_attribution 给 3:明确声明独立社区项目、非 DeepSeek 官方,给出文章与原型链接及 Design credits 章节。
self_consistency 给 2:README 的状态表、版本号(package.json 1.5.0)与设计文档大体一致,但 README 中“Evidence ledger + stream”一行重复出现两次,且部分版本标注(v0.6 与 v0.6 并列、v1.4/v1.5 混排)略显混乱,属于可指出的不一致。dependency_availability 仅 1:依赖 Node>=20、better-sqlite3 原生模块、bubblewrap 沙箱、多个 IM SDK,README 未给出离线或降级路径,CI 注释还提到 lockfile 曾指向腾讯内网镜像,说明依赖获取存在环境敏感性。failure_messages 给 2:CLI 有 die() 统一错误、doctor 退出码 0/1/2、App 认证失败给出可操作错误(测试断言 /is the App installed/),但未见对执行器超时、LLM 失败等场景的完整错误文案证据。
audience_and_scenarios 给 3:README 列出四类真实使用场景(observe 优先自治、跨机器个人集群、贡献机器人、定时报告引擎),并明确面向“任意 CLI 编码代理”的运维者。capability_boundaries 给 3:设计文档明确列出 IM 可批准与不可批准的事项(GitHub 合并审批、策略变更、创建工作均不可),并说明非目标。trigger_precision 给 3:explicit/inferred 二分、数字形状严格匹配('1.'、'ok 1'、'12' 均不匹配)、群聊数字视为闲聊、fail-closed 的 @ 提及检测,测试也覆盖这些边界。environment_fit 给 2:支持多 IM 渠道与多执行器,但强依赖 Node 20+、原生模块与 bwrap,Windows/WSL 等环境适配只在 README 提及,未见具体证据。
information_architecture 给 2:README 结构清晰(Why/How/Status/Quick start/渠道/设计),但极长且状态表与正文重复,docs/designs 有设计文档,整体可读但臃肿。install_notes 给 2:有 npx init 向导、非交互模板、手动 clone 路径与各渠道一次性配置步骤,但缺少对失败安装的排障说明。naming_stability 给 2:包名 @vicfei/dsh-super-agent、bin dsh-super-agent、命令集稳定,但 README 中版本号与功能标注存在漂移。examples_and_faq 给 2:有 examples/policy.json、executor.json、COOKBOOK 与 demo GIF,但未见独立 FAQ。known_limitations 给 2:README 提到微信媒体仅占位、群聊 @ 解析不可靠、单操作者需 App 身份等限制,但未集中成限制章节。license 给 3:MIT LICENSE 文件完整,package.json 与 README 一致。versioning_changelog 给 2:有语义化版本与状态表标注 since 版本,但未见独立 CHANGELOG 文件。maintenance_responsibility 仅 1:发布者为未验证身份,README 未说明维护者承诺、支持渠道或安全披露流程,仅有 CI/publish 工作流。
output_usability 给 2:输出包括门控判定行(ACCEPT/WOULD-ACCEPT/IGNORE)、tickets 阶段、面板、PR 与 IM 回执,形式可用,但未见结构化输出或机器可读报告的完整证据。marginal_value 给 2:它填补了“准入控制”这一被其他编排器跳过的环节,价值主张具体;但同类编排器众多,且其核心价值依赖用户已有 GitHub/IM 基础设施,边际价值中等。cost_benefit 仅 1:部署需要 Node 20+、原生模块、bwrap、GitHub App 或 PAT、多个 IM 应用注册与长期守护进程,运维成本较高,而收益集中在准入与审计,README 未量化成本收益。
claim_traceability 给 2:README 的多数主张可追溯到设计文档、测试文件或具体命令(如 dsh events verify、doctor 退出码),但“290 tests”“真实合并 PR”等数字无法在包内独立核实。cross_source_corroboration 给 2:README、设计文档、测试与 CI 工作流相互印证(如双键、数字形状、App 认证),但沙箱、内存、账本等关键实现源码不在包内,无法交叉验证。fact_inference_separation 给 2:README 大体区分了设计意图与已实现状态(状态表标注版本),但“Every line in this GIF is real output”等断言与推断混排,且部分版本标注混乱,削弱了区分度。
- 执行器以任意 CLI 子进程运行,沙箱默认开启仅为 README 断言,包内未见沙箱实现源码;在生产环境使用前应自行审查沙箱与 blockedCommands 的实际约束。
- 涉及 GITHUB_TOKEN、GitHub App 私钥、微信登录凭据与多个 IM token,未见加密、脱敏或日志密钥处理证据,应自行确认凭据存储与轮换策略。
- 依赖含原生模块 better-sqlite3 与多个第三方 SDK,使用 ^ 版本范围且无审计说明;CI 注释显示 lockfile 曾指向内网镜像,安装前应核对依赖来源。
- 发布者身份未经 FollowAgents 验证,README 未说明维护承诺或安全披露流程;升级前应评估维护可持续性。
- README 中版本标注与状态表存在重复和漂移(如 Evidence ledger 行重复、v0.6 并列),部分能力声明无法在包内独立核实。
常见问题
必须使用 DeepSeek 模型或 DeepSeek Harness 吗?
/chat/completions 端点,也可不启用 LLM 评估。观察模式会启动代理执行任务吗?
工作者能访问网络或 GitHub 凭据吗?
GITHUB_TOKEN 不会传给工作者。需要工作者自有认证环境变量时,必须配置在 passEnv 中,受限制的密钥类名称会被拒绝。自动合并如何判断是否可以合并?
项目有哪些运行时和部署要求?
DSH 超级代理编排器 免费吗?
DSH 超级代理编排器 开源吗?
DSH 超级代理编排器 安全吗?
DSH 超级代理编排器 还在维护吗?
谢谢反馈,我们会据此改进页面。