Nwflower/dsh-chat-import

DSH Chat Import

一个插件，13 种来源 —— 全保真导入 DeepSeek Harness，无缝续聊，并可导出 / 同步回 Claude Code。

反向方向同样覆盖：export_claude 把 DSH 会话序列化回 Claude Code JSONL（只读——绝不修改你的 DSH 日志），Claude Code 可用 --resume 加载续聊；sync_to_claude 再把会话新增轮次增量写回 Claude Code 文件——带守卫、绝不静默覆盖。

✨ 功能特性

📥 导入

• 13 种来源，一个插件 — 每种来源一条命令，从 Claude Code JSONL、Codex rollout 到 SQLite 数据库与会话目录。
• 🔍 全保真 — 工具调用与结果、思考块、标题、模型与时间戳，源有记录就原样保留。
• 📦 批量导入 — 指向一个目录（或整个数据库），每个文件 / 每段对话都成为独立会话，并返回逐文件汇总。

▶️ 续聊

• 可无缝续聊 — 打开导入的会话，从源记录停下的地方继续对话。
• 🗂 自动归组工作区 — 会话按源 cwd 挂进对应工作区（本机无此路径时回退到源文件所在目录）——不再「未分组」。

🔄 反向

• 📤 导出回 Claude Code — export_claude 把任意 DSH 会话（导入的或原生的）写到 <outputDir>/<slug>/<uuid>.jsonl，可直接 --resume。
• 🔄 反向同步 — sync_to_claude 把会话新增完整轮次追加回 Claude Code 文件——带守卫、绝不覆盖。

🛡️ 保护

• 🔁 幂等 + 增量 — 重复导入未变化的源直接跳过；增长的源只追加新增轮次。
• 🧮 上下文预算保护 — 超长会话按安全上下文预算裁剪，裁剪结果显式上报。

🗂 支持的来源

