前言¶
DeepSeek Harness (DSH) 採用「一切皆插件」的設計理念。在使用本地 OpenViking 服務器進行智能體記憶管理時，開發者通常需要切換窗口來操作 Studio 或檢查提交狀態。dsh-openviking-enhance 插件旨在解決這一割裂問題，它將 OpenViking 的 Studio 面板、會話提交狀態監控以及記憶檢索功能直接集成到 DSH 的 Web GUI 界面中，減少上下文切換的成本。
介紹¶
該插件由 A2chitect 維護。它是一個客戶端插件，主要提供 OpenViking 的只讀視圖。插件本身不會向 OpenViking 服務器提交數據、寫入或刪除任何內容，僅用於展示服務器狀態和檢索結果。
核心功能¶
OpenViking Studio 面板¶
在 DSH 左側邊欄底部新增 OpenViking Studio 面板入口。點擊該入口後，OpenViking 服務器的 Studio 界面會在 DSH 主區域打開。開發者無需切換瀏覽器標籤頁，即可直接瀏覽記憶、會話和檢索結果。
會話提交狀態藥丸¶
在消息框下方顯示當前會話的提交狀態（藥丸）。狀態包括：
* OV · not committed：未提交
* OV · 12.3k/20k：累積中
* OV · extracting…：提取中
* OV · 3 commits：已提交
* OV · extraction failed：提取失敗
* OV · unavailable：不可用（無法連接服務器）
點擊藥丸可查看最近 3 次提交的時間線，以及該次提交對記憶的具體變更（新增、更新或刪除），並可查看完整的記憶路徑或失敗原因。
Memory recall 右側邊欄¶
在 DSH 右側邊欄新增 Memory recall 選項卡。該選項卡顯示當前會話的檢索結果，包括：
* 檢索查詢（當前會話的最新消息或手動輸入）
* 檢索來源（memories、resources、skills）
* 匹配評分（顏色編碼：紅、橙、綠）
* 文件名、類型（entity、event 等）及摘要
* viking:// 路徑（懸停顯示）
安裝與配置¶
安裝¶
可以通過命令行或 DSH 的 Plugins 頁面進行安裝。
dsh plugin --profile desktop add dsh-openviking-enhance
配置¶
插件提供合理的默認值，標準本地部署通常無需額外配置。如需修改，可在 DSH 的 Plugins 頁面選擇該插件並點擊 Configure，或直接編輯配置文件。
主要配置項包括：
* endpoint：OpenViking 服務器地址，默認從 ~/.openviking/ovcli.conf 讀取，否則爲 http://127.0.0.1:1933。
* apiKey：服務器認證密鑰，如服務器需要則填寫。
* studioPath：Studio 頁面的路徑，默認爲 /studio/。
注意事項¶
版本依賴¶
- DSH 版本：需要 DSH 版本 >= 0.2.0-rc.2。
- OpenViking 版本：需要本地運行 OpenViking 服務器（如 0.4.22 測試版）。
- 記憶插件：需要安裝
@openviking/dsh-memory-plugin才能顯示準確的提交進度。如果未安裝，藥丸將顯示 token 數量而非提交次數。
加載機制¶
- 主機部分：插件的主機邏輯在 DSH 應用啓動時加載，安裝後需重啓應用。
- 客戶端部分：插件的客戶端邏輯通過文件加載，安裝後需刷新瀏覽器窗口（⌘R 或 F5）才能生效。
功能限制¶
- 插件內部路由僅響應來自 DSH 窗口自身的迴環請求。
- 如果插件顯示提取失敗，通常是因爲 OpenViking 的提取模型配置問題，需檢查
~/.openviking/ov.conf。
