前言¶
在 DeepSeek Harness（DSH）里做《明日方舟》相关对话时，模型往往缺少可核验的游戏数据：干员数值与档案、关卡掉落、剧情台词、泰拉大典考据，单靠通用联网搜索容易漏页、格式杂乱，也不便于工具化返回。社区插件 dsh-ark-wiki（维护者 wsk114514）把 PRTS Wiki 查询和一套带置信度的卡池/新角色方向性推断封装成两个模型可调用的工具，装好后用自然语言提问即可，由宿主在对话中按需调用。
下面介绍插件定位、两个工具的契约，以及安装与典型用法。事实以 GitHub 仓库 README 与 SkillHub 目录页 为准；本项目为非官方粉丝作品，与鹰角网络、《明日方舟》官方及 PRTS Wiki 无隶属关系。
这是什么¶
dsh-ark-wiki 是分类为「联网工具」的 DSH bundle：向会话注册 ark_wiki_lookup 与 ark_banner_predict，前者从 PRTS 拉取结构化数据供模型作答，后者默认基于剧情卡司快照做概率性的新角色/异格候选推断，也可按 PRTS「卡池一览」历史排期推断下期卡池与 UP 干员；两者均返回置信度、理由与信号。当前 npm 版本为 0.10.0，许可证 MIT，GitHub 星标数为 1（以目录页与仓库公开信息为准）。
核心功能¶
ark_wiki_lookup：PRTS 结构化查询¶
工具面向干员（技能、天赋、档案、密录）、物品、关卡、剧情、干员出场表，以及 PRTS「泰拉大典」世界观考据。调用时可传 query 与可选 category（operator | item | stage | story | world）；省略 category 时按查询词自动判定类别（例如含「泰拉大典/世界观」走世界观，形如 1-7、CE-5 的代号优先关卡，干员名加「出场」走剧情出场表等）。
返回值为声明了 output.schema 的 canonical JSON envelope，主要字段包括 status、category、query、matchedBy、entry（命中条目的结构化数据）、candidates（未命中时最多 8 条建议）、message、source（可回溯 PRTS 页面）。插件还提供 render，将结果渲染为 Markdown 摘要并附来源链接。
ark_banner_predict：新角色/异格与卡池排期（方向性）¶
默认模式（debut）根据剧情里反复出现但未进卡池的人物、长期无新剧情的干员等信号，给出 3–4 名候选及 confidence、reason、signals。也可通过 banner_type（debut | standard | limited | rerun | kernel）与 hint 切换到卡池排期推断；region 默认为 cn。README 明确这是概率性、带信号说明的推断，春节/新年限定或数据不可用时 candidates 可能为空。
安装与启用¶
插件以当前 DSH 进程的权限运行，安装前建议阅读仓库源码与 MIT 许可证，并确认 profile 名称（下文示例为 web，可按实际改为 desktop 等）。
方式一：npm（README 推荐）
dsh plugin --profile web add dsh-ark-wiki
方式二：从 GitHub 源码安装
# 1. 装到目标 profile（把 web 换成你实际使用的 profile 名）
dsh plugin --profile web add github:wsk114514/dsh-ark-wiki
# 2. 把包名 "dsh-ark-wiki" 写进该 profile package.json 的 dsh.profile.bundles 数组
环境要求（见 package.json）：Node >=22，DSH >=0.2.1-rc.1；依赖宿主注入的 @deepseek-ai/cordis 与 @deepseek-ai/dsh-tools（peerDependencies）。
装完后无需单独配置 API Key 即可在对话里提问；模型会在需要时调用上述工具。
典型用法¶
README 给出的自然语言示例可直接复现，例如：
- 「阿米娅的属性、技能和天赋」
- 「至纯源石是干什么用的」
- 「1-7 的掉落和敌人」
- 「0-1 坍塌 行动前 有哪些台词」「12F 干员密录」
- 「克莱门莎最早在哪个剧情出场」
- 「矿石病是什么」「维多利亚的首都」「整合运动」「泰拉年表」
需要显式指定查询类别时，工具参数形如：
{ "query": "阿米娅", "category": "operator" }
卡池/新角色推断示例：
{ "hint": "下个版本可能回阿戈尔或伊比利亚" }
{ "hint": "莱塔尼亚活动", "banner_type": "standard" }
适用场景与注意¶
适合在 DSH 里做明日方舟资料问答、剧情与设定检索、以及需要附带 PRTS 来源的结构化回答的场景；卡池与新角色相关回答应理解为带置信度与理由的方向性参考，而非官方预告。
再次说明：所有游戏数据与 wiki 文本版权归原权利方，插件仅做实时查询与展示，仅供个人非商业用途。社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；dsh-plugin.org 收录申请已提交、等待人工核实（见 README）。
