前言¶
在 DSH 裏跑智能體時，會話記憶往往落在 dsh-fish-memory 的按會話 JSON 文件裏；圖書館條目則常由 dsh-pin 維護。要在瀏覽器裏搜記憶、按會話或排序方式篩一遍，再對圖書館做增刪，通常得自己寫腳本或反覆調 API。dsh-memory-gui 是社區維護的客戶端類 DSH 插件，提供一個統一瀏覽頁，把上述兩類能力接到同一入口。下面介紹它的定位、能力與安裝方式。
這是什麼¶
dsh-memory-gui（GitHub：xiaole3349/dsh-memory-gui）由維護者 xiaole3349 發佈，在 SkillHub 目錄中歸類爲客戶端。插件版本在 package.json 中爲 0.1.0，許可證爲 MIT。一句話定位：爲 DSH 提供「記憶庫 + 圖書館」的 Web 瀏覽界面——記憶側讀 fish-memory 的會話存儲並在服務端搜索、篩選、排序；圖書館側複用 dsh-pin 的接口，支持增刪。
核心功能¶
記憶瀏覽¶
插件直接讀取 dsh-fish-memory 的每會話存儲（session-*.json）。在服務端完成搜索與篩選，可按時間或重要度排序，並可限定某一會話。數據目錄依賴爲 ~/.dsh/fish-memory/（需已安裝並寫入數據的 dsh-fish-memory）。
圖書館管理¶
圖書館功能複用 dsh-pin 的圖書館接口，在同源環境下調用 /dsh-pin/lib/*，可在 GUI 中增加與刪除圖書館條目（具體字段與語義以 dsh-pin 文檔爲準）。
HTTP 接口¶
除頁面外，插件暴露只讀記憶相關 API，便於腳本或前端聯調：
GET /dsh-memory-gui/api/sessions：列出可用會話。GET /dsh-memory-gui/api/memory?q=&session=&sort=recency|importance&limit=200：按查詢詞q、可選session、sort（recency或importance）及limit（示例默認 200）返回記憶條目。
安裝與啓用¶
官方 README 給出兩種方式，任選其一。
方式一：bundle 安裝¶
在插件源碼所在目錄執行（<本目錄> 即該倉庫根目錄）：
plugin_manager install_bundle <本目錄>
這一步通過 DSH 的 bundle 機制把插件打進當前 profile。
方式二：寫入 cordis.patch¶
在 profile 的 cordis.patch.yml 中插入：
- insert:
- id: memory-gui
name: dsh-memory-gui
保存後按你現有的 DSH / profile 流程加載 patch。
裝好後，在瀏覽器訪問：
<DSH 地址>/dsh-memory-gui
將 <DSH 地址> 換成你實際運行的 DSH 基址（含協議與端口）。
典型用法¶
- 確認
dsh-fish-memory已在運行或至少已在~/.dsh/fish-memory/下產生session-*.json；確認dsh-pin可用，以便圖書館增刪走/dsh-pin/lib/*。 - 按上一節完成安裝，打開
/dsh-memory-gui頁面，在記憶區用搜索、會話篩選與時間或重要度排序查看條目。 - 在圖書館區通過 GUI 增刪條目（底層仍由
dsh-pin處理）。 - 若需自動化，可對
GET /dsh-memory-gui/api/sessions與GET /dsh-memory-gui/api/memory?...發請求，參數與 README 中示例一致。
適用場景與注意¶
適合誰：已在 DSH 中使用 fish-memory 存會話記憶、並用 dsh-pin 管圖書館的開發者，希望用瀏覽器集中查看與輕量管理，而不每次手寫查詢腳本。
依賴：記憶瀏覽依賴 dsh-fish-memory 數據目錄；圖書館依賴 dsh-pin。缺任一組件時，對應頁籤或操作會不可用或報錯，安裝前請先配好生態裏的這兩個插件。
安全：插件與 DSH 進程同權限運行，能讀 ~/.dsh/fish-memory/ 並代你調用 pin 的圖書館 API。安裝前應閱讀倉庫源碼與 MIT 許可，確認符合你的部署策略。SkillHub 目錄頁（https://www.skillhub.cn/plugins/xiaole3349/dsh-memory-gui）是社區插件索引，與 DeepSeek / 幻方無官方從屬關係；DSH 本身遵循「一切皆插件」的擴展方式，本插件是其中一條客戶端擴展。
結尾¶
dsh-memory-gui 把 fish-memory 的會話 JSON 與 dsh-pin 的圖書館接到同一瀏覽頁，並提供記憶相關的 REST 查詢接口。若你的棧裏已有上述兩個插件，可按 README 的 plugin_manager install_bundle 或 cordis.patch.yml 方式啓用，再從 <DSH 地址>/dsh-memory-gui 進入。
- 目錄頁：https://www.skillhub.cn/plugins/xiaole3349/dsh-memory-gui
- 源碼與說明：https://github.com/xiaole3349/dsh-memory-gui
