前言¶
在 DeepSeek Harness（DSH）裏接 OpenViking 做記憶時，連接是否可達、各組件是否就緒、記憶與會話規模，往往要單獨 curl 健康檢查或翻服務端日誌。記憶插件負責讀寫，不負責把這些運維視角的信息收進客戶端界面。dsh-openviking-settings 在 DSH【設置】側欄增加「OpenViking」頁，把連接狀態、健康探測結果和聚合計數集中展示；它不部署 OpenViking 本身，只讀取你已經配置好的實例。
這是什麼¶
dsh-openviking-settings（npm 包名 @openviking/dsh-openviking-settings，當前資料版本 0.1.0）由 TerebiSAMA 維護，歸類爲 admin-security。插件在設置對話框中增加 OpenViking 狀態頁：連接與版本、服務就緒、記憶與會話計數、隊列與本地待寫回條數、自動記憶開關，以及脫敏後的服務端配置摘要。沒有可訪問且配置正確的 OpenViking 實例時，頁面會顯示「未連接」，其餘指標爲空。
核心功能¶
下面列出的能力均對應 README 中說明的面板項與數據來源。
- 連接與版本：通過
GET /health（免鑑權）判斷healthy並展示服務端version。 - 服務就緒：通過
GET /ready查看 agfs、vectordb、api_key_manager、embedding、ollama 等組件狀態。 - 記憶與會話：
GET /api/v1/stats/memories給出記憶庫口徑條數；GET /api/v1/sessions給出總數、近一小時有變更數量及最近修改時間。 - 隊列與補償：
GET /api/v1/observer/queue展示 Pending / In Progress / Processed；本機~/.openviking/pending/*.json統計寫入失敗時的待寫回條數。 - 自動記憶開關：讀取
OPENVIKING_AUTO_CAPTURE、~/.openviking/ovcli.conf的plugin段等，與@openviking/dsh-memory-plugin同一套配置鍵。 - 隱私邊界：API Key 僅在宿主進程使用，頁面展示首尾各 4 位的脫敏字符串；不拉取會話正文或記憶內容，僅聚合計數與健康狀態；請求由宿主發起，瀏覽器側只訪問本機 DSH 路由。
服務端內存佔用沒有公開端點，頁面不展示該項。
前置條件：先部署 OpenViking¶
本插件不包含 OpenViking 服務。應先部署並確保當前機能訪問（例如 http://<host>:<port>），再安裝本插件，否則設置頁沒有有意義的實時數據。
連接信息與 OpenViking 記憶插件共用，按優先級解析：
| 優先級 | 來源 | 字段 |
|---|---|---|
| 1 | 環境變量 | OPENVIKING_URL（或 OPENVIKING_BASE_URL）、OPENVIKING_API_KEY（或 OPENVIKING_BEARER_TOKEN） |
| 2 | ~/.openviking/ovcli.conf |
url、api_key |
| 3 | ~/.openviking/ov.conf |
server.url、server.root_api_key |
服務端需開放 /health、/ready，以及帶鑑權的 /api/v1/* 用於統計類接口。
安裝與啓用¶
方式一：插件市場（推薦）
在 DSH【插件 → 發現】中搜索「OpenViking 狀態」並安裝。若使用自定義市場索引，可將倉庫索引地址加入【發現】（詳見倉庫內 PACKAGING.md）。
方式二：從倉庫安裝
在終端執行：
dsh plugin --profile desktop add "git+https://github.com/TerebiSAMA/dsh-openviking-settings.git"
安裝完成後刷新 DSH 窗口或重啓應用，【設置】側欄會出現「OpenViking」入口。
典型用法¶
- 按上表配置環境變量或
ovcli.conf/ov.conf，確認 OpenViking 已運行且/health、/ready可訪問。 - 安裝插件並刷新 DSH。
- 打開【設置】→「OpenViking」，查看是否「已連接」、版本號與各組件就緒情況。
- 對照記憶條數、會話統計與隊列，判斷記憶流水線是否正常；若本機待寫回條數持續增加，說明有寫入失敗需回到 OpenViking 或網絡側排查。
- 在頁面上覈對自動記憶開關是否與
OPENVIKING_AUTO_CAPTURE或ovcli.conf一致，無需爲看狀態單獨改記憶插件配置（共用同一套鍵）。
適用場景與注意¶
適合已在 DSH 中配合 OpenViking 做記憶、需要在客戶端快速確認「連上了沒有、服務好不好、規模多大」的開發者或自託管運維，而不想每次手敲健康檢查接口。
使用時請注意：
- 插件以當前 DSH 進程權限運行，會按上述優先級讀取本機配置與環境變量；安裝前應瀏覽倉庫源碼並確認 MIT 許可證（
package.json中license爲 MIT）。 - 星標與社區目錄上的分類（admin-security）反映目錄歸類，不代表官方安全審計。
- DSH 生態是「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-openviking-settings 把 OpenViking 的連接、健康與記憶相關計數收進 DSH【設置】，與記憶插件共享連接配置，適合先部署 OpenViking、再在客戶端做日常狀態巡檢。
