moreWax/dsh-prime-agent

dsh-prime-agent

让你的 DeepSeek Harness 智能体学会学习。 一个闭环学习回路，将
Prime Agent 的持续记忆系统与
OKF/OpenWiki 知识注册表连接到 DeepSeek Harness
——完全以原生插件形式实现在有文档记录的接缝上。无需 fork，无需修改核心。

┌─────────────── dsh session ───────────────┐      ┌────────── Prime Agent ──────────┐
│ skill catalog ◄── okf-knowledge ───────────┼──────│  skills + OKF bundle pages      │
│ durable context ◄── prime-memory ────────┼──────│  memories / prompt notes        │
│ turn transcript ── prime-memory ─────────┼──────► inbox (refine.run)             │
└───────────────────────────────────────────┘      │        ▲                        │
│        │ DSPy / MIPROv2         │
└────────┴── OKF draft pages ─────┘
(accepted candidates flow back
through the catalog above)

包

| 包 | 功能 | 可独立运行 |
|---|---|---|
| @morewax/dsh-prime-memory | 将 Prime 技能提供到 ctx.skills，将 Prime 记忆作为持久上下文注入（会话引用契约：转义、预算受限、失败即报错），将对话轮次导出到 Prime 的 inbox 以供 refine | ✅ |
| @morewax/dsh-okf-knowledge | 将 OKF/OpenWiki bundle 页面作为技能提供，并附带来源信息 —— 信任层级（verified/unverified）在元数据中呈现，并带有 verifiedOnly 信任门控 | ✅ |
| prime-agent-testkit | 可复用的测试夹具 + 测试套件，验证上述每一项契约（16 个测试） | 仅开发用 |

初次接触？ 从5 分钟快速开始入手，然后浏览实战手册。

安装

dsh plugin --profile default add @morewax/dsh-prime-memory
dsh plugin --profile default add @morewax/dsh-okf-knowledge
or straight from GitHub:
dsh plugin --profile default add github:moreWax/dsh-prime-agent

快速开始

~/.dsh/profiles/default/cordis.patch.yml
- id: prime-memory
name: '@morewax/dsh-prime-memory'
config:
primeHome: ~/.prime/agent       # any Prime Agent install
sessionId:  # whose memories to surface
exportTurns: true               # write turns back for refine

- id: okf-knowledge
name: '@morewax/dsh-okf-knowledge'
config:
bundles: [/srv/wiki/core]       # one or more OKF bundles
verifiedOnly: false

离线优化器也已随附 —— 参见 refine/。

查看实战手册获取完整配方：
1. 将你的知识库作为智能体技能提供
2. 安全地注入持久记忆
3. 用 DSPy 闭合学习循环
4. 面向团队 wiki 的信任门控服务

为什么这不一样

记忆注入和转录导出插件已经存在。这个项目并不是孤立地做其中任何一个——它是两者之间的循环，外加：

- 溯源优先的知识：页面带有机器可读的信任层级；模型目录区分已验证和未验证的内容。
- 按契约保证注入安全：不受信任的记忆文本无法伪造框架标签（无损转义），预算失败时给出明确的错误码。
- 崩溃安全的导出：通过 ctx.storageDomain 实现仅追加记录，绝不损坏状态，绝不中断 agent 循环。
- 真正的互操作：驱动一个真实的 Prime Agent 安装——而不是重新实现。

兼容性

基于 DeepSeek Harness 0.1.1-rc.x（开发者预览版）构建。该 harness 在预发布阶段不承诺稳定性；我们会在每次上游版本更新时重新验证，并在此处固定已测试的版本。

开发

pnpm install
pnpm test          # 16 个测试：存储读取器、provider 接线、导出、注入安全
pnpm build

框架包来自 npm——无需检出 harness。关于在实时 harness 内进行测试，请参见
docs/dev-setup.md。

许可证

MIT