技能:原神内容添加器 (Genshin Content Adder)
概述
本技能旨在通过“分段确认制”确保仿真精度。在开发过程中,必须严格遵循用户的人工验证节点,严禁跨阶段开发。
🛠️ 标准开发流 (SOP v2.4)
阶段 1:自动化获取与基础验证 (Base Verification)
- 数据抓取:运行
fetch_content.py自动获取属性与倍率。 - [人工确认]:向用户展示
data.py中的BASE_STATS与SKILL_MULTIPLIERS。- 未获确认前,禁止进入下一阶段。
阶段 2:物理数据交互录入 (Physics Entry)
- 生成模版:在角色目录下创建
temp_frames.csv和temp_physics.csv模版。 - 数据填入:由用户将实测的帧数、中断窗口及物理参数填入。
- 数据合并:读取 CSV 并将结构化数据写入
data.py。 - [人工确认]:展示合并后的
data.py动作配置,用户确认转译准确性。
阶段 3:组件化迭代开发 (Component Iteration)
- 原子单位开发:按
entities.py->effects.py->skills.py顺序分块实现。 - 技术交流:每完成一个原子单位,必须展示实现思路、核心算法,并进行深度技术讨论。
- [人工确认]:获得用户对当前逻辑块的明确授权后,方可继续。
阶段 4:组装与终验 (Orchestration & QA)
- 主类总装:在
char.py中实例化并挂载所有组件。 - 序列仿真:运行测试序列并展示
EventFlow日志。 - [最终验收]:用户对整体表现进行最终确认。
📂 目录结构规范
text1character/[REGION]/[name_en]/ 2├── __init__.py # 注册与导出 3├── char.py # 主编排类 4├── data.py # [NEW] 混合数据中心:属性(自动) + 物理(交互) 5├── skills.py # 意图 -> 动作工厂 6├── talents.py # 被动效果 7├── constellations.py # 命座效果 8├── entities.py # [可选] 物理实体逻辑 9└── effects.py # [可选] 角色特有状态
references:
- docs/development/数据录入规范.md
📝 工程标准
- 沟通优先:代码实现不是终点,与用户的讨论和确认才是核心。
- 强制类型标注:所有函数签名必须包含参数和返回值的类型提示。
- 双引号准则:字符串字面量统一使用双引号
"。 - 严禁魔法数字:逻辑代码中所有数值必须引用自
data.py。