阴阳师助手（AstrBot 插件）（下载最新版）

在 QQ 群里回答《阴阳师》手游问题：查式神、查御魂、算满暴、看克制、搜网易大神最新攻略（带图转发）、看图识别式神/御魂。

生成说明：本项目的代码、文档与数据整理由 deepseek-v4.1flash-1017 模型生成。

功能

1. 图卡介绍（不是纯文本）

每个式神/御魂/阴阳师都有一张介绍图卡（data/cards/，共 353 张）：立绘、面板、技能与升级、词条、御魂参考，暗色卡片风格，/yys 天照 直接发图。

2. 被动回复只接明确提问

群里只有“明确在问阴阳师”（式神/御魂/攻略/配装/面板/满暴等 + 提问语气）才会自动回答； “帮我改配置”“更新插件”这类管理消息不会插话，也不会顶掉主机器人的指令。

3. 本地知识库（不联网也能答）

277 个式神/英杰：六星面板（攻击/生命/防御/速度/暴击/暴伤/命中/抵抗）、稀有度、CV、定位标签、黑话别名（“修子哥”“阿离”“高铁”……）
全部技能：鬼火消耗、被动/普攻类型、完整描述、Lv2~Lv5 升级效果、引用的 buff/印记词条原文
70 个御魂：57 普通 + 13 首领，2 件套 / 4 件套效果、获取途径
阴阳师/英杰：晴明、神乐、八百比丘尼、源博雅、源赖光、藤原道长全技能与选择建议
机制手册：伤害公式、暴击与满暴、御魂位置/主属性、速度行动条、效果命中/抵抗、控制驱散、三层克制关系、PVE/PVP、黑话

2. 满暴与面板计算

输出式神一律按 先满暴（面板暴击 100%），再算攻击 × 暴伤 的口径，不搞概率学。

/yys 算 攻击8000 暴击95 暴伤260
→ 未满暴：还差 5%
→ 当前期望 ×3.470；满暴系数 ×3.600；补满暴 +3.7%
→ 满暴后 攻击×暴伤 = 28800

3. 网易大神最新攻略（ds.163.com）

/yys 攻略 魂土配置
/yys 攻略 魂王
/yys 攻略 真蛇
/yys 攻略 地域鬼王配置
/yys 攻略 斗技阵容
/yys 攻略 道馆 / 逢魔 / 六道之门 / 业原火 / 秘闻 / 结界突破 / 永生之海
/yys 攻略 天照魂土配置        # 式神 + 玩法组合

自动检索圈子里最新的图文攻略，优先挑带阵容码的：直接发「阵容码 + 阵容码二维码」，扫码/复制即可导入；没有阵容码的再发普通图文攻略
回复标题、作者、日期、正文摘要、原文链接
把攻略里的图片转发到群里（默认最多 2 张，可配置）
超过 1 年会标注“可能已过时”；搜不到近期攻略会明确说“按机制给通用思路”，不拿旧配置冒充最新
群聊里问“魂土怎么配阵容”“咲耶御魂怎么带”会自动触发

4. 看图识别

三层流水线，从准到快：

截图文字：视觉模型读图里的式神/御魂名，读到就直接按名字查库
本地立绘匹配：白底内容裁剪 + 16×16 颜色特征，同画作匹配准确率高，双阈值防误判
视觉模型识别 + 官方立绘二次确认：认错时降级为“看着像 X（置信度一般）”，不硬编

识别成功后直接给该式神的面板、定位、御魂推荐、246 和毕业目标。

5. 群白名单

默认不启用任何群，第一次使用要在配置里添加自己的群号（或让管理员发 /yys 加群群号）：

WebUI → 插件 → 阴阳师助手 → 配置 → group_whitelist 添加群号（留空则不限制群）
群里管理员发 /yys 加群群号

DeepSeek Harness 插件

仓库里的 dsh/ 是 DeepSeek Harness（Cordis）插件包 dsh-Onmyoji-Guide，和 AstrBot 插件共用 data/：

yys_lookup：式神/御魂/阴阳师资料
yys_skills：完整技能
yys_calc：满暴与面板收益
yys_guide：网易大神最新攻略（优先阵容码）
yys_card：介绍图卡路径

安装：在 DSH 插件管理里安装 dsh/ 目录，或 plugin_manager install_bundle target=<仓库路径>/dsh（包名 dsh-onmyoji-guide，显示名 dsh-Onmyoji-Guide）。仓库根目录也声明了 dsh.bundle，可直接从仓库安装。详见 dsh/README.md。

安装

方式一：WebUI 上传（推荐）

下载 Release 里的 astrbot_plugin_yys.zip
AstrBot WebUI → 插件 → 安装 → 上传文件

