dsh-memorytree-rule 0.0.0-stage → 1.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.
@@ -0,0 +1,232 @@
1
+ // lib/runtime.mjs — 插件运行时:路径、库、作用域、主干同步的调度。
2
+ import fs from "node:fs";
3
+ import { resolvePaths, workspaceScope } from "./paths.mjs";
4
+ import { openMemoryDb, getMeta } from "./db.mjs";
5
+ import { MemoryStore } from "./store.mjs";
6
+ import { syncTrunk } from "./ingest.mjs";
7
+ import { checksum } from "./text.mjs";
8
+ import { exportTaskCards } from "./cards.mjs";
9
+ import { captureEmotionEvent } from "./emotion.mjs";
10
+
11
+ const SYNC_THROTTLE_MS = 15000;
12
+
13
+ /** 去掉空字符串,让「留空 = 默认」在行 config / config.json 里都成立。 */
14
+ function stripEmpty(obj) {
15
+ const out = {};
16
+ for (const [k, v] of Object.entries(obj ?? {})) {
17
+ if (v === "" || v === undefined || v === null) continue;
18
+ out[k] = v;
19
+ }
20
+ return out;
21
+ }
22
+
23
+ export class MemoryRuntime {
24
+ constructor(config = {}) {
25
+ // 优先级:行 config > <dataDir>/config.json > 默认值。
26
+ // 情感候选采集默认开启:装上即可用;不想用设 emotionCapture:false,重启后不再采集。
27
+ const defaults = {
28
+ redact: true,
29
+ autoSync: true,
30
+ emotionCapture: true,
31
+ emotionMinScore: 35,
32
+ emotionRetentionDays: 30,
33
+ emotionReviewCostCapCny: 0.3,
34
+ emotionPluginCwdPatterns: [],
35
+ };
36
+ let merged = { ...defaults, ...stripEmpty(config) };
37
+ let paths = resolvePaths(merged);
38
+ try {
39
+ if (fs.existsSync(paths.configFile)) {
40
+ const fileCfg = JSON.parse(fs.readFileSync(paths.configFile, "utf8"));
41
+ if (fileCfg && typeof fileCfg === "object") merged = { ...defaults, ...stripEmpty(fileCfg), ...stripEmpty(config) };
42
+ paths = resolvePaths(merged);
43
+ }
44
+ } catch {
45
+ /* 配置文件坏了就用行 config 与默认值,不阻塞插件加载 */
46
+ }
47
+ this.config = merged;
48
+ this.paths = paths;
49
+ this.db = null;
50
+ this.store = null;
51
+ this.lastSyncAt = 0;
52
+ this.lastSyncResult = null;
53
+ this.lastExec = null;
54
+ this.board = { base: "", token: "", sessionId: null };
55
+ this.registeredTools = [];
56
+ this.toolErrors = [];
57
+ this.lastCaptureError = null;
58
+ this.closed = false;
59
+ }
60
+
61
+ /** 惰性打开库;进程内复用同一个连接。 */
62
+ open() {
63
+ if (this.closed) throw new Error("记忆树已关闭(插件卸载后不能再写入)");
64
+ if (!this.store) {
65
+ this.db = openMemoryDb(this.paths.dbFile);
66
+ this.store = new MemoryStore(this.db, {
67
+ redact: this.config.redact !== false,
68
+ clock: this.config.clock,
69
+ });
70
+ }
71
+ return this.store;
72
+ }
73
+
74
+ close() {
75
+ this.closed = true;
76
+ if (this.store) this.store.close();
77
+ this.store = null;
78
+ this.db = null;
79
+ }
80
+
81
+ /** 记住最近一次工具调用的会话,看板“深度思考”按钮用它把请求送回会话。 */
82
+ noteExec(exec) {
83
+ if (exec) this.lastExec = exec;
84
+ try {
85
+ const id = exec?.agent?.id ?? exec?.agent?.session?.id;
86
+ if (id) this.board.sessionId = String(id);
87
+ } catch {
88
+ /* 形状变化时保持旧值 */
89
+ }
90
+ }
91
+
92
+ /** 没有工具调用时,也可以从 session/event 记住最近活跃的会话。 */
93
+ noteSession(sessionId) {
94
+ if (sessionId) this.board.sessionId = String(sessionId);
95
+ }
96
+
97
+ /**
98
+ * 情感枝采集入口。采集失败只记录,不向会话抛错;显式关闭(emotionCapture:false)时直接跳过。
99
+ * 返回 captureEmotionEvent 的结果,便于调用方决定是否记日志。
100
+ */
101
+ captureEvent(session, event) {
102
+ try {
103
+ const res = captureEmotionEvent(this, session, event);
104
+ if (res && res.ok === false && res.error) this.lastCaptureError = String(res.error);
105
+ return res;
106
+ } catch (err) {
107
+ this.lastCaptureError = err?.message ? String(err.message) : String(err);
108
+ return { ok: false, error: this.lastCaptureError };
109
+ }
110
+ }
111
+
112
+ /** 从工具执行上下文里拿会话工作目录(拿不到就用进程 cwd)。 */
113
+ cwdOf(exec) {
114
+ try {
115
+ const cwd = exec?.agent?.session?.header?.cwd;
116
+ if (cwd && String(cwd).trim() !== "") return String(cwd);
117
+ } catch {
118
+ /* 上下文形状变化时退回进程 cwd */
119
+ }
120
+ return process.cwd();
121
+ }
122
+
123
+ workspaceOf(exec) {
124
+ const cwd = this.cwdOf(exec);
125
+ const scope = workspaceScope(cwd);
126
+ try {
127
+ this.open().rememberScope(scope, cwd);
128
+ } catch {
129
+ /* 别名失败不影响主流程 */
130
+ }
131
+ return { cwd, scope };
132
+ }
133
+
134
+ /**
135
+ * 解析要检索/写入的作用域。
136
+ * requested: 'all'(默认,全库:user + 各 workspace) | 'user' | 'workspace'(当前)
137
+ */
138
+ scopesFor(exec, requested = "all") {
139
+ const ws = this.workspaceOf(exec);
140
+ const want = String(requested ?? "all");
141
+ if (want === "user" || want === "global") return { scopes: ["user"], cwd: ws.cwd, workspace: ws.scope };
142
+ if (want === "workspace" || want === "current") return { scopes: [ws.scope], cwd: ws.cwd, workspace: ws.scope };
143
+ // all = 全库。任务卡/判断叶默认写在 user 后,跨工作区查找也能直接命中。
144
+ let every = [];
145
+ try {
146
+ every = this.open().scopes();
147
+ } catch {
148
+ /* 库还没建好时退回 user + 当前工作区,不让检索整体失败 */
149
+ }
150
+ const list = Array.from(new Set(["user", ws.scope, ...every].filter(Boolean)));
151
+ return { scopes: list, cwd: ws.cwd, workspace: ws.scope };
152
+ }
153
+
154
+ /** 新写入的默认作用域:四枝默认都进 user;项目私有内容显式传 scope=workspace。 */
155
+ defaultScope(_layer, _exec) {
156
+ return "user";
157
+ }
158
+
159
+ /**
160
+ * 主干同步:AGENTS.md 变了才写库;文件没变时只是读文件校验(很快)。
161
+ * silent=true 时不抛错(工具调用不该因为文件权限失败而整体失败)。
162
+ */
163
+ ensureTrunk(exec, opts = {}) {
164
+ if (this.config.autoSync === false && opts.force !== true) return { skipped: true, reason: "autoSync 已关闭" };
165
+ const now = Date.now();
166
+ if (!opts.force && now - this.lastSyncAt < SYNC_THROTTLE_MS && this.lastSyncResult) return this.lastSyncResult;
167
+ if (!fs.existsSync(this.paths.agentsPath)) {
168
+ this.lastSyncAt = now;
169
+ this.lastSyncResult = { ok: false, reason: "主干文件不存在:" + this.paths.agentsPath };
170
+ return this.lastSyncResult;
171
+ }
172
+ let raw;
173
+ try {
174
+ raw = fs.readFileSync(this.paths.agentsPath, "utf8");
175
+ } catch (err) {
176
+ this.lastSyncAt = now;
177
+ this.lastSyncResult = { ok: false, reason: "读不到主干文件:" + (err && err.message ? err.message : String(err)) };
178
+ return this.lastSyncResult;
179
+ }
180
+ const store = this.open();
181
+ const sum = checksum(raw);
182
+ const prev = getMeta(this.db, "agents_checksum", null);
183
+ if (!opts.force && prev === sum) {
184
+ this.lastSyncAt = now;
185
+ this.lastSyncResult = { ok: true, changed: false, skipped: true, path: this.paths.agentsPath, rules: Number(getMeta(this.db, "agents_rules", "0")) };
186
+ return this.lastSyncResult;
187
+ }
188
+ try {
189
+ this.lastSyncResult = syncTrunk(store, this.paths.agentsPath, { scope: "user" });
190
+ } catch (err) {
191
+ this.lastSyncResult = { ok: false, error: err && err.message ? err.message : String(err) };
192
+ }
193
+ this.lastSyncAt = Date.now();
194
+ return this.lastSyncResult;
195
+ }
196
+
197
+ /** 看板写 AGENTS.md 时用的路径与备份目录。 */
198
+ trunkWriteOptions() {
199
+ return { agentsPath: this.paths.agentsPath, backupDir: this.paths.backupDir };
200
+ }
201
+
202
+ /**
203
+ * 把任务枝卡导出成 <dataDir>/cards.json,供外部插件启动时读取。
204
+ * 写成临时文件再 rename,避免插件读到半截 JSON。
205
+ */
206
+ exportCards() {
207
+ return exportTaskCards(this.open(), this.paths.dataDir);
208
+ }
209
+
210
+ /** 给报告/状态用的环境信息。 */
211
+ info() {
212
+ const store = this.open();
213
+ const st = store.stats();
214
+ return {
215
+ paths: this.paths,
216
+ config: {
217
+ redact: this.config.redact !== false,
218
+ autoSync: this.config.autoSync !== false,
219
+ emotionCapture: this.config.emotionCapture === true,
220
+ emotionMinScore: Number(this.config.emotionMinScore ?? 35),
221
+ emotionRetentionDays: Number(this.config.emotionRetentionDays ?? 30),
222
+ emotionReviewCostCapCny: Number(this.config.emotionReviewCostCapCny ?? 0.3),
223
+ emotionPluginCwdPatterns: Array.isArray(this.config.emotionPluginCwdPatterns) ? this.config.emotionPluginCwdPatterns : [],
224
+ },
225
+ dbExists: fs.existsSync(this.paths.dbFile),
226
+ dbBytes: fs.existsSync(this.paths.dbFile) ? fs.statSync(this.paths.dbFile).size : 0,
227
+ legacyExists: fs.existsSync(this.paths.legacyDb),
228
+ agentsExists: fs.existsSync(this.paths.agentsPath),
229
+ stats: st,
230
+ };
231
+ }
232
+ }
package/lib/schema.mjs ADDED
@@ -0,0 +1,363 @@
1
+ // lib/schema.mjs — 库结构、版本迁移。
2
+ //
3
+ // 设计:
4
+ // - node 是唯一「记忆条目」表;layer 表达四枝,status 表达生命周期,scope 表达作用域。
5
+ // - term / vec 是派生索引,随时可由 node.text 重建(memory_admin action=reindex)。
6
+ // - audit 只追加,用于「谁在什么时候查过什么、命中了什么」的审计,不参与检索。
7
+ // - 主干正本仍是 AGENTS.md:trunk 行是从文件同步来的索引副本(source=AGENTS.md#Lx-Ly),
8
+ // 不在这里直接编辑(要改就改 AGENTS.md,再 sync)。这样不产生第二个注入源。
9
+ export const SCHEMA_VERSION = 6;
10
+
11
+ export const LAYERS = ["trunk", "emotion", "task", "leaf"];
12
+ export const STATUSES = ["active", "candidate", "superseded", "archived"];
13
+ export const KINDS = ["rule", "card", "note", "pointer", "section", "session"];
14
+
15
+ // v6:情感枝自动收录的两张表(可选功能)。候选只存节选(默认 30 天清),review 记每天日结的账。
16
+ // 新库走 SCHEMA_SQL,旧库走 MIGRATIONS[6],两处共用同一段 SQL,避免结构分叉。
17
+ const EMOTION_TABLES_SQL = `
18
+ CREATE TABLE IF NOT EXISTS emotion_candidate (
19
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
20
+ day TEXT NOT NULL,
21
+ ts INTEGER NOT NULL,
22
+ session_id TEXT NOT NULL DEFAULT '',
23
+ cwd TEXT NOT NULL DEFAULT '',
24
+ role TEXT NOT NULL,
25
+ category TEXT NOT NULL,
26
+ score INTEGER NOT NULL DEFAULT 0,
27
+ reasons TEXT NOT NULL DEFAULT '[]',
28
+ text TEXT NOT NULL,
29
+ context TEXT NOT NULL DEFAULT '',
30
+ dedupe TEXT NOT NULL UNIQUE,
31
+ status TEXT NOT NULL DEFAULT 'pending',
32
+ node_id INTEGER,
33
+ created_at INTEGER NOT NULL,
34
+ updated_at INTEGER NOT NULL
35
+ );
36
+ CREATE INDEX IF NOT EXISTS emotion_candidate_day ON emotion_candidate(day, status, score DESC);
37
+
38
+ CREATE TABLE IF NOT EXISTS emotion_review (
39
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
40
+ day TEXT NOT NULL,
41
+ session_id TEXT NOT NULL DEFAULT '',
42
+ candidates INTEGER NOT NULL DEFAULT 0,
43
+ written INTEGER NOT NULL DEFAULT 0,
44
+ dismissed INTEGER NOT NULL DEFAULT 0,
45
+ cost_cny REAL NOT NULL DEFAULT 0,
46
+ tokens INTEGER NOT NULL DEFAULT 0,
47
+ status TEXT NOT NULL DEFAULT 'done',
48
+ note TEXT NOT NULL DEFAULT '',
49
+ created_at INTEGER NOT NULL
50
+ );
51
+ CREATE INDEX IF NOT EXISTS emotion_review_day ON emotion_review(day);
52
+ `;
53
+
54
+ const SCHEMA_SQL = `
55
+ CREATE TABLE IF NOT EXISTS meta (
56
+ key TEXT PRIMARY KEY,
57
+ value TEXT NOT NULL
58
+ );
59
+
60
+ CREATE TABLE IF NOT EXISTS node (
61
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
62
+ uid TEXT NOT NULL UNIQUE,
63
+ scope TEXT NOT NULL,
64
+ layer TEXT NOT NULL,
65
+ kind TEXT NOT NULL DEFAULT 'note',
66
+ status TEXT NOT NULL DEFAULT 'active',
67
+ subject TEXT NOT NULL DEFAULT '',
68
+ title TEXT NOT NULL DEFAULT '',
69
+ text TEXT NOT NULL,
70
+ summary TEXT,
71
+ tags TEXT NOT NULL DEFAULT '[]',
72
+ source TEXT NOT NULL DEFAULT 'manual',
73
+ evidence TEXT,
74
+ trust INTEGER NOT NULL DEFAULT 70,
75
+ importance REAL NOT NULL DEFAULT 0.5,
76
+ half_life_days REAL NOT NULL DEFAULT 0,
77
+ valid_until INTEGER,
78
+ superseded_by INTEGER,
79
+ checksum TEXT NOT NULL,
80
+ len REAL NOT NULL DEFAULT 0,
81
+ ts INTEGER NOT NULL,
82
+ created_at INTEGER NOT NULL,
83
+ updated_at INTEGER NOT NULL
84
+ );
85
+ CREATE INDEX IF NOT EXISTS node_scope_layer ON node(scope, layer, status);
86
+ CREATE INDEX IF NOT EXISTS node_subject ON node(subject);
87
+ CREATE INDEX IF NOT EXISTS node_uid ON node(uid);
88
+ CREATE INDEX IF NOT EXISTS node_status ON node(status);
89
+
90
+ CREATE TABLE IF NOT EXISTS term (
91
+ node_id INTEGER NOT NULL,
92
+ term TEXT NOT NULL,
93
+ tf REAL NOT NULL,
94
+ PRIMARY KEY (node_id, term)
95
+ ) WITHOUT ROWID;
96
+ CREATE INDEX IF NOT EXISTS term_term ON term(term);
97
+
98
+ CREATE TABLE IF NOT EXISTS vec (
99
+ node_id INTEGER PRIMARY KEY,
100
+ dim INTEGER NOT NULL,
101
+ kind TEXT NOT NULL,
102
+ data BLOB NOT NULL
103
+ );
104
+
105
+ CREATE TABLE IF NOT EXISTS audit (
106
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
107
+ ts INTEGER NOT NULL,
108
+ kind TEXT NOT NULL,
109
+ scope TEXT,
110
+ query TEXT,
111
+ hits INTEGER,
112
+ detail TEXT
113
+ );
114
+ CREATE INDEX IF NOT EXISTS audit_ts ON audit(ts);
115
+
116
+ CREATE TABLE IF NOT EXISTS scope_alias (
117
+ scope TEXT PRIMARY KEY,
118
+ cwd TEXT,
119
+ label TEXT,
120
+ last_seen INTEGER
121
+ );
122
+
123
+ CREATE TABLE IF NOT EXISTS revision (
124
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
125
+ ts INTEGER NOT NULL,
126
+ action TEXT NOT NULL,
127
+ node_id INTEGER,
128
+ uid TEXT,
129
+ detail TEXT
130
+ );
131
+
132
+ CREATE TABLE IF NOT EXISTS diary (
133
+ date TEXT PRIMARY KEY,
134
+ text TEXT NOT NULL,
135
+ mood TEXT NOT NULL DEFAULT '',
136
+ created_at INTEGER NOT NULL,
137
+ updated_at INTEGER NOT NULL
138
+ );
139
+
140
+ CREATE TABLE IF NOT EXISTS placement (
141
+ id TEXT PRIMARY KEY,
142
+ node_id INTEGER,
143
+ text TEXT NOT NULL,
144
+ title TEXT NOT NULL DEFAULT '',
145
+ scope TEXT NOT NULL DEFAULT 'user',
146
+ kind TEXT NOT NULL DEFAULT 'task',
147
+ status TEXT NOT NULL DEFAULT 'pending',
148
+ recommended_subject TEXT NOT NULL DEFAULT '',
149
+ recommended_title TEXT NOT NULL DEFAULT '',
150
+ recommended_group TEXT NOT NULL DEFAULT '',
151
+ reason TEXT NOT NULL DEFAULT '',
152
+ session_id TEXT NOT NULL DEFAULT '',
153
+ created_at INTEGER NOT NULL,
154
+ updated_at INTEGER NOT NULL
155
+ );
156
+ CREATE INDEX IF NOT EXISTS placement_status ON placement(status, updated_at);
157
+
158
+ CREATE TABLE IF NOT EXISTS pending_patch (
159
+ id TEXT PRIMARY KEY,
160
+ node_id INTEGER,
161
+ uid TEXT NOT NULL,
162
+ title TEXT NOT NULL DEFAULT '',
163
+ old_num TEXT NOT NULL,
164
+ new_num TEXT NOT NULL,
165
+ old_text TEXT NOT NULL,
166
+ new_text TEXT NOT NULL,
167
+ kind TEXT NOT NULL DEFAULT 'text',
168
+ base_checksum TEXT NOT NULL DEFAULT '',
169
+ status TEXT NOT NULL DEFAULT 'pending',
170
+ batch_id TEXT,
171
+ created_at INTEGER NOT NULL,
172
+ updated_at INTEGER NOT NULL
173
+ );
174
+ CREATE INDEX IF NOT EXISTS pending_patch_status ON pending_patch(status, updated_at);
175
+ CREATE INDEX IF NOT EXISTS pending_patch_uid ON pending_patch(uid);
176
+
177
+ CREATE TABLE IF NOT EXISTS patch_batch (
178
+ id TEXT PRIMARY KEY,
179
+ status TEXT NOT NULL DEFAULT 'applied',
180
+ base_checksum TEXT NOT NULL DEFAULT '',
181
+ plan_json TEXT,
182
+ backup TEXT,
183
+ rules INTEGER NOT NULL DEFAULT 0,
184
+ refs INTEGER NOT NULL DEFAULT 0,
185
+ error TEXT,
186
+ created_at INTEGER NOT NULL,
187
+ applied_at INTEGER
188
+ );
189
+ CREATE INDEX IF NOT EXISTS patch_batch_created ON patch_batch(created_at);
190
+
191
+ CREATE TABLE IF NOT EXISTS trunk_bucket (
192
+ uid TEXT PRIMARY KEY,
193
+ bucket TEXT NOT NULL,
194
+ updated_at INTEGER NOT NULL
195
+ );
196
+ ${EMOTION_TABLES_SQL}`;
197
+
198
+ const MIGRATIONS = {
199
+ // v2:日记索引表(每天一条,属于情感枝的索引,不是第六枝)。
200
+ 2: (db) => {
201
+ db.exec(`CREATE TABLE IF NOT EXISTS diary (
202
+ date TEXT PRIMARY KEY,
203
+ text TEXT NOT NULL,
204
+ mood TEXT NOT NULL DEFAULT '',
205
+ created_at INTEGER NOT NULL,
206
+ updated_at INTEGER NOT NULL
207
+ )`);
208
+ },
209
+ // v3:看板「待写入哪条枝」的持久化请求(跨页面/刷新保留)。
210
+ 3: (db) => {
211
+ db.exec(`CREATE TABLE IF NOT EXISTS placement (
212
+ id TEXT PRIMARY KEY,
213
+ node_id INTEGER,
214
+ text TEXT NOT NULL,
215
+ title TEXT NOT NULL DEFAULT '',
216
+ scope TEXT NOT NULL DEFAULT 'user',
217
+ kind TEXT NOT NULL DEFAULT 'task',
218
+ status TEXT NOT NULL DEFAULT 'pending',
219
+ recommended_subject TEXT NOT NULL DEFAULT '',
220
+ recommended_title TEXT NOT NULL DEFAULT '',
221
+ recommended_group TEXT NOT NULL DEFAULT '',
222
+ reason TEXT NOT NULL DEFAULT '',
223
+ session_id TEXT NOT NULL DEFAULT '',
224
+ created_at INTEGER NOT NULL,
225
+ updated_at INTEGER NOT NULL
226
+ );
227
+ CREATE INDEX IF NOT EXISTS placement_status ON placement(status, updated_at);`);
228
+ },
229
+ // v4:判断叶「待确定写入」补丁 + 已写入批次记录。
230
+ 4: (db) => {
231
+ db.exec(`CREATE TABLE IF NOT EXISTS pending_patch (
232
+ id TEXT PRIMARY KEY,
233
+ node_id INTEGER,
234
+ uid TEXT NOT NULL,
235
+ title TEXT NOT NULL DEFAULT '',
236
+ old_num TEXT NOT NULL,
237
+ new_num TEXT NOT NULL,
238
+ old_text TEXT NOT NULL,
239
+ new_text TEXT NOT NULL,
240
+ kind TEXT NOT NULL DEFAULT 'text',
241
+ base_checksum TEXT NOT NULL DEFAULT '',
242
+ status TEXT NOT NULL DEFAULT 'pending',
243
+ batch_id TEXT,
244
+ created_at INTEGER NOT NULL,
245
+ updated_at INTEGER NOT NULL
246
+ );
247
+ CREATE INDEX IF NOT EXISTS pending_patch_status ON pending_patch(status, updated_at);
248
+ CREATE INDEX IF NOT EXISTS pending_patch_uid ON pending_patch(uid);
249
+ CREATE TABLE IF NOT EXISTS patch_batch (
250
+ id TEXT PRIMARY KEY,
251
+ status TEXT NOT NULL DEFAULT 'applied',
252
+ base_checksum TEXT NOT NULL DEFAULT '',
253
+ plan_json TEXT,
254
+ backup TEXT,
255
+ rules INTEGER NOT NULL DEFAULT 0,
256
+ refs INTEGER NOT NULL DEFAULT 0,
257
+ error TEXT,
258
+ created_at INTEGER NOT NULL,
259
+ applied_at INTEGER
260
+ );
261
+ CREATE INDEX IF NOT EXISTS patch_batch_created ON patch_batch(created_at);`);
262
+ },
263
+ // v5:主干大标题(看板折叠分组,由用户指定;不改 AGENTS.md)。
264
+ // 只存「覆盖」:没有记录的规则仍按 §1 编号自动分组。
265
+ 5: (db) => {
266
+ db.exec(`CREATE TABLE IF NOT EXISTS trunk_bucket (
267
+ uid TEXT PRIMARY KEY,
268
+ bucket TEXT NOT NULL,
269
+ updated_at INTEGER NOT NULL
270
+ )`);
271
+ },
272
+ // v6:情感枝自动收录的候选表与日结 review 表。
273
+ 6: (db) => {
274
+ db.exec(EMOTION_TABLES_SQL);
275
+ },
276
+ };
277
+
278
+ export function currentVersion(db) {
279
+ const row = db.prepare("PRAGMA user_version").get();
280
+ const v = row ? Object.values(row)[0] : 0;
281
+ return Number(v) || 0;
282
+ }
283
+
284
+ function hasTable(db, name) {
285
+ const row = db.prepare("SELECT 1 AS ok FROM sqlite_master WHERE type='table' AND name=?").get(name);
286
+ return Boolean(row);
287
+ }
288
+
289
+ // 旧 v0 库可能只有 node 的一部分列。按当前结构补齐;uid/checksum 这类唯一键单独填值。
290
+ function repairNodeColumns(db) {
291
+ const have = new Set(db.prepare("PRAGMA table_info(node)").all().map((c) => c.name));
292
+ const columns = [
293
+ ["uid", "TEXT NOT NULL DEFAULT ''"],
294
+ ["scope", "TEXT NOT NULL DEFAULT 'user'"],
295
+ ["layer", "TEXT NOT NULL DEFAULT 'leaf'"],
296
+ ["kind", "TEXT NOT NULL DEFAULT 'note'"],
297
+ ["status", "TEXT NOT NULL DEFAULT 'active'"],
298
+ ["subject", "TEXT NOT NULL DEFAULT ''"],
299
+ ["title", "TEXT NOT NULL DEFAULT ''"],
300
+ ["text", "TEXT NOT NULL DEFAULT ''"],
301
+ ["summary", "TEXT"],
302
+ ["tags", "TEXT NOT NULL DEFAULT '[]'"],
303
+ ["source", "TEXT NOT NULL DEFAULT 'manual'"],
304
+ ["evidence", "TEXT"],
305
+ ["trust", "INTEGER NOT NULL DEFAULT 70"],
306
+ ["importance", "REAL NOT NULL DEFAULT 0.5"],
307
+ ["half_life_days", "REAL NOT NULL DEFAULT 0"],
308
+ ["valid_until", "INTEGER"],
309
+ ["superseded_by", "INTEGER"],
310
+ ["checksum", "TEXT NOT NULL DEFAULT ''"],
311
+ ["len", "REAL NOT NULL DEFAULT 0"],
312
+ ["ts", "INTEGER NOT NULL DEFAULT 0"],
313
+ ["created_at", "INTEGER NOT NULL DEFAULT 0"],
314
+ ["updated_at", "INTEGER NOT NULL DEFAULT 0"],
315
+ ];
316
+ for (const [name, decl] of columns) {
317
+ if (!have.has(name)) db.exec("ALTER TABLE node ADD COLUMN " + name + " " + decl);
318
+ }
319
+ // 旧行没有 uid/checksum:用主键生成稳定且唯一的值,避免唯一索引失败。
320
+ db.exec("UPDATE node SET uid='legacy-node:'||id||'-'||lower(hex(randomblob(4))) WHERE uid IS NULL OR uid=''");
321
+ db.exec("UPDATE node SET checksum='legacy-'||id WHERE checksum IS NULL OR checksum=''");
322
+ db.exec("CREATE UNIQUE INDEX IF NOT EXISTS node_uid_unique ON node(uid)");
323
+ }
324
+
325
+ export function migrate(db) {
326
+ let v = currentVersion(db);
327
+ // v0 且已有 node 表:这是未写 user_version 的旧库/半建库。
328
+ // 不能直接把版本设成 5,否则缺列的库会在第一次查询时才炸;先补齐 node 的关键列。
329
+ if (v === 0 && hasTable(db, "node")) {
330
+ repairNodeColumns(db);
331
+ }
332
+ db.exec(SCHEMA_SQL);
333
+ if (v === 0) {
334
+ db.exec("PRAGMA user_version = " + SCHEMA_VERSION);
335
+ v = SCHEMA_VERSION;
336
+ }
337
+ while (v < SCHEMA_VERSION) {
338
+ const next = v + 1;
339
+ const fn = MIGRATIONS[next];
340
+ if (typeof fn !== "function") throw new Error("缺少 v" + next + " 的迁移函数");
341
+ db.exec("BEGIN IMMEDIATE");
342
+ try {
343
+ fn(db);
344
+ db.exec("PRAGMA user_version = " + next);
345
+ db.exec("COMMIT");
346
+ } catch (e) {
347
+ db.exec("ROLLBACK");
348
+ throw e;
349
+ }
350
+ v = next;
351
+ }
352
+ if (v > SCHEMA_VERSION) {
353
+ throw new Error(
354
+ "数据库版本 v" + v + " 比插件支持的 v" + SCHEMA_VERSION + " 新:请升级插件,或先备份后另存一份库再打开。",
355
+ );
356
+ }
357
+ try {
358
+ db.prepare("INSERT INTO meta(key,value) VALUES('schema_version',?) ON CONFLICT(key) DO UPDATE SET value=excluded.value").run(String(SCHEMA_VERSION));
359
+ } catch {
360
+ /* meta 写失败不影响主流程 */
361
+ }
362
+ return v;
363
+ }