前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。reatcat/l123-harness 將一套經過實戰檢驗的 agent 方法論打包爲插件，提供上下文注入、門禁、事件記錄、記憶提煉等能力組件。該插件同時支持 Claude Code 和 DeepSeek Harness，提供 L1-L2-L3 三級記憶系統。
這套插件的設計對齊「宿主是內核，插件只提供能力組件」的原則。它不包含項目知識，而是通過裝機腳本幫助項目在本地建立記憶骨架，後續的項目知識由項目本身積累。
核心功能¶
插件提供以下能力：
- L1-L2-L3 三級記憶系統：L1 常駐
CLAUDE.md，L2 索引，L3 詳情。 - 門禁審批：對受保護文件進行審批流程。
- 零評判事件日誌：客觀記錄工具報錯、命令輸出，不進行主觀推理。
- 周審提煉：對事件日誌進行提煉，將候選結論放入 inbox。
- TDD 執行流：以測試紅綠循環作爲停止條件。
- 雙宿主支持：同時兼容 Claude Code 插件和 DeepSeek Harness (dsh)。
安裝與啓用¶
在 DeepSeek Harness 環境下，使用以下命令安裝：
dsh plugin --profile web add github:reatcat/l123-harness
本地開發注意事項¶
本地開發時，如果使用 dsh plugin add <本地路徑> 命令，系統會走 pnpm link，不會安裝插件聲明的橋接依賴。這會導致 hooks 降級（僅技能可用，啓動時告警）。本地驗證建議使用 tarball 包或先在插件目錄內執行 pnpm install。
工作原理¶
插件通過 hooks 橋接生命週期事件，實現記憶與門禁功能：
| 層 | 載體 | 特點 |
|---|---|---|
| L1 常駐 | CLAUDE.md |
小而穩定的緩存前綴：原則、優先級、安全底線、路由表 |
| L2 索引 | .agents/INDEX.md |
症狀→一句規則→L3 指針；SessionStart hook 自動注入 |
| L3 詳情 | .agents/** |
knowledge / pitfalls / runbooks / current / events / inbox |
裝機後，用戶可使用技能命令進行初始化和周審。
典型用法¶
/l123-harness:init-harness # 新項目裝機：生成 L1/L2/L3 骨架 + 門禁清單
/l123-harness:event-review # 周審：讀事件日誌 → 候選進 inbox → 陪同分流
日常自動化部分（L2 注入、門禁攔截、事件記錄）由 hooks 橋接在對應生命週期點自動運行。
注意事項¶
- 純 JS 免構建：項目本身無需構建工具。
- 項目知識積累：插件只提供骨架，項目知識由項目自己積累。
- Hook 限制：hooks 橋接中，
PreCompact和SessionEnd事件尚未實現。 - 權限與來源：插件以當前 dsh 進程權限運行，安裝前建議檢查源碼與許可證（MIT）。
