PerryLink/dsh-claude-move

🚚 dsh-claude-move
- 1024 商店渠道：先执行一次 npm i -g dsh1024，然后执行 dsh1024 plugin --profile web add dsh-claude-move（计入 deepseek1024.com 安装排名）。
Gitee

将 Claude Code、Codex、OpenCode 和 Hermes 迁移到 DeepSeek Harness —— 将会话、记忆、技能、指令和斜杠命令复制为可恢复的 DSH 会话，仅复制且需审批。

迁移时保留你的 Claude Code 历史记录：一次安装、可恢复会话、与运行中的 Claude Code 实时同步，以及四源迁移向导。

License
DSH plugin
dsh-doctor
Node
CI
Version
npm version
npm downloads

English · 简体中文 · Español · Português · हिन्दी

兼容性

- 面向 dsh 0.1.5-rc.2（web profile，会话格式 V3）；对等依赖要求 >=0.1.2-rc.1 =0.1.5-alpha.1 =24。
0.1.2-rc.1（适配于 2026-09-04）：会话信封保留其可忽略字段，仅用于存储日志的读取兼容性 —— Session.append 仍无法写入该字段，因此审计门禁行为保持不变。
- 0.4.0 发布了一个双基线 sessionPersistence 运行时垫片，通过 API 形态进行特性检测（绝不通过版本）：旧版 API（create/append/readFrom，list() 返回头部）和句柄接缝（create 返回 SessionHandle，list()/stat() 返回快照）均可工作。句柄接缝发布在 alpha 线上（@deepseek-ai/dsh-session-persistence / -jsonl 0.1.5-rc.2），因此兼容工作流覆盖了它。在句柄路径上，每次追加后都会跟随 flush()（持久性屏障）和配对的 close()（单写入者所有权）；头部会盖上后端当前格式版本以及显式的 isSeeded；缺失的助手模型来源会回退到提供方；并且自 0.4.5 起，当后端格式版本 >= 2 时，合成的 assistant/message 事件会携带 stream: [] —— V3 的 Session.fromRestore 会断言 Array.isArray(data.stream)，因此没有它，日志虽被写入且可读，却无法恢复。当所列元素的 header.id 无法解析时，导入扫描清理会拒绝运行，因此 imports.json 绝不会被静默清空。
- 最近一次针对全新 tarball 安装的验证：真实扫描、真实批量导入（幂等重复导入）、工作区附加和持久化产物均已确认；macOS/Linux 由 CI 矩阵覆盖。导入的日志使用会话格式 V3，无法被 dsh ）将 DSH 会话写回为可恢复的 Claude Code JSONL 转录记录（user/assistant/tool 轮次，thinking + tool_use/tool_result 配对，尽力进行 cwd 映射），因此历史记录可以再次离开 DSH。

四源迁移向导

/move              # 一次性向导：检测 → 预览 → 执行 → 报告（全部四个源）
move_detect        # 扫描 Claude Code / Codex / OpenCode / Hermes
move_preview       # 逐项计划：new | unchanged | changed | conflict（带 diff）| unsupported
move_run           # 在审批门后执行；冲突解决：
skip | overwrite | rename | merge  （默认 skip — 绝不猜测）

- 源 — Claude Code（~/.claude）、Codex（~/.codex）、OpenCode（数据 + 配置根目录）、Hermes（技能/记忆根目录）；每个源都有自己的解析器 + 映射器。
- 映射 — 记忆/指令 → DSH 全局 AGENTS.md 中的仅追加托管区段（每项一个标记区段）；技能 → 真正的 DSH 技能（SKILL.md 包按原样复制，其他格式转换）；斜杠命令 → 注册的 DSH 命令（重启后从 move.json 重建）；会话 → 可恢复的 DSH 会话（与阶段 1 相同的导入器）。
- 幂等 — 每个已应用的计划都记录在 $DSH_HOME/claude-move/move.json 中（digest / targetDigest / appliedAt）；重新运行会跳过未更改的项，force 会重新应用它们。
- 需审批 — 任何会写入内容的运行都会先询问 ctx.approval；除 allowed-once 之外的任何结果都意味着零写入。

