前言¶
DeepSeek Harness（dsh）会在本机 ~/.dsh/sessions 下以 Zstandard 压缩的 JSONL 保存对话（session.v4.jsonl.zstd）。换机器、拷贝备份目录或重装后，你希望这些记录重新出现在侧边栏并能续聊，而不是只留在磁盘里。
社区里常见的 dsh-plugin-session-import 面向 claude-code、codex、reasonix、zcode 等外部工具导出，并不识别 dsh 自己的 v4 日志。dsh-session-import-native（维护者 Felix-fyz，分类：记忆）专门处理 dsh 原生格式，从任意文件夹把日志导入当前 profile。
这是什么¶
dsh-session-import-native 是 dsh 插件：读取 dsh 自己保存的会话日志（session.v4.jsonl.zstd），导入后按原工作区挂到侧边栏，可立即点开继续对话。Web UI 为中文；Host API 与 /dsh-import 命令与界面语言无关。
- 仓库：Felix-fyz/dsh-session-import-native
- 目录页：SkillHub 插件页
- 许可证：MIT（见仓库 README）
- 当前 package 版本：0.1.0（见
package.json）
核心功能¶
下面行为均来自官方 README 说明。
导入范围与格式
- 仅支持 v4 日志（当前 dsh 写出的
session.v4.jsonl.zstd）。 - 来源可以是默认目录
~/.dsh/sessions，也可以是桌面上的sessions、sessions11、sessions - 副本等备份路径，或单条日志的完整文件路径。
导入后会保留什么
- 用户/助手消息、思考、工具调用与结果、标题、轮次结构。
- 会话编号：每条记录生成新的
session-<uuid>，不覆盖已有会话；同一份日志可重复导入。
工作区与侧边栏
- 若日志里记录的
cwd在磁盘上仍存在，则导入到该工作区；否则落到默认工作区目录并自动挂到侧边栏。
会丢弃或降级的内容
- 其他插件/版本的运行时事件（job、投递回执、重试标记、审批卡片、检索请求等），避免旧版本词汇导致回放失败。
- 图片与文件依赖另一份配置里的附件 ID，导入时变为
[图片]/[附件：名称]占位文本。
去重提示
- 导入台账写在
~/.dsh/session-import-native/imported.json；列表里对已导入项显示「已导入」徽标，仍可再次导入。
安装与启用¶
插件以 bundle 形式装进当前 profile，安装后由 HMR 生效；若改动过 Host 侧代码，需在插件管理里关闭再打开该插件。
从本地已有源码目录安装时，在 dsh 可用的环境中执行（路径换成你的绝对路径）：
plugin_manager install_bundle <绝对路径>\dsh-session-import-native
若目录来自 GitHub 仓库的本地副本，同样对上述克隆目录使用 install_bundle：
plugin_manager install_bundle <克隆目录的绝对路径>
安装前应自行查看仓库源码与 MIT 许可证。插件在 当前 dsh 进程的权限 下运行，导入时会读取你指定的 sessions 目录并写入 profile 与会话数据，请只导入你信任的路径。
典型用法¶
侧边栏
- 侧边栏底部点「⇩ 导入 DeepSeek 对话」。
- 选择 sessions 目录（默认可选
~/.dsh/sessions；常见备份名会自动列为快捷位置）。 - 勾选要恢复的会话后导入。
- 也可在对话框里直接输入某一条
session.v4.jsonl.zstd的完整路径。
命令
在支持 /dsh-import 的对话里，可指定目录或单文件（示例路径来自 README，按你的环境替换）：
/dsh-import C:\Users\me\Desktop\sessions
/dsh-import C:\Users\me\Desktop\sessions\--C-...--\session-xxxx\session.v4.jsonl.zstd
经过上面的步骤，导入的会话会出现在侧边栏对应工作区下，结构与当前 dsh 会话一致，可直接续聊。
适用场景与注意¶
适合谁
- 需要在同一 profile 内恢复本机或备份里的 dsh v4 会话，而不是导入 Claude Code 等外部工具记录的用户。
- 多工作区使用者：依赖日志中的
cwd还原侧边栏分组；目录已删除时会落到默认工作区。
与同类插件的区别
dsh-plugin-session-import：外部 IDE/助手导出，不识别 dsh 原生session.v4.jsonl.zstd。- 本插件：只处理 dsh 自己在
~/.dsh/sessions体系下写出的多帧 Zstandard JSONL 文件。
使用注意
- 附件无法按原 ID 还原，续聊时看到的是占位文本。
- 旧版本运行时事件会被过滤，回放行为以当前 dsh 为准。
- 开发改 Host 需在插件管理里重开插件；改 Client 需刷新页面（本地
pnpm run dev:web时 HMR 可自动重载）。
结尾¶
若你的目标是「把 dsh 自己备份的 session.v4.jsonl.zstd 拉回当前环境并续聊」，而不是迁移其他产品的对话记录，dsh-session-import-native 对得上这个需求。安装与行为以仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/Felix-fyz/dsh-session-import-native
- GitHub：https://github.com/Felix-fyz/dsh-session-import-native
DSH 社区插件目录由 SkillHub 等站点汇总，与 DeepSeek / 幻方无官方从属关系；选用插件时请自行审阅源码与权限影响。
