dsh-brain/docs/overview.md

1.7 KiB
Raw Blame History

dsh-brain 能力与设计

本页是 README 的完整版:完整能力清单、上报字段与隐私边界。


把 DeepSeek Harness 接到 LongMemory 云端记忆服务:每轮对话结束自动上报一条活动记录(只上传元数据),并把云端记忆库变成 agent 可用的工具。

当前版本 0.9.10,含宿主端与浏览器端两部分:host 半负责活动上报与工具注册,client/index.js 提供「设置 → 插件 → 云端记忆」配置卡片。

它做什么

能力 说明
活动上报 监听 session/event 的 turn/start、turn/end,每个结束的回合调用一次 POST /activity/turn。上报字段只有 6 个:client_id、conversation_id、turn_id、status、started_at、completed_at。
幂等 turn_id 为 <sessionId>:<turn>,服务端按 turn_id 去重,重试不会重复计数。
失败重试 网络错误与 5xx 进入待重试队列(上限 200 条),每 30 秒补发一次;4xx 不重试(说明载荷或令牌有问题)。
记忆工具 memory_search、memory_read、memory_add、memory_list、memory_projects 五个工具直接读写云端记忆库。
配置页 GET /dsh-brain 提供完整配置界面(本 profile 关闭了原生设置页,所以自带页面)。

绝不上传:提示词正文、工具输出、文件内容、本地路径、令牌。上报载荷在类型层面就只有六个字段,构造它的函数拿不到正文。

隐私边界

绝不上传:提示词正文、工具输出、文件内容、本地路径、令牌。上报载荷在类型层面只有六个字段,构造它的函数拿不到正文。