快速开始

1. 将捆绑包安装到你的配置文件中
dsh plugin --profile web add "github:PerryLink/dsh-claude-move#master"
或者从 npm 安装（已发布版本）
dsh plugin --profile web add dsh-claude-move

2. 重启并验证该行
dsh --profile web --dump-config | grep -A4 'id: claude-move'

然后，在任意 DSH 会话中，运行一条命令：
sh
/claude-import-all      # 扫描 → 复制每个 Claude 会话 → 报告

导入后无需重启 DSH——刷新已打开的 Web 页面一次，然后点击任意已导入的会话即可继续。

安装与卸载

- git 渠道（最新 master）：dsh plugin --profile web add "github:PerryLink/dsh-claude-move#master"——纯 ESM，无需 prepare 或 allowBuilds 步骤。
- npm 渠道（已发布版本）：dsh plugin --profile web add dsh-claude-move。
- tarball 渠道：在本仓库中运行 npm pack，然后执行 dsh plugin --profile web add ./dsh-claude-move-.tgz。
- 卸载：从配置文件的 bundles 中移除 claude-move 行，然后重启 dsh。已导入的会话会保留在 DSH 的数据目录中；该插件只写入其缓存（$DSH_HOME/claude-move/）和 claudecode 工作区文件夹，绝不触碰 Claude 源数据。

迁移内容

