前言¶
DeepSeek Harness (DSH) 的插件化架构允许开发者扩展智能体的能力。在本地化个人知识管理和长期记忆方面，MemoKnow 提供了一个轻量级的解决方案。它通过结构化记录和文档快照，帮助智能体维持上下文记忆并检索导入的文档知识。
MemoKnow 是什么¶
MemoKnow 是 DeepSeek Harness 的一个本地个人记忆和知识管理插件，由 twoyoung91 维护。它解决智能体如何从聊天记录中提取持久化事实、以及如何管理个人知识库的问题。该插件将记录存储在 SQLite 中，通过 SHA-256 对原始文档进行快照，结合 FTS5 全文搜索与可选的 sqlite-vec 语义检索，并在 DSH 界面内提供管理面板。
安装与启用¶
- 从 GitHub Releases 下载对应版本的
.tgz文件（例如dsh-external-dsh-memoknow-0.2.0.tgz）。 - 在命令行执行安装命令，将其添加到 web profile：
dsh plugin --profile web add C:\path\to\dsh-external-dsh-memoknow-0.2.0.tgz
- 重启 DSH（如果正在运行），然后打开 Settings → MemoKnow。
核心功能¶
- 记忆审查与导入：在 DSH 设置中提供审查建议的界面，允许检查证据、编辑建议记忆或批准/驳回。
- 知识库管理：支持导入文本、Markdown、Word、PDF、CSV 和 Excel 文档。导入的内容以不可变快照存储，支持搜索和预览提取的文本。
- 控制与配置：支持暂停自动学习、设置 token 预算、检查待处理会话及每日使用情况。
- 检索能力：默认使用 Local FTS（无需模型）。可选启用 Local CPU 嵌入（会下载模型）或 OpenAI 兼容的嵌入服务。
- 记忆维护：支持编辑或永久忘记单个记忆记录。
使用方式¶
- 打开 DSH Settings → MemoKnow，进入知识库管理页面。
- 审查记忆：查看建议的记忆列表，检查其来源会话和证据，决定是否批准。
- 搜索与预览：在知识库中搜索已导入的文档，预览提取出的文本内容。
- 控制学习：在设置页面调整学习策略，例如暂停自动记忆、限制 token 使用量，或查看待处理的会话。
注意事项¶
- 非官方组件：这是一个独立社区插件，并非 DeepSeek Harness 的官方组件。
- 单用户本地化：专为一个人的本地 DSH 个人资料设计，不支持多用户或云同步。
- 安全存储：仅存储 API 密钥的环境变量名称，绝不保存密钥的具体值。
- 数据结构：SQLite 是元数据和生命周期状态的权威来源，原始文档快照是不可变的。
- 兼容性限制：嵌入图像被忽略；不支持旧版 Excel (
.xls)；不支持直接通过github:安装；不支持xls格式。 - Managed 模式限制：在托管嵌入模式下，设置 API 更新无法覆盖策略。
数据存储¶
默认数据根目录为 $DSH_HOME/memoknow，当 DSH_HOME 未设置时则为 ~/.dsh/memoknow。
memoknow.sqlite3
objects/sha256/aa/bb/<full-sha256>[.txt]
models/ # 仅在启用 Local CPU 嵌入后创建
