Aegis
GanyuanRan/Aegis
面向编码 Agent 的软件工程方法包,提供基线优先规划、系统化调试、提示词卫生、完成前验证,以及修复/退役双轨跟踪技能。
安装
把 Aegis 装进 DeepSeek Harness
GitHub 方式 · GitHub 源码
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
桌面版有自己的 profile,叫 desktop,只认它自带的 dsh 命令——npm 装的 dsh 会直接拒掉这个 profile。先在应用菜单里点 Manage dsh Command… 装上这个命令,打开一次桌面版再彻底退出,跑下面这条,然后重新打开桌面版。
GitHub 方式 · GitHub 源码
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/desktop/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
我们的实装是在 npm 版 dsh 的 web profile 里跑的,没在桌面版上跑过。
我们跑过之后
我们跑过,装得上
这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 11 天前,DeepSeek Harness 0.2.2-rc.1.
挂进你的 README
给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。
安装前须知
装 Aegis 之前,先看这几条
- 源码在这里: GanyuanRan/Aegis——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:MIT。
安全
装 Aegis 会执行什么
- 构建脚本
我们这次实装里没有构建脚本被拦。
来源:我们在沙箱里的实装,DeepSeek Harness 0.2.2-rc.1,11 天前。
- 安装钩子
package.json 里没有 preinstall / install / postinstall 脚本。
来源:最近一次同步时读到的 GitHub 上的 package.json。prepare 没有记录——它只在从 GitHub 装时执行,被 pnpm 拦下时会出现在「构建脚本」那一行。
- README 里提到
shell 命令(bash、exec、spawn 之类)
来源:对 README 做的关键词匹配,只提示它可能碰到什么,不是代码分析。
这不是安全审计。上面是一次实装记录加两次文本扫描,没有人替你读过这个插件的代码。插件带着你 agent 的权限在跑。
AI 锐评
是什么 — 把 coding agent 按纪律推进:对照现有基线做规划,系统排查问题,完成前交出证据,并记录修复与下线。
谁该装 — 用 DeepSeek Harness 改已有契约和边界的仓库时,agent 跳过基线直接动刀,收工也不报覆盖范围。 只让它解释代码或起草注释、从不授权改逻辑或跑验证的人,加了没有落点。
注意 — 沙箱里在全新 profile 装上,并被 harness 注册进 profile。它会执行 shell 命令。README 里的 contract 通过率从 61.67% 到 93.33%、不安全结果从 13.33% 到 0%,写明是 Aegis 2.7.6(2026-08-11)的冻结 A/B,不是对本发行版的测量。
锐评 — 装。我要的是收工闸门,不是又一个会写总结的 skill。
grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。
Aegis 是做什么的

Aegis 是一个 DeepSeek Harness 插件,为编码 agent 提供一套软件工程方法:基线优先规划、系统化调试、提示词卫生、完成前验证,以及修复与退役的双轨跟踪。它不是新的代码执行工具,而是把这些规则投射到支持技能的宿主中。开始修改前,agent 需要先对齐项目真实基线,包括所有者、契约和边界;宣称完成前,要给出新鲜的验证证据、说明覆盖范围并记录剩余风险。旧 fallback 和旧路径则应关联退役触发条件,避免成为无人跟踪的技术债务;简单任务仍可走快速路径。
它适合需要明确规划和可审计证据的编码工作流。如果宿主不能加载 skill,或现有流程已经提供同等的规划与验证机制,安装 Aegis 的收益有限。README 还要求完成宿主原生激活和自动入口检查,不只确认文件已发现。
检测到的终端风险来自验证流程:插件会通过终端运行 python scripts/aegis-doctor.py --write-config --json,并可使用 discovery 参数检查安装、配置和 workspace 支持,因此实际触达范围取决于 agent 在当前环境中的终端权限。
Aegis 的文档
行为说明
Aegis 将方法包投射到支持 skill 的编码宿主中,覆盖基线优先规划、系统化调试、提示词卫生、完成前验证,以及修复/退役跟踪。基线应包含项目所有者、契约和边界;完成声明应带有新鲜证据、覆盖范围和剩余风险。简单请求可以继续走快速路径。
命令
README 要求先定位 <aegis-method-pack-root>,再在该目录执行:
cd <aegis-method-pack-root> && python scripts/aegis-doctor.py --write-config --json
只有 JSON 同时包含以下结果,安装才算完成:
| 字段 | 要求值 |
|---|---|
ok |
true |
workspaceSupport |
available |
configStatus |
configured |
--write-config 写入 doctor 流程使用的配置,--json 输出机器可读结果。不要在目标项目目录运行 doctor。
宿主激活
官方 DeepSeek Harness(dsh)应使用原生 profile-plugin 安装方式:dsh plugin --profile <profile> add github:GanyuanRan/Aegis。只有在 plugin manager 不可用且明确批准 compatibility mode 时,才使用 direct-child compatibility 路径。宿主若定义了 plugin、hook 或 session-start bootstrap contract,还必须完成原生激活和自动入口检查。
发现参数
宿主使用独立 skill discovery 目录时,额外传入 --discovery-root <path>;宿主指南规定目录名前缀时,再传入 --discovery-name-prefix <prefix>。README 提到 Codex、Claude Code、OpenCode 和 Kimi 等支持 skill 的宿主。
根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README
同一分类
Aegis 的同类插件
answer-me-with-html
QingYunA
把回答做成一页可视化 HTML:模型只写简短的 Markdown 草稿,随包附带的 `am` 命令行生成页面,支持流程图、时序图、树、时间线、ER 图、表格和提示框。
我们跑过,装得上
skillhub
iflytek
在 DeepSeek Harness 内浏览、搜索 SkillHub 技能,并管理本地技能的安装、更新和卸载。适配 DSH 0.2.0-rc.2 与 0.2.1-rc.2,暂不兼容 0.2.1-rc.3。
没有一行式安装命令——这个插件在一个大仓库的子目录里,也没发 npm 包。
vox-director
Alisa0808
Turn one topic into a finished Vox-style paper-collage explainer/ad video — automated end to end on Atlas Cloud + ffmpeg. An agent skill.
我们跑过,装得上
new-term-radar
zhuyansen
Daily radar for new AI terms: names of new models, products and repos, caught on X, Hugging Face, GitHub and sitemaps before keyword tools list them.
我们跑过,装得上