~/.claude (只读)
├─ projects//.jsonl  ──→  可恢复的 DSH 会话，归入一个 "claudecode" 工作区（默认）
├─ projects//memory/  ──→  实时的系统提示词记忆区段（每次请求重新读取）
├─ skills/*           ──→  真正的 DSH 技能
└─ CLAUDE.md + settings ──→  早期提示词区段 + 配置建议（绝不自动应用）

| 在 Claude Code 中 | 在 DSH 中落地为 |
|---|---|
| 会话记录（projects//.jsonl） | 均衡、可恢复的 DSH 会话——完整保真的 user/assistant/tool/thinking 映射，并修复中断的工具调用——归入一个 claudecode 工作区或每个项目一个 |
| 记忆文件（projects//memory/.md） | 一个实时的系统提示词上下文区段，每次请求重新读取（feedback > project > reference > user） |
| 技能（~/.claude/skills/*） | 真正的 DSH 技能（kebab-case 名称、冲突后缀，默认最多 30 个；README.md/MEMORY.md 以及没有描述的文件会被跳过） |
| CLAUDE.md（全局 + 每项目） | 一个早期提示词区段；项目文件优先 |
| settings.json | DSH 配置建议，并附有明确的无法映射键列表 |
| 项目状态（目录、git 分支与脏文件数） | 显示在扫描索引、Web 面板徽章以及 /resume-claude 交接中 |

用法

在挂载了该插件的任意会话中调用这些工具：

claude_scan                          # 完整扫描（增量缓存）
claude_scan { path: "~/.claude/projects/" }   # 部分扫描
claude_scan { refresh: true }        # 跳过缓存，重新扫描全部内容
claude_scan { projectsLimit: 10, sessionsLimit: 5, fields: "brief" }  # 精简输出

import_claude { path: "~/.claude/projects//.jsonl" }  # 单个会话
import_claude { path: "~/.claude/projects" }        # 目录（递归）
import_claude { path: "all" }                       # 全部内容
随时重新运行：未更改的文件会被跳过，已增长的记录只追加新的轮次。
超过 maxTranscriptBytes 的文件会以分块方式流式导入（无内存上限）。
import_claude { path: "...", force: true }          # 全新完整复制（保留之前的副本）

claude_export { sessionId: "" }     # 将 DSH 会话写回 Claude JSONL
claude_export { sessionId: "...", path: "~/.claude/projects//.jsonl" }  # 显式目标

命令（用户触发，不产生模型轮次）：

/claude-import-all                # 一次性：扫描 → 导入全部 → 报告 → 注入当前会话
/resume-claude latest             # 继续最近的 Claude 会话
/resume-claude         # 按源会话 id 或 import- id
/resume-claude           # 匹配标题；多个匹配会列出，绝不猜测
/claude-move-reset                # 重置插件缓存（书签 + 导入映射）；已导入的会话会保留
/claude-export  [path] # 将 DSH 会话导出为可恢复的 Claude JSONL 记录

Web 面板：一个浮动迁移面板，包含项目/会话树、状态徽章（未导入 / 已导入 / 已导入且有新轮次 / 源缺失 / 目录缺失 / git 脏）、关键词过滤、分页渲染、每个会话的“导入并继续” + “打开会话” + “刷新会话列表”、带实时进度条和取消功能的批量导入，以及缓存重置按钮。文本跟随浏览器语言（zh/en）。通过插件自有的 /api/claude-move/ JSON 路由在公共 ctx.webServer 接缝上提供服务。

导入之后

你不需要重启 DSH。 导入在完成的那一刻就会通过公共 sessionPersistence 服务持久落地：

- 服务器端列表（session.list / workspace.list RPC、CLI、任何新页面加载）会立即在 claudecode 工作区下显示已导入的会话。
- 面板会自行刷新已打开页面的会话列表，并为每个已导入会话提供打开会话按钮。
- 已导入的会话可以立即打开、阅读和恢复——使用 /resume-claude，或在列表中点击该会话。随时重新运行导入只会将新的轮次同步到同一批会话中。

配置

全部可选，可在 cordis.yml 中覆盖。

| 键 | 默认值 | 含义 |
|---|---|---|
| claudeHome | $CLAUDE_CONFIG_DIR 或 ~/.claude | Claude 数据根目录 |
| workspaceMode | claudecode | claudecode（一个专用工作区）· per-project（每个源 cwd 一个工作区） |
| claudecodeDir | $DSH_HOME/claudecode | claudecode 工作区文件夹（插件唯一会创建的文件夹） |
| scanGit | true | Git 探测级别：true（完整）· 'branch'（零 git 调用）· false |
| gitTimeoutMs | 5000 | Git 子进程超时 |
| scanConcurrency | 8 | 并行项目扫描上限 |
| maxTranscriptBytes | 67108864 | 流式导入阈值（超过则分块） |
| excludeProjects | [] | 要跳过的 Slug 子串 |
| enableMemory | true | 将记忆作为实时提示词部分注入 |
| memoryMaxBytes | 8192 | 记忆部分上限 |
| memoryScope | current-project | current-project · all（当前项目优先） |
| enableSkills | true | 将 Claude 技能注册为 DSH 技能 |
| maxSkills | 30 | 技能数量上限 |
| extraSkillDirs | [] | 额外技能目录 |
| enableInstructions | true | 注入全局 + 项目 CLAUDE.md |
| resumeMaxChars | 2048 | 交接摘要字符上限 |
| resumeMode | inject | inject（交接摘要） · agents（ctx.agents.resume） |
| enableWebPanel | true | 注册 /api/claude-move/ 面板路由 |
| importConcurrency | 4 | 每批并行读取 + 转换 |
| requireApproval | true | 向导写入请求 ctx.approval（仅允许一次） |
| codexHome | $CODEX_HOME 或 ~/.codex | Codex 数据根目录 |
| opencodeDataHome | 平台 XDG 数据目录/opencode | OpenCode 数据根目录 |
| opencodeConfigHome | 平台 XDG 配置目录/opencode | OpenCode 配置根目录 |
| hermesHome | $HERMES_HOME 或 ~/.hermes | Hermes 数据根目录 |
| skillsDir | $DSH_HOME/skills | 向导技能目标 |
| agentsMdPath | $DSH_HOME/AGENTS.md | 向导记忆/指令目标 |
| moveWorkspaceMode | per-source | per-source · single 向导导入的工作区分组方式 |
| enableExport | true | 注册 claude_export 工具和 /claude-export 命令 |
| exportDir | $DSH_HOME/claude-export | 默认导出文件夹（显式 path 始终优先） |

工具与界面

| 界面 | 类型 | 说明 |
|---|---|---|
| claude_scan | 工具 | 项目/会话/记忆/技能/设置的结构化索引 |
| import_claude | 工具 | 导入一个会话、一个目录或 all（增量，force 用于全新副本） |
| claude_export | 工具 | 将 DSH 会话导出为可恢复的 Claude Code JSONL 转录 |
| move_detect / move_preview / move_run | 工具 | 四源向导：扫描、带差异的逐项计划、在审批后执行 |
| /claude-import-all | 命令 | 扫描 → 导入所有内容 → 报告 |
| /resume-claude | 命令 | 继续 Claude 会话（最新、id 或关键词） |
| /claude-move-reset | 命令 | 重置插件缓存（保留已导入的会话） |
| /claude-export | 命令 | 将 DSH 会话导出为可恢复的 Claude JSONL 转录 |
| /move | 命令 | 一次性四源向导 |
| Web 迁移面板 | 客户端 | 浮动面板，带进度、取消、分页、打开会话 |

权限与数据

- 权限：workshop 清单声明 filesystem:read 和 filesystem:write。
- 读取 ~/.claude（转录、记忆、技能、CLAUDE.md、settings.json）——严格只读——以及它导入的项目目录。
- 写入：通过公共 sessionPersistence 服务写入 DSH 会话日志（仅创建 + 追加，绝不删除/重写/归档）、工作区注册表记录、其位于 $DSH_HOME/claude-move/ 下的缓存、claudecode 工作区文件夹，以及导出到 $DSH_HOME/claude-export/（或显式目标路径）下的 .jsonl 文件。
- 绝不修改 Claude 源文件、触碰其他应用程序的数据或访问网络。不读取或传输任何凭据。

安全边界

- 源文件为只读；DSH 日志为仅追加（仅 create + append）。
- 外部转录记录为不可信输入——其中的任何内容都不会被执行；system/developer/thinking 内容绝不进入恢复交接。
- 仅使用公共服务——sessionPersistence / workspaceRegistry / tools / commands / systemPrompt / skills / webServer；不修改引擎或 UI。
- 机密仅按位置报告（file:line:kind）；permission/permission-mode/queue-operation 记录仅计数，不导入。
- 向导写入需经审批门控——除 allowed-once 之外的任何结果都意味着零写入。

已知限制

- 标题来自 custom-title/ai-title/首个提示词；Claude 的 summary 记录会被报告，但不会映射到 DSH 压缩节点（合成有效的压缩事务会伪造其 seq 范围和检查点消息）。
- thinking 块会作为 reasoning 内容保留，但绝不进入恢复交接。
- 被中断的工具调用会用合成的错误结果修复（绝不丢弃），并报告为 repaired.synthesized。
- 权限类记录仅计数，不导入；DSH 权限预设建议在报告中生成。
- 在不具备流式 fs.streamText 接口的主机上，大于 maxTranscriptBytes 的转录记录会显式失败，而不是部分导入。
- 在 workspaceMode: 'per-project' 下，源目录已被删除的会话仍会导入，但工作区附加会失败（保持未分组；workspace.attached: false 并附带 reason）。默认的 claudecode 工作区不依赖源目录。
- 如果转录记录被截断或原地重置（轮次少于记录的导入量），重新导入会跳过它并报告 sourceShrunk；使用 force: true 可进行全新的完整复制。
- Web 面板是一个零构建的浮动面板，由插件自身的 JSON 路由驱动；它不使用 shell 的内部 UI 插槽系统。

模型体验

- 面向模型的界面是工具的描述/schema 及其输出：claude_scan 返回结构化索引，import_claude 返回带警告位置的文件级摘要，claude_export 返回导出摘要（目标路径 + 轮次/消息/工具计数）。工具结果本身也会被记录为 tool/result 事件，因此一切皆可重建。
- 没有隐藏的面向模型文本；memory/CLAUDE.md 部分注册在 ctx.systemPrompt 上（提示词组装，可从会话日志重建）。

故障排除
- 行未生效：dsh --profile  --dump-config 应打印 # == dsh-claude-move；请重新运行 dsh plugin --profile  add ...。
- Web 能启动但静默挂起：由 dsh plugin add 初始化的新配置文件仅包含 dsh-base —— 请将 @deepseek-ai/dsh-web-app 添加到 dsh.profile.bundles。安装到现有的 web 配置文件则无需任何操作。
- 面板路由返回 404：仅当 enableWebPanel: true 且组合了 Web 服务器时才会提供这些路由；请检查启动日志中的 FAILED fibers。
- 导入失败并提示“transcript 过大”：请调高 maxTranscriptBytes，或单独导入该文件。
- 导入成功但侧边栏未显示新会话：页面已经处于打开状态 —— 请点击面板的刷新按钮（或重新加载页面）一次。永远不需要重启 DSH。
- 日志：启动失败会打印到 dsh 控制台；该插件会针对工作区/导入映射问题记录以 [claude-move] 为前缀的错误。

归属（开源组件）

本项目基于 Apache License 2.0 许可；以下 MIT 许可的组件保留其各自的许可证（完整文本见 THIRD_PARTY_NOTICES.md）：

- 转换核心取自 Nwflower/dsh-chat-import（MIT）。
- 发现约定与安全模型来自 Demogorgon314/dsh-resume-plugin（MIT）。
- 记忆/技能注入与 frontmatter 解析模式来自 YYTbit/dsh-plugin-claude-bridge（MIT）。

开发

npm install   # peer deps: @deepseek-ai/dsh-tools@>=0.1.2-rc.1 =0.1.5-alpha.1 <0.2.0, @deepseek-ai/cordis, schemastery
npm test      # node --test test/.test.mjs

CI 通过 GitHub Actions 在 Linux/macOS/Windows 上使用 Node 22 运行完整测试套件（test.yml）。

主题

deepseek-harness、dsh-plugin、claude-code、migration、session-import、resume

贡献者

- @PerryLink —— 创建者与维护者：导入流水线、四源迁移向导、Web 面板、文档、CI/CD 与发布。
- @OLDnana1 —— 对中断的工具调用损坏问题的根因分析，该问题导致导入的会话在恢复时永久返回 HTTP 400。
- @GooodWei —— 发现 README.md（以及任何无描述的 .md）被错误注册为技能，从而破坏了 DSH 的技能加载。

PerryLink DSH 插件家族

本项目是由 PerryLink 维护的 40 个 DeepSeek Harness 插件之一。如果这个对你有帮助，其他的很可能也一样：

| 插件 | 一句话简介 |
|---|---|
| dsh-auto-review | 审批链上的第二模型自动审查，默认故障关闭 | |
| dsh-background-agents | 具有 Web UI 侧边栏、消息传递和中断功能的持久后台子代理 | |
| dsh-budget | DeepSeek Harness 的成本治理：预算、碳排和延迟集于一个面板。 | |
| dsh-checkpoint-rewind | Claude Code /rewind 等效功能：快照、会话分叉、一次性恢复 | |
| dsh-click | 面向 DeepSeek Harness 的跨平台原生桌面控制——Windows 优先。 | |
| dsh-composer-history | Web 编辑器的终端风格输入历史：方向键、Ctrl+R 搜索 | |
| dsh-data-quality | 数据集质量检查和引用交叉核对（此处消费的可选数值桥接） | |
| dsh-defend | 面向 DeepSeek Harness 的提示注入、越狱和密钥泄露防御。 | |
| dsh-doublecheck | 工程纪律守卫：需求拷问、测试门禁、对抗性审查 | |
| dsh-draw | 面向 DeepSeek Harness 的统一静态图像生成路由。 | |
| dsh-fast | 面向 DeepSeek Harness 的只读性能诊断。 | |
| dsh-fund-research | 面向中国公募基金的确定性研究报告 | |
| dsh-github | 面向 DSH 的 GitHub PR/issue 集成，每次写入均需审批 | |
| dsh-industry-research | 行业研究编排，通过本插件的 ctx.researchReport.assemble 封存其交付物 | |
| dsh-library | 面向 DeepSeek Harness 的本地文档知识库。 | |
| dsh-local-ai | 面向 DeepSeek Harness 的本地模型（Ollama）集成。 | |
| dsh-lsp-actions | 基于语言服务器的 LSP 诊断、格式化、补全、代码操作和重命名 | |
| dsh-mask | PII 脱敏中间件：在模型边界匿名化，在显示层恢复 | |
| dsh-mcp-panel | 只读 MCP 运行时面板：/mcp 命令 + 设置选项卡，含状态、工具和错误 | |
| dsh-memento | 审批门控的跨会话记忆：ctx.memory 接缝 + SQLite + 记忆工具 | |
| dsh-observe | 面向 DeepSeek Harness 的 OpenTelemetry 和 Langfuse 可观测性导出器。 | |
| dsh-output-styles | 与 Claude Code outputStyles 等效的运行时样式切换 | |
| dsh-reach | 多渠道审批/提问桥接：微信/Telegram/飞书，会话控制台 |
| dsh-permission-rules | Claude Code 风格的声明式 allow/deny/ask 权限规则，带审计 |
| dsh-personal-directive | 带顶栏开关的个人指令注入器（框架版） |
| dsh-plugin-guide | 作为按需智能体技能提供的插件开发知识库 | |
| dsh-plugin-doctor | 面向 DSH 插件的零依赖静态 + 沙箱冒烟检测器 | |
| dsh-research-report | 可验证的研究报告引擎：内容寻址的证据账本与密封版本 | |
| dsh-score | 面向 DeepSeek Harness 插件的多维度质量评分。 | |
| dsh-session-pin | 在 Web 侧边栏中固定会话，并保持持久排序 | |
| dsh-session-sync | DeepSeek Harness 的跨设备会话同步——你的会话存储的专用 git 镜像。 | |
| dsh-skill-pack-security | 安全审计技能包：密钥扫描、依赖与供应链审查 | |
| dsh-talk | DeepSeek Harness 的语音优先会话循环：对它说话，听它回答。 | |
| dsh-test-drive | 面向 DeepSeek Harness 插件的隔离安装与冒烟测试试驾。 | |
| dsh-ticktick | TickTick/滴答清单任务桥接：会话头部面板 + 11 个工具 |
| dsh-translate | 面向 DeepSeek Harness 的供应商参数转换与确定性 JSON 修复。 | |
| dsh-wechat | 微信 ↔ DSH 桥接（腾讯 iLink 机器人）：文本/图片/文件/语音，在聊天中审批 |
| dsh-autotier | 自动强/廉价模型层级路由，带确定性风险防护和 /tier 命令 | |
| dsh-catalog | PerryLink 系列的 DSH Desktop Market 标准目录源 | |
| dsh-cert-mcp | 暴露认证注册表的只读 MCP 服务器：等级、快照与五维证据 | |
| dsh-kit | 一键安装核心系列入门包 | |
| dsh-plugin-certification | 社区认证注册表，带有可复现检查的评级和徽章 | |
| dsh-plugin-kit | 用于 PerryLink DSH 插件的共享零运行时依赖工具包 | |
| dsh-plugin-portal | 零依赖静态门户，将整个插件系列渲染为单个页面 | |
| dsh-plugin-upgrade-015 | 合并了 0.1.3-alpha.1 → 0.1.5-rc.1 升级通道卡片以及零依赖接缝扫描器 | |
| dsh-team-rooms | 跨会话团队房间：共享消息总线、任务板和时间线 | |

从 DSH 桌面市场安装

所有 PerryLink 插件均可在内置的 DSH 桌面市场中浏览：市场 → 源 → 添加源 → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选择它。安装仍需通过市场的 npm 身份验证和您的确认。

许可证

Apache License 2.0 © 2026 dsh-claude-move 贡献者