dsh-worktree-groups 0.0.0-stage → 0.1.0
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/LICENSE +21 -0
- package/README.md +168 -2
- package/cordis.patch.yml +17 -0
- package/icon.svg +20 -0
- package/lib/activity.d.ts +78 -0
- package/lib/activity.d.ts.map +1 -0
- package/lib/activity.js +241 -0
- package/lib/activity.js.map +1 -0
- package/lib/client.d.ts +78 -0
- package/lib/client.d.ts.map +1 -0
- package/lib/client.js +4280 -0
- package/lib/git.d.ts +109 -0
- package/lib/git.d.ts.map +1 -0
- package/lib/git.js +317 -0
- package/lib/git.js.map +1 -0
- package/lib/icons.d.ts +148 -0
- package/lib/icons.d.ts.map +1 -0
- package/lib/icons.js +144 -0
- package/lib/icons.js.map +1 -0
- package/lib/index.d.ts +32 -0
- package/lib/index.d.ts.map +1 -0
- package/lib/index.js +47 -0
- package/lib/index.js.map +1 -0
- package/lib/ledger.d.ts +97 -0
- package/lib/ledger.d.ts.map +1 -0
- package/lib/ledger.js +276 -0
- package/lib/ledger.js.map +1 -0
- package/lib/live-merge.d.ts +44 -0
- package/lib/live-merge.d.ts.map +1 -0
- package/lib/live-merge.js +227 -0
- package/lib/live-merge.js.map +1 -0
- package/lib/live-state.d.ts +158 -0
- package/lib/live-state.d.ts.map +1 -0
- package/lib/live-state.js +281 -0
- package/lib/live-state.js.map +1 -0
- package/lib/locales.d.ts +71 -0
- package/lib/locales.d.ts.map +1 -0
- package/lib/locales.js +199 -0
- package/lib/locales.js.map +1 -0
- package/lib/projects.d.ts +88 -0
- package/lib/projects.d.ts.map +1 -0
- package/lib/projects.js +418 -0
- package/lib/projects.js.map +1 -0
- package/lib/routes.d.ts +376 -0
- package/lib/routes.d.ts.map +1 -0
- package/lib/routes.js +1875 -0
- package/lib/routes.js.map +1 -0
- package/lib/row-memo.d.ts +34 -0
- package/lib/row-memo.d.ts.map +1 -0
- package/lib/row-memo.js +46 -0
- package/lib/row-memo.js.map +1 -0
- package/lib/sidebar.d.ts +126 -0
- package/lib/sidebar.d.ts.map +1 -0
- package/lib/tree-model.d.ts +1226 -0
- package/lib/tree-model.d.ts.map +1 -0
- package/lib/tree-model.js +2143 -0
- package/lib/tree-model.js.map +1 -0
- package/lib/types.d.ts +98 -0
- package/lib/types.d.ts.map +1 -0
- package/lib/types.js +8 -0
- package/lib/types.js.map +1 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +88 -4
package/lib/icons.js
ADDED
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 宿主图标解析层:把「逻辑图标名」映射到**当前宿主**真实存在的 primitives 导出。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么需要这一层(2026-10-19 侧栏整块渲染失败)
|
|
5
|
+
*
|
|
6
|
+
* `src/sidebar.tsx` 原来直接以**尺寸后缀**取宿主图标(`P.IconPlusOutline16`、
|
|
7
|
+
* `P.IconChevronDownOutline14`、`P.IconArchiveOutline20` …),这在宿主
|
|
8
|
+
* `@deepseek-ai/dsh-client-ui-primitives@0.1.5-rc.2` 上成立(导出快照见
|
|
9
|
+
* `docs/HOST-CONTRACTS.md` §B5)。
|
|
10
|
+
*
|
|
11
|
+
* 宿主 `0.2.1-rc.2` 把图标导出改成了**线重后缀**:`IconPlusOutlineRegular`
|
|
12
|
+
* (1px)/ `IconPlusOutlineMedium`(1.3px),尺寸改由 `size` prop 控制,
|
|
13
|
+
* **`Icon*16` / `*14` / `*20` 这整套名字都不再存在**(实测导出表里没有任何
|
|
14
|
+
* `Icon*` + 数字后缀的名字)。
|
|
15
|
+
*
|
|
16
|
+
* 直接取用因此不是"图标不显示",而是**渲染期硬崩**:
|
|
17
|
+
*
|
|
18
|
+
* ```js
|
|
19
|
+
* const LeadIcon = P.IconBranchOutline16 // undefined
|
|
20
|
+
* jsx(LeadIcon, {}) // Element type is invalid … got: undefined
|
|
21
|
+
* ```
|
|
22
|
+
*
|
|
23
|
+
* 抛点在 `SidebarBoundary` 的子树内 ⇒ 侧栏被换成「侧栏渲染出错」;若发生在边界之外,
|
|
24
|
+
* 宿主 `SlotErrorBoundary` 会 `abdicate` 本 entry,整块侧栏静默回落到官方
|
|
25
|
+
* `ui-workspace`。用户看到的现象就是"这个插件导致侧栏渲染失败"。
|
|
26
|
+
*
|
|
27
|
+
* ## 契约
|
|
28
|
+
*
|
|
29
|
+
* 1. **候选表**:每个逻辑名给出「新命名优先、旧命名兜底」的候选序列,任一命中即用 ⇒
|
|
30
|
+
* 插件对两个宿主版本同时成立,不需要跟宿主版本硬绑定。
|
|
31
|
+
* 2. **绝不返回 `undefined`**:全部候选都缺席时回落**空图标组件**(渲染 `null`)。
|
|
32
|
+
* 宿主再改一次命名,代价是少几个图标,而不是整块侧栏白掉。
|
|
33
|
+
* 3. **纯逻辑**:本文件不 import react、不 import 任何 `@deepseek-ai/*` 包,
|
|
34
|
+
* 宿主图标面由调用方以 `face` 传入(`sidebar.tsx` 传 esbuild external 的
|
|
35
|
+
* `Primitives`),因此可被 `node --test` 直接覆盖。
|
|
36
|
+
*
|
|
37
|
+
* 尺寸:宿主新组件的 `size` prop 默认 16;`ArchiveOutline20` 这类旧名字自带 20 的
|
|
38
|
+
* 画板,因此候选表里同时记录**默认尺寸**,渲染时与宿主给的同名 prop 合并
|
|
39
|
+
* (调用方显式传入的 `size` 优先)。
|
|
40
|
+
*/
|
|
41
|
+
/**
|
|
42
|
+
* 逻辑名 → 候选导出名。
|
|
43
|
+
*
|
|
44
|
+
* 新命名(`*Regular` / `*Medium`)必须排在首位:宿主 `0.2.1` 只认它;
|
|
45
|
+
* 旧命名(`Icon*16/14/20`)保留在后,让 `0.1.5` 组合继续可用。
|
|
46
|
+
*/
|
|
47
|
+
export const ICON_SPECS = {
|
|
48
|
+
chevronDown: { candidates: ['IconChevronDownOutlineRegular', 'IconChevronDownOutline14'], size: 14 },
|
|
49
|
+
chevronRight: { candidates: ['IconChevronRightOutlineRegular', 'IconChevronRightOutline14'], size: 14 },
|
|
50
|
+
clock: { candidates: ['IconClockOutlineRegular', 'IconClockOutline16'], size: 16 },
|
|
51
|
+
folderOpen: { candidates: ['IconFolderOpenOutlineRegular', 'IconFolderOpenOutline16'], size: 16 },
|
|
52
|
+
folderClose: { candidates: ['IconFolderCloseRegular', 'IconFolderClose16'], size: 16 },
|
|
53
|
+
branch: { candidates: ['IconBranchOutlineRegular', 'IconBranchOutline16'], size: 16 },
|
|
54
|
+
panelLeft: { candidates: ['IconPanelLeftOutlineRegular', 'IconPanelLeftOutline16'], size: 16 },
|
|
55
|
+
plus: { candidates: ['IconPlusOutlineRegular', 'IconPlusOutline16'], size: 16 },
|
|
56
|
+
ellipsis: { candidates: ['IconEllipsisOutlineRegular', 'IconEllipsisOutline16'], size: 16 },
|
|
57
|
+
projectAdd: { candidates: ['IconProjectAddOutlineRegular', 'IconProjectAddOutline16'], size: 16 },
|
|
58
|
+
refresh: { candidates: ['IconRefreshOutlineRegular', 'IconRefreshOutline16'], size: 14 },
|
|
59
|
+
copy: { candidates: ['IconCopyOutlineRegular', 'IconCopyOutline16'], size: 16 },
|
|
60
|
+
edit: { candidates: ['IconEditOutlineRegular', 'IconEditOutline16'], size: 16 },
|
|
61
|
+
trash: { candidates: ['IconTrashOutlineRegular', 'IconTrashOutline16'], size: 16 },
|
|
62
|
+
archive: { candidates: ['IconArchiveOutlineRegular', 'IconArchiveOutline20'], size: 20 },
|
|
63
|
+
newChat: { candidates: ['IconNewChatOutlineRegular', 'IconNewChatOutline16'], size: 16 },
|
|
64
|
+
};
|
|
65
|
+
/** 全部逻辑图标名,顺序稳定(`ICON_SPECS` 的声明顺序)。 */
|
|
66
|
+
export const ICON_NAMES = Object.keys(ICON_SPECS);
|
|
67
|
+
/**
|
|
68
|
+
* 空图标:候选全部缺席时的回落组件。
|
|
69
|
+
*
|
|
70
|
+
* 渲染 `null`(不是抛错、也不是 `undefined`)—— React 收到 `null` 是合法的
|
|
71
|
+
* "不渲染任何东西",侧栏其余部分照常工作。
|
|
72
|
+
*/
|
|
73
|
+
function NullIcon() {
|
|
74
|
+
return null;
|
|
75
|
+
}
|
|
76
|
+
/** 读宿主图标面的一个名字;非函数一律视为缺席(导出了同名的非组件值也不算命中)。 */
|
|
77
|
+
function iconAt(face, name) {
|
|
78
|
+
if (face === null || face === undefined)
|
|
79
|
+
return undefined;
|
|
80
|
+
const value = face[name];
|
|
81
|
+
return typeof value === 'function' ? value : undefined;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* 解析一个逻辑图标。
|
|
85
|
+
*
|
|
86
|
+
* 结果按 `(face, name)` 缓存:同一宿主面重复解析必须返回**同一组件引用**,
|
|
87
|
+
* 否则 `sidebar.tsx` 里以图标为局部变量的渲染会每次拿到新组件类型,让 React
|
|
88
|
+
* 把整行当新组件卸载重建(拖拽与 hover 态都会被打断)。
|
|
89
|
+
*
|
|
90
|
+
* @param face 宿主 primitives 面(缺省/缺席都安全)。
|
|
91
|
+
* @param name 逻辑图标名。
|
|
92
|
+
* @returns 可渲染组件与命中的导出名;永不抛错。
|
|
93
|
+
*/
|
|
94
|
+
const resolvedCache = new WeakMap();
|
|
95
|
+
const fallbackCache = new Map();
|
|
96
|
+
export function resolveIcon(face, name) {
|
|
97
|
+
const spec = ICON_SPECS[name];
|
|
98
|
+
const hit = spec.candidates.find((candidate) => iconAt(face, candidate) !== undefined);
|
|
99
|
+
if (hit === undefined) {
|
|
100
|
+
// 缺席时也按名字缓存,保证同一逻辑名恒得同一引用。
|
|
101
|
+
const cached = fallbackCache.get(name);
|
|
102
|
+
if (cached !== undefined)
|
|
103
|
+
return cached;
|
|
104
|
+
const fallback = { Component: NullIcon, candidate: undefined };
|
|
105
|
+
fallbackCache.set(name, fallback);
|
|
106
|
+
return fallback;
|
|
107
|
+
}
|
|
108
|
+
const key = face;
|
|
109
|
+
let perFace = resolvedCache.get(key);
|
|
110
|
+
if (perFace === undefined) {
|
|
111
|
+
perFace = new Map();
|
|
112
|
+
resolvedCache.set(key, perFace);
|
|
113
|
+
}
|
|
114
|
+
const cached = perFace.get(name);
|
|
115
|
+
if (cached !== undefined && cached.candidate === hit)
|
|
116
|
+
return cached;
|
|
117
|
+
const resolved = {
|
|
118
|
+
Component: iconAt(face, hit),
|
|
119
|
+
candidate: hit,
|
|
120
|
+
};
|
|
121
|
+
perFace.set(name, resolved);
|
|
122
|
+
return resolved;
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* 列出该宿主面下**一个候选都不存在**的逻辑图标(漂移诊断用)。
|
|
126
|
+
*
|
|
127
|
+
* @param face 宿主 primitives 面。
|
|
128
|
+
* @returns 解析不到的图标名(顺序同 {@link ICON_NAMES})。
|
|
129
|
+
*/
|
|
130
|
+
export function unresolvedIcons(face) {
|
|
131
|
+
return ICON_NAMES.filter((name) => resolveIcon(face, name).candidate === undefined);
|
|
132
|
+
}
|
|
133
|
+
/**
|
|
134
|
+
* 图标默认尺寸(宿主新组件默认 16,`ArchiveOutline` 原画板 20)。
|
|
135
|
+
*
|
|
136
|
+
* 渲染层在 `jsx(Component, { size })` 时用它做默认值,调用方显式传入的 `size` 优先。
|
|
137
|
+
*
|
|
138
|
+
* @param name 逻辑图标名。
|
|
139
|
+
* @returns 该图标的默认尺寸。
|
|
140
|
+
*/
|
|
141
|
+
export function iconSize(name) {
|
|
142
|
+
return ICON_SPECS[name].size;
|
|
143
|
+
}
|
|
144
|
+
//# sourceMappingURL=icons.js.map
|
package/lib/icons.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"icons.js","sourceRoot":"","sources":["../src/icons.ts"],"names":[],"mappings":"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"}
|
package/lib/index.d.ts
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 宿主半边入口(契约见 `docs/INTERFACES.md` §1.6)。
|
|
3
|
+
*
|
|
4
|
+
* ## 依赖姿态(宿主契约 §2.5 / §C14)
|
|
5
|
+
*
|
|
6
|
+
* 本文件**只** `import type { Context } from '@deepseek-ai/cordis'` ——
|
|
7
|
+
* 这是全包唯一允许的 `@deepseek-ai/*` 静态 import,且是 type-only(编译后消失)。
|
|
8
|
+
* 理由(实测,见 `docs/HOST-CONTRACTS.md` §C14.4):DSH 的 ESM 解析钩子会**优先命中**
|
|
9
|
+
* 插件自带 `node_modules`,一旦运行时真的加载到第二份 `cordis`,`Service` 基类身份
|
|
10
|
+
* 分裂,本插件注册的服务全部失效。宿主服务(`webServer` / `workspaceRegistry` /
|
|
11
|
+
* `sessionPersistence` / `sessionController` / `sessions`)一律走 `ctx.get(name)` 运行时获取。
|
|
12
|
+
*
|
|
13
|
+
* ## 降级策略(PRD R6)
|
|
14
|
+
*
|
|
15
|
+
* `inject = ['webServer']` 保证路由注册发生在 webServer 就绪之后;但 `webServer`
|
|
16
|
+
* 本身缺席(非 web profile)时 `apply` 也**不抛错**,只是什么都不注册 ——
|
|
17
|
+
* 「缺失即降级,绝不崩」。
|
|
18
|
+
*/
|
|
19
|
+
import type { Context } from '@deepseek-ai/cordis';
|
|
20
|
+
export declare const name = "dsh-worktree-groups";
|
|
21
|
+
/**
|
|
22
|
+
* 硬依赖:只有 `webServer`。
|
|
23
|
+
*
|
|
24
|
+
* 其余宿主服务(`workspaceRegistry` / `sessionPersistence` / `sessionController` /
|
|
25
|
+
* `sessions`)都是**软依赖**,在 `routes.ts` 里用 `ctx.get()` 惰性读取并在缺失时降级
|
|
26
|
+
* (返回空树而不是抛错)。把它们写进 `inject` 会让插件在它们缺席时永久 pending,
|
|
27
|
+
* 而本插件没有这个必要。
|
|
28
|
+
*/
|
|
29
|
+
export declare const inject: string[];
|
|
30
|
+
/** 宿主半边入口。业务实现在 `routes.ts` / `git.ts` / `projects.ts` / `ledger.ts`。 */
|
|
31
|
+
export declare function apply(ctx: Context): void;
|
|
32
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAIlD,eAAO,MAAM,IAAI,wBAAwB,CAAA;AAEzC;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,UAAgB,CAAA;AAEnC,yEAAyE;AACzE,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAaxC"}
|
package/lib/index.js
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 宿主半边入口(契约见 `docs/INTERFACES.md` §1.6)。
|
|
3
|
+
*
|
|
4
|
+
* ## 依赖姿态(宿主契约 §2.5 / §C14)
|
|
5
|
+
*
|
|
6
|
+
* 本文件**只** `import type { Context } from '@deepseek-ai/cordis'` ——
|
|
7
|
+
* 这是全包唯一允许的 `@deepseek-ai/*` 静态 import,且是 type-only(编译后消失)。
|
|
8
|
+
* 理由(实测,见 `docs/HOST-CONTRACTS.md` §C14.4):DSH 的 ESM 解析钩子会**优先命中**
|
|
9
|
+
* 插件自带 `node_modules`,一旦运行时真的加载到第二份 `cordis`,`Service` 基类身份
|
|
10
|
+
* 分裂,本插件注册的服务全部失效。宿主服务(`webServer` / `workspaceRegistry` /
|
|
11
|
+
* `sessionPersistence` / `sessionController` / `sessions`)一律走 `ctx.get(name)` 运行时获取。
|
|
12
|
+
*
|
|
13
|
+
* ## 降级策略(PRD R6)
|
|
14
|
+
*
|
|
15
|
+
* `inject = ['webServer']` 保证路由注册发生在 webServer 就绪之后;但 `webServer`
|
|
16
|
+
* 本身缺席(非 web profile)时 `apply` 也**不抛错**,只是什么都不注册 ——
|
|
17
|
+
* 「缺失即降级,绝不崩」。
|
|
18
|
+
*/
|
|
19
|
+
import { registerRoutes } from './routes.js';
|
|
20
|
+
export const name = 'dsh-worktree-groups';
|
|
21
|
+
/**
|
|
22
|
+
* 硬依赖:只有 `webServer`。
|
|
23
|
+
*
|
|
24
|
+
* 其余宿主服务(`workspaceRegistry` / `sessionPersistence` / `sessionController` /
|
|
25
|
+
* `sessions`)都是**软依赖**,在 `routes.ts` 里用 `ctx.get()` 惰性读取并在缺失时降级
|
|
26
|
+
* (返回空树而不是抛错)。把它们写进 `inject` 会让插件在它们缺席时永久 pending,
|
|
27
|
+
* 而本插件没有这个必要。
|
|
28
|
+
*/
|
|
29
|
+
export const inject = ['webServer'];
|
|
30
|
+
/** 宿主半边入口。业务实现在 `routes.ts` / `git.ts` / `projects.ts` / `ledger.ts`。 */
|
|
31
|
+
export function apply(ctx) {
|
|
32
|
+
try {
|
|
33
|
+
registerRoutes(ctx);
|
|
34
|
+
}
|
|
35
|
+
catch (error) {
|
|
36
|
+
// 路由注册失败(例如同名路由已被别的插件占用)不应该让整个插件行加载失败:
|
|
37
|
+
// 记录后继续,客户端侧会看到 /tree 404 并走自己的错误边界。
|
|
38
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
39
|
+
try {
|
|
40
|
+
ctx.logger?.warn?.(`dsh-worktree-groups: HTTP 路由注册失败:${message}`);
|
|
41
|
+
}
|
|
42
|
+
catch {
|
|
43
|
+
// logger 不可用:静默(绝不因日志而崩)
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
//# sourceMappingURL=index.js.map
|
package/lib/index.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C,MAAM,CAAC,MAAM,IAAI,GAAG,qBAAqB,CAAA;AAEzC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,WAAW,CAAC,CAAA;AAEnC,yEAAyE;AACzE,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,IAAI,CAAC;QACH,cAAc,CAAC,GAAG,CAAC,CAAA;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uCAAuC;QACvC,qCAAqC;QACrC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtE,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAA;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}
|
package/lib/ledger.d.ts
ADDED
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 台账持久化(T2)。
|
|
3
|
+
*
|
|
4
|
+
* 背景:`SessionHeader` 只带 `cwd`,没有仓库指针。当某个 worktree 目录被 `rm -rf` 之后,
|
|
5
|
+
* 它里面的会话就无从知道原本属于哪个项目。本模块用一个 JSON 台账补上这份信息:
|
|
6
|
+
*
|
|
7
|
+
* - `projects[commonDir].worktrees[worktreePath]` —— 插件**见过的**每个 worktree
|
|
8
|
+
* (首次见到时间 / 最近见到时间 / 消失时间);
|
|
9
|
+
* - `sessions[sessionId] = { projectKey, worktreePath }` —— 会话归属快照,
|
|
10
|
+
* 用于目录消失后把会话归位到对应项目的 history 桶。
|
|
11
|
+
*
|
|
12
|
+
* 设计约束(见 `docs/INTERFACES.md` §1.4):
|
|
13
|
+
* - **原子写**:同目录 `<file>.tmp` → `fsync` → `rename`,权限 `0o600`,失败清理 tmp;
|
|
14
|
+
* - **容错读**:文件不存在 / JSON 损坏 / `version` 不符 ⇒ 备份坏文件并返回空台账,**永不抛错**;
|
|
15
|
+
* - **串行化**:`update()` 走内部 Promise 链,任一时刻只有一次「读-改-写」在飞;
|
|
16
|
+
* - **工厂不碰 IO**:`createFileLedger()` 只在 `read()` / `write()` / `update()` 内做 IO
|
|
17
|
+
* (宿主启动期会同步调用该工厂)。
|
|
18
|
+
*/
|
|
19
|
+
/** 一个 worktree 的台账记录。 */
|
|
20
|
+
export interface LedgerWorktree {
|
|
21
|
+
/** 最近一次见到的检出分支短名;detached 或未知时 undefined。 */
|
|
22
|
+
branch?: string;
|
|
23
|
+
/** 首次见到该 worktree 的时刻(epoch ms)。 */
|
|
24
|
+
firstSeenAt: number;
|
|
25
|
+
/** 最近一次被 git 列表看到的时刻(epoch ms)。 */
|
|
26
|
+
lastSeenAt: number;
|
|
27
|
+
/** 首次被发现已消失的时刻(epoch ms,>= lastSeenAt)。 */
|
|
28
|
+
goneAt?: number;
|
|
29
|
+
}
|
|
30
|
+
/** 一个项目(git common dir)的台账记录。 */
|
|
31
|
+
export interface LedgerProject {
|
|
32
|
+
/** 主工作树路径(便于 commonDir 变化时兜底)。 */
|
|
33
|
+
mainPath: string;
|
|
34
|
+
/** worktree 路径(归一化)→ 记录。 */
|
|
35
|
+
worktrees: Record<string, LedgerWorktree>;
|
|
36
|
+
}
|
|
37
|
+
/** 一条会话归属快照。 */
|
|
38
|
+
export interface LedgerSessionOwner {
|
|
39
|
+
/** 项目键(commonDir)。 */
|
|
40
|
+
projectKey: string;
|
|
41
|
+
/** 会话所属 worktree 路径(归一化)。 */
|
|
42
|
+
worktreePath: string;
|
|
43
|
+
}
|
|
44
|
+
/** 已归档工作空间的台账记录(2026-10-21 WSR1/WSR2)。 */
|
|
45
|
+
export interface LedgerArchivedProject {
|
|
46
|
+
title: string;
|
|
47
|
+
path?: string;
|
|
48
|
+
isGit: boolean;
|
|
49
|
+
archivedAt: number;
|
|
50
|
+
}
|
|
51
|
+
/** 台账全量数据(文件顶层结构)。 */
|
|
52
|
+
export interface LedgerData {
|
|
53
|
+
version: 1;
|
|
54
|
+
projects: Record<string, LedgerProject>;
|
|
55
|
+
/** sessionId → 归属快照(用于目录消失后的归位)。 */
|
|
56
|
+
sessions: Record<string, LedgerSessionOwner>;
|
|
57
|
+
/** projectKey → 已归档工作空间记录(可选,缺省表示无归档工作空间)。 */
|
|
58
|
+
archivedProjects?: Record<string, LedgerArchivedProject>;
|
|
59
|
+
}
|
|
60
|
+
/** 台账存储:读写 + 串行化的读-改-写。 */
|
|
61
|
+
export interface LedgerStore {
|
|
62
|
+
/** 从介质读取一份**全新**的台账数据(文件缺失/损坏时返回空台账,不抛错)。 */
|
|
63
|
+
read(): Promise<LedgerData>;
|
|
64
|
+
/** 全量覆盖写盘(原子写:tmp + fsync + rename)。 */
|
|
65
|
+
write(data: LedgerData): Promise<void>;
|
|
66
|
+
/**
|
|
67
|
+
* 读-改-写,串行化(内部 Promise 链,任一时刻只有一次在飞)。
|
|
68
|
+
* 回调返回**同一引用**(`=== data`)时跳过写盘(no-op 优化),但仍返回数据。
|
|
69
|
+
*
|
|
70
|
+
* ⚠️ **陷阱**:回调若**原地修改** `data` 并返回**同一引用**,会命中「同引用 ⇒ 跳过写盘」
|
|
71
|
+
* 的 no-op 优化,导致**数据静默丢失**(内存里看着改了,磁盘上没落盘,下次 `read()` 就没了)。
|
|
72
|
+
* 正确用法是构造并返回**新对象**(例如
|
|
73
|
+
* `{ ...current, sessions: { ...current.sessions, [id]: v } }`)。
|
|
74
|
+
* `src/routes.ts` 的 `updateLedger` 正是靠返回新引用(`next`)才落盘。
|
|
75
|
+
*/
|
|
76
|
+
update(fn: (data: LedgerData) => LedgerData): Promise<LedgerData>;
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* 构造一份空台账。
|
|
80
|
+
*
|
|
81
|
+
* 每次调用都返回**新对象**(不共享单例),调用方随意修改不会污染其它调用者。
|
|
82
|
+
*/
|
|
83
|
+
export declare function emptyLedger(): LedgerData;
|
|
84
|
+
/**
|
|
85
|
+
* 创建文件介质台账:`<homeDir>/worktree-groups.json`,临时文件 + rename 原子写。
|
|
86
|
+
*
|
|
87
|
+
* @param homeDir harness home 目录;缺省时**惰性**取 `defaultDshHome()`(不可解析则回退
|
|
88
|
+
* `$DSH_HOME ?? ~/.dsh`)。显式传入时完全不解析该包。
|
|
89
|
+
*
|
|
90
|
+
* 关键约束:
|
|
91
|
+
* - 本函数**不同步做任何 IO**,也**不 await 任何模块解析**(宿主启动期同步调用它);
|
|
92
|
+
* 目录创建、文件读写、home 解析全部推迟到 `read()` / `write()` / `update()` 内;
|
|
93
|
+
* - 读失败(文件不存在 / JSON 损坏 / 版本不符 / 任何 fs 错误)一律返回空台账,**绝不抛错**;
|
|
94
|
+
* - `update()` 串行化,且某次回调抛错不会卡死后续调用。
|
|
95
|
+
*/
|
|
96
|
+
export declare function createFileLedger(homeDir?: string): LedgerStore;
|
|
97
|
+
//# sourceMappingURL=ledger.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAqBH,yBAAyB;AACzB,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAA;IACnB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CAC1C;AAED,gBAAgB;AAChB,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,sBAAsB;AACtB,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CAAC,CAAA;IACV,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACvC,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IAC5C,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;CACzD;AAED,2BAA2B;AAC3B,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAAA;IAC3B,wCAAwC;IACxC,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;CAClE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,UAAU,CAExC;AAwCD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CA4L9D"}
|
package/lib/ledger.js
ADDED
|
@@ -0,0 +1,276 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 台账持久化(T2)。
|
|
3
|
+
*
|
|
4
|
+
* 背景:`SessionHeader` 只带 `cwd`,没有仓库指针。当某个 worktree 目录被 `rm -rf` 之后,
|
|
5
|
+
* 它里面的会话就无从知道原本属于哪个项目。本模块用一个 JSON 台账补上这份信息:
|
|
6
|
+
*
|
|
7
|
+
* - `projects[commonDir].worktrees[worktreePath]` —— 插件**见过的**每个 worktree
|
|
8
|
+
* (首次见到时间 / 最近见到时间 / 消失时间);
|
|
9
|
+
* - `sessions[sessionId] = { projectKey, worktreePath }` —— 会话归属快照,
|
|
10
|
+
* 用于目录消失后把会话归位到对应项目的 history 桶。
|
|
11
|
+
*
|
|
12
|
+
* 设计约束(见 `docs/INTERFACES.md` §1.4):
|
|
13
|
+
* - **原子写**:同目录 `<file>.tmp` → `fsync` → `rename`,权限 `0o600`,失败清理 tmp;
|
|
14
|
+
* - **容错读**:文件不存在 / JSON 损坏 / `version` 不符 ⇒ 备份坏文件并返回空台账,**永不抛错**;
|
|
15
|
+
* - **串行化**:`update()` 走内部 Promise 链,任一时刻只有一次「读-改-写」在飞;
|
|
16
|
+
* - **工厂不碰 IO**:`createFileLedger()` 只在 `read()` / `write()` / `update()` 内做 IO
|
|
17
|
+
* (宿主启动期会同步调用该工厂)。
|
|
18
|
+
*/
|
|
19
|
+
import { access, mkdir, open, readFile, rename, stat, unlink } from 'node:fs/promises';
|
|
20
|
+
import { homedir } from 'node:os';
|
|
21
|
+
import { dirname, join } from 'node:path';
|
|
22
|
+
/** 台账文件版本;不匹配即视为坏文件(备份 + 空台账)。 */
|
|
23
|
+
const LEDGER_VERSION = 1;
|
|
24
|
+
/** 台账文件名(介质:`<homeDir>/worktree-groups.json`)。 */
|
|
25
|
+
const LEDGER_FILE_NAME = 'worktree-groups.json';
|
|
26
|
+
/**
|
|
27
|
+
* `defaultDshHome` 所在的包名。
|
|
28
|
+
*
|
|
29
|
+
* 该包只在 DSH 宿主进程的 node_modules 里可解析,本包自身 **不可静态 import**
|
|
30
|
+
* (`tsc` 会报 TS2307)。因此这里用**惰性动态 import**(变量说明符,避免 tsc 解析),
|
|
31
|
+
* 解析失败时回退 `$DSH_HOME ?? ~/.dsh`。
|
|
32
|
+
*/
|
|
33
|
+
const DSH_HOME_PATHS_MODULE = '@deepseek-ai/dsh-home-paths';
|
|
34
|
+
/**
|
|
35
|
+
* 构造一份空台账。
|
|
36
|
+
*
|
|
37
|
+
* 每次调用都返回**新对象**(不共享单例),调用方随意修改不会污染其它调用者。
|
|
38
|
+
*/
|
|
39
|
+
export function emptyLedger() {
|
|
40
|
+
return { version: LEDGER_VERSION, projects: {}, sessions: {} };
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* 解析默认 harness home:优先动态 import `@deepseek-ai/dsh-home-paths` 的 `defaultDshHome()`;
|
|
44
|
+
* 该包不可解析(例如脱离宿主进程跑单测)时回退 `$DSH_HOME`,再回退 `~/.dsh`。
|
|
45
|
+
*
|
|
46
|
+
* 关键约束:**惰性**执行 —— 工厂函数本身不能触发 IO / 模块解析。
|
|
47
|
+
*/
|
|
48
|
+
async function resolveDefaultHome() {
|
|
49
|
+
try {
|
|
50
|
+
const specifier = DSH_HOME_PATHS_MODULE;
|
|
51
|
+
const mod = (await import(specifier));
|
|
52
|
+
const fn = mod.defaultDshHome;
|
|
53
|
+
if (typeof fn === 'function') {
|
|
54
|
+
const resolved = fn();
|
|
55
|
+
if (typeof resolved === 'string' && resolved.length > 0)
|
|
56
|
+
return resolved;
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
catch {
|
|
60
|
+
// 模块不可解析 / 导出形态变化 ⇒ 走下面的环境变量回退,绝不上抛
|
|
61
|
+
}
|
|
62
|
+
const fromEnv = process.env['DSH_HOME'];
|
|
63
|
+
if (typeof fromEnv === 'string' && fromEnv.trim().length > 0)
|
|
64
|
+
return fromEnv;
|
|
65
|
+
return join(homedir(), '.dsh');
|
|
66
|
+
}
|
|
67
|
+
/** 该值是否为「普通对象」(非 null、非数组)。 */
|
|
68
|
+
function isPlainObject(value) {
|
|
69
|
+
return typeof value === 'object' && value !== null && !Array.isArray(value);
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* 判断解析出来的 JSON 是否是本版本可用的台账结构。
|
|
73
|
+
* 结构不完整(缺 version / projects / sessions)一律视为损坏 —— 交给调用方备份。
|
|
74
|
+
*/
|
|
75
|
+
function isLedgerShape(value) {
|
|
76
|
+
if (!isPlainObject(value))
|
|
77
|
+
return false;
|
|
78
|
+
if (value['version'] !== LEDGER_VERSION)
|
|
79
|
+
return false;
|
|
80
|
+
return isPlainObject(value['projects']) && isPlainObject(value['sessions']);
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* 创建文件介质台账:`<homeDir>/worktree-groups.json`,临时文件 + rename 原子写。
|
|
84
|
+
*
|
|
85
|
+
* @param homeDir harness home 目录;缺省时**惰性**取 `defaultDshHome()`(不可解析则回退
|
|
86
|
+
* `$DSH_HOME ?? ~/.dsh`)。显式传入时完全不解析该包。
|
|
87
|
+
*
|
|
88
|
+
* 关键约束:
|
|
89
|
+
* - 本函数**不同步做任何 IO**,也**不 await 任何模块解析**(宿主启动期同步调用它);
|
|
90
|
+
* 目录创建、文件读写、home 解析全部推迟到 `read()` / `write()` / `update()` 内;
|
|
91
|
+
* - 读失败(文件不存在 / JSON 损坏 / 版本不符 / 任何 fs 错误)一律返回空台账,**绝不抛错**;
|
|
92
|
+
* - `update()` 串行化,且某次回调抛错不会卡死后续调用。
|
|
93
|
+
*/
|
|
94
|
+
export function createFileLedger(homeDir) {
|
|
95
|
+
const explicitHome = homeDir;
|
|
96
|
+
/** 惰性解析并缓存的台账文件绝对路径。 */
|
|
97
|
+
let cachedFile;
|
|
98
|
+
async function ledgerFile() {
|
|
99
|
+
if (cachedFile !== undefined)
|
|
100
|
+
return cachedFile;
|
|
101
|
+
const home = explicitHome !== undefined ? explicitHome : await resolveDefaultHome();
|
|
102
|
+
const file = join(home, LEDGER_FILE_NAME);
|
|
103
|
+
cachedFile = file;
|
|
104
|
+
return file;
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* 把坏文件挪到 `<file>.bad-<ts>` 备份。
|
|
108
|
+
* 备份失败(权限等)静默忽略 —— 宁可丢台账也不能崩宿主。
|
|
109
|
+
*/
|
|
110
|
+
async function backupCorrupt(file) {
|
|
111
|
+
const stamp = Date.now();
|
|
112
|
+
for (let attempt = 0; attempt < 100; attempt += 1) {
|
|
113
|
+
const target = attempt === 0 ? `${file}.bad-${stamp}` : `${file}.bad-${stamp}-${attempt}`;
|
|
114
|
+
try {
|
|
115
|
+
await access(target);
|
|
116
|
+
continue; // 该备份名已被占用,换一个后缀
|
|
117
|
+
}
|
|
118
|
+
catch {
|
|
119
|
+
// 名字可用
|
|
120
|
+
}
|
|
121
|
+
try {
|
|
122
|
+
await rename(file, target);
|
|
123
|
+
}
|
|
124
|
+
catch {
|
|
125
|
+
// 备份失败:坏文件留在原地,下次读取会再试一次
|
|
126
|
+
}
|
|
127
|
+
return;
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* 从磁盘读一份全新台账。所有失败路径都返回 `emptyLedger()`,不抛错。
|
|
132
|
+
*/
|
|
133
|
+
/**
|
|
134
|
+
* 内存读缓存(2026-11-14 PERF2):以文件 `mtimeMs` + `size` 校验,一致则直接返回上次解析结果,
|
|
135
|
+
* 免去每个 `/tree` 请求两次读盘 + `JSON.parse`(实测 352 KB)。外部改写会改变 mtime ⇒ 自动失效。
|
|
136
|
+
* ⚠️ 缓存对象只在内部共享给 `update` 回调(它一律构造新对象、不原地修改);公开 `read()` 返回副本。
|
|
137
|
+
*/
|
|
138
|
+
let cached;
|
|
139
|
+
async function fileIdentity(file) {
|
|
140
|
+
try {
|
|
141
|
+
const info = await stat(file);
|
|
142
|
+
return { mtimeMs: info.mtimeMs, size: info.size };
|
|
143
|
+
}
|
|
144
|
+
catch {
|
|
145
|
+
return undefined;
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
async function readFromDisk() {
|
|
149
|
+
let file;
|
|
150
|
+
try {
|
|
151
|
+
file = await ledgerFile();
|
|
152
|
+
}
|
|
153
|
+
catch {
|
|
154
|
+
return emptyLedger();
|
|
155
|
+
}
|
|
156
|
+
const identity = await fileIdentity(file);
|
|
157
|
+
if (identity === undefined) {
|
|
158
|
+
cached = undefined;
|
|
159
|
+
return emptyLedger();
|
|
160
|
+
}
|
|
161
|
+
if (cached !== undefined && cached.mtimeMs === identity.mtimeMs && cached.size === identity.size) {
|
|
162
|
+
return cached.data;
|
|
163
|
+
}
|
|
164
|
+
cached = undefined;
|
|
165
|
+
let raw;
|
|
166
|
+
try {
|
|
167
|
+
raw = await readFile(file, 'utf8');
|
|
168
|
+
}
|
|
169
|
+
catch {
|
|
170
|
+
// ENOENT(首次使用)以及任何其它 fs 错误:空台账即合法状态
|
|
171
|
+
return emptyLedger();
|
|
172
|
+
}
|
|
173
|
+
let parsed;
|
|
174
|
+
try {
|
|
175
|
+
parsed = JSON.parse(raw);
|
|
176
|
+
}
|
|
177
|
+
catch {
|
|
178
|
+
// 半截 / 损坏文件:备份后按空台账处理
|
|
179
|
+
await backupCorrupt(file);
|
|
180
|
+
return emptyLedger();
|
|
181
|
+
}
|
|
182
|
+
if (!isLedgerShape(parsed)) {
|
|
183
|
+
// 缺 version / 版本不符 / 结构不完整:备份后按空台账处理
|
|
184
|
+
await backupCorrupt(file);
|
|
185
|
+
return emptyLedger();
|
|
186
|
+
}
|
|
187
|
+
const result = emptyLedger();
|
|
188
|
+
result.projects = parsed.projects;
|
|
189
|
+
result.sessions = parsed.sessions;
|
|
190
|
+
const rawArchived = parsed['archivedProjects'];
|
|
191
|
+
if (isPlainObject(rawArchived)) {
|
|
192
|
+
const archivedProjects = {};
|
|
193
|
+
for (const [key, entry] of Object.entries(rawArchived)) {
|
|
194
|
+
if (!isPlainObject(entry))
|
|
195
|
+
continue;
|
|
196
|
+
archivedProjects[key] = {
|
|
197
|
+
title: typeof entry['title'] === 'string' ? entry['title'] : key,
|
|
198
|
+
...(typeof entry['path'] === 'string' && entry['path'] !== '' ? { path: entry['path'] } : {}),
|
|
199
|
+
isGit: entry['isGit'] === true,
|
|
200
|
+
archivedAt: typeof entry['archivedAt'] === 'number' && Number.isFinite(entry['archivedAt'])
|
|
201
|
+
? entry['archivedAt']
|
|
202
|
+
: 0,
|
|
203
|
+
};
|
|
204
|
+
}
|
|
205
|
+
if (Object.keys(archivedProjects).length > 0) {
|
|
206
|
+
result.archivedProjects = archivedProjects;
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
cached = { ...identity, data: result };
|
|
210
|
+
return result;
|
|
211
|
+
}
|
|
212
|
+
/**
|
|
213
|
+
* 原子写盘:目录 → `<file>.tmp`(0o600)→ fsync → rename。失败清理 tmp。
|
|
214
|
+
*/
|
|
215
|
+
async function writeToDisk(data) {
|
|
216
|
+
const file = await ledgerFile();
|
|
217
|
+
const tmp = `${file}.tmp`;
|
|
218
|
+
try {
|
|
219
|
+
await mkdir(dirname(file), { recursive: true });
|
|
220
|
+
const handle = await open(tmp, 'w', 0o600);
|
|
221
|
+
try {
|
|
222
|
+
await handle.writeFile(`${JSON.stringify(data, null, 2)}\n`, 'utf8');
|
|
223
|
+
await handle.sync();
|
|
224
|
+
}
|
|
225
|
+
finally {
|
|
226
|
+
await handle.close();
|
|
227
|
+
}
|
|
228
|
+
await rename(tmp, file);
|
|
229
|
+
const identity = await fileIdentity(file);
|
|
230
|
+
cached = identity === undefined ? undefined : { ...identity, data };
|
|
231
|
+
}
|
|
232
|
+
catch (error) {
|
|
233
|
+
cached = undefined;
|
|
234
|
+
// 清理半截 tmp,避免目录里残留垃圾
|
|
235
|
+
try {
|
|
236
|
+
await unlink(tmp);
|
|
237
|
+
}
|
|
238
|
+
catch {
|
|
239
|
+
// tmp 可能压根没建起来
|
|
240
|
+
}
|
|
241
|
+
throw error;
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
/** Promise 链尾:保证任一时刻只有一次任务在飞,且失败不会毒化后续任务。 */
|
|
245
|
+
let tail = Promise.resolve();
|
|
246
|
+
/**
|
|
247
|
+
* 把任务追加到串行链尾。
|
|
248
|
+
* - 返回值是**本次任务自己的**结果(不复用共享变量);
|
|
249
|
+
* - `tail` 吞掉本次的成败,所以某次抛错不会让整条链永久卡死。
|
|
250
|
+
*/
|
|
251
|
+
function enqueue(task) {
|
|
252
|
+
const result = tail.then(task, task);
|
|
253
|
+
tail = result.then(() => undefined, () => undefined);
|
|
254
|
+
return result;
|
|
255
|
+
}
|
|
256
|
+
return {
|
|
257
|
+
read() {
|
|
258
|
+
// 公开 read() 契约:返回独立副本(调用方改动不影响缓存 / 下一次读取)。
|
|
259
|
+
return enqueue(async () => structuredClone(await readFromDisk()));
|
|
260
|
+
},
|
|
261
|
+
write(data) {
|
|
262
|
+
return enqueue(() => writeToDisk(data));
|
|
263
|
+
},
|
|
264
|
+
update(fn) {
|
|
265
|
+
return enqueue(async () => {
|
|
266
|
+
const current = await readFromDisk();
|
|
267
|
+
const next = fn(current);
|
|
268
|
+
if (next === current)
|
|
269
|
+
return current; // 同一引用 ⇒ 无变化,跳过写盘(陷阱见 LedgerStore.update 的 JSDoc)
|
|
270
|
+
await writeToDisk(next);
|
|
271
|
+
return next;
|
|
272
|
+
});
|
|
273
|
+
},
|
|
274
|
+
};
|
|
275
|
+
}
|
|
276
|
+
//# sourceMappingURL=ledger.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"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"}
|