前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。對於使用 loci 作爲本地知識庫的用戶，管理知識通常需要在 CLI 工具和 Web 界面之間切換。loci-dsh 插供了一個純 UI 層的解決方案，將 loci 的記憶功能集成到 DSH 的 Web UI 側邊欄中。通過這個插件，你可以在不離開對話界面的情況下，搜索、提問、記錄和可視化你的本地知識庫。
介紹¶
loci-dsh 是 IvenKooLab 維護的一個 Memory 類插件。它不涉及 Python 嵌入或核心分叉，僅作爲 DSH Web 服務器的一層 UI 掛載。插件將側邊欄標籤頁與本地運行的 loci HTTP 服務器連接，實現了本地知識庫的混合檢索、LLM 回答引用以及知識圖譜瀏覽。
核心功能¶
插件提供以下核心視圖與能力：
- Search（搜索）：支持混合檢索，可調整結果數量，支持僅檢索記憶（
tag=memory）及路徑過濾。 - Ask（提問）：基於本地知識庫回答問題，並在答案中生成引用芯片（citation chips）。
- Memories（記憶）：展示按時間倒序排列的全景時間線，支持直接快速記錄記憶。
- Graph（圖譜）：瀏覽 loci 的知識圖譜（需 loci ≥ 0.6.0），支持點擊實體過濾關係。
- Status（狀態）：顯示連接狀態、存儲摘要及各來源的塊計數。
安裝與啓用¶
在安裝前，請確保環境滿足以下依賴：
- Node.js ≥ 24（DSH 的啓動器使用了
import.meta.main，Node 20/22 會在靜默狀態下退出）。 - DeepSeek Harness (dsh)：通過
npm i -g @deepseek-ai/dsh安裝。 - dsh-better-sidebar：用於提供側邊欄基礎支持，執行安裝命令以掛載側邊欄。
- loci ≥ v0.6.2：確保其 HTTP 服務器正在運行，並在配置文件中設置固定 Token。
1. 安裝插件¶
執行以下命令將插件添加到 Web 配置文件中：
dsh plugin --profile web add github:IvenKooLab/loci-dsh
2. 配置 loci¶
在 loci 的 config.toml 中配置 HTTP 服務器的 Token：
[http]
token = "<a random string>"
啓動 loci 的 HTTP 服務端（默認端口 8765）：
loci serve-http
3. 配置 DSH 插件¶
編輯 ~/.dsh/profiles/web/cordis.patch.yml。由於 DSH 的補丁機制是“全量替換”而非“深度合併”，你需要編寫一個針對 loci-dsh 的覆蓋行。注意不要使用 insert，因爲插件安裝時已掛載。
- id: loci-dsh
config:
baseUrl: 'http://127.0.0.1:8765'
token: '<與 loci config.toml 中 [http] token 相同的值>'
配置說明¶
插件支持通過環境變量或配置文件進行微調。主要配置項如下：
- baseUrl: loci serve-http 的地址，默認爲
http://127.0.0.1:8765。 - token: Bearer 認證令牌，必須與 loci 配置一致。
- timeoutMs: 默認 20000ms，控制健康檢查、搜索和記錄等短請求的超時時間。
- askTimeoutMs: 默認 180000ms，控制
/ask接口超時，該接口涉及完整的 LLM 交互。 - graphPath: 絕對路徑，用於啓用 Graph 視圖（默認讀取
<store>/graph.json）。 - memoriesPath: 絕對路徑，用於啓用 Memories 視圖的時間線功能（默認讀取
memories/目錄）。
注意事項¶
- 純 UI 層：插件不包含 Python 運行時，也不修改 DSH 或 loci 的核心邏輯。
- 配置替換：在
cordis.patch.yml中配置時，必須列出所有希望覆蓋的鍵值對。插件不會自動合併舊配置。 - 版本依賴：嚴格依賴 Node.js ≥ 24 和 loci ≥ v0.6.2。舊版本可能存在兼容性問題。
總結¶
loci-dsh 通過輕量級的 UI 掛載，解決了本地知識庫在 DeepSeek Harness 中的接入問題。它提供了從搜索、問答到圖譜可視化的完整鏈路，適合需要在瀏覽器中直接操作本地 RAG 知識庫的開發者和用戶。
插件目錄：https://www.skillhub.cn/plugins/IvenKooLab/loci-dsh
源碼地址：https://github.com/IvenKooLab/loci-dsh
