在 DeepSeek Harness (DSH) 的開發流程中,調試記憶系統的狀態(如 Layer 0、1、2、3 的分佈)通常是隱性的。開發者很難直觀地確認記憶是否被正確捕獲或檢索。DSH 採用插件化架構,下面介紹一個內嵌到對話視圖的本地記憶瀏覽器。
插件定位¶
dsh-memory-dashboard 是一個由 perinchiang 維護的插件,直接在 Harness 的對話界面中提供本地四層記憶的只讀瀏覽功能。它不替代記憶後端,也不向騰訊雲網關寫入數據,僅作爲數據查看工具存在。
核心能力¶
-
內嵌視圖
插件注入到 Harness 的conversation.view,不提供獨立的 Dashboard 頁面。 -
Overview 統計
界面頂部展示 L0/L1/L2/L3 的數量、當前 Layer 佔比和會話統計。 -
交互與篩選
Layer Selector 與記錄列表聯動,支持本地搜索和加載更多。 -
詳情查看
Memory 詳情在移動端使用 Bottom Sheet,技術 metadata 默認摺疊。在存在可定位 Session 時,可從詳情跳回原始 Harness 會話。 -
界面適配
Desktop 使用居中的 Content Shell,Mobile 使用同一套信息架構並避免橫向 overflow。 -
技術實現
宿主端只讀打開 SQLite;瀏覽器端通過當前 DSH Web 端口訪問插件 API。
安裝與配置¶
使用官方命令安裝插件:
dsh plugin --profile web add github:perinchiang/dsh-memory-dashboard
安裝後需要重啓 dsh web。生產環境中建議將 GitHub 安裝鎖定到已審閱的 commit,以確保穩定性:
dsh plugin --profile web add github:perinchiang/dsh-memory-dashboard#<commit-sha>
插件默認讀取以下路徑的 SQLite 數據庫:
~/.memory-tencentdb/memory-tdai/vectors.db
如果數據目錄不在默認位置,可以通過環境變量指定:
TDAI_DATA_DIR=C:\path\to\memory-tdai
使用步驟¶
- 安裝並重啓
dsh web。 - 進入對話頁。
- 在頁面頂部打開「記憶」入口。
適用場景與注意事項¶
該插件依賴本地已安裝並運行 dsh-tdai-memory,且本地必須存在 vectors.db 文件。
插件在宿主端以只讀權限運行,具有以下特性:
* 不調用騰訊雲 API,不包含 API Key。
* 不修改數據庫內容。
* 僅作爲瀏覽器插件運行,無需 TypeScript 構建步驟。
DSH 的設計理念是「一切皆插件」,本插件屬於社區目錄中的項目,與 DeepSeek 或幻方研究院無官方從屬關係。
結尾¶
dsh-memory-dashboard 爲 DSH 開發者提供了一個可視化的窗口來排查記憶系統的狀態,是調試智能體記憶流程的有力輔助工具。