dsh-hsr 0.2.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/index.js CHANGED
@@ -1,8 +1,14 @@
1
1
  /**
2
2
  * dsh-hsr —— 《崩坏:星穹铁道》资料查询插件。
3
3
  *
4
- * 只对外提供一个工具 `hsr`,参数是一行 flag 文本。取数、匹配、裁剪都在内部完成,
5
- * 对外不暴露任何地址、文件名或中间步骤。
4
+ * 对外提供五个工具,参数都是一行 flag 文本:
5
+ * - `hsr-find` 查角色、光锥、遗器套装,或列清单;
6
+ * - `hsr-help` 用法说明;
7
+ * - `hsr-rule` 查询规则与游戏规则知识库;
8
+ * - `hsr-exp` 查询经验与配队经验;
9
+ * - `hsr-stage` 查当前深渊关卡与主怪特点。
10
+ *
11
+ * 取数、匹配、裁剪都在内部完成,对外不暴露任何地址、文件名或中间步骤。
6
12
  */
7
13
 
8
14
  import fs from 'node:fs';
@@ -10,12 +16,25 @@ import path from 'node:path';
10
16
  import { fileURLToPath } from 'node:url';
11
17
 
12
18
  import { clearModelNotes, loadNotes, notePaths, readUserNotes, writeUserNotes } from './experience.js';
19
+ import { renderHelp } from './help.js';
13
20
  import { readSection, renderIndex } from './knowledge.js';
14
21
  import { findEntries, isNicknameQuery, normalizeName } from './match.js';
15
22
  import { renderCharacter, renderLightcone, renderList, renderRelicSets } from './render.js';
23
+ import { renderStages, resolveMode } from './stage.js';
16
24
  import { describeProxy, readSettings, settingsPath, writeSettings } from './settings.js';
17
- import { DataUnavailable, loadDetail, loadIndex, loadRelicSets, resolveVersion } from './source.js';
18
- import { parseArgs, UsageError } from './tool.js';
25
+ import { plainText } from './text.js';
26
+ import {
27
+ DataUnavailable,
28
+ loadDetail,
29
+ loadIndex,
30
+ loadMonsterDetail,
31
+ loadMonsterIndex,
32
+ loadRelicSets,
33
+ loadStageDetail,
34
+ loadStageIndex,
35
+ resolveVersion,
36
+ } from './source.js';
37
+ import { parseArgs, TOOL_NAMES, UsageError } from './tool.js';
19
38
 
20
39
  export const name = 'dsh-hsr';
21
40
  // webServer 必须是硬依赖:行是并发挂载的,等 apply 里再找服务可能还没起来,
@@ -43,17 +62,80 @@ const OUTPUT_SCHEMA = {
43
62
  additionalProperties: false,
44
63
  };
45
64
 
