设备数据直传（device-sync）

酒馆跨设备 data 直传插件：同一局域网内，把一台设备的酒馆数据（角色卡、聊天、世界书、头像、快速回复、主题等）直传给另一台，谁的文件新用谁的，接收端独有的数据保留，4 位确认码防误传。

许可：GPL-3.0（GNU General Public License v3）

组成

• 仓库根目录（manifest.json + index.js）→ 客户端扩展（界面，扩展设置里操作）
• server-plugin/ → 服务器插件（传输引擎）

安装（酒馆内操作）

界面扩展

酒馆 → 扩展 → 安装扩展 → 输入本仓库 URL（如 https://github.com/<用户名>/st-device-sync）→ 安装。之后在扩展管理里可一键更新。

服务器插件（传输引擎，必需）

电脑和手机两端都要装，把整个仓库 clone 到酒馆的插件目录：

git clone https://github.com/<用户名>/st-device-sync.git "SillyTavern/plugins/device-sync"

（手机 Termux 里对应 ~/SillyTavern/plugins/device-sync/）

然后两端 config.yaml 里开：

enableServerPlugins: true   # 加载服务器插件（默认随启动自动 git pull 更新）
listen: true                # 允许局域网访问（接收端必须开）

重启酒馆，打开扩展设置，找到「设备数据直传」面板。

使用

接收端（要收数据的设备）：面板选「接收端」→ 生成确认码 → 把本机地址和 4 位码告诉发送端。

发送端（有数据的设备）：面板选「发送端」→ 填接收端地址（如 192.168.1.5:8000）和确认码 → 开始传输。进度实时显示。

注意

• 接收端的酒馆要能被局域网访问：config.yaml 里 listen: true，whitelist 加上发送端 IP（或暂时 whitelistMode: false），Windows 防火墙放行 8000 端口入站。
• 若接收端开了登录密码（basicAuth），发送端面板勾选「接收端开了登录密码」并填写。
• 默认不同步 settings.json（含 API key）和 secrets.json（密钥，永不传输）；不同步备份、缩略图、缓存、向量库等垃圾目录。要同步设置可在 plugins/device-sync/settings.json 里把 includeSettingsJson 改成 true。
• 传输期间两端都别聊天（文件可能正在写入）。