来源	存储位置	导入工具
Claude Code	~/.claude/projects/<slug>/<sessionId>.jsonl	import_claude
Codex / ChatGPT CLI	~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl	import_codex
ChatGPT（网页导出）	导出压缩包（任意路径）——conversations.json	import_chatgpt
Cursor	~/.cursor/projects/<slug>/agent-transcripts/<id>/<id>.jsonl	import_cursor
Gemini CLI	~/.gemini/history/<slot>/chats/session-*.json	import_gemini
Reasonix	~/.reasonix/sessions/desktop-*.jsonl	import_reasonix
opencode	~/.local/share/opencode/opencode.db	import_opencode
ZCode（z.ai CLI）	~/.zcode/cli/db/db.sqlite	import_zcode
Grok Build	~/.grok/sessions/<project>/<session_id>/	import_grokbuild
OpenClaw	~/.openclaw/agents/<agent>/sessions/*.jsonl	import_openclaw
Pi Coding Agent	~/.pi/agent/sessions/--<cwd>--/<timestamp>_<uuid>.jsonl	import_pi
Hermes	~/.hermes/（Windows %LOCALAPPDATA%\hermes）	import_hermes
Kimi CLI	~/.kimi/sessions/<workdir-md5>/<sessionId>/wire.jsonl	import_kimi

每次导入都会保留源实际记录的内容——sessionId、cwd、标题、模型、时间戳、工具调用与结果、思考过程。数据较少的源导入其已有的内容；源格式无法保留的部分，会在导入报告里显式标注（如 Kimi 镜像进父 wire 的 SubagentEvent 子代理对话会跳过——父 Agent 工具调用与结果保留，子代理自己的 subagents/<agentId>/wire.jsonl 可直接导入）。

🚀 快速开始

1. 安装 — 把插件加进 profile：

dsh plugin --profile web add dsh-chat-import                    # npm 包
dsh plugin --profile web add -w link:/path/to/dsh-chat-import   # 本地源码（符号链接）

2. 导入 — 在任意 DSH 会话里导入单个文件或整个目录（13 个导入工具调用方式一致——见上方来源表）：

import_claude({ path: "~/.claude/projects" })

3. 续聊 — 刷新一次会话列表，打开导入的会话，继续对话——它会从源记录停下的地方无缝接上。

🛠 使用

注意：导入会即时落盘，但 DSH 的会话列表不会自动刷新——导入后请刷新页面（或会话列表）才能看到新会话。

导入——单个文件或目录。 每个 import_* 工具都接受 path；目录递归扫描，每个文件 / 每段对话成为独立会话：

import_claude({ path: "C:\Users\<you>\.claude\projects\<slug>\<sessionId>.jsonl" })
import_codex({ path: "C:\Users\<you>\.codex\sessions\2026\05\18\rollout-2026-05-18T21-14-16-xxxx.jsonl" })
import_chatgpt({ path: "C:\Users\<you>\Downloads\chatgpt-export\conversations.json" })
import_opencode({ path: "C:\Users\<you>\.local\share\opencode\opencode.db" })

import_chatgpt / import_opencode / import_zcode / import_hermes 恒返回批量结果——一个文件 / 数据库包含全部会话，一次调用即可让每段对话成为独立会话。

• preview: true（别名 dryRun: true）— 只读运行：照常解析 / 读取 / 转换，但零副作用、不落盘。去掉该参数再调一次即正式导入。
• force: true — 即使已导入，也以新 id（import-<sessionId>-<n>）另存一份完整副本；旧会话绝不修改。
• sessionId（可选）— 覆盖目标 DSH 会话 id（默认 import-<源sessionId>）。
• 增量续写（重导） — 重导同一源路径绝不改写已导入历史：未变文件跳过（already-imported，不重读）；增长文件只把新增轮次 append 进同一会话（appended）；截断文件检测并上报（sourceShrunk）——需要完整新副本时用 force: true：

import_claude({ path: "C:\Users\<you>\.claude\projects\<slug>\<sessionId>.jsonl" })
// 未变化 → "already-imported" · 增长 → "appended"（只追加新轮次）

每次导入结果都会上报 status 与任何异常——畸形行、疑似敏感信息、逐源丢弃——绝不静默吞掉。

scan_discover — 只读会话发现

scan_discover 扫描全部 13 种格式的已知数据根，返回结构化会话索引（标题、项目、路径、导入状态），供批导入前预览。零副作用：

scan_discover()
scan_discover({ path: "~/.codex/sessions", format: "codex", query: "import" })

list_imported_sessions & retract_import — 识别与撤回

list_imported_sessions() 枚举本插件已导入的全部 DSH 会话；retract_import({ sessionId })（或 sourcePath）移除其 registry 记录并返回手动删除引导。只识别 + 引导手动删，绝不执行任何删除：

list_imported_sessions()
retract_import({ sessionId: "import-019f5f27-…" })

export_claude — DSH → Claude Code JSONL

export_claude({ sessionId }) 把现有 DSH 会话（导入的或原生的）序列化为 Claude Code JSONL transcript，可直接 --resume。文件写到 <outputDir>/<slug>/<uuid>.jsonl（默认 ~/.claude/projects），文件名是全新 UUID v4——绝不覆盖已有文件：

export_claude({ sessionId: "import-019f5f27-…" })
export_claude({ sessionId: "…", outputDir: "D:\backup\claude-projects", dryRun: true })

sync_to_claude — 增量写回

sync_to_claude({ sessionId }) 把会话的新增完整轮次追加回其 Claude Code 文件——target: "source"（默认，写回导入源文件）或 "copy"（最近一次 export_claude 副本）。文件被外部修改或缩小时一律上报、绝不覆盖；force: true 越过外部修改重锚定（被覆盖的守卫仍会上报）：

sync_to_claude({ sessionId: "import-019f5f27-…" })
sync_to_claude({ sessionId: "…", target: "copy", dryRun: true })

浏览器面板 — 侧边栏发现与导入

dsh web 侧边栏底部上方有一个「导入会话」浮动胶囊（sidebar.footer.action 槽条目以 fixed 浮层渲染，同槽其它条目——如官方 Cordis 徽标占满整个 footer 行——不会把它挤出或挡住）。打开的面板按工作区文件夹分组列出发现的会话（各来源记录里的 cwd/项目名，缺省归入「(未分组)」），支持来源过滤——「全部来源」扫描全部格式的默认数据根，单选来源则只看该格式——并带逐会话导入状态徽标（已导入 / 部分 / 未导入）。搜索框按标题 / 工作区 / 路径过滤，列表分页展示（每页 50 条），跨页选择保留便于批量操作。面板支持 Esc 关闭。

每行支持单选导入，复选框支持多选导入（「导入所选 (N)」）：面板调用与 import_* 工具完全相同的 host 导入管线，幂等跳过 / 增量续写 / force / 上下文预算语义完全一致；导入后自动刷新列表展示最新状态。多会话源（如 conversations.json、opencode/zcode/hermes 库）整源导入——opencode/zcode 只导所选 sessionId。

数据来自与 scan_discover 同一套只读发现（30s TTL 缓存 + 持久化 mtime 书签）；面板除你主动触发的导入外零写入。

/import 斜杠命令

插件还注册了一个 /import <source> <path> 斜杠命令（在挂载了 dsh commands 服务的环境下可用）：直接在会话里输入即可导入，不占模型轮次——与 import_* 工具同一管线、同一幂等 / 增量 / force / 上下文预算语义。<source> 接受短名（claude、codex…）、客户端来源 id（claude-code）或工具全名（import_claude）；<path> 为 transcript 文件或会话目录 / 数据根（单文件导入 / 目录批量照常判定）。

会话启动上下文增强

两个可选钩子在 DSH 会话启动时运行（host agent/session-start 事件），均为 agent 级作用域、绝不触碰你的 transcript：

• 迁移提示（默认开）——当会话工作区存在可发现的（已导入或可导入）外部聊天历史时，注入一行 PromptContext，告诉模型如何继续（/import <source> <path> 命令或侧边栏面板）。per-project 记忆保证同一工作区只提示一次；设 DSH_IMPORT_SESSION_HINT=0 关闭。
• Claude 上下文桥接（默认关）——设 DSH_IMPORT_CONTEXT_BRIDGE=1 把 Claude Code 的上下文资产桥进会话：~/.claude/memory/*.md（按 feedback > project > reference > user 分组、8 KiB 上限、mtime 缓存重读）、项目根 CLAUDE.md、以及 ~/.claude/skills/*/SKILL.md（注册为该 agent 独有的 claude-<name> 技能）。

