更新 README.md
This commit is contained in:
parent
c5cc145fe2
commit
eacb8d2eee
60
README.md
60
README.md
|
|
@ -1,4 +1,4 @@
|
|||
# dsh-cloud-memory
|
||||
# dsh-brain
|
||||
|
||||
把 DeepSeek Harness 接到 LongMemory 云端记忆服务:**每轮对话结束自动上报一条活动记录**(只上传元数据),并把云端记忆库变成 agent 可用的工具。
|
||||
|
||||
|
|
@ -12,29 +12,47 @@
|
|||
| 幂等 | `turn_id` 为 `<sessionId>:<turn>`,服务端按 `turn_id` 去重,重试不会重复计数。 |
|
||||
| 失败重试 | 网络错误与 5xx 进入待重试队列(上限 200 条),每 30 秒补发一次;4xx 不重试(说明载荷或令牌有问题)。 |
|
||||
| 记忆工具 | `memory_search`、`memory_read`、`memory_add`、`memory_list`、`memory_projects` 五个工具直接读写云端记忆库。 |
|
||||
| 配置页 | `GET /cloud-memory` 提供完整配置界面(本 profile 关闭了原生设置页,所以自带页面)。 |
|
||||
| 配置页 | `GET /dsh-brain` 提供完整配置界面(本 profile 关闭了原生设置页,所以自带页面)。 |
|
||||
|
||||
**绝不上传**:提示词正文、工具输出、文件内容、本地路径、令牌。上报载荷在类型层面就只有六个字段,构造它的函数拿不到正文。
|
||||
|
||||
## 改名与迁移(v0.5.0)
|
||||
|
||||
本插件原名 **dsh-cloud-memory**,自 v0.5.0 起改名为 **dsh-brain**(仓库同步改名)。
|
||||
|
||||
**自动迁移**(首次启动新版时完成,无需手动):
|
||||
|
||||
- 设置与令牌文件 `$DSH_HOME/cloud-memory.json` → 复制为 `dsh-brain.json`(旧文件保留不删)
|
||||
- 技能同步状态 `$DSH_HOME/cloud-memory-skills.json` → 复制为 `dsh-brain-skills.json`(同上)
|
||||
- 旧路由 `/cloud-memory/*` 全部保留为别名,与新路由 `/dsh-brain/*` 指向同一处理函数
|
||||
- 旧环境变量 `DSH_CLOUD_MEMORY_*_TOKEN` 继续生效(新名 `DSH_BRAIN_*_TOKEN` 优先)
|
||||
|
||||
**需要手动改两处**:
|
||||
|
||||
1. 插件注册:从 profile 的 bundles 里移除旧的 `dsh-cloud-memory`,改装 `dsh-brain`(`dsh plugin --profile desktop add dsh-brain` 后完全重启)。
|
||||
2. Mnemon 配置里 provider 一行改名:`- use: dsh-brain/mnemon-provider`。
|
||||
|
||||
不变的东西:`clientId`(默认 `dsh-desktop`)、技能包校验格式(`cloud-memory-skill-v1` 是与云端约定的线格式)、云端 API 地址与令牌本身。
|
||||
|
||||
## 安装
|
||||
|
||||
```powershell
|
||||
# 装进当前 profile(默认 desktop)
|
||||
dsh plugin --profile desktop add dsh-cloud-memory
|
||||
dsh plugin --profile desktop add dsh-brain
|
||||
```
|
||||
|
||||
装好后确认 profile 的 `package.json` 里有两处:
|
||||
|
||||
```jsonc
|
||||
{
|
||||
"dependencies": { "dsh-cloud-memory": "^0.1.0" },
|
||||
"dsh": { "profile": { "bundles": [ /* ..., */ "dsh-cloud-memory" ] } }
|
||||
"dependencies": { "dsh-brain": "^0.5.0" },
|
||||
"dsh": { "profile": { "bundles": [ /* ..., */ "dsh-brain" ] } }
|
||||
}
|
||||
```
|
||||
|
||||
重启 DSH,在「设置 → 插件 → 云端记忆」里配置(备用入口:`http://127.0.0.1:<当次端口>/cloud-memory`)。
|
||||
重启 DSH,在「设置 → 插件 → 云端记忆」里配置(备用入口:`http://127.0.0.1:<当次端口>/dsh-brain`)。
|
||||
|
||||
> `baseUrl` 默认是占位符 `https://your-memory-host/api/longmemory`。**首次使用必须先把它改成你自己的 LongMemory 服务地址**(配置页里填,或写进 `$DSH_HOME/cloud-memory.json`),否则上报与工具都会连接失败。
|
||||
> `baseUrl` 默认是占位符 `https://your-memory-host/api/longmemory`。**首次使用必须先把它改成你自己的 LongMemory 服务地址**(配置页里填,或写进 `$DSH_HOME/dsh-brain.json`),否则上报与工具都会连接失败。
|
||||
|
||||
## 登录(推荐)
|
||||
|
||||
|
|
@ -43,11 +61,11 @@ dsh plugin --profile desktop add dsh-cloud-memory
|
|||
```
|
||||
密码 → POST /api/auth/login(一次性会话 cookie)
|
||||
→ POST /api/auth/tokens ×2(activity:write、memory:write)
|
||||
→ 只把两个 cmt_… 令牌写进 $DSH_HOME/cloud-memory.json
|
||||
→ 只把两个 cmt_… 令牌写进 $DSH_HOME/dsh-brain.json
|
||||
→ 密码与会话 cookie 立即丢弃
|
||||
```
|
||||
|
||||
- 密码只在这一串请求里存在:不落盘、不写日志、不随 `/cloud-memory/status` 回显。
|
||||
- 密码只在这一串请求里存在:不落盘、不写日志、不随 `/dsh-brain/status` 回显。
|
||||
- 服务端只保存令牌哈希,令牌可单独撤销;改密码不影响已签发令牌。
|
||||
- 服务地址不是 HTTPS(且不是 loopback)时插件拒绝发送密码。
|
||||
- 管理员账号不能签发个人令牌(服务端 `403 management_only`),请用普通用户。
|
||||
|
|
@ -55,7 +73,7 @@ dsh plugin --profile desktop add dsh-cloud-memory
|
|||
|
||||
## 配置
|
||||
|
||||
配置文件 `$DSH_HOME/cloud-memory.json`(默认 `%USERPROFILE%\.dsh\cloud-memory.json`),字段:
|
||||
配置文件 `$DSH_HOME/dsh-brain.json`(默认 `%USERPROFILE%\.dsh\dsh-brain.json`),字段:
|
||||
|
||||
| 字段 | 默认 | 说明 |
|
||||
| --- | --- | --- |
|
||||
|
|
@ -85,12 +103,12 @@ dsh plugin --profile desktop add dsh-cloud-memory
|
|||
|
||||
```yaml
|
||||
providers:
|
||||
- use: dsh-cloud-memory/mnemon-provider
|
||||
- use: dsh-brain/mnemon-provider
|
||||
instanceId: longmemory
|
||||
```
|
||||
|
||||
之后在 Mnemon 的插件页会出现 LongMemory 的服务字段(Endpoint / Memory
|
||||
token),留空即复用本插件已有的 `cloud-memory.json` 配置,一处配置两处生效。
|
||||
token),留空即复用本插件已有的 `dsh-brain.json` 配置,一处配置两处生效。
|
||||
每个记忆空间映射一个 LongMemory 项目:发现流程会自动列出账号下的全部
|
||||
项目,外加一个不分项目的「全部」空间;也可以在空间上手动填 Project ID。
|
||||
|
||||
|
|
@ -107,7 +125,7 @@ v1 范围:支持 发现 / 状态 / 搜索 / 浏览 / 写入 / 按 id 读取;
|
|||
自 0.3.0 起,插件在记忆之外还双向同步技能:云端技能中心是总汇,本机
|
||||
技能目录(默认 `$DSH_HOME/skills`)是工作副本,本地的浏览、启停、分类
|
||||
仍归 DSH 技能管理器。插件启动 5 秒后首跑,之后每 15 分钟对账一次;
|
||||
结果与冲突列表见 `GET /cloud-memory/status` 的 `skills` 字段,聊天里
|
||||
结果与冲突列表见 `GET /dsh-brain/status` 的 `skills` 字段,聊天里
|
||||
也可以用 `skill_list` 工具查看云端清单。
|
||||
|
||||
- **下行**:云端技能按平台自己的规矩落地——先验整包清单哈希、再逐
|
||||
|
|
@ -131,7 +149,7 @@ v1 范围:支持 发现 / 状态 / 搜索 / 浏览 / 写入 / 按 id 读取;
|
|||
|
||||
## 技能管理(内置)
|
||||
|
||||
自 0.4.0 起,常用的本地管理也长在插件里,页面在 `/cloud-memory/skills`
|
||||
自 0.4.0 起,常用的本地管理也长在插件里,页面在 `/dsh-brain/skills`
|
||||
(配置页有链接进入):
|
||||
|
||||
- **列表**:本机全部技能,标注来源(云端交付 / 本地已传云端 / 本地)
|
||||
|
|
@ -157,12 +175,12 @@ git 安装与同名跳过、以及停用技能与同步引擎的配合共 15 项
|
|||
|
||||
| 方法 | 路径 | 用途 |
|
||||
| --- | --- | --- |
|
||||
| GET | `/cloud-memory` | 配置页面 |
|
||||
| GET | `/cloud-memory/status` | 设置 + 上报计数 + 最近 50 条记录(令牌只返回掩码) |
|
||||
| PUT | `/cloud-memory/config` | 应用设置补丁(令牌留空表示不修改) |
|
||||
| POST | `/cloud-memory/login` | 账号密码登录,换取两个令牌并保存(密码不落盘) |
|
||||
| POST | `/cloud-memory/test` | 分别校验两个令牌(活动令牌用空载荷探测,鉴权先于载荷校验,返回 400 即代表令牌有效,不会写入记录) |
|
||||
| POST | `/cloud-memory/flush` | 立即补发待重试队列 |
|
||||
| GET | `/dsh-brain` | 配置页面 |
|
||||
| GET | `/dsh-brain/status` | 设置 + 上报计数 + 最近 50 条记录(令牌只返回掩码) |
|
||||
| PUT | `/dsh-brain/config` | 应用设置补丁(令牌留空表示不修改) |
|
||||
| POST | `/dsh-brain/login` | 账号密码登录,换取两个令牌并保存(密码不落盘) |
|
||||
| POST | `/dsh-brain/test` | 分别校验两个令牌(活动令牌用空载荷探测,鉴权先于载荷校验,返回 400 即代表令牌有效,不会写入记录) |
|
||||
| POST | `/dsh-brain/flush` | 立即补发待重试队列 |
|
||||
|
||||
写接口会校验同源 `Origin`,跨站请求返回 403。
|
||||
|
||||
|
|
@ -179,7 +197,7 @@ git 安装与同名跳过、以及停用技能与同步引擎的配合共 15 项
|
|||
|
||||
## 故障排查
|
||||
|
||||
- **热力图不涨**:看 `/cloud-memory/status` 的 `reporter.skipped` 与 `lastError`;常见原因是没配 `activityToken`、插件被 `enabled:false` 关掉,或令牌缺 `activity:write` scope。
|
||||
- **热力图不涨**:看 `/dsh-brain/status` 的 `reporter.skipped` 与 `lastError`;常见原因是没配 `activityToken`、插件被 `enabled:false` 关掉,或令牌缺 `activity:write` scope。
|
||||
- **工具报“未配置记忆令牌”**:填 `memoryToken`;写入还需要云端已配置 WebDAV 主存储(否则服务端 409 `storage_not_configured`)。
|
||||
- **网络不可用**:上报会进队列,恢复后 30 秒内自动补发;也可以在配置页点“重试上报队列”。
|
||||
- **令牌泄漏风险**:令牌只存在本机 JSON 文件里,页面只回显掩码(`cmt_act…0001`)。文件权限依赖用户目录 ACL(Windows 无 POSIX 位)。
|
||||
|
|
|
|||
Loading…
Reference in New Issue