warrenop/open-preset-harness

open-preset-harness

多角色 AI 智能体的项目记忆 — 一份知识库，所有 Preset 可读。

License: MIT
DSH 插件
Wiki

DSH Profile Bundle： dsh-tool-project-memory · 分类：Memory · 安装说明 · 上架清单

智能体会话结束就「忘」；团队不会。
open-preset-harness 在 DeepSeek Harness 之上增加 项目级组织记忆层：任意工种（Preset）可沉淀经验，任意工种可按需召回。

为什么做这个项目

Harness 把 Preset（壳） 和 Session Log（单次对话记忆） 分开——这对工程是对的。但 团队经验属于项目，不属于某一次会话或某一个 Preset。

没有共享记忆时：

- 安全审查 Preset 每个迭代重复踩同样的鉴权坑
- 新人 Preset 反复问三个月前已答过的问题
- 产品定案随 PM 会话结束而消失
- Token 浪费在「每个角色从零重建上下文」

open-preset-harness 让项目经验 随时间复利 —— 像团队真正会用的 Wiki，且符合 Harness「进模型必进日志」的约束。

是什么 / 不是什么

| | |
|---|---|
| 是 | 面向 Harness 多 Preset 的 开源项目组织记忆 |
| 是 | 按领域组织、按需召回、贡献可追溯 |
| 不是 | Harness 的替代品（我们是扩展） |
| 不是 | 每个 Preset 各记各的 silo，或泛泛的向量库 Demo |
| 不是 | 宣称「发明了 AI 记忆」— 我们做的是 多角色团队场景下的正确整合 |

与 DeepSeek Harness 的关系

- 上游： DeepSeek Harness（MIT）
- 策略： 优先 插件 + 约定目录，避免硬分叉；跟进上游版本
- 合规： 保留上游版权，见 NOTICE
- 身份： 独立社区项目，非 DeepSeek 官方产品

详见 docs/architecture.md、docs/phase-0-memory-api.md。
Wiki： docs/wiki

核心概念

┌─────────────────────────────────────────────────────────┐
│              项目记忆（共享）                                │
│   index · domains · decisions · 蒸馏后的经验               │
└────────────────────────▲────────────────────────────────┘
│ 写入 remember / 读取 recall
┌───────────────────┼───────────────────┐
Preset A            Preset B            Preset C
Session 1           Session 2           Session N

设计原则

- 每个项目一份记忆池 — 所有 Preset 可读（写入可治理）
- 按领域/主题组织，不按 Preset id
- 索引 + 按需 recall — 避免每轮灌入整库
- Model-visible ⟺ logged

默认目录：/.dsh/memory/（结构见英文 README 与 API 文档）

应用场景

| 场景 | 谁写入 | 谁读取 | 价值 |
|------|--------|--------|------|
| 跨职能协作 | 任意 Preset | 其他 Preset | 经验不锁在某次会话 |
| 研发 ↔ 测试 | 开发 Preset | 测试 Preset | 减少反复对齐 |
| 产品 ↔ 研发 | PM Preset | 研发 Preset | 定案与 rationale 可检索 |
| 安全 / 合规 | 审查 Preset | 全部 Preset | 约束自动传播 |
| 新人上手 | 老人长期沉淀 | 新人 Preset | 少打断 senior |
| 开源维护 | 分拣 Preset | 发版 Preset | 已知坑与惯例共享 |
| 乙方 / 客户 | 商务 Preset | 交付 Preset | 客户偏好随 repo 走 |
| 科研 → 写作 | 文献 Preset | 撰稿 Preset | 结论可引用 |
| SRE / 故障 | 复盘 Preset | 排障 Preset | 故障经验复用 |
| 设计系统 | 设计 Preset | 前端 Preset | Token 与例外一致 |
| 国际化 | 翻译 Preset | 开发 Preset | 术语统一 |
| 数据 / ML | EDA Preset | 建模 Preset | 数据坑留存 |

更多见 docs/scenarios.md。

当前状态

v1.0.0 — 主线能力全部发布（Phase 0–3、Distill 1–3、LLM 辅助）；双 Preset Demo 仍延后 (#3)。

| 里程碑 | 状态 |
|--------|------|
| 项目记忆 API 规范 | ✅ phase-0-memory-api.md |
| 文件约定 .dsh/memory/ | ✅ |
| dsh-tool-project-memory | ✅ packages/tool-project-memory（DSH1024 Profile Bundle） |
| Supersede 治理（Phase 1） | ✅ phase-1-supersede.md · #4 |
| Session 蒸馏 hook（Phase 1） | ✅ phase-1-distill.md · #5 |
| 写入治理（Phase 3） | ✅ phase-3-governance.md · #8 #10 |
| 蒸馏 + LLM 辅助 | ✅ phase-1-distill.md · #11 |
| 配置参考 | ✅ config-reference.md |
| 双 Preset Demo | 📝 延后 · #3 |

Roadmap

按 社区 Issue 与场景需求 推进，公开文档不写时间盒。

已发布（v1.0.0）

- Memory LLM 辅助：distillAutoLlm、vectorEmbedModel: llm-keywords-v1（Harness ctx.llm）
- 配置参考 · SRE 场景手册

已发布（v0.9.0）

- 自动蒸馏（Tier 3）：distillAuto 在 Phase 3 治理下将启发式候选写入 remember

已发布（v0.8.0）

- 写入审批 gate（Phase 3b）：writeApprovalDomains 在 remember 前走 Harness 审批

已发布（v0.7.0）

- 向量 sidecar（Phase 2b）：vectorSidecar + recall ranking: 'vector'（local-fhash-v1，无网络）

已发布（v0.6.0）

- 写入 ACL（Phase 3a）：writeAllowDomains / writeAllowPresets / writeDenyPresets

已发布（v0.5.0）

- Token + IDF 排序 recall（Phase 2a）：默认多词查询排序；ranking: 'legacy' 恢复 Phase 0 子串模式

已发布（v0.4.0）

- 辅助蒸馏（Tier 2）：可选 suggest_memory_candidates 工具 — 启发式扫描 session，仍须显式 remember

已发布（v0.3.1）

- 蒸馏 compaction 提醒（Tier 1b）：可选，在成功的 compaction/end 后 inject，可附带 summary 摘要

已发布（v0.3.0）

- 蒸馏提醒（Tier 1a）：可选 agent/turn-stopping inject 提醒调用 remember — 默认关、不自动写盘

已发布（v0.2.0）

- Supersede 治理：remember(supersedes) 回写旧 entry、recall/index 只展示 active 条目
- expires_at / recall expired 警告
- Harness smoke + CI（scripts/smoke.sh）

已发布（v0.1.0）

- Profile Bundle 一键安装
- 工具：recall、remember、memory_status
- 空白 session 注入 index.md（有字节上限）
- 按领域组织的 .dsh/memory/

计划

- 双 Preset Demo (#3) — walkthrough 已有，录屏延后

见 scenarios.md 与 Scenario Issue。

快速开始

1. Harness 接入 — 或一键安装：dsh plugin --profile web add "github:warrenop/open-preset-harness#main&path:packages/tool-project-memory"
2. 双 Preset Demo — 或 ./scripts/demo-headless.sh（需 DEEPSEEK_API_KEY）
3. 用 Scenario Issue 反馈真实场景

chmod +x scripts/link-harness.sh
./scripts/link-harness.sh /path/to/deepseek-harness-master

参与贡献

见 CONTRIBUTING.md。

Issue 欢迎描述「Preset A 写入 → Preset B 召回」类场景；可选标签 cn-scenario / en-scenario。

许可证

MIT — LICENSE、NOTICE