dsh-xlock 0.2.9 → 0.2.10

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.md CHANGED
@@ -1,4 +1,4 @@
1
- ***REMOVED*** dsh-xlock — 跨机会话粘锁与修复插件
1
+ # dsh-xlock — 跨机会话粘锁与修复插件
2
2
 
3
3
  DeepSeek Harness(DSH)插件,在**多机 Syncthing 同步** `~/.dsh/sessions` 的场景下提供三层能力:
4
4
 
@@ -6,13 +6,13 @@ DeepSeek Harness(DSH)插件,在**多机 Syncthing 同步** `~/.dsh/session
6
6
  2. **修复层**:写打开前的工程化门禁——zstd 帧走查、torn JSONL 末行自动修复(原字节留证)、Syncthing 冲突副本识别/隔离/分叉证据导出,全程不依赖大模型。
7
7
  3. **会话跨机状态层**:创建归属(`.dsh-xlock-origin.json`)、归档(`.dsh-xlock-archive.json`)与归档集双向对账,浏览器侧栏圆环 / 圆点 / 会话菜单解锁 / 会话集合刷新。
8
8
 
9
- ***REMOVED******REMOVED*** 为什么需要
9
+ ## 为什么需要
10
10
 
11
11
  - DSH 的写租约在 Windows 上是**本机命名信号量**(`Local\dsh-session-lock-<hash>`),对异机无效。
12
12
  - resume 未闭合的会话会立即写合成 closer(step/end + turn/end)——两机先后打开即双写分叉。
13
13
  - Syncthing 冲突副本(`session.v4.jsonl.sync-conflict-<日期>-<时间>-<设备短ID>.zstd`)对 DSH 是隐形文件,不会被加载也不会被清理。
14
14
 
15
- ***REMOVED******REMOVED*** 工作原理
15
+ ## 工作原理
16
16
 
17
17
  宿主半 `index.js` 启动时对 `sessionPersistence` 服务做**实例级**方法包装(`open`/`create`/`stat`),不重 provide、不改原型。写打开(`access='write'`)按序执行:
18
18
 
@@ -24,7 +24,7 @@ DeepSeek Harness(DSH)插件,在**多机 Syncthing 同步** `~/.dsh/session
24
24
 
25
25
  `machineId` 存 `%LOCALAPPDATA%\dsh-xlock\machineId.json`(同步面之外,机器绑定;host 不匹配自动重生成防克隆)。
26
26
 
27
- ***REMOVED******REMOVED*** 创建归属
27
+ ## 创建归属
28
28
 
29
29
  锁标记记的是**最后持有者**,归属另走三源,逐级降级:
30
30
 
@@ -38,7 +38,7 @@ DeepSeek Harness(DSH)插件,在**多机 Syncthing 同步** `~/.dsh/session
38
38
 
39
39
  `machines.json` 两个区并存:`machines`(每机 `host` / `syncthing` / `cwds`)与 `devices`(短 ID → 机器名)。`cwds` 由各机 apply 自动学习、**只增不改**,内容没变不写盘;写回同步面上的**源码包** `~/.dsh/dsh-plugins/dsh-xlock/machines.json`(`DSH_XLOCK_REGISTRY` 可覆盖)。输出:`xlock status` 给异机创建的会话加 `created-remote(<host>)`;`xlock audit` 多一行创建归属与依据。
40
40
 
41
- ***REMOVED******REMOVED*** 归档标记(`.dsh-xlock-archive.json`)
41
+ ## 归档标记(`.dsh-xlock-archive.json`)
42
42
 
43
43
  平台把归档存在 `~/.dsh/storages/workspace.json`(不在同步面),而会话目录本身同步,故归档状态落成贴身标记随会话目录同步。
44
44
 
@@ -46,12 +46,12 @@ DeepSeek Harness(DSH)插件,在**多机 Syncthing 同步** `~/.dsh/session
46
46
  - **同步器**(`core/archivesync.mjs`,`archiveSyncRoute` 默认开):写侧监听 `workspace` 的 `domain/changed` 落标记;读侧轮询标记文件,用 `workspaceRegistry.archiveSession` / `unarchiveSession` 收敛。只处理相对上轮真变化的 id、盘上已是目标值不重写。
