返回目录

aegis

编辑精选维护状态: 活跃

ganyuanran/aegis

让 AI 编码智能体具备架构意识:基线优先、证据验证、漂移检查,保障长任务安全。

前往 GitHub项目主页
$ dsh plugin --profile <profile> add github:GanyuanRan/Aegis

1,172

星标

52

Fork

Python

语言

MIT

许可证

2026-04-30

创建于

2026-09-07

最近推送

MIT 许可的 AI 编程代理可靠性方法包,可通过 `dsh plugin add github:GanyuanRan/Aegis` 作为 profile 插件安装进 DeepSeek Harness(dsh)。

DSH 适配

兼容

作者声明

安全审计

未审计

最后核验

2026-08-21

许可证

MIT

01它能帮你完成什么?

  • Make AI coding agent runs in DeepSeek Harness safer and less prone to rework

    The agent plans against the project's real baseline before editing and completion claims ship with fresh verification evidence, covered scope and residual risk — on the project's frozen A/B benchmark, contract pass rate went 61.67% → 93.33% and unsafe outcomes 13.33% → 0%

    Developers running coding agents (DeepSeek Harness, Codex, Claude Code, OpenCode, Kimi) who want fewer reworks and safer changes on non-trivial tasks

  • Apply one discipline across every AI coding host you use, including DeepSeek Harness

    The same method pack installed on Codex, Claude Code, OpenCode, Kimi, DeepSeek Harness and other skill-aware hosts, with host-aware updates via `scripts/aegis-update.py`

    Teams standardizing agent workflows across multiple coding-agent hosts

02如何接入 DeepSeek Harness?

前置条件

  • DeepSeek Harness (`dsh`) installed and a profile selected — installation is a profile-plugin install via `dsh plugin --profile <profile> add github:GanyuanRan/Aegis`
  • Python available to run the verification scripts (`scripts/aegis-doctor.py`) from the installed method-pack root

安装步骤

  1. 01

    Give the README's quick-install prompt to your agent: read the Aegis repo, identify the host (DeepSeek Harness / dsh), and install via `dsh plugin --profile <profile> add github:GanyuanRan/Aegis` instead of silently substituting the direct-child compatibility path

    $ dsh plugin --profile <profile> add github:GanyuanRan/Aegis

  2. 02

    Restart or reload the host if needed

  3. 03

    Locate the installed `<aegis-method-pack-root>`, then run `cd <aegis-method-pack-root> && python scripts/aegis-doctor.py --write-config --json` — not from the target project directory

  4. 04

    If the host uses a separate skill discovery directory, verify it with `--discovery-root <path>`; if the host guide declares a skill directory name prefix, also pass `--discovery-name-prefix <prefix>`

  5. 05

    Complete the DeepSeek Harness host guide's native activation and automatic-entry checks (file discovery or a generic doctor result alone is not sufficient when the host provides a plugin, hook, or session-start bootstrap contract)

验证接入成功

  • Treat the install as complete only if the doctor JSON includes `"ok": true`, `"workspaceSupport": "available"`, and `"configStatus": "configured"`

03DSH 适配与能力边界

DSH 适配兼容

Installed into DeepSeek Harness (dsh) as a profile plugin via `dsh plugin --profile <profile> add github:GanyuanRan/Aegis`, with a dedicated DeepSeek Harness host guide

  • Baseline-first planning

    coding tasks in any supported host, including DeepSeek Harnessthe agent aligns with the project's real baseline — owners, contracts, boundaries — before touching code

    lazily creates CONTEXT.md / CONTEXT-MAP.md files on the first resolved domain term (glossary-only)
  • Evidence-based completion verification

    completion claims from the agentfresh verification evidence, covered scope and residual risk attached to every "done" — you read evidence, not vibes

  • Install & activation management (doctor / update)

    the installed method-pack root`scripts/aegis-doctor.py` reports install status and switches activation mode (`auto`/`explicit`) and TDD mode (`off`/`auto`); `scripts/aegis-update.py` performs host-scoped updates

    doctor runs with `--write-config` during install verification; the host must be restarted after changing activation mode
  • Explicit workflow triggers

    natural language or explicit requests in the host session`Aegis goal: ...` frames scope, success evidence and boundaries; `Grill me ...` starts a decision interview; `TDD Route: strict` / `test-first` requests strict test-first work; `aegis:first-principles-review` pressure-tests a direction

04适合谁?何时不该用?

适合

  • Developers running coding agents (DeepSeek Harness, Codex, Claude Code, OpenCode, Kimi) who want fewer reworks and safer changes on non-trivial tasks
  • Teams standardizing agent workflows across multiple coding-agent hosts

不适合

  • For DeepSeek Harness an install guide exists, but release-level fresh host smoke is still pending — the integration is documented, not yet verified per release.

05兼容性、维护与安全提示

  • Aegis is the runtime-ready Method Pack, not the full Aegis Platform, a daemon, a background runner, a runtime core, or final completion authority; user instructions and target-project rules outrank Aegis guidance.
  • For DeepSeek Harness an install guide exists, but release-level fresh host smoke is still pending — the integration is documented, not yet verified per release.
  • The benchmark numbers are bounded advisory evidence from a frozen held-out A/B benchmark, not a universal-quality or completion-authority claim.
2026-04-302026-08-19v2.8.4

MIT · actively maintained (latest release v2.8.4, 2026-08-19)

06常见问题

Aegis 如何接入 DeepSeek Harness?原生还是 MCP?

不是 MCP 方式:对于官方 DeepSeek Harness(`dsh`),全局/最小安装即原生 profile 插件安装,命令为 `dsh plugin --profile <profile> add github:GanyuanRan/Aegis`,按专门的 DeepSeek Harness 主机指南操作。仅当插件管理器不可用且你明确批准兼容模式时,才退回 direct-child 兼容路径。

如何验证安装成功?

在安装后的方法包根目录(不是你的项目目录)运行 `python scripts/aegis-doctor.py --write-config --json`。只有当 JSON 中包含 `"ok": true`、`"workspaceSupport": "available"`、`"configStatus": "configured"`,并完成主机指南的原生激活与自动进入检查,才算安装完成。

需要什么前置条件?

已安装 DeepSeek Harness(`dsh`)并选定一个 profile 用于安装,以及用于运行 doctor/update 脚本的 Python。Aegis 本身不要求额外的 API key 或账号。

有什么限制?Aegis 对项目有最终决定权吗?

Aegis 目前是运行时就绪的 Method Pack,不是完整平台、守护进程或最终完成权威;用户指令和目标项目规则优先于 Aegis 指导,基准数字只是有边界的参考证据。对 DeepSeek Harness 主机,发布级新鲜冒烟验证仍在等待中。

之后如何更新或切换模式?

说 `update Aegis` 或 `aegis:update` 即可走主机感知的更新路径(`scripts/aegis-update.py`)。激活模式默认自动,可用 `python scripts/aegis-doctor.py activation-mode explicit` 切换为显式模式并重启主机;TDD 默认关闭。

08数据与来源

  • 作者声明github.comd5bda9fb9df0…

    If the host is the official DeepSeek Harness (`dsh`), treat global/minimal installation as native profile-plugin install…

  • 作者声明github.comd5bda9fb9df0…

    `DeepSeek Harness` | Install guides exist; release-level fresh host smoke is still pending | [DeepSeek Harness](docs/REA…

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-21。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。