Riven Analyst

Riven Analyst 是一个面向《星际战甲》玩家的 Agent 插件。把紫卡截图交给 Claude Code 或 Codex，即可获得卡面解读、使用或洗炼建议，并按需继续分析完整配卡。

项目结合经过整理的本地知识、武器数据与当前版本资料，为紫卡判断和配卡分析提供依据。

功能

• 从截图中识别武器、紫卡词条、数值、段位和洗炼次数。
• 结合武器变体、紫卡倾向和词条数值范围，给出“直接用、继续洗或暂缓”的建议。
• 说明每条属性为什么有用、负面是否适合当前武器，以及下一次洗炼可以追求什么。
• 在玩家提出配卡或伤害问题时，搜索社区热门配卡和调用mcp计算器，以此生成八槽配卡、替换建议和同条件计算。

使用范围

准确性说明

本项目仍在持续完善中。受限于作者对游戏机制的理解、数据来源及版本更新，伤害计算、词条评价和相关知识整理可能存在遗漏或错误。项目提供的分析结果仅供参考，欢迎熟悉相关机制的玩家通过 Issue 或 Pull Request 指出问题、补充资料，共同完善本项目。

工作流程

flowchart LR
    A[放入紫卡截图] --> B[识别武器和词条]
    B --> C[结合武器数据与紫卡范围]
    C --> D[给出使用或洗炼建议]
    D --> E{需要完整配卡?}
    E -- 否 --> F[完成报告]
    E -- 是 --> G[补充八槽配卡与替换说明]

快速开始

让 Agent 安装

把下面这段话发给 Claude Code：

请帮我安装这个仓库：
https://github.com/ruali-dev/Riven-Analyst

请按照 docs/INSTALL.md 完成安装。需要配置视觉模型时，打开插件里的 mcp-server/vision-config.html 让我填写；保存后重启 Claude Code 会话，确认插件可以使用后告诉我。

Agent 会完成仓库注册、插件安装和一次性权限配置。详细安装步骤放在 docs/INSTALL.md，marketplace 与 JSON 配置也由 Agent 管理。

配置视觉模型

安装过程中会打开 mcp-server/vision-config.html。页面只需要填写四项：

• Provider 标识
• 视觉模型 ID
• API Base URL
• API Key

配置页支持 OpenAI-compatible 接口。硅基流动配置示例：

https://api.siliconflow.cn/v1
Pro/moonshotai/Kimi-K2.6
moonshotai/Kimi-K2.7-Code

填写完成后，选择本机 .claude 目录保存，并重新加载 Claude Code 插件。

使用方法

把截图放进当前项目，然后直接告诉 Agent：

请分析下 screenshots/1.png 这张紫卡截图。

报告通常包含三部分：当前紫卡是否值得用、每条属性对武器的实际意义，以及继续洗炼时的目标词条。

需要完整配卡时，可以继续问：

请结合我使用的武器版本和当前配卡，给出完整八槽，并说明这张紫卡适合替换哪张 MOD。

更新

把下面这句话交给 Agent 即可更新：

请把 Riven Analyst 更新到仓库最新版本，并保留当前的视觉模型配置。

数据与致谢

武器、MOD、中文本地化和部分紫卡倾向数据由 Warframe Community Developers（WFCD） 的 warframe-items 数据派生。感谢 WFCD 长期维护 Warframe 社区数据。

项目还会结合经过整理的本地知识与当前版本资料，为紫卡判断和配卡分析提供依据。

路线图

• 扩充武器和特殊机制资料。
• 完善近战紫卡与近战配卡计算。
• 增加更多视觉模型供应商配置模板。
• 持续改进紫卡报告的表达和数值说明。

参与项目

欢迎提交 Issue 或 Pull Request。代码结构与数据边界见 架构说明，计算规则见 计算参考。

许可证

项目使用 Apache License 2.0。

《Warframe》《星际战甲》及相关名称、美术与游戏资产归其权利人所有。Riven Analyst 是非官方社区项目，与游戏开发商或发行商不存在隶属关系。README 主视觉为项目原创的同人科幻设计，不包含官方 Logo、角色或提取自游戏的素材。