PI-Desktop 评测 会话文件与存储迁移
十一项本地检查验证 PI-Desktop 的文件迁移、锁文件排除、符号链接与失败保留,区分文件复制成功与完整桌面会话恢复。
AgentIndex · 发布于 2026-11-05 · 更新于 2026-11-05
PI-Desktop 把编程智能体的项目、持久会话、模型和插件放到独立桌面工作区。它的选型价值在于连续性:应用重启、更换模型或者迁移存储位置后,项目记录是否仍然可以理解和使用?功能清单能说明产品方向,却不能直接回答这些问题。
本篇验证其中一层:把资料和会话文件复制到新目录。选定实现会保留原文件,按范围排除浏览器安装锁,调整部分符号链接,并在核验阶段拒绝源文件变化。这些是本地工作区有用的文件层行为;数据库迁移和应用重启后的会话恢复仍需要单独验收。
固定版本与测试边界
2026 年 11 月 5 日,我们固定提交 836ccd084147bedf916e56c859c1529ae63d2ac6。根包版本为 0.21.0,README 将 0.21.x 定位为 Early Preview。项目由 Electron、Rust host core 和 pi agent harness 组合而成,仓库采用 LGPL-3.0。项目说明
十一项具名检查在 macOS arm64、Node.js 26.6.0 下运行,使用临时目录与人工会话文件,直接加载真实存储和偏好模块。Electron 的 original-fs 导入映射为 Node 的物理文件系统接口;Rust 路径迁移回调则替换为记录调用或故意失败的函数。复现脚本、源码指纹与结果
本次没有打开 Electron 窗口、真实资料目录、SQLite 迁移或模型会话。Windows junction、打包后的 .asar 行为和进程中断恢复都没有实测。完整源码构建需要 Node、pnpm 与 Rust,选定模块测试不代替整个应用的构建和运行。
| 场景 | 本次观察 |
|---|---|
| 目标目录位于源目录内 | 在创建目标前拒绝 |
| 目标包含无关文件 | 拒绝,原文件保留 |
| 符号链接目标、经链接父目录与源重叠 | 拒绝 |
| 人工会话复制 | 新旧内容一致,原件仍在 |
| 浏览器根目录的安装锁 | 不复制 |
| 数据目录及浏览器子目录中的用户 lockfile | 保留 |
| 内部绝对链接、外部相对链接 | 调整后保持选定目标关系 |
| 核验开始时修改源文件 | 拒绝迁移 |
| 注入路径改写失败 | 错误向外传递,原会话保留 |
| 偏好文件损坏 | 报错,没有静默重置 |
先确认目录真正分离
目标校验会规范化路径,并与数据根目录、浏览器根目录和安装锚点比较。测试中的内部目标在创建前被拒绝;通过符号链接父目录指向源数据的路径也被拒绝。不同的路径文字可能对应同一棵目录树,因此这一步比单纯比较字符串更贴合迁移需求。目录校验与迁移实现
包含无关文件的目录不会被当成空目标使用,测试文件得到保留。首次安装、数据根尚不存在时,选定函数能创建新数据目录,而且不会调用路径迁移回调。这些覆盖了部分边界;权限突变、网络盘和真实空间不足没有纳入实测。
源码把迁移定义为冷复制,要求数据库、浏览器、插件和日志写入者先停止。这决定了操作应安排在怎样的生命周期阶段。复制一个仍在写入的资料目录,再期待最终核验通过,并不能代替对写入者的协调。
复制核验与数据库改写分开看
人工 JSONL 会话复制后与原件逐字节一致,原件继续可读;进度到达 complete,记录回调收到了旧、新数据根目录。实现会在复制时计算哈希,并在进入路径改写前检查源和目标。
随后,我们在核验阶段开始时修改源会话,迁移被拒绝。另一项测试让回调主动抛错,错误向外传递,而原会话仍保留。这说明选定失败边界具备可观察行为,没有证明完整恢复事务。失败目标可能留下部分文件,本次也未测试崩溃后重新打开应用。
记录回调不会真正改写数据库中的路径。因此,文件复制通过,不能据此认定 Rust host 能打开迁移后的数据库、恢复会话或找到全部附件。真正采用时,在删除旧存储前,应重新打开应用,检查代表性会话与附件,并确认当前生效的是目标目录。只看进度完成容易把不同层次的成功混在一起。
锁文件与符号链接影响可迁移性
浏览器根目录的 lockfile 和 SingletonLock 被排除;数据根目录中的用户 lockfile,以及浏览器子目录里的同名文件仍然保留。排除范围与安装元数据有关,不能简单扩展为“所有叫 lockfile 的文件都可删除”,因为用户项目也可能需要它。
指向源目录内部会话的绝对符号链接被调整到新会话位置;指向外部人工文件的相对链接,迁移后仍能解析到同一个外部文件。外部内容没有自动复制进新目录。这意味着移动资料目录不一定得到一份自包含归档,备份和跨盘搬运时仍可能依赖原有外部路径。
本次系统是 macOS,不能由此推导 Windows junction、网络共享或 Electron 打包文件系统行为。计划在哪个平台部署,就应在哪个平台检验实际安装包与路径组合,尤其是已有资料包含链接时。
偏好状态不应悄悄切换
偏好文件不存在时,读取器返回默认根目录和空备份列表。包含新根、旧备份根和待处理迁移的合法偏好,经真实写入器与读取器往返后保持一致;非法 JSON 和相对根路径会被拒绝。偏好实现
拒绝损坏状态能够让问题显现,避免用户误以为切换后的空目录就是原工作区;同时也要求运维保留可恢复的偏好和最后可用位置。本次正常写入与读取没有注入断电、磁盘故障,不能当成这些情况下原子性的证明。
选型建议
如果需要独立桌面界面、跨项目持久会话和可替换模型提供方,并能接受预览版本,PI-Desktop 值得用测试工程试用。它的插件能扩展工具、面板与后台服务,插件兼容性和访问范围需要另外评估。本地优先说明工作区状态的存放方式;选择云模型时,请求仍交给对应提供方。
采用前建议在目标系统上完成一次持久化检查、附件打开和完整的迁移重启过程。本篇支持的是选定文件层行为,没有对模型质量评分,也没有验证插件隔离。如果需求主要发生在安卓手机上,可看 dsh-Go 加密分享评测;关注文件形式的跨会话交接,可看 Crew 记忆评测。