dsh-genshin-account

DeepSeek Harness 插件：把你的原神账号读成一份快照，然后在两处用起来 —— 对话里问（agent 工具），界面上看（侧边栏「原神启动」）。

A DeepSeek Harness plugin that reads your Genshin Impact account into one snapshot and exposes it as agent tools plus a GUI panel.

截图

概览：账号主卡、展柜角色评分一览、元素分布与进度。

角色页：完整练度、五件圣遗物与逐条副词条评分。

抽卡页：星级分布、各池保底进度、每月抽卡量（柱 + 折线）。

五星记录与出货区间：欧非分档、「歪」标记、区间分布。

五星记录

能做什么

侧边栏「原神启动」六个页签：

页签	内容
概览	账号主卡（昵称 / UID / 冒险等级 / 区服 / 主元素）、角色·五星·四星·展柜数字块、展柜角色评分一览、元素分布、等级分布、进度与数据状态
角色	左侧列表（官方头像 + 元素描边，可搜索、按元素筛选、按等级/稀有度/命座/名字排序），右侧完整练度：命座、三段天赋、面板、武器、五件圣遗物与评分、生效套装效果；右上角可导出长图
抽卡	总抽数 / 五星 / 四星 / 平均出金 / 欧非比、各池抽数与保底进度、星级分布、每月抽卡量、五星出货区间、五星记录（带欧非分档与「歪」标记）
武器	卡片网格（官方图标 + 稀有度描边），按类型 / 星级筛选
设置	UID、扫码登录、安全验证、展柜重新同步
关于	版本、仓库、博客、功能说明

明暗主题自适应；所有游戏图标来自官方 CDN，元素图标内联在包里，离线可用。

安装

dsh plugin --profile web add dsh-genshin-account

也可以直接从 GitHub 装（源码最新）：

dsh plugin --profile web add github:EagleClark/dsh-genshin-account

本地开发可以装成 link（改完即时生效）：

dsh plugin --profile web add <仓库绝对路径>

装完重启 DSH，刷新页面即可看到「原神启动」。

配置（都在页面里，不用改文件）

第一次打开会落在设置页，三步：

填国服 UID —— 服务器按 UID 自动判断（1/2 → 天空岛 cn_gf01，5 → 世界树 cn_qd01）
扫码登录 —— 点「生成二维码」，用手机米游社 App 扫码确认；会话由插件自己从 Set-Cookie 取，不需要你复制 Cookie
安全验证 —— 拖一次 geetest 滑块，通过后插件自动换取 x-rpc-challenge 并立刻读取账号

验证是按接口发放的（/index 与 /character/list 各一次），所以可能连续弹两次滑块；通过后自动完成，不需要重新配置。

页面里还有接口诊断：用当前会话依次请求三个接口并逐个报告返回码，排查时比猜有用。

Cookie 只存在本机，/state 从不回显（只回 hasCookie: true/false）。

数据来源

数据	来源	需要登录
全部角色、等级、命座、三段天赋、武器名与等级、圣遗物部位与等级	养成计算器 `api-takumi.mihoyo.com/.../sync/avatar/detail`	是
圣遗物主副词条、角色面板、武器精炼	游戏内「角色展柜」→ `profile.microgg.cn/api/uid/<uid>`（国际服回落 `enka.network`）	否，按 UID 公开
深境螺旋 / 幻想真境剧诗 / 幽境危战 / 成就 / 好感	展柜 payload 的 `playerInfo` 与 `role_combat` / `hard_challenge`	否
祈愿记录	`getGachaLog`（需手动粘贴一次链接）	否，但 authkey 约 24 小时过期

展柜是圣遗物副词条唯一的通路：把角色放进游戏内「角色展柜」并开启「显示详情」，等 5 分钟，再同步。上限 8 个角色，其余角色只有部位、散件名和等级。

祈愿链接这样拿：游戏内打开一次祈愿历史，然后运行

iex(irm 'https://www.lelaer.com/cn.ps1')

把复制到的整段链接粘进抽卡页即可。

评分怎么算

插件给每件圣遗物两个可解释的数，都不假装是伤害计算。

CV（暴击值）

CV = 暴击率 × 2 + 暴击伤害，只算副词条；理之冠主词条是双暴时也计入（暴击率 31.1% 记 62.2）。

部位	拉完了	及格	良好	小毕业	大毕业	传家宝
生之花 / 死之羽	<30	30–34	35–39	40–44	45–49	≥50
时之沙 / 空之杯	<25	25–29	30–34	35–39	40–44	≥45
理之冠	<50	50–59	60–69	70–79	80–94	≥95

五件合计按「各档下限之和」：及格 160 / 良好 190 / 小毕业 220 / 大毕业 250 / 传家宝 285。

权重评分（角色页默认）

评分 = Σ（词条数值 × 官方系数 × 该角色权重），只算副词条 + 理之冠主词条。