🔑 关键行为

• 只读导入 — 源转录与数据库绝不改写；导入的 DSH 历史 append-only（既有事件绝不修改）。
• 幂等 + 增量 — 未变源不重读直接跳过；增长只追加新增轮次；截断检测并上报。
• 自动归组工作区 — 会话按源 cwd 归入对应工作区；cwd 在本机不存在时（跨机器迁移 transcript 的常见情况）回退归到源文件所在目录的工作区，不会消失在「未分组」里。
• 上下文预算保护 — 导入会话没有 provider 配置，dsh 不会自动压缩它们；超长会话按上下文预算裁剪（单条内容上限，中间段压缩，保留最早提问、一条摘要与尾部）。预算可在调用时指定，或通过环境变量 DSH_IMPORT_CONTEXT_BUDGET 设置；裁剪结果总是上报。
• 失败要大声，绝不静默 — 畸形行与疑似敏感信息按位置计数上报（行号 / kind——绝不输出内容）；源格式无法保留的部分在导入报告里显式标注。
• 沙箱 — 读取工作区之外的源文件或写工作区之外的导出目标，需要会话沙箱放行该路径。

⚙️ 兼容性

面向 dsh 0.1.x 线（dsh-tools ^0.1.0-rc.6，实测 dsh 0.1.0-rc.6），需要 Node.js >= 22.13（node:sqlite 免 flag 的首个版本）。npm test — 367 个用例。

📦 安装与卸载

dsh plugin --profile web add dsh-chat-import        # npm 包
dsh plugin --profile web add -w link:/path/to/dsh-chat-import   # 本地源码（符号链接）

dsh plugin 把插件的 bundle 声明收编进 profile；重启 dsh 后插件生效。卸载：从 profile 的 bundles 移除 import-claude insert 行并重启 dsh。已导入的会话保留在 DSH 数据目录，不受影响。

📄 许可证

MIT — 见 LICENSE。