前言¶
在 Android 上用 DSHA（DeepSeek Harness Android 端）对话时，「一键备份」会把会话打包到本地。若你改用 dsh-Go 在手机或桌面继续开发、调试智能体，会话格式与工作区并不互通，手工拷贝私有目录或依赖 ADB 拉取既麻烦，也容易碰权限与隐私边界。
dsha-to-dshgo 是 dsh-Go 上的 DSH bundle 插件（维护者 384615666，社区分类：记忆）。它只处理你明确选择的 DSHA v5 一键备份文件，在设备本机完成解析、暂存与写入，把会话迁入 dsh-Go 的独立工作区；正文、工具历史、preset 与时间线保留，迁移后可继续对话。不改 APK、不 Root、不以电脑端工具作为最终产品，备份内的 .credentials.yaml 等敏感项仅做完整性校验，不迁移、不写报告、不打印内容。
这是什么¶
一句话：把 DSHA「一键备份」导出的会话，迁移到 dsh-Go 官方会话持久化路径（A 路径），会话出现在新工作区中，源备份只读，不覆盖目标已有会话 ID，也不修改你已有的工作区。
npm 包名为 dsha-to-dshgo（当前资料中版本 0.1.4）；GitHub 仓库 384615666/dsha-to-dshgo。SkillHub 目录页：dsha-to-dshgo。许可：MIT。
核心功能¶
下面介绍 README 中已实现、并经隔离引擎与真实备份验证的能力（验证基线含 208 项自动化测试；旧代 v0–v3 仅有合成夹具证据，未在真实用户旧数据上验证）。
输入与扫描¶
- 接受 DSHA v5 一键备份（通过 gzip magic 识别，扩展名可为
..gz等）。 - 可从手机
Download/DSHA扫描并流式暂存，支持大文件；也可用系统文件选择器选单个备份。
解析与恢复¶
- 整包校验、白名单暂存。
- 经 dsh-Go 自带历史迁移链（v0–v3 → v4）、父子 catalog 绑定与官方
locate位置校验。 - 最高代不可用、ambiguous 或非 canonical 名会隔离并进入报告，不静默回退旧代。
写入与会话¶
- A 路径：官方
sessionPersistence.create/append/flush/close，全量语义读回，保留源会话 ID。 - 附件：先于会话发布（图片逐字节、文件 verbatim），官方读回后才创建会话；失败或取消时本批新建对象移入 quarantine（不删除），共享对象保留。
安全与重复导入¶
- G6 工作区完整单元快照、批准计划内容门禁、journal 持久化、受保护撤回回滚；用户改名、追加、新增引用保留为 pending；崩溃遗留的实例锁/guard 可在恢复面板经用户确认后解除。
- 相同备份重跑会重新核验目标：一致则显示「已完成」；目标被修改则要求恢复判断，不会静默追加。
原生面板¶
插件在 dsh-Go 中贡献 「DSHA 迁移」 面板（features placement）。典型流程：选择备份或从 Download/DSHA 选择 → 校验进度 → 分页选择会话 → preset/cwd 映射 → 确认计划 → 开始/取消 → 结果与恢复。P0 探针收在「开发工具」里。
发行说明中还提到：B 路径仍是实验入口，未接入统一作业；不要把这个版本当作唯一数据副本使用。
安装与启用¶
官方市场索引可能延迟；若市场暂未出现，资料建议先以 npm 包安装。开发期安装命令如下（来自 README，路径需换成你本机实际目录；仓库内插件目录名为 dsh-dsha-migrator）。
桌面 web profile：
dsh plugin --profile web add /path/to/dsh-dsha-migrator
手机本机引擎（在 App 终端内执行；先把插件文件夹放到手机存储）：
cp -r /sdcard/Download/dsh-dsha-migrator /root/.dsh/dsh-go/plugins/
dsh plugin --profile web add /root/.dsh/dsh-go/plugins/dsh-dsha-migrator
然后在 App 的「引擎」页重启内核。
兼容性（资料原文）：目标引擎 >=0.2.1-rc.4 <0.3.0-0（证据基线 rc.4）；App minApp 1.0.4（1.0.7 实测）。Node >=22.19。
典型用法¶
安装并重启引擎后，在 dsh-Go 功能区打开 DSHA 迁移 面板，按界面步骤操作即可，无需单独 CLI 完成导入（仓库提供 dsh-dsha-inspect 二进制供检查，属开发/诊断用途）。
- 在 DSHA 侧完成 v5 一键备份（文件可落在
Download/DSHA）。 - 在面板中选择该备份，或从
Download/DSHA列表选取。 - 等待校验进度完成，分页勾选要迁移的会话。
- 配置 preset 与 cwd 映射，审阅并确认计划后开始迁移；可随时取消。
- 在结果页查看报告；必要时使用恢复面板处理 pending 或锁；导入成功后可在工作区继续对话。
作业私有数据位于 <DSH_HOME>/dsha-migrator/（journal、冻结计划、内容寻址快照、隔离区），权限为文件 0600、目录 0700。导入成功后会删除私有输入副本与候选暂存；结果页可「删除本任务私有数据」。卸载插件不影响已导入的会话。
适用场景与注意¶
适合谁：已从 DSHA 备份会话、希望在 dsh-Go 同一设备上续聊或接入 DSH 插件生态的开发者；重视「只读备份、本机处理、不上传聊天数据」边界的人。
使用前请知悉：
- 插件以当前 dsh 进程权限运行；安装前应自行查看 源码与 MIT 许可，确认符合你的安全策略。
- 资料写明解析与写入均在设备本机完成，不联网上传聊天数据；敏感配置仅校验、不导出。
- 真机续聊验证在资料中于可用
Glm 5.3 Flash通道通过；导入会话原Flash通道因缺少 DeepSeek API Key 仍未通过——迁移会话本身与通道/API 配置是不同问题。 - DSH 生态理念是「一切皆插件」；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsha-to-dshgo 把 DSHA 一键备份与 dsh-Go 工作区之间的格式鸿沟，收敛为面板内可选备份、可审计划、可回滚的一次迁移作业。需要细节、Issue 与更新时，以 GitHub README 为准：384615666/dsha-to-dshgo；目录索引：SkillHub 插件页。
