前言¶

DeepSeek Harness（DSH）的插件生態強調“一切皆插件”。在使用官方 @vectorize-io/hindsight-coding-agents 插件時，桌面端存在兩個具體問題：一是守護進程不會隨 DSH 自動啓動，需要手動在 CLI 中處理；二是啓動時會彈出黑色的終端窗口。

本插件作爲旁路補丁，接管守護進程的啓動與停止，自動綁定 DSH 的生命週期。它解決了守護進程冷啓動延遲、黑框干擾以及安裝路徑受限的問題，使本地記憶功能在桌面端具備完整的可用性。

核心功能¶

一鍵開關與狀態指示
在 DSH 側邊欄提供“本地記憶”按鈕，實時顯示守護進程狀態（未運行 / 啓動中 / 運行中 / 失敗）。
自動啓動與退出隨停
插件會在 DSH 啓動後約 40 秒內自動拉起守護進程，不阻塞主界面。同時，它通過一個獨立的“看門狗”進程監控 DSH 主進程，一旦檢測到 DSH 退出，立即殺掉守護進程並釋放內存。
隱藏終端黑框
插件會自動給官方的 daemon-start.js 打上“隱藏窗口”的補丁（支持自愈，官方更新後自動重打），並後臺隱藏 uv.exe 的終端窗口。
安裝到其它盤
通過配置參數，可將守護進程（uv 緩存）與模型緩存安裝到任意盤符，避免佔用 C 盤空間。

    <DSH_HOME>/profiles/node_modules/dsh-hindsight-local/

    - insert:
        - id: hindsight-local
          name: 'dsh-hindsight-local'

安裝並重啓 DSH 後，守護進程會自動進入待命狀態。

插件自身的配置文件位於 <DSH_HOME>/storages/dsh-hindsight-local/config.json：

{
  "installDir": "X:\\hindsight",
  "autoStart": true
}

installDir：指定守護進程與模型的安裝目錄。留空則使用系統默認位置；指定後，UV_CACHE_DIR 和 HF_HOME 會指向該目錄下的子文件夾，從而將數據安裝到任意盤符。
autoStart：布爾值。設爲 true 時，DSH 啓動時自動拉起守護進程；設爲 false 時，僅依賴手動開關。

資源佔用：本地守護進程常駐內存約 0.8–1 GB，首次安裝磁盤佔用約 3 GB（主要包含 torch 依賴及模型文件）。關閉開關或退出 DSH 後內存會釋放。
冷啓動時間：首次啓動需下載依賴和模型，耗時約 1–3 分鐘；後續緩存命中，約 40 秒內就緒。
黑框機制：黑框是通過 ShowWindow(SW_HIDE) 隱藏的，進程仍在後臺運行。不要手動點擊黑框的關閉按鈕，否則會殺掉守護進程。
官方更新：官方插件更新可能會覆蓋 daemon-start.js，本插件的窗口補丁會在下次啓動時自動重打。
密鑰安全：DEEPSEEK_API_KEY 僅通過 DSH 宿主的憑證服務讀取，不寫入本地文件，也不會暴露在插件進程之外。

該插件通過旁路補丁的方式，完善了 hindsight-coding-agents 在 DSH 桌面端的本地記憶生命週期管理。它提供了自動啓動、退出清理、窗口隱藏以及安裝路徑配置等實用功能，適合需要穩定使用本地記憶功能的開發者。