kirkchinese/claude2dsh

Claude2DSH

把 Claude Code 的会话、技能、子 agent、斜杠命令、记忆与 MCP 服务器迁移为 DeepSeek Harness（DSH）原生可续聊会话；需要时，还能把 DSH 新轮次带回 Claude Code JSONL。

Awesome DSH Plugin
npm version
DSH >=0.1.5-rc.1 =22.19
license: MIT

English

一座抽象桥把琥珀色来源环境中的会话节点与软件资产安全送入青色目标环境

Claude Code 是多工具迁移层的第一个会话源适配器。Claude2DSH 保留有用的会话结构，通过 DSH 原生持久化 API 写入，并默认把原始 Claude 目录视为只读源。

[!IMPORTANT]
0.3.0 要求 DSH >=0.1.5-rc.1 ~/.claude/projects只读"] --> B["Claude adapter发现 · 解析 · 归一化"]
B --> C["归一化会话 IR轮次 · 步骤 · 工具 · 图片"]
C --> D["DSH 事件合成原生会话事件"]
D --> E[("DSH 会话$DSH_HOME/sessions")]
E --> F["导出 / 同步安全副本"]
F --> G["Claude Code JSONL可续聊转录"]
E --> H["Settings UI + 工具导入 · 导出 · 同步 · 合并"]

快速开始

要求：Node.js >=22.19.0、pnpm 与 dsh CLI。
sh
把已发布插件安装进 DSH 内置的有头 profile
dsh plugin --profile web add @claude2dsh/plugin@0.3.0

启动浏览器 UI；终端会打印本地 URL
dsh web

然后：

1. 打开 dsh web 在终端打印的 URL。
2. 全新 DSH 首次打开时如出现模型 API Key 提示，可选稍后配置；迁移本身不会调用模型。
3. 进入设置 → Claude2DSH。
4. 选择语言，确认 Claude 会话目录，并按需勾选 subagent/workflow 子会话。
5. 先点预览导入检查统计与逐项报告，再点执行导入。
mermaid
flowchart LR
S1["安装插件dsh plugin --profile web add ..."] --> S2["启动 UIdsh web"]
S2 --> S3["打开 设置 → Claude2DSH"]
S3 --> S4["预览导入"]
S4 --> S5["执行导入"]
S5 --> R["DSH 原生会话会话来源中可见"]

设置 → Claude2DSH 的第一个分区就是迁移向导；界面默认中文，也可切换 English。若 3080 已被占用，运行 dsh web --port 0 并打开 DSH 打印的 URL。

真实 Claude2DSH 首次迁移向导中文界面，包含语言、来源目录、子会话选项、预览导入、执行导入与自动镜像默认值

预览只读，并在任何 DSH 写入前给出逐项计划。

真实 Claude2DSH 预览导入报告，显示一个不含隐私、等待导入的合成会话

下面是真实成功结果。截图来自真实的 Claude2DSH 界面，输入为不含隐私的合成 Claude 转录。

真实 Claude2DSH 导入结果，显示合成会话新导入一项且失败为零

仓库辅助脚本

如果已经克隆本仓库，辅助脚本会执行同样的主 web profile 安装，并在 DSH 默认本地端口（3080）启动 UI：
sh
bash scripts/install-claude2dsh.sh

只有确实需要自定义 profile 时才设置 CLAUDE2DSH_PROFILE。Headless profile 暴露同一组工具，但不包含浏览器 UI。

能力：什么场景、怎么用

| 能力             | 使用场景                                                  | 入口与可见结果                                                                                                                                                    |
| ---------------- | --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 会话导入         | 首次迁移，或 Claude 转录新增轮次后                        | 设置 → Claude2DSH → 首次迁移，或 claude2dsh_import；报告 previewed/imported/already/appended/skipped/failed                                               |
| 技能导入         | 让 Claude skills 成为 DSH 原生可发现资产                  | claude2dsh_import_skills；技能复制到 $DSH_HOME/skills 并进入 DSH 技能发现                                                                                     |
| 全局上下文       | 把用户全局 ~/.claude/CLAUDE.md 迁入 DSH 全局指令        | claude2dsh_import_context；先预览，绝不覆盖内容不同的 $DSH_HOME/AGENTS.md                                                                                     |
| 项目记忆         | 让一个项目的 MEMORY.md 与 memory/.md 在 DSH 中可发现 | claude2dsh_import_memory；每个项目生成一个 DSH 技能包                                                                                                           |
| 导出回 Claude    | 想在 Claude Code 继续某个 DSH 会话                        | claude2dsh_export；在 $DSH_HOME/claude2dsh/exports 写入经校验的 JSONL 副本                                                                                    |
| 同步回写         | 把 DSH 新轮次追加到已有 Claude 导出副本                   | claude2dsh_sync；报告追加的轮次、事件与 JSONL 记录数                                                                                                            |
| 自动镜像         | 持续监控 Claude 新轮次，并把 DSH 轮次镜像到安全副本       | 设置 → 自动镜像；claude2dsh_autosync 查看状态或恢复暂停队列                                                                                                 |
| 冲突合并         | 同步水位后双端都增长，且任一版本都不能丢                  | claude2dsh_merge；计算或创建新的合并副本，不修改两侧原件                                                                                                        |
| 工具输出 sidecar | 转录引用了较大的持久化工具输出                            | claude2dsh_sidecars；列出/解析复制文件，并记录缺失或超限项                                                                                                      |
| 会话来源         | 区分 Claude 主会话、子会话与合并会话                      | 设置 → 会话来源，或 claude2dsh_session_sources；显示来源类型与路径                                                                                          |
| 子 agent 导入    | 希望 Claude 子 agent 定义的指令在 DSH 中继续可用          | claude2dsh_import_agents；每个 ~/.claude/agents/.md 变成技能 cc-agent-，来源、模型与工具列表写入 frontmatter metadata                                |
| 命令导入         | 希望 Claude 斜杠命令在 DSH 中保持“由人调用”               | claude2dsh_import_commands；commands//.md 变成 cc-cmd--，并带 disable-model-invocation: true，人工提示词不会进入模型目录              |
| MCP 服务器导入   | 希望 Claude 的 MCP 服务器不必在 DSH 重新手抄配置          | claude2dsh_import_mcp；读取 ~/.claude.json 与项目 .mcp.json，apply:true 写出 dsh-mcp-client patch 层并给出 dsh --patch 命令；SSE 服务器报告为不支持   |
| 插件盘点         | 不运行 Claude 插件代码，只检查其中的资产                  | claude2dsh_plugin_inventory；dry-run 报告技能、命令、agent、prompt、hook 与 marketplace；apply:true 同时转换插件内的 agents/ 与 commands/                 |
| 图片策略         | 保留转录图片，同时尊重所选模型的输入模态                  | imageMode: "auto" 自动跟随当前 DSH 会话路由；探测路由 provider/model 留空即跟随会话，填写则覆盖。Settings 页面显示当前探测结论，每个导入条目记录降级/升格原因。 |
| Hook bridge      | 复用当前已支持的 Claude command hook 子集                 | 设置 → Claude hook bridge 只读扫描 Claude 设置与插件 hooks，预览可映射的 command hook，并可保存候选供下次启动启用；不支持类型会报告并跳过                     |

