dsh-environment-sync

配置与凭据

environment.json 格式 2 保存同步范围，旧格式 1 只读迁移。config/plugins.json 保存精确版本与来源。原作者和 fork 信息随记录保留，不改变仓库的公开或私有属性。

0.7.0 起，Home 下的 .agent-presets// 随共享环境上传并恢复，包括 agent.cordis.yml、可选 preset.yml、技能和二进制资产；内置预设与额外配置根目录不在该范围。文件保留原目录和 Git 历史，冲突按文件选择；environment.json.agentPresets 记录文件、执行权限与明确删除。只有此前记录过的文件会同步删除，目标电脑的其他预设保留。没有此字段的旧快照不改动本机预设；两台电脑均须升级管理器至 0.7.0 后同步预设，旧管理器仍可读取格式 2 并安装共享清单中的新管理器。

预设是受信任的可执行配置。该目录只能放准备跨机共享的定义、技能与资产；不要放凭据、聊天、附件或机器路径。链接、特殊文件、路径越界、已知凭据与运行数据目录、缺少组装文件或错误 YAML 均在预检时拒绝，不递归读取链接目标。预设文件纳入同一应用恢复记录，失败时恢复原内容与权限。

0.7.1 起，Home 的 .dsh-agent-presets-sync-baseline.json 区分已受管文件与尚未恢复的远端文件。首次升级或接入时，缺少远端文件不代表删除；应用后才接管删除语义。该基线只留在本机，并随应用失败恢复。

插件展示数据（catalog.json）

管理页面的插件显示名、作用范围分类和说明来自插件自带的 catalog.json，与版本和来源（私有仓库的 config/plugins.json）分开维护。每个条目必须带：

• name —— 面向用户的显示名，中文短名，不是包名。
• scope —— 作用范围，取值 session（会话插件）或 global（全局插件）。
• description —— 一句话说明；details 补充边界和生效方式。

scope 按效果的作用范围划分，不按仓库或作者：只改变单个会话界面与行为的算会话插件（主题、聊天展示、模型下拉、按会话挂载的面板）；提供跨会话能力、注入约束或注册全局工具的算全局插件（网络、搜索与模型提供方、约束注入）。取值缺失或非法时按 global 处理，避免把全局插件误显示成只影响一个对话。完整字段表与判定顺序见 docs/plugin-manager.md。

settings.yaml、home/profile patch 和 AGENTS.md 使用 Git 历史。NAS 设置、情感资料库路径及会话绑定、Rabi Manager 地址不进入共享 settings；目标电脑的 webserver 配置保持本机值。其他机器专用字段可登记在 private-sync.local.yaml。

.credentials.yaml 与 plugins/subscriptions/auth.json 共同加密到 credentials.enc.json，使用 AES-256-GCM 和 scrypt。显式删除的凭据不会从旧文件复活；可选文件只有明确删除记录才会从目标移除。同步密钥、解密后的凭据、资料库及会话数据不得提交。

源码版 DSH 的官方接口依赖在每台电脑上自动绑定到同一份 DSH_SOURCE_ROOT，避免旧 npm 接口与新源码混用。这些官方依赖路径和本机锁文件不进入共享插件清单；共享插件本身保持固定 Git 来源。