方式二：克隆到插件目录

cd AstrBot/data/plugins
git clone https://github.com/your-name/yys.git astrbot_plugin_yys

建议把目录名改成 astrbot_plugin_yys（与 metadata.yaml 的 name 一致）。如果仓库名就是 yys，也可以直接把克隆下来的目录重命名。

重启 AstrBot 或点击插件页的“重载”。

依赖

插件本身不强制第三方依赖，使用 AstrBot 自带的 aiohttp / Pillow。可选：

pip install rapidocr_onnxruntime "numpy<2"

装完后本地 OCR 也能读截图文字（不装则由视觉模型读）。

配置

WebUI → 插件 → 阴阳师助手 → 配置：

配置项	默认	说明
`group_whitelist`	`[]`	启用的群号列表；留空 = 不启用任何群
`passive_mode`	`keyword`	`keyword` 关键词自动答；`off` 只响应指令
`passive_keywords`	见 schema	触发自动回答的关键词
`passive_cooldown`	`6`	同群自动回答冷却（秒）
`enable_image`	`true`	图片识别开关
`enable_vision`	`true`	本地匹配失败时调用视觉模型
`enable_ds`	`true`	网易大神攻略检索开关
`ds_max_images`	`2`	每条攻略最多转发几张图
`ds_max_qr`	`2`	有阵容码时最多生成几张二维码
`ds_guide_days`	`400`	攻略时效（天），超过降权/标注
`ds_cookie`	空	大神 Cookie（可选，游客被拒时用）
`max_reply_chars`	`900`	单条回复最大字数
`allow_private`	`true`	是否允许私聊使用
`quick_card`	`true`	简单查询直接回卡片

指令

/yys 天照                       式神面板 + 技能列表 + 御魂推荐 + 毕业面板
/yys 技能 天照                  完整技能描述（含 buff 词条）
/yys 御魂 破势                  2/4 件套效果 + 获取途径
/yys 阴阳师 晴明                主角全技能 + 选择建议
/yys 满暴 天照                  满暴凑法（6号位暴击/暴伤两种方案）
/yys 算 攻击8000 暴击95 暴伤260   满暴判定、期望系数、攻击×暴伤、边际收益
/yys 评分 暴击8 暴伤12 攻击加成5   御魂双暴评分
/yys 克制 破势                  克制关系
/yys 攻略 魂土配置              网易大神最新阵容/配置（带图）
/yys 攻略 天照                  网易大神最新式神攻略（带图）
/yys 大神登录                   管理员扫码登录大神（游客被拒时用）
/yys 大神状态                   查看当前游客/登录态
/yys 加群 123456789             管理员加群
/yys 帮助

快捷指令：/式神天照、/御魂破势、/满暴天照。

玩法/副本黑话

黑话	对应
魂十	八岐大蛇十层
魂土 / 魂十一	八岐大蛇十一层（悲鸣）
魂王 / 魂十二	八岐大蛇十二层（神罚）
魂B / 魂玉	八岐大蛇十三层（虚无）
真蛇	真·八岐大蛇
封魔	逢魔之时
下海	永生之海
困28	探索困难 28 章
地鬼	地域鬼王

示例

用户：/yys 算 攻击8000 暴击95 暴伤260
助手：面板：攻击 8000｜暴击 95%｜暴伤 260%
      ⚠️ 未满暴：还差 5% 暴击。输出必须满暴，否则每段伤害都在赌。
      满暴系数（攻击×暴伤）：×3.600
      当前期望系数：×3.470（暴击率 95%）
      补满暴后期望提升：+3.7%（这是稳定收益，不是概率）
      满暴后 攻击×暴伤 = 8000 × 3.60 = 28800

用户：/yys 攻略 魂王
助手：【大神攻略·魂王】【神罚大蛇】单雪御前输出面板1.78w左右
      作者：意气风发猫十八｜2026-10-30
      （魂王：八岐大蛇十二层（神罚），吃御魂加成）
      ...
      [图片] [图片]

用户：魂土怎么配阵容？
助手：先说一句：资料里那篇标着“魂土”的攻略其实是斗技挖土……
      魂土副本这边没搜到最新攻略，下面是按机制给的通用思路……

开源与贡献

本项目是完全开源的，任何人都可以贡献代码、数据、攻略或文档，但必须遵守以下规则：

