🚚 dsh-claude-move

Migra Claude Code, Codex, OpenCode y Hermes a DeepSeek Harness — copia sesiones, memorias, habilidades, instrucciones y comandos de barra como sesiones DSH reanudables, solo-copia y con aprobación.

Conserva tu historial de Claude Code al cambiarte: una sola instalación, sesiones reanudables, sincronización en vivo con un Claude Code en marcha y un asistente de migración de cuatro fuentes.

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

Compatibilidad

Dirigido a dsh 0.1.1-rc.2 (perfil web); las dependencias peer requieren >=0.1.0-rc.8 <0.2.0. Node ^22.19 || >=24.
Última verificación con una instalación nueva desde tarball: escaneo real, importación por lotes real (reimportación idempotente), adjuntado al workspace y artefactos de persistencia confirmados; macOS/Linux cubiertos por la matriz de CI.

Matriz de compatibilidad (solo costuras públicas)

Superficie	Uso	Respaldo cuando falta
Servicios de host (`tools` / `sessionPersistence` / `workspaceRegistry` / `commands` / `systemPrompt` / `skills` / `webServer`)	obligatorio donde se indica	los servicios opcionales se registran reactivamente; la falta de `fs` falla en voz alta
`sessionPersistence.listSnapshots` / `readFrom` / `fs` con capacidad `streamText` / `ctx.jobs` / `ctx.agents.resume`	detectado por característica	`list()` / lectura de archivo completo con rechazo en voz alta / mapa de jobs propio / inyección de traspaso
Servicios de shell del cliente (`sessions.refresh/open`, `workspaces.refresh`)	detectado por característica al aplicar el panel	recarga completa de la página
Las capacidades de plataforma más nuevas nunca son requisitos estrictos — el plugin sigue arrancando en rc.8.

Qué obtienes

Auto-descubrimiento — claude_scan localiza la raíz de datos de Claude ($CLAUDE_CONFIG_DIR, con fallback a ~/.claude) e indexa cada proyecto/sesión, memoria, habilidad, CLAUDE.md global y settings.json, con caché incremental y escaneo paralelo (scanConcurrency).
Importación con fidelidad total — import_claude convierte las transcripciones en sesiones DSH balanceadas y reanudables (turn/start → step/start → user/message → assistant/message → tool/call → tool/result → step/end → turn/end), repara llamadas a herramientas interrumpidas e importa por streaming en trozos las transcripciones mayores que maxTranscriptBytes.
Un solo workspace claudecode — cada sesión importada cae en un workspace dedicado (por defecto $DSH_HOME/claudecode); workspaceMode: 'per-project' restaura la agrupación de un workspace por proyecto.
Solo-copia e incremental — nada se mueve, reescribe ni elimina en ninguno de los dos lados; reejecutar solo añade los turnos nuevos (force: true guarda una copia completa adicional con un id nuevo).
Contexto personal, siempre fresco — las memorias se inyectan como una sección de prompt en vivo, las habilidades de Claude se registran como habilidades DSH reales (globales + a nivel de proyecto), y el CLAUDE.md global + de proyecto se inyecta temprano.
Asistente de migración de cuatro fuentes — /move más move_detect / move_preview / move_run migran Claude Code, Codex, OpenCode y Hermes, con aprobación e idempotencia (move.json).
Panel web y comandos — /claude-import-all, /resume-claude, /claude-move-reset y un panel de migración flotante.

Asistente de migración de cuatro fuentes

/move              # asistente de un solo paso: detectar → previsualizar → ejecutar → informar (las cuatro fuentes)
move_detect        # escanea Claude Code / Codex / OpenCode / Hermes
move_preview       # plan por ítem: new | unchanged | changed | conflict (con diff) | unsupported
move_run           # ejecuta tras la puerta de aprobación; resolución de conflictos:
                   #   skip | overwrite | rename | merge  (por defecto skip — nunca adivina)

Fuentes — Claude Code (~/.claude), Codex (~/.codex), OpenCode (raíces de datos + config), Hermes (raíces de skills/memoria); cada fuente tiene su propio parser + mapper.
Mapeo — memorias/instrucciones → secciones gestionadas solo-anexables en el AGENTS.md global de DSH (una sección marcada por ítem); skills → skills DSH reales (los paquetes SKILL.md se copian tal cual, otros formatos se convierten); comandos de barra → comandos DSH registrados (reconstruidos desde move.json tras un reinicio); sesiones → sesiones DSH reanudables (los mismos importadores que la fase 1).
Idempotente — cada plan aplicado se registra en $DSH_HOME/claude-move/move.json (digest / targetDigest / appliedAt); las reejecuciones omiten los ítems sin cambios y force los vuelve a aplicar.
Con aprobación — una ejecución que escribiría algo pregunta primero a ctx.approval; cualquier cosa distinta de allowed-once significa cero escrituras.

