DSH 超级代理编排器

为命令行编码代理设置准入门槛、观察模式和人工审批,让自主工作先经过可审计的授权流程。

Star 数
★ 26
最近更新
1 天前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具自托管服务网页应用
可在哪里用
通用 · 跨平台Codex · Claude Code · OpenAI API(部分支持)
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Node.js ≥ 20GitGitHub 令牌或 GitHub App 凭据Shell / 命令行网络访问本地文件系统
典型场景
维护多个代码仓库的个人开发者,希望先在 observe 模式审阅代理会接手的请求,再逐步启用自动执行。
不适合
  • 不希望自行托管守护进程和本地数据库的团队
  • 需要工作者在沙箱内直接联网的团队
维护状态
近 30 天有提交最近提交 2026-11-20近 7 天每天 +0.6 ★

这个 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。

  1. 维护多个代码仓库的个人开发者,希望先在 observe 模式审阅代理会接手的请求,再逐步启用自动执行。
  2. 在多台机器运行编码代理的维护者,希望把 GitHub 和聊天消息统一进入工单流程,并通过手机 IM 审批待处理事项。
  3. 希望为自有仓库配置贡献机器人的团队,需要隔离 worktree、失败时不交付的工作者和带审批门槛的 PR 合并。
  4. 需要从代理会话日志定期生成报告的维护者,可用 routine 触发任务,并让报告以 PR 形式接受人工审核。
  5. 要跨工单保存仓库约定的团队,可启用两层记忆;观察模式先记录待注入事实,自动模式再将其附加到后续提示。

如何安装或部署这个 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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
67/ 100 五分制 3.4 / 5
信任安全 19/29
可靠稳定 8/14
适用触发 16/18
规范维护 12/18
有效结果 7/13
证据核验 5/8
查看各维度的扣分理由
信任安全19 / 29 · 3.3/5

信任维度整体有真实设计支撑:准入表、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 章节。

可靠稳定8 / 14 · 2.9/5

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 失败等场景的完整错误文案证据。

适用触发16 / 18 · 4.4/5

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 提及,未见具体证据。

规范维护12 / 18 · 3.3/5

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 工作流。

有效结果7 / 13 · 2.7/5

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 未量化成本收益。

证据核验5 / 8 · 3.1/5

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 并列),部分能力声明无法在包内独立核实。
证据充分度:低 评估于 2026年11月12日 审查版本 d1d14dba2670 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/dsh-super-agent.svg?lang=zh)](https://followagents.com/zh/agents/dsh-super-agent)
<a href="https://followagents.com/zh/agents/dsh-super-agent"><img src="https://followagents.com/badge/dsh-super-agent.svg?lang=zh" alt="FARS 评测"></a>

常见问题

必须使用 DeepSeek 模型或 DeepSeek Harness 吗?
不需要。项目不要求 DSH 或 DeepSeek 模型;推断评估可配置任意 OpenAI 兼容 /chat/completions 端点,也可不启用 LLM 评估。
观察模式会启动代理执行任务吗?
不会。正向评估会记录为 would accept,观察模式不执行工作;可审阅记录后再将范围切换到 auto。
工作者能访问网络或 GitHub 凭据吗?
默认沙箱禁止网络,并通过环境变量允许名单限制子进程可见内容;README 明确指出 GITHUB_TOKEN 不会传给工作者。需要工作者自有认证环境变量时,必须配置在 passEnv 中,受限制的密钥类名称会被拒绝。
自动合并如何判断是否可以合并?
启用 Merge Gate 后,PR 必须由代理创建,需有允许名单中的非机器人在当前 head SHA 上批准,变更行数不超过上限,且没有仍有效的变更请求;可选要求 CI 全绿。
项目有哪些运行时和部署要求?
README 的 doctor 要求 Node.js 20 或更高版本。项目通过 CLI 和 watch 守护循环运行,状态保存在本地 SQLite;启用默认沙箱时还需对应平台的沙箱包装器。
DSH 超级代理编排器 免费吗?
软件本身免费,但 DSH 超级代理编排器 要调用 AI 模型,模型的调用费用由你向模型服务商支付(也可以接本地模型)。
DSH 超级代理编排器 开源吗?
开源。源码在 GitHub(vicfei/dsh-super-agent),许可证是 MIT。
DSH 超级代理编排器 安全吗?
FollowAgents 的 FARS 评审(2026年11月12日)给 DSH 超级代理编排器 的“信任与安全”打了 19/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
DSH 超级代理编排器 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-20,在最近 30 天内。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念