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（133 条 × 8 项，按百分比存，覆盖全部角色），未收录的回落「通用」模板；取值约定与新角色怎么补见 data/weights-notes.md。
一次满档强化约 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 | 133 个角色的权重评分系数（覆盖全部 124 个角色 + 形态变化的复用项，见 data/weights-notes.md） |
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 生成，游戏名称与内容版权归米哈游所有。
