dsh-memory-dashboard

Readme

# dsh-memory-dashboard

DeepSeek Harness 的内嵌 Memory View：在对话页顶部增加「记忆」入口，浏览本地 TDAI 四层记忆，并支持搜索、分层切换、详情查看和原始 Session 回跳。

这是一个只读浏览器插件，不替换记忆后端，也不会向 TencentDB Gateway 写入数据。

## 安装

```powershell
dsh plugin --profile web add github:perinchiang/dsh-memory-dashboard
```

安装后重启 `dsh web`，在对话页顶部打开「记忆」即可。生产环境建议将 GitHub 安装锁定到已审阅的 commit：

```powershell
dsh plugin --profile web add github:perinchiang/dsh-memory-dashboard#<commit-sha>
```

## 能力

- 内嵌到 Harness 的 `conversation.view`，不是独立 Dashboard。
- Overview 展示 L0/L1/L2/L3 数量、当前 Layer 占比和会话统计。
- Layer Selector 与记录列表联动，支持本地搜索和加载更多。
- Memory 详情使用移动端 Bottom Sheet，技术 metadata 默认折叠。
- 在存在可定位 Session 时，可从 Memory 详情跳回原始 Harness 会话。
- Desktop 使用居中的 Content Shell，Mobile 使用同一套信息架构并避免横向 overflow。
- 宿主端只读打开 SQLite；浏览器端通过当前 DSH Web 端口访问插件 API。

## 数据来源与后端归属

本插件只负责查看数据。当前 Memory 数据由以下项目提供：

1. **TencentDB Agent Memory（腾讯云开源项目）**：四层记忆后端、L0 对话捕获、LLM 提炼、向量/FTS 存储和召回能力。
   
   [TencentCloud/TencentDB-Agent-Memory：DeepSeek Harness 接入分支](https://github.com/TencentCloud/TencentDB-Agent-Memory/tree/feat/server_team/agents/dsh)

2. **dsh-tdai-memory（DeepSeek Harness 移植层）**：把 TencentDB Agent Memory 接入 DSH，并写入本地 `memory-tdai` 数据目录。
   
   [Scorp1o117/dsh-tdai-memory](https://github.com/Scorp1o117/dsh-tdai-memory)

默认读取：

```text
~/.memory-tencentdb/memory-tdai/vectors.db
```

也可以通过环境变量指定数据目录：

```text
TDAI_DATA_DIR=C:\path\to\memory-tdai
```

本插件不会调用 TencentDB API，不包含 API Key，也不会修改数据库内容。

## 界面截图

以下截图由项目维护者提供，用于展示 Memory View 的实际界面。仓库不再附带包含本地会话内容的测试截图。

![Memory View](assets/memory-overview.png)

## 兼容性

- DeepSeek Harness Web profile
- Node.js `>=22.18`
- 需要已安装并运行 `dsh-tdai-memory`，且本地存在 `vectors.db`
- 插件包包含可直接运行的 `lib/`，GitHub 安装不需要 TypeScript 构建步骤

## 开发与本地验证

插件是标准 DSH bundle，核心清单位于 `package.json` 的 `dsh.bundle`，入口补丁位于 `cordis.patch.yml`。

```powershell
node --check lib/index.js
node --check lib/client.js
dsh --profile web --dump-config
```

本插件的 API 路径为 `/dsh-memory-dashboard/api/*`，只注册 GET 路由。

## 许可证

MIT