前言¶
在 DeepSeek Harness（DSH）里用久了，会话会越来越多。想找回某段讨论时，往往只能逐个打开会话、凭印象翻找。Harness 本身以当前会话为主，并不提供统一的本地历史检索入口。
下面介绍社区插件 dsh-chat-history（维护者 michaelfeng）。它在侧边栏增加 History / 历史 面板，对本地聊天记录建索引并支持短语搜索、上下文预览和跳回原会话。搜索在本地完成，不调用模型，也不向外发送网络请求。
这是什么¶
dsh-chat-history 是 DSH 的第三方插件，分类上属于「记忆」类能力：把分散在各 Session 里的对话文本整理成本地可检索缓存，而不是把上下文塞进当前 Prompt。
- 仓库：github.com/michaelfeng/dsh-chat-history
- 当前版本（README 安装地址）：
v2.0.0 - 许可证：MIT
- 集成说明：README 写明验证基于 Harness 0.2.1-rc.3 的桌面插件接口；其他版本可能需要适配。
面板位置在侧边栏 Plugins / 插件 下方，Schedules / 定时任务 与 More / 更多 上方；点击后在主区域打开，不依赖当前是否打开了某个会话。
核心功能¶
README 中列出的能力均可直接对应到界面操作：
- 跨会话搜索：输入关键词或短语，分别查看「标题命中」和「消息命中」。
- 原位读上下文：点击消息结果，在右侧查看前后对话，无需来回切换会话。
- 定位关键词：高亮匹配内容，支持上一个 / 下一个匹配，并可 打开原会话 继续聊天。
- 本地缓存复用：未变化的记录不重复解析；首次整理显示进度，之后自动增量更新。
- 中英文界面：跟随 Harness 的语言设置。
搜索范围与性质（务必分清预期）：
- 只处理用户与助手的对话文本，排除工具输出、注入消息、围栏代码块和子代理会话。
- 支持不区分大小写的字面短语匹配，词语之间的空白可变化。
- 不是语义搜索；不支持正则表达式或模糊匹配。
- 每个会话返回最近一条匹配消息，结果按该消息时间排序；一次最多返回 100 个会话，超过时会提示。
安装与启用¶
在 DeepSeek Harness 中打开 Plugins / 插件，点击 Add plugin / 添加插件 右侧下拉箭头，选择 Install a third-party plugin / 安装第三方插件，粘贴下列地址并 Install / 安装：
github:michaelfeng/dsh-chat-history#v2.0.0
安装完成后点击 Enable now / 立即启用。在插件详情中确认：
- 插件总开关已开启；
- Chat History 组件 开关已开启，且状态为 Running / 运行中。
随后侧边栏 Plugins / 插件 下方会出现 History / 历史 入口。
从旧版升级（1.x → 2.0.0）¶
项目已从 dsh-conversation-history 改名为 dsh-chat-history。升级时建议：
- 先移除旧的 Conversation History 插件（bundle 与组件），再安装上述地址，避免两个 bundle 同时注册。
- 缓存目录由
cache/conversation-history改为cache/chat-history，首次打开会重新整理索引。
若曾安装名为 @local/dsh-chat-history 的本地开发副本，请先关闭或移除旧副本，再安装仓库版本，避免重复注册组件。
典型用法¶
README 给出的最短路径如下：
- 点击侧边栏 History / 历史。
- 输入至少两个字符，例如「发布」或
release notes。 - 点击消息摘要，在右侧查看上下文；点击标题命中，查看该会话的近期消息。
- 用匹配导航按钮在关键词间跳转；需要继续对话时点击 打开会话。
安装验证记录（README 中对 v1.1.0 的描述）提到：搜索 release notes 可返回多段会话中的消息命中，上下文预览支持 Markdown 标题与列表，关键词导航计数会随「下一处」更新。2.0.0 将入口从会话内 History 标签页改为侧边栏面板，搜索与上下文逻辑未变。
工作方式与本地数据¶
组件启动后，插件通过 Harness 的会话存储接口提取对话文本，生成可重建的本地缓存；搜索前先核对会话版本，再匹配已整理文本。
- 未变化会话复用内存或磁盘缓存；活跃会话只整理新增事件。
- 已保存会话若发生变化，可能需重新读取，成本取决于存储后端。
- 并发搜索共用进行中的整理任务；搜索与上下文加载有独立超时，避免界面一直等待。
隐私与权限：
- 插件不发送外部网络请求，不调用模型，不需要额外 API key，README 亦说明不包含遥测。
- 缓存默认在
$DSH_HOME/cache/chat-history/，存放自聊天记录提取的文本；未加密，敏感程度应与原始聊天记录相同。 - 插件不修改原始会话日志；关闭组件后可删除派生缓存，下次开启会重新建立。
插件以当前 DSH 进程权限运行，安装前建议阅读源码与 MIT 许可证，确认符合你的部署与合规要求。
适用场景与注意¶
更适合：
- 长期在 Harness 中积累大量会话，需要按短语快速定位历史讨论；
- 希望在同一界面预览上下文后再决定是否打开原 Session；
- 希望检索完全本地化、不依赖模型 API 的场景。
不适合或需降低预期：
- 需要语义检索、同义词或正则表达式时（应使用其他工具或导出后处理）；
- 依赖工具输出、子代理会话内容作为检索依据时（插件会排除这些内容）。
远程部署时，界面经 Harness 连接通道与插件后端通信；数据边界以 Harness 自身的连接与存储配置为准。
结尾¶
dsh-chat-history 解决的是 DSH 内「历史会话难检索」的具体问题：侧边栏入口、本地索引、短语搜索与上下文预览，并与打开原会话衔接。它是社区第三方插件，与 DeepSeek 官方无隶属关系；可在社区目录页与 GitHub 查看说明与 Issue。
