前言¶
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）。
