dsh-hsr
qui11zxy/dsh-hsr
Query Honkai: Star Rail data as agent tools: character stats, skills, Light Cones, relic sets and current endgame stages. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
Installazione
dsh plugin --profile web add github:qui11zxy/dsh-hsrREADME
dsh-hsr
DeepSeek Harness 插件:查询《崩坏:星穹铁道》的角色、光锥、遗器套装与深渊关卡。
装好之后,模型手里多五个工具,问「三月七满级面板」「银河铁道之夜叠影五阶」「云无留迹的过客两件套效果」「欢愉命途都有谁」「忘却之庭现在首领怪有什么弱点」这类问题时会先查再答,不用凭记忆编数字。
它能给出什么
角色(hsr-find --role):星级、命途、属性、简介、80 级满级基础属性、推荐光锥(第一张,即专武)、行迹属性加成合计、各技能(按满级口径)、额外能力、星魂、忆灵、专属效果。
光锥(hsr-find --lightcone):星级、命途、80 级满级基础属性、技能正文、叠影 1~5 阶参数对照。
遗器套装(hsr-find --relicset):名称、内圈或外圈、2 件套与 4 件套的套装效果。
清单(hsr-find --list):全部角色或光锥,按命途、属性、星级筛选;全部遗器套装,标注内外圈。
深渊关卡(hsr-stage --stage):忘却之庭、虚构叙事、末日幻影给三间(星启模式那一关,加上它前面那关的上下两间),异相仲裁给当前一期(三关 + 王棋关)。输出关卡名、目标、限时、主怪弱点(可削韧属性)、抗性与技能特点(只留机制,不列技能名)。
规则与经验(hsr-rule / hsr-exp):使用规则、游戏规则知识库(战斗机制、面板估算、伤害计算、配队排轴),以及查询经验与配队经验。
数据是每次调用现查的最新资料,不在本地留副本。
安装
插件以 bundle 形式挂到某个 DSH profile 上。假设 profile 目录是 ~/.dsh/profiles/desktop:
cd ~/.dsh/profiles/desktop
npm install dsh-hsr
也可以直接从 GitHub 装:npm install github:qui11zxy/dsh-hsr。
然后在 ~/.dsh/profiles/desktop/package.json 里把包名加进 bundles 列表:
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-hsr"
]
}
}
}
重启 DSH,五个工具就绪,设置里会多出一栏「HSR 数据库」。
想装本地副本(自己改代码时方便):
cd ~/.dsh/profiles/desktop
npm install file:/path/to/dsh-hsr
用法
每个工具只有一个参数 args,写一行 flag:
| 工具 | 干什么 |
|---|---|
hsr-find | 查角色、光锥、遗器套装,或列清单 |
hsr-help | 用法说明与例子 |
hsr-rule | 查询规则;游戏规则知识库(目录与分节) |
hsr-exp | 查询经验;配队经验 |
hsr-stage | 查当前深渊关卡与主怪特点 |
参数在五个工具里写法一致,只是各工具只认自己那部分:
| 参数 | 属于 | 说明 |
|---|---|---|
--role 名字 | hsr-find | 查角色,支持中文名、英文名、昵称 |
--lightcone 名字 | hsr-find | 查光锥 |
--relicset 名字 | hsr-find | 查遗器套装 |
--list | hsr-find | 列清单,可与 --role / --lightcone / --relicset 同用 |
--baseType 命途 | hsr-find | 按命途筛选:毁灭、巡猎、智识、同谐、虚无、存护、丰饶、记忆、欢愉 |
--damageType 属性 | hsr-find | 按属性筛选,仅角色:物理、火、冰、雷、风、量子、虚数 |
--star 星级 | hsr-find | 按星级筛选,仅光锥:3、4、5 |
--stage 玩法 | hsr-stage | 查深渊关卡:忘却之庭、虚构叙事、末日幻影、异相仲裁(可加关卡号,如 异相仲裁 3) |
--lang 中|英 | 全部 | 输出语言,默认中文 |
--rule | hsr-rule | 返回使用规则与查询经验 |
--teamKnowledge | hsr-rule | 返回游戏规则目录与配队经验,准备配队时用 |
--teamKnowledge --section 3 | hsr-rule | 取游戏规则里的某一节(编号、标题都行,--section all 取全文) |
--exp | hsr-exp | 只返回查询经验 |
--exp --team | hsr-exp | 只返回配队经验 |
三种写法等价:--role 三月七、--role=三月七、--role --三月七。
例子
--role 三月七
--role 星神★阿哈
--role 三月七 --baseType 巡猎
--lightcone 当第一声「阿哈」响起
--relicset 云无留迹的过客
--relicset --list
--role --list --damageType 冰
--lightcone --list --star 5
--role 三月七 --lang en
--rule
--teamKnowledge
--teamKnowledge --section 3.6
--stage 忘却之庭
--stage 异相仲裁 3
同名角色(比如两个「三月七」)会返回其中一个,并在末尾列出全部同名条目,加 --baseType 或 --damageType 就能指定。
输出示例
# 三月七(4★ / 冰 / 存护)
简介:一度沉睡于恒冰,对过去一无所知的少女。
为了寻找身世的真相,选择与星穹列车同行。
## 基础属性(80 级)
生命 1058.4|攻击 511.56|防御 573.3|速度 101|暴击率 5%|暴击伤害 50%|嘲讽 150|能量上限 120
推荐光锥|余生的第一天
## 行迹属性加成(合计)
冰属性伤害提高 +22.4%|防御力 +22.5%|效果抵抗 +10%
## 技能
### 普攻|极寒的弓矢(单攻)
对指定敌方单体造成等同于三月七100%攻击力的冰属性伤害。
...
## 异相仲裁|智械残局
### 骑士(一)
目标:...
主怪|承露天人
弱点(可削韧属性):物理|冰|雷
抗性:火 20%|量子 20%|虚数 20%|风 40%
技能特点:
- 大概率使受到攻击的我方目标陷入风化状态
- 进入【持咒】状态。下次行动对我方全体施放【玄气噬身】
设置
设置里有一栏「HSR 数据库」:
- 代理:留空跟随系统(浏览器)代理;填
direct强制直连;也可以直接填127.0.0.1:7897这样的地址。 - 查询经验:写你对角色的称呼与全称的对应关系(例如「板鸭 = 布洛妮娅」),模型查询时会先读这段。
- 配队经验:写你的配队偏好、已有角色光锥遗器,模型给配队建议时会读这段。
- 删除本机自识别经验:清空模型自己写下的检验经验,点击前会再确认一次。
这两段文字分别存到 ~/.dsh/dsh-hsr/experience/user.md 与 user-team.md,也可以直接改文件。
数值口径
- 角色与光锥的属性都是 80 级满级值,角色已含突破成长,光锥由「起点值 + 每级增量 × 79」算出。
- 技能按「理论满级」折算:15 级表取 10 级,10 级表取 6 级,更短的逐级列出。
- 能量上限与该技能的回能分别写在基础属性行和每个技能标题后。黄泉(残梦层数)这类不靠能量条的角色数值远低于正常水平,这两项整块不显示,避免误读。
- 削韧值三个位置依次是主目标、全体、相邻目标;单攻显示一个数,群攻标「全体」,扩散标「主目标 / 相邻」,弹射标「每段」。
- 忆灵的生命、速度会代入具体数值,并标出它继承自角色哪一项。
- 遗器套装只有 2 件套效果的是内圈,同时有 2 件与 4 件效果的是外圈。
- 富文本里的颜色、下划线、注音、
#1[i]之类的占位符都已替换成普通文字。 - 深渊里的敌人技能只保留「机制」,纯伤害句会被丢掉;这是给配队参考用的,数值以游戏内为准。
经验文件
经验分查询与配队两套,每套三层:
| 层 | 查询 | 配队 | 谁维护 |
|---|---|---|---|
| 基础经验 | 插件内 experience/base.md | 插件内 experience/team-base.md | 随插件发布,只读 |
| 模型检验 | ~/.dsh/dsh-hsr/experience/model.md | model-team.md | 模型发现口径不对时自己写 |
| 用户经验 | ~/.dsh/dsh-hsr/experience/user.md | user-team.md | 你自己写(设置页可填) |
普通查询不返回经验:--rule 带使用规则与查询经验,--exp 只看查询经验,--exp --team 只看配队经验,--teamKnowledge 带配队经验。文件首次读取时会自动建好。
游戏规则(rules/game.md)按知识库的方式给:--teamKnowledge 只返回二级/三级标题的目录(每节标了行数或子节数),模型看完目录再用 --teamKnowledge --section 3.6 取需要的那一节,不必每次把几百行全塞进上下文。--section 接受编号(3、3.6)、标题片段(伤害计算、击破)或 all。
游戏规则目前覆盖:遗器词条与副词条三档数值、面板估算(从遗器词条推到进战数值,含两个完整算例)、伤害乘区与抗性、战技点与能量、行动值与拉条、Buff 覆盖率与永续 Buff、深渊机制。
配置
config/config.json 里放着命途表、属性表、标签名、段落标题、默认语言和昵称写法。想改称呼或者补别名,改这个文件即可;命途与属性的可选值都从这里读,代码里没有硬编码。
rules/rules.md 是使用规则,--rule 会原样返回;rules/game.md 是配队用的游戏规则,--teamKnowledge 会带上它。后者留空,由你自己写。
数据版本有两档:默认用稳定版本(数据源标记为 live 的那档),保证查到的内容是稳定的;如果你在插件目录里放一个空的 config/safety.macro 文件,就切到测试版本(latest),能查到刚更新的内容,但数据可能有出入。这个宏文件不会随插件发布,也不在版本库里,平时不用管。
要求
- Node.js 22 以上。
- 需要能访问网络,插件每次查询都实时取数;连不上时会提示「无法连接,请检查网络连接或配置可用代理」,需要的话在设置里填代理。
许可
MIT
Plugin correlati
archify (deepseek-harness)
tt-a1i/archify
WeKnora (dsh-weknora)
tencent/weknora
next-ai-draw-io (dsh-plugin)
dayuanjiang/next-ai-draw-io
weknora
tencent/weknora