PerryLink/dsh-session-sync
PerryLink/dsh-session-sync has 34 GitHub stars and 8 forks. GitHot measured 0 stars in 24 hours and +6 in 7 days. Last checked 2026-11-15 19:38 UTC. Last push 2026-11-04.
Crecimiento de estrellas medido
- in 24h
- 0
- in 7 days
- +6
- in 15 days
- Actualización retrasada
- in 1 month
- Actualización retrasada
Cambios netos en períodos que se solapan, no totales diarios. Los datos no disponibles se dejan en blanco. Las estrellas indican interés, no calidad.
Acerca de
Cross-device DeepSeek Harness session sync: a dedicated git mirror with append-only keep-both conflict resolution (fork files, never silently overwritten), /sync command and sync_* tools
Herramientas de desarrolloREADME-es.md
Original🔄 dsh-session-sync
- Canal 1024 store:
npm i -g dsh1024una vez, luegodsh1024 plugin --profile web add dsh-session-sync(cuenta para el ranking de instalaciones de deepseek1024.com).
Sincronización de sesiones entre dispositivos para DeepSeek Harness — un espejo git dedicado de tu almacén de sesiones.
Sincroniza tus sesiones entre dispositivos, conserva ambos lados ante cualquier conflicto, nunca pierdas un turno.
English · 简体中文 · Español · Português · हिन्दी
dsh plugin --profile <name> add dsh-session-sync
📖 Base de conocimiento del ecosistema — datos medidos, no marketing: guía de desarrollo · datos de selección · criterios de mantenimiento.
Instalación y desinstalación
- Canal git (último
main):dsh plugin --profile web add github:PerryLink/dsh-session-sync(equivalente a instalar desdegit+https://github.com/PerryLink/dsh-session-sync.git). Sin paso de compilación —index.mjsylib/son los artefactos publicados. - Canal npm (versiones publicadas):
dsh plugin --profile web add dsh-session-sync. - Canal tarball:
pnpm packen este repositorio, luegodsh plugin --profile web add ./dsh-session-sync-<version>.tgz. - Desinstalar:
dsh plugin --profile web remove dsh-session-sync(o elimina la fila del parche de perfil).
⭐ 如果它帮到了你
Este plugin forma parte de la familia de plugins DSH (más de 40, todos Apache-2.0). Si te resulta útil, dale una estrella: no desbloquea nada, pero ayuda a que la siguiente persona lo encuentre antes.
English: part of a 95 plugin family for DeepSeek Harness. If it is useful, a star helps the next person find it — nothing is gated behind it.
What is dsh-session-sync?
Sincronización de sesiones entre dispositivos para DeepSeek Harness — un espejo git dedicado de tu almacén de sesiones.
Sincroniza tus sesiones entre dispositivos, conserva ambos lados ante cualquier conflicto, nunca pierdas un turno.
Resumen del flujo: solicitud → política/revisión → veredicto. Los ejemplos siguientes usan la superficie de comandos real.
La misma ejecución, animada.
Compatibilidad
| Superficie | Estado |
|---|---|
| Harness | DeepSeek Harness dsh-v0.2.1-alpha.1 (tag de GitHub, verificado el 2026-09-25: cadena completa de puertas contra los peers 0.1.7-rc.2 fijados). Línea de dependencias npm 0.1.7-rc.2, peers `>=0.1.2-rc.1 <0.2.0 |
| Node | ^22.19.0 || >=24.0.0 |
| Plataformas | Cualquier lugar donde git y DSH se ejecuten (espejo basado en git; sin código específico de plataforma) |
| Modelo | Los modelos solo texto funcionan plenamente; no se requiere visión ni capacidad extra |
Qué obtienes
dsh-session-sync refleja tu almacén de sesiones de DSH en un árbol de trabajo git dedicado y lo sincroniza con un remoto que tú controlas — sin servicio en la nube, sin almacenamiento de terceros:
- Comando
/sync—status(rama, remoto saneado, delante/detrás, archivos sucios, forks),diff,log,pull,push,help. - Herramientas
sync_status/sync_pull/sync_push— la misma superficie para el modelo, dentro de un turno. - Resolución de conflictos append-only — los registros de sesión son append-only; ante cualquier divergencia el plugin conserva ambos lados (la versión local se conserva, la remota se preserva como archivos fork) y nunca sobrescribe en silencio. Las sesiones divergentes también pueden bifurcarse a nivel de sesión.
- Modos automáticos — pull al iniciar, push tras cada turno cerrado y pull periódico, todos configurables y reversibles.
- Escrituras con confirmación —
pull/pushpreguntan primero (medianteuserQuestionsoapproval); las superficies de solo lectura nunca preguntan; sin respondedor la operación falla cerrada.
dispositivo A remoto (tu repositorio git) dispositivo B
$DSH_HOME/sessions ──espejo──▶ commit ──push──▶ [sessions] ──pull──▶ merge (conservar ambos + fork)
Inicio rápido
dsh plugin --profile web add github:PerryLink/dsh-session-sync
# 1. instala el bundle en tu perfil
dsh plugin --profile web add github:PerryLink/dsh-session-sync
# o desde npm (versiones publicadas)
dsh plugin --profile web add dsh-session-sync
# 2. apúntalo a un remoto git privado y verifica la fila
dsh --profile web --dump-config | grep -A2 'id: session-sync'
Luego configura el remoto en tu parche de perfil (un repositorio privado es la base) y sincroniza:
- insert:
- id: session-sync
name: dsh-session-sync
config:
remote: [email protected]:you/your-dsh-sessions.git
> /sync status
> /sync pull
> /sync push
Ejemplos
Son los puntos de entrada reales; instala y llama a uno.
Ejemplo detallado
Comando
/sync help
Salida
sync: usage — /sync [status | pull | push | diff | log | help]
status show mirror state (default): branch, remote, ahead/behind, dirty, forks
pull fetch + merge remote changes (keep-both; confirms first)
push mirror + commit + push local changes (confirms first)
diff uncommitted changes + HEAD..remote stat (read-only)
log last commits in the sync repository
Observado en index.mjs:754-765 (registered /sync handler)
Rama de fallo
Entrada
/sync push
Salida
sync: cancelled: approval requires an open turn; /sync commands run between turns — mount userQuestions or set confirmVia: userQuestions
Observado en plugins/dsh-session-sync/lib/gate.mjs:134-137; plugins/dsh-session-sync/index.mjs:792-794; plugins/dsh-session-sync/test/gate.test.mjs:80-88; plugins/dsh-session-sync/README.md:246
Ejemplos breves
/sync diff/sync pull
Configuración
Todos los ajustes son campos de Config de Schemastery (modificables desde cordis.yml). Una sobrescritura dirigida por id reemplaza toda la fila — repite cada clave que necesites. cordis.patch.yml documenta cada clave en línea.
| Clave | Valor predeterminado | Significado |
|---|---|---|
enabled |
true |
Interruptor maestro; false desregistra el comando, las herramientas, los oyentes y los modos automáticos |
backend |
git |
Backend de sincronización: git (espejo en texto plano) o encrypted (contenido del espejo cifrado con age) |
sessionRoot |
'' |
Raíz del almacén de sesiones; vacío = $DSH_HOME/sessions (si faltan ambos, falla la carga) |
repoDir |
'' |
Raíz del árbol de trabajo; vacío = $DSH_HOME/dsh-session-sync/repo |
remote |
'' |
Dirección remota (requerida antes de pull/push; status/diff funcionan sin ella) |
branch |
main |
Nombre de la rama remota |
gitBin |
git |
Ruta del ejecutable git |
ageBin |
age |
Ruta del ejecutable age (se sondea con backend: encrypted; si falta, degrada a texto plano) |
ageRecipient |
'' |
Destinatario age (clave pública o cadena de identidad); vacío = no se puede cifrar, degrada a texto plano |
ageIdentity |
'' |
Ruta a una clave secreta age sin frase de paso (para descifrar); vacío = degrada a texto plano |
autoPullOnStart |
false |
Hace pull una vez al montar el plugin (la configuración es la concesión; sin reconfirmar) |
autoPushOnTurnEnd |
false |
Hace push tras cada turno cerrado |
pullIntervalMinutes |
0 |
Pull periódico cada N minutos (0 = apagado, máx. 10080) |
confirmVia |
auto |
Canal de confirmación: auto (primero userQuestions, luego approval), userQuestions, approval |
graceMs |
10000 |
Periodo de gracia para matar git (ms) |
commandTimeoutMs |
120000 |
Tiempo de espera por comando (ms) |
maxOutputBytes |
262144 |
Límite de salida recolectada por flujo (bytes) |
commitName |
dsh-session-sync |
Nombre del autor del commit |
commitEmail |
dsh-session-sync@localhost |
Correo del autor del commit |
registerCommand |
true |
Registra el comando /sync |
registerTools |
true |
Registra las herramientas sync_* cuando el servicio tools está presente |
Ejemplo de sobrescritura en tu parche de perfil:
- insert:
- id: session-sync
name: dsh-session-sync
config:
remote: [email protected]:you/your-dsh-sessions.git
branch: main
autoPushOnTurnEnd: true
pullIntervalMinutes: 30
confirmVia: userQuestions
Herramientas y superficies
| Superficie | Solo lectura | Requiere confirmación | Notas |
|---|---|---|---|
/sync status |
✅ | — | Rama, remoto saneado, delante/detrás, archivos sucios, archivos fork, último pull/push |
/sync diff |
✅ | — | Cambios sin commit + estadística HEAD..remote (solo lectura) |
/sync log |
✅ | — | Últimos commits del repositorio de sincronización |
/sync pull |
✅ | Fetch + merge con semántica de conservar ambos; lo local se conserva, lo remoto se preserva como forks | |
/sync push |
✅ | Espejo + commit + push; nunca fuerza push, reconcilia y reintenta una vez ante rechazo | |
sync_status |
✅ | — | Los mismos datos que /sync status para el modelo |
sync_pull |
✅ | Pull invocable por el modelo | |
sync_push |
✅ | Push invocable por el modelo |
Permisos y datos
- Permisos: las operaciones mutadoras cruzan la puerta de confirmación (
confirmVia); el plugin nunca reimplementa ni elude los serviciosuserQuestions/approvaldel harness. Los modos automáticos están cubiertos por la concesión de configuración y nunca reconfirman. - Datos: los metadatos de sincronización (id de dispositivo, último pull/push, última cabecera de push, último error) viven en el dominio de almacenamiento
session-sync. Los archivos de sesión se copian como bytes opacos — el plugin nunca los analiza. El id de dispositivo también se escribe endevice.txten el repositorio de sincronización para la atribución de forks entre dispositivos. - Registro de sesión:
sync/push,sync/pullysync/conflictestán declarados entypes.d.ts; se anexan solo cuando el host registra los tipos (ver Limitaciones conocidas). Todo lo escrito o mostrado se sanea. El único mensaje duradero que el plugin escribe —el aviso de fork por conflicto— lleva el source kind propio del plugin (producer-owned,dsh-session-sync); el harness retiró el kind compartidopluginy lo rechaza al releer una sesión.
Límites de seguridad
- Nunca sobrescribe en silencio. El merge de tres vías append-only conserva ambos lados ante cualquier divergencia; los archivos fork nunca se eliminan y git nunca fuerza push, resetea, rebase ni cambia de rama.
- Contención de rutas. Los archivos se reflejan como bytes opacos con enlaces simbólicos rechazados y cada ruta unida se comprueba por contención (
PATH_UNSAFEfalla alto). - Salida saneada. Las credenciales de URL remota, los tokens y los secretos
key=valuese redactan antes de llegar al modelo o al registro; la visualización de rutas rechaza todo lo que esté fuera de su raíz. - Sin almacenamiento de credenciales. El plugin no almacena credenciales; las credenciales de git viven en tu helper de credenciales normal. Las identidades/destinatarios age los gestionas tú, y las claves nunca entran en el repositorio de sincronización.
- Endurecimiento de git. git se ejecuta con
GIT_TERMINAL_PROMPT=0yGIT_OPTIONAL_LOCKS=0, acotado por plazo y señal, con un límite de salida por flujo. - Falla cerrada. La falta de respondedor de confirmación, de remoto o una ruta insegura rechaza la operación alto.
Cifrado y modelo de amenazas
backend: encrypted añade una capa age opcional sobre el espejo: los bytes de sesión se cifran en archivos encrypted/**/*.age antes de commitear y subir, y se descifran de vuelta al espejo local en texto plano antes de fusionar. La fusión a tres bandas siempre se ejecuta en texto plano localmente, por lo que la semántica append-only de conservar ambos lados no cambia.
Qué protege el cifrado:
- El contenido del espejo en reposo en el remoto. Los archivos de sesión que subes son texto cifrado age; el host remoto, sus operadores y cualquiera que clone el repositorio no ven los bytes de sesión en claro sin la clave privada.
Qué no protege (la frontera):
- Las claves e identidades age son tuyas. Los archivos de destinatario/identidad nunca son distribuidos, almacenados ni rotados por el plugin. Si una clave se filtra, el contenido del espejo que protege queda expuesto. Usa una identidad sin frase de contraseña y mantenla fuera del repositorio.
- El remoto sigue siendo en la práctica un repositorio privado. Los metadatos de git — mensajes de commit, el
.gitignore, la estructura de rutasencrypted/, los nombres de rama y la actividad de push/fetch — siguen siendo visibles para el host remoto. El cifrado oculta el contenido, no el hecho de que sincronizas, ni la forma de tu árbol de sesiones. - El texto plano sigue existiendo localmente. El espejo en
<repoDir>/sessions/es texto plano en disco; el cifrado protege la copia transmitida/remota, no el cifrado del disco local ni el almacén de sesiones en vivo. - La degradación elegante significa texto plano. Con
backend: encrypted, si faltaage, oageRecipient/ageIdentityestán vacíos, el plugin cae al camino git en texto plano y avisa explícitamente en el estado/registro — nunca finge cifrar. Revisa la advertencia en/sync statusantes de confiar en el remoto como cifrado.
Línea base: con backend: git (el predeterminado), los bytes de sesión se almacenan sin cifrar en tu remoto git — usa un repositorio privado.
Limitaciones conocidas
- El cifrado es opcional.
backend: encryptedañade una capa age (ver «Cifrado y modelo de amenazas» arriba); si faltaageo las claves, cae a texto plano con una advertencia explícita. Conbackend: git(el predeterminado), los bytes de sesión se almacenan sin cifrar en tu remoto git — usa un repositorio privado. - Se requiere git. El plugin necesita el ejecutable
gity el serviciosubprocess; sin ellos, las operaciones de sincronización fallan con un motivo claro (los perfiles siguen arrancando). - Eventos de sesión en
0.1.0-rc.6/0.1.0-rc.8/0.1.1-rc.2/0.1.2-alpha.2/0.1.2-alpha.3/0.1.2-rc.1/0.1.7-alpha.2. El harness aún no registra los tipossync/*, por lo que los anexos al registro de sesión se omiten (las sesiones siguen cargando); el plugin los habilita automáticamente una vez que un host registra los tipos o expone el envoltorioignorableenSession.append. approvalentre turnos./syncse ejecuta entre turnos, donde el canalapprovalno tiene un turno abierto al que adjuntarse; usaconfirmVia: userQuestionspara la sincronización por comando, o impulsa la sincronización mediante las herramientas dentro de un turno. La comprobación de turno abierto lee la proyección de sesiónturnBoundarydel host: una composición sin@deepseek-ai/dsh-session-projectionno puede verificar el estado del turno y falla en cerrado con ese motivo.- Los artefactos privados del host no se sincronizan.
session.lock(el arriendo de sesión del harness) y los archivos de stagingsession.migration.*.tmpnunca se reflejan ni se eliminan: son estado de ejecución, no contenido sincronizable. Los registros de sesión (session.jsonl,session.v[1-9]*.jsonl[.zstd]) siguen siendo la carga útil reflejada.
Desarrollo
pnpm install # node ^22.19 || >=24
pnpm run typecheck && pnpm run typecheck:ci # tsc --checkJs contra los peers 0.1.7-alpha.2 publicados
pnpm test # node --test (13 archivos de test; la suite git del motor se omite sin git)
pnpm run verify:self-contained # las specs de dependencias resuelven desde el registro
pnpm run verify:artifacts # archivos publicados presentes + index.mjs importable
pnpm run check:readmes # consistencia de los cinco README
pnpm pack # el tarball publicado
No hay paso de compilación: ESM puro, index.mjs y lib/ son los artefactos publicados.
Topics
dsh, dsh-plugin, deepseek-harness, deepseek, cordis, session-sync, session, git, sync, cross-device
Contribuyentes
- @PerryLink — creador y mantenedor: motor de espejo git, merge append-only conservando ambos, comando
/syncy herramientassync_*, modos automáticos, saneadores y documentación en cinco idiomas.
PerryLink DSH Plugin Family
Este proyecto forma parte de la familia de plugins de DeepSeek Harness de PerryLink. El registro permanece plegado abajo para que cada README conserve una primera pantalla corta; expándelo para ver cada fila y su estado.
Expandir todos los plugins
Licencia
LICENSE (Apache License 2.0) © 2026 dsh-session-sync contributors