From 847c9c1ecdbb6543dd5a1eab2b42c92e21969d31 Mon Sep 17 00:00:00 2001 From: QQ Date: Wed, 11 Nov 2026 10:51:03 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20README.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/README.md b/README.md index 5610819..12aec7a 100644 --- a/README.md +++ b/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 接口 | 方法 | 路径 | 用途 |