Claude Code 迁移 Mreate/dsh-cc-import

dsh-cc-import

简体中文 · English

把 Claude Code 的记忆与对话迁移进 DeepSeek Harness（DSH）：CLAUDE.md 记忆加载、 /init 一键生成 AGENTS.md、Claude Code .jsonl 对话高保真导入为可回溯、可 resume 的 DSH 会话。
零核心改动，纯插件挂载。安装插件即可启用，卸载后不留任何核心补丁。

核心能力

- 记忆加载（CLAUDE.md）：按 Claude Code 官方文档 的 memory 层级注入 ~/.claude/CLAUDE.md、./CLAUDE.md、./CLAUDE.local.md、子目录 CLAUDE.md （路径索引、按需读）与 @import 引用。AGENTS.md 家族由 DSH 原生自动加载，本插件不重复注入。
- /init 命令：输入 /init 先选择文档语言（中文 / English，DSH 选项选择 UI），再把「分析代码库 → 创建 AGENTS.md」的提示词提交给当前模型，由模型探索项目并写入 AGENTS.md（参考 Claude Code 的 /init 流程；创建结果即时可见）。
- 对话高保真导入：把 CC .jsonl 会话转换为可回溯、可 resume 的真实 DSH 会话（user/assistant 回合、工具调用与结果、thinking → reasoning、时间戳、token 用量），导入即附加到当前工作区。
- 子代理导入：CC 子代理侧链（/subagents/*.jsonl）作为子会话导入（parentSession + delegationDepth + origin: 'subagent'）。
- 可扩展：导入器实现 ImportProvider 接口（src/import/provider.ts），后续接 Cursor / Codex 等新 Agent 只需新增一个 provider 实现。
- 双入口：侧边栏底部「🅒 导入 Claude Code 对话」按钮 + 浮层多选选择器；模型侧另有 cc_history_list / cc_import 工具，模型也能直接驱动导入。

快速开始

前置条件：已全局安装 dsh CLI 的 DSH（npm install -g @deepseek-ai/dsh）、pnpm 10+、Node ≥ 22。

1. 克隆 / 下载本插件源码后安装依赖并构建
cd cc-import
pnpm install
pnpm run bundle # tsdown → lib/index.js + lib/client.cjs

2. 装进 DSH profile（以 web 为例）
dsh plugin --profile web add github:Mreate/dsh-cc-import

客户端半由 package.json 的 dsh.client 字段自动发现打包，无需手动接线。
安装后重启 dsh web（浏览器页面自动重连，若客户端还是旧版刷新一次页面即可）。

界面

侧边栏底部新增「🅒 导入 Claude Code 对话」入口（DSH 官方 UI 无改动，纯插件叠加）：

| 区域 | 说明 |
| 底部入口 | 🅒 按钮，点击打开导入浮层 |
| 浮层顶栏 | 显示当前目标工作区（工作区：；检测不到时显示全部会话） |
| 会话列表 | 多选：CC 图标 + 标题（超 80 字自动折叠为灰色 … (xx字已折叠)）+ 项目目录 + 大小 |
| 批量导入 | 「导入选中（N）」→ 逐条结果（✓/✗ + 事件数 + 子代理数）→ 全部成功自动关闭浮层 |
| 列表过滤 | 只显示当前工作区 cwd 匹配的 CC 会话（Windows 大小写/分隔符容错） |

效果截图

| 功能 | 截图 |
| 导入对话 UI | 导入浮层 |
| /init 指令 | init指令 |

文档

| 主题 | 内容 |
| 设计文档 | 架构、事件映射、记忆层级、里程碑 |
| 接入清单 | 安装、接线、端到端验证步骤 |
| 代码约定 | 模块边界、provider 抽象、lossless JSON 约定 |

配置与扩展

- 记忆层级：CLAUDE 家族内 local > project > user；根目录记忆读入全文，子目录同名文件只列路径索引（按需 read）；@import 支持 @path （相对引用文件所在目录）、@/path（工作区根）、@~/path（用户主目录），可嵌套、去环、深度有界。
- /init：先选语言（中文 / English）→ 生成「分析代码库并创建 AGENTS.md」提示词并提交给当前模型，由模型探索项目写入 AGENTS.md（已存在则建议改进）。
- 导入器扩展：实现 ImportProvider（discoverDataRoot / listSessions / previewSession / importSession），在 src/index.ts 注册即可；claude-code 是参考实现。
- 工作区归属：导入会话自动 attachSession 到目标工作区注册表，侧边栏按注册表分组立即出现在对应工作区下。

工作方式

dsh profile
-> dsh-base + dsh-web-app
-> cc-import Cordis patch
-> systemPrompt.context（CLAUDE.md 记忆，user-role 运行时上下文快照；AGENTS.md 由 DSH 原生加载） -> /init 命令（语言选择 → userQuestions → agent.followup → 模型分析生成 AGENTS.md） -> 侧边栏 footer 按钮 + shell.overlay 浮层（客户端半） -> /api/cc-import RPC（webServer HTTP 路由） -> ImportProvider（CC JSONL 解析 + 事件合成） -> sessionPersistence.create/append（持久化） -> workspaceRegistry.attachSession（工作区归属帧） -> 客户端 session.list 基线重拉（立即出现，无需刷新浏览器）

导入只负责「把 CC 历史变成 DSH 会话」。会话日志是对话真源，resume、回溯、工具执行、compaction 与持久化继续由 DSH 服务拥有。更详细的模块边界见设计文档。

技术要点

- 事件级高保真映射：CC 记录 → 平衡的 DSH SessionEvent 序列（turn/start → user/message → step/start → assistant/message → tool/call → tool/result → step/end → turn/end），seq 0 基连续、 time 沿用源时间戳、surface 事件带 surfaceOp: 'append'、data 为 lossless JSON。
- 幂等导入：确定性会话 id（cc-）让重复导入直接返回已有会话；会话被 DSH 归档后仍可重新导入——自动以 cc--reimport-N 新建会话，原归档会话保留。
- 立即可见：导入后 host 触发 host/workspace-changed 帧 + 客户端 session.list 基线重拉，会话立刻出现在当前工作区，无需重启 DSH 或刷新浏览器。
- Windows 路径容错：cwd 过滤做大小写 / 分隔符归一化。
- 模型可驱动：cc_history_list / cc_import 两个工具注册进模型工具集。

已知限制

- 工具调用参数与结果原样保留，但不会被重新执行——导入会话是忠实回放，不是在线重跑。
- 子代理已作为子会话导入，但主会话里触发子代理的工具调用尚未超链接到子会话。
- 附件（图片）还原未实现：CC 图片块降级为文本占位（[image: ]）。
- 侧边栏会话列表是 DSH 封闭区域，导入的会话在列表里无 CC 徽标（徽标只在插件浮层内显示）。
- 导入仅覆盖 claude-code provider；@import 深度/文件数有界（默认 4 层 / 40 个文件）。

完整已知限制与设计取舍见设计文档。

开发

CI 使用 Node 24 与 pnpm；包声明支持 Node ^22.19 || >=24。

pnpm install --frozen-lockfile
pnpm run bundle

pnpm run bundle 会用 tsdown 把 src/ 编译到 lib/（host：lib/index.js；
客户端：lib/client.cjs，工厂形式 window.__ModuleLoader__.load）。修改源码后必须重新构建，重启 dsh web 生效。

权限与安全边界

cc-import 不实现独立沙箱：记忆加载只读文件；/init 与导入写入使用 DSH 现有文件策略（/init 显式以 workspace-write 限定在当前工作区内）。对话导入落盘 sessionPersistence 并附加到工作区注册表，不执行任何模型或 Shell 命令。

License

MIT