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/README.md +58 -23
- package/dsh-hsr-ico.png +0 -0
- package/experience/team-base.md +22 -3
- package/lib/help.js +178 -0
- package/lib/index.js +305 -71
- package/lib/source.js +73 -3
- package/lib/stage.js +689 -0
- package/lib/text.js +10 -0
- package/lib/tool.js +160 -17
- package/package.json +5 -3
- package/rules/game.md +146 -2
- package/rules/rules.md +33 -20
- package/config/safety.macro +0 -0
package/lib/index.js
CHANGED
|
@@ -1,8 +1,14 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* dsh-hsr —— 《崩坏:星穹铁道》资料查询插件。
|
|
3
3
|
*
|
|
4
|
-
*
|
|
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 {
|
|
18
|
-
import {
|
|
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
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
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
|
-
|
|
56
|
-
|
|
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
|
-
|
|
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
|
|
244
|
+
async function runFind(input) {
|
|
145
245
|
const config = readConfig();
|
|
146
|
-
const
|
|
147
|
-
const parsed = parseArgs(input);
|
|
148
|
-
const lang =
|
|
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(
|
|
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(
|
|
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(
|
|
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
|
|
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
|
|
449
|
-
|
|
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}
|
|
56
|
+
* @param {boolean} testMode 测试模式下用最新版本,否则用稳定版本。
|
|
57
57
|
* @returns {Promise<string>} 版本号。
|
|
58
58
|
*/
|
|
59
|
-
export async function resolveVersion(
|
|
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 =
|
|
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
|
+
}
|