词条	系数	词条	系数
暴击率	×2	大攻击 / 大生命	×1.33
暴击伤害	×1	大防御	×1.06
元素精通	×0.33	小攻击	×0.199
元素充能	×1.1979	小生命 / 小防御	×0.0172 / ×0.221

角色权重在 data/character-weights.json（120 个角色 × 8 项，按百分比存），未收录的回落「通用」模板。一次满档强化约 7.75 分；六档门槛：普通部位 23.3 / 31 / 38.8 / 46.5 / 54.3，理之冠 85.3 / 93 / 100.8 / 108.5 / 116.3，五件合计 178.3 / 217 / 255.8 / 294.5 / 333.3。

角色页可在 CV / 权重评分 之间切换，卡片与总分一起变。

强化次数与初始词条

接口只给最终数值，但每次强化只能取官方四档，所以数值可以唯一分解成强化次数：卡片上 3 次 是精确次数，≈4 表示需要靠整件总次数约束求解。总次数减升级次数就是初始词条数（5★ +20 共 5 次）。

抽卡

池子：新手 / 常驻 / 角色活动（301 与 400 共享保底）/ 武器活动 / 集录
平均出金、欧非比（相对 1.6% 基础出率的倍率）
五星记录带六级欧非分档与「歪」标记（常驻五星判定）
图表：星级分布（横向堆叠柱）、每月抽卡量（柱 + 折线双轴）、五星出货区间（柱 + 数值标签）

图表用 Chart.js 4（MIT）。库已内联进客户端包，不新增任何路由，也不显示第三方标识。

Agent 工具

装好后自动获得 6 个工具：

工具	作用
`genshin_account_overview`	账号总览：数量、元素分布、进度、最佳圣遗物
`genshin_characters`	角色列表，按元素 / 武器类型 / 最低等级过滤与排序
`genshin_character`	单个角色完整练度（支持中文名 / 英文名 / 别名 / id）
`genshin_artifacts`	圣遗物筛选与排序（套装、部位、角色、最低 CV）
`genshin_weapons`	武器筛选（类型、最低稀有度、是否已装备）
`genshin_gacha`	祈愿分析：抽数、平均出金、欧非比、各池保底、五星记录

返回结构化 JSON 同时附一份给人看的文本；数据不可用时给可读的错误，不抛异常。

数据文件

data/ 是精简过的中文字典，运行时不需要网络：

文件	内容
`characters.json`	124 个角色：中文名 / 英文名 / 元素 / 武器类型 / 稀有度 / 别名
`weapons.json`	255 把武器：中文名 / 类型 / 稀有度
`artifact-sets.json`	63 套圣遗物：中文名 + 2 / 4 件套效果原文
`character-weights.json`	120 个角色的权重评分系数
`weapon-details.json`	90 级基础攻击、副属性、精炼 1–5 被动原文
`aliases.json` / `names-zh.json`	别名与 hash 索引
`skill-orders.json`	每角色的「普攻 / 战技 / 爆发」顺序（技能 id 不按此递增，按 id 排序会张冠李戴）
`element-icons/*.webp`	官方七元素图标母图；`scripts/build-element-icons.mjs` 转成 96px PNG 内联进包

已知限制

角色与武器需要登录态；展柜按 UID 公开可读，是唯一例外
圣遗物只覆盖展柜角色（最多 8 个），其余角色只有部位、散件名与等级
展柜有 5 分钟延迟
逆向接口：签名盐与 app_version 会随官方改版失效（-10001），届时在高级设置里更新；频繁请求会被限流
CV 与权重评分是通用质量指标，不等于角色收益，更不是伤害计算
4★ 圣遗物的强化位数按 7 位估算，可能与游戏内差一位

开发

npm test                                   # 13 个测试文件
node scripts/ui-preview.mjs                # 渲染各页签截图到临时目录
PREVIEW_LOCAL=1 node scripts/ui-preview.mjs  # 用仓库代码现算快照

预览需要 react / react-dom（放 REACT_DIR）与 Edge。面板要等 effect 填数据才有内容，静态渲染看不出真实排版。

重新生成数据（需要网络，仅开发时）：

node scripts/build-dict.mjs <genshin-db 路径>
node scripts/build-names.mjs
node scripts/build-skill-orders.mjs
node scripts/build-weapon-details.mjs
node scripts/build-character-weights.mjs
node scripts/build-element-icons.mjs   # 改了元素母图后重跑
node scripts/inline-chart.mjs          # 升级 chart.js 后重跑

游戏更新后名字缺失，重跑前四条即可，插件本身不用改。

路由（15 条，全部同源）：/state /summary /character /artifacts /weapons /sync /gacha /gacha/sync /login/qr /login/poll /verify/widget /verify/start /verify/finish /probe-miyoushe /diag。

许可

MIT。随包游戏数据由 genshin-db（MIT）与 EnkaNetwork/API-docs 生成，游戏名称与内容版权归米哈游所有。

dsh-genshin-account

Installer

README