前言¶
在 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
