mm_datas 5.3.1 → 5.3.2
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/example/custom_demo.js +17 -17
- package/example/preset_demo.js +8 -8
- package/example/rpg_cache.js +39 -39
- package/example/rpg_crud.js +19 -19
- package/example/rpg_demo.js +5 -5
- package/example/rpg_persistence.js +39 -39
- package/example/rpg_relations.js +28 -28
- package/example/rpg_world.js +7 -7
- package/example/storage_demo.js +33 -35
- package/index.js +7 -55
- package/lib/backend.js +35 -569
- package/lib/backend_codec.js +42 -0
- package/lib/cache_adapter.js +112 -0
- package/lib/data_error.js +19 -0
- package/lib/errors.js +11 -10
- package/lib/hybrid_store.js +225 -0
- package/lib/json_db_layout.js +266 -0
- package/lib/json_file_store.js +66 -0
- package/lib/manager.js +234 -507
- package/lib/manager_define.js +131 -0
- package/lib/manager_ext.js +412 -0
- package/lib/manager_helper.js +97 -0
- package/lib/manager_store.js +196 -0
- package/lib/memory_store.js +203 -0
- package/lib/model.js +114 -288
- package/lib/model_check.js +184 -0
- package/lib/model_validator.js +104 -0
- package/lib/mongo_adapter.js +106 -0
- package/lib/pool.js +58 -42
- package/lib/relation.js +81 -55
- package/lib/sql_adapter.js +116 -0
- package/lib/store.js +16 -409
- package/lib/store_query.js +119 -0
- package/lib/tool_scan.js +106 -0
- package/package.json +2 -3
- package/test.js +21 -42
- package/tool/data/index.js +19 -8
- package/tool/data_admin/index.js +38 -0
- package/tool/data_admin/tool.json +42 -0
package/example/custom_demo.js
CHANGED
|
@@ -21,17 +21,17 @@ function title(t) { console.log('\n===== ' + t + ' ====='); }
|
|
|
21
21
|
async function run() {
|
|
22
22
|
mm.dataAdmin.reset();
|
|
23
23
|
title('0. 起点:mm_admin 实例池 + 空注册表');
|
|
24
|
-
|
|
24
|
+
let pool = mm.dataAdmin();
|
|
25
25
|
console.log('池类型:', pool.constructor.name, '/ 绑定的管理类:', pool.getClass().name);
|
|
26
26
|
console.log('mm_admin 全局注册表:', mm.list(), '/ 集合数:', mm.dataAdmin.registry().models().length);
|
|
27
|
-
|
|
27
|
+
let vi = mm.validator();
|
|
28
28
|
console.log('schema 校验器:', vi.package, 'v' + vi.version, '/ 可用工具:', vi.available_tools.length);
|
|
29
29
|
console.log('schema 规范:', vi.schema_draft, '/ 允许类型:', vi.allowed_types.join(' / '));
|
|
30
30
|
console.log('禁用类型:', vi.forbidden_types.join(' / '), '(一律改用 number)');
|
|
31
31
|
|
|
32
32
|
// ---- 1. 静态配置集合:名字、字段、种子全部自定义 ----
|
|
33
33
|
title('1. 自定义静态集合:map / item(标准 JSON Schema)');
|
|
34
|
-
|
|
34
|
+
let map = mm.dataAdmin('map', {
|
|
35
35
|
kind: 'static', key: 'map_id', version: 1,
|
|
36
36
|
schema: {
|
|
37
37
|
$schema: DRAFT, type: 'object',
|
|
@@ -54,7 +54,7 @@ async function run() {
|
|
|
54
54
|
{ map_id: 1002, name: '幽暗森林', safe: false, portals: [{ to: 1001, label: '返回主城' }] }
|
|
55
55
|
]
|
|
56
56
|
});
|
|
57
|
-
|
|
57
|
+
let item = mm.dataAdmin('item', {
|
|
58
58
|
kind: 'static', key: 'item_id', version: 12,
|
|
59
59
|
schema: {
|
|
60
60
|
$schema: DRAFT, type: 'object',
|
|
@@ -77,7 +77,7 @@ async function run() {
|
|
|
77
77
|
|
|
78
78
|
// ---- 2. 动态角色集合:标准 JSON Schema,含嵌套 object / array ----
|
|
79
79
|
title('2. DataManager 角色集合 + 标准 JSON Schema');
|
|
80
|
-
|
|
80
|
+
let role = mm.dataAdmin('role', {
|
|
81
81
|
key: 'role_id',
|
|
82
82
|
schema: {
|
|
83
83
|
$schema: DRAFT, type: 'object',
|
|
@@ -125,7 +125,7 @@ async function run() {
|
|
|
125
125
|
// ---- 3. 运行时声明关联 ----
|
|
126
126
|
title('3. 运行时声明关联(ref / hasMany / snapshot)');
|
|
127
127
|
role.ref('map_id', 'map', { as: 'map_info', select: ['map_id', 'name', 'safe'] });
|
|
128
|
-
|
|
128
|
+
let bag = mm.dataAdmin('bag', {
|
|
129
129
|
key: 'bag_id',
|
|
130
130
|
schema: {
|
|
131
131
|
$schema: DRAFT, type: 'object',
|
|
@@ -147,7 +147,7 @@ async function run() {
|
|
|
147
147
|
|
|
148
148
|
// ---- 4. 写数据 ----
|
|
149
149
|
title('4. 写数据:角色 / 背包');
|
|
150
|
-
|
|
150
|
+
let hero = role.add({
|
|
151
151
|
name: '亚瑟', level: 10, hp: 280, mp: 40, map_id: 1001, x: 300, y: 400,
|
|
152
152
|
attrs: { element: 'fire', power: 12 }, tags: ['tank']
|
|
153
153
|
});
|
|
@@ -165,7 +165,7 @@ async function run() {
|
|
|
165
165
|
// ---- 5. 一次读回完整角色档案 ----
|
|
166
166
|
title('5. 关联展开(with)');
|
|
167
167
|
role.store.calls.list = 0;
|
|
168
|
-
|
|
168
|
+
let full = role.get(hero.id, { with: ['map_info', 'items'] });
|
|
169
169
|
console.log('后端查询次数(本表 + 2 个关联):', role.store.calls.list);
|
|
170
170
|
console.log('角色:', full.name, 'Lv.' + full.level, '/ 所在:', full.map_info.name);
|
|
171
171
|
console.log('背包:', full.items.map(function (b) { return b.item_name + '×' + b.quantity; }).join('、'));
|
|
@@ -174,7 +174,7 @@ async function run() {
|
|
|
174
174
|
title('6. 传送打怪结算 / 引用完整性 / 配置换版');
|
|
175
175
|
role.set(hero.id, { title: '骑士', map_id: 1002, x: 20, y: 800 });
|
|
176
176
|
role.patch(hero.id, { $inc: { gold: 250, exp: 120 } });
|
|
177
|
-
|
|
177
|
+
let moved = role.get(hero.id, { with: ['map_info'] });
|
|
178
178
|
console.log('称号=' + moved.title + ',到达=' + moved.map_info.name +
|
|
179
179
|
',金币=' + moved.gold + ',经验=' + moved.exp);
|
|
180
180
|
console.log('谁持有铁剑(1001):', item.reverse(1001).count, '条背包记录');
|
|
@@ -189,12 +189,12 @@ async function run() {
|
|
|
189
189
|
|
|
190
190
|
// ---- 7. 任意名字 / 独立实例池 ----
|
|
191
191
|
title('7. 任意集合名 / mm_admin 多池隔离');
|
|
192
|
-
|
|
192
|
+
let pet = mm.dataAdmin('宠物');
|
|
193
193
|
pet.add({ name: '小火龙', owner_id: hero.id, element: 'fire' });
|
|
194
194
|
mm.dataAdmin('battle_log').generate(5, {
|
|
195
195
|
role_id: '{{ ref:role.role_id }}', turns: '{{ random(3,12) }}', seq: '{{ $index }}'
|
|
196
196
|
});
|
|
197
|
-
|
|
197
|
+
let w2 = mm.createPool('game2');
|
|
198
198
|
w2.data('role').add({ name: '另一个世界的角色' });
|
|
199
199
|
console.log('集合清单:', mm.dataAdmin.registry().models().map(function (m) { return m.name; }).join(' '));
|
|
200
200
|
console.log('默认池 role 数=' + role.size + ',game2 池 role 数=' + w2.data('role').size);
|
|
@@ -202,26 +202,26 @@ async function run() {
|
|
|
202
202
|
|
|
203
203
|
// ---- 8. 持久化 ----
|
|
204
204
|
title('8. 独立池持久化');
|
|
205
|
-
|
|
206
|
-
|
|
205
|
+
let dir = path.join(os.tmpdir(), 'mm_data_v4_demo');
|
|
206
|
+
let disk = mm.createPool('disk', { store: 'json', dir: dir });
|
|
207
207
|
disk.data('role').add({ name: '存档角色' });
|
|
208
208
|
disk.data('role').save();
|
|
209
|
-
|
|
209
|
+
let restored = mm.createPool('disk_restore', { store: 'json', dir: dir });
|
|
210
210
|
mm.dataAdmin.registry(restored).load();
|
|
211
211
|
console.log('落盘:', dir);
|
|
212
212
|
console.log('恢复:', restored.data('role').get(1).name);
|
|
213
213
|
|
|
214
214
|
// ---- 9. 工具面 ----
|
|
215
215
|
title('9. AI / 工作流工具面');
|
|
216
|
-
|
|
216
|
+
let out = await tool.main({
|
|
217
217
|
action: 'get', model: 'role', query: hero.id, with: ['map_info'], admin: mm.dataAdmin()
|
|
218
218
|
}, {});
|
|
219
219
|
console.log('tool.data:', out.obj.name, '/', out.obj.map_info.name);
|
|
220
|
-
|
|
220
|
+
let v = await tool.main({
|
|
221
221
|
action: 'validate', model: 'role', body: { name: 'x', level: 999 }, admin: mm.dataAdmin()
|
|
222
222
|
}, {});
|
|
223
223
|
console.log('tool.validate:', JSON.stringify(v.obj));
|
|
224
|
-
|
|
224
|
+
let fnTool = mm.getFunctionTool('data');
|
|
225
225
|
console.log('LLM 工具定义:', fnTool.type + '/' + fnTool.function.name,
|
|
226
226
|
'| parameters 字段:', Object.keys(fnTool.function.parameters.properties).join(','));
|
|
227
227
|
console.log('type 通道:', mm.getToolConfig('data').type, '(工作流 data,LLM 视图为 function)');
|
package/example/preset_demo.js
CHANGED
|
@@ -10,31 +10,31 @@
|
|
|
10
10
|
const mm = require('../index.js');
|
|
11
11
|
|
|
12
12
|
// 独立命名空间,不污染默认池 reg('mm_datas')
|
|
13
|
-
|
|
14
|
-
|
|
13
|
+
let pool = mm.createPool('rpg_preset', { models: mm.EXAMPLE_MODEL_DIR });
|
|
14
|
+
let reg = mm.dataAdmin.registry(pool);
|
|
15
15
|
|
|
16
16
|
console.log('显式加载的示例集合:', reg.models().length, '个');
|
|
17
17
|
console.log(reg.models().map(function (m) { return m.name + '(' + m.kind + ')'; }).join(' '));
|
|
18
18
|
console.log('character.schema() 是标准文档:', pool.data('character').schema().$schema,
|
|
19
19
|
'/ type:', pool.data('character').schema().type);
|
|
20
20
|
|
|
21
|
-
|
|
22
|
-
|
|
21
|
+
let map = pool.data('map');
|
|
22
|
+
let town = map.get(1001);
|
|
23
23
|
console.log('\n地图 1001:', town.name, '传送点', town.portals.length, '个');
|
|
24
24
|
|
|
25
|
-
|
|
26
|
-
|
|
25
|
+
let role = pool.data('character');
|
|
26
|
+
let hero = role.add({
|
|
27
27
|
player_id: 1, name: '亚瑟', job_id: 1, level: 10,
|
|
28
28
|
hp: 280, mp: 40, gold: 0, map_id: 1001, x: 300, y: 400, online: true
|
|
29
29
|
});
|
|
30
|
-
|
|
30
|
+
let bag = pool.data('bag');
|
|
31
31
|
bag.addMany([
|
|
32
32
|
{ character_id: hero.id, item_id: 1001, quantity: 1, equipped: true },
|
|
33
33
|
{ character_id: hero.id, item_id: 3001, quantity: 20 }
|
|
34
34
|
]);
|
|
35
35
|
pool.data('character_skill').add({ character_id: hero.id, skill_id: 101, level: 3 });
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
let full = role.get(hero.id, { with: ['job', 'map', 'items', 'skills'] });
|
|
38
38
|
console.log('\n角色档案:', full.name, '/', full.job.name, '/ Lv.' + full.level, '/', full.map.name);
|
|
39
39
|
console.log('背包:', full.items.map(function (b) { return b.item_name + '×' + b.quantity; }).join('、'));
|
|
40
40
|
console.log('完整性:', JSON.stringify(reg.verify()));
|
package/example/rpg_cache.js
CHANGED
|
@@ -27,19 +27,19 @@ class QueryCache {
|
|
|
27
27
|
key(prefix, id) { return prefix + ':' + id; }
|
|
28
28
|
clone(v) { return JSON.parse(JSON.stringify(v)); }
|
|
29
29
|
get(key, loader) {
|
|
30
|
-
|
|
30
|
+
let e = this.map.get(key);
|
|
31
31
|
if (e && e.expireAt > Date.now()) { this.hits++; return this.clone(e.value); }
|
|
32
32
|
this.misses++;
|
|
33
|
-
|
|
33
|
+
let value = loader();
|
|
34
34
|
this.map.set(key, { value: this.clone(value), expireAt: Date.now() + this.ttl });
|
|
35
35
|
return this.clone(value);
|
|
36
36
|
}
|
|
37
37
|
/** 手动让某条过期(演示 TTL 语义,免去 sleep) */
|
|
38
|
-
expire(key) {
|
|
38
|
+
expire(key) { let e = this.map.get(key); if (e) e.expireAt = 0; }
|
|
39
39
|
/** 写操作后按前缀批量失效,避免脏读 */
|
|
40
40
|
invalidate(prefix) {
|
|
41
41
|
let n = 0;
|
|
42
|
-
for (
|
|
42
|
+
for (let k of this.map.keys()) if (k.indexOf(prefix) === 0) { this.map.delete(k); n++; }
|
|
43
43
|
return n;
|
|
44
44
|
}
|
|
45
45
|
stats() { return { hits: this.hits, misses: this.misses, keys: this.map.size }; }
|
|
@@ -47,11 +47,11 @@ class QueryCache {
|
|
|
47
47
|
|
|
48
48
|
async function run() {
|
|
49
49
|
W.title('第 3 章 / 缓存:静态配置、结果缓存、版本钉扎与一致性');
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
50
|
+
let w = W.open('rpg_cache');
|
|
51
|
+
let c = w.c;
|
|
52
|
+
let reg = w.reg;
|
|
53
|
+
let h = w.heroes;
|
|
54
|
+
let store = c.character.store;
|
|
55
55
|
|
|
56
56
|
// ---------- ① 静态配置常驻内存 ----------
|
|
57
57
|
W.title('3.1 第一层:静态配置表就是缓存层');
|
|
@@ -65,15 +65,15 @@ async function run() {
|
|
|
65
65
|
// ---------- ② 预取 + 本地索引 ----------
|
|
66
66
|
W.title('3.2 第二层:整表预取 + 本地 Map 索引');
|
|
67
67
|
store.calls.list = 0;
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
68
|
+
let itemById = new Map(c.item.all().map(function (r) { return [r.item_id, r]; }));
|
|
69
|
+
let skillById = new Map(c.skill.all().map(function (r) { return [r.skill_id, r]; }));
|
|
70
|
+
let mapById = new Map(c.map.all().map(function (r) { return [r.map_id, r]; }));
|
|
71
|
+
let prefetchCalls = store.calls.list;
|
|
72
|
+
let lookups = [];
|
|
73
73
|
for (let i = 0; i < 1000; i++) {
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
74
|
+
let it = itemById.get(1001);
|
|
75
|
+
let sk = skillById.get(101);
|
|
76
|
+
let mp = mapById.get(1001);
|
|
77
77
|
if (i === 0) lookups.push(it.name + ' / ' + sk.name + ' / ' + mp.name);
|
|
78
78
|
}
|
|
79
79
|
W.show('预取 3 张配置表的后端调用', prefetchCalls + ' 次');
|
|
@@ -81,31 +81,31 @@ async function run() {
|
|
|
81
81
|
|
|
82
82
|
// ---------- ③ 查询结果缓存 ----------
|
|
83
83
|
W.title('3.3 第三层:热查询结果缓存(TTL + 写失效)');
|
|
84
|
-
|
|
85
|
-
|
|
84
|
+
let cache = new QueryCache(60000);
|
|
85
|
+
let onlineKey = cache.key('online', 'list');
|
|
86
86
|
store.calls.list = 0;
|
|
87
87
|
const loader = function () { return c.character.list({ online: true }, { order: 'level desc', limit: -1 }).list; };
|
|
88
|
-
|
|
89
|
-
|
|
88
|
+
let a = cache.get(onlineKey, loader);
|
|
89
|
+
let b = cache.get(onlineKey, loader);
|
|
90
90
|
W.show('在线角色(首次 miss / 二次 hit)', a.length + ' 人 / ' + b.length + ' 人,后端只查了 ' + store.calls.list + ' 次');
|
|
91
|
-
|
|
91
|
+
let profileKey = cache.key('profile', h.arthur);
|
|
92
92
|
store.calls.list = 0;
|
|
93
|
-
|
|
93
|
+
let pa = cache.get(profileKey, function () {
|
|
94
94
|
return c.character.get(h.arthur, { with: ['job', 'map', 'items', 'skills'] });
|
|
95
95
|
});
|
|
96
|
-
|
|
96
|
+
let profileCalls = store.calls.list;
|
|
97
97
|
cache.get(profileKey, function () { throw new Error('不应再调用 loader'); });
|
|
98
98
|
W.show('角色档案缓存', pa.name + ' / ' + pa.job.name + ' / 背包 ' + pa.items.length +
|
|
99
99
|
' 件;首次展开 4 个关联共 ' + profileCalls + ' 次后端查询,二次命中 ' + (store.calls.list - profileCalls) + ' 次');
|
|
100
100
|
W.show('缓存统计', cache.stats());
|
|
101
101
|
|
|
102
102
|
// 写入后失效,避免脏读
|
|
103
|
-
|
|
103
|
+
let fresh = c.character.add({
|
|
104
104
|
player_id: 3001, name: '新上线玩家', job_id: 4, map_id: 1001, online: true, level: 5
|
|
105
105
|
});
|
|
106
|
-
|
|
106
|
+
let callsBeforeWrite = store.calls.list;
|
|
107
107
|
cache.invalidate('online:');
|
|
108
|
-
|
|
108
|
+
let after = cache.get(onlineKey, loader);
|
|
109
109
|
W.show('新增在线角色后主动失效', '在线人数 ' + a.length + ' → ' + after.length +
|
|
110
110
|
'(新角色 #' + fresh.id + '),失效后重查 ' + (store.calls.list - callsBeforeWrite) + ' 次后端查询');
|
|
111
111
|
// TTL 过期
|
|
@@ -115,17 +115,17 @@ async function run() {
|
|
|
115
115
|
|
|
116
116
|
// ---------- ④ 版本化缓存键 + ⑤ 快照 ----------
|
|
117
117
|
W.title('3.4 第四层:配置版本钉扎(cfg_ver)让缓存键天然失效');
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
118
|
+
let verBefore = c.item.version;
|
|
119
|
+
let before = c.bag.add({ character_id: fresh.id, item_id: 1001, quantity: 1 });
|
|
120
|
+
let old = c.bag.get(before.id);
|
|
121
121
|
W.show('v' + verBefore + ' 时写入的背包', old.item_name + ' / cfg_ver=' + old.cfg_ver);
|
|
122
|
-
|
|
122
|
+
let nextCfg = c.item.all().map(function (r) {
|
|
123
123
|
if (r.item_id === 1001) { r.name = '精铁剑·改'; r.atk = 22; }
|
|
124
124
|
return r;
|
|
125
125
|
});
|
|
126
126
|
c.item.reload(nextCfg, { version: 14 });
|
|
127
|
-
|
|
128
|
-
|
|
127
|
+
let after2 = c.bag.add({ character_id: fresh.id, item_id: 1001, quantity: 2 });
|
|
128
|
+
let now = c.bag.get(after2.id);
|
|
129
129
|
W.show('v' + c.item.version + ' 时写入的背包', now.item_name + ' / cfg_ver=' + now.cfg_ver);
|
|
130
130
|
W.show('历史记录不受换版影响', old.item_name + ' vs ' + now.item_name);
|
|
131
131
|
|
|
@@ -135,9 +135,9 @@ async function run() {
|
|
|
135
135
|
|
|
136
136
|
W.title('3.5 第五层:写时快照冗余,读时不必 join');
|
|
137
137
|
store.calls.list = 0;
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
138
|
+
let withJoin = c.bag.first({ item_id: 1001 }, { with: ['item'] });
|
|
139
|
+
let afterJoin = store.calls.list;
|
|
140
|
+
let noJoin = c.bag.first({ item_id: 1001 });
|
|
141
141
|
W.show('with 实时展开', '需要 ' + afterJoin + ' 次后端查询 → ' + withJoin.item.name);
|
|
142
142
|
W.show('只读快照字段', '只查 ' + (store.calls.list - afterJoin) + ' 次(省掉配置表那 1 次)→ ' + noJoin.item_name +
|
|
143
143
|
';结算 / 背包列表等高频路径推荐用快照');
|
|
@@ -145,12 +145,12 @@ async function run() {
|
|
|
145
145
|
|
|
146
146
|
// ---------- ⑥ 池隔离 ----------
|
|
147
147
|
W.title('3.6 第六层:配置池 / 玩家池隔离,缓存互不污染');
|
|
148
|
-
|
|
149
|
-
|
|
148
|
+
let cfgPool = W.createWorld('rpg_cache_cfg');
|
|
149
|
+
let playerPool = W.createWorld('rpg_cache_player');
|
|
150
150
|
W.show('两个池的 item 行数', cfgPool.data('item').size + ' / ' + playerPool.data('item').size);
|
|
151
151
|
playerPool.data('item').add({ item_id: 7777, name: '仅玩家池可见', type: 'material' }, { force: true });
|
|
152
152
|
W.show('只往玩家池加一件道具', cfgPool.data('item').size + ' / ' + playerPool.data('item').size);
|
|
153
|
-
|
|
153
|
+
let prevPool = mm.dataAdmin.pool();
|
|
154
154
|
mm.dataAdmin.use(playerPool);
|
|
155
155
|
W.show('dataAdmin.use(玩家池) 后', mm.dataAdmin('item').get(7777).name);
|
|
156
156
|
mm.dataAdmin.use(prevPool);
|
package/example/rpg_crud.js
CHANGED
|
@@ -22,11 +22,11 @@ function names(rows, field) {
|
|
|
22
22
|
|
|
23
23
|
async function run() {
|
|
24
24
|
W.title('第 1 章 / RPG 增删改查与多种取数姿势');
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
25
|
+
let w = W.open('rpg_crud');
|
|
26
|
+
let pool = w.pool;
|
|
27
|
+
let reg = w.reg;
|
|
28
|
+
let c = w.c;
|
|
29
|
+
let h = w.heroes;
|
|
30
30
|
|
|
31
31
|
W.show('集合清单(15 个,静态/动态/中间表)', reg.models().map(function (m) {
|
|
32
32
|
return m.name + '(' + m.kind + ')';
|
|
@@ -60,32 +60,32 @@ async function run() {
|
|
|
60
60
|
}, { limit: 6 }).list));
|
|
61
61
|
W.show('⑧ 字段投影 fields', c.character.list({}, { fields: ['name', 'level'], limit: 3 }).list);
|
|
62
62
|
W.show('⑨ 排序 order', names(c.character.list({}, { order: 'level desc', limit: 5 }).list));
|
|
63
|
-
|
|
64
|
-
|
|
63
|
+
let p1 = c.character.list({}, { limit: 5, order: 'id' });
|
|
64
|
+
let p2 = c.character.list({}, { limit: 5, offset: 5, order: 'id' });
|
|
65
65
|
W.show('⑩ 分页 offset/limit', '总数=' + p1.count + ',第1页=' + names(p1.list) + ',第2页=' + names(p2.list));
|
|
66
|
-
|
|
66
|
+
let p3 = c.character.list({}, { limit: 5, order: 'id', cursor: p1.next_cursor });
|
|
67
67
|
W.show('⑪ 游标翻页 cursor', 'next_cursor=' + p1.next_cursor + ',下一页=' + names(p3.list));
|
|
68
68
|
W.show('⑫ 遍历 API', 'count=' + c.character.count({}) + ',where=' + c.character.where({ online: true }).length +
|
|
69
69
|
',map=' + c.character.map(function (r) { return r.level; }).slice(0, 5).join(',') +
|
|
70
|
-
',for-of 前 3 个=' + (function () {
|
|
70
|
+
',for-of 前 3 个=' + (function () { let out = []; for (let r of c.character) { out.push(r.name); if (out.length === 3) break; } return out.join('、'); })());
|
|
71
71
|
W.show('⑬ 反查 reverse(谁引用了小红药水 3001)', c.item.reverse(3001).count + ' 条记录');
|
|
72
72
|
|
|
73
73
|
// ---------- 3. 写 ----------
|
|
74
74
|
W.title('1.3 写数据:角色 / 背包 / 任务进度');
|
|
75
|
-
|
|
75
|
+
let newbie = c.character.add({
|
|
76
76
|
player_id: 2001, name: '新手剑士', job_id: 1, map_id: 1001, level: 1, hp: 180, mp: 20
|
|
77
77
|
});
|
|
78
78
|
W.show('add 新角色', '#' + newbie.id + ' ' + newbie.obj.name + ' / 默认值 hp=' + newbie.obj.hp);
|
|
79
|
-
|
|
79
|
+
let batch = c.bag.addMany([
|
|
80
80
|
{ character_id: newbie.id, item_id: 1001, quantity: 1 },
|
|
81
81
|
{ character_id: newbie.id, item_id: 3001, quantity: 5 }
|
|
82
82
|
]);
|
|
83
83
|
W.show('addMany 背包', batch.affected + ' 条,ids=' + batch.ids.join(','));
|
|
84
|
-
|
|
84
|
+
let up1 = c.quest_progress.upsert(
|
|
85
85
|
{ character_id: newbie.id, quest_id: 1 },
|
|
86
86
|
{ status: 'active', progress: 0, custom_data: { kills: 0 } }
|
|
87
87
|
);
|
|
88
|
-
|
|
88
|
+
let up2 = c.quest_progress.upsert(
|
|
89
89
|
{ character_id: newbie.id, quest_id: 1 },
|
|
90
90
|
{ status: 'done', progress: 10 }
|
|
91
91
|
);
|
|
@@ -102,7 +102,7 @@ async function run() {
|
|
|
102
102
|
W.show('generate 模板造数后角色总数', c.character.size);
|
|
103
103
|
|
|
104
104
|
W.title('1.4 三层写入拦截(全部抛错,不落盘)');
|
|
105
|
-
|
|
105
|
+
let rejects = [
|
|
106
106
|
['schema 范围', function () { c.character.add({ player_id: 1, name: '越界', job_id: 1, map_id: 1001, level: 0 }); }],
|
|
107
107
|
['schema 类型', function () { c.character.add({ player_id: 1, name: '类型错', job_id: 1, map_id: 1001, level: '高' }); }],
|
|
108
108
|
['必填缺失', function () { c.character.add({ name: '缺字段' }); }],
|
|
@@ -121,21 +121,21 @@ async function run() {
|
|
|
121
121
|
|
|
122
122
|
// ---------- 4. 删 ----------
|
|
123
123
|
W.title('1.5 删除与引用完整性');
|
|
124
|
-
|
|
124
|
+
let refs = c.item.reverse(1001);
|
|
125
125
|
W.show('删道具 1001 之前先反查', refs.count + ' 条引用,来自 ' +
|
|
126
126
|
Array.from(new Set(refs.list.map(function (r) { return r.collection; }))).join(','));
|
|
127
|
-
|
|
127
|
+
let snapshot = c.item.all().map(function (r) { return Object.assign({}, r); });
|
|
128
128
|
c.item.del(1001, { force: true }); // 静态表 force 属于 GM 临时操作,正常应走 reload
|
|
129
129
|
W.show('强删后 verify()', reg.verify());
|
|
130
130
|
c.item.reload(snapshot, { version: 12 });
|
|
131
131
|
W.show('整表恢复后 verify()', reg.verify());
|
|
132
|
-
|
|
132
|
+
let removed = c.bag.del({ character_id: newbie.id, item_id: 3001 });
|
|
133
133
|
W.show('del 动态背包记录', removed.affected + ' 条(带条件,不允许全表删)');
|
|
134
134
|
try { c.bag.del({}); } catch (e) { W.show('无条件下删被拒', e.code); }
|
|
135
135
|
|
|
136
136
|
// ---------- 5. 静态配置换版 ----------
|
|
137
137
|
W.title('1.6 静态配置的正确改法:reload 整表换版');
|
|
138
|
-
|
|
138
|
+
let nextCfg = c.item.all().map(function (r) {
|
|
139
139
|
if (r.item_id === 1001) { r.name = '精铁剑'; r.atk = 18; r.price = 200; }
|
|
140
140
|
return r;
|
|
141
141
|
});
|
|
@@ -146,7 +146,7 @@ async function run() {
|
|
|
146
146
|
|
|
147
147
|
// ---------- 6. 工具面 ----------
|
|
148
148
|
W.title('1.7 AI / 工作流工具面同一种取数');
|
|
149
|
-
|
|
149
|
+
let out = await tool.main({
|
|
150
150
|
action: 'list', model: 'character', query: { online: true },
|
|
151
151
|
options: { fields: ['name', 'level'], order: 'level desc', limit: 3 }, admin: pool
|
|
152
152
|
}, {});
|
package/example/rpg_demo.js
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
* 第 1 章 rpg_crud.js 增删改查 + 13 种取数姿势 + 三层写入拦截
|
|
9
9
|
* 第 2 章 rpg_relations.js 多对一 / 一对多 / 多对多 / 运行时声明关联 / 无 N+1 / 反查
|
|
10
10
|
* 第 3 章 rpg_cache.js 静态配置缓存 / 预取索引 / 结果缓存 / cfg_ver 换版 / 快照 / 池隔离
|
|
11
|
-
* 第 4 章 rpg_persistence.js json store /
|
|
11
|
+
* 第 4 章 rpg_persistence.js json store / auto_save / 重启恢复 / dump 存档 / 配置与玩家数据分工
|
|
12
12
|
*
|
|
13
13
|
* 共用底座:
|
|
14
14
|
* rpg_world.js 建池 + 造初始数据
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
* node example/rpg_persistence.js
|
|
22
22
|
*/
|
|
23
23
|
const W = require('./rpg_world.js');
|
|
24
|
-
|
|
24
|
+
let chapters = [
|
|
25
25
|
{ name: 'CRUD / 取数', mod: require('./rpg_crud.js') },
|
|
26
26
|
{ name: '关联', mod: require('./rpg_relations.js') },
|
|
27
27
|
{ name: '缓存', mod: require('./rpg_cache.js') },
|
|
@@ -33,10 +33,10 @@ async function run() {
|
|
|
33
33
|
console.log('模型目录: ' + W.MODEL_DIR);
|
|
34
34
|
console.log('章节: ' + chapters.map(function (c) { return c.name; }).join(' → '));
|
|
35
35
|
|
|
36
|
-
|
|
36
|
+
let results = [];
|
|
37
37
|
for (let i = 0; i < chapters.length; i++) {
|
|
38
|
-
|
|
39
|
-
|
|
38
|
+
let ch = chapters[i];
|
|
39
|
+
let res = await ch.mod.run();
|
|
40
40
|
results.push({ chapter: ch.name, result: res });
|
|
41
41
|
}
|
|
42
42
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
*
|
|
7
7
|
* 本章覆盖:
|
|
8
8
|
* - memory store(默认)vs json store(每表一个 .json + _tables.json)
|
|
9
|
-
* -
|
|
9
|
+
* - auto_save:写入即落盘;以及手动 save() / load()
|
|
10
10
|
* - 重启模拟:新池 → 先 loadModels 恢复 schema → 再 load 恢复数据
|
|
11
11
|
* - 反例:不带模型定义直接 load,集合会退化成自由集合、schema 校验失效
|
|
12
12
|
* - 整包 dump() 写进业务存档集合(save),按角色 / 存档位读档
|
|
@@ -24,65 +24,65 @@ function fileList(dir) {
|
|
|
24
24
|
|
|
25
25
|
async function run() {
|
|
26
26
|
W.title('第 4 章 / 持久化:存档、重启恢复与配置分工');
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
27
|
+
let stamp = Date.now();
|
|
28
|
+
let autoDir = path.join(os.tmpdir(), 'mm_data_rpg_auto_' + stamp);
|
|
29
|
+
let manualDir = path.join(os.tmpdir(), 'mm_data_rpg_manual_' + stamp);
|
|
30
30
|
|
|
31
31
|
// ---------- 1. 两种 store ----------
|
|
32
32
|
// v5 起「装载了 *_model.json 的池」默认就是 hybrid(data/<集合>/000001.json),
|
|
33
33
|
// 本章想演示纯内存,必须显式写 store:'memory';v5 目录布局另见 storage_demo.js。
|
|
34
34
|
W.title('4.1 显式 memory 不落盘,json store 才写文件(v5 默认 hybrid 见 storage_demo)');
|
|
35
|
-
|
|
35
|
+
let mem = W.createWorld('rpg_persist_mem', { store: 'memory' });
|
|
36
36
|
W.show('内存池后端', mem.getServer().constructor.name);
|
|
37
37
|
W.show('内存池调用 save()', mem.data('character').save());
|
|
38
38
|
W.show('内存池目录不存在', fs.existsSync(path.join(autoDir, 'character.json')) === false);
|
|
39
39
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
W.show('json 池后端', w.pool.getServer().constructor.name + ' /
|
|
40
|
+
let w = W.open('rpg_persist_auto', { store: 'json', dir: autoDir, auto_save: true });
|
|
41
|
+
let c = w.c;
|
|
42
|
+
let reg = w.reg;
|
|
43
|
+
let h = w.heroes;
|
|
44
|
+
W.show('json 池后端', w.pool.getServer().constructor.name + ' / auto_save=' + w.pool.getServer().auto_save);
|
|
45
45
|
W.show('落盘目录', autoDir);
|
|
46
|
-
|
|
46
|
+
let files = fileList(autoDir);
|
|
47
47
|
W.show('生成文件', files.length + ' 个:' + files.slice(0, 6).join('、') + ' …');
|
|
48
48
|
W.show('_tables.json', JSON.parse(fs.readFileSync(path.join(autoDir, '_tables.json'), 'utf8')).length + ' 张表');
|
|
49
49
|
W.show('character.json 前 60 字符', fs.readFileSync(path.join(autoDir, 'character.json'), 'utf8').slice(0, 60).replace(/\s+/g, ' '));
|
|
50
50
|
|
|
51
|
-
// ---------- 2.
|
|
52
|
-
W.title('4.2
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
51
|
+
// ---------- 2. auto_save ----------
|
|
52
|
+
W.title('4.2 auto_save:每次写入自动落盘');
|
|
53
|
+
let charFile = path.join(autoDir, 'character.json');
|
|
54
|
+
let sizeBefore = fs.statSync(charFile).size;
|
|
55
|
+
let savedHero = c.character.add({
|
|
56
56
|
player_id: 4001, name: '存档战士', job_id: 1, map_id: 1001, level: 7, gold: 999
|
|
57
57
|
});
|
|
58
|
-
|
|
58
|
+
let sizeAfter = fs.statSync(charFile).size;
|
|
59
59
|
W.show('新增角色 #' + savedHero.id + ' 后文件变化', sizeBefore + ' → ' + sizeAfter + ' 字节');
|
|
60
|
-
|
|
60
|
+
let onDisk = JSON.parse(fs.readFileSync(charFile, 'utf8'));
|
|
61
61
|
W.show('磁盘上确实有这条记录', onDisk[onDisk.length - 1].name + ' / gold=' + onDisk[onDisk.length - 1].gold);
|
|
62
62
|
c.character.patch(savedHero.id, { $inc: { gold: 1 } });
|
|
63
63
|
W.show('patch 后磁盘金币', JSON.parse(fs.readFileSync(charFile, 'utf8'))[onDisk.length - 1].gold);
|
|
64
64
|
|
|
65
65
|
// ---------- 3. 手动 save / load + 重启模拟 ----------
|
|
66
66
|
W.title('4.3 手动存档与「重启」恢复(先定义,后数据)');
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
67
|
+
let w2 = W.open('rpg_persist_manual', { store: 'json', dir: manualDir });
|
|
68
|
+
let c2 = w2.c;
|
|
69
|
+
let reg2 = w2.reg;
|
|
70
|
+
let h2 = w2.heroes;
|
|
71
71
|
W.show('未 save 前目录存在?', fs.existsSync(manualDir));
|
|
72
|
-
|
|
72
|
+
let leveled = c2.character.add({
|
|
73
73
|
player_id: 5001, name: '手动存档法师', job_id: 2, map_id: 1003, level: 30, gold: 12345
|
|
74
74
|
});
|
|
75
75
|
c2.bag.add({ character_id: leveled.id, item_id: 1003, quantity: 1 });
|
|
76
|
-
W.show('写完后目录存在?', fs.existsSync(manualDir) + '(
|
|
76
|
+
W.show('写完后目录存在?', fs.existsSync(manualDir) + '(auto_save 关闭,需手动 save)');
|
|
77
77
|
W.show('reg.save()', reg2.save());
|
|
78
78
|
W.show('手动落盘文件数', fileList(manualDir).length);
|
|
79
79
|
W.show('存档里的角色数', JSON.parse(fs.readFileSync(path.join(manualDir, 'character.json'), 'utf8')).length);
|
|
80
80
|
|
|
81
81
|
// 模拟进程重启:一个全新的池,先加载模型定义,再恢复数据
|
|
82
|
-
|
|
83
|
-
|
|
82
|
+
let restored = W.createWorld('rpg_persist_restore', { store: 'json', dir: manualDir });
|
|
83
|
+
let regR = mm.dataAdmin.registry(restored);
|
|
84
84
|
W.show('新池恢复 load()', regR.load());
|
|
85
|
-
|
|
85
|
+
let rc = W.collections(restored);
|
|
86
86
|
W.show('恢复后角色数 / 背包数', rc.character.size + ' / ' + rc.bag.size);
|
|
87
87
|
W.show('恢复的那条角色', rc.character.get({ name: '手动存档法师' }).level + ' 级 / gold=' +
|
|
88
88
|
rc.character.get({ name: '手动存档法师' }).gold);
|
|
@@ -93,32 +93,32 @@ async function run() {
|
|
|
93
93
|
|
|
94
94
|
// 反例:不带模型定义直接 load
|
|
95
95
|
W.title('4.4 反例:不带模型定义直接 load 会丢失约束');
|
|
96
|
-
|
|
97
|
-
|
|
96
|
+
let bare = mm.createPool('rpg_persist_bare', { store: 'json', dir: manualDir });
|
|
97
|
+
let regB = mm.dataAdmin.registry(bare);
|
|
98
98
|
regB.load();
|
|
99
|
-
|
|
99
|
+
let bareChar = bare.data('character');
|
|
100
100
|
W.show('裸恢复后的 character', 'constrained=' + bareChar.constrained + ' / schema=' + bareChar.schema());
|
|
101
101
|
bareChar.add({ 随便一个字段: '会被放行' });
|
|
102
102
|
W.show('结论', '恢复玩家数据前必须先 loadModels(或 createPool({models})),否则集合退化成自由集合');
|
|
103
103
|
|
|
104
104
|
// ---------- 4. 业务存档:dump ----------
|
|
105
105
|
W.title('4.5 整包 dump() 写进业务存档集合(按角色 / 存档位)');
|
|
106
|
-
|
|
106
|
+
let dump = reg2.dump();
|
|
107
107
|
W.show('dump() 内容', Object.keys(dump).length + ' 张表 / 共 ' + reg2.stats().total + ' 行');
|
|
108
|
-
|
|
108
|
+
let slot1 = c2.save.add({
|
|
109
109
|
character_id: h2.arthur, slot: 1,
|
|
110
110
|
data: dump, saved_at: '2026-11-18 23:00:00'
|
|
111
111
|
});
|
|
112
|
-
|
|
112
|
+
let slot2 = c2.save.add({
|
|
113
113
|
character_id: h2.arthur, slot: 2,
|
|
114
114
|
data: { character: c2.character.all().filter(function (r) { return r.id === h2.arthur; }) },
|
|
115
115
|
saved_at: '2026-11-18 23:05:00'
|
|
116
116
|
});
|
|
117
117
|
W.show('写入两个存档位', '#' + slot1.id + '(整包) / #' + slot2.id + '(单角色)');
|
|
118
|
-
|
|
118
|
+
let read1 = c2.save.get({ character_id: h2.arthur, slot: 1 });
|
|
119
119
|
W.show('读档 slot1', Object.keys(read1.data).length + ' 张表,其中 character ' +
|
|
120
120
|
read1.data.character.length + ' 行、bag ' + read1.data.bag.length + ' 行');
|
|
121
|
-
|
|
121
|
+
let read2 = c2.save.get({ character_id: h2.arthur, slot: 2 });
|
|
122
122
|
W.show('读档 slot2', read2.data.character[0].name + ' / Lv.' + read2.data.character[0].level);
|
|
123
123
|
W.show('存档集合自身也可落盘', (function () {
|
|
124
124
|
reg2.save();
|
|
@@ -128,13 +128,13 @@ async function run() {
|
|
|
128
128
|
|
|
129
129
|
// ---------- 5. 边界与分工 ----------
|
|
130
130
|
W.title('4.6 边界与持久化分工');
|
|
131
|
-
|
|
132
|
-
|
|
131
|
+
let missingDir = path.join(os.tmpdir(), 'mm_data_rpg_no_such_' + stamp);
|
|
132
|
+
let missingPool = mm.createPool('rpg_persist_missing', { store: 'json', dir: missingDir });
|
|
133
133
|
W.show('load 不存在的目录', mm.dataAdmin.registry(missingPool).load());
|
|
134
134
|
W.show('换目录另存', reg2.save(path.join(os.tmpdir(), 'mm_data_rpg_copy_' + stamp)).dir);
|
|
135
135
|
W.show('静态配置(9 张)', '随模型 JSON 一起发布 → 启动 loadModels 即可,不需要玩家存档');
|
|
136
|
-
W.show('动态数据(6 张)', 'character / bag / character_skill / quest_progress / map_state / save → save/load 或
|
|
137
|
-
W.show('推荐组合', '静态表 = 代码里的模型定义 + seed;动态表 = json store +
|
|
136
|
+
W.show('动态数据(6 张)', 'character / bag / character_skill / quest_progress / map_state / save → save/load 或 auto_save');
|
|
137
|
+
W.show('推荐组合', '静态表 = 代码里的模型定义 + seed;动态表 = json store + auto_save;跨版本靠 cfg_ver 钉扎');
|
|
138
138
|
|
|
139
139
|
W.title('第 4 章完成');
|
|
140
140
|
return { dir: autoDir, tables: fileList(autoDir).length };
|