mm_llm 1.3.0 → 1.3.1

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/lib/sqlite.js CHANGED
@@ -1,6 +1,9 @@
1
1
  'use strict';
2
2
 
3
3
  const { DatabaseSync } = require('node:sqlite');
4
+ const sqlite_session = require('./sqlite_session');
5
+ const sqlite_config = require('./sqlite_config');
6
+ const sqlite_quota = require('./sqlite_quota');
4
7
 
5
8
  /**
6
9
  * SQLite 存储
@@ -66,480 +69,11 @@ class Sqlite {
66
69
  );
67
70
  `);
68
71
  }
69
-
70
- // ---------- 会话消息 ----------
71
- /**
72
- * 追加单条消息
73
- * @param {Number} user_id 用户ID
74
- * @param {Number} agent_id 智能体ID
75
- * @param {Number} session_id 会话ID
76
- * @param {Object} message 消息对象,形如 { role, content }
77
- * @returns {Sqlite} 当前实例
78
- */
79
- addMessage(user_id, agent_id, session_id, message) {
80
- return this.addMessages(user_id, agent_id, session_id, [message]);
81
- }
82
-
83
- /**
84
- * 批量追加消息
85
- * @param {Number} user_id 用户ID
86
- * @param {Number} agent_id 智能体ID
87
- * @param {Number} session_id 会话ID
88
- * @param {Array} messages 消息数组
89
- * @returns {Sqlite} 当前实例
90
- */
91
- addMessages(user_id, agent_id, session_id, messages) {
92
- const user = this._key(user_id);
93
- const agent = this._key(agent_id);
94
- const session = this._key(session_id);
95
- const insert = this._db.prepare(
96
- 'INSERT INTO messages(user_id, agent_id, session_id, seq, message) VALUES(?, ?, ?, ?, ?)'
97
- );
98
- this._transaction(() => {
99
- this._ensureSession(user_id, agent_id, session_id);
100
- const start = this._countMessages(user_id, agent_id, session_id);
101
- for (let i = 0; i < messages.length; i++) {
102
- insert.run(user, agent, session, start + i, JSON.stringify(messages[i]));
103
- }
104
- });
105
- return this;
106
- }
107
-
108
- /**
109
- * 覆盖写入会话消息
110
- * @param {Number} user_id 用户ID
111
- * @param {Number} agent_id 智能体ID
112
- * @param {Number} session_id 会话ID
113
- * @param {Array} messages 消息数组
114
- * @returns {Sqlite} 当前实例
115
- */
116
- setMessages(user_id, agent_id, session_id, messages) {
117
- const user = this._key(user_id);
118
- const agent = this._key(agent_id);
119
- const session = this._key(session_id);
120
- const insert = this._db.prepare(
121
- 'INSERT INTO messages(user_id, agent_id, session_id, seq, message) VALUES(?, ?, ?, ?, ?)'
122
- );
123
- const remove = this._db.prepare(
124
- 'DELETE FROM messages WHERE user_id = ? AND agent_id = ? AND session_id = ?'
125
- );
126
- this._transaction(() => {
127
- this._ensureSession(user_id, agent_id, session_id);
128
- remove.run(user, agent, session);
129
- for (let i = 0; i < messages.length; i++) {
130
- insert.run(user, agent, session, i, JSON.stringify(messages[i]));
131
- }
132
- });
133
- return this;
134
- }
135
-
136
- /**
137
- * 读取会话消息
138
- * @param {Number} user_id 用户ID
139
- * @param {Number} agent_id 智能体ID
140
- * @param {Number} session_id 会话ID
141
- * @returns {Array} 消息数组
142
- */
143
- getMessages(user_id, agent_id, session_id) {
144
- const rows = this._db
145
- .prepare(
146
- 'SELECT message FROM messages WHERE user_id = ? AND agent_id = ? AND session_id = ? ORDER BY seq'
147
- )
148
- .all(this._key(user_id), this._key(agent_id), this._key(session_id));
149
- return rows.map((row) => JSON.parse(row.message));
150
- }
151
-
152
- /**
153
- * 统计会话消息数量
154
- * @param {Number} user_id 用户ID
155
- * @param {Number} agent_id 智能体ID
156
- * @param {Number} session_id 会话ID
157
- * @returns {Number} 消息条数
158
- */
159
- countMessages(user_id, agent_id, session_id) {
160
- return this._countMessages(user_id, agent_id, session_id);
161
- }
162
-
163
- /**
164
- * 判断会话是否存在
165
- * @param {Number} user_id 用户ID
166
- * @param {Number} agent_id 智能体ID
167
- * @param {Number} session_id 会话ID
168
- * @returns {Boolean} 是否存在
169
- */
170
- hasSession(user_id, agent_id, session_id) {
171
- const row = this._db
172
- .prepare(
173
- 'SELECT 1 AS found FROM sessions WHERE user_id = ? AND agent_id = ? AND session_id = ?'
174
- )
175
- .get(this._key(user_id), this._key(agent_id), this._key(session_id));
176
- return Boolean(row);
177
- }
178
-
179
- /**
180
- * 列出全部会话的三元组
181
- * @returns {Array} 形如 [{ user_id, agent_id, session_id }] 的数组
182
- */
183
- listSessions() {
184
- const rows = this._db
185
- .prepare('SELECT user_id, agent_id, session_id FROM sessions ORDER BY rowid')
186
- .all();
187
- return rows.map((row) => ({
188
- user_id: row.user_id,
189
- agent_id: row.agent_id,
190
- session_id: row.session_id
191
- }));
192
- }
193
-
194
- /**
195
- * 删除会话及其消息
196
- * @param {Number} user_id 用户ID
197
- * @param {Number} agent_id 智能体ID
198
- * @param {Number} session_id 会话ID
199
- * @returns {Boolean} 是否删除了已存在的会话
200
- */
201
- delSession(user_id, agent_id, session_id) {
202
- const user = this._key(user_id);
203
- const agent = this._key(agent_id);
204
- const session = this._key(session_id);
205
- const removeMessages = this._db.prepare(
206
- 'DELETE FROM messages WHERE user_id = ? AND agent_id = ? AND session_id = ?'
207
- );
208
- const removeSession = this._db.prepare(
209
- 'DELETE FROM sessions WHERE user_id = ? AND agent_id = ? AND session_id = ?'
210
- );
211
- return this._transaction(() => {
212
- removeMessages.run(user, agent, session);
213
- return removeSession.run(user, agent, session).changes > 0;
214
- });
215
- }
216
-
217
- // ---------- 智能体配置 ----------
218
- /**
219
- * 设置智能体配置(按字段合并)
220
- *
221
- * 合并由 SQLite 的 json_patch 在库内完成,无需先读再写,
222
- * 故多进程并发写时后写入者不会覆盖他人刚改的字段。
223
- * @param {Number} agent_id 智能体ID
224
- * @param {Object} config 配置,含 system_prompt / tools(工具名数组)/ users(允许调用的用户ID数组)
225
- * @returns {Sqlite} 当前实例
226
- */
227
- setAgent(agent_id, config = {}) {
228
- this._db
229
- .prepare(
230
- 'INSERT INTO agents(agent_id, config) VALUES(?, ?) ' +
231
- 'ON CONFLICT(agent_id) DO UPDATE SET config = json_patch(agents.config, excluded.config)'
232
- )
233
- .run(this._key(agent_id), JSON.stringify(config));
234
- return this;
235
- }
236
-
237
- /**
238
- * 读取智能体配置
239
- * @param {Number} agent_id 智能体ID
240
- * @returns {Object} 配置副本,不存在时为空对象
241
- */
242
- getAgent(agent_id) {
243
- const row = this._db.prepare('SELECT config FROM agents WHERE agent_id = ?').get(this._key(agent_id));
244
- if (!row) return {};
245
- const agent = JSON.parse(row.config);
246
- return { ...agent, tools: (agent.tools || []).slice() };
247
- }
248
-
249
- /**
250
- * 删除智能体配置
251
- * @param {Number} agent_id 智能体ID
252
- * @returns {Boolean} 是否删除了已存在的配置
253
- */
254
- delAgent(agent_id) {
255
- const result = this._db.prepare('DELETE FROM agents WHERE agent_id = ?').run(this._key(agent_id));
256
- return result.changes > 0;
257
- }
258
-
259
- // ---------- 工具定义 ----------
260
- /**
261
- * 设置工具定义
262
- *
263
- * 工具定义即提交给模型的函数声明,按工具名全局存放,
264
- * 各智能体通过配置中的工具名数组引用,见 setAgent。
265
- * @param {String} tool_name 工具函数名称
266
- * @param {Object} schema 工具定义,形如 { type, function: { name, description, parameters } }
267
- * @returns {Sqlite} 当前实例
268
- */
269
- setToolSchema(tool_name, schema) {
270
- this._db
271
- .prepare(
272
- 'INSERT INTO tools(tool_name, schema) VALUES(?, ?) ' +
273
- 'ON CONFLICT(tool_name) DO UPDATE SET schema = excluded.schema'
274
- )
275
- .run(this._key(tool_name), JSON.stringify(schema));
276
- return this;
277
- }
278
-
279
- /**
280
- * 读取工具定义
281
- * @param {String} tool_name 工具函数名称
282
- * @returns {Object|undefined} 工具定义,不存在时返回 undefined
283
- */
284
- getToolSchema(tool_name) {
285
- const row = this._db.prepare('SELECT schema FROM tools WHERE tool_name = ?').get(this._key(tool_name));
286
- return row ? JSON.parse(row.schema) : undefined;
287
- }
288
-
289
- /**
290
- * 删除工具定义
291
- * @param {String} tool_name 工具函数名称
292
- * @returns {Boolean} 是否删除了已存在的工具定义
293
- */
294
- delToolSchema(tool_name) {
295
- const result = this._db.prepare('DELETE FROM tools WHERE tool_name = ?').run(this._key(tool_name));
296
- return result.changes > 0;
297
- }
298
-
299
- /**
300
- * 列出已定义的工具名
301
- * @returns {Array} 工具函数名称数组
302
- */
303
- listToolSchemas() {
304
- const rows = this._db.prepare('SELECT tool_name FROM tools ORDER BY rowid').all();
305
- return rows.map((row) => row.tool_name);
306
- }
307
-
308
- /**
309
- * 清空工具定义
310
- * @returns {Sqlite} 当前实例
311
- */
312
- clearToolSchemas() {
313
- this._db.prepare('DELETE FROM tools').run();
314
- return this;
315
- }
316
-
317
- // ---------- 智能体选项 ----------
318
- /**
319
- * 设置智能体选项(按字段合并)
320
- *
321
- * 同一用户对不同智能体可有不同选项,故选项按 (user_id, agent_id) 成对存放。
322
- * 合并由 SQLite 的 json_patch 在库内完成,无需先读再写。
323
- * @param {Number} user_id 用户ID
324
- * @param {Number} agent_id 智能体ID
325
- * @param {Object} options 选项,含 api_key / base_url / model / temperature 等
326
- * @returns {Sqlite} 当前实例
327
- */
328
- setOptions(user_id, agent_id, options = {}) {
329
- this._db
330
- .prepare(
331
- 'INSERT INTO options(user_id, agent_id, value) VALUES(?, ?, ?) ' +
332
- 'ON CONFLICT(user_id, agent_id) DO UPDATE SET ' +
333
- 'value = json_patch(options.value, excluded.value)'
334
- )
335
- .run(this._key(user_id), this._key(agent_id), JSON.stringify(options));
336
- return this;
337
- }
338
-
339
- /**
340
- * 读取智能体选项
341
- * @param {Number} user_id 用户ID
342
- * @param {Number} agent_id 智能体ID
343
- * @returns {Object} 选项副本,不存在时为空对象
344
- */
345
- getOptions(user_id, agent_id) {
346
- const row = this._db
347
- .prepare('SELECT value FROM options WHERE user_id = ? AND agent_id = ?')
348
- .get(this._key(user_id), this._key(agent_id));
349
- return row ? JSON.parse(row.value) : {};
350
- }
351
-
352
- /**
353
- * 删除智能体选项
354
- * @param {Number} user_id 用户ID
355
- * @param {Number} agent_id 智能体ID
356
- * @returns {Boolean} 是否删除了已存在的选项
357
- */
358
- delOptions(user_id, agent_id) {
359
- const result = this._db
360
- .prepare('DELETE FROM options WHERE user_id = ? AND agent_id = ?')
361
- .run(this._key(user_id), this._key(agent_id));
362
- return result.changes > 0;
363
- }
364
-
365
- // ---------- 用户信息 ----------
366
- /**
367
- * 设置用户信息(按字段合并)
368
- *
369
- * 合并由 SQLite 的 json_patch 在库内完成,无需先读再写。
370
- * @param {Number} user_id 用户ID
371
- * @param {Object} config 用户信息,含 name(称呼)/ profile(偏好描述)
372
- * @returns {Sqlite} 当前实例
373
- */
374
- setUser(user_id, config = {}) {
375
- this._db
376
- .prepare(
377
- 'INSERT INTO users(user_id, config) VALUES(?, ?) ' +
378
- 'ON CONFLICT(user_id) DO UPDATE SET config = json_patch(users.config, excluded.config)'
379
- )
380
- .run(this._key(user_id), JSON.stringify(config));
381
- return this;
382
- }
383
-
384
- /**
385
- * 读取用户信息
386
- * @param {Number} user_id 用户ID
387
- * @returns {Object} 用户信息副本,不存在时为空对象
388
- */
389
- getUser(user_id) {
390
- const row = this._db.prepare('SELECT config FROM users WHERE user_id = ?').get(this._key(user_id));
391
- return row ? JSON.parse(row.config) : {};
392
- }
393
-
394
- /**
395
- * 删除用户信息
396
- * @param {Number} user_id 用户ID
397
- * @returns {Boolean} 是否删除了已存在的用户信息
398
- */
399
- delUser(user_id) {
400
- const result = this._db.prepare('DELETE FROM users WHERE user_id = ?').run(this._key(user_id));
401
- return result.changes > 0;
402
- }
403
-
404
- // ---------- 用户配额 ----------
405
- /**
406
- * 读取用户配额
407
- *
408
- * 配额按用户存放(不区分智能体),未设置的用户返回 undefined,
409
- * LLM 会据此视为无配额而拒绝调用。
410
- * @param {Number} user_id 用户ID
411
- * @returns {Number|undefined} 剩余配额
412
- */
413
- getQuota(user_id) {
414
- const row = this._db.prepare('SELECT quota FROM quotas WHERE user_id = ?').get(this._key(user_id));
415
- return row ? row.quota : undefined;
416
- }
417
-
418
- /**
419
- * 设置用户配额
420
- * @param {Number} user_id 用户ID
421
- * @param {Number} quota 剩余配额
422
- * @returns {Sqlite} 当前实例
423
- */
424
- setQuota(user_id, quota) {
425
- this._db
426
- .prepare(
427
- 'INSERT INTO quotas(user_id, quota) VALUES(?, ?) ' +
428
- 'ON CONFLICT(user_id) DO UPDATE SET quota = excluded.quota'
429
- )
430
- .run(this._key(user_id), quota);
431
- return this;
432
- }
433
-
434
- /**
435
- * 增减用户配额
436
- *
437
- * 由 SQLite 在库内完成加减并返回新值,便于调用后一次扣分,
438
- * 避免读改写竞态。
439
- * @param {Number} user_id 用户ID
440
- * @param {Number} delta 增减量,扣分传负数
441
- * @returns {Number} 增减后的配额
442
- */
443
- gainQuota(user_id, delta) {
444
- const row = this._db
445
- .prepare(
446
- 'INSERT INTO quotas(user_id, quota) VALUES(?, ?) ' +
447
- 'ON CONFLICT(user_id) DO UPDATE SET quota = quota + excluded.quota RETURNING quota'
448
- )
449
- .get(this._key(user_id), delta);
450
- return row.quota;
451
- }
452
-
453
- /**
454
- * 删除用户配额
455
- * @param {Number} user_id 用户ID
456
- * @returns {Boolean} 是否删除了已存在的配额
457
- */
458
- delQuota(user_id) {
459
- const result = this._db.prepare('DELETE FROM quotas WHERE user_id = ?').run(this._key(user_id));
460
- return result.changes > 0;
461
- }
462
-
463
- // ---------- 清理 ----------
464
- /**
465
- * 清空全部数据
466
- * @returns {Sqlite} 当前实例
467
- */
468
- clear() {
469
- this._transaction(() => {
470
- this._db.exec(
471
- 'DELETE FROM messages; DELETE FROM sessions; DELETE FROM agents; ' +
472
- 'DELETE FROM tools; DELETE FROM users; DELETE FROM options; DELETE FROM quotas;'
473
- );
474
- });
475
- return this;
476
- }
477
-
478
- /**
479
- * 关闭数据库连接
480
- * @returns {void}
481
- */
482
- close() {
483
- this._db.close();
484
- }
485
-
486
- /**
487
- * 统一存储键的表示(私有方法)
488
- *
489
- * 表的标识列是文本类型,这里显式转换,避免数字与字符串形式
490
- * 落到不同行。
491
- * @param {*} value 原始标识
492
- * @returns {String} 文本标识
493
- */
494
- _key(value) {
495
- return String(value);
496
- }
497
-
498
- /**
499
- * 统计指定会话的消息数量(私有方法)
500
- * @param {Number} user_id 用户ID
501
- * @param {Number} agent_id 智能体ID
502
- * @param {Number} session_id 会话ID
503
- * @returns {Number} 消息条数
504
- */
505
- _countMessages(user_id, agent_id, session_id) {
506
- const row = this._db
507
- .prepare(
508
- 'SELECT COUNT(*) AS total FROM messages WHERE user_id = ? AND agent_id = ? AND session_id = ?'
509
- )
510
- .get(this._key(user_id), this._key(agent_id), this._key(session_id));
511
- return row.total;
512
- }
513
-
514
- /**
515
- * 确保会话存在(私有方法)
516
- * @param {Number} user_id 用户ID
517
- * @param {Number} agent_id 智能体ID
518
- * @param {Number} session_id 会话ID
519
- * @returns {void}
520
- */
521
- _ensureSession(user_id, agent_id, session_id) {
522
- this._db
523
- .prepare('INSERT OR IGNORE INTO sessions(user_id, agent_id, session_id) VALUES(?, ?, ?)')
524
- .run(this._key(user_id), this._key(agent_id), this._key(session_id));
525
- }
526
-
527
- /**
528
- * 在事务中执行写操作(私有方法)
529
- * @param {Function} handler 写操作
530
- * @returns {*} handler 的返回值
531
- */
532
- _transaction(handler) {
533
- this._db.exec('BEGIN');
534
- try {
535
- const result = handler();
536
- this._db.exec('COMMIT');
537
- return result;
538
- } catch (error) {
539
- this._db.exec('ROLLBACK');
540
- throw error;
541
- }
542
- }
543
72
  }
