在 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 开发者提供了一个可视化的窗口来排查记忆系统的状态,是调试智能体记忆流程的有力辅助工具。