dsh-brain/README.md

4.0 KiB
Raw Blame History

🧠 dsh-brain

把 DeepSeek Harness 接到你自己的 LongMemory 云端记忆服务。

每轮对话自动上报活动 · 让 agent 直接读写云端记忆 · 技能双向同步 · MCP 统一管理

version license node platform


✨ 它是什么

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,进入 设置 → 插件 → 云端记忆 进行配置。

⚡ 快速开始

  1. 填服务地址:把 baseUrl 改成你自己的 LongMemory 地址(默认是占位符)。
  2. 登录取令牌:在设置卡填云端「普通用户」账号密码,一键换取两个令牌(密码不落盘)。
  3. 开始使用:对话自动上报;让 agent 调记忆工具;在技能页管理技能。

不想用账号登录?也可以直接手填两个令牌。详见 安装与配置。

🧭 文档

文档 内容
完整能力与设计 完整能力清单、上报字段与隐私边界
安装与配置 安装细节、登录流程、全部配置字段与环境变量
技能同步与管理 双向同步、内置技能管理、按来源的技能树
Mnemon 集成 作为记忆空间 Provider 的接入与支持范围
HTTP 接口与状态语义 所有本地接口与上报状态映射
统一管理卡与 MCP 三页签界面说明、MCP 管理
故障排查 热力图不涨、令牌缺失、网络不可用等
开发与发布 本地构建、验证脚本、打包发布
管理接口契约 各接口的真实契约与能力边界
源码来源 上游基线与本地改动来源

🛠 开发

pnpm install
pnpm run build
pnpm run typecheck

发布流程与发布前闸门见 开发与发布。

📄 许可

MIT · 见 LICENSE。