dsh-xlock 0.2.8 → 0.2.9
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 +25 -23
- package/client.js +307 -307
- package/cordis.patch.yml +10 -10
- package/core/audit.mjs +226 -226
- package/core/origin.mjs +267 -267
- package/dsh-xlock.ps1 +15 -15
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
***REMOVED*** 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
|
-
|
|
9
|
+
***REMOVED******REMOVED*** 为什么需要
|
|
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
|
-
|
|
15
|
+
***REMOVED******REMOVED*** 工作原理
|
|
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
|
-
|
|
27
|
+
***REMOVED******REMOVED*** 创建归属
|
|
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
|
-
|
|
41
|
+
***REMOVED******REMOVED*** 归档标记(`.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
|
-
|
|
49
|
+
***REMOVED******REMOVED*** 浏览器 UI
|
|
50
50
|
|
|
51
51
|
client 半(`client.js`)读宿主半只读路由,全部自绘,无第三方图标依赖:
|
|
52
52
|
|
|
53
|
-
- **对端活跃度圆环**(slot `sidebar.session.row.leading`,id `xlock-remote`):只对异机持锁(`held-foreign
|
|
54
|
-
- **创建归属圆点**(同槽,id `xlock-origin`):8px 圆点
|
|
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`;有创建记录为实线、只靠桶名反推为点线;异机持锁时让路。
|
|
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
|
-
|
|
62
|
+
***REMOVED******REMOVED*** CLI
|
|
63
63
|
|
|
64
64
|
```powershell
|
|
65
|
-
dsh-xlock.ps1 audit <session|all>
|
|
66
|
-
dsh-xlock.ps1 resolve <session> --keep primary
|
|
67
|
-
dsh-xlock.ps1 resolve <session> --keep copy
|
|
68
|
-
dsh-xlock.ps1 reset <session>
|
|
69
|
-
dsh-xlock.ps1 status
|
|
70
|
-
dsh-xlock.ps1 gc
|
|
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*** 隔离区过期清理(也可配启动自动)
|
|
71
71
|
```
|
|
72
72
|
|
|
73
73
|
DSH 原生工具 `xlock` 同名(action: `status` / `audit` / `reset` / `resolve` / `gc`,`session` 支持 id 片段模糊匹配),GUI / mobile 可达。
|
|
74
74
|
|
|
75
|
-
|
|
75
|
+
***REMOVED******REMOVED*** 隔离区
|
|
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
|
-
|
|
79
|
+
***REMOVED******REMOVED*** 配置(包内 config.json,随同步面共享)
|
|
80
80
|
|
|
81
81
|
| 键 | 默认 | 说明 |
|
|
82
82
|
| --- | --- | --- |
|
|
@@ -89,15 +89,17 @@ DSH 原生工具 `xlock` 同名(action: `status` / `audit` / `reset` / `resolv
|
|
|
89
89
|
| `sessionActiveMs` | 180000 | 对端活跃窗口:日志 mtime 在此范围内判「正在写」(毫秒) |
|
|
90
90
|
| `archiveSyncRoute` | true | 归档状态跨机同步,见上「归档标记」 |
|
|
91
91
|
|
|
92
|
-
|
|
92
|
+
***REMOVED******REMOVED*** 插件页名称与描述
|
|
93
93
|
|
|
94
94
|
走官方 locale 机制:`locale/en.json` 是锚点(缺了整个 locale 目录不读),`locale/zh.json` 给中文,两者只写 `meta.title` / `meta.description`,缺哪个语言落回英文。`package.json` 的 `files` 与 `exports` 都要带上 `locale`。
|
|
95
95
|
|
|
96
|
-
|
|
96
|
+
***REMOVED******REMOVED*** 安装
|
|
97
97
|
|
|
98
|
-
profile
|
|
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
|
|
|
100
|
-
|
|
100
|
+
**为什么不再用 `github:` 源**:DSH 的 `updateRefusal()` 对 Git 安装只接受「钉到完整 commit 的 spec」,设置›插件页不给版本区、也不显示「可更新」;registry 安装才会 `pnpm view` 比对版本。发版流程:bump `package.json` 的 `version` → `pnpm publish --no-git-checks --access public` → 对机 `pnpm install`。
|
|
101
|
+
|
|
102
|
+
**打包约束**:`package.json` 的 `files` 决定 tarball 内容,`config.json` / `dsh-xlock.ps1` 必须列出,否则安装副本缺失、宿主静默退回内置默认值。`machines.json` **故意不进 `files`**(含本机主机名与工作区路径);首次运行由 `core/config.mjs` 的 `learnRegistry()` 在 `~/.dsh/dsh-plugins/dsh-xlock/machines.json` 自建。
|
|
101
103
|
|
|
102
104
|
另一台机器一键安装(同步盘把源码目录带到对机后):
|
|
103
105
|
|
|
@@ -107,13 +109,13 @@ powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.dsh\dsh-plugins\dsh-
|
|
|
107
109
|
|
|
108
110
|
脚本幂等:登记 profile `package.json` → 用 DSH 自带 runtime + vendored pnpm 执行 install → 提示重启。激活验证看 `%LOCALAPPDATA%\dsh-xlock\host.log`。
|
|
109
111
|
|
|
110
|
-
|
|
112
|
+
***REMOVED******REMOVED*** 边界与残余风险
|
|
111
113
|
|
|
112
114
|
- 纯同步原理性边界:A 机开会话与 B 机写打开落在**分钟级同步延迟窗口**内时,两端本地取锁都可能成功 → 双写分叉;无跨机 CAS,此窗口只能缩小(`acquireQuiesceMs`)不能消除,事后由修复层 + audit + resolve 兜底。
|
|
113
115
|
- 只读查看(GUI 纯浏览)与 DSH 之外的直接文件工具不经过 `sessionPersistence.open('write')`,不受拦(只读不产生写终结符)。
|
|
114
116
|
- 设备短 ID 语义按 Syncthing 官方冲突副本命名假设,运行时以 `createdAt` 范围与文件名时间戳交叉印证,矛盾标「归属存疑」。
|
|
115
117
|
|
|
116
|
-
|
|
118
|
+
***REMOVED******REMOVED*** 测试
|
|
117
119
|
|
|
118
120
|
`test/run.mjs` 零依赖自包含(夹具隔离 env,不碰真实会话):
|
|
119
121
|
|