# 迁移到 DSH Desktop App

DSH Desktop 复用 Web 客户端，但页面位于 `dsh-app://app/`；原浏览器页面的 `localStorage` 和 IndexedDB 不会自动出现在 App。Desktop 插件安装、启用状态也属于独立的 `$DSH_HOME/profiles/desktop`。不要把 Web 中显示的证据或插件状态视为 App 已具备。

## 操作

1. 在仍能访问旧数据的 DSH Web 会话中安装本版 Research Kit，打开「科研工作台」→「迁移到 App」→「导出本端完整迁移包」。迁移包包含全部课题的证据、论断、关联、账本、课题设置、知识节点／关系、灵感资产和最近研究运行，不受当前筛选条件限制。导出前会强制拉取文件侧证据；文件侧不可读取时拒绝生成可能不完整的迁移包。备份不会为了导出而反向回写文件侧，避免既有同源判定阻断备份。
2. 在 DSH Desktop 的 Plugins 页安装并启用同版 Research Kit。打开「科研工作台」→「迁移到 App」，选择 Web 导出的 JSON。界面先验证 SHA-256 完整性与各部分格式，再展示各类记录的总数、预计新增数和本端已有数；选文件和预览阶段不写入。
3. 点击「先下载本端备份」，确认浏览器下载目录里确有该文件，再点击「确认增量导入」。导入按稳定 ID 补缺，不覆盖本端已有证据、人工结论、知识状态或资产；文件侧证据会在末尾同步。如果文件侧已有同源来源，只计数并提示，不覆盖原记录。完成后刷新并逐类核对数量、来源、关联和 Agent 历史。

迁移文件包含笔记、研究资产及有界来源摘录。只放在你控制的本地位置，不要公开分享。导入中断不会清空已有数据；再次选择同一文件、预览和导入会跳过已有 ID。灵感资产经宿主公开 `save` 接口恢复，稳定 ID 与内容保留，但创建／使用时间可能以本端写入时刻重记；原备份仍保留源端完整记录。研究运行合并后若超过 500 条会在写入前拒绝，避免静默截断；以导出的迁移包为长期备份。

迁移包解决跨页面源的搬运，不是自动云同步；当前灵感资产、知识库和运行元数据仍由 App 页面本地存储管理。重要资料要定期导出迁移包。后续将它们改成 Host 侧单一真源时，应另做版本化、冲突检测和逐项验收，不能仅复制浏览器存储键。

## 升级门禁

对本地 DSH 源码运行 `npm run check:dsh-app -- /path/to/deepseek-harness`。它检查 Research Kit 的版本声明、输入框、工具卡阶段、Claim Agent／发布路由和 Desktop 自定义协议转发的静态契约；通过不等于实际安装成功。Desktop profile 已安装本地链接时，源码与构建产物更新后仍须刷新 App 插件／页面，不能把旧的已加载实例当作新版验收。每次升级还需按 [手工验收清单](MANUAL-QA.md) 的 Desktop 项执行 Claim 初审与发布门禁、窄窗口、暗色、工具卡与迁移往返验证。不要用插件管理器的版本豁免代替适配。

2026-09-26 已在已安装的 DSH Desktop App 上完成入口、导出与导入预览的真实交互验收：本端 192 条证据导出后通过完整性校验，回选时显示预计新增 0 条。尚未在真实 App 中点击最终导入，因为该动作会写入当前用户的生产证据库；隔离浏览器回归已覆盖实际写入与重复导入。真实 App 的跨 Web 迁移、窄窗口、暗色和工具卡仍需完整验收。