主题
升级与数据迁移
产品怎么更新、您的数据都在哪、换电脑怎么搬——一次说清。
自动更新：它自己搞定
产品内置自动更新，您基本不用管：
| 特性 | 说明 |
|---|---|
| 自动检查 | 启动时查最新版本 |
| 增量下载 | 只下变化的部分（差分下载）——几百 MB 的更新常只下几十 MB |
| 断点续传 | 下载中断了，接着上次的继续 |
| 完整性校验 | 安装包带哈希校验——下坏了不会装 |
| 更新永不中断会话 | 有任务在跑？等它收尾再装——绝不强杀进行中的任务（产品级承诺） |
有新版本时的表现：通知提醒 → 您方便时点更新 → 下载（后台）→ 装好下次启动生效。强制更新（极少用，只在旧版本有致命问题时）也会等当前任务收尾。
更新会动我什么吗
| 东西 | 会被影响吗 |
|---|---|
项目文件（代码、ai-docs/ 文档） | ❌ 不动——在您的项目文件夹里 |
| 会话记录 | ❌ 不动——本机数据库 |
| 您的配置（Key、智能体、技能、MCP） | ❌ 不动——用户配置随版本保留 |
| 产品自身 | ✅ 更新的是它自己 |
结论：更新是「换工具」，不碰您的工件。
您的数据都在哪
| 数据 | 位置 | 随什么走 |
|---|---|---|
| 项目全部（代码 + 文档） | 项目文件夹 | 您自己管理（Git / 拷贝） |
| 会话记录 | 产品数据目录（本机） | 数据目录迁移（见下） |
| 配置（Key / 智能体 / MCP） | 用户配置目录（本机） | 同一数据体系 |
日常备份：项目文件夹进 Git（见提交与推送代码）就是最好的备份——代码与文档都在仓库里。
换电脑 / 数据迁移
text
新电脑装好产品 → 项目文件夹拷过来（或 git clone）→ 打开项目 → 继续干- 项目相关的（代码、文档、项目级智能体）随项目文件夹走
- 个人配置（Key、用户级智能体、技能）在新电脑的设置里配一次
- 会话记录属旧机器本地——重要结论让它落成项目文档（
ai-docs/），文档随项目走、永续可用
养成习惯
重要结论与决定都在项目文档里留痕（见项目文档机制）——这比依赖会话记录可靠：文档随 Git 走到任何机器。
常见卡点
| 现象 | 怎么办 |
|---|---|
| 不想现在更新 | 忽略提醒即可；但别拖过强制线（太旧的版本会被要求升级后才继续服务） |
| 更新下载慢 | 后台下载不打扰干活；断网了下次续传 |
| 更新后界面变了 | 大版本的界面调整——功能都在，看更新说明；具体不会用问对话「××功能在哪」 |
| 想回退到旧版本 | 自动更新只向前；确需旧版从官网下载页找历史安装包（数据不受影响） |
| 数据目录能搬家吗 | 高级操作——设置 → 存储里有数据目录管理（一般无需动） |