StarRailCopilot国际服养成规划功能的技术实现方案

背景介绍

StarRailCopilot是一款为《崩坏：星穹铁道》游戏设计的自动化辅助工具。在国际服版本中，由于官方未提供内置的养成规划入口，开发团队需要寻找替代方案来实现这一功能。

技术挑战

国际服玩家目前无法直接使用游戏内的养成规划功能，这给资源管理和角色培养带来了不便。开发团队考虑通过解析Hoyolab网页端的养成规划器来获取玩家的养成需求数据。

解决方案

方案概述

1. 用户操作流程：

   • 玩家首先在Hoyolab网页端设置自己的养成需求
   • 通过浏览器将规划页面保存为HTML文件到本地
   • 在StarRailCopilot工具中导入该HTML文件

2. 技术实现：

   • 使用lxml库解析HTML文件
   • 从DOM结构中提取养成需求数据
   • 将解析结果转换为工具内部数据结构

技术细节

HTML文件的结构分析显示，养成数据存储在特定的DOM节点中。例如，材料需求被包裹在具有特定CSS类名的div元素中，包含以下关键信息：

• 材料图标
• 材料名称
• 需求数量
• 当前差异值

解析器需要定位这些特定节点，提取其中的文本内容，并进行适当的数据清洗和转换。

实现建议

开发团队可以参考项目已有的PlannerProgressParser类中的from_planner_results方法实现。该方法已经提供了类似的功能框架，可以作为基础进行扩展。

技术优势

这种实现方案具有以下优点：

1. 兼容性强：不依赖游戏客户端API，适用于国际服
2. 用户友好：操作流程简单直观
3. 可维护性：基于HTML解析的技术成熟稳定

未来展望

随着游戏版本的更新，开发团队将持续关注官方API的变化，在条件允许时迁移到更直接的接口调用方案，以提供更流畅的用户体验。同时也会优化现有HTML解析方案的性能和稳定性。

这种技术实现为国际服玩家提供了与国服相近的功能体验，体现了开发团队对多版本支持的重视和对玩家需求的积极响应。