Inicio rápido

# 1. instala el bundle en tu perfil
dsh plugin --profile web add "github:PerryLink/dsh-claude-move#master"

# o desde npm (versiones publicadas)
dsh plugin --profile web add dsh-claude-move

# 2. reinicia y verifica la fila
dsh --profile web --dump-config | grep -A4 'id: claude-move'

Luego, en cualquier sesión DSH, ejecuta un comando:

/claude-import-all      # escanea → copia cada sesión de Claude → informa

No es necesario reiniciar DSH después de importar — refresca la página web abierta una vez y haz clic en cualquier sesión importada para continuar.

Instalación y desinstalación

Canal git (último master): dsh plugin --profile web add "github:PerryLink/dsh-claude-move#master" — ESM puro, sin paso de prepare ni allowBuilds.
Canal npm (versiones publicadas): dsh plugin --profile web add dsh-claude-move.
Canal tarball: npm pack en este repo y luego dsh plugin --profile web add ./dsh-claude-move-<version>.tgz.
Desinstalación: elimina la fila claude-move de los bundles del perfil y reinicia dsh. Las sesiones importadas permanecen en el directorio de datos de DSH; el plugin solo escribe su caché ($DSH_HOME/claude-move/) y la carpeta del workspace claudecode, y nunca toca los datos fuente de Claude.

Qué se migra

