在 DSH 中开发智能体时,对话轮次往往在会话结束后就丢失了。与其依赖云端的记忆服务,不如将对话保存为本地文件。dsh-save-chat 正是为此设计,它将对话保存为 Markdown,并提供检索接口。
插件介绍¶
dsh-save-chat 是一个 DeepSeek Harness 插件,由 xypang33-sketch 维护。它解决了智能体开发中“对话留存”的问题,将对话轮次保存为本地 Markdown 文件。它提供两层存储结构:按会话组织的集合(项目级)和跨项目的个人知识库。所有数据均为本地纯 Markdown 文件,无数据库依赖,零依赖。
核心功能¶
- 保存对话轮次:保存提问与完整回答的内容。
- 双层存储结构:支持按会话的集合(Project-local)和跨项目的个人知识库。
- 模型检索能力:模型可调用
search_knowledge和read_knowledge进行按需检索。 - 零依赖与纯文件:仅依赖 Markdown 文件,无数据库,不产生遥测数据。
- UI 交互:提供心形按钮保存、侧边栏面板浏览、右键菜单管理。
- 图片保留:对话中的图片会随 Markdown 文件一起保留。
- 本地全文搜索:使用 BM25 算法在本地进行全文搜索。
安装与启用¶
安装前请确认当前运行的 DSH 进程(Profile)。安装命令如下:
dsh plugin --profile web add dsh-save-chat
若使用桌面客户端,将 --profile web 替换为 --profile desktop。安装后需要重启 DSH 才能生效。
使用步骤¶
- 添加插件:在 DSH 的设置中找到插件选项,添加
dsh-save-chat。 - 保存对话:在对话回复行的操作栏中,点击心形图标即可保存整轮对话。
- 浏览内容:在侧边栏面板中浏览已保存的收藏内容。
- 添加到知识库:在侧边栏或右键菜单中选择“添加到知识库”,将其提升为可被模型检索的持久化内容。
- 引用与检索:右键菜单支持复制引用(
@/path/file.md)。将引用粘贴到新对话中,或直接询问模型“我们上次得出了什么结论?”,模型会调用检索工具返回结果。
适用场景与注意事项¶
该插件适合需要在本地持久化对话记录、利用本地文件进行知识管理且希望减少云服务依赖的开发者。
- 文件位置:知识库文件存储在
~/.dsh/knowledge/<YYYY-MM>.md。会话集合文件位于<session workspace>/.dsh-favorites/<session title>.md。 - 本地存储:仅本地存储,不发送遥测或服务器请求。
- 按需检索:知识库内容仅在模型需要时检索,不会自动注入,节省 Token。
- 模型调用成本:保存对话或总结图片时会产生少量模型调用。
- 配置要求:需要重启 DSH 才能生效。
总结¶
dsh-save-chat 提供了一种轻量级、本地优先的方式管理 DSH 对话。它通过纯 Markdown 文件和检索工具,将对话转化为可搜索的知识资产,适合构建个人知识库或项目归档。