前言¶
用 DeepSeek Harness（DSH）做長任務開發時，常見痛點並不在「模型不夠聰明」，而在流程失控：智能體還沒摸清項目邊界就改代碼，改完一句「已完成」卻拿不出驗證證據，簡單修 bug 也被拉成長篇流程。社區插件庫 SkillHub 上有一款工作流類插件 Aegis（ganyuanran/aegis），GitHub 星標已逾 1100，維護者爲 GanyuanRan。它把「基線優先、證據驗證、漂移檢查」做成可安裝的方法包，目標很明確：少返工、改得更穩、別盲信「做完了」。
DeepSeek Harness 的核心理念是「一切皆插件」；SkillHub 等社區目錄便於檢索與安裝，但與 DeepSeek / 幻方並無官方從屬關係，下文安裝方式以插件倉庫與 GitHub 原文爲準。
這是什麼¶
Aegis 是一個 Aegis Method Pack（方法包），不是後臺守護進程，也不是獨立的運行時核心。一句話定位：讓 AI 編程智能體在動手前先對齊項目真實基線（負責人、契約、邊界），完工前用新鮮證據證明結果，簡單任務走快路徑，複雜任務才展開完整流程。
插件在 SkillHub 目錄頁標註爲「工作流」分類，當前版本 v2.8.8；GitHub 倉庫採用 MIT 許可證。項目自述源自 Jesse Vincent 的 Superpowers 思路，並在此基礎上增加了面向真實軟件項目的架構與證據層。
核心功能與亮點¶
1. 基線優先，減少盲目改動¶
智能體在改代碼前會先對齊項目現狀：模塊歸屬、接口契約、改動邊界。目標是停止「猜架構、猜約定」，從源頭降低返工。
2. 證據驗證，告別「感覺做完了」¶
完成聲明需附帶可覈對的驗證證據、覆蓋範圍與殘餘風險說明。用戶讀的是證據鏈，而不是一句口頭確認。
3. 複雜度治理：簡單任務不折騰¶
瑣碎請求走 fast-path，只在任務風險確實需要時才展開完整儀式。README 將此稱爲 Workflow Quality：輕活保持輕，重活才加重流程。
4. 退役與漂移管理¶
對過時回退路徑、廢棄實現做跟蹤或清理，避免「幽靈代碼」在倉庫裏靜默堆積；長任務中持續做漂移檢查。
5. 多宿主一套方法¶
同一套紀律可在 Codex、Claude Code、OpenCode、Kimi 及 DeepSeek Harness 等支持 Skill 的宿主上使用。對 DSH 用戶，官方文檔 docs/README.deepseek-harness.md 提供了專門的 profile-plugin 安裝與驗證流程。
6. 可量化的基準參考（附邊界說明）¶
項目在 Aegis 2.7.6 上做過凍結的 A/B 對照基準：在 20 個用例、120 次有效運行中，契約通過率從 61.67% 升至 93.33%，不安全結果從 13.33% 降至 0%。README 明確標註這是有界參考證據，不代表普適質量承諾或最終完成權威；評審爲技術向、非獨立人工審計。寫文章時保留這一數據，同時保留其限定語。
安裝與啓用¶
安裝前請確認本機已具備 dsh 與 pnpm（Harness 的 dsh plugin 會轉發到 pnpm，僅能用 npx 啓動 Web UI 並不足夠）：
dsh --version
pnpm --version
默認方式：profile 插件 Bundle 安裝¶
以 Web profile 爲例，在每個需要啓用 Aegis 的 profile 中單獨安裝（裝在一個 profile 不會自動作用於另一個）：
dsh plugin --profile web add "git+https://github.com/GanyuanRan/Aegis.git"
若使用 Headless profile，需另行執行：
dsh plugin --profile headless add "git+https://github.com/GanyuanRan/Aegis.git"
需要固定版本時，可釘住 release tag：
dsh plugin --profile web add "git+https://github.com/GanyuanRan/Aegis.git#v2.8.8"
注意：官方文檔要求使用完整的 git+https:// 形式，不要簡寫爲 github:GanyuanRan/Aegis，部分 DSH/pnpm 組合會把簡寫解析爲 SSH 路徑，導致未配置 GitHub SSH 密鑰時安裝失敗。
安裝後不要在 $DSH_HOME/skills、項目 .dsh/skills 等路徑重複註冊，以免與 Bundle 產生重複 skill 所有者、干擾路由。
安裝驗證¶
先確認 profile 已列出 aegis：
dsh plugin --profile web list --depth 0
dsh --profile web --dump-config
dump 結果中應出現 id: aegis-method-pack。隨後在方法包根目錄（通常爲 $DSH_HOME/profiles/web/node_modules/aegis）執行 doctor，不要在目標業務項目目錄裏跑：
cd <aegis-method-pack-root>
python scripts/aegis-doctor.py --write-config --json
JSON 輸出需包含 "ok": true、"workspaceSupport": "available"、"configStatus": "configured" 纔算結構安裝完成。重啓 profile 後，在全新會話中確認 skill 目錄出現 using-aegis、systematic-debugging、verification-before-completion 等條目，並用一條代表性自然語言任務驗證路由是否進入 Aegis 決策路徑。
兼容模式（僅在必要時）¶
當 preview 版 Bundle API 不可用、策略禁止第三方 profile 插件、或無法爲插件管理器提供 pnpm 時，可使用文檔中的 direct-child 兼容安裝；該模式需用戶顯式批准，且不能與 Bundle 同時啓用。一般用戶優先走上面的默認 Bundle 路徑。
典型用法示例¶
安裝並重啓宿主後，多數場景用自然語言即可，Aegis 會按任務匹配方法；需要更明確控制時可用下列觸發方式。
日常診斷與修復：
Why does this login failure happen? Diagnose it before changing code.
Aegis goal: Fix the auth refresh bug without rewriting the auth system.
決策訪談（只問不改）：
Grill me on whether we should ship a hosted version first.
審查與第一性原理壓測：
Review this diff independently before I merge it.
aegis:first-principles-review
顯式 TDD（默認 TDD 模式爲 off）：
TDD Route: strict
或在方法包根目錄開啓自動 TDD 路由：
cd <aegis-method-pack-root>
python scripts/aegis-doctor.py tdd-mode auto
更新已安裝的方法包：
dsh plugin --profile web update aegis
也可用自然語言 update Aegis 或顯式請求 aegis:update，由本地更新腳本按當前宿主路由。
對非平凡項目工作，Aegis 可被動複用 CONTEXT.md 或 CONTEXT-MAP.md 中的領域術語；領域建模僅在術語需解析、歧義、更名或衝突時激活，未決領域決策仍歸用戶所有。
適用場景與注意事項¶
適合誰、什麼場景：
- 用 DSH 或其他 AI 編程宿主做跨多輪、多文件的改動，擔心智能體「越改越偏」；
- 希望改動前先對齊架構與契約，完工前有可複查證據；
- 團隊已在用 Skill / 方法包生態，希望一套工作流紀律跨宿主複用。
務必注意：
- 權限與信任邊界：插件以當前
dsh進程權限運行，安裝前應閱讀源碼與 MIT 許可證，確認符合團隊安全策略。 - 非最終權威：Aegis 是 runtime-ready 方法包，不提供權威的
GateDecision、最終完成裁決；用戶指令與目標項目規則優先於 Aegis 引導。 - DSH 仍爲開發者預覽：官方警告可能存在兼容性破壞性變更；文檔記錄的是已實現的 Bundle 結構支持，不承諾當前版本的即時路由質量已完全驗收。
- 不要混裝：Bundle 與 direct-child 兼容視圖勿同時激活；項目級
.dsh/skills試驗勿與同一 profile 的 Bundle 並行，以免路由證據不可靠。 - 激活模式：默認
auto會在會話邊界延遲注入緊湊的using-aegis引導；若需純顯式調用，可在方法包根目錄執行python scripts/aegis-doctor.py activation-mode explicit並重啓宿主。
結尾¶
如果你厭倦了在長任務裏「盯着智能體別亂改、別假完工」，Aegis 提供了一條可安裝、可驗證的路徑：先對齊基線，用證據說話，讓簡單事保持簡單。它不能替代你的工程判斷，但能把常見失控點壓進可複用的方法紀律裏。
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/GanyuanRan/Aegis
- GitHub 倉庫：https://github.com/GanyuanRan/Aegis
- DeepSeek Harness 安裝說明：https://github.com/GanyuanRan/Aegis/blob/main/docs/README.deepseek-harness.md
