4.0 KiB
4.0 KiB
🧠 dsh-brain
把 DeepSeek Harness 接到你自己的 LongMemory 云端记忆服务。
每轮对话自动上报活动 · 让 agent 直接读写云端记忆 · 技能双向同步 · MCP 统一管理
✨ 它是什么
dsh-brain 是一个 DSH 插件:一边把 DSH 的对话活动(只传元数据)汇入你自托管的 LongMemory,一边把云端记忆库、技能中心变成 agent 随时可用的能力。数据始终留在你自己的服务器上。
🚀 主要能力
| 能力 | 你能得到什么 |
|---|---|
| 📈 活动上报 | 每个回合结束自动上报一条记录,喂给你自己的活跃热力图;幂等去重、失败自动补发。 |
| 🧰 记忆工具 | agent 直接用 memory_search / memory_read / memory_add / memory_list / memory_projects 读写云端记忆库。 |
| 🔗 Mnemon 记忆空间 | 作为 Mnemon 的 Provider,长期记忆每次读写都实时穿透到 LongMemory,别处刚写入的内容立刻可召回。 |
| 🧩 技能双向同步 | 云端技能中心 ↔ 本机技能目录自动对账;冲突按内容与时间自动处理,可逐项确认。 |
| 🗂 技能管理 | 插件内即可列表、启停、删除、从 git 安装技能,不必再装第三方管理器。 |
| 🛠 MCP 管理 | 统一管理 MCP 连接、健康检查、启停、重连与目录市场。 |
| 🎛 统一设置卡 | 「连接与上报 / 技能管理 / MCP 管理」三页签,一处配置。 |
🔒 隐私:绝不上传
提示词正文、工具输出、文件内容、本地路径、令牌都不会上传。上报载荷在类型层面只有 6 个字段(client_id、conversation_id、turn_id、status、started_at、completed_at),构造它的函数拿不到正文。
📦 安装
# 装进当前 profile(默认 desktop)
dsh plugin --profile desktop add dsh-brain
装好后重启 DSH,进入 设置 → 插件 → 云端记忆 进行配置。
⚡ 快速开始
- 填服务地址:把
baseUrl改成你自己的 LongMemory 地址(默认是占位符)。 - 登录取令牌:在设置卡填云端「普通用户」账号密码,一键换取两个令牌(密码不落盘)。
- 开始使用:对话自动上报;让 agent 调记忆工具;在技能页管理技能。
不想用账号登录?也可以直接手填两个令牌。详见 安装与配置。
🧭 文档
| 文档 | 内容 |
|---|---|
| 完整能力与设计 | 完整能力清单、上报字段与隐私边界 |
| 安装与配置 | 安装细节、登录流程、全部配置字段与环境变量 |
| 技能同步与管理 | 双向同步、内置技能管理、按来源的技能树 |
| Mnemon 集成 | 作为记忆空间 Provider 的接入与支持范围 |
| HTTP 接口与状态语义 | 所有本地接口与上报状态映射 |
| 统一管理卡与 MCP | 三页签界面说明、MCP 管理 |
| 故障排查 | 热力图不涨、令牌缺失、网络不可用等 |
| 开发与发布 | 本地构建、验证脚本、打包发布 |
| 管理接口契约 | 各接口的真实契约与能力边界 |
| 源码来源 | 上游基线与本地改动来源 |
🛠 开发
pnpm install
pnpm run build
pnpm run typecheck
发布流程与发布前闸门见 开发与发布。
📄 许可
MIT · 见 LICENSE。