前言¶
在 DeepSeek Harness（DSH）里長期開發時，工作區 Markdown、.dsh 下的記憶與人設、以及按會話追加的聊天記錄會分散在多個目錄裏。用文件樹或全文搜索可以定位單篇內容，但很難一眼看出「哪些筆記、哪幾次對話在講同一件事」。下面介紹的 dsh-hippo（側欄名「海馬體」）把這些只讀來源彙總後，用文件作簇心、標題與列表項作節點、共同關鍵詞作連邊，在側欄渲染一張可交互的神經元網絡，便於瀏覽與跳轉原文。
這是什麼¶
dsh-hippo 是 DSH 社區插件，分類爲「記憶」。維護者 Snerou，源碼與說明見 GitHub：Snerou/dsh-hippo，目錄頁見 skillhub.cn/plugins/Snerou/dsh-hippo。插件把工作區文件、DSH 記憶和過去會話渲染爲可旋轉的神經元圖（Hippocampus for DeepSeek Harness），數據僅在本地解析，不上傳。
核心功能¶
圖怎麼建¶
- 文件爲簇：每個被掃描到的
.md/.markdown/.txt文件形成一個簇；簇內節點來自文檔標題與列表項。 - 關鍵詞連邊：不同節點若共享關鍵詞，會在圖中連成網絡。
- 交互：點擊節點查看原文；滾輪縮放；拖拽旋轉整張圖；雙擊聚焦單個簇。
默認讀哪些目錄¶
插件只讀文本，跳過 node_modules、附件、日誌與緩存。
| 來源 | 說明 |
|---|---|
| 當前工作區 | 環境變量 DSH_WORKSPACE；未設置時使用 ~/Documents/deepseek-harness/default-workspace |
~/.dsh |
DSH 記憶、人設、技能等（不含 profiles 目錄本身） |
| 會話 | ~/.dsh/sessions 與 ~/.dsh/profiles/*/sessions |
| 追溯樹 | ~/.dsh/profiles/*/trace（「根源追溯」產生的 md） |
會話如何進圖¶
每次啓動 DSH 會重新掃描會話文件。每個會話解析爲：
- 一個會話節點（標題優先用 DSH 記錄的會話名，否則取用戶第一句話）；
- 最多 8 條條目節點（用戶發言，已去掉系統注入說明）。
會話文件爲追加式多幀 zstd；插件按幀解壓，結果按「大小 + 修改時間」緩存到 ~/.dsh/dsh-hippo/session-cache.json，未變更的文件不重複解壓。因此重啓 DSH 後，新會話與新文件會自動納入圖中，無需手動刷新。
圖中標題會規範爲中文短句：去掉盤符路徑、後綴、XML 標籤與聊天時間戳；英文佔比高時按內置詞表翻譯；無法翻譯時用「會話 · 日期」兜底。
與 dsh-reason-tree 聯動¶
安裝 dsh-reason-tree 後，在追溯面板點擊「定位至海馬體」，海馬體會定位到對應文件或結論節點。若該 md 不在當前掃描範圍，插件會把其所在目錄補進數據源並重拉圖。聯動通過 localStorage 與 window 自定義事件完成，兩插件無需互相 import。
安裝與啓用¶
在 desktop profile 下執行官方安裝命令：
dsh plugin --profile desktop add dsh-hippo
安裝完成後重啓 DSH，左側欄會出現「海馬體」圖標。
若圖中缺少某工作區的會話，可在面板右下角點擊「＋ 工作區會話」。插件會自動發現本機會話目錄並寫入配置，立即生效，無需再次重啓。
配置¶
可選配置文件：~/.dsh/dsh-hippo.json（不存在則使用默認值）。
{
"sources": [
{ "dir": "D:/notes", "group": "note", "label": "筆記" },
{ "dir": "D:/diary", "group": "diary", "label": "日記" }
],
"sessionDirs": ["C:/Users/me/.dsh/sessions"],
"sessions": { "enabled": true, "limit": 60 },
"scanIntervalSec": 60
}
sources：額外掃描目錄；group影響顏色分組，label爲分組顯示名。sessionDirs：額外會話目錄（「＋ 工作區會話」也會寫入此處）。sessions.limit：最多加載會話數（按時間新到舊）；設爲0或enabled: false可關閉會話進圖。scanIntervalSec：後臺重掃間隔（秒），默認 60；設爲0關閉自動重掃。
典型用法¶
- 安裝並重啓 DSH，從側欄打開「海馬體」，先熟悉默認工作區與
~/.dsh形成的簇與連邊。 - 若有筆記目錄未出現在圖中，在
~/.dsh/dsh-hippo.json的sources裏增加dir/group/label，或依賴面板「＋ 工作區會話」補全會話路徑。 - 需要與追溯結論對照時，配合 dsh-reason-tree 使用「定位至海馬體」，在圖中跳到對應節點後再點節點讀原文。
- 會話較多時，用
sessions.limit限制數量，避免圖過大；需要更實時刷新時調整scanIntervalSec（設爲 0 則僅依賴啓動時與手動觸發邏輯）。
權限、安全與適用場景¶
插件只讀本地文件，並註冊自有 HTTP 路由；資料說明其沒有殺進程或啓動外部程序的接口。
/dsh-hippo/add-source僅允許將家目錄、~/.dsh、工作區或已有數據源下的目錄寫入配置，其他路徑返回 403。/dsh-hippo/node只讀取圖中已掃描到的文件，不接受任意路徑參數。
所有解析在本地內存完成，插件包內不含用戶數據；讀哪些目錄取決於你本機配置與磁盤內容。DSH 生態強調「一切皆插件」；社區目錄站點與 DeepSeek / 幻方無官方從屬關係。安裝前建議自行查看源碼與 MIT 許可證。插件以當前 DSH 進程權限運行，能讀到的路徑與進程用戶一致。
適合：希望在同一視圖裏關聯工作區文檔、DSH 記憶、歷史會話與追溯 md 的 DSH 桌面用戶。不適合：需要寫回或修改記憶文件的場景（本插件只讀）。
結尾¶
dsh-hippo 把分散的 Markdown 與會話整理成可旋轉、可聚焦的神經元圖，並支持與會話緩存、可選數據源及 reason-tree 定位聯動。進一步瞭解可訪問目錄頁 https://www.skillhub.cn/plugins/Snerou/dsh-hippo 與倉庫 https://github.com/Snerou/dsh-hippo。