544
73
 
545
- module.exports = { Sqlite };
74
+ // 分区装配:会话消息、配置数据、配额与事务
75
+ sqlite_session.install(Sqlite);
76
+ sqlite_config.install(Sqlite);
77
+ sqlite_quota.install(Sqlite);
78
+
79
+ module.exports = Sqlite;
@@ -0,0 +1,197 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * 配置数据分区
5
+ * @description 装配 Sqlite 的智能体、工具定义、选项与用户信息的读写方法
6
+ */
7
+
8
+ /**
9
+ * 装配配置数据方法到 Sqlite 原型
10
+ * @param {class} Sqlite SQLite 存储类
11
+ */
12
+ function install(Sqlite) {
13
+ /**
14
+ * 设置智能体配置(按字段合并)
15
+ *
16
+ * 合并由 SQLite 的 json_patch 在库内完成,无需先读再写,
17
+ * 故多进程并发写时后写入者不会覆盖他人刚改的字段。
18
+ * @param {Number} agent_id 智能体ID
19
+ * @param {Object} config 配置,含 system_prompt / tools(工具名数组)/ users(允许调用的用户ID数组)
20
+ * @returns {Sqlite} 当前实例
21
+ */
22
+ Sqlite.prototype.setAgent = function (agent_id, config = {}) {
23
+ this._db
24
+ .prepare(
25
+ 'INSERT INTO agents(agent_id, config) VALUES(?, ?) ' +
26
+ 'ON CONFLICT(agent_id) DO UPDATE SET config = json_patch(agents.config, excluded.config)'
27
+ )
28
+ .run(this._key(agent_id), JSON.stringify(config));
29
+ return this;
30
+ };
31
+
32
+ /**
33
+ * 读取智能体配置
34
+ * @param {Number} agent_id 智能体ID
35
+ * @returns {Object} 配置副本,不存在时为空对象
36
+ */
37
+ Sqlite.prototype.getAgent = function (agent_id) {
38
+ let row = this._db.prepare('SELECT config FROM agents WHERE agent_id = ?').get(this._key(agent_id));
39
+ if (!row) return {};
40
+ let agent = JSON.parse(row.config);
41
+ return { ...agent, tools: (agent.tools || []).slice() };
42
+ };
43
+
44
+ /**
45
+ * 删除智能体配置
46
+ * @param {Number} agent_id 智能体ID
47
+ * @returns {Boolean} 是否删除了已存在的配置
48
+ */
49
+ Sqlite.prototype.delAgent = function (agent_id) {
50
+ let result = this._db.prepare('DELETE FROM agents WHERE agent_id = ?').run(this._key(agent_id));
51
+ return result.changes > 0;
52
+ };
53
+
54
+ /**
55
+ * 设置工具定义
56
+ *
57
+ * 工具定义即提交给模型的函数声明,按工具名全局存放,
58
+ * 各智能体通过配置中的工具名数组引用,见 setAgent。
59
+ * @param {String} tool_name 工具函数名称
60
+ * @param {Object} schema 工具定义,形如 { type, function: { name, description, parameters } }
61
+ * @returns {Sqlite} 当前实例
62
+ */
63
+ Sqlite.prototype.setToolSchema = function (tool_name, schema) {
64
+ this._db
65
+ .prepare(
66
+ 'INSERT INTO tools(tool_name, schema) VALUES(?, ?) ' +
67
+ 'ON CONFLICT(tool_name) DO UPDATE SET schema = excluded.schema'
68
+ )
69
+ .run(this._key(tool_name), JSON.stringify(schema));
70
+ return this;
71
+ };
72
+
73
+ /**
74
+ * 读取工具定义
75
+ * @param {String} tool_name 工具函数名称
76
+ * @returns {Object|undefined} 工具定义,不存在时返回 undefined
77
+ */
78
+ Sqlite.prototype.getToolSchema = function (tool_name) {
79
+ let row = this._db.prepare('SELECT schema FROM tools WHERE tool_name = ?').get(this._key(tool_name));
80
+ return row ? JSON.parse(row.schema) : undefined;
81
+ };
82
+
83
+ /**
84
+ * 删除工具定义
85
+ * @param {String} tool_name 工具函数名称
86
+ * @returns {Boolean} 是否删除了已存在的工具定义
87
+ */
88
+ Sqlite.prototype.delToolSchema = function (tool_name) {
89
+ let result = this._db.prepare('DELETE FROM tools WHERE tool_name = ?').run(this._key(tool_name));
90
+ return result.changes > 0;
91
+ };
92
+
93
+ /**
94
+ * 列出已定义的工具名
95
+ * @returns {Array} 工具函数名称数组
96
+ */
97
+ Sqlite.prototype.listToolSchemas = function () {
98
+ let rows = this._db.prepare('SELECT tool_name FROM tools ORDER BY rowid').all();
99
+ return rows.map((row) => row.tool_name);
100
+ };
101
+
102
+ /**
103
+ * 清空工具定义
104
+ * @returns {Sqlite} 当前实例
105
+ */
106
+ Sqlite.prototype.clearToolSchemas = function () {
107
+ this._db.prepare('DELETE FROM tools').run();
108
+ return this;
109
+ };
110
+
111
+ /**
112
+ * 设置智能体选项(按字段合并)
113
+ *
114
+ * 同一用户对不同智能体可有不同选项,故选项按 (user_id, agent_id) 成对存放。
115
+ * 合并由 SQLite 的 json_patch 在库内完成,无需先读再写。
116
+ * @param {Number} user_id 用户ID
117
+ * @param {Number} agent_id 智能体ID
118
+ * @param {Object} options 选项,含 api_key / base_url / model / temperature 等
119
+ * @returns {Sqlite} 当前实例
120
+ */
121
+ Sqlite.prototype.setOptions = function (user_id, agent_id, options = {}) {
122
+ this._db
123
+ .prepare(
124
+ 'INSERT INTO options(user_id, agent_id, value) VALUES(?, ?, ?) ' +
125
+ 'ON CONFLICT(user_id, agent_id) DO UPDATE SET ' +
126
+ 'value = json_patch(options.value, excluded.value)'
127
+ )
128
+ .run(this._key(user_id), this._key(agent_id), JSON.stringify(options));
129
+ return this;
130
+ };
131
+
132
+ /**
133
+ * 读取智能体选项
134
+ * @param {Number} user_id 用户ID
135
+ * @param {Number} agent_id 智能体ID
136
+ * @returns {Object} 选项副本,不存在时为空对象
137
+ */
138
+ Sqlite.prototype.getOptions = function (user_id, agent_id) {
139
+ let row = this._db
140
+ .prepare('SELECT value FROM options WHERE user_id = ? AND agent_id = ?')
141
+ .get(this._key(user_id), this._key(agent_id));
142
+ return row ? JSON.parse(row.value) : {};
143
+ };
144
+
145
+ /**
146
+ * 删除智能体选项
147
+ * @param {Number} user_id 用户ID
148
+ * @param {Number} agent_id 智能体ID
149
+ * @returns {Boolean} 是否删除了已存在的选项
150
+ */
151
+ Sqlite.prototype.delOptions = function (user_id, agent_id) {
152
+ let result = this._db
153
+ .prepare('DELETE FROM options WHERE user_id = ? AND agent_id = ?')
154
+ .run(this._key(user_id), this._key(agent_id));
155
+ return result.changes > 0;
156
+ };
157
+
158
+ /**
159
+ * 设置用户信息(按字段合并)
160
+ *
161
+ * 合并由 SQLite 的 json_patch 在库内完成,无需先读再写。
162
+ * @param {Number} user_id 用户ID
163
+ * @param {Object} config 用户信息,含 name(称呼)/ profile(偏好描述)
164
+ * @returns {Sqlite} 当前实例
165
+ */
166
+ Sqlite.prototype.setUser = function (user_id, config = {}) {
167
+ this._db
168
+ .prepare(
169
+ 'INSERT INTO users(user_id, config) VALUES(?, ?) ' +
170
+ 'ON CONFLICT(user_id) DO UPDATE SET config = json_patch(users.config, excluded.config)'
171
+ )
172
+ .run(this._key(user_id), JSON.stringify(config));
173
+ return this;
174
+ };
175
+
176
+ /**
177
+ * 读取用户信息
178
+ * @param {Number} user_id 用户ID
179
+ * @returns {Object} 用户信息副本,不存在时为空对象
180
+ */
181
+ Sqlite.prototype.getUser = function (user_id) {
182
+ let row = this._db.prepare('SELECT config FROM users WHERE user_id = ?').get(this._key(user_id));
183
+ return row ? JSON.parse(row.config) : {};
184
+ };
185
+
186
+ /**
187
+ * 删除用户信息
188
+ * @param {Number} user_id 用户ID
189
+ * @returns {Boolean} 是否删除了已存在的用户信息
190
+ */
191
+ Sqlite.prototype.delUser = function (user_id) {
192
+ let result = this._db.prepare('DELETE FROM users WHERE user_id = ?').run(this._key(user_id));
193
+ return result.changes > 0;
194
+ };
195
+ }
196
+
197
+ module.exports = { install };