前言¶
在做 DSH / 智能体开发时，常见情况是：历史会话已经存在于 claude-code、codex、reasonix、zcode 等工具里，但想在 DSH 中继续同一项目时，需要重新整理上下文。
dsh-plugin-session-import 解决的是这个迁移问题：把上述工具的历史聊天记录导入为 dsh 会话，并带上工作区绑定与工具能力，导入后可以直接续聊。
这是什么¶
dsh-plugin-session-import 是 huguangyu666 维护的 DeepSeek Harness 插件，采用 MIT 许可证。
它面向已有本地会话记录的开发者，将 claude-code / codex / reasonix / zcode 的聊天记录转换为 dsh 可继续使用的会话。
核心功能¶
会话导入¶
- 支持 claude-code、codex、reasonix、zcode 四种工具解析。
- 将历史聊天记录导入为 dsh 会话，包含工作区绑定与工具能力。
- 导入后可以直接续聊。
会话发现与搜索¶
- 会话列表展示标题、项目名、消息数、时间。
- 扫描使用 30s 缓存。
- 按标题 / 项目名过滤搜索，输入为防抖。
批量导入¶
- 支持多选会话一次导入。
- 每个会话独立 seed + 工作区绑定。
工具能力¶
- 导入会话自动加入默认 preset scope。
- 可用 25+ 工具，例如
read/edit/glob/grep/pwsh等，与正常会话一致。
超长会话保护¶
- 按顺序执行：内容裁剪 → 消息截断 → 单条兜底。
DSH_IMPORT_CONTEXT_BUDGET可覆盖预算。
Web UI 与命令¶
- Web UI 侧边栏提供「⇩ 导入会话」按钮，明暗主题自适应。
- 命令行支持：
/import <tool> <path>
文件或目录均可传入，目录表示批量。
安装与启用¶
先检查运行环境：
node >=22.5
插件声明的依赖版本：
@deepseek-ai/dsh >=0.1.0-rc.6
@deepseek-ai/dsh-client-locale >=0.1.0-rc.6
react >=18.0.0
使用官方命令安装：
dsh plugin --profile web add dsh-plugin-session-import
dsh web
第一条命令把插件加入 web profile，第二条命令重启后生效。
也可以使用商店方式：
- 安装
dsh-store。 - 打开「插件商店」搜索安装。
典型用法¶
Web UI 导入¶
- 点击侧边栏底部的「⇩ 导入会话」。
- 选择工具。
- 搜索 / 滚动分批加载。
- 勾选会话。
- 导入。
命令行导入¶
示例：
/import codex C:\Users\xxx\.codex\sessions
传入目录时按批量处理。
适用场景与注意¶
适合已经有 claude-code、codex、reasonix、zcode 本地会话，并且希望在 DSH 中继续后续任务的开发者。
使用前需要注意：
- 图片附件会降级为占位文本，部分工具不支持 image block。
- 超长会话被截断的历史消息不保留，保留摘要与锚点。
- reasonix 桌面版部分会话标题依赖
.titles.json，缺失时回退文件名提取。 - 插件以当前 dsh 进程权限运行。安装前建议检查源码与许可证。
- 许可证为 MIT。
结尾¶
经过上面的步骤，可以把本地工具的历史会话导入 DSH，并在导入后的会话中继续任务。
GitHub 仓库：
https://github.com/huguangyu666/dsh-plugin-session-import
插件线索中的目录页：
https://www.skillhub.cn/plugins/huguangyu666/dsh-plugin-session-import
