配置自己的存储

配置文件位于当前 DSH_HOME 下的 dsh-sync.json；未设置 DSH_HOME 时为用户目录下的 .dsh/dsh-sync.json。它只留在本机，不进入同步快照。请在本机编辑，勿将真实配置提交到公开源码仓库或贴入聊天。

私有 HTTPS Git

新建仅自己／授权协作者可访问的私有数据仓库，使用独立同步分支。下面仅是不可连接的占位示例，请替换仓库和账号：

{
  "backend": "gitee",
  "repoUrl": "https://git.example.invalid/your-account/private-sync.git",
  "branch": "dsh-sync",
  "username": "your-account",
  "token": "",
  "privateRepoConfirmed": false,
  "profiles": ["desktop"],
  "includeAttachments": true,
  "maxExtraBytes": 209715200,
  "extras": []
}

gitee 是保留的 Git 后端配置名，界面也沿用 Gitee 标签。Git 传输使用 HTTPS 用户名／令牌认证；不同提供商的兼容性和权限要求需自行验证。

令牌可只设置在本机环境变量 DSH_SYNC_TOKEN，或写入本机配置的 token 字段。使用最小必要仓库权限，不把凭据嵌入 URL。亲自确认数据仓库为私有后才将 privateRepoConfirmed 改为 true；这是本机确认声明，插件不会自动查询或更改远端可见性。

不得将本项目的公开源码仓库作为个人同步目标。 插件会拒绝此目标。切换仓库、分支或账号会隔离 Git 工作副本；更换旧设备配置后建议先下载核对，不强制推送覆盖远端。

自己的 SFTP 服务器

不提供托管服务器、共享账号、预置主机公钥或私钥。每台设备自行生成／保管密钥，并由服务器管理员授权设备公钥。在本机配置：

backend：sftp。
sftp.host：自己的服务器域名或地址；port：SSH 端口。
sftp.username：自己获授权的服务器用户。
sftp.remoteRoot：安全的 /data/ 子目录，例如 /data/my-sync；须按服务器 SFTP 可见路径配置。
sftp.privateKeyPath：本机私钥绝对路径，私钥不经过网页、不进入同步。
sftp.hostKey：通过可信独立渠道核对的完整 ssh-ed25519 服务器公钥。不要关闭主机身份校验，也不要盲目信任首次网络扫描结果。

密钥需可用于非交互式 OpenSSH 认证。账户、密钥和目录访问权限由使用者管理。Git 和 SFTP 备份相互独立；切换存储不会搬运或删除旧备份。面板保存存储选择不会自动传输。

日常使用

源设备上传

先检查状态与同步范围。工程／额外文件须手动添加自定义映射，例如逻辑名 my-project。
可执行本地预演：它会扫描并暂存本机数据；已配置 Git 时还可能创建本地提交，不是只读检查，但不推送或访问远端。
明确确认后上传。仅当显示远端回读／哈希核验成功时，才视为备份成功。超时后可能显示待确认，不自动重复推送。
同一时刻只在一台设备编辑。不是实时双向同步，也不自动合并两台设备的分叉历史。

目标设备下载与恢复

安装兼容版本插件，并配置自己的仓库凭据或 SFTP 授权。各设备按相同逻辑名映射工程，本机目标路径可以不同。
默认在线模式只应用宿主允许的安全范围：冷历史通过原生接口导入；已加载、分叉、格式不支持的会话及忙碌工程保留，运行时配置等推迟应用。查看未应用项，不能将部分应用当成全量成功。
仅下载／离线恢复只产生暂存计划，不覆盖现有会话或工程。检查结果后完全退出 DSH，再运行该结果给出的恢复命令。需可运行 Node.js 24+；不要在另一台机器复用生成的本机恢复脚本。
恢复核对源哈希及下载时的目标基线，覆盖前验证备份；冲突时停止，不自动改权限。内容相同的只读附件保持原样。失败计划不可重跑，先检查日志并重新下载。
恢复中失败会尝试回滚，仍可能出现需人工处理的不完整回滚。请保留日志和备份；本插件不替代独立备份。

离线计划会记录本次宿主端口并检测监听，但仍须自行确认所有相关 DSH 进程已退出。不提供自动关机、自动关闭 DSH、配套桌面宿主补丁或一键授权新设备的功能。

下载尚未完整应用时会阻止后续上传，避免用旧本机快照覆盖远端。不要轻易勾选覆盖未应用远端内容；只有核对并明确接受丢弃风险后才能使用此选项。

跨设备插件升级

快照可携带已安装插件的精确版本、支持的本地安装包和升级说明。目标设备下载后仅检测差异；用户选中具体插件并再次确认后才交给宿主插件管理器安装。模型调用另需本次插件管理授权。

不自动批准依赖构建脚本，不自动降级，不自动重启。远端说明及本地插件包都属于不受信任输入，请先核对来源；安装插件意味着允许代码在宿主环境执行。若返回待重启，由使用者手动重启。安装后重新下载恢复计划，以免使用安装前的旧基线。

dsh-sync

同名パッケージの別リポジトリ

インストール

ドキュメント