更新 README.md
This commit is contained in:
parent
430c07aaa7
commit
847c9c1ecd
29
README.md
29
README.md
|
|
@ -66,6 +66,8 @@ dsh plugin --profile desktop add dsh-cloud-memory
|
|||
| `defaultK` | `10` | `memory_search` 未指定 `k` 时的条数。 |
|
||||
| `activityToken` | — | `activity:write` 令牌,形如 `cmt_…`。 |
|
||||
| `memoryToken` | — | `memory:read` / `memory:write` 令牌,形如 `cmt_…`。 |
|
||||
| `skillsSyncEnabled` | `true` | 云端技能中心与本机技能目录的双向同步开关。 |
|
||||
| `skillsDir` | 空 | 本机技能目录覆盖;为空时用 `$DSH_HOME/skills`。 |
|
||||
|
||||
两个令牌也可以用环境变量 `DSH_CLOUD_MEMORY_ACTIVITY_TOKEN`、`DSH_CLOUD_MEMORY_MEMORY_TOKEN` 覆盖。
|
||||
|
||||
|
|
@ -100,6 +102,33 @@ v1 范围:支持 发现 / 状态 / 搜索 / 浏览 / 写入 / 按 id 读取;
|
|||
验证:`node verify-mnemon-provider.mjs`(对本地 stub 服务跑通
|
||||
发现→写入→召回→项目隔离全流程)。
|
||||
|
||||
## 技能同步
|
||||
|
||||
自 0.3.0 起,插件在记忆之外还双向同步技能:云端技能中心是总汇,本机
|
||||
技能目录(默认 `$DSH_HOME/skills`)是工作副本,本地的浏览、启停、分类
|
||||
仍归 DSH 技能管理器。插件启动 5 秒后首跑,之后每 15 分钟对账一次;
|
||||
结果与冲突列表见 `GET /cloud-memory/status` 的 `skills` 字段,聊天里
|
||||
也可以用 `skill_list` 工具查看云端清单。
|
||||
|
||||
- **下行**:云端技能按平台自己的规矩落地——先验整包清单哈希、再逐
|
||||
文件验 sha256,原子写入,并留下 `.manifest.json` 交付记录;云端标
|
||||
记了「脚本已变更待确认」的包不会自动安装,先在看板里确认。
|
||||
- **上行**:本地原创技能(管理器安装、导入或手写的)自动发布到云
|
||||
端;之后的修改以新修订发布,带 `expected_revision` 守卫,云端被
|
||||
别人先改过就报冲突、不强行覆盖。
|
||||
|
||||
防事故的规矩:云端交付的技能从不回传,本地改动它只报
|
||||
`locally_modified` 冲突、原样不动;本地删除不删云端,且同版本不会
|
||||
被重新拉回(云端出了新版才会再下来);同名技能两边都有时互不抢占,
|
||||
报 `name_collision`。云端只接受固定布局(根目录只有 `SKILL.md`,
|
||||
其余文件进 `references/`、`scripts/`、`assets/`,扩展名有白名单,
|
||||
单文件 ≤512 KiB、整包 ≤2 MiB、≤100 个文件),不符合的本地技能报
|
||||
`unsupported_layout`,不会为了迁就而裁剪文件。
|
||||
|
||||
验证:`node verify-skills-sync.mjs`(对本地 stub 技能中心跑通
|
||||
下行安装、上行发布与修订、改云端技能报冲突、同名冲突、脚本待审、
|
||||
布局拒绝、删除不传播全流程)。
|
||||
|
||||
## HTTP 接口
|
||||
|
||||
| 方法 | 路径 | 用途 |
|
||||
|
|
|
|||
Loading…
Reference in New Issue