前言¶

DeepSeek Harness (DSH) 強調插件化架構，而 Memorix 是一個本地優先的 AI 記憶控制平面，負責存儲項目級和知識級的記憶。當開發者需要在 Web 界面中直接瀏覽、檢索和管理這些記憶時，直接操作數據庫往往存在風險且不夠直觀。dsh-memorix-panel 插件正是爲了解決這一痛點而生，它將 Memorix 的 SQLite 記憶庫接入 DSH 的 Web GUI，提供可視化的管理界面。

插件介紹¶

dsh-memorix-panel 是一個由 biubiu23333333 維護的 DSH 插件。它通過連接本地的 Memorix 數據庫，讓用戶在 DSH 的會話界面中直接查看記憶庫狀態、統計總量、搜索與篩選記憶、查看詳情以及管理狀態。

在數據讀寫策略上，插件採取“只讀讀取、CLI 寫入”的方案：讀取操作直接連接 SQLite 數據庫，不依賴任何第三方運行時；寫入操作（如新建記憶、修改狀態）一律通過官方 memorix CLI 執行，以確保 Memorix 自身的檢索索引保持同步。該插件零運行時依賴，遵循 MIT 許可證。

功能特性¶

插件主要提供以下功能：

• 庫狀態與統計：顯示記憶庫路徑、文件大小、WAL 大小、最後更新時間以及 Memorix CLI 版本。支持統計記憶、項目、活躍、歸檔、長期記憶、迷你技能、會話、證據卡、知識頁的數量。
• 檢索與篩選：支持按標題、實體名稱、類型進行搜索，並可通過記憶類型與狀態進行篩選。
• 項目與記憶列表：以手風琴形式展示項目列表，展開後可查看該項目下的記憶。
• 記憶詳情：展示記憶的元信息、正文、要點、概念、涉及文件、關聯提交、關聯實體等完整信息。
• 狀態管理與新建：支持在詳情頁直接修改記憶狀態（需二次確認），或在面板內新建記憶。
• 長期記憶視圖：提供獨立的長期記憶分區，展示狀態（候選、已確認、已批准、已歸檔等）、作用域與類型。面板會提示狀態流轉規則，如“候選與已確認不會進入 Workset，必須 approve”。
• 長期記憶管理：支持驅動 Memorix 的狀態機（候選 → 確認 → 已確認 → 批准 → 已批准，或歸檔），操作需填寫理由並二次確認。
• 一鍵複製項目名：支持在項目行、記憶詳情的“項目”行及長期記憶詳情的“起源項目”行旁一鍵複製 projectId。

前置條件¶

使用本插件前，需滿足以下環境要求：

• DSH Web GUI：已安裝並可用。
• Node.js：版本需 ≥ 22.18.0。這是 Memorix 自身的版本要求。
• Git：已安裝。Memorix 的項目身份來自真實 Git 根目錄。
• Memorix CLI：已安裝。提供 memorix 命令行工具。
• dsh-better-sidebar（可選）：若需在右側工作臺 tab 中看到“Memorix 記憶”入口，需安裝此插件。

安裝與啓用¶

安裝插件需要 DSH 的 Web profile（通常名爲 web）。使用以下命令安裝：

dsh plugin --profile web add dsh-memorix-panel

安裝完成後，執行硬刷新瀏覽器（Windows/Linux 爲 Ctrl+Shift+R，macOS 爲 Cmd+Shift+R）以使客戶端生效。如果主機端有更新，還需要重啓 dsh-web 服務。

使用說明¶

入口位置¶

面板提供三種入口方式：
1. 會話標題欄：默認位置。在任意會話界面的標題欄中，點擊「Session 日誌」按鈕右側的「● 記憶 N」按鈕。
2. 右側邊緣停靠：當沒有活動會話或找不到「Session 日誌」按鈕時，入口會自動停靠在瀏覽器窗口右側邊緣垂直居中處。
3. 右側工作臺 tab：如果部署中安裝了 dsh-better-sidebar 且與本插件處於同一客戶端組裝域，工作臺的「+ / 空面板卡片」中會出現「Memorix 記憶」選項。

點擊入口後，面板會以瀏覽器頂層浮層的形式從右側滑出。

基本操作¶

1. 瀏覽與檢索：在面板頂部使用搜索框輸入關鍵詞（支持標題、實體、類型），或使用下方的篩選器按類型和狀態過濾記憶。
2. 查看詳情：點擊列表中的記憶條目，查看完整的元信息、正文、要點和關聯文件。
3. 修改狀態：在詳情頁底部，點擊「改狀態」按鈕。選擇目標狀態（如 active、resolved、archived），系統會彈出二次確認框。
4. 新建記憶：在面板中點擊「新建記憶」，按照提示填寫標題、正文、類型等信息，點擊確認後，命令行會執行寫入操作。

長期記憶管理¶

長期記憶視圖展示了 Memorix 的耐用記憶層。該視圖展示了記憶的狀態流轉過程。

• 狀態流轉：記憶通常經歷「候選」→「確認」→「已確認」→「批准」→「已批准」的過程。
• 管理操作：在長期記憶詳情頁，可以直接點擊「確認」或「批准」按鈕來推進狀態機。每次操作都需要填寫理由（寫入審計事件）並確認。
• 提示：面板會提示「候選與已確認都不會進入 Workset，必須 approve」。

數據路徑¶

插件通過讀取以下文件來獲取數據：
* ~/.memorix/data/memorix.db：SQLite 記憶庫。
* ~/.memorix/data/.project-aliases.json：項目別名映射。
* ~/.memorix/last-project-root：最近使用的項目根路徑。

命令行寫入示例¶

當在界面中觸發“新建記憶”或“改狀態”時，插件實際上是在後臺調用 Memorix 的 CLI 命令。例如：

# 改狀態
memorix memory resolve --id <n> --status active|resolved|archived -- --cwd <項目根>

# 新建記憶
memorix memory store --text <正文> --title <標題> --type <類型> \
  --json --cwd <項目根>

配置¶

所有配置項位於 profile 的 cordis.patch.yml 文件中，且均爲可選。主要配置項如下：

示例配置：

- insert:
    - id: memorix-panel
      name: dsh-memorix-panel
      config:
        bin: memorix
        cliTimeoutMs: 25000
        allowWrite: true
        allowStore: true

若只需只讀瀏覽，可將 allowWrite 與 allowStore 設爲 false。