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.
@@ -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
- const pool = mm.dataAdmin();
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
- const vi = mm.validator();
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
- const map = mm.dataAdmin('map', {
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
- const item = mm.dataAdmin('item', {
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
- const role = mm.dataAdmin('role', {
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
- const bag = mm.dataAdmin('bag', {
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
- const hero = role.add({
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
- const full = role.get(hero.id, { with: ['map_info', 'items'] });
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
- const moved = role.get(hero.id, { with: ['map_info'] });
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
- const pet = mm.dataAdmin('宠物');
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
- const w2 = mm.createPool('game2');
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
- const dir = path.join(os.tmpdir(), 'mm_data_v4_demo');
206
- const disk = mm.createPool('disk', { store: 'json', dir: dir });
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
- const restored = mm.createPool('disk_restore', { store: 'json', dir: dir });
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
- const out = await tool.main({
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
- const v = await tool.main({
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
- const fnTool = mm.getFunctionTool('data');
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)');
@@ -10,31 +10,31 @@
10
10
  const mm = require('../index.js');
11
11
 
12
12
  // 独立命名空间,不污染默认池 reg('mm_datas')
13
- const pool = mm.createPool('rpg_preset', { models: mm.EXAMPLE_MODEL_DIR });
14
- const reg = mm.dataAdmin.registry(pool);
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
- const map = pool.data('map');
22
- const town = map.get(1001);
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
- const role = pool.data('character');
26
- const hero = role.add({
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
- const bag = pool.data('bag');
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
- const full = role.get(hero.id, { with: ['job', 'map', 'items', 'skills'] });
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()));
@@ -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
- const e = this.map.get(key);
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
- const value = loader();
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) { const e = this.map.get(key); if (e) e.expireAt = 0; }
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 (const k of this.map.keys()) if (k.indexOf(prefix) === 0) { this.map.delete(k); n++; }
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
- const w = W.open('rpg_cache');
51
- const c = w.c;
52
- const reg = w.reg;
53
- const h = w.heroes;
54
- const store = c.character.store;
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
- const itemById = new Map(c.item.all().map(function (r) { return [r.item_id, r]; }));
69
- const skillById = new Map(c.skill.all().map(function (r) { return [r.skill_id, r]; }));
70
- const mapById = new Map(c.map.all().map(function (r) { return [r.map_id, r]; }));
71
- const prefetchCalls = store.calls.list;
72
- const lookups = [];
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
- const it = itemById.get(1001);
75
- const sk = skillById.get(101);
76
- const mp = mapById.get(1001);
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
- const cache = new QueryCache(60000);
85
- const onlineKey = cache.key('online', 'list');
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
- const a = cache.get(onlineKey, loader);
89
- const b = cache.get(onlineKey, loader);
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
- const profileKey = cache.key('profile', h.arthur);
91
+ let profileKey = cache.key('profile', h.arthur);
92
92
  store.calls.list = 0;
93
- const pa = cache.get(profileKey, function () {
93
+ let pa = cache.get(profileKey, function () {
94
94
  return c.character.get(h.arthur, { with: ['job', 'map', 'items', 'skills'] });
95
95
  });
96
- const profileCalls = store.calls.list;
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
- const fresh = c.character.add({
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
- const callsBeforeWrite = store.calls.list;
106
+ let callsBeforeWrite = store.calls.list;
107
107
  cache.invalidate('online:');
108
- const after = cache.get(onlineKey, loader);
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
- const verBefore = c.item.version;
119
- const before = c.bag.add({ character_id: fresh.id, item_id: 1001, quantity: 1 });
120
- const old = c.bag.get(before.id);
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
- const nextCfg = c.item.all().map(function (r) {
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
- const after2 = c.bag.add({ character_id: fresh.id, item_id: 1001, quantity: 2 });
128
- const now = c.bag.get(after2.id);
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
- const withJoin = c.bag.first({ item_id: 1001 }, { with: ['item'] });
139
- const afterJoin = store.calls.list;
140
- const noJoin = c.bag.first({ item_id: 1001 });
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
- const cfgPool = W.createWorld('rpg_cache_cfg');
149
- const playerPool = W.createWorld('rpg_cache_player');
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
- const prevPool = mm.dataAdmin.pool();
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);
@@ -22,11 +22,11 @@ function names(rows, field) {
22
22
 
23
23
  async function run() {
24
24
  W.title('第 1 章 / RPG 增删改查与多种取数姿势');
25
- const w = W.open('rpg_crud');
26
- const pool = w.pool;
27
- const reg = w.reg;
28
- const c = w.c;
29
- const h = w.heroes;
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
- const p1 = c.character.list({}, { limit: 5, order: 'id' });
64
- const p2 = c.character.list({}, { limit: 5, offset: 5, order: 'id' });
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
- const p3 = c.character.list({}, { limit: 5, order: 'id', cursor: p1.next_cursor });
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 () { const out = []; for (const r of c.character) { out.push(r.name); if (out.length === 3) break; } return out.join('、'); })());
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
- const newbie = c.character.add({
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
- const batch = c.bag.addMany([
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
- const up1 = c.quest_progress.upsert(
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
- const up2 = c.quest_progress.upsert(
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
- const rejects = [
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
- const refs = c.item.reverse(1001);
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
- const snapshot = c.item.all().map(function (r) { return Object.assign({}, r); });
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
- const removed = c.bag.del({ character_id: newbie.id, item_id: 3001 });
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
- const nextCfg = c.item.all().map(function (r) {
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
- const out = await tool.main({
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
  }, {});
@@ -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 / autoSave / 重启恢复 / dump 存档 / 配置与玩家数据分工
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
- const chapters = [
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
- const results = [];
36
+ let results = [];
37
37
  for (let i = 0; i < chapters.length; i++) {
38
- const ch = chapters[i];
39
- const res = await ch.mod.run();
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
- * - autoSave:写入即落盘;以及手动 save() / load()
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
- const stamp = Date.now();
28
- const autoDir = path.join(os.tmpdir(), 'mm_data_rpg_auto_' + stamp);
29
- const manualDir = path.join(os.tmpdir(), 'mm_data_rpg_manual_' + stamp);
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
- const mem = W.createWorld('rpg_persist_mem', { store: 'memory' });
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
- const w = W.open('rpg_persist_auto', { store: 'json', dir: autoDir, autoSave: true });
41
- const c = w.c;
42
- const reg = w.reg;
43
- const h = w.heroes;
44
- W.show('json 池后端', w.pool.getServer().constructor.name + ' / autoSave=' + w.pool.getServer().autoSave);
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
- const files = fileList(autoDir);
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. autoSave ----------
52
- W.title('4.2 autoSave:每次写入自动落盘');
53
- const charFile = path.join(autoDir, 'character.json');
54
- const sizeBefore = fs.statSync(charFile).size;
55
- const savedHero = c.character.add({
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
- const sizeAfter = fs.statSync(charFile).size;
58
+ let sizeAfter = fs.statSync(charFile).size;
59
59
  W.show('新增角色 #' + savedHero.id + ' 后文件变化', sizeBefore + ' → ' + sizeAfter + ' 字节');
60
- const onDisk = JSON.parse(fs.readFileSync(charFile, 'utf8'));
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
- const w2 = W.open('rpg_persist_manual', { store: 'json', dir: manualDir });
68
- const c2 = w2.c;
69
- const reg2 = w2.reg;
70
- const h2 = w2.heroes;
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
- const leveled = c2.character.add({
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) + '(autoSave 关闭,需手动 save)');
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
- const restored = W.createWorld('rpg_persist_restore', { store: 'json', dir: manualDir });
83
- const regR = mm.dataAdmin.registry(restored);
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
- const rc = W.collections(restored);
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
- const bare = mm.createPool('rpg_persist_bare', { store: 'json', dir: manualDir });
97
- const regB = mm.dataAdmin.registry(bare);
96
+ let bare = mm.createPool('rpg_persist_bare', { store: 'json', dir: manualDir });
97
+ let regB = mm.dataAdmin.registry(bare);
98
98
  regB.load();
99
- const bareChar = bare.data('character');
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
- const dump = reg2.dump();
106
+ let dump = reg2.dump();
107
107
  W.show('dump() 内容', Object.keys(dump).length + ' 张表 / 共 ' + reg2.stats().total + ' 行');
108
- const slot1 = c2.save.add({
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
- const slot2 = c2.save.add({
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
- const read1 = c2.save.get({ character_id: h2.arthur, slot: 1 });
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
- const read2 = c2.save.get({ character_id: h2.arthur, slot: 2 });
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
- const missingDir = path.join(os.tmpdir(), 'mm_data_rpg_no_such_' + stamp);
132
- const missingPool = mm.createPool('rpg_persist_missing', { store: 'json', dir: missingDir });
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 或 autoSave');
137
- W.show('推荐组合', '静态表 = 代码里的模型定义 + seed;动态表 = json store + autoSave;跨版本靠 cfg_ver 钉扎');
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 };