dsh-hsr 0.2.0 → 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 CHANGED
@@ -1,18 +1,24 @@
1
1
  # dsh-hsr
2
2
 
3
- DeepSeek Harness 插件:查询《崩坏:星穹铁道》的角色、光锥与遗器资料。
3
+ [![npm](https://img.shields.io/npm/v/dsh-hsr.svg)](https://www.npmjs.com/package/dsh-hsr)
4
4
 
5
- 装好之后,模型手里多一个 `hsr` 工具,问「三月七满级面板」「银河铁道之夜叠影五阶」「云无留迹的过客两件套效果」「欢愉命途都有谁」这类问题时会先查再答,不用凭记忆编数字。
5
+ DeepSeek Harness 插件:查询《崩坏:星穹铁道》的角色、光锥、遗器套装与深渊关卡。
6
+
7
+ 装好之后,模型手里多五个工具,问「三月七满级面板」「银河铁道之夜叠影五阶」「云无留迹的过客两件套效果」「欢愉命途都有谁」「忘却之庭现在首领怪有什么弱点」这类问题时会先查再答,不用凭记忆编数字。
6
8
 
7
9
  ## 它能给出什么
8
10
 
9
- **角色**:星级、命途、属性、简介、80 级满级基础属性、推荐光锥(第一张,即专武)、行迹属性加成合计、各技能(按满级口径)、额外能力、星魂、忆灵、专属效果。
11
+ **角色**(`hsr-find --role`):星级、命途、属性、简介、80 级满级基础属性、推荐光锥(第一张,即专武)、行迹属性加成合计、各技能(按满级口径)、额外能力、星魂、忆灵、专属效果。
12
+
13
+ **光锥**(`hsr-find --lightcone`):星级、命途、80 级满级基础属性、技能正文、叠影 1~5 阶参数对照。
14
+
15
+ **遗器套装**(`hsr-find --relicset`):名称、内圈或外圈、2 件套与 4 件套的套装效果。
10
16
 
11
- **光锥**:星级、命途、80 级满级基础属性、技能正文、叠影 1~5 阶参数对照。
17
+ **清单**(`hsr-find --list`):全部角色或光锥,按命途、属性、星级筛选;全部遗器套装,标注内外圈。
12
18
 
13
- **遗器套装**:名称、内圈或外圈、2 件套与 4 件套的套装效果。
19
+ **深渊关卡**(`hsr-stage --stage`):忘却之庭、虚构叙事、末日幻影给三间(星启模式那一关,加上它前面那关的上下两间),异相仲裁给当前一期(三关 + 王棋关)。输出关卡名、目标、限时、主怪弱点(可削韧属性)、抗性与技能特点(只留机制,不列技能名)。
14
20
 
15
- **清单**:全部角色或光锥,按命途、属性、星级筛选;全部遗器套装,标注内外圈。
21
+ **规则与经验**(`hsr-rule` / `hsr-exp`):使用规则、游戏规则知识库(战斗机制、面板估算、伤害计算、配队排轴),以及查询经验与配队经验。
16
22
 
17
23
  数据是每次调用现查的最新资料,不在本地留副本。
18
24
 
@@ -22,9 +28,11 @@ DeepSeek Harness 插件:查询《崩坏:星穹铁道》的角色、光锥与
22
28
 
23
29
  ```bash
24
30
  cd ~/.dsh/profiles/desktop
25
- npm install github:qui11zxy/dsh-hsr
31
+ npm install dsh-hsr
26
32
  ```
27
33
 
34
+ 也可以直接从 GitHub 装:`npm install github:qui11zxy/dsh-hsr`。
35
+
28
36
  然后在 `~/.dsh/profiles/desktop/package.json` 里把包名加进 bundles 列表:
29
37
 
30
38
  ```json
@@ -41,7 +49,7 @@ npm install github:qui11zxy/dsh-hsr
41
49
  }
42
50
  ```
43
51
 
44
- 重启 DSH,`hsr` 工具就绪,设置里会多出一栏「HSR 数据库」。
52
+ 重启 DSH,五个工具就绪,设置里会多出一栏「HSR 数据库」。
45
53
 
46
54
  想装本地副本(自己改代码时方便):
47
55
 
@@ -52,23 +60,34 @@ npm install file:/path/to/dsh-hsr
52
60
 
53
61
  ## 用法
54
62
 
55
- 工具只有一个参数 `args`,写一行 flag:
63
+ 每个工具只有一个参数 `args`,写一行 flag:
56
64
 
57
- | 参数 | 说明 |
65
+ | 工具 | 干什么 |
58
66
  | --- | --- |
59
- | `--role 名字` | 查角色,支持中文名、英文名、昵称 |
60
- | `--lightcone 名字` | 查光锥 |
61
- | `--relicset 名字` | 查遗器套装 |
62
- | `--list` | 列清单,可与 `--role` / `--lightcone` / `--relicset` 同用 |
63
- | `--baseType 命途` | 按命途筛选:毁灭、巡猎、智识、同谐、虚无、存护、丰饶、记忆、欢愉 |
64
- | `--damageType 属性` | 按属性筛选,仅角色:物理、火、冰、雷、风、量子、虚数 |
65
- | `--star 星级` | 按星级筛选,仅光锥:3、4、5 |
66
- | `--lang 中\|英` | 输出语言,默认中文 |
67
- | `--rule` | 返回使用规则与查询经验 |
68
- | `--exp` | 只返回查询经验 |
69
- | `--exp --team` | 只返回配队经验 |
70
- | `--teamKnowledge` | 返回游戏规则的目录与全部配队经验,准备配队时用 |
71
- | `--teamKnowledge --section 3` | 取游戏规则里的某一节(编号、标题都行,`--section all` 取全文) |
67
+ | `hsr-find` | 查角色、光锥、遗器套装,或列清单 |
68
+ | `hsr-help` | 用法说明与例子 |
69
+ | `hsr-rule` | 查询规则;游戏规则知识库(目录与分节) |
70
+ | `hsr-exp` | 查询经验;配队经验 |
71
+ | `hsr-stage` | 查当前深渊关卡与主怪特点 |
72
+
73
+ 参数在五个工具里写法一致,只是各工具只认自己那部分:
74
+
75
+ | 参数 | 属于 | 说明 |
76
+ | --- | --- | --- |
77
+ | `--role 名字` | `hsr-find` | 查角色,支持中文名、英文名、昵称 |
78
+ | `--lightcone 名字` | `hsr-find` | 查光锥 |
79
+ | `--relicset 名字` | `hsr-find` | 查遗器套装 |
80
+ | `--list` | `hsr-find` | 列清单,可与 `--role` / `--lightcone` / `--relicset` 同用 |
81
+ | `--baseType 命途` | `hsr-find` | 按命途筛选:毁灭、巡猎、智识、同谐、虚无、存护、丰饶、记忆、欢愉 |
82
+ | `--damageType 属性` | `hsr-find` | 按属性筛选,仅角色:物理、火、冰、雷、风、量子、虚数 |
83
+ | `--star 星级` | `hsr-find` | 按星级筛选,仅光锥:3、4、5 |
84
+ | `--stage 玩法` | `hsr-stage` | 查深渊关卡:忘却之庭、虚构叙事、末日幻影、异相仲裁(可加关卡号,如 `异相仲裁 3`) |
85
+ | `--lang 中\|英` | 全部 | 输出语言,默认中文 |
86
+ | `--rule` | `hsr-rule` | 返回使用规则与查询经验 |
87
+ | `--teamKnowledge` | `hsr-rule` | 返回游戏规则目录与配队经验,准备配队时用 |
88
+ | `--teamKnowledge --section 3` | `hsr-rule` | 取游戏规则里的某一节(编号、标题都行,`--section all` 取全文) |
89
+ | `--exp` | `hsr-exp` | 只返回查询经验 |
90
+ | `--exp --team` | `hsr-exp` | 只返回配队经验 |
72
91
 
73
92
  三种写法等价:`--role 三月七`、`--role=三月七`、`--role --三月七`。
74
93
 
@@ -87,6 +106,8 @@ npm install file:/path/to/dsh-hsr
87
106
  --rule
88
107
  --teamKnowledge
89
108
  --teamKnowledge --section 3.6
109
+ --stage 忘却之庭
110
+ --stage 异相仲裁 3
90
111
  ```
91
112
 
92
113
  同名角色(比如两个「三月七」)会返回其中一个,并在末尾列出全部同名条目,加 `--baseType` 或 `--damageType` 就能指定。
@@ -112,6 +133,19 @@ npm install file:/path/to/dsh-hsr
112
133
  ...
113
134
  ```
114
135
 
136
+ ```
137
+ ## 异相仲裁|智械残局
138
+
139
+ ### 骑士(一)
140
+ 目标:...
141
+ 主怪|承露天人
142
+ 弱点(可削韧属性):物理|冰|雷
143
+ 抗性:火 20%|量子 20%|虚数 20%|风 40%
144
+ 技能特点:
145
+ - 大概率使受到攻击的我方目标陷入风化状态
146
+ - 进入【持咒】状态。下次行动对我方全体施放【玄气噬身】
147
+ ```
148
+
115
149
  ## 设置
116
150
 
117
151
  设置里有一栏「HSR 数据库」:
@@ -132,6 +166,7 @@ npm install file:/path/to/dsh-hsr
132
166
  - 忆灵的生命、速度会代入具体数值,并标出它继承自角色哪一项。
133
167
  - 遗器套装只有 2 件套效果的是内圈,同时有 2 件与 4 件效果的是外圈。
134
168
  - 富文本里的颜色、下划线、注音、`#1[i]` 之类的占位符都已替换成普通文字。
169
+ - 深渊里的敌人技能只保留「机制」,纯伤害句会被丢掉;这是给配队参考用的,数值以游戏内为准。
135
170
 
136
171
  ## 经验文件
137
172
 
@@ -145,7 +180,9 @@ npm install file:/path/to/dsh-hsr
145
180
 
146
181
  普通查询不返回经验:`--rule` 带使用规则与查询经验,`--exp` 只看查询经验,`--exp --team` 只看配队经验,`--teamKnowledge` 带配队经验。文件首次读取时会自动建好。
147
182
 
148
- 游戏规则(`rules/game.md`)按知识库的方式给:`--teamKnowledge` 只返回二级/三级标题的目录(每节标了行数或子节数),模型看完目录再用 `--teamKnowledge --section 3.6` 取需要的那一节,不必每次把近三百行全塞进上下文。`--section` 接受编号(`3`、`3.6`)、标题片段(`伤害计算`、`击破`)或 `all`。
183
+ 游戏规则(`rules/game.md`)按知识库的方式给:`--teamKnowledge` 只返回二级/三级标题的目录(每节标了行数或子节数),模型看完目录再用 `--teamKnowledge --section 3.6` 取需要的那一节,不必每次把几百行全塞进上下文。`--section` 接受编号(`3`、`3.6`)、标题片段(`伤害计算`、`击破`)或 `all`。
184
+
185
+ 游戏规则目前覆盖:遗器词条与副词条三档数值、面板估算(从遗器词条推到进战数值,含两个完整算例)、伤害乘区与抗性、战技点与能量、行动值与拉条、Buff 覆盖率与永续 Buff、深渊机制。
149
186
 
150
187
  ## 配置
151
188
 
@@ -153,6 +190,8 @@ npm install file:/path/to/dsh-hsr
153
190
 
154
191
  `rules/rules.md` 是使用规则,`--rule` 会原样返回;`rules/game.md` 是配队用的游戏规则,`--teamKnowledge` 会带上它。后者留空,由你自己写。
155
192
 
193
+ 数据版本有两档:默认用稳定版本(数据源标记为 `live` 的那档),保证查到的内容是稳定的;如果你在插件目录里放一个空的 `config/safety.macro` 文件,就切到测试版本(`latest`),能查到刚更新的内容,但数据可能有出入。这个宏文件不会随插件发布,也不在版本库里,平时不用管。
194
+
156
195
  ## 要求
157
196
 
158
197
  - Node.js 22 以上。
Binary file
@@ -12,15 +12,20 @@
12
12
  - 命座是依次解锁的,顺序:有本体(0命)->1命(有第一个命座)->…
13
13
  - 专武:一般指第一张推荐光锥,即查询时返回的推荐光锥,只有5星非开拓者的角色有专武。某角色(a+b)表示该角色的命座数为a,专武叠层为b(0为没有专武)。
14
14
  - 用户没有说角色命座时,四星角色和开拓者默认满命,其他五星角色最多假设有2命,且在配队时尽可能降低金数(即命座数)需求。
15
+ - 由于战斗有行动值限制,所以需要再有限行动值内打出更多伤害,且尽量恰好在某一回合结束前打出伤害,最大化利用(因为一回合没结束时是不计消耗回合的)。
15
16
 
16
17
  ## 遗器光锥
17
18
  - 每个角色要携带一个光锥和一套完整遗器(4+2),适配的光锥可能改变角色战斗逻辑。
18
19
  - 完整遗器的数值参考 `--teamKnowledge` 中给出的遗器词条,一般认为主C有30个有效词条,辅助根据有效词条的种类数取有效词条15~30个,且估计时不能取某个副词条非常多。若用户提供了具体面板,则按用户给的计算。**一定要计算遗器提供的词条和效果!**
20
+ - 面板估算按 `--teamKnowledge` 第 2.4 节的口径走:角色基础 → 光锥基础 → 行迹 → 套装 → 主词条 → 副词条 → 条件加成;副词条初始值与每次强化都按三档中值算,得到的是「期望面板」。
21
+ - 条件生效的套装效果(速度 ≥120 再加攻、速度 ≥135/160 再加伤等)先按不满足算,速度算出来达标再加回去,不要一开始就加。
22
+ - 主C常用副词条分配(30次强化):暴击率8、暴击伤害8、攻击%6、速度4、生命%4;不吃暴击的角色把暴击换成属性伤害%或治疗量加成%。
23
+ - 辅助常用分配(20次强化):速度6、暴击率2、暴击伤害2、效果命中4、效果抵抗4、攻击%2。
24
+ - 估算面板时不要把队友增益、忆灵、只持续1回合的增伤算进去,那些属于覆盖率与排轴部分。
19
25
  - 推荐光锥只表示该光锥可能是该角色专武,**不一定是最适配该角色的光锥**,不得直接套用。
20
26
  - 同谐角色要额外考虑是否适配光锥“舞!舞!舞!”,该光锥提供的全队行动提前24%(叠5)的收益很高。能较高频释放终结技的角色外圈考虑风套(翔鹰套)。
21
27
  - 需要辅助角色尽早上拐力时考虑内圈遗器“生命的翁瓦克”。
22
28
  - 没有说明时,四星角色默认满星魂,四星及以下光锥默认叠5,五星光锥均只有一张叠1,“记一位星神的陨落”“星海巡航”“记忆的质料”“孤独中疗愈”“不息的演算”“记忆永不落幕”“欢愉满溢祝福”是一张叠5。
23
- - 速度和充能效率存在阈值,若速度无法让角色在规定轮内多一动、满足某个效果或在某个时刻先行动,则是无效速度;充能效率若不能多充出一个终结技,则也无效。
24
29
 
25
30
  ## 配队
26
31
  - 一般情况下,考虑标准四人队伍,一号位主C,二号位副C/辅助,三号位辅助,四号位生存。若用户指出带生存伤害不够/要追高分、0T,则考虑三拐。
@@ -31,11 +36,25 @@
31
36
  - 攻击、增伤、爆伤等词条有边际效应,配队时要考虑。
32
37
  - 考虑配队时,应当先考虑辅助能提供什么,需要主C具备哪些特点,再去找适配的主C;对于需要同时配出多路队伍的关卡,还要考虑不同队伍间的实力分配,不能有一间过弱。
33
38
  - 当用户提供敌方的具体情况时,优先考虑能快速破除敌方机制的角色,同时考虑敌方抗性和弱点,尽可能不要让主C打对应属性有高抗性的怪而是找BOSS有对应弱点的。若没有其他可选主C,则考虑让副C/辅助能针对对应弱点,并考虑三拐。
34
- - 三拐时队伍中最好有一个角色可以提供一定生存能力,如自带减伤或回复、生命倍率(或有角色的主词条可以选生命%、防御%)、记忆命途(忆灵可以不断复活)。
39
+ - 三拐时队伍中最好有一个角色可以提供一定生存能力,如自带减伤或回复、生命倍率(或有角色的主词条可以选生命%、防御%)、记忆命途(忆灵可以不断复活),且一般三拐时要有至少一个辅助具有拉条(使队友行动提前)的能力。
40
+ - 队伍中角色的机制若能相互触发,则称为队伍逻辑自洽,优先考虑。
35
41
  - 配队时同步考虑排轴,见下。
36
42
 
37
43
  ## 排轴
38
44
  - 实际游戏时,还需要对角色的行动顺序进行规划。参考 `--teamKnowledge` 中给出的行动值相关词条,根据用户提供的数据或自己估计,按规则设计一套能最大化行动顺序的逻辑。
39
45
  - 排轴时可以假定我方角色速度能够调整(注意忆灵速度和阿哈时刻速度变化),但不要假设过高的速度。一般主C词条优先双爆(或其他提升伤害的词条),在需要时添加少量速度。
40
- - 要考虑我方辅助提供的效果的覆盖率,主C爆发输出时应当尽可能上满buff。
46
+ - 要考虑我方辅助提供的效果的覆盖率,尽可能保证全程覆盖,至少保证主C爆发输出时尽可能上满buff。
41
47
  - 特定情况下,可以在终结技满能量时先不释放,从而改变输出或效果触发时机。
48
+ - 辅助大多能通过遗器获得较高速度,通常认为如果只追速度词条,在不考虑技能加成时可以达到160~180,高练度可以达到190左右;若同时还需要另一词条,则认为速度可达到130-160左右。一般常见速度阈值为134(忘却之庭首轮2动)、142(忘却之庭带叠5“舞!舞!舞!”、翔鹰套和翁瓦克首轮3动)、160(忘却之庭两轮4动、带叠5“舞!舞!舞!”和翁瓦克首轮3动)、174(带翁瓦克忘却之庭首轮3动)
49
+ - 主C的遗器副词条一般多选则暴击率、暴击伤害(如果伤害能暴击,否则选择其他增幅伤害的词条)。
50
+ - 速度和充能效率存在阈值,若速度无法让角色在规定轮内多一动、满足某个效果或在某个时刻先行动,则是无效速度;充能效率若不能多充出一个终结技,则也无效。但若能多一动,多充出一个大招,则是很大提升。这方面一般考虑辅助。
51
+ - 由于被敌方攻击也可以获得少量能量,所以某次行动后若只缺少数点能量,可以标注此处可尝试通过受击补齐能量缺口。注意特殊能量受击不回复。
52
+ - 没有特殊说明,能量满后不再回复,不能溢出。
53
+ - 排轴时一般针对某项具体深渊的行动值限制,默认忘却之庭,即第一轮150行动值。
54
+ - 可根据 `--teamKnowledge` 中给出的行动值相关词条,精确计算角色间的行动先后顺序。
55
+ - 覆盖率按 `--teamKnowledge` 第 8 节算:先列主 C 每个输出回合,标注增伤/降防/易伤是否到位,再区分「永远补不上」「这一轮补不上」「顺序不对」三类缺口。主C单次输出占比大时,缺一次buff的损失远大于少动一次。
56
+ - 持续回合数在**自己回合结束**时减1,所以「1回合buff」只能覆盖同一次行动,主C若在辅助之后行动就吃不到。要主C吃到,辅助必须比主C早动至少一轮,或给更长持续回合数。
57
+ - 「下一次」型增益跟着下一个行动者走,「施放终结技后」型增益给自己加速,这两类在排轴时都要单独标注。
58
+ - 永续buff的判断看三点:产出端多久给一次、消耗端能撑几轮、消耗速度不能快过产出速度。产出每2轮1次而消耗每轮1次,就永远缺。
59
+ - 卡双BUFF的做法:把「A→C→B」的顺序改成「B→C」,让主C同时吃到两个同源继承增伤,代价是给B加速(翔鹰套「施放终结技后行动提前25%」)。
60
+ - 终结技能量满了可以先不放,等主C需要增伤的那一刻插队放;插队不占行动机会,这是终结技最大的价值。
package/lib/help.js ADDED
@@ -0,0 +1,178 @@
1
+ /**
2
+ * 使用说明:`hsr-help` 的正文。
3
+ *
4
+ * 五个工具分工是固定的:
5
+ * - `hsr-find` 查角色、光锥、遗器套装、列清单;
6
+ * - `hsr-help` 本文件,用法说明;
7
+ * - `hsr-rule` 规则:查询规则与游戏规则知识库;
8
+ * - `hsr-exp` 经验:查询经验与配队经验;
9
+ * - `hsr-stage` 深渊关卡与主怪特点。
10
+ *
11
+ * 参数名与写法各工具通用,不带 `--` 的名字一律按中文名匹配。
12
+ */
13
+
14
+ /** 每个工具的一句话职责。 */
15
+ const TOOL_ROWS = [
16
+ ['hsr-find', '查角色、光锥、遗器套装,或列清单'],
17
+ ['hsr-help', '用法说明与例子'],
18
+ ['hsr-rule', '查询规则、游戏规则知识库(目录与分节)'],
19
+ ['hsr-exp', '查询经验、配队经验'],
20
+ ['hsr-stage', '查当前深渊关卡与主怪特点'],
21
+ ];
22
+
23
+ /** 各工具的参数表。 */
24
+ const PARAM_ROWS = [
25
+ ['--role <名字>', 'hsr-find', '查角色:满级属性、行迹加成、技能、额外能力、星魂、忆灵、推荐光锥'],
26
+ ['--lightcone <名字>', 'hsr-find', '查光锥:满级基础属性、叠影 1~5 阶'],
27
+ ['--relicset <名字>', 'hsr-find', '查遗器套装:内圈/外圈与 2 件、4 件套效果'],
28
+ ['--list', 'hsr-find', '列清单,可配 --baseType / --damageType / --star 筛选'],
29
+ ['--baseType <命途>', 'hsr-find', '按命途筛选:毁灭、巡猎、智识、同谐、虚无、存护、丰饶、记忆、欢愉'],
30
+ ['--damageType <属性>', 'hsr-find', '按属性筛选(只对角色):物理、火、冰、风、雷、量子、虚数'],
31
+ ['--star <3|4|5>', 'hsr-find', '按星级筛选(只对光锥)'],
32
+ ['--lang <中|英>', '全部', '输出语言,默认中文'],
33
+ ['--rule', 'hsr-rule', '查询规则:什么时候查、怎么查、怎么答'],
34
+ ['--teamKnowledge', 'hsr-rule', '配队知识:游戏规则目录 + 配队经验(篇幅长,默认只给目录)'],
35
+ ['--section <编号|标题>', 'hsr-rule', '取游戏规则里的某一节,配合 --teamKnowledge 用;all 取全文'],
36
+ ['--exp', 'hsr-exp', '查询经验(查资料时怎么少出错)'],
37
+ ['--exp --team', 'hsr-exp', '配队经验(配队、排轴、估面板时怎么算)'],
38
+ ['--stage <玩法>', 'hsr-stage', '深渊关卡:忘却之庭、虚构叙事、末日幻影给三间(星启模式与它前面那关的上下两间),异相仲裁给当前一期(三关 + 王棋关)'],
39
+ ];
40
+
41
+ /** 例子。 */
42
+ const EXAMPLE_ROWS = [
43
+ ['--role 三月七', 'hsr-find', '角色完整面板'],
44
+ ['--role 开拓者', 'hsr-find', '开拓者所有形态(按 --baseType 收窄)'],
45
+ ['--role --list --baseType 记忆', 'hsr-find', '所有记忆命途角色'],
46
+ ['--lightcone 银河铁道之夜', 'hsr-find', '光锥满级属性与叠影'],
47
+ ['--relicset 云无留迹的过客', 'hsr-find', '遗器套装内外圈与效果'],
48
+ ['--teamKnowledge', 'hsr-rule', '配队前先取规则目录'],
49
+ ['--teamKnowledge --section 3.6', 'hsr-rule', '再取需要的某一节'],
50
+ ['--exp --team', 'hsr-exp', '配队前取配队经验'],
51
+ ['--stage 忘却之庭', 'hsr-stage', '当前忘却之庭星启三间的主怪'],
52
+ ['--stage 异相仲裁 3', 'hsr-stage', '异相仲裁第 3 关'],
53
+ ];
54
+
55
+ /**
56
+ * 渲染使用说明。
57
+ * @param {'zh'|'en'} lang 语言。
58
+ * @returns {string} 正文。
59
+ */
60
+ export function renderHelp(lang) {
61
+ const en = lang === 'en';
62
+ const lines = [];
63
+
64
+ lines.push(en ? '# Honkai: Star Rail lookup — how to use' : '# 《崩坏:星穹铁道》资料查询 —— 使用说明');
65
+ lines.push('');
66
+ lines.push(
67
+ en
68
+ ? 'Everything is fetched live from the game data; there is no local copy. Names are matched in Chinese by default.'
69
+ : '所有资料都是联网现查,游戏数据没有本地副本。名字默认按中文匹配。',
70
+ );
71
+ lines.push('');
72
+
73
+ lines.push(en ? '## Tools' : '## 五个工具');
74
+ lines.push('');
75
+ lines.push('| 工具 | 干什么 |');
76
+ lines.push('|---|---|');
77
+ for (const [name, what] of TOOL_ROWS) {
78
+ lines.push(`| \`${name}\` | ${en ? EN_TOOL_WHAT[name] : what} |`);
79
+ }
80
+ lines.push('');
81
+
82
+ lines.push(en ? '## Arguments' : '## 参数');
83
+ lines.push('');
84
+ lines.push('| 参数 | 工具 | 说明 |');
85
+ lines.push('|---|---|---|');
86
+ for (const [flag, tool, what] of PARAM_ROWS) {
87
+ lines.push(`| \`${flag}\` | ${en ? EN_TOOL_NAME[tool] : tool} | ${en ? EN_PARAM_WHAT[flag] : what} |`);
88
+ }
89
+ lines.push('');
90
+ lines.push(
91
+ en
92
+ ? 'Values may be written as `--role 三月七`, `--role=三月七` or `--role --三月七`. Names with spaces go in quotes: `--lightcone "银河铁道之夜"`.'
93
+ : '取值可以写成 `--role 三月七`、`--role=三月七` 或 `--role --三月七`。名字里有空格时用引号:`--lightcone "银河铁道之夜"`。',
94
+ );
95
+ lines.push('');
96
+
97
+ lines.push(en ? '## Examples' : '## 例子');
98
+ lines.push('');
99
+ lines.push('| 参数 | 工具 | 得到 |');
100
+ lines.push('|---|---|---|');
101
+ for (const [args, tool, what] of EXAMPLE_ROWS) {
102
+ lines.push(`| \`${args}\` | ${en ? EN_TOOL_NAME[tool] : tool} | ${en ? EN_EXAMPLE_WHAT[args] : what} |`);
103
+ }
104
+ lines.push('');
105
+
106
+ lines.push(en ? '## Notes' : '## 几点约定');
107
+ lines.push('');
108
+ if (en) {
109
+ lines.push('- One query at a time: `--role`, `--lightcone` and `--relicset` cannot be combined.');
110
+ lines.push('- Same name may match several entries; the tool lists them and asks you to narrow it down with `--baseType` or `--damageType`.');
111
+ lines.push('- Numbers are the 80-level values; skills are shown at the level a player actually reaches (level 6 basic ATK, level 10 for the rest).');
112
+ lines.push('- When the network is unreachable the tool says so plainly; it never dumps links or internals.');
113
+ lines.push('- For team building: read `--teamKnowledge` first, then the section you need, then `--exp --team`.');
114
+ lines.push('- Lookups hit the network and are slowish; if you need several entries, fire them in parallel instead of one by one.');
115
+ lines.push('- Enemy skills in `hsr-stage` are for reference only: they list mechanics only, and the game may change them at any time.');
116
+ } else {
117
+ lines.push('- 一次只查一种:`--role`、`--lightcone`、`--relicset` 不能混用。');
118
+ lines.push('- 名字可能对应多个条目,工具会列出来,让你用 `--baseType` 或 `--damageType` 收窄。');
119
+ lines.push('- 数值一律是 80 级口径;技能按玩家实际能到的等级显示(普攻 6 级,其余 10 级)。');
120
+ lines.push('- 连不上时工具只说连不上,不会吐出链接或内部细节。');
121
+ lines.push('- 要配队:先 `--teamKnowledge` 看规则目录,再 `--section` 取需要的那节,最后 `--exp --team` 取配队经验。');
122
+ lines.push('- 查询要联网,比较耗时;要查好几条时尽量并行发,不要一条一条串着查。');
123
+ lines.push('- `hsr-stage` 里的敌人技能仅供参考:只列机制,且游戏随时可能改动。');
124
+ }
125
+ lines.push('');
126
+ return lines.join('\n');
127
+ }
128
+
129
+ /** 英文工具说明。 */
130
+ const EN_TOOL_WHAT = {
131
+ 'hsr-find': 'Look up characters, light cones, relic sets, or list them',
132
+ 'hsr-help': 'This usage guide',
133
+ 'hsr-rule': 'Query rules and the game-rule knowledge base',
134
+ 'hsr-exp': 'Query notes and team-building notes',
135
+ 'hsr-stage': 'Look up the current challenge stages and their main enemies',
136
+ };
137
+
138
+ /** 英文工具名(表里显示成 hsr-xxx)。 */
139
+ const EN_TOOL_NAME = {
140
+ 'hsr-find': 'hsr-find',
141
+ 'hsr-help': 'hsr-help',
142
+ 'hsr-rule': 'hsr-rule',
143
+ 'hsr-exp': 'hsr-exp',
144
+ 'hsr-stage': 'hsr-stage',
145
+ 全部: 'any',
146
+ };
147
+
148
+ /** 英文参数说明。 */
149
+ const EN_PARAM_WHAT = {
150
+ '--role <名字>': 'Character: 80-level stats, traces, skills, abilities, eidolons, memosprite, recommended light cone',
151
+ '--lightcone <名字>': 'Light cone: 80-level stats and refinement 1~5',
152
+ '--relicset <名字>': 'Relic set: inner/outer and the 2-pc / 4-pc effects',
153
+ '--list': 'List entries, optionally filtered by --baseType / --damageType / --star',
154
+ '--baseType <命途>': 'Filter by Path: Destruction, Hunt, Erudition, Harmony, Nihility, Preservation, Abundance, Remembrance, Elation',
155
+ '--damageType <属性>': 'Filter by element (characters only): Physical, Fire, Ice, Wind, Lightning, Quantum, Imaginary',
156
+ '--star <3|4|5>': 'Filter by rarity (light cones only)',
157
+ '--lang <中|英>': 'Output language, Chinese by default',
158
+ '--rule': 'Query rules: when to look things up and how to answer',
159
+ '--teamKnowledge': 'Team knowledge: game-rule contents plus team notes (long, contents only by default)',
160
+ '--section <编号|标题>': 'One section of the game rules, used with --teamKnowledge; all returns everything',
161
+ '--exp': 'Query notes (how to avoid mistakes when reading game data)',
162
+ '--exp --team': 'Team notes (team building, rotation, panel estimation)',
163
+ '--stage <玩法>': 'Challenge stages: the three chambers of Memory of Chaos / Unknowable Domain / Apocalyptic Shadow (the Star Launch stage plus the two chambers of the stage before it), the current cycle of Peak Arbitration (three stages plus the King stage)',
164
+ };
165
+
166
+ /** 英文例子说明。 */
167
+ const EN_EXAMPLE_WHAT = {
168
+ '--role 三月七': 'Full character panel',
169
+ '--role 开拓者': 'Every Trailblazer variant (narrow with --baseType)',
170
+ '--role --list --baseType 记忆': 'All Remembrance characters',
171
+ '--lightcone 银河铁道之夜': 'Light cone stats and refinements',
172
+ '--relicset 云无留迹的过客': 'Relic set slot and effects',
173
+ '--teamKnowledge': 'Read the rule contents before building a team',
174
+ '--teamKnowledge --section 3.6': 'Then fetch just that section',
175
+ '--exp --team': 'Read team-building notes',
176
+ '--stage 忘却之庭': 'Main enemies of the three Star Launch chambers of Memory of Chaos',
177
+ '--stage 异相仲裁 3': 'Peak Arbitration, stage 3',
178
+ };