47
47
  - 归档与锁无因果关系;归档标记的冲突副本单列 `archiveConflicts×N`,不计入粘锁争抢,也不产生 `other×N` 噪音。
48
48
 
49
- ***REMOVED******REMOVED*** 浏览器 UI
49
+ ## 浏览器 UI
50
50
 
51
51
  client 半(`client.js`)读宿主半只读路由,全部自绘,无第三方图标依赖:
52
52
 
53
- - **对端活跃度圆环**(slot `sidebar.session.row.leading`,id `xlock-remote`):只对异机持锁(`held-foreign`)画——**实线脉动**(`***REMOVED***f0883e`,2px,1.6s 呼吸)= 对端真在写(日志在 `sessionActiveMs` 窗口内,或 `turn/start` 未闭合);**虚线灰淡**(`***REMOVED***8b949e`,2px,`opacity .6`)= 只剩残锁。`prefers-reduced-motion` 下关掉呼吸动画,形状仍可辨。
54
- - **创建归属圆点**(同槽,id `xlock-origin`):8px 圆点 `***REMOVED***58a6ff`;有创建记录为实线、只靠桶名反推为点线;异机持锁时让路。
53
+ - **对端活跃度圆环**(slot `sidebar.session.row.leading`,id `xlock-remote`):只对异机持锁(`held-foreign`)画——**实线脉动**(`#f0883e`,2px,1.6s 呼吸)= 对端真在写(日志在 `sessionActiveMs` 窗口内,或 `turn/start` 未闭合);**虚线灰淡**(`#8b949e`,2px,`opacity .6`)= 只剩残锁。`prefers-reduced-motion` 下关掉呼吸动画,形状仍可辨。
54
+ - **创建归属圆点**(同槽,id `xlock-origin`):8px 圆点 `#58a6ff`;有创建记录为实线、只靠桶名反推为点线;异机持锁时让路。
55
55
  - **会话菜单「解除跨机锁(主机名)」**(`ctx.contextMenus.register({target:'session'})`,id `xlock.unlock`,`danger:true`):仅对 `held-foreign` 产出,点击走 `POST /dsh-xlock/session-state/reset`,只删锁标记、不改归档并立刻复查。
56
56
  - **会话集合变化检测**(`GET /dsh-xlock/session-ids`,15 秒):磁盘全量 id 集合变了就让平台重拉基线。
57
57
 
@@ -59,24 +59,24 @@ client 半(`client.js`)读宿主半只读路由,全部自绘,无第三
59
59
 
60
60
  UI 与 CLI 的 reset 同语义、都是**显式使用者动作**:插件不自行判断对端是否已停写,必须由人确认后再点解锁。
61
61
 
62
- ***REMOVED******REMOVED*** CLI
62
+ ## CLI
63
63
 
64
64
  ```powershell
65
- dsh-xlock.ps1 audit <session|all> ***REMOVED*** 审计(只读,不改任何文件)
66
- dsh-xlock.ps1 resolve <session> --keep primary ***REMOVED*** 裁决冲突:以主文件为准(副本隔离 + 分叉证据导出)
67
- dsh-xlock.ps1 resolve <session> --keep copy ***REMOVED*** 裁决冲突:以副本为准(副本换正,先修 torn 末行)
68
- dsh-xlock.ps1 reset <session> ***REMOVED*** 跨机逃生门:删粘锁标记与标记冲突副本
69
- dsh-xlock.ps1 status ***REMOVED*** 全局状态总览
70
- dsh-xlock.ps1 gc ***REMOVED*** 隔离区过期清理(也可配启动自动)
65
+ dsh-xlock.ps1 audit <session|all> # 审计(只读,不改任何文件)
66
+ dsh-xlock.ps1 resolve <session> --keep primary # 裁决冲突:以主文件为准(副本隔离 + 分叉证据导出)
67
+ dsh-xlock.ps1 resolve <session> --keep copy # 裁决冲突:以副本为准(副本换正,先修 torn 末行)
68
+ dsh-xlock.ps1 reset <session> # 跨机逃生门:删粘锁标记与标记冲突副本
69
+ dsh-xlock.ps1 status # 全局状态总览
70
+ dsh-xlock.ps1 gc # 隔离区过期清理(也可配启动自动)
71
71
  ```
