dsh-agent-session-import

把 第三方 coding agent 的本地对话记录导入为 DeepSeek Harness（DSH）会话。 一个可安装的 DSH bundle 插件：host 侧只读各 agent 的本地数据，浏览器侧提供导入面板；零运行时依赖、无需构建。

支持来源：

来源	读取的本地数据（只读）
Codex（CLI / 桌面版共用同一存储）	~/.codex/sessions/**.jsonl + ~/.codex/thread_history_1.sqlite
Claude Code	~/.claude/projects/**.jsonl
Cursor IDE（Agent / Composer）	~/Library/Application Support/Cursor/User/globalStorage/state.vscdb
ZCode	~/.zcode/cli/db/db.sqlite
Kimi（Kimi Code CLI / 桌面端）	~/.kimi-code/sessions（Windows：%USERPROFILE%\.kimi-code\sessions，可用 KIMI_CODE_HOME 覆盖；macOS 另含桌面端 runtime 路径）

其他 agent（Aider、Continue……）只需新增一个 provider 文件，见 docs/adding-provider.md。

界面预览

截图中的会话标题与项目名已做模糊处理，只用于展示界面布局。

项目结构

• lib/host/ — Host 插件： service.js（端点编排与导入任务）、scan.js（来源扫描缓存）、 jobs.js（任务进度/取消/保留窗口）、state.js（已导入映射持久化）、 writer.js（DSH v4 会话写入）、cursor-store.js + convert.js（Cursor 读取）、 providers/（各来源 provider 与注册表）。
• src/client/ — 真正的 ES module 源码：runtime、icons（品牌图标与侧栏图标）、 styles（CSS）、i18n（字典）、utils、components、panel、apply、index； 由 esbuild（devDependency）打包成单一 bundle，平台模块保持 external。
• lib/client.js — 由 src/client/*.js 生成的单文件 bundle（DSH client 只加载这个文件，文件头有 generated 标记）。

npm install            # 安装 esbuild 等开发依赖（运行时仍然零依赖）
npm run build:client   # 修改 src/client/ 后重新生成 lib/client.js
npm test               # 单元测试（writer 两种模式、provider 注册顺序/契约）
npm run check          # bundle 是否最新、语法、README 截图、绝对路径等

功能

• 侧边栏 Import Sessions 面板：左侧来源导航，右侧会话列表按项目文件夹分组、可展开/收起，显示标题、更新时间、消息数和 Imported/Archived 徽标。
• 支持搜索、Unimported / All 范围切换、组级全选、Select unimported、逐条勾选；导入弹窗展示总进度、当前条目、逐条结果，失败项可重试。
• 两种导入模式（内容都不丢，区别只在展示与请求结构）：
  • Faithful：思考、工具调用与结果保留为结构化卡片，最适合阅读；续聊时可能受模型 API 对历史 tool_use/thinking 的校验限制。
  • Resume-safe：同样的内容以文本保留（【思考】 / [工具调用] / [工具结果]），去掉 tool/thinking wire 结构，任何模型都能安全继续对话。
• 一条来源对话 → 一条 DSH 会话，尽量回到原项目目录（目录不存在时回退到用户 home）。
• 会话标题与消息数写入 DSH 投影缓存，导入后侧边栏直接可见。
• 已导入记录保存在 $DSH_HOME/session-import/imported.json，重复导入会显示徽标；导入结束后列表自动刷新。

安装

从 npm 安装（发布后可用）

1. 打开 DSH 侧边栏 Plugins。

2. Add plugin → 输入包名（或带版本）：

   dsh-agent-session-import
   dsh-agent-session-import@0.2.2
   

3. Install → 完成后点 Enable now（或到 Plugins 列表启用）。

4. 侧边栏出现 Import Sessions 即可使用。桌面端通常数秒内热组合生效；未出现则重启 DSH。

从 GitHub 安装

1. Plugins → Add plugin。

2. 输入仓库地址（推荐固定 commit）：

   git+https://github.com/howtomakeaname/dsh-agent-session-import.git
   

   或本地 clone 后用该目录的绝对路径（例如 ~/code/dsh-agent-session-import）。

3. Install → Enable。修改代码后重启 DSH 生效。

卸载：Plugins → 该插件 → Uninstall。卸载不会删除已导入的会话。

使用

1. 侧边栏点 Import Sessions。
2. 左侧选来源 → 展开项目分组 → 勾选要导入的对话（或 Select unimported）→ 选模式 → Import。
3. 进度弹窗里查看每条结果；完成的会话会出现在左侧会话列表中（归入对应工作区分组）。

会话头部与来源说明

• 每条导入会话的第一个 surface 事件是一个空的 system/message（受保护 surface head），满足 DSH v4 的格式要求； 续聊时由 DSH 按当前 cwd、工具集、preset 与模型重新渲染 system prompt，插件不会把 system prompt 硬编码进日志。
• 第一条 user 消息开头会注入一段来源说明 text block，告诉模型历史来自哪个 agent、历史工具名与当前 DSH 工具不同， 仅作参考。它是普通 user-role 文本，在所有续聊路径中都会保留。

已知限制

• Codex：完整 reasoning 链不落明文，本地只保留可见的 summary；桌面版与 CLI 共用 ~/.codex，已一并覆盖。
• Kimi：只支持 Kimi Agent / Kimi Code 会话；普通 Kimi 聊天记录在服务端，本地没有正文。
• ZCode：schema 绑定 ZCode 0.16.x；rewind 会话按线性历史导入。
• 工具结果超过 2 万字符、思考超过 1.2 万字符会截断并标注。
• 超大历史按页读取；个别损坏行会跳过并计入统计。
• Faithful 模式续聊时，模型服务可能校验历史中的 foreign tool_use / thinking；需要稳定续聊请用 Resume-safe。

数据与隐私

• 只读第三方本地数据（SQLite 以只读 URI 打开），不修改、不复制原始数据。
• 插件本身不发送网络请求；所有处理都在本机 DSH Host 进程内完成。
• 删除 $DSH_HOME/session-import/imported.json 只会重置「已导入」记录，不会删除会话本身。

扩展新来源

在 lib/host/providers/<id>.js 实现 status/list/load，并在 lib/host/providers/registry.js 的 OPTIONAL_PROVIDERS 加一行即可。完整契约、字段映射与不变量见 docs/adding-provider.md。

发布（维护者）

npm run check                     # bundle 结构 / 无绝对路径 / client 入口检查
npm pack --dry-run                # 确认 tarball 只包含 lib、docs、README、LICENSE、CHANGELOG
npm login                         # 已登录可跳过
npm publish --access public       # 发布到 npm（默认 registry 不可用时显式 --registry）

也可以直接从 Git 仓库安装（DSH 的 Add plugin 支持 git spec）；若要在 Discover 市场出现，需要把 dsh-plugin-market-index 格式的索引 JSON 与图标托管到可公开访问的 URL，让用户添加 index source。

平台支持

平台	状态
macOS	已在实机验证 5 个来源的端到端导入（列表、导入、冷读、UI）
Windows / Linux	路径与 SQLite 访问已跨平台处理：Cursor 使用 %APPDATA% / ~/.config，Codex/Claude Code/ZCode 使用用户目录，cwd 用 path.isAbsolute 判定，SQLite CLI 从 PATH 解析；CI 在 ubuntu-latest / macos-latest / windows-latest 跑单元测试与打包检查，尚未在 Windows 真机用本地数据做导入验证

• Kimi Code CLI 会话按 KIMI_CODE_HOME / ~/.kimi-code/sessions 读取，macOS/Windows/Linux 均支持；Kimi 桌面端内置 runtime 的路径目前按 macOS 解析，其他平台找不到时仅这部分不可用。
• SQLite 访问统一优先走 node:sqlite（各平台随 DSH runtime 提供，不依赖预装 sqlite3）；仅在运行时缺少该模块时回退 PATH 上的 sqlite3/sqlite3.exe，可用 SQLITE3 环境变量覆盖。

兼容性

• 在 DSH 0.2.x 上开发与验证（桌面版 0.2.1-rc.2）。
• 包本身零运行时依赖；host 侧使用 Node 内置模块，浏览器侧复用 DSH 平台内置的 @deepseek-ai/dsh-client-ui-primitives 等静态模块。

License

MIT