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 指令 |
文档
| 主题 | 内容 |
|---|---|
| 设计文档 | 架构、事件映射、记忆层级、里程碑 |
| 接入清单 | 安装、接线、端到端验证步骤 |
| 代码约定 | 模块边界、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），seq0 基连续、
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-codeprovider；@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 命令。