72
72
 
73
73
  DSH 原生工具 `xlock` 同名(action: `status` / `audit` / `reset` / `resolve` / `gc`,`session` 支持 id 片段模糊匹配),GUI / mobile 可达。
74
74
 
75
- ***REMOVED******REMOVED*** 隔离区
75
+ ## 隔离区
76
76
 
77
77
  `%LOCALAPPDATA%\dsh-xlock\quarantine\<UTC戳>-<会话>-<kind>\`(文件 + meta.json),同步面之外。台账 `ledger.jsonl` 记录 quarantine/copy/export/delete 全动作,删除先留痕。gc:普通 30 天、分叉导出证据 180 天(`-1` 永久)、总量 512MB 超限最旧优先。
78
78
 
79
- ***REMOVED******REMOVED*** 配置(包内 config.json,随同步面共享)
79
+ ## 配置(包内 config.json,随同步面共享)
80
80
 
81
81
  | 键 | 默认 | 说明 |
82
82
  | --- | --- | --- |
@@ -89,11 +89,11 @@ DSH 原生工具 `xlock` 同名(action: `status` / `audit` / `reset` / `resolv
89
89
  | `sessionActiveMs` | 180000 | 对端活跃窗口:日志 mtime 在此范围内判「正在写」(毫秒) |
90
90
  | `archiveSyncRoute` | true | 归档状态跨机同步,见上「归档标记」 |
91
91
 
92
- ***REMOVED******REMOVED*** 插件页名称与描述
92
+ ## 插件页名称与描述
93
93
 
94
94
  走官方 locale 机制:`locale/en.json` 是锚点(缺了整个 locale 目录不读),`locale/zh.json` 给中文,两者只写 `meta.title` / `meta.description`,缺哪个语言落回英文。`package.json` 的 `files` 与 `exports` 都要带上 `locale`。
95
95
 
96
- ***REMOVED******REMOVED*** 安装
96
+ ## 安装
97
97
 
98
98
  已发布到 npm:`dsh-xlock`。profile 依赖写纯 semver 范围 `^0.2.8`(**不能写成 `dsh-xlock@^0.2.8` 以外的带 `:` 形态**——DSH 原生更新检测只认 registry 安装且 range 不含冒号),pnpm 从 registry 装成真实目录;`~/.dsh/dsh-plugins/dsh-xlock/` 为开发工作副本。随包 `cordis.patch.yml` 的 insert 自动并入。改包内容后需重启 DSH。
99
99
 
@@ -109,13 +109,13 @@ powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.dsh\dsh-plugins\dsh-
109
109
 
110
110
  脚本幂等:登记 profile `package.json` → 用 DSH 自带 runtime + vendored pnpm 执行 install → 提示重启。激活验证看 `%LOCALAPPDATA%\dsh-xlock\host.log`。
111
111
 
112
- ***REMOVED******REMOVED*** 边界与残余风险
112
+ ## 边界与残余风险
113
113
 
114
114
  - 纯同步原理性边界:A 机开会话与 B 机写打开落在**分钟级同步延迟窗口**内时,两端本地取锁都可能成功 → 双写分叉;无跨机 CAS,此窗口只能缩小(`acquireQuiesceMs`)不能消除,事后由修复层 + audit + resolve 兜底。
115
115
  - 只读查看(GUI 纯浏览)与 DSH 之外的直接文件工具不经过 `sessionPersistence.open('write')`,不受拦(只读不产生写终结符)。
