DSH 官方提供了 /export 导出功能，但缺乏配套的导入工具。dsh-session-import 插件填补了这一空白，允许将官方导出的 ZIP 或 JSONL 文件还原为可继续对话的会话。
插件简介¶
插件名称为 dsh-session-import，归属于「记忆」类别，由维护者 kinyokun 提供，遵循 MIT 许可证。
核心功能¶
- 文件解析：支持解析
/export导出的 ZIP 或裸 JSONL 文件。 - 校验机制：进行结构真实性验证，并通过 SHA-256 指纹校验文件完整性。
- 状态同步：同步模型、预设、权限等状态。
- 树状支持：支持整棵子会话树、图片与文件附件的导入。
- 实时交互：导入/删除操作通过实时推送免刷新。
安装与启用¶
通过以下命令安装插件：
dsh plugin --profile web add github:kinyokun/dsh-session-import
安装后需重启 dsh web 并刷新浏览器。
典型用法¶
- 在新会话页面点击「导入对话」。
- 选择 ZIP 或 JSONL 文件。
- 查看校验结果、子会话和附件数量。
- 选择目标工作区。
- 点击「开始导入」。
每次导入会生成新的会话 ID，重建包内父子关系，不覆盖原会话。导入成功后，历史消息、系统提示词、模型和其他状态事件均完整保留。
限制与注意¶
该插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 上传大小最多 256 MiB。
- ZIP 解压总量最多 512 MiB。
- 最多支持 256 个会话。
- 最多 4096 个 ZIP 条目。
- 最多 100 万个逻辑事件。
- 不支持分卷、加密 ZIP、ZIP64 或符号链接。
恢复与校验¶
结构校验判断官方运行时能否恢复日志；SHA-256 用于比对文件指纹。恢复区位于存储根目录的同级，例如 ~/.dsh/sessions 对应 ~/.dsh/sessions-import-recovery/。
