证据门控知识库 AgriciDaniel/deepseek-harness-brain

DeepSeek Harness Brain

DeepSeek Harness Brain 0.2.0 是一套独立的 Obsidian 知识库，以证据为门槛，帮你理解、审查、扩展 DeepSeek Harness，并有选择地移植其中的思路。这个社区版本已对照固定的上游快照做过验证，验证项包括导入器、vault、流水线和打包检查，结果可复现。

浏览器、在线服务商、原生、跨平台、全面安全审计、生产规模这几类行为，都不在已验证的发布证据范围内。本项目与 DeepSeek 无隶属关系，也未获其背书。

产出

- 一份通俗说明，讲清 harness 各部分如何拼在一起。
- 带来源引用的笔记，覆盖会话、工具、权限、持久化、插件、Cordis、子代理、提示词、服务商和验证。
- 一张可移植性矩阵，把可复用的模式与框架专属机制分开。
- 一个可复现的示例 vault，以及一个带白名单的 checkout 导入器。
- 一个有据可依的秘书，外加四个策展智能体，用于基于证据的审查。
- 明确的置信度标签、未决风险和验证边界。

从这里开始

- 通俗指南：PDF 或 HTML
- 五分钟上手工具包
- 产品边界
- 示例 Obsidian vault
- 可移植性矩阵
- Cordis 分支差异
- 已知限制与未决风险
- 验证台账

工作原理

证据从固定版本、按内容寻址的源捕获进入。策展规则再把证据变成互链的笔记、台账、可移植性指引和报告。
确定性检查能防止仅凭文字描述就声称达到更高的成熟度层级。

适用对象

- 评估 DeepSeek Harness 架构的开发者。
- 正在决定把哪些 harness 模式移植进现有应用的团队。
- 想要可追溯的证据、而不是无出处摘要的运维人员。
- 核对声明、测试、生命周期行为或安全边界的贡献者。

快速开始

需要 Python 3.11 或更高版本。

python -m pip install -e .
deepseek-harness-brain demo
deepseek-harness-brain lint --vault examples/sample-vault
deepseek-harness-brain report --vault examples/sample-vault --html-only

要把本地 DeepSeek Harness 检出与已复核的证据做对比：

deepseek-harness-brain import-checkout \
--checkout /path/to/deepseek-harness \
--vault examples/sample-vault \
--expected-commit b150a551b8d465e31e418e1b2eaf5e79bbb7d28e \
--as-of 2026-08-21

要新建一个独立的客户 vault：

deepseek-harness-brain new acme \
--client-name "Acme Co" \
--owner "Your Name" \
--out-dir ~/deepseek-harness-brain-vaults

deepseek-harness-brain ingest \
--vault ~/deepseek-harness-brain-vaults/acme \
--file tests/fixtures/sample-source.md

deepseek-harness-brain synthesize \
--vault ~/deepseek-harness-brain-vaults/acme

优先移植什么

最值得移植、且不绑定具体框架的候选有：

1. 只追加的会话事件，以及可重建的模型请求。
2. 一个带防护的工具执行器，支持带类型的审批与取消。
3. 能力接缝，把定义、服务商和消费方分开。
4. 确定性的提示词与工具 schema 组装。
5. 在复杂后端之前，先定一份小而耐久的持久化契约。

配置档、热重载、模型编写的工作流、生成的 RPC，以及完整的 Cordis 运行时，只有在产品复杂度与之匹配时才值得用。证据与取舍见可移植性矩阵。

证据边界

本项目默认只做建议、只读。它不会改动账户、生产系统、客户记录或线上部署。静态检查、单元测试、构建或无需密钥的检查即使通过，也绝不会被当作浏览器、原生、真实服务商、安全审计或生产环境的证据。

随附的原始抓取是一组白名单公开文件，来自 MIT 许可的上游仓库。客户或私有来源的抓取绝不能提交。见发布说明、第三方声明和安全策略。

验证

python tests/test_harness_adapter.py
python tests/test_pipeline.py
python scripts/audit_brain.py --json --report-only

v0.2.0 社区版通过了本地发布审计与打包门禁。发布状态准确记录了哪些内容已验证、哪些运行时层级仍在证据之外。Brainstein 的通用结构评分仍是有用的结构反馈，但不能覆盖明确的发布状态守卫。

社区

- 改动代码、证据或 vault 笔记前，先读 Contributing。
- 需要帮助请用 Support；可复现的 bug 或证据更正请走 issue 表单。
- 敏感发现请通过 Security 里的私密渠道上报。
- 参与前请先看 Code of Conduct。

视觉标识

主封面由项目所有者提供，优化时没有覆盖源文件。辅助图专门为本仓库生成。没有从官网复制任何视觉素材。封面上的 DeepSeek 标识只用来指明研究对象，不代表隶属或背书。详见素材来源。

许可与署名

DeepSeek Harness Brain 以 MIT License 发布。部分上游 DeepSeek Harness 文件的版权仍归 DeepSeek 及贡献者所有，遵循其 MIT 许可。完整署名与已审阅的 commit 记录在 Third-Party Notices 和上游许可副本中。