116
116
  - 设备短 ID 语义按 Syncthing 官方冲突副本命名假设,运行时以 `createdAt` 范围与文件名时间戳交叉印证,矛盾标「归属存疑」。
117
117
 
118
- ***REMOVED******REMOVED*** 测试
118
+ ## 测试
119
119
 
120
120
  `test/run.mjs` 零依赖自包含(夹具隔离 env,不碰真实会话):
121
121
 
package/client.js CHANGED
@@ -31,11 +31,11 @@ window.__ModuleLoader__.load({
31
31
  var REFRESH_MS = 15000;
32
32
  var CSS_TEXT = [
33
33
  '.dxl-ring{display:inline-block;width:11px;height:11px;border-radius:50%;box-sizing:border-box;cursor:default;vertical-align:middle}',
34
- '.dxl-ring[data-activity="writing"]{border:2px solid ***REMOVED***f0883e;animation:dxl-pulse 1.6s ease-in-out infinite}',
35
- '.dxl-ring[data-activity="silent"]{border:2px dashed ***REMOVED***8b949e;opacity:.6}',
34
+ '.dxl-ring[data-activity="writing"]{border:2px solid #f0883e;animation:dxl-pulse 1.6s ease-in-out infinite}',
35
+ '.dxl-ring[data-activity="silent"]{border:2px dashed #8b949e;opacity:.6}',
36
36
  '.dxl-origin{display:inline-block;width:8px;height:8px;border-radius:50%;box-sizing:border-box;cursor:default;vertical-align:middle;margin-left:3px}',
37
- '.dxl-origin[data-source="record"]{border:1.5px solid ***REMOVED***58a6ff}',
38
- '.dxl-origin[data-source="bucket"]{border:1.5px dotted ***REMOVED***58a6ff;opacity:.75}',
37
+ '.dxl-origin[data-source="record"]{border:1.5px solid #58a6ff}',
38
+ '.dxl-origin[data-source="bucket"]{border:1.5px dotted #58a6ff;opacity:.75}',
39
39
  '@keyframes dxl-pulse{0%,100%{opacity:1}50%{opacity:.35}}',
40
40
  '@media (prefers-reduced-motion:reduce){.dxl-ring[data-activity="writing"]{animation:none}}',
41
41
  ].join("");
package/cordis.patch.yml CHANGED
@@ -1,8 +1,8 @@
1
- ***REMOVED*** dsh-xlock — 跨机粘性会话锁 + 冲突副本治理
2
- ***REMOVED***
3
- ***REMOVED*** 把本包插进 profile 的条目列表:cordis 加载 index.js(宿主半),
4
- ***REMOVED*** apply() 里 ctx.inject(['sessionPersistence']) 后对实例做 open/create
5
- ***REMOVED*** 包装(跨机锁标记 + 尾部修复 + 冲突副本门禁)。详见包内 README.md。
1
+ # dsh-xlock — 跨机粘性会话锁 + 冲突副本治理
2
+ #
3
+ # 把本包插进 profile 的条目列表:cordis 加载 index.js(宿主半),
4
+ # apply() 里 ctx.inject(['sessionPersistence']) 后对实例做 open/create
5
+ # 包装(跨机锁标记 + 尾部修复 + 冲突副本门禁)。详见包内 README.md。
6
6
 
7
7
  - insert:
8
8
  - id: dsh-xlock
package/core/audit.mjs CHANGED
@@ -177,7 +177,7 @@ export function renderReport(report) {
177
177
  if (c.health.tornTailFrame) flags.push('torn-tail-frame(写打开自愈)')
178
178
  if (c.health.tornJsonlLastLine) flags.push('torn-JSONL-末行(需修复)')
179
179
  if (c.health.seqGaps.length) flags.push(`seq-gap×${c.health.seqGaps.length}`)
180
- if (c.openTurn !== undefined) flags.push(`turn***REMOVED***${c.openTurn}未闭合`)
180
+ if (c.openTurn !== undefined) flags.push(`turn#${c.openTurn}未闭合`)
181
181
  L.push(
182
182
  ` 主文件 ${c.name}: ${c.eventCount} events, frames=${c.health.frameCount}, ${range}` +
183
183
  (flags.length ? ` ⚠ ${flags.join(', ')}` : ' ✓'),
package/dsh-xlock.ps1 CHANGED
@@ -1,15 +1,15 @@
1
- ***REMOVED*** dsh-xlock.ps1 — 跨机会话粘锁插件 CLI 包装
2
- ***REMOVED***
3
- ***REMOVED*** 用法(PowerShell 7+):
4
- ***REMOVED*** dsh-xlock.ps1 audit <session|all>
5
- ***REMOVED*** dsh-xlock.ps1 resolve <session> --keep primary|copy
6
- ***REMOVED*** dsh-xlock.ps1 reset <session>
7
- ***REMOVED*** dsh-xlock.ps1 status
8
- ***REMOVED*** dsh-xlock.ps1 gc
9
- ***REMOVED***
10
- ***REMOVED*** 前置:DSH 已安装(或手动指定 $env:DSH_NODE_EXECUTABLE);
11
- ***REMOVED*** 本脚本用 DSH 自带 Node(ELECTRON_RUN_AS_NODE=1)跑插件 CLI,零额外依赖。
12
- ***REMOVED*** 规则:本文件 UTF-8 BOM + CRLF;不要用会改行尾的编辑器保存。
1
+ # dsh-xlock.ps1 — 跨机会话粘锁插件 CLI 包装
2
+ #
3
+ # 用法(PowerShell 7+):
4
+ # dsh-xlock.ps1 audit <session|all>
5
+ # dsh-xlock.ps1 resolve <session> --keep primary|copy
6
+ # dsh-xlock.ps1 reset <session>
7
+ # dsh-xlock.ps1 status
8
+ # dsh-xlock.ps1 gc
9
+ #
10
+ # 前置:DSH 已安装(或手动指定 $env:DSH_NODE_EXECUTABLE);
11
+ # 本脚本用 DSH 自带 Node(ELECTRON_RUN_AS_NODE=1)跑插件 CLI,零额外依赖。
12
+ # 规则:本文件 UTF-8 BOM + CRLF;不要用会改行尾的编辑器保存。
13
13
 
14
14
  [CmdletBinding()]
15
15
  param(
@@ -19,7 +19,7 @@ param(
19
19
 
20
20
  $ErrorActionPreference = 'Stop'
21
21
 
22
- ***REMOVED*** ── 定位 DSH Node ────────────────────────────────────────────────────────
22
+ # ── 定位 DSH Node ────────────────────────────────────────────────────────
23
23
  $node = $env:DSH_NODE_EXECUTABLE
24
24
  if (-not $node -or -not (Test-Path -LiteralPath $node)) {
25
25
  $node = $null
@@ -37,10 +37,10 @@ if (-not $node -or -not (Test-Path -LiteralPath $node)) {
37
37
  exit 2
38
38
  }
39
39
 
40
- ***REMOVED*** ── 定位插件 CLI ────────────────────────────────────────────────────────
40
+ # ── 定位插件 CLI ────────────────────────────────────────────────────────
41
41
  $cli = Join-Path $PSScriptRoot 'cli\xlock.mjs'
42
42
  if (-not (Test-Path -LiteralPath $cli)) {
43
- ***REMOVED*** 本脚本与 cli/ 同目录(源码态 dsh-plugins/dsh-xlock、安装态 node_modules/dsh-xlock 均成立)
43
+ # 本脚本与 cli/ 同目录(源码态 dsh-plugins/dsh-xlock、安装态 node_modules/dsh-xlock 均成立)
44
44
  Write-Error "找不到 CLI:$cli"
45
45
  exit 2
46
46
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-xlock",
3
- "version": "0.2.9",
3
+ "version": "0.2.10",
4
4
  "description": "Sticky cross-machine session lock, sync-conflict audit/repair, and session creation-origin records for DSH sessions",
5
5
  "type": "module",
6
6
  "main": "index.js",