企业官网建设流程全解析

本文是一份 FyAgent 配置备份与跨设备同步的实战指南。FyAgent 是你的"随身数字人格"：把模型、AI 账号、技能、提示词和工作方式统一管理，带到每一个 AI 工具里。配置攒得越多，越不想在一台新电脑或一次重装后从零开始。FyAgent 提供两条互补的路线：WebDAV/S3 云同步（改动自动上传，换设备一键拉取）和配置包（手动导出为文本，跨设备、跨网络一键迁移）。两者都不需要你会写代码。

一、先搞清楚：FyAgent 帮你备份了什么

FyAgent 的个人配置默认保存在本机的~/.fyagent/目录下（见 docs/user-manual/zh/installation.md）。云同步同步的就是这些数据快照，主要包括：

换句话说：你花时间调好的"工作方式"会被完整带走，日常跑出来的日志不会拖累同步。同步的核心逻辑在 src-tauri/src/services/webdav_sync.rs，它把数据库快照与技能包打成带校验和的清单（manifest），先传数据、最后传清单，保证恢复时不会拿到"半份"数据。

二、WebDAV 自动同步设置：3 步完成跨设备同步

WebDAV 是最通用的选择——NAS（群晖、威联通）、阿里云盘 WebDAV、Nextcloud 等都支持。

第 1 步：填写连接信息。打开同步设置面板，填入：

• 服务器地址（base_url）：如https://nas.example.com:5006
• 用户名 / 密码：WebDAV 专用账号即可
• 远端根目录：默认fyagent-sync，多设备共享同一目录
• Profile 名称：默认default，同一网盘存多套配置时可区分

第 2 步：测试连接。点击连接测试，FyAgent 会验证认证并自动创建远端目录结构，无需手动建文件夹。

第 3 步：开启自动同步。打开enabled与auto_sync两个开关后，此后每次修改 Provider、模型、提示词、技能或 MCP 配置，后台都会防抖式地自动上传，状态栏实时显示success/error。自动同步由 src-tauri/src/services/webdav_auto_sync.rs 驱动，且带大文件保护机制。

配置字段定义在 src-tauri/src/settings.rs 中的WebDavSyncSettings，密码等敏感项保存在本地，不会随同步包二次暴露。

💡换设备的标准动作：新机器安装 FyAgent → 填入同样的 WebDAV 地址与账号 → 点击「下载」。你的模型、账号、技能、提示词几分钟内全部就位。

三、S3 兼容云同步：R2、OSS、COS 一键预设

如果你习惯对象存储，FyAgent 的 S3 兼容云同步是更省事的选择。设置项比 WebDAV 略多：region、bucket、accessKeyId、secretAccessKey、endpoint（自定义端点时可填），字段定义见 src-tauri/src/settings.rs 中的S3SyncSettings。

它内置了一键预设，选中即自动填好 region 与 endpoint：

• AWS S3
• MinIO（自建）
• Cloudflare R2（免流量费，适合个人）
• 阿里云 OSS
• 腾讯云 COS
• 华为云 OBS

签名采用标准 AWS Signature V4 手写实现，因此任何 S3 兼容服务都能接入，无需额外 SDK。

两个使用要点：

1. 互斥原则：开启 S3 同步会自动停用 WebDAV 同步，反之亦然，避免两个远端互相覆盖。
2. 手动兜底：除了自动同步，你随时可以手动「上传」/「下载」，相当于一次显式备份或恢复。

四、配置包一键迁移：导出成文本，粘贴即可还原

云同步解决"同一账号跨设备"，而**配置包（Config Pack）**解决"跨环境迁移"：新公司电脑不能连家里 NAS、或者想分享给同事，都靠它。

导出（源设备）：在模型管理页点击「导入 / 导出连接」（入口见 src/shared/features/config-pack-ui/ConfigPackDialog.tsx），选择要携带的 Provider 条目（包含应用、名称、服务地址、模型、接口类型），生成一段可复制的文本。

导入（目标设备）：粘贴文本后，FyAgent 会先给出导入预览，逐条冲突检测，你可以为每条选择：

确认后一键写入，无需重启。导入服务在 src-tauri/src/services/config_pack/mod.rs，前端交互在 src/shared/features/config-pack-ui/。

⚠️ 配置包文本中可能包含 API Key，请通过私密渠道传递，不要发群或贴公开论坛。

五、别忽略这两层"本地保险"

1. 每次保存前的本地备份。FyAgent 在写入配置前会保留上一次修改前的文件副本（如models.json.backup），并弹出「确认配置更改」让你核对将修改的文件与备份位置，随时可以「撤回文件修改」。

2. 技能备份。卸载技能只是从管理列表移除，备份会保留在~/.fyagent/skill-backups/，随时可在「更多 → 备份恢复」中找回；技能目录默认为~/.fyagent/skills/。详见 docs/user-manual/zh/skills.md。

六、常见问题速查

Q：自动同步太频繁？会冲突吗？A：自动同步只对配置类改动触发，且内部有互斥锁串行化所有同步操作；上传采用"先数据后清单"顺序，另一端下载前会校验 manifest 版本，不会应用不兼容或残缺的快照。

Q：云同步安全吗？A：敏感数据在本地加密存储；FyAgent 对同步通道有明确的安全边界——远端恢复数据被视为不可信输入，导入数据库备份时启用了严格的 SQLite 授权白名单（fail-closed），防止异常备份文件产生越权写入。威胁模型见 SECURITY.md。

Q：WebDAV 和 S3 能同时用吗？A：不能，二者互斥：启用一方会自动停用另一方。日常选一个即可，配置包可作离线补充。

Q：同步失败怎么排查？A：设置面板会显示lastError与失败来源（手动/自动）；先点「测试连接」确认网络与账号，再手动上传一次验证写权限。

写在最后

给 FyAgent 做配置备份的顺序建议：先开自动同步（WebDAV 或 S3 二选一）→ 再导出一份配置包存在本地 → 每月手动下载一次远端快照。三层保险齐了，换电脑、重装、甚至换网盘，你的数字人格都能在几分钟内完整复活。

更多路径与目录说明，可参考 docs/user-manual/zh/troubleshooting.md 中的本地数据位置一览表。