转换不等于等价，报告会说明差异：Claude 子 agent 变成 DSH 技能而不是 preset，Claude 斜杠命令变成 user-invocable 技能。原始 frontmatter 字段保留在技能 metadata 中，差异可被检查。

会话导入具备幂等性：再次运行会报告已存在，不会复制一份。默认递归搜索并感知 CLAUDE_CONFIG_DIR（回退到 ~/.claude/projects），首启向导会显示实际来源目录与发现/导入数量。项目级 CLAUDE.md 不需要复制，因为 DSH 已原生读取它；只有用户全局上下文需要转换。

Settings 界面导览

Claude2DSH 把首次迁移与安全关键默认值放在同一个设置页：

- 首次迁移：语言、来源目录、可选子会话、预览、执行与逐项结果。
- 自动镜像：需显式开启的 watcher、防抖与 DSH → 安全副本方向。
- 导入默认值：图片模式/provider/model、子会话默认值与 sidecar 大小上限。
- 导出 / 写回：默认目标是安全副本；写真实 ~/.claude 是独立危险开关。
- Claude hook bridge：只在启动时生效的路径与激活说明。
- 会话来源：已导入会话 ID、来源类型与来源路径。

以下真实截图使用默认中文界面与合成数据；切换语言后标签会同步变化。

Claude2DSH 设置中的自动镜像、导入默认值与导出或写回分区，画面显示安全默认值

Claude2DSH 设置中的启动时 Hook bridge 与会话来源分区，显示一个不含隐私的合成 Claude 主会话

安全边界

- 导入把 Claude 源视为只读；预览不会写 DSH。
- DSH 写入只经过宿主持久化与 $DSH_HOME/sessions、$DSH_HOME/skills、$DSH_HOME/claude2dsh 下的 DSH 原生目录。
- 导出与同步默认写 $DSH_HOME/claude2dsh/exports，不会写原始 ~/.claude。
- 写原始 Claude 目录必须显式授权 allowOriginalClaudeDir: true，默认始终拒绝。
- 插件盘点只读资产，不执行插件代码。
- 自动镜像检测到双端并发增长就暂停；显式合并工具创建新的安全副本，不猜哪一侧获胜。

当前局限

- 宿主版本范围： 0.3.0 支持 DSH >=0.1.5-rc.1
插件装好了，但为什么看不到 UI？

很可能装进了 headless profile。把插件安装进内置 web profile 并启动 dsh web；页面位于设置 → Claude2DSH。

会写我的真实 ~/.claude 吗？

迁移不会。导出与同步默认也只写 $DSH_HOME 下的安全副本。写原始目录需要另一项显式授权。

为什么自动镜像与 Hook bridge 默认关闭？

两者都会在首次导入后继续执行工作，因此保持 opt-in，让用户先看清并接受其范围；Hook bridge 还只覆盖文档明示的 7/30 command-only 子集。

兄弟项目

Claude2DSH 与同作者的另一款 DSH 插件面向同一群人——需要在多个 agent 工具之间工作的人：

- CiteCiter —— DSH 会话的引用与证据管理。Claude2DSH 负责把整段会话在宿主之间搬运，CiteCiter 负责让答案背后的来源可追溯、可引用。两者遵循同一套原则：只用公开扩展点、未经显式授权不写入外部工具目录、每次发布前都跑真实 profile 验收。

如果你刚把 Claude Code 的会话库迁进 DSH，接下来的自然选择就是给那些会引用文档的会话装上 CiteCiter。

许可与致谢

MIT。项目独立设计，并受益于 dsh-chat-import（MIT）与 dsh-claude-move（Apache-2.0）的公开成果；感谢两个项目提供有价值的参照。Hook 兼容委托给 DeepSeek Harness 官方 Claude Code hook bridge 包。