dsh-session-sync 0.2.32 → 0.2.33

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.pt.md ADDED
@@ -0,0 +1,430 @@
1
+ <div align="center">
2
+
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-session-sync-hero-en-dark.webp">
5
+ <img src="docs/assets/dsh-session-sync-hero-en-light.webp" width="100%" alt="dsh-session-sync: dois dispositivos copiam $DSH_HOME/sessions como bytes opacos para um worktree git e sincronizam com um remoto próprio; o pull faz um merge de três vias por arquivo que mantém os dois lados (a versão remota como arquivo fork) e nunca faz force-push.">
6
+ </picture>
7
+
8
+ # dsh-session-sync
9
+
10
+ **Transforme seu armazenamento de sessões em um repositório git que você controla — sincronize entre dispositivos, mantenha os dois lados em qualquer conflito e nunca perca um turno.**
11
+
12
+ Um plugin de sincronização puramente host-side para DeepSeek Harness: os arquivos de sessão são copiados como bytes opacos, a divergência é resolvida por um merge de três vias append-only e o remoto é seu (git em texto plano por padrão, criptografia age opcional) — sem serviço na nuvem, sem armazenamento de terceiros.
13
+
14
+ [Instalar](#instalação-em-três-passos) · [Configuração](#configuração) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
15
+
16
+ [![License](https://img.shields.io/badge/license-Apache--2.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
17
+ [![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.1.2%20%3C0.3.0-4B67B4?style=flat-square&labelColor=2B3245)](#compatibilidade)
18
+ [![npm](https://img.shields.io/npm/v/dsh-session-sync?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-session-sync)
19
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-session-sync/ci.yml?branch=main&label=CI&style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-session-sync/actions/workflows/ci.yml)
20
+ [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24.9-339933?style=flat-square&labelColor=2B3245)](#compatibilidade)
21
+
22
+ [![Stars](https://img.shields.io/github/stars/PerryLink/dsh-session-sync?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-session-sync/stargazers)
23
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-session-sync?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-session-sync)
24
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-session-sync?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-session-sync?ref=badge)
25
+ [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-session-sync/badge)](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-session-sync)
26
+ [![DSH Market](https://img.shields.io/badge/DSH_Market-listed-4B67B4?style=flat-square&labelColor=2B3245)](https://dsh.market/)
27
+ [![Gitee](https://img.shields.io/badge/Gitee-mirror-C71D23?style=flat-square&labelColor=2B3245&logo=gitee)](https://gitee.com/perrylink/dsh-session-sync)
28
+
29
+ ```sh
30
+ dsh plugin --profile <name> add dsh-session-sync
31
+ ```
32
+
33
+ </div>
34
+
35
+ <sub>Plugin da comunidade, não afiliado à DeepSeek. Este é o único repositório oficial, mantido por PerryLink; repositórios com o mesmo nome em outras contas não são afiliados. O Gitee é um espelho.</sub>
36
+
37
+ ## O que é
38
+
39
+ O `dsh-session-sync` espelha o armazenamento de sessões do DSH (`$DSH_HOME/sessions`) em um worktree git dedicado e o sincroniza com um remoto que **você** controla: sem serviço na nuvem, sem armazenamento de terceiros. Os arquivos de sessão são copiados como bytes opacos — o plugin nunca analisa JSONL/zstd, porque a codificação física pertence ao harness; o trabalho dele é mover esses bytes, mesclar históricos append-only e relatar o estado. Diante de qualquer divergência ele executa um merge de três vias append-only: **os dois lados são mantidos**, a versão remota é preservada como arquivos fork e nada é sobrescrito em silêncio. `backend: git` (o padrão) é um espelho em texto plano; `backend: encrypted` adiciona uma camada age por cima; todos os modos automáticos são configuráveis e reversíveis.
40
+
41
+ <p align="center">
42
+ <picture>
43
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-session-sync-flow-v5-dark.svg">
44
+ <img src="docs/assets/dsh-session-sync-flow-v5-light.svg" width="100%" alt="Estrutura do dsh-session-sync: o dispositivo A espelha os bytes e confirma $DSH_HOME/sessions, e o push cruza o portão de confirmação até o seu remoto git; o dispositivo B faz fetch, executa um merge de três vias por arquivo (base/ours/theirs) e restaura as sessões localmente, mantendo os bytes remotos divergentes como arquivos fork no caminho original; arquivos fork nunca são apagados nem sobrescritos.">
45
+ </picture>
46
+ </p>
47
+
48
+ ## Instalação em três passos
49
+
50
+ 1. **Instale** (escolha um canal):
51
+
52
+ ```sh
53
+ # canal git (último main; equivalente a git+https://github.com/PerryLink/dsh-session-sync.git)
54
+ dsh plugin --profile web add github:PerryLink/dsh-session-sync
55
+ # canal npm (versões publicadas)
56
+ dsh plugin --profile web add dsh-session-sync
57
+ # canal tarball: pnpm pack neste repo e depois
58
+ dsh plugin --profile web add ./dsh-session-sync-<version>.tgz
59
+ ```
60
+
61
+ Sem etapa de build: `index.mjs` e `lib/` são os artefatos enviados.
62
+
63
+ 2. **Configuração mínima** (aponte para um remoto git **privado** no seu profile patch):
64
+
65
+ ```yaml
66
+ - insert:
67
+ - id: session-sync
68
+ name: dsh-session-sync
69
+ config:
70
+ remote: git@github.com:you/your-dsh-sessions.git
71
+ ```
72
+
73
+ 3. **Verifique que ele monta**:
74
+
75
+ ```sh
76
+ dsh --profile web --dump-config | grep -A2 'id: session-sync'
77
+ ```
78
+
79
+ ```
80
+ > /sync status
81
+ > /sync pull
82
+ > /sync push
83
+ ```
84
+
85
+ **Desinstalar**: `dsh plugin --profile web remove dsh-session-sync` (ou remova a linha do profile patch).
86
+
87
+ ## Capacidades principais
88
+
89
+ O `dsh-session-sync` transforma o armazenamento de sessões em um espelho git versionado no host e entrega a ação de sincronização ao seu remoto:
90
+
91
+ - **Comando `/sync`** — `status` (branch, remoto higienizado, à frente/atrás, arquivos sujos, arquivos fork), `diff`, `log`, `pull`, `push`, `help`.
92
+ - **Ferramentas `sync_status` / `sync_pull` / `sync_push`** — a mesma superfície para o modelo, dentro de um turno.
93
+ - **Resolução de conflitos append-only** — os registros de sessão são append-only; diante de qualquer divergência o plugin mantém **os dois** lados (a versão local é mantida, a remota é preservada como arquivos fork) e nunca sobrescreve em silêncio. Sessões divergentes também podem bifurcar no nível da sessão.
94
+ - **Modos automáticos** — pull ao iniciar, push após cada turno fechado e pull periódico, tudo configurável e reversível.
95
+ - **Escritas com porta de confirmação** — `pull`/`push` perguntam primeiro (via `userQuestions` ou `approval`); superfícies somente leitura nunca perguntam; sem respondedor a operação falha fechada.
96
+
97
+ ```text
98
+ dispositivo A remoto (seu repositório git) dispositivo B
99
+ $DSH_HOME/sessions ──espelho──▶ commit ──push──▶ [sessions] ──pull──▶ merge (manter ambos + fork)
100
+ ```
101
+
102
+ ### Comandos e ferramentas
103
+
104
+ | Superfície | Somente leitura | Requer confirmação | Notas |
105
+ |---|---|---|---|
106
+ | `/sync status` | ✅ | — | Branch, remoto higienizado, à frente/atrás, arquivos sujos, arquivos fork, último pull/push |
107
+ | `/sync diff` | ✅ | — | Alterações não commitadas + estatística `HEAD..remote` (somente leitura) |
108
+ | `/sync log` | ✅ | — | Últimos commits do repositório de sincronização |
109
+ | `/sync pull` | | ✅ | Fetch + merge com semântica de manter ambos; o local é mantido, o remoto é preservado como forks |
110
+ | `/sync push` | | ✅ | Espelho + commit + push; nunca força push, reconcilia e tenta de novo uma vez em caso de rejeição |
111
+ | `sync_status` | ✅ | — | Os mesmos fatos de `/sync status` para o modelo |
112
+ | `sync_pull` | | ✅ | Pull invocável pelo modelo |
113
+ | `sync_push` | | ✅ | Push invocável pelo modelo |
114
+
115
+ ### Exemplos
116
+
117
+ Estes são os pontos de entrada reais do plugin; instale uma vez e chame um deles.
118
+
119
+ **Exemplo detalhado** — comando `/sync help`:
120
+
121
+ ```text
122
+ sync: usage — /sync [status | pull | push | diff | log | help]
123
+ status show mirror state (default): branch, remote, ahead/behind, dirty, forks
124
+ pull fetch + merge remote changes (keep-both; confirms first)
125
+ push mirror + commit + push local changes (confirms first)
126
+ diff uncommitted changes + HEAD..remote stat (read-only)
127
+ log last commits in the sync repository
128
+ ```
129
+
130
+ *Observed from `index.mjs:754-765 (registered /sync handler)`*
131
+
132
+ **Ramo de falha** — entrada `/sync push`:
133
+
134
+ ```text
135
+ sync: cancelled: approval requires an open turn; /sync commands run between turns — mount userQuestions or set confirmVia: userQuestions
136
+ ```
137
+
138
+ *Observed from `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`*
139
+
140
+ **Exemplos curtos**: `/sync diff` · `/sync pull`
141
+
142
+ ## Configuração
143
+
144
+ Todos os ajustes são campos `Config` do Schemastery (alteráveis a partir do cordis.yml). Uma sobreposição direcionada por id substitui a linha inteira — repita todas as chaves necessárias. O `cordis.patch.yml` documenta cada chave em linha.
145
+
146
+ Chaves mais usadas:
147
+
148
+ | Chave | Padrão | Significado |
149
+ |---|---|---|
150
+ | `remote` | `''` | Endereço do remoto (obrigatório antes de pull/push; status/diff funcionam sem ele) |
151
+ | `backend` | `git` | Backend de sincronização: `git` (espelho em texto plano) ou `encrypted` (conteúdo do espelho criptografado com age) |
152
+ | `sessionRoot` | `''` | Raiz do armazenamento de sessões; vazio = `$DSH_HOME/sessions` (faltando ambas, a carga falha) |
153
+ | `repoDir` | `''` | Raiz do worktree de sincronização; vazio = `$DSH_HOME/dsh-session-sync/repo` |
154
+ | `branch` | `main` | Nome do branch remoto |
155
+ | `autoPushOnTurnEnd` | `false` | Push após cada turno fechado |
156
+ | `pullIntervalMinutes` | `0` | Pull periódico a cada N minutos (`0` = desligado, máximo `10080`) |
157
+ | `confirmVia` | `auto` | Canal de confirmação: `auto` (userQuestions primeiro, depois approval), `userQuestions`, `approval` |
158
+
159
+ <details>
160
+ <summary>Tabela de configuração completa (21 chaves)</summary>
161
+
162
+ | Chave | Padrão | Significado |
163
+ |---|---|---|
164
+ | `enabled` | `true` | Interruptor mestre; `false` desregistra o comando, as ferramentas, os listeners e os modos automáticos |
165
+ | `backend` | `git` | Backend de sincronização: `git` (espelho em texto plano) ou `encrypted` (conteúdo do espelho criptografado com age) |
166
+ | `sessionRoot` | `''` | Raiz do armazenamento de sessões; vazio = `$DSH_HOME/sessions` (faltando ambas, a carga falha) |
167
+ | `repoDir` | `''` | Raiz do worktree de sincronização; vazio = `$DSH_HOME/dsh-session-sync/repo` |
168
+ | `remote` | `''` | Endereço do remoto (obrigatório antes de pull/push; status/diff funcionam sem ele) |
169
+ | `branch` | `main` | Nome do branch remoto |
170
+ | `gitBin` | `git` | Caminho do executável git |
171
+ | `ageBin` | `age` | Caminho do executável age (sondado com `backend: encrypted`; se faltar, degrada para texto plano) |
172
+ | `ageRecipient` | `''` | Destinatário age (chave pública ou string de identidade); vazio = não consegue criptografar, degrada para texto plano |
173
+ | `ageIdentity` | `''` | Caminho de uma chave secreta age sem frase de senha para descriptografar; vazio = não consegue descriptografar, degrada para texto plano |
174
+ | `autoPullOnStart` | `false` | Pull uma vez ao montar o plugin (a configuração é a autorização; sem reconfirmação) |
175
+ | `autoPushOnTurnEnd` | `false` | Push após cada turno fechado |
176
+ | `pullIntervalMinutes` | `0` | Pull periódico a cada N minutos (`0` = desligado, máximo `10080`) |
177
+ | `confirmVia` | `auto` | Canal de confirmação: `auto` (userQuestions primeiro, depois approval), `userQuestions`, `approval` |
178
+ | `graceMs` | `10000` | Período de carência para matar o git (ms) |
179
+ | `commandTimeoutMs` | `120000` | Timeout por comando (ms) |
180
+ | `maxOutputBytes` | `262144` | Teto de saída coletada por fluxo (bytes) |
181
+ | `commitName` | `dsh-session-sync` | Nome do autor do commit |
182
+ | `commitEmail` | `dsh-session-sync@localhost` | E-mail do autor do commit |
183
+ | `registerCommand` | `true` | Registra o comando `/sync` |
184
+ | `registerTools` | `true` | Registra as ferramentas `sync_*` quando o serviço tools está presente |
185
+
186
+ </details>
187
+
188
+ Exemplo de sobreposição no seu profile patch:
189
+
190
+ ```yaml
191
+ - insert:
192
+ - id: session-sync
193
+ name: dsh-session-sync
194
+ config:
195
+ remote: git@github.com:you/your-dsh-sessions.git
196
+ branch: main
197
+ autoPushOnTurnEnd: true
198
+ pullIntervalMinutes: 30
199
+ confirmVia: userQuestions
200
+ ```
201
+
202
+ ## FAQ
203
+
204
+ <details>
205
+ <summary>Onde os dados realmente ficam? Algo é enviado para a nuvem?</summary>
206
+
207
+ Não há serviço na nuvem nem armazenamento de terceiros. Duas cópias ficam na sua máquina: `$DSH_HOME/sessions` (o armazenamento de sessões do harness) e o worktree `repoDir` que você configurar (padrão `$DSH_HOME/dsh-session-sync/repo`); o remoto é **seu próprio** repositório git. `backend: encrypted` só transforma a cópia enviada/remota em texto cifrado age — o espelho local continua em texto plano.
208
+
209
+ </details>
210
+
211
+ <details>
212
+ <summary>Um conflito pode sobrescrever ou perder uma sessão?</summary>
213
+
214
+ Nada é sobrescrito em silêncio. Os registros de sessão são append-only e o merge de três vias mantém os dois lados diante de qualquer divergência: a versão local é mantida e a remota é preservada como arquivo fork chamado `<basename>.remote-fork-<carimbo UTC de 14 dígitos>-<device8>`; arquivos fork nunca são apagados nem sobrescritos, e o git nunca força push, reseta, faz rebase ou troca de branch. Uma sessão divergente também bifurca no nível da sessão, com um aviso persistente injetado na filha.
215
+
216
+ </details>
217
+
218
+ <details>
219
+ <summary>A criptografia vem ativada por padrão? O que acontece se o age faltar?</summary>
220
+
221
+ Não — o padrão é `backend: git`, então os bytes de sessão ficam sem criptografia no seu remoto: use um repositório privado. `backend: encrypted` precisa de `age` e de `ageRecipient`/`ageIdentity` não vazios; se faltar algo, o plugin avisa explicitamente e cai para git em texto plano — nunca finge criptografar. Verifique o aviso em `/sync status` antes de confiar no remoto como criptografado.
222
+
223
+ </details>
224
+
225
+ <details>
226
+ <summary>O que acontece sem git ou sem respondedor de confirmação?</summary>
227
+
228
+ Sem o executável `git` ou o serviço `subprocess`, as operações de sincronização falham com um motivo claro (os perfis continuam iniciando). O `/sync` roda entre turnos, onde o canal `approval` não tem um turno aberto ao qual se anexar: use `confirmVia: userQuestions`, ou conduza a sincronização pelas ferramentas `sync_*` dentro de um turno; sem nenhum respondedor a operação falha fechada.
229
+
230
+ </details>
231
+
232
+ <details>
233
+ <summary>Qual é a sobrecarga? Os modos automáticos rodam para sempre?</summary>
234
+
235
+ Os arquivos de sessão são copiados como bytes opacos e nunca analisados; cada comando git tem timeout, carência de término e teto de saída por fluxo. O push automático vem desligado, o pull periódico vem desligado (`pullIntervalMinutes: 0`) e o pull ao iniciar vem desligado — uma vez ativados, ficam cobertos pela autorização de configuração e não reconfirmam. O custo depende do tamanho do armazenamento de sessões e da latência do remoto; este repositório não tem dados de benchmark, então não damos números inventados.
236
+
237
+ </details>
238
+
239
+ ## Limites de segurança
240
+
241
+ - **Nunca sobrescreve em silêncio.** O merge de três vias append-only mantém os dois lados diante de qualquer divergência, incluindo delete/modify (os bytes modificados são mantidos, a intenção de exclusão é respeitada); arquivos fork nunca são apagados e o git nunca força push, reseta, faz rebase ou troca de branch.
242
+ - **Contenção de caminhos.** Os arquivos são espelhados como bytes opacos com links simbólicos recusados e cada caminho unido é verificado por contenção (`PATH_UNSAFE` falha alto).
243
+ - **Saída higienizada.** Credenciais de URL remota, tokens e segredos `key=value` são redigidos antes de chegar ao modelo ou ao log; a exibição de caminhos recusa tudo fora da sua raiz.
244
+ - **Sem armazenamento de credenciais.** O plugin não armazena credenciais; as credenciais git ficam no seu helper de credenciais normal. As identidades/destinatários age são gerenciados por você, e as chaves nunca entram no repositório de sincronização.
245
+ - **Endurecimento do git.** O git roda com `GIT_TERMINAL_PROMPT=0` e `GIT_OPTIONAL_LOCKS=0`, limitado por prazo e sinal, com teto de saída por fluxo.
246
+ - **Falha fechada.** A falta de respondedor de confirmação, de remoto ou um caminho inseguro recusa a operação alto.
247
+
248
+ ## Permissões e dados
249
+
250
+ - **Permissões**: operações que mudam estado cruzam a porta de confirmação (`confirmVia`); o plugin nunca reimplementa nem contorna os serviços `userQuestions`/`approval` do harness. Os modos automáticos são cobertos pela autorização de configuração e nunca reconfirmam.
251
+ - **Dados**: os metadados de sincronização (id do dispositivo, último pull/push, última cabeça de push, último erro) vivem no domínio de armazenamento `session-sync`. Os arquivos de sessão são copiados como bytes opacos — o plugin nunca os analisa. O id do dispositivo também é gravado em `device.txt` no repositório de sincronização para atribuição de forks entre dispositivos.
252
+ - **Log de sessão**: `sync/push`, `sync/pull` e `sync/conflict` são declarados em `types.d.ts`; só são anexados quando o host registra os tipos (ver Limitações conhecidas). Tudo o que é escrito ou exibido passa por higienização. A única mensagem durável que o plugin escreve — o aviso de fork por conflito — carrega o source kind próprio do plugin (producer-owned, `dsh-session-sync`); o harness aposentou o kind compartilhado `plugin` e o recusa ao reler uma sessão.
253
+
254
+ ## Criptografia e modelo de ameaças
255
+
256
+ `backend: encrypted` adiciona uma camada **age** opcional sobre o espelho: os bytes de sessão são criptografados em arquivos `encrypted/**/*.age` antes de serem commitados e enviados, e descriptografados de volta ao espelho local em texto plano antes da mesclagem. O merge de três vias sempre roda em texto plano localmente, então a semântica append-only de manter ambos não muda.
257
+
258
+ O que a criptografia **protege**:
259
+
260
+ - **O conteúdo do espelho em repouso no remoto.** Os arquivos de sessão que você envia são texto cifrado age; o host remoto, seus operadores e qualquer pessoa que clone o repositório não veem os bytes de sessão em claro sem a chave privada.
261
+
262
+ O que ela **não** protege (a fronteira):
263
+
264
+ - **As chaves e identidades age são suas.** Os arquivos de destinatário/identidade nunca são distribuídos, armazenados ou rotacionados pelo plugin. Se uma chave vazar, o conteúdo do espelho que ela protege fica exposto. Use uma identidade sem frase de senha e mantenha-a fora do repositório.
265
+ - **O remoto continua sendo, na prática, um repositório privado.** Metadados do git — mensagens de commit, o `.gitignore`, a estrutura de caminhos `encrypted/`, nomes de branch e a atividade de push/fetch — continuam visíveis para o host remoto. A criptografia esconde o *conteúdo*, não o fato de você sincronizar, nem a forma da sua árvore de sessões.
266
+ - **O texto plano ainda existe localmente.** O espelho em `<repoDir>/sessions/` é texto plano no disco; a criptografia protege a cópia transmitida/remota, não a criptografia do disco local nem o armazenamento de sessões em uso.
267
+ - **Degradação graciosa significa texto plano.** Com `backend: encrypted`, se o `age` faltar, ou `ageRecipient`/`ageIdentity` estiverem vazios, o plugin cai para o caminho git em texto plano **e avisa explicitamente** no status/log — nunca finge criptografar. Verifique o aviso em `/sync status` antes de confiar no remoto como criptografado.
268
+
269
+ Linha de base: com `backend: git` (o padrão), os bytes de sessão são armazenados sem criptografia no **seu** remoto git — use um repositório privado.
270
+
271
+ ## Limitações conhecidas
272
+
273
+ - **A criptografia é opcional e o age é uma dependência externa.** `backend: encrypted` adiciona uma camada age (ver «Criptografia e modelo de ameaças» acima); se o `age` faltar ou `ageRecipient`/`ageIdentity` estiverem vazios, avisa explicitamente e cai para texto plano, e uma identidade protegida por frase de senha não pode ser usada (a descriptografia bloquearia num prompt TTY, então falha fechada). Com `backend: git` (o padrão), os bytes de sessão são armazenados sem criptografia no **seu** remoto git — use um repositório privado.
274
+ - **`object-storage` é uma interface reservada.** É um marcador de posição de interface e falha alto ao carregar; só `git` e `encrypted` estão implementados.
275
+ - **Requer git.** O plugin precisa do executável `git` e do serviço `subprocess`; sem eles, as operações de sincronização falham com um motivo claro (os perfis continuam iniciando).
276
+ - **Um `repoDir` por backend.** Trocar entre `git` e `encrypted` no mesmo `repoDir` não é suportado; use um worktree novo por backend.
277
+ - **Eventos de sessão em `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`.** O harness não registra os tipos `sync/*`, então os anexos ao log de sessão são pulados (as sessões continuam carregando); o plugin os habilita automaticamente quando um host registra os tipos ou expõe o envelope `ignorable` em `Session.append`.
278
+ - **`approval` entre turnos.** O `/sync` roda entre turnos, onde o canal `approval` não tem um turno aberto ao qual se anexar; use `confirmVia: userQuestions` para sincronização por comando, ou conduza a sincronização pelas ferramentas dentro de um turno. A verificação de turno aberto lê a projeção de sessão `turnBoundary` do host: uma composição sem `@deepseek-ai/dsh-session-projection` não consegue verificar o estado do turno e falha fechada com esse motivo.
279
+ - **Artefatos privados do host não são sincronizados.** `session.lock` (o lease de sessão do harness) e os arquivos de staging `session.migration.*.tmp` nunca são espelhados nem apagados: são estado de execução, não conteúdo sincronizável. Os logs de sessão (`session.jsonl`, `session.v[1-9]*.jsonl[.zstd]`) continuam sendo a carga útil espelhada.
280
+
281
+ ## Compatibilidade
282
+
283
+ | Superfície | Estado |
284
+ |---|---|
285
+ | Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1` (tag do GitHub, verificado em 2026-09-25: cadeia completa de portas contra os peers fixados `0.1.7-rc.2`). Linha de dependência npm `0.1.7-rc.2`, peers `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0`. (adaptado em 2026-10-04): o aviso de fork por conflito carrega o source kind próprio do plugin (producer-owned) — o harness aposentou o kind compartilhado `plugin` e o recusa ao reler. |
286
+ | Node | `^22.19.0 \|\| >=24.9.0` |
287
+ | Plataformas | Onde quer que `git` e DSH rodem (espelho baseado em git; sem código específico de plataforma) |
288
+ | Modelo | Modelos apenas de texto totalmente suportados; nenhuma visão ou capacidade extra de modelo é necessária |
289
+
290
+ ## Ecossistema e qualidade
291
+
292
+ - [Espelho no Gitee](https://gitee.com/perrylink/dsh-session-sync) (espelho sincronizado; o GitHub é canônico)
293
+ - [Página do dshfind](https://dshfind.com/plugins/PerryLink/dsh-session-sync) (instalações e ranking)
294
+ - [Relatório do OpenSSF Scorecard](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-session-sync) (movido por [.github/workflows/scorecard.yml](.github/workflows/scorecard.yml))
295
+ - [Relatório de verificação do dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章) (selo histórico de verificação K10–K13)
296
+ - [DSH Market](https://dsh.market/) (listado)
297
+ - **Canal da loja 1024**: rode `npm i -g dsh1024` uma vez e depois `dsh1024 plugin --profile web add dsh-session-sync` (conta para o ranking de instalações do [deepseek1024.com](https://deepseek1024.com))
298
+ - [Base de conhecimento do ecossistema](https://perrylink.github.io/dsh-plugin-guide/): guia de desenvolvimento de plugins · dados medidos de seleção · critérios de manutenção
299
+
300
+ ## Desenvolvimento
301
+
302
+ ```sh
303
+ pnpm install # node ^22.19 || >=24.9
304
+ pnpm run typecheck && pnpm run typecheck:ci # tsc --checkJs: face do checkout + face da linha publicada
305
+ pnpm test # node --test (14 arquivos de teste; a suíte git do motor é pulada sem git)
306
+ pnpm run verify:self-contained # as specs de dependências resolvem a partir do registry
307
+ pnpm run verify:artifacts # arquivos enviados presentes + index.mjs importável
308
+ pnpm run check:readmes # consistência dos README em cinco idiomas
309
+ pnpm pack # o tarball publicado
310
+ ```
311
+
312
+ Sem etapa de build: ESM puro, `index.mjs` e `lib/` são os artefatos enviados. As imagens do README são geradas programaticamente por [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Python + Pillow) e podem ser reexecutadas com segurança.
313
+
314
+ Topics: `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `session-sync`, `session`, `git`, `sync`, `cross-device`
315
+
316
+ ## Família e agradecimentos
317
+
318
+ Este projeto faz parte da família de plugins de DeepSeek Harness da [PerryLink](https://github.com/PerryLink) (todos Apache-2.0). Se ele for útil, **uma estrela ajuda a próxima pessoa a encontrá-lo** — nada fica bloqueado atrás dela.
319
+
320
+ - [@BlakrPander](https://github.com/BlakrPander) — redação de PAT-como-usuário e a análise delete/modify de manter ambos (#14); as duas partes saíram em 0.2.27/0.2.28.
321
+ - [@PerryLink](https://github.com/PerryLink) — criador e mantenedor: motor de espelho git, merge append-only de manter ambos, comando `/sync` e ferramentas `sync_*`, modos automáticos, higienizadores e a documentação em cinco idiomas.
322
+
323
+ <details>
324
+ <summary>Expandir todos os plugins</summary>
325
+
326
+ | Plugin | Estado |
327
+ |---|---|
328
+ | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
329
+ | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
330
+ | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
331
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 CONGELADO — ver o README do repo |
332
+ | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
333
+ | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
334
+ | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 CONGELADO — ver o README do repo |
335
+ | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
336
+ | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
337
+ | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
338
+ | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
339
+ | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
340
+ | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 CONGELADO — ver o README do repo |
341
+ | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
342
+ | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
343
+ | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
344
+ | **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
345
+ | **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
346
+ | **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
347
+ | **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
348
+ | **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
349
+ | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
350
+ | **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
351
+ | **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
352
+ | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
353
+ | **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
354
+ | **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
355
+ | **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
356
+ | **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
357
+ | **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
358
+ | **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
359
+ | **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
360
+ | **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
361
+ | **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
362
+ | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
363
+ | **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
364
+ | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
365
+ | **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
366
+ | **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
367
+ | **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
368
+ | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
369
+ | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
370
+ | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
371
+ | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
372
+ | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
373
+ | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 CONGELADO — ver o README do repo |
374
+ | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
375
+ | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
376
+ | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
377
+ | **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
378
+ | **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
379
+ | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
380
+ | **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
381
+ | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
382
+ | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
383
+ | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
384
+ | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
385
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 APOSENTADO (repo arquivado) |
386
+ | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
387
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 APOSENTADO (repo arquivado) |
388
+ | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 APOSENTADO (repo arquivado) |
389
+ | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
390
+ | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
391
+ | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
392
+ | **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
393
+ | **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
394
+ | **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
395
+ | **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
396
+ | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
397
+ | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
398
+ | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
399
+ | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
400
+ | **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 CONGELADO — ver o README do repo |
401
+ | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
402
+ | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
403
+ | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
404
+ | **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
405
+ | **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
406
+ | **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
407
+ | **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
408
+ | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
409
+ | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
410
+ | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
411
+ | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
412
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 APOSENTADO (repo arquivado) |
413
+ | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
414
+ | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
415
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 CONGELADO — ver o README do repo |
416
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 CONGELADO — ver o README do repo |
417
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 CONGELADO — ver o README do repo |
418
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 CONGELADO — ver o README do repo |
419
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 CONGELADO — ver o README do repo |
420
+ | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 APOSENTADO (repo arquivado) |
421
+ | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 APOSENTADO (repo arquivado) |
422
+ | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 APOSENTADO (repo arquivado) |
423
+
424
+ </details>
425
+
426
+ ## Licença
427
+
428
+ [LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-session-sync contributors
429
+
430
+ <p align="center"><sub>Apache-2.0 · Plugin da comunidade, não afiliado à DeepSeek.</sub></p>
package/index.mjs CHANGED
@@ -396,7 +396,17 @@ export function makeSyncStatusTool(engine, readMeta) {
396
396
  const status = await engine.status()
397
397
  try {
398
398
  const meta = await readMeta()
399
- return { ...status, lastPullAt: meta.lastPullAt, lastPushAt: meta.lastPushAt, lastError: meta.lastError }
399
+ // 只合并有值的键:把 undefined 展开进工具结果会让宿主按
400
+ // “value is not lossless JSON” 拒绝整个 sync_status 结果(#29)。
401
+ const extra = {}
402
+ if (meta.lastPullAt !== undefined) extra.lastPullAt = meta.lastPullAt
403
+ if (meta.lastPushAt !== undefined) extra.lastPushAt = meta.lastPushAt
404
+ if (meta.lastError !== undefined) extra.lastError = meta.lastError
405
+ const out = { ...status, ...extra }
406
+ // 工具结果必须是 lossless JSON:collectStatus 的 head/remoteHead/error
407
+ // 在空仓库或未配置远端时是 undefined,展开后会让宿主拒绝整个结果。
408
+ for (const key of Object.keys(out)) if (out[key] === undefined) delete out[key]
409
+ return out
400
410
  } catch {
401
411
  return status
402
412
  }
@@ -621,6 +631,8 @@ export function apply(ctx, config = {}) {
621
631
  try {
622
632
  const current = await ensureMeta()
623
633
  const next = { ...current, ...patch }
634
+ // `undefined` 表示删除该键(清空 lastError),而不是写入一个非 JSON 值。
635
+ for (const key of Object.keys(patch)) if (patch[key] === undefined) delete next[key]
624
636
  const table = await tablePromise
625
637
  await table.put(STATE_KEY, next)
626
638
  metaCache = next
package/lib/constants.mjs CHANGED
@@ -84,9 +84,12 @@ export const FORK_NAME_RE = /\.remote-fork-\d{14}-[0-9a-z]{8}(?:\.|$)/iu
84
84
  // 名称来源(session-persistence-jsonl):
85
85
  // - lease.ts:40 LEASE_FILENAME = 'session.lock'(flock 租约;仅会话打开期间存在)
86
86
  // - generation.ts:725 `session.migration.<token><suffix>.tmp`(迁移暂存,失败自清)
87
+ // - 原子写暂存:`.l2s.<payload>.<hash>.tmp<seq>.<seq>`(宿主写入会话文件时的临时
88
+ // 文件;完成即 rename 或删除,同名内容还会被反复重写)。它让工作树长期处于
89
+ // stat-dirty 状态,git merge 会因此走 autostash 并失败(#29)。
87
90
  // 注意:`session.jsonl` / `session.v<N>.jsonl[.zstd]`(session-format/filename.ts 的
88
91
  // sessionFormatLogFilename + format.ts 的 logSuffix)是**同步载荷**,不在此列。
89
- export const HOST_ARTIFACT_NAME_RE = /^(?:session\.lock|session\.migration\..+\.tmp)$/u
92
+ export const HOST_ARTIFACT_NAME_RE = /^(?:session\.lock|session\.migration\..+\.tmp|\.l2s\..+)$/u
90
93
 
91
94
  // 默认值(Config schema 的默认与 DEFAULT_* 常量同源;cordis.yml 可整体覆盖)。
92
95
  export const DEFAULTS = Object.freeze({
package/lib/engine.mjs CHANGED
@@ -144,7 +144,7 @@ export class SyncEngine {
144
144
  await this.#deps.git.push({ signal: opts.signal })
145
145
  }
146
146
  const head = await this.#deps.git.headSha()
147
- this.#deps.reportMeta({ lastPushAt: Date.now(), lastPushHead: head })
147
+ this.#deps.reportMeta({ lastPushAt: Date.now(), lastPushHead: head, lastError: undefined })
148
148
  this.#deps.logger.info(`sync push ok: head ${head ?? ''} (${mirror.mirrored} mirrored, ${mirror.deleted} deleted)`)
149
149
  return {
150
150
  ok: true,
@@ -172,7 +172,11 @@ export class SyncEngine {
172
172
  await fs.mkdir(this.#deps.repoDir, { recursive: true })
173
173
  await this.#deps.git.bootstrap()
174
174
  await this.#mirrorAndCommit('dsh-session-sync: local checkpoint before pull')
175
- return await this.#pullInternal(opts)
175
+ const result = await this.#pullInternal(opts)
176
+ // 成功的拉取清掉上一次的 lastError:它曾经永久保留,让用户按几天前的
177
+ // push 错误排查当前问题(#29)。
178
+ if (result.ok) this.#deps.reportMeta({ lastError: undefined })
179
+ return result
176
180
  } catch (error) {
177
181
  return this.#fail(error)
178
182
  }
@@ -205,6 +209,9 @@ export class SyncEngine {
205
209
  this.#deps.reportMeta({ lastPullAt: Date.now() })
206
210
  return { ok: true, pulled: false, forks: [], adopted: 0, appended: 0, diverged: 0 }
207
211
  }
212
+ // 先清掉 stat-dirty:宿主原子写暂存文件会让 git 误判工作树有未提交改动,
213
+ // 从而在 merge 时走 autostash 并失败(#29)。
214
+ await this.#deps.git.refreshIndex()
208
215
  const merged = await this.#deps.git.beginMerge(remoteHead)
209
216
  if (!merged.inProgress) {
210
217
  this.#deps.reportMeta({ lastPullAt: Date.now() })
package/lib/git.mjs CHANGED
@@ -35,6 +35,7 @@ export const ALLOWED_VERBS = new Set([
35
35
  'ls-files',
36
36
  'ls-tree',
37
37
  'update-ref',
38
+ 'update-index',
38
39
  'status',
39
40
  ])
40
41
 
@@ -57,6 +58,10 @@ export function assertSafe(args) {
57
58
  if (verb === 'merge' && !(args.includes('--no-commit') || args.includes('--abort'))) {
58
59
  throw gitFailed('assert', 'git merge is only allowed with --no-commit or --abort')
59
60
  }
61
+ if (verb === 'update-index' && !(args.length === 3 && args[1] === '-q' && args[2] === '--refresh')) {
62
+ // 只允许刷新 stat 缓存;绝不接受 --add/--remove/--force-remove 等改索引内容的旗标。
63
+ throw gitFailed('assert', 'git update-index is only allowed as `-q --refresh`')
64
+ }
60
65
  if (verb === 'commit' && args.includes('--amend')) {
61
66
  throw gitFailed('assert', 'git commit --amend is forbidden (history is append-only)')
62
67
  }
@@ -269,6 +274,18 @@ export class GitBackend {
269
274
  throw gitFailed('fetch', redactText(stderr).trim().split('\n').slice(-3).join(' | ') || `exit ${result.code}`)
270
275
  }
271
276
 
277
+ /**
278
+ * 刷新索引里的 stat 信息(不改变内容)。宿主的原子写暂存文件会让工作树长期
279
+ * 处于 stat-dirty 状态:`git diff-files` 有输出但内容没变,`git merge` 因此
280
+ * 走 autostash,而 `git stash create` 在没有真实改动时输出为空,git 直接以
281
+ * `fatal: stash failed` 中止(#29)。合并前刷新一次即可把这类“假脏”清掉。
282
+ * 退出码非零(仍有真实改动)被忽略——调用方已先做过本地提交。
283
+ * @returns {Promise<void>}
284
+ */
285
+ async refreshIndex() {
286
+ await this.#maybe(['update-index', '-q', '--refresh'])
287
+ }
288
+
272
289
  /**
273
290
  * 开始合并:git merge --no-commit --allow-unrelated-histories <remoteHead>。
274
291
  * 干净自动合并退出 0(变更已暂存,待 commit --no-edit 落合并提交);
@@ -287,7 +304,14 @@ export class GitBackend {
287
304
  return { conflicted: false, inProgress: true }
288
305
  }
289
306
  const inProgress = await this.mergeInProgress()
290
- return { conflicted: inProgress, inProgress }
307
+ if (!inProgress) {
308
+ // 退出非零且没有 MERGE_HEAD:合并根本没有开始(例如 autostash 失败、
309
+ // 未跟踪文件将被覆盖)。旧代码把它当成 “already up to date”,pull 于是
310
+ // 静默成功、lastError 不更新,仓库却永远合不上(#29)。
311
+ const tail = redactText(String(result.stderr ?? '')).trim().split('\n').slice(-3).join(' | ') || `exit ${result.code}`
312
+ throw gitFailed('merge', tail)
313
+ }
314
+ return { conflicted: true, inProgress: true }
291
315
  }
292
316
 
293
317
  /** 是否存在进行中的合并(MERGE_HEAD)。 */
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "dsh-session-sync",
3
3
  "description": "Cross-device sync for DeepSeek Harness sessions: a dedicated git mirror of the session store, append-only three-way merge with keep-both + fork conflict resolution, /sync command, sync_pull/sync_push/sync_status tools, and configurable auto push/pull",
4
- "version": "0.2.32",
4
+ "version": "0.2.33",
5
5
  "repository": {
6
6
  "type": "git",
7
7
  "url": "git+https://github.com/PerryLink/dsh-session-sync.git"