前言¶
在 DeepSeek Harness（DSH）裏配合 Hindsight 做 coding agent 記憶時，常見做法是手改 ~/.hindsight/profiles/<profile>.env 換 LLM，再自己 uvx 重啓 daemon；要看 bank 裏記了什麼，又要另開工具或直接調 REST。維護者 akamuyyds 的 dsh-hindsight-panel 把這兩類操作收進 Harness 側邊欄：本地代理 127.0.0.1:9077 的 Hindsight API，並在面板裏改寫 profile env、可選重啓 daemon，同時瀏覽記憶與統計。下面介紹它是什麼、怎麼裝、怎麼用。
這是什麼¶
dsh-hindsight-panel 是 DSH 的客戶端插件（Cordis bundle + Web 面板），分類爲客戶端。一句話：給 DeepSeek Harness 用的側邊欄面板，集中管理 Hindsight 記憶，並可直接切換 Hindsight 自身使用的 LLM provider/model，無需單獨編輯 env 文件。
- 倉庫：github.com/akamuyyds/dsh-hindsight-panel
- 社區目錄：skillhub.cn 插件頁
- 許可：MIT（見倉庫 LICENSE）
- 當前資料中的包版本：
0.2.9（以 release 壓縮包爲準）
全部在本地運行：插件讀寫 daemon profile 的 env（~/.hindsight/profiles/<profile>.env），API Key 在界面僅以掩碼展示；從 DSH 憑據庫解析的 Key 不進瀏覽器。
環境要求¶
使用前請逐項確認：
- DeepSeek Harness，且爲桌面或 Web profile（僅 CLI 無法使用側邊欄插件）。
- Hindsight coding agent 已安裝並以 daemon 模式運行（例如市場中的
@vectorize-io/hindsight-coding-agents），API 默認在127.0.0.1:9077：
curl http://127.0.0.1:9077/health
# 期望類似：{"status":"healthy","database":"connected", ...}
uvx在 PATH 上——僅「保存並重啓」「回滾」需要；否則用環境變量HINDSIGHT_UVX指定絕對路徑。- Node.js 22.19+ / 24+ 僅用於倉庫單元測試，運行插件不需要。
核心功能¶
| 能力 | 說明 |
|---|---|
| 切換 Hindsight 用的模型 | 選擇 provider、模型、base URL、API Key 與 reasoning effort；保存後可重啓本地 Hindsight daemon；一鍵回滾恢復上一次 LLM 配置。 |
| 複用 DSH 已配置的模型 | Harness profile 裏聲明過的 provider/模型（如 opencode-go、deepseek-official）會列出；API Key 由宿主從 DSH 憑據庫解析，無需在瀏覽器重複填寫。 |
| 查看記憶與統計 | 當前 bank 的記憶、文檔、觀察、LLM 調用統計與知識頁；支持關鍵詞搜索、語義召回、記憶構成圖。 |
| 面板內卸載 | 關於頁通過 Harness 插件管理器移除 bundle 並刷新；不刪除記憶數據與 ~/.hindsight 配置。 |
面板 HTTP 路由掛在 Harness Web 服務器的 /api/dsh-hindsight-panel/* 下；對外部頁面校驗 x-dsh-hindsight-panel: 1 與同源 Origin，僅能從面板內調用。
安裝與啓用¶
插件無構建步驟。推薦用 release 壓縮包一鍵安裝（不必 clone 倉庫）：
- 側邊欄點 插件 → 添加插件（按鈕旁箭頭裏可選「安裝第三方插件」）。
- 粘貼地址並安裝：
https://github.com/akamuyyds/dsh-hindsight-panel/releases/latest/download/dsh-hindsight-panel.tgz
- 安裝完成後側邊欄出現腦圖圖標即表示啓用。
releases/latest/download/...始終指向最新版；升級時先在插件頁卸載舊版，再用同一地址安裝一次。
插件以當前 DSH 進程權限運行，安裝前建議瀏覽倉庫源碼與 MIT 許可證，確認符合你的安全策略。社區目錄站點與 DeepSeek / 幻方無官方從屬關係，屬於 DSH「一切皆插件」生態下的第三方條目。
第一次打開¶
打開面板 模型 頁：
- Daemon 應顯示 healthy 及檢測到的版本（例如
v1.1.0）。 - 當前模型 顯示 daemon 實際使用的 provider/model（來自 profile env），Key 爲掩碼。
- 點 測試連接 會觸發 Hindsight 的
dry-run-extract；能返回 facts 表示 provider、模型、Key 鏈路正常。
若顯示 daemon: unreachable，需先啓動 Hindsight，例如：
uvx hindsight-embed@latest daemon --profile coding-agent start
若使用其他 profile，在 ~/.hindsight/coding-agent.json 中設置 daemonProfile。
典型用法¶
模型頁¶
- 從 DSH 本地配置導入——選擇 Harness profile 裏已有的 provider，模型與憑據名（如
OPENCODE_GO_API_KEY、DEEPSEEK_API_KEY）自動探測；Key 框顯示 自動：<憑據名>。 - 手動配置——選 Hindsight 內置 provider，或自填 provider 名與 OpenAI 兼容 base URL。
- 保存 原位改寫 profile env，保留註釋與無關行。保存並重啓 會執行
uvx hindsight-embed@latest daemon --profile <profile> stop|start，並輪詢/health直至healthy且database: connected（約 1–2 分鐘，含模型校驗與本地 embedding 加載）。 - 回滾 從
~/.hindsight/profiles/<profile>.env.hindsight-panel-backup.json恢復上一版 LLM 配置並重啓。 - Reasoning effort 僅在填寫時寫入；不支持的 provider 寫
none也安全。
空密碼框表示保留已存 Key；要刪除需用「清除已存 Key」。
記憶頁¶
bank 選擇器（常見爲 coding-agent::<repo>）、統計卡片、構成圖與 30 天活躍度曲線；子標籤包括：
- 記憶——按 fact 類型過濾、關鍵詞（
/memories/list?q=）或語義召回（/memories/recall）。 - 文檔、觀察、LLM 調用（provider、模型、token、耗時）、知識頁（無數據時爲空狀態）。
卸載¶
關於 → 卸載，或在 設置 → 插件 移除 Hindsight 記憶；均不會刪除記憶數據或改動 ~/.hindsight。
模型切換原理（簡要）¶
Hindsight 在 daemon 啓動時讀取 LLM 配置，換模型即改 env 再重啓。面板步驟爲：
- 原位改寫相關鍵（
HINDSIGHT_API_LLM_PROVIDER、_MODEL、_API_KEY、_BASE_URL、_REASONING_EFFORT、HINDSIGHT_API_PORT等），保持文件格式與註釋。 - 將上一版 LLM 配置寫入
.hindsight-panel-backup.json供回滾。 - 用
uvx停止並啓動 daemon；以「/health不再應答」視爲停止成功（Windows 上 stop 可能仍返回非 0），再輪詢直至就緒。
重啓失敗時面板展示日誌尾部；env 仍保留最後一次可用值。
適用場景與注意¶
適合：已在 DSH Web/桌面中使用 Hindsight coding agent，需要頻繁試不同 LLM、或經常查看 bank 記憶與調用統計的開發者。
注意：
- 僅本地代理，依賴本機
9077上的 Hindsight daemon。 - 403 等多爲未從面板發起請求；勿從第三方頁面直接調插件 API。
- 更新後若側邊欄圖標消失，在 設置 → 插件 禁用再啓用 Hindsight 記憶 並刷新頁面（宿主不會熱重載 bundle）。
結尾¶
dsh-hindsight-panel 把 Hindsight 的模型配置與記憶瀏覽放進 DSH 側邊欄，並與 Harness profile 憑據對齊，減少手改 env 和分散查 API 的成本。詳情與 issue 見 GitHub 倉庫，目錄條目見 SkillHub 插件頁。