必须发布到 GitHub：所有贡献通过 Pull Request 提交并合并到本仓库，成果在本仓库公开共享；不接受只在私下/群里分发的修改版。
必须标注来源：数据、攻略、图片、文本都要写清来源链接（灰机 wiki 页面、大神原帖、官网、社区原帖 + 作者 + 日期），无法确认来源的内容不要提交。
禁止隐私数据：不提交真实群号、QQ 号、IP、账号密码、Cookie、聊天记录、含个人信息的截图。
授权：代码默认 MIT，数据整理/文档默认 CC BY-NC-SA 3.0（与灰机 wiki 一致）。
AI 生成内容请注明模型；本项目由 deepseek-v4.1flash-1017 生成。

详见 CONTRIBUTING.md。

来源标注

内容	来源
式神/御魂/技能	灰机 wiki Data 页（`Data:Character/<id>.json`、`Data:Soul.json` 等）
主角技能	官网主角录 + 社区攻略
机制/配装/克制	官方攻略 + 社区共识，插件内标注“以游戏内为准”
大神攻略	ds.163.com 原帖，保留原文链接与作者
游戏图片/数值	版权归网易（杭州）网络有限公司

完整说明见 docs/数据来源.md 与 NOTICE。

数据来源

式神/御魂/技能：阴阳师灰机 wiki（yys.huijiwiki.com）的 Data 数据页，逐页抓取：
- Data:Character/<id>.json 280 个文件 → 277 个式神/英杰
- Data:Attribute.json 277 条六星面板
- Data:Soul.json 70 个御魂
- Data:SkillBuffs.json 1158 条 buff/印记、Data:SkillTips.json 156 条词条
- Data:CharacterIndex.json、Data:Skin.json
主角技能：官网主角录 + 社区攻略补全
机制/配装/克制：官方攻略与社区共识整理，插件内标注“以游戏内为准”
大神攻略：ds.163.com 圈子公开接口 + 搜索引擎站内检索（360/Bing/百度多源兜底）

游戏数据随版本调整，插件内为整理时的版本；具体以游戏内为准。

目录结构

yys/
├── main.py               # 插件入口：指令、群监听、白名单、攻略/图片转发
├── yys_kb.py             # 知识库：检索、格式化、玩法/副本黑话
├── yys_calc.py           # 满暴、面板、御魂评分
├── yys_vision.py         # OCR / 本地立绘匹配 / 视觉模型
├── yys_llm.py            # 系统提示词与 LLM 调用
├── yys_ds.py             # 网易大神攻略检索、扫码登录
├── data/                 # 知识库 JSON + 机制手册 + cards/（353 张图卡）
├── docs/                 # 交付说明
├── tools/                # 数据抓取/构建脚本
├── metadata.yaml
├── _conf_schema.json
└── requirements.txt

开发

数据重建（需要先抓 wiki 原始数据）：

# 1. 抓 wiki Data 页（需要 Node + playwright-core + Edge）
node tools/scrape_wiki.js

# 2. 生成知识库 JSON
python tools/build_data.py

# 3. 生成图片索引（需要 tools 下载的图片）
python tools/download_images.py
python tools/build_index.py

# 4. 抓大神最新动态（可选）
python tools/fetch_ds.py 6

# 5. 本地冒烟测试（stub 掉 astrbot）
python tools/test_local.py

tools/ 里的脚本默认使用仓库相对路径；scrape_wiki.js 需要把灰机 wiki 的 Data 页抓到 tools/raw/。

已知限制

纯立绘/模型图且没有名字文字时，视觉模型对部分式神会认错，插件会用官图二次确认并降级提示，不硬说。
本地匹配只覆盖“同一张官方画作”，游戏内 3D 模型截图不在覆盖范围。
御魂小图标没有官方图库，御魂识别主要靠截图文字和视觉模型。
大神攻略检索依赖公开接口和搜索引擎，偶尔会遇到验证码；此时自动降级到最近动态语料，搜不到会明说。
攻略相关性是启发式判断，合集/导航类帖子会标注“合集导航”。

免责声明

本项目为非官方玩家工具，与网易游戏无关联。
游戏数据、图片、攻略版权归网易（杭州）网络有限公司及原作者所有，本项目仅用于学习交流，不做商业用途。
插件内整理的数据以游戏内实际表现为准。

License

内容	协议
代码（`.py`、`tools/.js`）	MIT
数据与整理文档（`data/`、`docs/`、图卡文字）	CC BY-NC-SA 3.0
游戏立绘/御魂图/技能原文	版权归网易，非商业展示，不属于 CC 授权
大神攻略	版权归原作者，运行时检索展示

数据来源：阴阳师灰机 wiki（https://yys.huijiwiki.com/），作者为 wiki 贡献者；本项目进行了结构化整理与修改。
本项目由 deepseek-v4.1flash-1017 生成，免费非商业。
详细版权审计见 docs/版权与许可.md。

dsh-onmyoji-guide

安装

README