DeepSeek Harness 插件测评:Aegis 让 AI 编程 Agent 说完成前先给证据,合同通过率从 62% 提升到 93%
插件简介
Aegis 是 DeepSeek Harness 生态中的 AI 编程 Agent 方法包(Method Pack),由 GanyuanRan 开发维护。GitHub 仓库地址:https://github.com/GanyuanRan/Aegis,当前星标 1173,综合评分 69.1,最近更新时间 2026-09-07,开源协议为 MIT License。
该插件的核心定位是"让 AI 编程 agent 变得可信:少返工、更安全、说完成前先给证据"。它不是一个独立的后台服务或守护进程,而是一套可挂载到多种 AI 编程宿主上的方法包,通过基线对齐、证据验证、漂移检查和安全治理,让 Agent 在长任务中保持工程纪律。Aegis 派生自 Jesse Vincent 创建的 Superpowers 项目,在此基础上加入了面向真实软件项目的架构与证据聚焦方法层。
核心功能
基线优先,减少返工
Agent 动手前先对齐项目真实基线,包括代码所有者、接口契约和模块边界,不再靠猜测实施改动,用户也无需为 Agent 的猜错买单。
证据验证,完成声明可追溯
每个"完成"声明都附带 fresh 验证证据、覆盖范围说明和残余风险评估。用户读到的是证据而非感觉,避免 Agent 说"done"但实际未完成的情况。
安全治理,降低不安全改动
在冻结的 held-out A/B 实测中,合同通过率从 61.67% 提升至 93.33%,不安全结果率从 13.33% 降至 0%。该数据来自 20 个案例、120 次有效运行的有界建议性证据。
幽灵代码追踪
退役的 fallback 和旧路径会被显式跟踪,或附带退役触发条件后移除,技术债不再悄悄累积。
简单任务保持轻量
平凡请求留在 fast-path 快速通道,只有任务真正需要时才展开完整仪式,避免过度工程化。
多宿主通用
一套方法包可在 Codex、Claude Code、OpenCode、Kimi、DeepSeek Harness 等多种 skill-aware 宿主上获得一致体验。
安装与配置
Aegis 需通过 DeepSeek Harness 插件管理器安装。安装前需确保已安装 DSH CLI 引擎。
# 安装 DSH CLI 引擎(如未安装)
npm install -g @deepseek-ai/dsh
# 从 GitHub 源安装 Aegis
dsh plugin add GanyuanRan/Aegis
由于 npm 上存在同名包「aegis」(归属 killdream/aegis),直接通过 npm 安装可能装到错误的包。建议使用 dsh plugin add 从 GitHub 源安装,或使用 profile 模式:
dsh plugin --profile add "git+https://github.com/GanyuanRan/Aegis.git"
安装后需运行验证脚本确认安装完成:
cd <aegis-method-pack-root>
python scripts/aegis-doctor.py --write-config --json
只有当 JSON 输出包含 "ok": true、"workspaceSupport": "available" 和 "configStatus": "configured" 时,安装才视为完成。安装后需重启 DSH 宿主使配置生效。
兼容性与避坑指南
npm 同名包陷阱
npm registry 上的「aegis」包(版本 0.1.0)归属 killdream/aegis,与本插件无关。使用 npm install aegis 会安装到错误的包。必须通过 dsh plugin add GanyuanRan/Aegis 从 GitHub 源安装。
安装验证需 Python 环境
Aegis 的安装验证依赖 Python 脚本 aegis-doctor.py,环境中需有可用的 Python 解释器。验证标准较为严格,需同时满足 ok、workspaceSupport 和 configStatus 三个条件。
DSH 宿主验证级别
在 Aegis 的宿主兼容性矩阵中,DeepSeek Harness 属于"已有安装说明;release-level fresh host smoke 仍待补证"级别,并非最高验证等级。实际使用中如遇问题,建议参考官方宿主兼容性矩阵和已知限制文档。
依赖模块
Aegis 依赖 3 个 @deepseek-ai 命名空间模块:dsh-agent、dsh-llm、dsh-skill-filesystem。如出现依赖缺失,清理 node_modules 后重新安装。
非完整平台
Aegis 当前发布形态是 Method Pack(方法包),不是 daemon、不是后台 runner、不提供 authoritative GateDecision。用户当前指令和目标项目规则优先于 Aegis。
适合人群
适合:使用 AI 编程 Agent 进行真实项目开发的开发者;对代码质量和安全性有较高要求的团队;经常遇到 Agent"说完成但实际未完成"问题的用户;需要在多种 AI 编程宿主间保持一致工程纪律的用户。
不适合:仅使用 AI 进行简单问答或聊天的普通用户;没有 Python 环境无法运行安装验证的用户;希望完全零配置开箱即用的用户;对 Agent 行为额外干预敏感、不希望增加"仪式"的用户。
总结
Aegis 为 AI 编程 Agent 引入了工程纪律和证据验证机制,通过基线对齐、完成证据和安全治理,将合同通过率从 62% 提升到 93%,同时将不安全结果率降至零。对于依赖 AI Agent 进行真实开发的团队而言,这是一款值得尝试的方法包。安装时需注意 npm 同名包陷阱,务必从 GitHub 源安装并运行验证脚本。
查看插件详情页,获取完整安装命令和兼容性检查结果。
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。