46
- const PARAMETERS = {
47
- type: 'object',
48
- properties: {
49
- args: {
50
- type: 'string',
51
- description:
52
- '一行参数,例如 "--role --三月七"、"--lightcone --银河铁道之夜"、"--relicset --云无留迹的过客"、"--role --list"、"--rule"、"--teamKnowledge"、"--teamKnowledge --section 3.6"。可用:--role、--lightcone、--relicset、--list、--baseType、--damageType、--star、--lang、--exp、--team、--rule、--teamKnowledge、--section。',
65
+ /** 各工具的参数说明。 */
66
+ const TOOL_PARAMETERS = {
67
+ find: {
68
+ type: 'object',
69
+ properties: {
70
+ args: {
71
+ type: 'string',
72
+ description:
73
+ '一行参数,例如 "--role 三月七"、"--lightcone 银河铁道之夜"、"--relicset 云无留迹的过客"、"--role --list --baseType 记忆"。可用:--role、--lightcone、--relicset、--list、--baseType、--damageType、--star、--lang。',
74
+ },
53
75
  },
76
+ required: ['args'],
77
+ additionalProperties: false,
78
+ },
79
+ help: {
80
+ type: 'object',
81
+ properties: {
82
+ args: {
83
+ type: 'string',
84
+ description: '可留空。留空或给 "--lang 中" 都行,用来切换说明语言。',
85
+ },
86
+ },
87
+ required: [],
88
+ additionalProperties: false,
89
+ },
90
+ rule: {
91
+ type: 'object',
92
+ properties: {
93
+ args: {
94
+ type: 'string',
95
+ description:
96
+ '一行参数,例如 "--rule"、"--teamKnowledge"、"--teamKnowledge --section 3.6"。可用:--rule、--teamKnowledge、--section、--lang。',
97
+ },
98
+ },
99
+ required: ['args'],
100
+ additionalProperties: false,
101
+ },
102
+ exp: {
103
+ type: 'object',
104
+ properties: {
105
+ args: {
106
+ type: 'string',
107
+ description: '一行参数,例如 "--exp"(查询经验)、"--exp --team"(配队经验)。可用:--exp、--team、--lang。',
108
+ },
109
+ },
110
+ required: ['args'],
111
+ additionalProperties: false,
112
+ },
113
+ stage: {
114
+ type: 'object',
115
+ properties: {
116
+ args: {
117
+ type: 'string',
118
+ description:
119
+ '一行参数,可留空(查全部深渊玩法)。例如 "--stage 忘却之庭"、"--stage 虚构叙事"、"--stage 末日幻影"、"--stage 异相仲裁 3"。可用:--stage、--lang。',
120
+ },
121
+ },
122
+ required: [],
123
+ additionalProperties: false,
54
124
  },
55
- required: ['args'],
56
- additionalProperties: false,
125
+ };
126
+
127
+ /** 各工具的说明。 */
128
+ const TOOL_DESCRIPTIONS = {
129
+ find:
130
+ '查询《崩坏:星穹铁道》的资料:角色(满级属性、行迹加成、技能、额外能力、星魂、忆灵、推荐光锥)、光锥(满级属性、叠影)、遗器套装(内外圈与套装效果),或用 --list 列清单。参数:--role 名字、--lightcone 名字、--relicset 名字、--list、--baseType 命途、--damageType 属性、--star 星级、--lang 中/英。',
131
+ help:
132
+ '《崩坏:星穹铁道》资料查询的使用说明:五个工具各管什么、每个参数怎么写、有哪些例子。参数可留空,或用 --lang 中/英 切语言。',
133
+ rule:
134
+ '读《崩坏:星穹铁道》的规则:--rule 返回查询规则与查询经验;--teamKnowledge 返回游戏规则目录与配队经验(规则较长,默认只给目录),再用 --teamKnowledge --section <编号或标题> 取需要的那一节。参数:--rule、--teamKnowledge、--section、--lang。',
135
+ exp:
136
+ '读《崩坏:星穹铁道》的经验:--exp 返回查询经验(查资料时怎么少出错);--exp --team 返回配队经验(配队、排轴、估算进战面板时怎么算)。参数:--exp、--team、--lang。',
137
+ stage:
138
+ '查《崩坏:星穹铁道》当前的深渊关卡:忘却之庭、虚构叙事、末日幻影给三间(星启模式与它前面那关的上下两间)的主怪,异相仲裁给当前一期(三关 + 王棋关)。输出关卡名、目标、主怪弱点(可削韧属性)、抗性与技能特点(只留机制,不列技能名)。敌人技能仅供参考。参数:--stage 玩法名(可留空查全部)、--lang。',
57
139
  };
58
140
 
59
141
  /** --lang 的各种写法。 */
@@ -64,10 +146,18 @@ function readConfig() {
64
146
  return JSON.parse(raw);
65
147
  }
66
148
 
67
- /** 安全宏:文件存在即安全模式(用稳定版本),否则测试模式(用最新版本)。 */
68
- function isSafeMode() {
149
+ /**
150
+ * 数据模式判定。
151
+ *
152
+ * - `config/safety.macro` 存在 → 测试模式,用最新版本(内容更新,但可能有未验证的数据);
153
+ * - 不存在 → 安全模式,用稳定版本。
154
+ *
155
+ * 这个宏文件不进仓库(`.gitignore` 里有 `*.macro`),只有本地调试时才会出现。
156
+ */
157
+ function isTestMode() {
69
158
  try {
70
159
  fs.accessSync(MACRO_FILE);
160
+ // 有宏 = 测试模式 = 用最新版本。
71
161
  return true;
72
162
  } catch {
73
163
  return false;
@@ -136,39 +226,28 @@ function renderTeamKnowledge(game, notes, { lang, section }) {
136
226
 
137
227
  const INDEX_FILE = { role: 'character', lightcone: 'lightcone' };
138
228
 
229
+ /** 解析语言。 */
230
+ function resolveLang(config, parsed) {
231
+ if (parsed.lang === null) return config.defaultLanguage || 'zh';
232
+ const lang = LANG_ALIASES[parsed.lang.toLowerCase()];
233
+ if (lang === undefined) {
234
+ throw new UsageError('--lang 只支持 中 或 英(zh / en)。');
235
+ }
236
+ return lang;
237
+ }
238
+
139
239
  /**
140
- * 处理一次查询。
240
+ * hsr-find:查角色、光锥、遗器套装,或列清单。
141
241
  * @param {string} input 参数行。
142
242
  * @returns {Promise<string>} 正文。
143
243
  */
144
- async function run(input) {
244
+ async function runFind(input) {
145
245
  const config = readConfig();
146
- const safeMode = isSafeMode();
147
- const parsed = parseArgs(input);
148
- const lang = parsed.lang === null ? config.defaultLanguage || 'zh' : LANG_ALIASES[parsed.lang.toLowerCase()];
149
- if (lang === undefined) {
150
- throw new UsageError('--lang 只支持 中 或 英(zh / en)。');
151
- }
246
+ const testMode = isTestMode();
247
+ const parsed = parseArgs(input, { scope: 'find' });
248
+ const lang = resolveLang(config, parsed);
152
249
  const labels = config.stats?.[lang] || config.stats?.zh || {};
153
250
 
154
- if (parsed.teamKnowledge) {
155
- const game = readText(GAME_RULES_FILE);
156
- const notes = await loadNotes('team', TEAM_EXPERIENCE_FILE, { lang });
157
- return renderTeamKnowledge(game, notes, { lang, section: parsed.section });
158
- }
159
-
160
- if (parsed.rule || parsed.exp) {
161
- const kind = parsed.team ? 'team' : 'query';
162
- const baseFile = kind === 'team' ? TEAM_EXPERIENCE_FILE : EXPERIENCE_FILE;
163
- const notes = await loadNotes(kind, baseFile, { lang });
164
- if (parsed.exp) {
165
- const title = kind === 'team' ? (lang === 'en' ? 'Team Experience' : '配队经验') : (lang === 'en' ? 'Experience' : '经验');
166
- return [`## ${title}`, '', notes].join('\n');
167
- }
168
- const rules = readText(RULES_FILE);
169
- return [rules, '', '## 经验', '', notes].join('\n');
170
- }
171
-
172
251
  const baseType = parsed.baseType === null ? null : resolveKey(config, 'baseTypes', parsed.baseType);
173
252
  if (parsed.baseType !== null && baseType === null) {
174
253
  throw new UsageError(`没有「${parsed.baseType}」这个命途。`);
@@ -179,7 +258,7 @@ async function run(input) {
179
258
  }
180
259
 
181
260
  if (parsed.kind === 'relicset') {
182
- const version = await resolveVersion(safeMode);
261
+ const version = await resolveVersion(testMode);
183
262
  const sets = await loadRelicSets(version);
184
263
  if (parsed.list) {
185
264
  const rows = Object.entries(sets)
@@ -198,7 +277,7 @@ async function run(input) {
198
277
 
199
278
  if (parsed.list) {
200
279
  const kind = parsed.kind ?? 'role';
201
- const version = await resolveVersion(safeMode);
280
+ const version = await resolveVersion(testMode);
202
281
  const index = await loadIndex(INDEX_FILE[kind], version);
203
282
  const filters = [];
204
283
  if (baseType) filters.push(`${lang === 'en' ? 'Path' : '命途'}=${labelOf(config, 'baseTypes', baseType, lang)}`);
@@ -231,7 +310,7 @@ async function run(input) {
231
310
  });
232
311
  }
233
312
 
234
- const version = await resolveVersion(safeMode);
313
+ const version = await resolveVersion(testMode);
235
314
  const kind = parsed.kind;
236
315
  const index = await loadIndex(INDEX_FILE[kind], version);
237
316
 
@@ -298,6 +377,144 @@ async function run(input) {
298
377
  return text + hint;
299
378
  }
300
379
 
380
+ /**
381
+ * hsr-stage:查当前深渊关卡(忘却之庭、虚构叙事、末日幻影、异相仲裁)。
382
+ * @param {string} input 参数行。
383
+ * @returns {Promise<string>} 正文。
384
+ */
385
+ async function runStage(input) {
386
+ const config = readConfig();
387
+ const testMode = isTestMode();
388
+ const parsed = parseArgs(input, { scope: 'stage' });
389
+ const lang = resolveLang(config, parsed);
390
+
391
+ let only = null;
392
+ let peakId = null;
393
+ if (parsed.stage !== null) {
394
+ const resolved = resolveMode(parsed.stage);
395
+ if (!resolved) {
396
+ throw new UsageError(`没有「${parsed.stage}」这个深渊玩法。`);
397
+ }
398
+ only = [resolved.mode.key];
399
+ peakId = resolved.peakId;
400
+ }
401
+
402
+ const version = await resolveVersion(testMode);
403
+
404
+ // 怪物的 id 常常是「子体 id」,详情要按父体取,所以先建一张子→父的对照表。
405
+ const monsterIndex = await loadMonsterIndex(version);
406
+ const parentOf = new Map();
407
+ for (const [id, entry] of Object.entries(monsterIndex)) {
408
+ if (!entry || typeof entry !== 'object') continue;
409
+ for (const child of Array.isArray(entry.child) ? entry.child : []) {
410
+ // child 可能是 id 本体,也可能是对象。
411
+ const childId = String(typeof child === 'object' ? child?.id ?? '' : child ?? '');
412
+ if (childId.length === 0) continue;
413
+ if (!parentOf.has(childId)) parentOf.set(childId, id);
414
+ }
415
+ }
416
+
417
+ const detailCache = new Map();
418
+ const fetchMonster = async (rawId) => {
419
+ const id = String(rawId);
420
+ if (detailCache.has(id)) return detailCache.get(id);
421
+ const parentId = parentOf.get(id) ?? id;
422
+ let detail = null;
423
+ try {
424
+ detail = await loadMonsterDetail(version, lang, parentId);
425
+ } catch {
426
+ detail = null;
427
+ }
428
+ if (!detail) {
429
+ detailCache.set(id, null);
430
+ return null;
431
+ }
432
+ const children = Array.isArray(detail.child) ? detail.child : [];
433
+ // 优先取与关卡里那个 id 完全一致的子体;找不到就用父体自身。
434
+ const child =
435
+ children.find((item) => String(item?.id ?? '') === id) ??
436
+ children.find((item) => String(item?.id ?? '') === parentId) ??
437
+ children[0] ??
438
+ null;
439
+ const nameEntry = monsterIndex[parentId];
440
+ const name = plainMonsterName(nameEntry, detail, lang);
441
+ const info = { id, parentId, name, child };
442
+ detailCache.set(id, info);
443
+ return info;
444
+ };
445
+
446
+ const text = await renderStages({
447
+ version,
448
+ lang,
449
+ config,
450
+ only,
451
+ peakId,
452
+ testMode,
453
+ fetchMonster,
454
+ loadIndex: (indexName, ver) => loadStageIndex(indexName, ver),
455
+ loadDetail: (folder, ver, lang2, id) => loadStageDetail(folder, ver, lang2, id),
456
+ });
457
+ return text;
458
+ }
459
+
460
+ /** 怪物名:索引里的名字优先,其次详情里的。 */
461
+ function plainMonsterName(indexEntry, detail, lang) {
462
+ const raw = indexEntry?.[lang] || indexEntry?.zh || indexEntry?.en || detail?.name || '';
463
+ return plainText(String(raw), []);
464
+ }
465
+
466
+ /**
467
+ * hsr-rule:查询规则、游戏规则知识库。
468
+ * @param {string} input 参数行。
469
+ * @returns {Promise<string>} 正文。
470
+ */
471
+ async function runRule(input) {
472
+ const config = readConfig();
473
+ const parsed = parseArgs(input, { scope: 'rule' });
474
+ const lang = resolveLang(config, parsed);
475
+
476
+ if (parsed.teamKnowledge) {
477
+ const game = readText(GAME_RULES_FILE);
478
+ const notes = await loadNotes('team', TEAM_EXPERIENCE_FILE, { lang });
479
+ return renderTeamKnowledge(game, notes, { lang, section: parsed.section });
480
+ }
481
+
482
+ const kind = parsed.team ? 'team' : 'query';
483
+ const baseFile = kind === 'team' ? TEAM_EXPERIENCE_FILE : EXPERIENCE_FILE;
484
+ const notes = await loadNotes(kind, baseFile, { lang });
485
+ const rules = readText(RULES_FILE);
486
+ return [rules, '', '## 经验', '', notes].join('\n');
487
+ }
488
+
489
+ /**
490
+ * hsr-exp:查询经验与配队经验。
491
+ * @param {string} input 参数行。
492
+ * @returns {Promise<string>} 正文。
493
+ */
494
+ async function runExp(input) {
495
+ const config = readConfig();
496
+ const parsed = parseArgs(input, { scope: 'exp' });
497
+ const lang = resolveLang(config, parsed);
498
+
499
+ const kind = parsed.team ? 'team' : 'query';
500
+ const baseFile = kind === 'team' ? TEAM_EXPERIENCE_FILE : EXPERIENCE_FILE;
501
+ const notes = await loadNotes(kind, baseFile, { lang });
502
+ const title = kind === 'team' ? (lang === 'en' ? 'Team Experience' : '配队经验') : (lang === 'en' ? 'Experience' : '经验');
503
+ return [`## ${title}`, '', notes].join('\n');
504
+ }
505
+
506
+ /**
507
+ * hsr-help:用法说明。
508
+ * @param {string} input 参数行。
509
+ * @returns {Promise<string>} 正文。
510
+ */
511
+ async function runHelp(input) {
512
+ const config = readConfig();
513
+ const parsed = parseArgs(input, { scope: 'help' });
514
+ const lang = resolveLang(config, parsed);
515
+ return renderHelp(lang);
516
+ }
517
+
301
518
  function sendJson(response, status, payload) {
302
519
  const body = JSON.stringify(payload);
303
520
  response.writeHead(status, {
@@ -418,35 +635,52 @@ function registerRoutes(server) {
418
635
  };
419
636
  }
420
637
 
638
+ /** 每个工具的处理器。 */
639
+ const RUNNERS = {
640
+ find: runFind,
641
+ help: runHelp,
642
+ rule: runRule,
643
+ exp: runExp,
644
+ stage: runStage,
645
+ };
646
+
421
647
  export function apply(ctx, _config) {
422
- const definition = {
423
- name: 'hsr',
424
- description:
425
- '查询《崩坏:星穹铁道》的资料:角色(满级属性、行迹加成、技能、额外能力、星魂)、光锥(满级属性、叠影)、遗器套装(内外圈与套装效果)。用 --role 查角色、--lightcone 查光锥、--relicset 查遗器、--list 列清单、--rule 看规则与经验、--teamKnowledge 取配队规则目录与配队经验(配规则 --section 3 取某一节)。',
426
- parameters: PARAMETERS,
427
- isConcurrencySafe: () => true,
428
- output: {
429
- schema: OUTPUT_SCHEMA,
430
- render: (_args, value) => [{ type: 'text', text: String(value?.text ?? '') }],
431
- },
432
- execute: async (args, exec) => {
433
- exec?.signal?.throwIfAborted?.();
434
- const input = typeof args?.args === 'string' ? args.args : '';
435
- try {
436
- const text = await run(input);
437
- return { text };
438
- } catch (error) {
439
- if (error instanceof DataUnavailable && error.plain) return { text: error.message };
440
- if (error instanceof UsageError || error instanceof DataUnavailable) {
441
- return { text: `查询未完成:${error.message}` };
442
- }
443
- return { text: `查询未完成:插件内部出错(${error?.message || error})。` };
444
- }
445
- },
446
- };
648
+ const disposers = [];
447
649
 
448
- const disposeTool = ctx.tools.register(definition);
449
- ctx.effect?.(() => disposeTool, 'dsh-hsr: hsr tool');
650
+ for (const [scope, runner] of Object.entries(RUNNERS)) {
651
+ const definition = {
652
+ name: TOOL_NAMES[scope],
653
+ description: TOOL_DESCRIPTIONS[scope],
654
+ parameters: TOOL_PARAMETERS[scope],
655
+ isConcurrencySafe: () => true,
656
+ output: {
657
+ schema: OUTPUT_SCHEMA,
658
+ render: (_args, value) => [{ type: 'text', text: String(value?.text ?? '') }],
659
+ },
660
+ execute: async (args, exec) => {
661
+ exec?.signal?.throwIfAborted?.();
662
+ const input = typeof args?.args === 'string' ? args.args : '';
663
+ try {
664
+ const text = await runner(input);
665
+ return { text };
666
+ } catch (error) {
667
+ if (error instanceof DataUnavailable && error.plain) return { text: error.message };
668
+ if (error instanceof UsageError || error instanceof DataUnavailable) {
669
+ return { text: `查询未完成:${error.message}` };
670
+ }
671
+ return { text: `查询未完成:插件内部出错(${error?.message || error})。` };
672
+ }
673
+ },
674
+ };
675
+ const disposeTool = ctx.tools.register(definition);
676
+ // 注意:ctx.effect(cb) 会立刻执行 cb,并把 cb 的返回值当销毁函数。
677
+ disposers.push(disposeTool);
678
+ }
679
+ ctx.effect?.(() => () => {
680
+ for (const dispose of disposers) {
681
+ if (typeof dispose === 'function') dispose();
682
+ }
683
+ }, 'dsh-hsr: tools');
450
684
 
451
685
  const server = ctx.webServer ?? ctx.get?.('webServer');
452
686
  let routeCount = 0;
package/lib/source.js CHANGED
@@ -53,13 +53,13 @@ async function readJson(path, missingMessage) {
53
53
 
54
54
  /**
55
55
  * 解析当前应当使用的数据版本。
56
- * @param {boolean} safeMode 安全模式下用稳定版本,否则用最新版本。
56
+ * @param {boolean} testMode 测试模式下用最新版本,否则用稳定版本。
57
57
  * @returns {Promise<string>} 版本号。
58
58
  */
59
- export async function resolveVersion(safeMode) {
59
+ export async function resolveVersion(testMode) {
60
60
  const manifest = await readJson('/manifest.json', '版本信息暂时取不到,请稍后再试。');
61
61
  const hsr = manifest && typeof manifest === 'object' ? manifest.hsr : null;
62
- const version = safeMode ? hsr?.live : hsr?.latest;
62
+ const version = testMode ? hsr?.latest : hsr?.live;
63
63
  if (typeof version !== 'string' || version.length === 0) {
64
64
  throw new DataUnavailable('版本信息暂时取不到,请稍后再试。');
65
65
  }
@@ -117,3 +117,73 @@ export async function loadDetail(kind, version, lang, id) {
117
117
  }
118
118
  return value;
119
119
  }
120
+
121
+ /**
122
+ * 读深渊关卡索引(忘却之庭、虚构叙事、末日幻影、异相仲裁)。
123
+ * @param {string} indexName 索引文件名,如 `maze`。
124
+ * @param {string} version 数据版本。
125
+ * @returns {Promise<Record<string, unknown>>} 以 id 为键的索引。
126
+ */
127
+ export async function loadStageIndex(indexName, version) {
128
+ const value = await readJson(
129
+ `/hsr/${version}/${indexName}.json`,
130
+ '当前版本的深渊关卡目录取不到,请稍后再试。',
131
+ );
132
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
133
+ throw new DataUnavailable('数据格式异常,请稍后再试。');
134
+ }
135
+ return value;
136
+ }
137
+
138
+ /**
139
+ * 读深渊关卡详情。
140
+ * @param {string} folder 详情目录名,如 `maze`。
141
+ * @param {string} version 数据版本。
142
+ * @param {string} lang 语言。
143
+ * @param {string} id 关卡 id。
144
+ * @returns {Promise<object|object[]>} 详情对象。
145
+ */
146
+ export async function loadStageDetail(folder, version, lang, id) {
147
+ const value = await readJson(
148
+ `/hsr/${version}/${lang}/${folder}/${id}.json`,
149
+ '这一期的深渊关卡取不到,请稍后再试。',
150
+ );
151
+ if (!value || typeof value !== 'object') {
152
+ throw new DataUnavailable('数据格式异常,请稍后再试。');
153
+ }
154
+ return value;
155
+ }
156
+
157
+ /**
158
+ * 读怪物索引。
159
+ * @param {string} version 数据版本。
160
+ * @returns {Promise<Record<string, unknown>>} 以怪物 id 为键的索引。
161
+ */
162
+ export async function loadMonsterIndex(version) {
163
+ const value = await readJson(
164
+ `/hsr/${version}/monster.json`,
165
+ '当前版本的怪物目录取不到,请稍后再试。',
166
+ );
167
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
168
+ throw new DataUnavailable('数据格式异常,请稍后再试。');
169
+ }
170
+ return value;
171
+ }
172
+
173
+ /**
174
+ * 读怪物详情。
175
+ * @param {string} version 数据版本。
176
+ * @param {string} lang 语言。
177
+ * @param {string} id 怪物 id。
178
+ * @returns {Promise<object>} 详情对象。
179
+ */
180
+ export async function loadMonsterDetail(version, lang, id) {
181
+ const value = await readJson(
182
+ `/hsr/${version}/${lang}/monster/${id}.json`,
183
+ '这个怪物的资料取不到,请稍后再试。',
184
+ );
185
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
186
+ throw new DataUnavailable('数据格式异常,请稍后再试。');
187
+ }
188
+ return value;
189
+ }