~/.claude (solo lectura)
 ├─ projects/*/*.jsonl  ──→  sesiones DSH reanudables, agrupadas en un workspace "claudecode" (por defecto)
 ├─ projects/*/memory/  ──→  sección de memoria del system-prompt en vivo (se relee por petición)
 ├─ skills/**           ──→  skills DSH reales
 └─ CLAUDE.md + settings ──→  sección de prompt temprana + sugerencias de configuración (nunca se auto-aplican)

En Claude Code	Llega a DSH como
Transcripciones de sesión (`projects//.jsonl`)	Sesiones DSH balanceadas y reanudables — mapeo con fidelidad total de `user`/`assistant`/`tool`/`thinking` con reparación de llamadas a herramientas interrumpidas — agrupadas en un workspace `claudecode` o una por proyecto
Archivos de memoria (`projects//memory/.md`)	Una sección de contexto del system-prompt en vivo, releída en cada petición (`feedback > project > reference > user`)
Skills (`~/.claude/skills/**`)	Skills DSH reales (nombres kebab-case, sufijos de colisión, máximo 30 por defecto; `README.md`/`MEMORY.md` y archivos sin descripción se omiten)
`CLAUDE.md` (global + por proyecto)	Una sección de prompt temprana; gana el archivo del proyecto
`settings.json`	Sugerencias de configuración DSH con una lista explícita de claves no mapeables
Estado del proyecto (directorio, rama git y conteo de cambios)	Se muestra en el índice de escaneo, las insignias del panel web y el traspaso de `/resume-claude`

Uso

Llama a las herramientas en cualquier sesión con el plugin montado:

claude_scan                          # escaneo completo (caché incremental)
claude_scan { path: "~/.claude/projects/<slug>" }   # escaneo parcial
claude_scan { refresh: true }        # omite la caché, reescanea todo
claude_scan { projectsLimit: 10, sessionsLimit: 5, fields: "brief" }  # recorta la salida

import_claude { path: "~/.claude/projects/<slug>/<sessionId>.jsonl" }  # una sesión
import_claude { path: "~/.claude/projects" }        # directorio (recursivo)
import_claude { path: "all" }                       # todo
# Reejecuta en cualquier momento: los archivos sin cambios se omiten, las transcripciones crecidas solo añaden los turnos nuevos.
# Los archivos mayores que maxTranscriptBytes se importan por streaming en trozos (sin techo de memoria).
import_claude { path: "...", force: true }          # copia completa nueva (se conserva la copia anterior)

Comandos (activados por el usuario, sin turno del modelo):

/claude-import-all                # un solo paso: escanear → importar todo → informar → inyectar en la sesión actual
/resume-claude latest             # continúa la sesión de Claude más reciente
/resume-claude <sessionId>        # por id de sesión fuente o id import-<src>
/resume-claude <keyword>          # coincide con títulos; varias coincidencias se listan, nunca se adivina
/claude-move-reset                # reinicia la caché del plugin (marcadores + mapa de importación); las sesiones importadas se conservan

Panel web: un panel de migración flotante con el árbol de proyectos/sesiones, insignias de estado (no importado / importado / importado-con-turnos-nuevos / fuente ausente / directorio ausente / git sucio), filtro por palabra clave, renderizado paginado, "Importar y continuar" + "Abrir sesión" + "Refrescar lista de sesiones" por sesión, importación por lotes con barra de progreso en vivo y cancelar, y un botón de reinicio de caché. Los textos siguen el idioma del navegador (zh/en). Servido a través de las rutas JSON /api/claude-move/* propias del plugin en la costura pública ctx.webServer.

Después de importar

No necesitas reiniciar DSH. Las importaciones aterrizan de forma duradera a través del servicio público sessionPersistence en el momento en que se completan:

Las listas del lado del servidor (RPCs session.list / workspace.list, la CLI, cualquier carga de página nueva) muestran las sesiones importadas bajo el workspace claudecode de inmediato.
El panel refresca por sí mismo la lista de sesiones de la página ya abierta y ofrece un botón Abrir sesión por cada sesión importada.
Las sesiones importadas pueden abrirse, leerse y reanudarse de inmediato — /resume-claude, o haz clic en la sesión de la lista. Reejecutar la importación en cualquier momento sincroniza solo los turnos nuevos en las mismas sesiones.

Configuración

Todo opcional, anulable en cordis.yml.

Clave	Por defecto	Significado
`claudeHome`	`$CLAUDE_CONFIG_DIR` o `~/.claude`	Raíz de datos de Claude
`workspaceMode`	`claudecode`	`claudecode` (un workspace dedicado) · `per-project` (un workspace por cwd fuente)
`claudecodeDir`	`$DSH_HOME/claudecode`	La carpeta del workspace `claudecode` (la única carpeta que el plugin crea)
`scanGit`	`true`	Nivel de sondeo de git: `true` (completo) · `'branch'` (cero llamadas a git) · `false`
`gitTimeoutMs`	`5000`	Timeout del subproceso de git
`scanConcurrency`	`8`	Límite de escaneo paralelo de proyectos
`maxTranscriptBytes`	`67108864`	Umbral de importación por streaming (troceado por encima)
`excludeProjects`	`[]`	Subcadenas de slug a omitir
`enableMemory`	`true`	Inyecta memorias como una sección de prompt en vivo
`memoryMaxBytes`	`8192`	Límite de la sección de memoria
`memoryScope`	`current-project`	`current-project` · `all` (el proyecto actual primero)
`enableSkills`	`true`	Registra habilidades de Claude como habilidades DSH
`maxSkills`	`30`	Límite de cantidad de habilidades
`extraSkillDirs`	`[]`	Directorios de habilidades adicionales
`enableInstructions`	`true`	Inyecta `CLAUDE.md` global + de proyecto
`resumeMaxChars`	`2048`	Límite de caracteres del resumen de traspaso
`resumeMode`	`inject`	`inject` (resumen de traspaso) · `agents` (ctx.agents.resume)
`enableWebPanel`	`true`	Registra las rutas del panel `/api/claude-move/*`
`importConcurrency`	`4`	Lectura + conversión en paralelo por lote
`requireApproval`	`true`	Las escrituras del asistente preguntan `ctx.approval` (solo allowed-once)
`codexHome`	`$CODEX_HOME` o `~/.codex`	Raíz de datos de Codex
`opencodeDataHome`	dir de datos XDG de la plataforma/opencode	Raíz de datos de OpenCode
`opencodeConfigHome`	dir de config XDG de la plataforma/opencode	Raíz de config de OpenCode
`hermesHome`	`$HERMES_HOME` o `~/.hermes`	Raíz de datos de Hermes
`skillsDir`	`$DSH_HOME/skills`	Destino de habilidades del asistente
`agentsMdPath`	`$DSH_HOME/AGENTS.md`	Destino de memoria/instrucciones del asistente
`moveWorkspaceMode`	`per-source`	Agrupación de workspace para importaciones del asistente: `per-source` · `single`

Herramientas y superficies

Superficie	Tipo	Notas
`claude_scan`	herramienta	Índice estructurado de proyectos/sesiones/memorias/habilidades/ajustes
`import_claude`	herramienta	Importa una sesión, un directorio o `all` (incremental; `force` para una copia nueva)
`move_detect` / `move_preview` / `move_run`	herramientas	Asistente de cuatro fuentes: escanear, plan por ítem con diffs, ejecutar tras la aprobación
`/claude-import-all`	comando	Escanea → importa todo → informa
`/resume-claude`	comando	Continúa una sesión de Claude (latest, id o palabra clave)
`/claude-move-reset`	comando	Reinicia la caché del plugin (las sesiones importadas se conservan)
`/move`	comando	Asistente de cuatro fuentes de un solo paso
Panel web de migración	cliente	Panel flotante con progreso, cancelación, paginación, abrir sesión

Permisos y datos

Permisos: el manifiesto del workshop declara filesystem:read y filesystem:write.
Lee ~/.claude (transcripciones, memorias, habilidades, CLAUDE.md, settings.json) — estrictamente de solo lectura — y los directorios de proyecto a los que importa.
Escribe logs de sesión DSH a través del servicio público sessionPersistence (solo create + append, nunca elimina/reescribe/archiva), registros del workspace-registry, su caché bajo $DSH_HOME/claude-move/ y la carpeta del workspace claudecode.
Nunca modifica archivos fuente de Claude, toca datos de otras aplicaciones ni accede a la red. No se leen ni transmiten credenciales.

Límites de seguridad

Los archivos fuente son de solo lectura; los logs DSH son solo-append (solo create + append).
Las transcripciones externas son entrada no confiable — nada en ellas se ejecuta; el contenido system/developer/thinking nunca entra en el traspaso de reanudación.
Solo servicios públicos — sessionPersistence / workspaceRegistry / tools / commands / systemPrompt / skills / webServer; sin cambios en el motor ni en la UI.
Los secretos se informan solo por posición (file:line:kind); los registros permission/permission-mode/queue-operation se cuentan, no se importan.
Las escrituras del asistente van con aprobación — cualquier cosa distinta de allowed-once significa cero escrituras.

Limitaciones conocidas

Los títulos provienen de custom-title/ai-title/primer prompt; los registros summary de Claude se informan pero no se mapean a nodos de compactación DSH (sintetizar una transacción de compactación válida fabricaría su rango de seq y su mensaje de checkpoint).
Los bloques thinking se conservan como contenido reasoning, pero nunca entran en el traspaso de reanudación.
Las llamadas a herramientas interrumpidas se reparan con un resultado de error sintético (nunca se descartan), informado como repaired.synthesized.
Los registros de clase de permisos se cuentan, no se importan; las sugerencias de permisos predefinidos DSH se generan en los informes.
En hosts sin una superficie de streaming fs.streamText, las transcripciones mayores que maxTranscriptBytes fallan en voz alta en lugar de importar parcialmente.
En workspaceMode: 'per-project', las sesiones cuyo directorio fuente fue eliminado aún se importan, pero el adjuntado al workspace falla (quedan sin agrupar; workspace.attached: false más un reason). El workspace claudecode por defecto no depende del directorio fuente.
Si una transcripción fue truncada o reiniciada en el lugar (menos turnos que la importación registrada), la reimportación la omite e informa sourceShrunk; usa force: true para una copia completa nueva.
El panel web es un panel flotante sin build dirigido por las propias rutas JSON del plugin; no usa el sistema de slots de UI interno del shell.

Experiencia del modelo

La superficie visible para el modelo son las descripciones/esquemas de las dos herramientas y sus salidas: claude_scan devuelve el índice estructurado, import_claude devuelve resúmenes por archivo con posiciones de las advertencias. Los resultados de las herramientas se registran a su vez como eventos tool/result, de modo que todo es reconstruible.
No hay texto oculto visible para el modelo; las secciones de memoria/CLAUDE.md se registran en ctx.systemPrompt (ensamblado de prompt, reconstruible desde el log de sesión).

Solución de problemas

Fila sin efecto: dsh --profile <p> --dump-config debería imprimir # == dsh-claude-move; vuelve a ejecutar dsh plugin --profile <p> add ....
La web arranca pero se cuelga en silencio: los perfiles nuevos inicializados por dsh plugin add contienen solo dsh-base — añade @deepseek-ai/dsh-web-app a dsh.profile.bundles. Instalar en el perfil web existente no necesita nada.
Rutas del panel 404: se sirven solo cuando enableWebPanel: true y hay un servidor web compuesto; revisa el log de arranque en busca de fibers FAILED.
La importación falla con "transcript 过大": sube maxTranscriptBytes o importa ese archivo individualmente.
La importación tuvo éxito pero la barra lateral no muestra ninguna sesión nueva: la página ya estaba abierta — haz clic una vez en el botón de refrescar del panel (o recarga la página). Nunca es necesario reiniciar DSH.
Logs: los fallos de arranque se imprimen en la consola de dsh; el plugin registra errores con prefijo [claude-move] para problemas de workspace/mapa de importación.

Atribución (componentes de código abierto)

Este proyecto está licenciado bajo la Apache License 2.0; los siguientes componentes con licencia MIT conservan sus propias licencias (texto completo en THIRD_PARTY_NOTICES.md):

Núcleo de conversión vendored de Nwflower/dsh-chat-import (MIT).
Convenciones de descubrimiento y modelo de seguridad de Demogorgon314/dsh-resume-plugin (MIT).
Patrones de inyección de memoria/skills y análisis de frontmatter de YYTbit/dsh-plugin-claude-bridge (MIT).

Desarrollo

npm install   # peer deps: @deepseek-ai/dsh-tools@>=0.1.0-rc.8, @deepseek-ai/cordis, schemastery
npm test      # node --test test/*.test.mjs

CI ejecuta la suite completa en Node 22 en Linux/macOS/Windows a través de GitHub Actions (test.yml).

Temas

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

Contribuidores

@PerryLink — creador y mantenedor: el pipeline de importación, el asistente de migración de cuatro fuentes, el panel web, la documentación, CI/CD y releases.
@OLDnana1 — análisis de causa raíz de la corrupción de llamadas a herramientas interrumpidas que hacía que las sesiones importadas devolvieran permanentemente HTTP 400 al reanudar.
@GooodWei — identificó que README.md (y cualquier .md sin descripción) se registraba mal como habilidad, lo que rompía la carga de habilidades de DSH.

Familia de plugins DSH de PerryLink

Este proyecto es uno de los plugins de DeepSeek Harness mantenidos por PerryLink. Si este te ayuda, es probable que los demás también lo hagan:

Plugin	Una línea
dsh-mcp-panel	Panel de runtime MCP de solo lectura: comando /mcp + pestaña Settings con estado, herramientas y errores
dsh-doublecheck	Guardia de disciplina de ingeniería: interrogatorio de requisitos, puertas de prueba, revisión de adversario
dsh-background-agents	Agentes hijos en segundo plano duraderos con una barra lateral de Web UI, mensajería e interrupción
dsh-lsp-actions	Diagnósticos LSP, formato, completado, acciones de código y renombrado sobre language servers
dsh-output-styles	Cambio de estilo en runtime equivalente a outputStyles de Claude Code
dsh-checkpoint-rewind	Equivalente a /rewind de Claude Code: snapshots, forks de sesión, restauración de un solo paso
dsh-permission-rules	Reglas de permisos declarativas allow/deny/ask estilo Claude Code con auditoría
dsh-auto-review	Auto-revisión de segundo modelo en la cadena de aprobación, fail-closed por defecto
dsh-memento	Memoria entre sesiones con aprobación: costura ctx.memory + SQLite + herramienta de memoria
dsh-skill-pack-security	Pack de skills de auditoría de seguridad: escaneo de secretos, revisión de dependencias y cadena de suministro
dsh-session-pin	Fija sesiones en la barra lateral web con orden duradero
dsh-composer-history	Historial de entrada estilo terminal para el composer web: flechas, búsqueda Ctrl+R
dsh-github	Integración de PR/issues de GitHub para DSH, cada escritura gated por aprobación
dsh-plugin-guide	Base de conocimiento de desarrollo de plugins como skill de agente bajo demanda
dsh-claude-move	Migra sesiones, memoria, skills y CLAUDE.md de Claude Code a DSH

Navigation Menu

🚚 dsh-claude-move

Compatibilidad

Matriz de compatibilidad (solo costuras públicas)

Qué obtienes

Asistente de migración de cuatro fuentes

Inicio rápido

Instalación y desinstalación

Qué se migra

Uso

Después de importar

Configuración

Herramientas y superficies

Permisos y datos

Límites de seguridad

Limitaciones conocidas

Experiencia del modelo

Solución de problemas

Atribución (componentes de código abierto)

Desarrollo

Temas

Contribuidores

Familia de plugins DSH de PerryLink

Licencia

FilesExpand file tree

README.es.md

Latest commit

History

README.es.md

File metadata and controls

🚚 dsh-claude-move

Compatibilidad

Matriz de compatibilidad (solo costuras públicas)

Qué obtienes

Asistente de migración de cuatro fuentes

Inicio rápido

Instalación y desinstalación

Qué se migra

Uso

Después de importar

Configuración

Herramientas y superficies

Permisos y datos

Límites de seguridad

Limitaciones conocidas

Experiencia del modelo

Solución de problemas

Atribución (componentes de código abierto)

Desarrollo

Temas

Contribuidores

Familia de plugins DSH de PerryLink

Licencia