前言¶
在 DeepSeek Harness（DSH）里做 agent，常见需求是「用户丢一个游戏 UID，希望 agent 能读出角色等级、武器和面板数值」。自己拼 Enka、mihomo 等公开接口、再整理成中文报告，要处理三款游戏的不同字段，还要和工具描述对齐，工作量不小。
下面介绍社区插件 dsh-game-uid（维护者 FireflyLover520，分类：联网工具）。它向 DSH 注册工具 game_uid：传入 UID，把展柜角色的等级、命座、天赋、武器、汇总面板以及圣遗物 / 遗器 / 驱动盘套装构成整理成一份中文报告，只展示数据，不打分、不评级。
这是什么¶
dsh-game-uid 是 DSH 的联网类插件，当前版本 0.2.7（MIT 许可证）。支持匿名查询的三款游戏为：原神、崩坏：星穹铁道、绝区零。对 game 传入异环（nte）或鸣潮等没有公开按 UID 匿名查接口的游戏时，插件会返回说明，不会编造数据。
插件仅在 macOS 版 DeepSeek Harness 上验证过（DSH 0.2.x / 桌面端）。若在 Windows 上无法运行，可按 README 建议让 agent 协助适配路径与导出逻辑；接口本身为公开只读 API。
核心功能¶
工具 game_uid¶
| 参数 | 必填 | 说明 |
|---|---|---|
uid |
是 | 原神 / 星铁 / 绝区零 UID（9~10 位数字） |
game |
否 | auto（默认，三游戏并发探一次）/ genshin / hsr / zzz / nte |
format |
否 | md（默认）/ text（去掉 Markdown，适合 QQ）/ qq（一行紧凑版，≤150 字） |
角色 |
否 | 逗号或顿号分隔的角色名；点名则只输出这些；不传则输出展柜全部 |
save |
否 | true 时落地 JSON + Markdown 存档，默认不写盘 |
detail |
否 | 已弃用，保留兼容；工具只返回汇总面板，不列单件词条 |
对 agent 用自然语言即可，例如：「查一下 UID 618285856 的练度」「只看这个号的甘雨」「637000000 星铁练度怎么样，存个档」。
输出内容¶
报告包含游戏名、UID、昵称、冒险等级 / 等价信息、展柜人数，以及每个角色的元素、等级、命座、天赋、武器类型、武器与汇总面板（生命、攻击、防御、双暴等），以及套装件数构成。示例形态如下（README 摘录）：
🎮 **原神** · UID `618285856`
👤 Algoinde · AR57 · 世界等级 8 · 成就 458 · 展柜 4 人
**甘雨** (冰) · Lv.90 · 0命 · 天赋 9/9/9 · 弓
⚔️ 阿莫斯之弓 R3 · Lv.90 · 5★ · 基础攻 608 · 攻击力 49.6%
📊 生命 9797 · 攻击 2471 · 防御 630 · 暴击率 40.3% · 暴击伤害 180.2%
🧿 冰风迷途的勇士 4 件 + 角斗士的终幕礼 1 件
不提供单件圣遗物词条明细，也不做强弱评价。
数据来源与可见范围¶
- 原神：
https://enka.network/api/uid/<uid> - 星铁：
https://api.mihomo.me/sr_info_parsed/<uid>?lang=cn - 绝区零：
https://enka.network/api/zzz/uid/<uid>
角色 / 武器 / 套装中文名表在构建时从 Enka 官方 store 抽取，落在插件 data/ 目录，运行查表不额外联网；取玩家数据时各请求一次。因此只能看到放进游戏展柜 / 支援展示的角色，且公开数据通常有几分钟缓存延迟。
内置 data/chars.json 随发包更新（README 提及当前含 147 个原神角色等）。表内没有的 avatarId 会按需拉取 Enka 的 store/gi/avatars.json 与 gi/locs.json 补名，60 秒内不重复尝试；本地修改 chars.json 会按 mtime 自动重读，无需重启 DSH。
星铁与绝区零的补充处理¶
星铁面板会按 mihomo 行为补齐：击破特攻 缺失时按 100% 白值；伤害加成 汇总各元素加成行；能量恢复效率 补回 100% 基底后再显示百分比。
绝区零在 Enka 基础值之上，插件按文档自行叠加命座技能等级、四段式角色本体面板，以及音擎与驱动盘对完整面板的还原；套装 2/4 件无条件数值来自维护在 data/zzz-suit-bonus.json 的 wiki 抓取结果。音擎被动与条件型套装效果未计入面板，报告中会注明。
维护期间若 Enka ZZZ 返回 424，插件会尝试使用 ~/.dsh/game-uid-archive/zzz-cache/ 下 24 小时内成功查询的缓存，并在报告顶部标注；无可用缓存则如实提示维护中。
与 QQ 群场景的配合¶
若同时使用 dsh-qq-bridge，群内 @ 机器人并给出 UID 时，agent 可调用 game_uid；format=qq 适合 bridge 对超长回复的截断规则（约 160 字）。完整报告仍在 DSH 会话中查看，或通过 save=true 存档。
安装与启用¶
安装命令以 README 为准，使用本地 tgz 包路径（勿凭仓库名自行拼接 GitHub 安装串）：
dsh plugin --profile <profile> add file:/path/to/dsh-game-uid-<version>.tgz
安装后需完全退出桌面端再重开（macOS 上 ⌘Q），新插件代码才会装载。
插件以当前 DSH 进程权限运行，会向上述第三方域名发起 HTTPS 请求。安装前应阅读仓库源码与 MIT 许可证，确认可接受联网范围与数据展示方式。
典型用法¶
- 在 DSH 对话中让 agent 查 UID，默认
game=auto、format=md。 - 限定角色：
角色=甘雨或角色=甘雨、班尼特；不在展柜中会直接说明，而非空报告。 - 需要落盘：
save=true，文件写入环境变量DSH_GAME_UID_ARCHIVE指定目录，默认为~/.dsh/game-uid-archive，文件名形如genshin-618285856-<ts>.json与同内容的.md。 - 发到 QQ：
format=text或format=qq。
适用场景与注意¶
适合需要在 DSH agent 工作流里快速读 UID 练度与汇总面板的开发者或个人用户，尤其是已习惯用自然语言驱动工具、又不想每次手写 HTTP 与字段映射的场景。
需注意：只能查展柜可见角色；公开 API 延迟与 Enka 维护会影响绝区零实时性；Windows 未在 README 中验证；插件不替代游戏内详情页，也不提供打分或配装建议。
结尾¶
dsh-game-uid 把三款游戏的 UID 查询收成 DSH 里一个工具调用，输出统一的中文汇总报告，并支持点名、多格式与可选存档。社区目录页与源码仓库如下，版本与参数以 README 与 package.json 为准。
- 目录页：https://www.skillhub.cn/plugins/FireflyLover520/dsh-game-uid
- GitHub：https://github.com/FireflyLover520/dsh-game-uid
