前言¶

在 DeepSeek Harness (DSH) 中，让模型直接处理长期记忆、日志记录或数据库权限会引入复杂性。dsh-hypatia 通过将 Hypatia 知识图谱集成到 DSH 插件系统中来解决这个问题。它运行 Hypatia CLI 作为主机进程，让模型专注于记忆提案，而将数据库编排、权限和重试处理交给插件本身。

插件定位¶

dsh-hypatia 是一个记忆类插件。由用户 tkliuxing 维护。它为 DSH 提供长期记忆，由 Hypatia 知识图谱支持。插件在主机代码中运行 Hypatia，模型仅负责提出值得记住的内容。

核心功能¶

该插件提供以下能力：

1. 同一请求内召回：在固定的时间和大小预算内，检索并附加相关的项目记忆。
2. 精确项目范围：记忆归属于单一项目，基于标准工作区路径推导；跨项目泄漏由主机侧账本防止，而非依赖内容标签。
3. 已验证写入：每次写入都会被读回并比较，仅在确认成功后才记为已存储。
4. 两阶段遗忘：删除前显示确切条目，诚实报告清理状态。
5. 无需 Bash：记忆在只读和写入会话中工作，因为插件从不要求模型执行 shell 命令。
6. 知识图谱查询技能：提供查询知识图谱的能力。
7. 自动对话记忆桥接：自动处理对话与记忆之间的桥接。

安装与依赖¶

在安装之前，请确保系统满足以下条件：

• Hypatia CLI：必须在 PATH 中。插件依赖 hypatia 0.1.4 CLI 合约。
• Node.js：版本 22.5 或更高（控制账本使用 node:sqlite）。

安装命令如下：

dsh plugin --profile web add @tkliuxing/dsh-hypatia

配置说明¶

安装后，配置通常在 cordis 行中进行。以下是关键配置项：

• memory.preset：记忆预设选项，包括 disabled、read-only-recall、standard（默认）和 full。
• memory.authorization：内存授权独立于 DSH 文件沙箱。
• recall：控制召回行为，包括启用开关、截止时间、最大结果数等。
• ingest：控制摘要摄入。
• reconcile：控制调和操作。

使用示例¶

插件提供了以下工具供代理使用：

• 记忆存储：
  • “remember: this project forbids eval”
• 记忆检索：
  • “what do we know about the retry policy?”
• 记忆遗忘：
  • “forget what you know about the old API”（先预览，再确认删除）
• 状态检查：
  • “did that actually save?”
  • “settle whatever is still unverified”
• 知识图谱管理：通过 hypatia 技能直接驱动 CLI 进行管理，需要 danger-full-access 权限。

限制与注意事项¶

• 单进程限制：同一时间只能有一个进程运行。并发调用会因文件锁而失败。
• 版本要求：必须使用兼容 0.1.4 合约的 Hypatia CLI。
• 许可证：MIT 许可证。

生态与资源¶

DeepSeek Harness 的插件生态强调“一切皆插件”。该插件遵循社区目录规范，不隶属于 DeepSeek 官方。

• GitHub 仓库：https://github.com/tkliuxing/dsh-hypatia
• 社区目录：https://www.skillhub.cn/plugins/tkliuxing/dsh-hypatia