DSH-Portable 的会话、设置、插件和默认工作区都保存在便携目录中。完整退出后复制目录,就能在另一块硬盘、U 盘或相同平台的电脑上继续使用。
- 在托盘菜单选择 退出 DeepSeek Harness。
- 等待窗口和托盘图标消失。Windows 用户还应等到文件夹可以正常重命名;不要在程序仍运行时强制复制或删除。
- 将整个
DSH-Portable文件夹复制到相同平台的新位置。 - 在相同平台的新位置运行
DeepSeek-Herness.exe。macOS 运行应用包;Linux AppImage 用户同时复制旁边的DSH-Portable-data目录。 - 打开一个已有会话,再检查常用插件和默认工作区。Portable 会修正它管理的旧路径;你主动打开的外部项目仍保留原位置。
完整目录复制只适用于相同操作系统和 CPU 架构;更换操作系统或架构时,请下载对应目标包,再用数据归档迁移会话、设置和插件配置。原生插件依赖需在目标平台重建,外部 workspace 需自行搬迁或重新连接;跨操作系统恢复尚未通过成品验收。
不要让两台电脑同时运行同一个同步目录。会话正在写入时由网盘或同步工具合并同一份数据,可能产生冲突。
已发布的 0.6.4 入口为「设置 → 通用设置 → 便携版」;下文使用开发版的新入口。
不想复制完整运行环境时,打开 设置 → Portable → 数据与迁移:
- 导出迁移包:便于在你信任的设备之间迁移。
- 导出加密私密包:内容相同,但需要密码才能读取,更适合云盘或移动介质。
两种包都包含会话、设置、插件配置和 API 凭据;都不包含运行时、缓存、日志或工作区文件。未加密迁移包属于敏感数据,不要公开分享。它仍是带完整性校验的压缩容器,并不是文本文件;请通过导入确认界面或 dsh portable inspect 查看摘要。
通过设置界面导入到已有环境时,确认页会说明冲突文件将被数据包替换;选择「重启并导入」前请核对内容。Portable 会在 data/backups/ 创建回滚副本。命令行恢复默认只补入缺失数据,覆盖需要明确指定。导入只有在插件依赖恢复并且每个 Profile 都能组合后才会提交;依赖下载或验证失败会自动恢复导入前的数据。注册表插件首次迁入新电脑时可能需要联网。
- 新建一个测试会话,并确认一个插件处于启用状态。
- 从托盘完全退出。
- 把整个文件夹移动或重命名,例如从
Downloads移到Documents。 - 从新位置重新打开,确认测试会话、插件和设置仍然存在。
这个检查只验证 Portable 管理的数据。你在其他位置打开的代码仓库、图片或文档不会被复制进便携目录。
- Windows 移动盘优先使用 NTFS,避免文件权限、长路径和单文件大小限制。
- 更新或修复正在进行时不要移动目录。
- 如果 Windows 提示文件仍被占用,重新打开 DSH-Portable,运行 设置 → Portable → 运行检查,再从托盘完全退出。
- 遇到无法解决的问题,可在同一页面导出脱敏支持报告并提交 Bug。不要附带 API Key、未加密迁移包或私人会话。