Skip to main content
Q

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.

Install

dsh plugin --profile web add github:qui11zxy/dsh-hsr

README

dsh-hsr

npm

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查遗器套装
--listhsr-find列清单,可与 --role / --lightcone / --relicset 同用
--baseType 命途hsr-find按命途筛选:毁灭、巡猎、智识、同谐、虚无、存护、丰饶、记忆、欢愉
--damageType 属性hsr-find按属性筛选,仅角色:物理、火、冰、雷、风、量子、虚数
--star 星级hsr-find按星级筛选,仅光锥:3、4、5
--stage 玩法hsr-stage查深渊关卡:忘却之庭、虚构叙事、末日幻影、异相仲裁(可加关卡号,如 异相仲裁 3)
--lang 中|英全部输出语言,默认中文
--rulehsr-rule返回使用规则与查询经验
--teamKnowledgehsr-rule返回游戏规则目录与配队经验,准备配队时用
--teamKnowledge --section 3hsr-rule取游戏规则里的某一节(编号、标题都行,--section all 取全文)
--exphsr-exp只返回查询经验
--exp --teamhsr-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.mdmodel-team.md模型发现口径不对时自己写
用户经验~/.dsh/dsh-hsr/experience/user.mduser-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

Related plugins