前言¶
在 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。
