企业官网建设流程全解析

Open-Science 数据存放位置怎么选？迁移到副盘与原子迁移完整图解指南

【免费下载链接】open-scienceAIPOCH Open-Science is an open-source, local-first, model-agnostic AI research workbench for macOS, Windows, and Linux, with scientific agents, Python/R notebooks, data connectors, and reproducible provenance.项目地址: https://gitcode.com/GitHub_Trending/open/open-science

Open-Science 是一款开源的本地优先（local-first）AI 科研工作台，支持 macOS、Windows 与 Linux。你的笔记本、文献库、数据文件和运行产物都保存在本地磁盘上——那么Open-Science 数据存放位置该怎么选？什么时候该把数据迁移到副盘？本文用图解方式带你完整搞懂它的两级存储结构、4 条选盘标准，以及一键"变更位置"背后的原子迁移机制，全程不丢数据。

先搞懂：Open-Science 把数据放在哪里？

很多新手的第一困惑是：这个 App 到底在我电脑上写了哪些东西？答案是——它把存储分成两个根目录，而且职责完全不同。

配置根目录（Config Root）：永远不动

数据库、会话记录、模型配置、技能（skills）等放在一个固定的配置目录里，设计上不可迁移（相关逻辑见 storage-root.ts）。这样做的理由是：密钥环（keychain）等系统组件绑定了这个位置，强行搬走会触发系统级的危险弹窗。

数据根目录（Data Root）：可以随你走

真正占空间的大文件都在数据根目录，默认位于用户主目录下的OpenScience文件夹（开发版为OpenScience-DEV）。其中可迁移的子目录包括：

完整清单定义在 />

操作步骤：

1. 打开设置 → 存储，点击"Change location"；
2. 选择新位置的父目录（应用会自动在其下创建OpenScience子文件夹）；
3. 应用对目标做智能分类，决定按钮含义（见 StoragePanel.tsx 的注释）：
   • 空目录 →Change location（执行完整迁移）
   • 已含 Open-Science 数据 →Use this folder（只切换指针，不移动文件）
4. 若检测到正在运行的会话，会先提示你确认中断并重启（StorageMigrationModal.tsx）；
5. 确认后即可等待迁移完成、自动重启生效。

原子迁移四阶段：扫描 → 复制 → 校验 → 清理

迁移引擎（data-migration.ts）把每次搬家做成"原子操作"，进度条上的文字与这四个阶段一一对应：

1. 扫描（Scanning）：递归清点源目录，统计文件数与字节数；
2. 复制（Copying）：同卷时优先用硬链接瞬时完成；跨盘则流式复制，符号链接（conda 缓存依赖它）会被忠实重建而非解引用；
3. 校验（Verifying）：逐文件核对内容，并记录权限与时间戳等元数据以便恢复；
4. 清理（Cleaning up）：全部校验通过后才删除源文件——任何一步失败，源数据都原封不动。

中断了怎么办？迁移标记自动兜底

复制进行中新目录下会写入一个哨兵文件.open-science-migration.json（实现见 migration-marker.ts），记录源路径、目标路径、状态（copying/verified）与文件清单摘要。它的作用：

• 迁移中途断电/退出 → 下次启动时应用识别出这是一份"未提交的暂存副本"，提供恢复或丢弃两个明确选项；
• 丢弃（discard）会删除整份未提交的副本，源数据毫发无损——这就是"原子性"的含义：迁移要么完整生效，要么完整回滚，不存在半成品。

常见问题速答

Q：我手动把文件夹复制/剪切到副盘行不行？不建议。手动操作会错过迁移标记、指针更新、runtime重建和路径归一化等步骤，容易出现"数据文件夹找不到"或新旧位置数据分裂。请始终走设置页的变更位置流程。

Q：迁移后runtime环境会重新下载吗？环境包不会整体丢失，但 conda/venv 环境因含绝对路径会在需要时按需重建，首次在新位置运行笔记本可能稍慢，属正常现象。

Q：可以一键回到默认位置吗？可以。设置页支持"Use default location"，把数据根目录切回~/OpenScience，同样走上面的迁移流程（见 contenteditable="false">【免费下载链接】open-scienceAIPOCH Open-Science is an open-source, local-first, model-agnostic AI research workbench for macOS, Windows, and Linux, with scientific agents, Python/R notebooks, data connectors, and reproducible provenance.项目地址: https://gitcode.com/GitHub_Trending/open/open-science