原神角色伤害计算器数据配置辅助工具。从游戏解包数据预处理精简数据，提供数据导出和检查工具，支持AI分析和生成data.json配置。
npx skills add https://github.com/Kurarion/Genshin-Calc --skill genshin-data-generator复制此命令并粘贴到 Claude Code 中以安装该技能
| name | genshin-data-generator |
| description | 原神角色伤害计算器数据配置辅助工具。从游戏解包数据预处理精简数据，提供数据导出和检查工具，支持AI分析和生成data.json配置。 |
这个工具不会自动生成配置。配置生成需要 AI 根据预处理后的数据进行推理、分析和判断。
工作流程：
永远不要直接读取 src/assets/genshin 以下的内容！
这些解包数据文件（avatar_map.json 12MB, weapon_map.json 13MB等）体积巨大，直接读取会：
正确做法：使用版本系统读取预处理后的数据（见下方"数据读取流程"）。
fetch_version.py 是判断是否需要获取新数据的最权威工具。
推荐工作流程：始终优先使用 fetch_version.py，它会自动处理以下所有判断：
# 步骤1：进入脚本目录
cd .claude/skills/genshin-data-generator/scripts
# 步骤2：运行 fetch_version.py（它将自动判断并执行）
# Windows 系统（使用 UTF-8 编码）
$env:PYTHONIOENCODING="utf-8"; python3 fetch_version.py
# Linux/Mac 系统
PYTHONIOENCODING=utf-8 python3 fetch_version.py
# 步骤3：使用预处理数据进行配置生成
# 预处理数据已生成在 versions/[commit-id]/processed/ 目录中
# 直接读取对应的单独文件
# 获取最新版本的 commit ID
COMMIT_ID=$(cat ../versions/metadata.json | grep -o '"latest": "[^"]*"' | cut -d'"' -f4)
# 读取角色数据（预处理后的原始游戏数据）
cat ../versions/$COMMIT_ID/processed/characters/character_10000073.json
# 读取武器数据
cat ../versions/$COMMIT_ID/processed/weapons/weapon_11301.json
# 读取 name_id_map.json（用于查找 ID）
cat ../versions/$COMMIT_ID/processed/name_id_map.json
fetch_version.py 的自动判断逻辑：
versions/metadata.json 获取本地版本列表preprocess.py 预处理数据metadata.json如果需要手动检查版本状态（不推荐替代上述流程）：
# 检查 metadata.json 获取版本信息
cat .claude/skills/genshin-data-generator/versions/metadata.json
# 输出示例：
{
"versions": [
{
"commitId": "fe7c8592b2fd1cd3f285de5039285c99e641a5e1",
"shortId": "fe7c859",
"timestamp": "2026-02-19T17:59:23.975011Z",
"sourceUrl": "https://gitlab.com/Dimbreath/AnimeGameData",
"branch": "master",
"fetchSource": "gitlab",
"stats": {
"characters": 136,
"weapons": 227,
"artifacts": 42
}
}
],
"latest": "fe7c8592b2fd1cd3f285de5039285c99e641a5e1"
}
检查 stats 字段：
fetch_version.py# 检查最新版本的 processed 目录
COMMIT_ID=$(cat ../versions/metadata.json | grep -o '"latest": "[^"]*"' | cut -d'"' -f4)
ls ../versions/$COMMIT_ID/processed/
# 应该看到：
# - processed_data.json
# - name_id_map.json
# - characters/ (目录)
# - weapons/ (目录)
# - artifacts/ (目录)
⚠️ 重要提示：
fetch_version.py，它会自动处理所有判断和预处理latest 是 metadata.json 中的一个字段，指向最新版本的 commit ID，不是实际的文件夹versions/latest/ 路径，这个路径不存在--version latest 参数时，query_data_config.py 会自动解析 metadata.json 中的 latest 字段PYTHONIOENCODING=utf-8 环境变量，避免中文乱码在向 src/assets/init/data.json 添加新配置时，必须遵循以下规则：
正确的做法：通过 name_id_map.json 来确定新配置的插入位置。
重要：preprocess.py 现在会自动读取 data.json 来保持 name_id_map.json 与 data.json 的顺序一致。
# 方法1：使用 query_data_config.py（推荐）
cd .claude/skills/genshin-data-generator/scripts
# Windows 系统
$env:PYTHONIOENCODING="utf-8"; python3 query_data_config.py --type character --list
# 方法2：直接读取 name_id_map.json
# 首先获取最新版本的 commit ID
cd .claude/skills/genshin-data-generator
COMMIT_ID=$(cat versions/metadata.json | grep -o '"latest": "[^"]*"' | cut -d'"' -f4)
# Windows PowerShell 替代方案
$COMMIT_ID = (Get-Content versions/metadata.json | Select-String '"latest"' | ForEach-Object { $_ -replace '.*"latest": "(.*?)".*', '$1' })
# 然后读取对应版本的 name_id_map.json
cat versions/$COMMIT_ID/processed/name_id_map.json | python -c "
import json, sys
data = json.load(sys.stdin)
char_ids = list(data['characters'].keys())
print('最后10个角色ID:')
for cid in char_ids[-10:]:
print(f' {cid}: {data[\"characters\"][cid][\"en\"]}')
"
# Windows PowerShell 替代方案（使用 UTF-8）
$env:PYTHONIOENCODING="utf-8"; Get-Content versions/$COMMIT_ID/processed/name_id_map.json | python -c "import json, sys; data = json.load(sys.stdin); char_ids = list(data['characters'].keys())[-10:]; [print(f' {cid}: {data[\"characters\"][cid][\"en\"]}') for cid in char_ids]"
特殊 ID 通常有以下特征：
10000005502 (火), 10000005503 (水), 10000005504 (风), 10000005506 (岩), 10000005507 (雷), 10000005508 (草)10000007702 (火), 10000007703 (水), 10000007704 (风), 10000007706 (岩), 10000007707 (雷), 10000007708 (草)1000011711702, 1000011811802 等// 假设要添加 10000126 和 10000127
// 在 name_id_map.json 中看到：
{
"characters": {
...
"10000125": "Columbina", ← 最后一个普通 ID
"1000011711702": "Manekin (Pyro)", ← 第一个特殊 ID
...
}
}
// 正确做法：在 10000125 之后插入 10000126 和 10000127
// 错误做法：插入到文件最后或特殊 ID 之后
此规则适用于：
characters)weapons)artifact)所有脚本的输出文件必须保存在项目内部！
query_data_config.py: 默认输出到 exports/ 目录export_data.py: 默认输出到 exports/ 目录diff_analyzer.py: 默认输出到 diffs/ 目录如果用户指定了项目外路径，脚本会自动重定向到项目内部对应目录。
.claude/skills/genshin-data-generator/
├── versions/ # 版本化数据存储（Git忽略所有内容）
│ ├── metadata.json # 版本索引（本地生成，不追踪）
│ └── [commit-id]/ # 按 commit ID 命名的版本目录
│ ├── source/ # 原始游戏数据
│ ├── processed/ # 预处理数据
│ │ ├── processed_data.json
│ │ ├── name_id_map.json
│ │ ├── characters/
│ │ ├── weapons/
│ │ └── artifacts/
│ └── meta.json # 版本元数据
├── diffs/ # 差分报告目录（Git管理）
│ └── version_diff_*.md # 版本对比报告
├── scripts/ # 脚本文件（Git管理）
│ ├── version_manager.py # 版本管理工具
│ ├── fetch_version.py # 版本获取脚本
│ ├── diff_analyzer.py # 差分分析脚本
│ ├── preprocess.py # 数据预处理脚本
│ ├── query_data_config.py # 数据查询脚本
│ └── ... # 其他辅助脚本
├── references/ # 参考文档（Git管理）
└── SKILL.md # 主文档（Git管理）
版本系统使用 Git commit ID 作为唯一标识符，支持：
fetch_version.py 获取指定仓库/分支的最新 N 个 commit--repo 参数指定不同的 Git 仓库（GitLab/GitHub）--branch 参数指定不同的分支（master/main）--count 参数指定获取的版本数量（默认3个）diff_analyzer.py 对比任意两个版本的差异latest、短 ID、完整 commit ID 引用版本支持的 Git 平台：
https://gitlab.com/Dimbreath/AnimeGameDatahttps://github.com/Dimbreath/GenshinData数据获取策略：
-/raw/{commit}）使用此 Skill 进行角色/武器/圣遗物配置时，核心流程如下：
cd .claude/skills/genshin-data-generator/scripts
# 获取最新3个版本（默认仓库）
python3 fetch_version.py
# 指定仓库和分支
python3 fetch_version.py --repo https://gitlab.com/Dimbreath/AnimeGameData --branch master
# 指定获取的版本数量
python3 fetch_version.py --repo https://gitlab.com/Dimbreath/AnimeGameData --branch master --count 5
支持的仓库：
https://gitlab.com/Dimbreath/AnimeGameData (默认)https://github.com/Dimbreath/GenshinData注意事项：
这将自动完成：
如果需要直接运行 Go 工具获取数据：
# 在项目根目录运行
go run main.go --repo https://gitlab.com/Dimbreath/AnimeGameData --branch master
# 指定输出目录
go run main.go --repo https://gitlab.com/Dimbreath/AnimeGameData --branch master --targetDir ./src/assets/genshin
# 使用特定 commit ID 获取数据（推荐用于版本管理）
go run main.go --repo https://gitlab.com/Dimbreath/AnimeGameData --commit a7624301c8b009c54bdf7bf8d4cfb817aad6accf
# 直接指定完整的资源 URL
go run main.go --resUrl https://gitlab.com/Dimbreath/AnimeGameData/-/raw/master
# 使用本地数据源
go run main.go --localResPath /path/to/local/data
参数说明：
--repo: Git 仓库 URL（支持 GitHub 和 GitLab）--branch: 分支名称（默认：master）--commit: Commit ID（优先级高于 branch，用于获取特定版本的数据）--targetDir: 输出目录（默认：./src/assets/genshin）--resUrl: 完整的资源 URL（与 --repo/--branch/--commit 互斥）--localResPath: 本地数据源路径参数优先级：
--commit + --repo：获取特定 commit 的数据（推荐用于版本管理）--branch + --repo：获取指定分支的最新数据--resUrl：直接使用提供的完整 URL网络连接注意事项：
GODEBUG=netdns=go go run main.go ...版本管理说明：
--count 参数调整）cd .claude/skills/genshin-data-generator/scripts
# 比较两个版本（报告输出到 diffs/ 目录）
python3 diff_analyzer.py --from abc1234 --to def5678 --output ../diffs/version_diff_abc1234_def5678.md
# 比较最新版本与前一版本
python3 diff_analyzer.py --from HEAD~1 --to latest --output ../diffs/version_diff_latest.md
# 检查未实现的项目
python3 diff_analyzer.py --from latest --check-unimplemented --output ../diffs/unimplemented.md
# 只关注特定类型
python3 diff_analyzer.py --from abc1234 --to def5678 --focus characters weapons
差分报告：
diffs/ 目录（专用文件夹，不污染其他目录）version_diff_{from}_{to}.md重要说明：
重要：预处理后的游戏数据已经自动生成单独文件，这是生成新配置时的标准数据来源。
⚠️ 重要：
- 永远不要直接读取
src/assets/genshin以下的原始解包数据- 始终使用预处理后的数据（文件体积小、结构清晰）
- 预处理数据已自动生成单独文件，按 ID 直接读取即可
对比示例：查询叶洛亚 (10000127) 的游戏数据
| 错误做法 ❌ | 正确做法 ✅ |
|---|---|
bash<br># 直接读取原始解包数据（12MB+）<br>cat src/assets/genshin/avatar_map.json | grep 10000127<br> | bash<br># 读取预处理后的单独文件（~50KB）<br>cd .claude/skills/genshin-data-generator<br>COMMIT_ID=$(cat versions/metadata.json | grep -o '"latest": "[^"]*"' | cut -d'"' -f4)<br>cat versions/$COMMIT_ID/processed/characters/character_10000127.json<br> |
| 问题： - 文件巨大（12MB+） - 输出混乱，包含无关数据 - 占用大量上下文 | 优势： - 文件小巧（~50KB） - 结构清晰，只包含目标角色数据 - 节省上下文 |
标准流程：
# 获取最新版本的 commit ID
cd .claude/skills/genshin-data-generator
COMMIT_ID=$(cat versions/metadata.json | grep -o '"latest": "[^"]*"' | cut -d'"' -f4)
# 读取角色数据（预处理后的原始游戏数据）
cat versions/$COMMIT_ID/processed/characters/character_10000073.json
# 读取武器数据
cat versions/$COMMIT_ID/processed/weapons/weapon_11301.json
# 读取圣遗物数据
cat versions/$COMMIT_ID/processed/artifacts/artifact_301.json
# 读取 name_id_map.json（用于查找 ID）
cat versions/$COMMIT_ID/processed/name_id_map.json
query_data_config.py 用于查询 src/assets/init/data.json 中已配置的数据，这是检查和参考已有配置的标准方法。
⚠️ 重要：
- 检查已配置数据时，必须优先使用
query_data_config.py- 不要使用 grep 搜索 data.json（效率低且输出不友好）
- 不要直接读取 data.json（文件巨大，占用大量上下文）
对比示例：查询叶洛亚 (10000127) 的已配置数据
| 错误做法 ❌ | 正确做法 ✅ |
|---|---|
bash<br># 使用 grep 搜索 data.json<br>grep -A 100 '"10000127":' src/assets/init/data.json<br> | bash<br># 使用专用脚本查询<br>cd .claude/skills/genshin-data-generator/scripts<br>PYTHONIOENCODING=utf-8 python query_data_config.py --type character --id 10000127<br> |
| 问题： - 输出格式混乱 - 可能截断或不完整 - 难以阅读 | 优势： - 输出格式化，易读 - 完整显示配置 - 高效精准 |
标准流程：
cd .claude/skills/genshin-data-generator/scripts
# 根据ID查询已配置的角色数据（推荐）
python3 query_data_config.py --type character --id 10000073
# 根据名称搜索（需要在 output/ 目录有 name_id_map.json）
python3 query_data_config.py --type character --name 纳西妲
# 模糊搜索
python3 query_data_config.py --type character --fuzzy 纳
# 列出所有已配置的ID
python3 query_data_config.py --type character --list
# 导出到文件
python3 query_data_config.py --type character --id 10000073 --output config_export.json
输出示例：
开始预处理数据...
输入目录: ./src/assets/genshin
输出文件: ./.claude/skills/genshin-data-generator/output/processed_data.json
角色单独导出目录: ./output/characters
武器单独导出目录: ./output/weapons
圣遗物单独导出目录: ./output/artifacts
处理角色数据...
已导出 133 个角色单独文件
处理武器数据...
处理圣遗物数据...
已导出 40 个圣遗物套装单独文件
已生成名称-ID映射文件: ./output/name_id_map.json
- 角色: 133 个
- 武器: 227 个
- 圣遗物: 40 个
- 总计: 400 个
预处理完成！
原始avatar_map.json: 12.25 MB
原始weapon_map.json: 13.00 MB
输出processed_data.json: 4.62 MB
压缩率: 81.68%
name_id_map.json 提供了名称与ID的双向映射，是AI查找ID的首选方式。
文件位置：
versions/[commit-id]/processed/name_id_map.json
文件结构：
{
"characters": {
"10000002": {
"cn_sim": "神里绫华",
"cn_tra": "神里綾華",
"jp": "神里綾華",
"en": "Kamisato Ayaka"
},
"10000073": {
"cn_sim": "纳西妲",
"cn_tra": "納西妲",
"jp": "ナヒーダ",
"en": "Nahida"
}
},
"weapons": {
"11301": {
"cn_sim": "天目影打刀",
"cn_tra": "天目影打刀",
"jp": "天目影打刀",
"en": "Amenoma Kageuchi"
}
},
"artifacts": {
"15001": {
"cn_sim": "炽烈的炎之魔女",
"cn_tra": "熾烈的炎之魔女",
"jp": "炎の魔女",
"en": "Crimson Witch of Flames"
}
}
}
使用方法：
方法1：通过名称搜索ID
# 使用 query_data_config.py 通过名称查找ID
cd .claude/skills/genshin-data-generator/scripts
python3 query_data_config.py --type character --name 纳西妲
python3 query_data_config.py --type weapon --name 天目影打刀
python3 query_data_config.py --type artifact --name 炽烈的炎之魔女
方法2：直接读取映射文件
# 直接读取映射文件
cat versions/[commit-id]/processed/name_id_map.json | grep "纳西妲"
AI使用场景：
重要提示：
cn_sim - 简体中文cn_tra - 繁体中文jp - 日文en - 英文预处理脚本已自动为所有角色、武器、圣遗物生成单独JSON文件：
output/characters/
├── character_10000002.json # 神里绫华
├── character_10000003.json # 琴
├── character_10000073.json # 纳西妲
└── ... (共133个)
output/weapons/
├── weapon_11301.json # 单手剑·天目影
├── weapon_11302.json # 单手剑·笛剑
├── weapon_11401.json # 弓
└── ... (共227个)
output/artifacts/
├── artifact_301.json # 渲染之火
├── artifact_302.json # 渲染之水
├── artifact_303.json # 渲染之风
└── ... (共40个)
推荐做法: 配置时直接读取对应的单独文件：
# 角色配置
cat output/characters/character_10000073.json
# 武器配置
cat output/weapons/weapon_11301.json
# 圣遗物配置
cat output/artifacts/artifact_301.json
方式2：使用 export_data.py 导出（临时分析用）
export_data.py 可用于将特定数据导出到 exports/ 目录：
# 导出特定角色/武器/圣遗物到 exports/ 目录
cd .claude/skills/genshin-data-generator/scripts
python3 export_data.py --type character --id 10000073
python3 export_data.py --type weapon --id 11301
python3 export_data.py --type artifact --id 301
注意: 预处理已自动生成所有单独文件，推荐直接使用方式1。exports/ 目录仅用于临时导出或特殊分析需求。
query_data_config.py 可用于查询和导出已配置的角色/武器/圣遗物数据：
# 根据ID查询并输出（美化格式）
cd .claude/skills/genshin-data-generator/scripts
python3 query_data_config.py --type character --id 10000073
# 根据名称搜索（需要先运行 preprocess.py 生成映射文件）
python3 query_data_config.py --type character --name 纳西妲
# 模糊搜索
python3 query_data_config.py --type character --fuzzy 纳
# 列出所有ID
python3 query_data_config.py --type character --list
# 导出到文件
python3 query_data_config.py --type character --id 10000073 --output config_export.json
# 以纯JSON格式输出（不美化）
python3 query_data_config.py --type character --id 10000073 --json
用途：
AI 需要结合以下信息进行推理和配置生成：
output/characters/character_{id}.json（推荐）或 processed_data.jsonAI 分析步骤：
paramDescList 判断 indexes 映射desc 判断特殊机制（buff、治疗、护盾等）elementBonusType 和 attackBonusType了解哪些数据尚未实现：
python3 check_unimplemented.py --type all
输出示例：
============================================================
角色实现情况
============================================================
解包数据中的角色总数: 95
data.json中已实现的角色数: 85
未实现的角色数: 10
未实现的角色 (10):
------------------------------------------------------------
[10000080] 赛诺 (武器: WEAPON_POLE, 品质: QUALITY_ORANGE)
[10000081] 坎蒂丝 (武器: WEAPON_POLE, 品质: QUALITY_PURPLE)
...
未实现角色列表已导出到: output/unimplemented_characters.txt
avatar_map.json (12MB): 角色数据
name: 角色名称（多语言）desc: 角色描述（多语言）skills.normal: 普通攻击配置skills.skill: 元素技能skills.elementalBurst: 元素爆发skills.proudSkills: 天赋/突破skills.constellation: 命座name, desc, paramList, paramDescListweapon_map.json (13MB): 武器数据
name: 武器名称（多语言）desc: 武器描述（多语言）skillAffixMap: 武器精炼效果name, desc, paramList, paramValidIndexes, addPropsreliquary_set_map.json (92KB): 圣遗物套装数据
setName: 套装名称（多语言）setAffixs: 套装效果（2件套、4件套）setName, name, desc, paramList, paramValidIndexes, addProps重要：各个技能/天赋/命座/武器特效/圣遗物套装的desc字段(多语言)包含完整的技能描述，也可能包括其它技能之间的联动信息。例如，某些命座效果会基于其他技能的参数，需要仔细阅读desc理解联动关系。
重要: 各个paramList中包含了各自技能等的param参数list，paramDescList中包含的的paramX即对应着paramlist中X-1的Index，paramValidIndexes只是单纯用于判断paramList中对应Index的有效与无效（非0即有效），实际分析时用处不是很大
重要: 各个addProps中包含了各自技能等的增益Key-Value，有一部分的相关BUFF是通过addProps而非paramList来定义的，这种情况下也需要通过desc来分析这个数值是加成什么的，即使propType有定义类似的东西，但目前没有将propType中Key与计算使用的Key进行映射。因此推理过程是类似的，但实际写data.json时是有区别的。
重要: levelmap字段在每个角色与武器中有各个等级的数据，这些数据在配置生成时完全无用，预处理时会移除以节省上下文。
版本更新时需要修改的主要文件：
src/app/shared/interface/interface.ts)作用：定义配置文件的数据结构和类型接口
主要内容：
ExtraData: 顶层配置接口（characters, weapons, artifact）ExtraSkillInfo: 技能信息接口（damage, buffs, healing, shield, product）ExtraSkillDamage: 伤害配置接口（indexes, base, elementBonusType, attackBonusType...） data.json配置的核心接口ExtraSkillBuff: Buff配置接口（index, base, target, customValue, settingType...） data.json配置的核心接口ExtraSkillHealing: 治疗配置接口（index, base, constIndex, healingBonusType...） data.json配置的核心接口ExtraSkillShield: 盾量配置接口（index, constIndex, base, shieldBonusType, shieldElementType...） data.json配置的核心接口ExtraSkillProduct: 生成物配置接口（index, base...） data.json配置的核心接口版本更新场景：
src/app/shared/const/const.ts)作用：定义所有常量和枚举，是伤害计算的核心配置文件
重要：PROP_DMG_开头的常量是伤害计算的核心，涉及新反应、新伤害乘区、所有伤害、盾、治疗、生成物HP计算！
伤害计算分为6个区域（乘区），按顺序相乘：
最终伤害 = 基础伤害 × 倍率区 × 元素加成区 × 反应倍率 × 抗性区 × 防御区 × 会心区
各乘区说明：
ELEMENT_PYRO: 火元素ELEMENT_HYDRO: 水元素ELEMENT_ANEMO: 风元素ELEMENT_ELECTRO: 雷元素ELEMENT_CRYO: 冰元素ELEMENT_GEO: 岩元素ELEMENT_DENDRO: 草元素ELEMENT_PHYSICAL: 物理元素以上常量不用于对伤害进行定义元素类型
元素伤害加成：
PROP_DMG_BONUS_CRYO: 冰元素伤害加成PROP_DMG_BONUS_PYRO: 火元素伤害加成PROP_DMG_BONUS_HYDRO: 水元素伤害加成PROP_DMG_BONUS_ELECTRO: 雷元素伤害加成PROP_DMG_BONUS_ANEMO: 风元素伤害加成PROP_DMG_BONUS_GEO: 岩元素伤害加成PROP_DMG_BONUS_DENDRO: 草元素伤害加成PROP_DMG_BONUS_PHYSICAL: 物理伤害加成以上也用于对伤害进行定义元素类型
技能类型伤害加成：
PROP_DMG_BONUS_NORMAL: 普通攻击伤害加成PROP_DMG_BONUS_CHARGED: 重击伤害加成PROP_DMG_BONUS_PLUNGING: 下落攻击伤害加成PROP_DMG_BONUS_SKILL: 元素技能伤害加成PROP_DMG_BONUS_ELEMENTAL_BURST: 元素爆发伤害加成其他类型：
PROP_DMG_BONUS_ALL: 全伤害加成PROP_DMG_BONUS_WEAPON: 武器伤害加成PROP_DMG_BONUS_OTHER: 其他伤害加成（天赋效果等）PROP_DMG_BONUS_SET: 圣遗物套装伤害加成倍率提升（加法）：
PROP_DMG_RATE_UP_*: 某类技能伤害倍率提升X%倍率倍乘（乘法）：
PROP_DMG_RATE_MULTI_*: 某类技能伤害倍率×X元素类型：CRYO, PYRO, HYDRO, ELECTRO, ANEMO, GEO, DENDRO, PHYSICAL, ALL 技能类型：NORMAL, CHARGED, PLUNGING, SKILL, ELEMENTAL_BURST, WEAPON, OTHER, SET
特殊倍率：
PROP_DMG_RATE_MULTI_MOON_ELECTROCHARGED: 月感电倍率PROP_DMG_RATE_MULTI_MOON_RUPTURE: 月绽放倍率PROP_DMG_BASICS_MULTI_MOON_RUPTURE: 月绽放基础倍率抗性提升：
PROP_DMG_ANTI_CRYO: 冰元素抗性提升PROP_DMG_ANTI_*: 各元素抗性提升抗性降低（针对怪物）：
PROP_DMG_ANTI_CRYO_MINUS: 冰元素抗性降低PROP_DMG_ANTI_*_MINUS: 各元素抗性降低PROP_DMG_ANTI_ALL_MINUS: 全元素抗性降低用途：用于超导反应（减物理抗性）或者各种角色技能，天赋，命座中的效果来降低敌人抗性
直接提升伤害计算中的基础区数值（不是百分比）：
PROP_DMG_VAL_UP_*: 某类技能伤害数值提升会心伤害提升：
PROP_DMG_CRIT_DMG_UP_*: 某类技能会心伤害提升会心独立区：
PROP_DMG_CRIT_RATE_UP_*: 某类技能会心率提升治疗加成类型：
PROP_HEALING_BONUS: 基础治疗加成（针对所有类型治疗）PROP_HEALING_BONUS_NORMAL: 普通攻击治疗加成PROP_HEALING_BONUS_SKILL: 元素技能治疗加成PROP_HEALING_BONUS_ELEMENTAL_BURST: 元素爆发治疗加成PROP_HEALING_BONUS_WEAPON: 武器治疗加成PROP_HEALING_BONUS_OTHER: 其他治疗加成PROP_HEALING_BONUS_SET: 圣遗物套装治疗加成治疗倍率：
PROP_HEALING_RATE_UP_*: 某类技能治疗倍率提升X%PROP_HEALING_RATE_MULTI_*: 某类技能治疗倍率×X治疗数值：
PROP_HEALING_VAL_UP_*: 某类技能治疗基础区数值直接提升护盾加成类型：
PROP_DMG_ELEMENT_SHIELD_UP: 护盾强效加成（针对所有类型护盾）PROP_SHIELD_BONUS_NORMAL: 普通攻击创造的护盾强效加成PROP_SHIELD_BONUS_SKILL: 元素技能创造的护盾强效加成PROP_SHIELD_BONUS_ELEMENTAL_BURST: 元素爆发创造的护盾强效加成PROP_SHIELD_BONUS_WEAPON: 武器创造的护盾强效加成PROP_SHIELD_BONUS_OTHER: 其他护盾强效加成PROP_SHIELD_BONUS_SET: 圣遗物套装创造的护盾强效加成用于区分技能内部不同类型的伤害：
PROP_TAG_RAZOR_SOUL_COMPANION: 雷泽的狼魂伤害PROP_TAG_VENTI_SKILL_PRESS: 温迪的蓄力长按伤害PROP_TAG_FURINA_SALON_SOLITAIRE: 芙宁娜的沙龙独舞伤害重要：特殊标签系统用于区分技能内部多种不同类型的伤害，不是特殊机制！，主要用于实现对同技能内不同伤害进行追加该伤害专用的BUFF使用
当需要添加新的特殊标签（tag）时，必须完成以下步骤：
步骤1: 在 data.json 中使用 tag
在技能配置中添加 tag 字段，用于区分技能内部不同类型的伤害或增益。
示例：兹白(10000126)的配置
"skill": [
{
"damage": {
"indexes": [0],
"base": "DEFENSE",
"elementBonusType": "DMG_BONUS_GEO",
"attackBonusType": "DMG_BONUS_SKILL",
"specialDamageType": "moon-hydro-crystallize-direction"
}
},
{
"damage": {
"indexes": [1],
"base": "DEFENSE",
"elementBonusType": "DMG_BONUS_GEO",
"attackBonusType": "DMG_BONUS_SKILL",
"specialDamageType": "moon-hydro-crystallize-direction",
"tag": "ZIBAI_SPIRIT_STEED_SECOND_HIT" // 灵驹飞踏第二段伤害
}
},
{
"damage": {
"indexes": [2],
"base": "DEFENSE",
"elementBonusType": "DMG_BONUS_GEO",
"attackBonusType": "DMG_BONUS_NORMAL",
"specialDamageType": "moon-hydro-crystallize-direction",
"tag": "ZIBAI_LUNAR_PHASE_SHIFT_4TH_EXTRA" // 月转时隙第四段额外伤害
}
}
]
"proudSkills": [
[
{
"buffs": [
{
"index": 0,
"base": "DEFENSE",
"target": ["DMG_VAL_UP_SKILL"],
"settingType": "switch",
"defaultEnable": false,
"tag": "ZIBAI_SPIRIT_STEED_SECOND_HIT" // 只对灵驹飞踏第二段生效
}
]
}
]
]
"constellation": {
"1": [
{
"buffs": [
{
"index": 1,
"base": "DEFENSE",
"target": ["DMG_VAL_UP_SKILL"],
"settingType": "switch",
"defaultEnable": false,
"tag": "ZIBAI_SPIRIT_STEED_SECOND_HIT"
}
]
}
],
"3": [
{
"buffs": [
{
"index": 0,
"base": "DEFENSE",
"target": ["DMG_VAL_UP_NORMAL"],
"settingType": "switch",
"defaultEnable": false,
"tag": "ZIBAI_LUNAR_PHASE_SHIFT_4TH_EXTRA"
}
]
}
]
}
说明：
步骤2: 在 const.ts 中添加 tag 常量
在 src/app/shared/const/const.ts 中：
static readonly PROP_TAG_ZIBAI_SPIRIT_STEED_SECOND_HIT = 'ZIBAI_SPIRIT_STEED_SECOND_HIT';
static readonly PROP_TAG_ZIBAI_LUNAR_PHASE_SHIFT_4TH_EXTRA = 'ZIBAI_LUNAR_PHASE_SHIFT_4TH_EXTRA';
PROPS_TAG_LIST 数组：static readonly PROPS_TAG_LIST = [
// ... 其他tag
Const.PROP_TAG_ZIBAI_SPIRIT_STEED_SECOND_HIT,
Const.PROP_TAG_ZIBAI_LUNAR_PHASE_SHIFT_4TH_EXTRA,
];
PROPS_TAG_MAP 映射（关联角色ID）：static readonly PROPS_TAG_MAP: Map<string, string[]> = new Map([
// ... 其他角色
['10000126', [Const.PROP_TAG_ZIBAI_SPIRIT_STEED_SECOND_HIT, Const.PROP_TAG_ZIBAI_LUNAR_PHASE_SHIFT_4TH_EXTRA]],
]);
PROPS_ALL_BASE_SPACIAL 或 PROPS_ALL_BASE_SPACIAL_PERCENT：根据 tag 对应的 buff 加成类型，将 [属性常量, Tag常量] 添加到对应的集合：
PROPS_ALL_BASE_SPACIAL: 用于非百分比的数值加成（如 DMG_VAL_UP_*）PROPS_ALL_BASE_SPACIAL_PERCENT: 用于百分比加成（如 DMG_BONUS_*）判断规则：
target 类型DMG_VAL_UP_* 系列 → 添加到 PROPS_ALL_BASE_SPACIALDMG_BONUS_* 系列 → 添加到 PROPS_ALL_BASE_SPACIAL_PERCENT示例：
// 兹白的两个tag都使用 DMG_VAL_UP_* 类型，添加到 PROPS_ALL_BASE_SPACIAL
static readonly PROPS_ALL_BASE_SPACIAL = [
// ... 其他配置
[Const.PROP_DMG_VAL_UP_NORMAL, Const.PROP_TAG_ZIBAI_LUNAR_PHASE_SHIFT_4TH_EXTRA],
// ... 其他配置
[Const.PROP_DMG_VAL_UP_SKILL, Const.PROP_TAG_ZIBAI_SPIRIT_STEED_SECOND_HIT],
// ... 其他配置
];
重要：这两个集合用于将 tag 与其对应的伤害属性关联起来，是伤害计算系统正确识别和应用 tag 加成的关键。
步骤3: 在 i18n 文件中添加翻译
⚠️ 重要：翻译必须从预处理数据中提取，不要自己翻译！
# 获取最新版本的commit ID
cd .claude/skills/genshin-data-generator
COMMIT_ID=$(cat versions/metadata.json | grep -o '"latest": "[^"]*"' | cut -d'"' -f4)
# 读取角色数据
cat versions/$COMMIT_ID/processed/characters/character_10000126.json
从 desc 字段中提取各语言的官方翻译
在所有 i18n 文件中添加翻译：
en.json:
"TAG": {
// ...
"ZIBAI_SPIRIT_STEED_SECOND_HIT": "Spirit Steed's Stride 2nd Hit",
"ZIBAI_LUNAR_PHASE_SHIFT_4TH_EXTRA": "Lunar Phase Shift 4th Additional Attack"
}
cn_sim.json:
"TAG": {
// ...
"ZIBAI_SPIRIT_STEED_SECOND_HIT": "灵驹飞踏第二段",
"ZIBAI_LUNAR_PHASE_SHIFT_4TH_EXTRA": "月转时隙第四段额外攻击"
}
jp.json:
"TAG": {
// ...
"ZIBAI_SPIRIT_STEED_SECOND_HIT": "翔ける霊駒2段目",
"ZIBAI_LUNAR_PHASE_SHIFT_4TH_EXTRA": "隙を過ぐる月・四段目の追加攻撃"
}
命名规范：
ROLE_SKILL_NAME_DETAIL基础属性：
PROP_HP_BASE: 生命值基础（被生命加成百分比增益）PROP_HP_BASE_EXTRA: 生命值基础（基础额外加成，被生命加成百分比增益）PROP_ATTACK_BASE: 攻击力基础（被攻击力加成百分比增益）（部分buff计算使用）ATTACK_BASE_EXTRA: 攻击力基础（基础额外加成，被攻击力加成百分比增益）（部分buff计算使用）PROP_DEFENSE_BASE: 防御力基础（被防御力加成百分比增益）DEFENSE_BASE_EXTRA: 防御力基础（基础额外加成，被防御力加成百分比增益）属性提升：
PROP_HP_UP: 生命值提升（不被生命加成百分比增益，直接加算）PROP_ATTACK_UP: 攻击力提升（不被攻击力加成百分比增益，直接加算）PROP_DEFENSE_UP: 防御力提升（不被防御力加成百分比增益，直接加算）PROP_ELEMENT_MASTERY_UP: 元素精通提升PROP_CRIT_RATE: 会心率PROP_CRIT_DMG: 会心伤害PROP_ENERGY_RECHARGE: 元素充能效率合计用属性：
PROP_HP: 最终面板生命值（一般用于最终伤害、buff等计算）PROP_ATTACK: 最终面板攻击力（一般用于最终伤害、buff等计算）PROP_DEFENSE: 最终面板防御力（一般用于最终伤害、buff等计算）PROP_LEVEL: 等级PROP_ELEMENTAL_MASTERY: 元素精通重要：生成物计算只计算HP，不涉及任何伤害计算！
生成物HP计算公式：
product = base * rate + Σ(rateAttach[i] * data[baseAttach[i]]) + extra
base参数：
HP: 生命值基础ATTACK: 攻击力基础DEFENSE: 防御力基础配置示例：
{
"product": {
"index": 0,
"base": "HP"
}
}
用于计算队列中的变量：
PROP_VAR_CHARA_1 ~ PROP_VAR_CHARA_8: 角色变量1-8PROP_VAR_SET_1, PROP_VAR_SET_2: 套装变量1-2PROP_VAR_WEAPON_1, PROP_VAR_WEAPON_2: 武器变量1-2用途：用于复杂的计算队列（finalResCalQueue），例如：
触发条件：当技能/天赋描述中出现类似"此外，兹白在队伍中时，队伍的月兆将会上升一级"的效果时，需要添加月兆buff配置。
月兆buff包含两部分：
月兆等级变量设置（VAR_CHARA_1）
月元素伤害加成（DMG_ELEMENT_MOON_ALL_UP）
isAllTeam: true）配置示例（兹白"月兆祝赐·浮明若流"天赋）：
// proudSkills 数组中添加两个新的buff对象
[
{
"buffs": [
{
"showIndex": 0,
"setTos": ["VAR_CHARA_1"], // 设置月兆等级变量
"settingType": "slider",
"sliderInitialValue": 0, // 初始值：0级
"sliderMin": 0, // 最小值：0级
"sliderMax": 2, // 最大值：2级
"sliderStep": 1, // 步长：1级
"title": "BUFF.MOON_LEVEL.TITLE" // i18n显示标题
}
]
},
{
"buffs": [
{
"customValue": 0.01, // 单位转换（整数转百分比）
"target": ["DMG_ELEMENT_MOON_ALL_UP"], // 月元素伤害加成
"settingType": "slider",
"sliderInitialValue": 0, // 初始值：0%
"sliderMin": 0, // 最小值：0%
"sliderMax": 36, // 最大值：36%（3级×12%）
"sliderStep": 1, // 步长：1%
"isAllTeam": true // 影响全队
}
]
}
]
说明：
VAR_CHARA_1变量，用于记录月兆等级（0-2）customValue: 0.01将slider值转换为百分比（如slider值12 → 12%伤害加成）背景：月结晶直接伤害（specialDamageType: "moon-hydro-crystallize-direction"）有两类buff需要特殊处理：
DMG_ELEMENT_MOON_HYDROCRYSTALLIZE_EXTRA_VAL_UPDMG_ELEMENT_MOON_HYDROCRYSTALLIZE_UP问题：当这些buff使用tag时（如ZIBAI_SPIRIT_STEED_SECOND_HIT），buff的值存储在target + "__" + tag属性中，需要额外读取。
解决：在calculator.service.ts的月结晶直接伤害计算中添加hasTag处理：
// 数值区处理（extraVal）
let extraVal = data[Const.PROP_DMG_ELEMENT_MOON_HYDROCRYSTALLIZE_EXTRA_VAL_UP] ?? 0;
if (hasTag) {
extraVal += data[Const.PROP_DMG_ELEMENT_MOON_HYDROCRYSTALLIZE_EXTRA_VAL_UP + tag] ?? 0;
}
damgeValue += extraVal;
// 增伤区处理（damgeUp）
let moonHydroCrystallizeUp = data[Const.PROP_DMG_ELEMENT_MOON_HYDROCRYSTALLIZE_UP] ?? 0;
if (hasTag) {
moonHydroCrystallizeUp += data[Const.PROP_DMG_ELEMENT_MOON_HYDROCRYSTALLIZE_UP + tag] ?? 0;
}
damgeUp += moonHydroCrystallizeUp;
配置要求：
const.ts映射：
DMG_ELEMENT_MOON_HYDROCRYSTALLIZE_EXTRA_VAL_UP → PROPS_ALL_BASE_SPACIALDMG_ELEMENT_MOON_HYDROCRYSTALLIZE_UP → PROPS_ALL_BASE_SPACIAL_PERCENT示例配置（兹白C0）：
{
"buffs": [
{
"index": 0,
"base": "DEFENSE",
"target": ["DMG_ELEMENT_MOON_HYDROCRYSTALLIZE_UP"], // 增伤区（百分比）
"settingType": "switch",
"defaultEnable": false,
"tag": "ZIBAI_SPIRIT_STEED_SECOND_HIT"
}
]
}
判断规则：
DMG_ELEMENT_MOON_HYDROCRYSTALLIZE_UP（增伤区）DMG_ELEMENT_MOON_HYDROCRYSTALLIZE_EXTRA_VAL_UP（数值区）第一组：根据elementBonusType选择（元素类型）
PROP_DMG_RATE_UP_CRYO/...: 元素倍率提升PROP_DMG_RATE_MULTI_CRYO/...: 元素倍率倍乘PROP_DMG_BONUS_PYRO/...: 火元素伤害加成PROP_DMG_VAL_UP_CRYO/...: 火元素伤害数值提升PROP_DMG_ANTI_CRYO/...: 火元素抗性(敌人用)PROP_DMG_ANTI_CRYO_MINUS/...: 火元素抗性降低(针对敌人)PROP_DMG_CRIT_RATE_UP_CRYO/...: 火元素会心率提升PROP_DMG_CRIT_DMG_UP_CRYO/...: 火元素会心伤害提升第二组：根据attackBonusType选择（攻击类型）
PROP_DMG_RATE_UP_NORMAL/...: 普通攻击倍率提升PROP_DMG_RATE_MULTI_NORMAL/...: 普通攻击倍率倍乘PROP_DMG_BONUS_NORMAL/...: 普通攻击伤害加成PROP_DMG_VAL_UP_NORMAL/...: 普通攻击伤害数值提升PROP_DMG_CRIT_RATE_UP_NORMAL/...: 普通攻击会心率提升PROP_DMG_CRIT_DMG_UP_NORMAL/...: 普通攻击会心伤害提升重要：一个伤害总是同时具备两个分类（元素类型和攻击类型（又包含了TAG）），两组常量互不冲突！
全局常量（除了特殊反应伤害之外，对象为任意伤害）：
PROP_DMG_RATE_UP_ALL: 全局倍率提升PROP_DMG_RATE_MULTI_ALL: 全局倍率倍乘PROP_DMG_BONUS_ALL: 全伤害加成PROP_DMG_VAL_UP_ALL: 全局伤害数值提升PROP_DMG_CRIT_RATE_UP_ALL: 全局伤害会心率提升PROP_DMG_CRIT_DMG_UP_ALL: 全局伤害会心伤害提升新元素反应（基本不会追加，因此追加时需要慎重判断）：
新伤害乘区（基本不会追加，因此追加时需要慎重判断）：
PROP_DMG_RATE_UP_* / PROP_DMG_RATE_MULTI_*）新特殊标签（追加频率较高）：
PROP_TAG_*）新武器类型：
示例格式说明
- 源数据: 来自 processed_data.json 的原始游戏数据
- 推断过程: 从源数据分析并生成配置的步骤
- 最终配置: 生成的 data.json 配置
重要: paramDescList 中的每一行代表一个独立的效果，需要在 skills 数组中创建对应的配置对象。
每个技能的 skills 属性是一个数组，数组中的每个对象对应 paramDescList 中的一行（或多行相关的效果）：
// data.json 中的配置结构
{
"10000002": { // 角色ID
"skills": {
"normal": [ // ← 数组！每个对象是一个独立配置
{ "damage": { ... } }, // 第1个配置对象
{ "damage": { ... } }, // 第2个配置对象
{ "damage": { ... } } // 第3个配置对象
],
"skill": [ // ← 数组！
{ "damage": { ... } },
{ "shield": { ... } },
{ "healing": { ... } }
]
}
}
}
| paramDescList 中的行 | 需要创建的配置对象 | 配置类型 |
|---|---|---|
| 伤害相关描述 | { "damage": { ... } } | 伤害配置 |
| 治疗量描述 | { "healing": { ... } } | 治疗配置 |
| 护盾吸收量描述 | { "shield": { ... } } | 护盾配置 |
| 增益效果描述 | { "buffs": [ ... ] } | 增益配置 |
| 生成物生命值 | { "product": { ... } } | 生成物配置 |
关键原则:
重要区别：paramDescList中的 + 号可能表示两种不同的情况：
| 描述格式 | 含义 | 配置方式 | 示例 |
|---|---|---|---|
| `"灭净三业伤害 | {param3:F1P}攻击力+{param4:F1P}元素精通"` | 复合倍率：+前后有明确的base说明（攻击力 vs 元素精通） | 使用 indexesAttach 和 baseAttach |
| `"三段伤害 | {param3:F1P}+{param4:F1P}"` | 两个独立伤害：+前后都没有单位说明，都是纯数值倍率 | 创建两个独立的 damage 对象 |
判断规则：
+ 前后都有明确的base说明（如 攻击力 + 元素精通、防御力 + HP）+ 前后都没有单位说明，只是两个独立的攻击力倍率伤害判断方法：
+ 前后的单位说明：
+ 前有 攻击力/防御力/HP，+ 后也有 攻击力/防御力/HP/元素精通 等 → 复合倍率+ 前后都只是 {paramX:F1P} 格式，没有额外单位说明 → 两个独立伤害+ 在格式内部连接的是同一类型的多个伤害实例示例：兹白(10000126)普通攻击三段
// paramDescList (简体中文)
[
"三段伤害|{param3:F1P}+{param4:F1P}", // 两个独立伤害
...
]
// 正确配置：两个独立的damage对象
"normal": [
{
"damage": {
"indexes": [2], // 第一个伤害：param3 × 攻击力
"base": "ATTACK",
...
}
},
{
"damage": {
"indexes": [3], // 第二个伤害：param4 × 攻击力
"base": "ATTACK",
...
}
}
]
// 错误配置：使用indexesAttach（复合倍率）
"normal": [
{
"damage": {
"indexes": [2],
"indexesAttach": [[3]], // ❌ 错误！这不是复合倍率
"baseAttach": ["ATTACK"],
...
}
}
]
核心原则：只有当预处理数据中的值需要单位转换时，才使用 indexMultiValue。
判断规则：
| 预处理数据值 | 描述 | 是否需要 indexMultiValue | 示例 |
|---|---|---|---|
0.007（每100点防御力提升0.7%） | 需要按"每100点"计算 | 需要 0.01（转换为每1点） | 兹白天赋3：0.007 × 0.01 = 0.00007 |
5.5（550%防御力） | 直接的倍率值 | ❌ 不需要！直接使用index读取 | 兹白C2：5.5已在数据中 |
2.5（250%防御力） | 直接的倍率值 | ❌ 不需要！直接使用index读取 | 兹白C4：2.5已在数据中 |
错误示例（常见）：
// ❌ 错误：5.5已经在预处理数据中，不需要转换
{
"index": 1,
"base": "DEFENSE",
"indexMultiValue": 5.5, // 错误！
"target": ["DMG_VAL_UP_SKILL"]
}
// ✅ 正确：直接使用index读取
{
"index": 1,
"base": "DEFENSE",
"target": ["DMG_VAL_UP_SKILL"]
}
重要提示：
indexMultiValue 是一个乘数，用于将预处理数据中的值转换为实际计算所需的单位核心原则：customValue 和 index 永远不要同时使用！
判断规则：
| 场景 | 使用方式 | 实际例子 |
|---|---|---|
默认情况 → paramMap 中有需要的值 | 只使用 index | 叶洛亚天赋1：param[0]=0.05对应描述"暴击率5%" → 只写 "index": 0 |
paramMap 中找不到需要的值 | 只使用 customValue | 描述中有明确数值但paramMap中无此值 → 只写 "customValue" |
重要提示：
paramMap 中都包含需要的数值，应使用 indexcustomValue 仅用于 paramMap 中完全没有对应值的特殊情况判断流程：
paramMap 中是否有对应数值indexcustomValue重要提示：
index 用于从 paramMap 中读取数值customValue 用于手动指定固定值（仅当paramMap中完全找不到对应值时使用）index，customValue 仅用于特殊例外情况核心原则：当多个buff效果共享同一个触发条件（switch）时，应该放在同一个buffs数组中。
属性继承规则：
settingType 和 defaultEnable：只需在第一个buff object设置，后续buff继承isAllTeam：每个buff独立设置，必须保留（因为不同buff可能影响范围不同）使用场景：
暴击率和暴击伤害使用不同index但共享switch
// 游戏数据：paramMap[0]=0.05(暴击率5%), paramMap[1]=0.1(暴击伤害10%)
// 描述："施放元素战技后，暴击率提升5%，暴击伤害提升10%"
// 分析：两个效果同时触发，共享一个switch，但数值不同需用不同index
// ✅ 正确配置
"proudSkills": [
[
{
"buffs": [
{
"index": 0,
"target": ["CRIT_RATE"],
"settingType": "switch",
"defaultEnable": false,
"isAllTeam": true
},
{
"index": 1,
"target": ["CRIT_DMG"],
"isAllTeam": true
// 继承第一个buff的settingType和defaultEnable
}
]
}
]
]
错误配置：分成多个独立object
// ❌ 错误：三个独立的object = 三个独立的switch
[
{"buffs": [{"index": 0, "target": ["CRIT_RATE"], "settingType": "switch", ...}]},
{"buffs": [{"index": 1, "target": ["CRIT_DMG"], "settingType": "switch", ...}]},
{"buffs": [{"index": 4, "target": ["ELEMENTAL_MASTERY"], "settingType": "switch", ...}]}
]
判断是否合并到同一个buffs数组：
⚠️ target选择注意：
CRIT_RATE（全局暴击率），不是 CRIT_RATE_GEO（岩元素暴击率）核心原则：命座3和5通常只提升技能等级+3，不需要配置。
规则：
示例：
// ❌ 错误：仅为技能等级+3，不应该有配置
"4": [
{
"buffs": [
{
"index": 2,
"target": ["DMG_BONUS_SKILL"], // 技能等级+3不需要配置！
"settingType": "switch",
"defaultEnable": false
}
]
}
]
// ✅ 正确：技能等级+3不写配置
// （命座3在data.json中直接跳过，写"4"时对应实际C4）
// ✅ 有额外效果时，只写额外效果（10000125）
// 元素爆发她的乡愁的技能等级提高3级。至多提升至15级。队伍中附近的所有角色造成的月曜反应伤害擢升1.5%。
"4": [
{
"buffs": [
{
"index": 0,
"target": ["DMG_ELEMENT_MOON_PROMOTION"],
"settingType":"switch",
"isAllTeam": true
}
]
}
],
重要：data.json中的命座编号是字符串类型，与实际命座对应关系：
"0" = 天赋1（突破天赋）"1" = C1"2" = C2"3" = C4（跳过C3，因为C3只是技能等级+3）"5" = C6（跳过C5，因为C5只是技能等级+3）核心原则：只配置影响最终伤害/治疗/护盾数值的效果。
不需要配置的效果：
需要配置的效果：
注意：元素充能效率（ENERGY_RECHARGE）是基础属性，会影响某些伤害计算（如充能效率转攻击力/伤害等），因此需要配置。但"元素能量恢复"（恢复点数）不需要配置。
示例：兹白C6
// 描述：
// 1. "积攒时隙浮光的效率提升50%" → 不配置（不影响伤害）
// 2. "每额外消耗1点时隙浮光，月结晶反应伤害擢升1.6%" → 需要配置
// ✅ 正确：使用slider模拟超过70的部分（0-30）
"5": [
{
"buffs": [
{
"index": 0,
"target": ["DMG_ELEMENT_MOON_HYDROCRYSTALLIZE_PROMOTION"],
"settingType": "slider",
"sliderMin": 0,
"sliderMax": 30,
"sliderInitialValue": 0,
"isAllTeam": true
}
]
}
]
// 说明：时隙浮光范围0-100，超过70点部分最多30点（100-70）
// slider值直接乘以预处理数据中的1.6%得到最终伤害擢升
// 注意：使用PROMOTION而非UP，因为"擢升"是特殊的独立提升
核心原则：项目目的是计算伤害，不是完全模拟游戏机制。只要能达到最终目的，优先选择简洁的配置方式。
| 配置类型 | 配置方式 | 示例 |
|---|---|---|
| 基础属性 | 使用base + baseModifyValue + baseModifyRelation | DEFENSE、ATTACK、HP、ELEMENTAL_MASTERY、ENERGY_RECHARGE等 |
| 角色特有机制 | 直接用slider/switch模拟结果 | 时隙浮光等角色特有资源 |
基础属性列表：
ATTACK - 攻击力DEFENSE - 防御力HP - 生命值ELEMENTAL_MASTERY - 元素精通ENERGY_RECHARGE - 元素充能效率⚠️ target 命名注意事项：
- 基础属性作为 target 时，直接使用属性名本身，如
ELEMENTAL_MASTERY- ❌ 错误写法：
ELEMENTAL_MASTERY_UP带有_UP后缀的形式不存在_UP后缀用于伤害相关常量（如DMG_RATE_UP_*），不用于元素精通
角色特有机制：
配置示例对比：
// ✅ 正确：基础属性使用base方式
{
"index": 0,
"base": "DEFENSE",
"baseModifyValue": 1000,
"baseModifyRelation": "+",
"target": ["ATTACK_UP"]
}
// ✅ 正确：角色特有机制直接用slider模拟结果
// 描述：每额外消耗1点时隙浮光，月结晶反应伤害擢升1.6%
{
"index": 0,
"target": ["DMG_ELEMENT_MOON_HYDROCRYSTALLIZE_PROMOTION"],
"settingType": "slider",
"sliderMin": 0,
"sliderMax": 30, // 时隙浮光超过70的部分（0-30）
"sliderInitialValue": 0
}
// ❌ 错误：角色特有机制使用不存在的base
{
"index": 0,
"base": "PHASE_SHIFT_RADIANCE", // 这不是基础属性！
"baseModifyValue": 70,
"baseModifyRelation": "-",
"target": ["DMG_ELEMENT_MOON_HYDROCRYSTALLIZE_PROMOTION"]
}
判断规则：
核心原则：buff 的 settingType 取决于效果是否有触发条件和叠加层数。
| settingType | 用途 | 示例 |
|---|---|---|
| resident | 无条件自动生效的被动效果，始终存在 | 武器特效的防御力提升 |
| switch | 有条件触发的效果（开/关两种状态） | 伤害加成、技能效果等 |
| slider | 有叠加层数的效果（switch无法模拟） | 叠加层数、气氛值、月兆等级等 |
判断规则：
无条件自动生效 → resident
有条件触发（只有开/关两种状态） → switch (+ defaultEnable 根据情况设置)
有叠加层数（多个不同数值的状态） → slider
有条件触发 → switch (+ defaultEnable 根据情况设置)
可变数值效果 → slider
defaultEnable 设置规则：
defaultEnable: false（默认关闭）示例对比（朏魄含光 11519 武器特效）：
// ✅ 正确配置
"effect": [
{
"buffs": [
{
"index": 0,
"target": ["DEFENSE_UP"],
"settingType": "resident" // 无条件自动生效
}
]
},
{
"buffs": [
{
"index": 0,
"target": ["DMG_ELEMENT_MOON_HYDROCRYSTALLIZE_UP"],
"settingType": "switch", // 有条件触发
"defaultEnable": false // 默认关闭
}
]
}
]
// ❌ 错误配置
{
"index": 0,
"target": ["DEFENSE_UP"],
"settingType": "slider", // 无条件生效不需要slider
"sliderInitialValue": 1,
"sliderMin": 1,
"sliderMax": 5,
"sliderStep": 1
}
推荐做法：分开写
"skill": [
{ "damage": { ... } }, // 第1个配置对象
{ "shield": { ... } }, // 第2个配置对象
{ "healing": { ... } } // 第3个配置对象
]
技术上可行但不推荐：合并
"skill": [
{ // 合并的配置对象（不推荐）
"damage": { ... },
"shield": { ... },
"healing": { ... }
}
]
建议分开写的原因:
角色: 神里绫华 (10000002) - 神里流·倾
源数据:
// paramDescList (简体中文)
[
"一段伤害|{param1:F1P}", // param1 = 0.457253 (等级1)
"二段伤害|{param2:F1P}", // param2 = 0.486846
"三段伤害|{param3:F1P}", // param3 = 0.626218
"四段伤害|{param4:F1P}*3", // param4 = 0.226464 (3次)
"五段伤害|{param7:F1P}", // param7 = 0.781817
"重击伤害|{param8:F1P}*3", // param8 = 0.55126 (3次)
"重击体力消耗|{param9:F1}点",
"下坠期间伤害|{param10:P}",
"低空/高空坠地冲击伤害|{param11:P}/{param12:P}"
]
// paramMap["01"] (等级1的参数值)
[0.457253, 0.486846, 0.626218, 0.226464, 0, 0, 0.781817, 0.55126, 20, 0.639324, 1.278377, 1.596762, ...]
说明: 神里绫华的普通攻击包含多个不同的伤害类型，每个需要单独配置。注意param5和param6未使用（值为0），需要跳过。
推断过程:
步骤1: 分析每一行的含义和参数
步骤2: 提取普通攻击的参数索引
param1 (一段) → index = 0param2 (二段) → index = 1param3 (三段) → index = 2param4 (四段) → index = 3param7 (五段) → index = 6indexes = [0, 1, 2, 3, 6]步骤3: 确定基础属性
base = "ATTACK"步骤4: 判断是否可被覆盖 (canOverride)
canOverride = true步骤5: 判断元素加成类型 (elementBonusType)
elementBonusType = "DMG_BONUS_PHYSICAL"步骤6: 判断攻击加成类型 (attackBonusType)
attackBonusType = "DMG_BONUS_NORMAL"步骤7: 为每个伤害类型创建配置对象
damage 对象damage 对象damage 对象最终配置 (data.json中的实际配置):
"normal": [
{
"damage": {
"indexes": [0, 1, 2, 3, 6], // 普通攻击一段到五段
"base": "ATTACK",
"canOverride": true,
"elementBonusType": "DMG_BONUS_PHYSICAL",
"attackBonusType": "DMG_BONUS_NORMAL"
}
},
{
"damage": {
"indexes": [7], // 重击伤害（param8 = index 7）
"base": "ATTACK",
"canOverride": true,
"elementBonusType": "DMG_BONUS_PHYSICAL",
"attackBonusType": "DMG_BONUS_CHARGED"
}
},
{
"damage": {
"indexes": [9, 10, 11], // 下落攻击伤害（param10-12）
"base": "ATTACK",
"canOverride": true,
"elementBonusType": "DMG_BONUS_PHYSICAL",
"attackBonusType": "DMG_BONUS_PLUNGING"
}
}
]
计算公式:
普通攻击一段伤害 = param[0] × 攻击力 = 0.457253 × 攻击力
重击伤害 = param[7] × 攻击力 = 0.55126 × 攻击力
角色: 纳西妲 (10000073) - 行相
源数据:
// paramDescList (简体中文)
[
"一段伤害|{param1:F1P}", // param1 = 0.403048 (等级1)
"二段伤害|{param2:F1P}", // param2 = 0.369744
"三段伤害|{param3:F1P}", // param3 = 0.458744
"四段伤害|{param4:F1P}", // param4 = 0.584064
"重击伤害|{param5:F1P}", // param5 = 1.32
"重击体力消耗|{param6:F1}点",
"下坠期间伤害|{param7:F1P}",
"低空/高空坠地冲击伤害|{param8:P}/{param9:P}"
]
// 武器类型: WEAPON_CATALYST (法器)
// 元素类型: 草元素
// paramMap["01"] (等级1的参数值)
[0.403048, 0.369744, 0.458744, 0.584064, 1.32, 50, 0.568288, 1.136335, 1.419344, ...]
说明: 法器角色的普通攻击使用角色元素属性（纳西妲为草元素），而非物理伤害。
推断过程:
步骤1: 识别伤害的行
步骤2: 提取参数索引
param1到param4 → indexes = [0, 1, 2, 3]param5 → indexes = [4]param7-9 → indexes = [6, 7, 8]步骤3: 判断 canOverride
canOverride = false (法器普通攻击使用元素伤害，不可被附魔覆盖)步骤4: 判断 elementBonusType
elementBonusType = "DMG_BONUS_DENDRO"步骤5: 判断 attackBonusType
attackBonusType = "DMG_BONUS_NORMAL"attackBonusType = "DMG_BONUS_CHARGED"attackBonusType = "DMG_BONUS_PLUNGING"最终配置:
{
"damage": {
"indexes": [0, 1, 2, 3], // 普通攻击一段到四段
"base": "ATTACK",
"canOverride": false, // 法器普通攻击不可覆盖
"elementBonusType": "DMG_BONUS_DENDRO", // 使用角色元素（草）
"attackBonusType": "DMG_BONUS_NORMAL"
}
}
对比物理普通攻击（神里绫华）:
canOverride: true, elementBonusType: "DMG_BONUS_PHYSICAL"canOverride: false, elementBonusType: "DMG_BONUS_DENDRO"角色: 雷泽 (10000020) - 雷牙（元素爆发）
源数据:
// elementalBurst 的 paramDescList (简体中文)
[
"爆发伤害|{param1:P}", // param1 = 1.6 (等级1)
"狼魂伤害|{param2:F1P}普通攻击伤害", // param2 = 0.24，关键！参考普通攻击
"普通攻击速度提升|{param3:P}", // param3 = 0.26
"雷元素抗性提升|{param4:P}", // param4 = 0.8
"持续时间|{param5:F1}秒",
"冷却时间|{param6:F1}秒",
"元素能量|{param7:I}"
]
// normal 的 paramDescList (简体中文)
[
"一段伤害|{param1:F1P}", // param1 = 0.9592 (等级1)，被引用的参数
...
]
// elementalBurst desc (简体中文): "...狼魂存在期间，会与雷泽共同战斗...狼魂会随雷泽的普通攻击协同攻击，造成雷元素伤害..."
说明: 狼魂的伤害基于普通攻击倍率，再乘以狼魂自己的倍率。这种机制需要使用originSkills来引用普通攻击的参数。
推断过程:
步骤1: 识别参考技能
normal 技能步骤2: 提取当前技能的 indexes
param2 (狼魂伤害) → indexes = [1]步骤3: 提取 originIndexes
param1 (一段伤害) → originIndexes = [0]步骤4: 确定 originRelations
originRelations = ["*"]步骤5: 判断其他字段
elementBonusType = "DMG_BONUS_ELECTRO"attackBonusType = "DMG_BONUS_NORMAL"步骤6: 判断是否需要特殊标签 (tag)
如何判断是否需要添加tag？
需要检查角色的所有proudSkills（突破天赋）和talents（命座），查找是否有以下情况：
检查源数据 (proudSkills):
// proudSkills[2] - "魔女的前夜礼·苍雷奔涌"
{
"desc": {
"cn_sim": "...雷泽的元素爆发雷牙唤醒的雷狼存在期间，如果雷泽积攒元素战技利爪与苍雷中的雷之印时发生溢出，雷狼将会引下落雷攻击附近的敌人，造成相当于雷泽150%攻击力的雷元素范围伤害...",
"en": "...While the Wolf Within summoned by Razor's Elemental Burst Lightning Fang is active, if the Electro Sigils from Razor's Elemental Skill Claw and Thunder overflow, the Wolf Within will call down a lightning strike on nearby enemies, dealing AoE Electro DMG equal to 150% of Razor's ATK..."
},
"paramMap": {
"01": [0.7, 1.5, 7, 1, ...] // param1 = 0.7 (狼魂伤害提升比例)
}
}
分析过程:
tag = "RAZOR_SOUL_COMPANION"结果: 添加tag → tag = "RAZOR_SOUL_COMPANION"
最终配置:
"elementalBurst": [
{
"damage": {
"indexes": [0], // 爆发伤害 param[1]
"base": "ATTACK",
"canOverride": false,
"elementBonusType": "DMG_BONUS_ELECTRO",
"attackBonusType": "DMG_BONUS_ELEMENTAL_BURST"
}
},
{
"damage": {
"originSkills": ["normal"], // 参考普通攻击
"originIndexes": [0], // normal的param[0]（一段伤害）
"originRelations": ["*"], // 乘法关系
"indexes": [1], // 当前技能的param[1]（狼魂倍率）
"base": "ATTACK",
"canOverride": false,
"elementBonusType": "DMG_BONUS_ELECTRO",
"attackBonusType": "DMG_BONUS_NORMAL",
"tag": "RAZOR_SOUL_COMPANION" // 狼魂专属标签
}
}
]
计算公式:
狼魂伤害 = normal[0] × param[1] × 攻击力
= (普通攻击一段倍率) × (狼魂倍率) × 攻击力
= 0.9592 × 0.24 × 攻击力
= 0.230208 × 攻击力
角色: 纳西妲 (10000073) - 所闻遍计（元素战技）
源数据:
// paramDescList (简体中文)
[
"点按伤害|{param1:F1P}", // param1 = 0.984 (等级1)
"长按伤害|{param2:F1P}", // param2 = 1.304
"灭净三业伤害|{param3:F1P}攻击力+{param4:F1P}元素精通", // 关键！复合倍率
"灭净三业触发间隔|{param5:F1}秒",
"蕴种印持续时间|{param6:F1}秒",
"点按冷却时间|{param7:F1}秒",
"长按冷却时间|{param8:F1}秒"
]
// paramMap["01"] (等级1的参数值)
[0.984, 1.304, 1.032, 2.064, 2.5, 25, 5, 6, ...]
// desc (简体中文): "...纳西妲将基于攻击力与元素精通，对该敌人及其所处连结中的所有敌人释放灭净三业，造成草元素伤害..."
说明: 灭净三业的伤害由两部分组成：基于攻击力的部分 + 基于元素精通的部分。这种机制需要使用indexesAttach和baseAttach来配置额外的倍率。
推断过程:
步骤1: 识别每一行的含义和参数
步骤2: 分析灭净三业的复合倍率
{param3:F1P}攻击力+{param4:F1P}元素精通param3攻击力 → indexes = [2], base = "ATTACK"+ param4元素精通 → indexesAttach = [[3]], baseAttach = ["ELEMENTAL_MASTERY"]+号 → 加法步骤3: 判断其他字段
attackBonusType = "DMG_BONUS_SKILL"elementBonusType = "DMG_BONUS_DENDRO"步骤4: 判断是否需要特殊标签 (tag)
如何判断是否需要添加tag？
需要检查角色的所有proudSkills（突破天赋）和talents（命座），查找是否有以下情况：
检查源数据 (proudSkills):
// proudSkills[1] - "慧明缘觉智论"
{
"desc": {
"cn_sim": "基于纳西妲元素精通超过200点的部分，每1点元素精通能使所闻遍计的灭净三业造成的伤害提升0.1%，暴击率提升0.03%。通过这种方式，至多使灭净三业造成的伤害提升80%，暴击率提升24%。",
"en": "Each point of Nahida's Elemental Mastery beyond 200 will grant 0.1% Bonus DMG and 0.03% CRIT Rate to Tri-Karma Purification from \"All Schemes to Know\". A maximum of 80% Bonus DMG and 24% CRIT Rate can be granted to Tri-Karma Purification in this manner."
},
"paramMap": {
"01": [200, 800, 0.001, 0.003, ...] // param1 = 200 (基础值), param2 = 800 (上限)
}
}
分析过程:
tag = "NAHIDA_TRI_KARMA"结果: 添加tag → tag = "NAHIDA_TRI_KARMA"
步骤4: 为每个效果创建配置对象
damage 对象damage 对象damage 对象（复合倍率）最终配置 (data.json中的实际配置):
"skill": [
{
"damage": { // 点按伤害
"indexes": [0],
"base": "ATTACK",
"canOverride": false,
"elementBonusType": "DMG_BONUS_DENDRO",
"attackBonusType": "DMG_BONUS_SKILL"
}
},
{
"damage": { // 长按伤害
"indexes": [1],
"base": "ATTACK",
"canOverride": false,
"elementBonusType": "DMG_BONUS_DENDRO",
"attackBonusType": "DMG_BONUS_SKILL"
}
},
{
"damage": { // 灭净三业伤害（复合倍率）
"indexes": [2], // 主要倍率: param[2] × 攻击力
"indexesAttach": [[3]], // 额外倍率: param[3] × 元素精通
"base": "ATTACK",
"baseAttach": ["ELEMENTAL_MASTERY"],
"elementBonusType": "DMG_BONUS_DENDRO",
"attackBonusType": "DMG_BONUS_SKILL",
"tag": "NAHIDA_TRI_KARMA"
}
}
]
计算公式:
灭净三业伤害 = (param[2] × 攻击力) + (param[3] × 元素精通)
= (1.032 × 攻击力) + (2.064 × 元素精通)
⚠️ 重要说明:
indexesAttach 和 baseAttach 必须是数组格式，即使只有一个额外倍率+）indexesAttach 和 baseAttach 可以继续添加元素角色: 阿贝多 (10000038) - 诞生式·大地之潮（元素爆发）
源数据:
// paramDescList (简体中文)
[
"爆发伤害|{param1:P}", // param1 = 3.672 (等级1)
"生灭之花伤害|每朵{param2:F1P}", // param2 = 0.72 (等级1)
"冷却时间|{param3:F1}秒",
"元素能量|{param4:I}"
]
// paramMap["01"] (等级1的参数值)
[3.672, 0.72, 12, 40, ...]
// desc (简体中文): "场上存在阿贝多自己创造的阳华时，会在阳华的领域内生成7朵生灭之花..."
说明: 生灭之花的伤害基于花朵数量计算。每朵花造成固定伤害，总伤害 = 每朵花伤害 × 花朵数量。花朵数量通过VAR_CHARA_1变量控制（1-7朵）。
推断过程:
步骤1: 识别每一行的含义
步骤2: 提取生灭之花的参数
param2 → 数组索引 = 2-1 = 1base = "ATTACK"步骤3: 确定最终计算队列
VAR_CHARA_1 = 生灭之花数量（由Buff滑块控制，1-7朵）finalResCalQueue 实现这个计算步骤4: 判断其他字段
attackBonusType = "DMG_BONUS_ELEMENTAL_BURST"elementBonusType = "DMG_BONUS_GEO"步骤5: 判断是否需要特殊标签 (tag)
如何判断是否需要添加tag？
需要检查角色的所有proudSkills（突破天赋）和talents（命座），查找是否有以下情况：
检查源数据 (talents):
// talents[1] - "显生之宙" (命座2)
{
"desc": {
"cn_sim": "...施放诞生式·大地之潮时，清除所有生灭计数效果，并根据清除的层数，提高诞生式·大地之潮的爆发伤害与生灭之花造成的伤害；每层生灭计数，会提高等同于阿贝多防御力的30%的伤害；该效果至多叠加4次。",
"en": "...Unleashing Rite of Progeniture: Tectonic Tide consumes all stacks of Fatal Reckoning. Each stack of Fatal Reckoning consumed increases the DMG dealt by Fatal Blossoms and Rite of Progeniture: Tectonic Tide's burst DMG by 30% of Albedo's DEF. This effect stacks up to 4 times."
},
"paramMap": {
"01": [0.3, 3, ...] // param1 = 0.3 (每层提升比例), param2 = 3 (最大层数)
}
}
分析过程:
tag = "ALBEDO_FATAL_BLOSSOM"结果: 添加tag → tag = "ALBEDO_FATAL_BLOSSOM"
步骤6: 定义VAR_CHARA_1变量
由于生灭之花的伤害基于花朵数量计算，需要定义一个滑块来控制花朵数量。
VAR_CHARA_1定义配置:
"buffs": [
{
"showIndex": 1, // 显示顺序
"setTos": ["VAR_CHARA_1"], // 设置的目标变量
"settingType": "slider", // 滑块类型
"sliderInitialValue": 1, // 初始值：1朵花
"sliderMin": 1, // 最小值：1朵花
"sliderMax": 7, // 最大值：7朵花
"sliderStep": 1, // 步长：1
"title": "BUFF.COMMON_QUANTITY.TITLE" // 显示标题（i18n key）
}
]
配置说明:
showIndex: 控制Buff在UI中的显示顺序setTos: 设置的目标变量数组（这里设置VAR_CHARA_1）sliderInitialValue: 滑块初始值（默认1朵花）sliderMin/Max: 滑块范围（1-7朵花，对应desc中提到的7朵生灭之花）sliderStep: 滑块步长（每次调整1朵）title: i18n key，用于多语言显示步骤5: 为每个效果创建配置对象
damage 对象damage 对象（带最终计算队列）最终配置 (data.json中的实际配置):
"elementalBurst": [
{
"damage": { // 爆发伤害
"indexes": [0],
"base": "ATTACK",
"canOverride": false,
"elementBonusType": "DMG_BONUS_GEO",
"attackBonusType": "DMG_BONUS_ELEMENTAL_BURST"
}
},
{
"buffs": [ // VAR_CHARA_1 定义（生灭之花数量滑块）
{
"showIndex": 1,
"setTos": ["VAR_CHARA_1"],
"settingType": "slider",
"sliderInitialValue": 1,
"sliderMin": 1,
"sliderMax": 7,
"sliderStep": 1,
"title": "BUFF.COMMON_QUANTITY.TITLE"
}
]
},
{
"damage": { // 生灭之花伤害
"indexes": [1], // param[1] 每朵花伤害
"base": "ATTACK",
"finalResCalQueue": [ // 基于花朵数量的计算
{
"relation": "*", // 乘法
"inner": [
{
"relation": "+",
"variable": "VAR_CHARA_1" // 花朵数量（1-7）
}
]
}
],
"canOverride": false,
"elementBonusType": "DMG_BONUS_GEO",
"attackBonusType": "DMG_BONUS_ELEMENTAL_BURST",
"tag": "ALBEDO_FATAL_BLOSSOM"
}
}
]
计算公式:
每朵花伤害 = param[1] × 攻击力 = 0.72 × 攻击力
总伤害 = 每朵花伤害 × (0 + VAR_CHARA_1)
= 0.72 × 攻击力 × (0 + 花朵数量)
例如: 花朵数量 = 3
总伤害 = 0.72 × 攻击力 × 3 = 2.16 × 攻击力
显示逻辑:
用户通过Buff滑块设置花朵数量（1-7朵）
伤害计算时自动乘以花朵数量
角色: 菈乌玛 (10000119) - 元素战技
源数据:
// paramDescList (简体中文)
[
"点按伤害|{param1:F1P}",
"长按一段伤害|{param2:F1P}",
"长按二段伤害|每枚草露{param3:F1P}元素精通", // 关键！月绽放伤害
...
]
// desc (简体中文): "...咏唱狩猎的祷歌，造成草元素范围伤害...与一次视为月绽放反应伤害的草元素范围伤害"
说明: 菈乌玛的长按二段伤害被明确说明为"视为月绽放反应伤害"的草元素伤害。这种特殊伤害类型需要使用specialDamageType来标记。
推断过程:
步骤1: 识别特殊伤害类型
specialDamageType = "moon-rupture-direction"步骤2: 提取参数
param3 → indexes = [2]base = "ELEMENTAL_MASTERY"步骤3: 确定最终计算队列
VAR_CHARA_5 = 草露数量（1-3个）步骤4: 判断其他字段
attackBonusType = "DMG_BONUS_SKILL"elementBonusType = "DMG_BONUS_DENDRO"specialDamageType = "moon-rupture-direction"最终配置:
{
"damage": {
"indexes": [2], // param[2]
"base": "ELEMENTAL_MASTERY",
"finalResCalQueue": [ // 基于草露数量计算合计伤害
{
"relation": "*",
"inner": [
{
"relation": "+",
"variable": "VAR_CHARA_5" // 草露数量（1-3个）
}
]
}
],
"canOverride": false,
"elementBonusType": "DMG_BONUS_DENDRO",
"attackBonusType": "DMG_BONUS_SKILL",
"specialDamageType": "moon-rupture-direction" // 直接月绽放伤害
}
}
计算公式:
每枚草露伤害 = param[2] × 元素精通
总伤害 = 每枚草露伤害 × (0 + VAR_CHARA_5)
= param[2] × 元素精通 × (0 + 草露数量)
角色: 兹白 (10000126) - 技能月转时隙
源数据:
// desc (简体中文): "...第四段攻击将额外造成一次岩元素伤害，该伤害视为月结晶反应伤害。"
// paramDescList (简体中文)
[
"灵驹飞踏第一段伤害|{param1:F1P}防御力",
"灵驹飞踏第二段伤害|{param2:F1P}防御力",
"月转时隙第四段额外伤害|{param3:F1P}防御力", // 关键！月结晶伤害
...
]
说明: 兹白的月转时隙第四段额外伤害被明确说明为"视为月结晶反应伤害"。这种特殊伤害类型需要使用specialDamageType标记为moon-hydro-crystallize-direction。
推断过程:
步骤1: 识别特殊伤害类型
specialDamageType = "moon-hydro-crystallize-direction"步骤2: 提取参数
param3 → indexes = [2]base = "DEFENSE"步骤3: 判断其他字段
attackBonusType = "DMG_BONUS_NORMAL"elementBonusType = "DMG_BONUS_GEO"specialDamageType = "moon-hydro-crystallize-direction"步骤4: 添加tag标识
tag = "ZIBAI_LUNAR_PHASE_SHIFT_4TH_EXTRA"最终配置:
{
"damage": {
"indexes": [2],
"base": "DEFENSE",
"canOverride": false,
"elementBonusType": "DMG_BONUS_GEO",
"attackBonusType": "DMG_BONUS_NORMAL",
"specialDamageType": "moon-hydro-crystallize-direction",
"tag": "ZIBAI_LUNAR_PHASE_SHIFT_4TH_EXTRA"
}
}
角色: 兹白 (10000126) - 命座4"魂魄往而身从之"
源数据:
// desc (简体中文): "...第四段额外攻击将造成相当于原本250%的月结晶反应伤害。"
// paramMap (C4)
{
"01": [2.5, 0, 0, 0, 0, 0, 0, 0]
}
// paramValidIndexes: [0]
说明: C4的效果是使技能中的第四段额外月结晶伤害造成250%的伤害。这需要使用origin引用技能中的damage配置，然后乘以C4的参数倍率。
推断过程:
步骤1: 确定引用源
originSkills: ["skill"]originIndexes: [2]步骤2: 确定倍率来源
indexes: [0]从C4的paramMap读取倍率步骤3: 确定运算关系
originRelations: ["*"]表示乘法关系最终配置:
{
"damage": {
"originSkills": ["skill"], // 引用skill中的damage
"originIndexes": [2], // 引用skill的index 2（第四段额外月结晶伤害）
"originRelations": ["*"], // 关系是乘法
"indexes": [0], // 从C4的paramMap读取index 0（值为2.5）
"canOverride": false,
"elementBonusType": "DMG_BONUS_GEO",
"attackBonusType": "DMG_BONUS_NORMAL",
"specialDamageType": "moon-hydro-crystallize-direction",
"tag": "ZIBAI_LUNAR_PHASE_SHIFT_4TH_EXTRA"
}
}
计算公式:
C4伤害 = skill[2]（第四段额外月结晶伤害）× C4 paramMap[0]（2.5）
= 原伤害 × 250%
origin引用说明:
originSkills: 指定引用的技能类型（"normal"/"skill"/"elementalBurst"等）originIndexes: 指定引用该技能中的哪个damage indexoriginRelations: 指定引用值与当前值的关系（["*"]为乘法，["+"]为加法）角色: 神里绫华 (10000002) - other 技能（神里流·霰步）
源数据:
// paramDescList (简体中文)
[
"启动体力消耗|{param1:F1}点", // param1 = 10
"持续体力消耗|每秒{param2:F1}点", // param2 = 15
"附魔持续时间|{param3:F1}秒" // param3 = 5
]
// paramMap["01"] (等级1的参数值)
[10, 15, 5, ...]
// desc (简体中文): "...将寒气凝聚在剑上，使神里绫华在短时间内获得冰元素附魔..."
说明: 元素附魔是一种特殊的增益效果，它不会直接提供数值加成，而是改变普通攻击、重击、下落攻击的元素类型。
推断过程:
步骤1: 从desc识别增益类型
settingType = "switch"步骤2: 确定附魔的元素类型
overrideElement = "DMG_BONUS_CRYO"步骤3: 设置其他必要字段
target = [] (空数组)defaultEnable = falseindex = 1最终配置:
"other": [
{
"buffs": [
{
"index": 1, // 任意一个Index即可
"overrideElement": "DMG_BONUS_CRYO", // 冰元素附魔
"target": [], // 空数组，不追加实际Buff
"settingType": "switch", // 开关型
"defaultEnable": false // 默认关闭
}
]
}
]
效果说明:
角色: 班尼特 (10000032) - 元素爆发「美妙旅程」
源数据:
// paramDescList (简体中文)
[
"技能伤害|{param1:P}", // 爆发伤害
"持续治疗|每秒{param2:F2P}生命值上限+{param3:I}", // 治疗效果
"攻击力加成比例|{param4:P}", // param4 = 0.56 (等级1)，关键！
"持续时间|{param5:F1}秒",
"冷却时间|{param6:F1}秒",
"元素能量|{param7:I}"
]
// paramMap["01"] (等级1的参数值)
[2.328, 0.06, 577.3388, 0.56, 12, 15, 60, ...]
// desc (简体中文): "...领域内的角色如果生命值高于70%，会基于班尼特的基础攻击力，以一定比例获得攻击力加成..."
说明: 班尼特的元素爆发同时包含伤害、治疗和攻击力增益三种效果。攻击力增益基于班尼特的基础攻击力，而非最终攻击力。
推断过程:
步骤1: 分析每一行的含义和参数
步骤2: 识别增益类型
settingType = "switch"步骤3: 确定基础属性
ATTACK_BASE (基础攻击力)，不是 ATTACK (最终攻击力)base = "ATTACK_BASE"步骤4: 确定目标效果
target = ["ATTACK_VAL_UP"]步骤5: 确定目标范围
isAllTeam = true步骤6: 提取参数索引
param4 (攻击力加成比例) → index = 4-1 = 3步骤7: 为每个效果创建配置对象
damage 对象healing 对象buffs 对象最终配置 (data.json中的实际配置):
"elementalBurst": [
{
"damage": { // 爆发伤害
"indexes": [0],
"base": "ATTACK",
"canOverride": false,
"elementBonusType": "DMG_BONUS_PYRO",
"attackBonusType": "DMG_BONUS_ELEMENTAL_BURST"
}
},
{
"healing": { // 持续治疗
"index": 1,
"constIndex": 2,
"constCalRelation": "+",
"base": "HP",
"healingBonusType": "HEALING_BONUS_ELEMENTAL_BURST"
}
},
{
"buffs": [ // 攻击力增益
{
"index": 3, // 对应param[3]
"base": "ATTACK_BASE", // ⚠️ 基于基础攻击力
"target": ["ATTACK_VAL_UP"], // 提升攻击力数值
"settingType": "switch", // 开关型
"defaultEnable": false, // 默认关闭
"isAllTeam": true // 全队生效
}
]
}
]
计算公式:
攻击力提升 = param[3] × 班尼特的基础攻击力
= 0.56 × 基础攻击力
例如: 基础攻击力 = 1000
攻击力提升 = 0.56 × 1000 = 560
⚠️ 重要说明:
角色: 芙宁娜 (10000089) - 元素爆发「万众狂欢」
源数据:
// paramDescList (简体中文)
[
"技能伤害|{param1:F1P}生命值上限", // 爆发伤害
"持续时间|{param2:F1}秒",
"气氛值上限|{param4:I}", // param4 = 300
"气氛值转化提升伤害比例|{param5:F2P}", // param5 = 0.0007 (每点气氛值)
"气氛值转化受治疗加成比例|{param6:F2P}", // param6 = 0.0001 (每点气氛值)
"冷却时间|{param7:F1}秒",
"元素能量|{param8:I}"
]
// paramMap["01"] (等级1的参数值)
[0.114064, 18, 0.01, 300, 0.0007, 0.0001, 15, 60, ...]
// desc (简体中文): "...每1%都将使芙宁娜获得1点「气氛值」。同时，基于芙宁娜持有的「气氛值」，附近的队伍中所有角色造成的伤害提升，受治疗加成提升。"
说明: 芙宁娜的气氛值是一个动态变化的值，范围0-300。气氛值越高，提供的伤害加成和受治疗加成越高。需要使用滑块来模拟这个可变值。
推断过程:
步骤1: 分析每一行的含义和参数
步骤2: 识别增益类型
settingType = "slider"步骤3: 确定数值范围
param4 = 300 (气氛值上限)sliderMax = 300sliderInitialValue = 0步骤4: 确定目标效果
DMG_BONUS_ALLREVERSE_HEALING_BONUSisAllTeam = true步骤5: 提取参数索引
param5 (伤害转化比例) → index = 5-1 = 4param6 (治疗转化比例) → index = 6-1 = 5步骤6: 理解双对象配置
步骤7: 为每个效果创建配置对象
damage 对象buffs 数组（两个对象）最终配置 (data.json中的实际配置):
"elementalBurst": [
{
"damage": { // 爆发伤害
"indexes": [0],
"base": "HP",
"canOverride": false,
"elementBonusType": "DMG_BONUS_HYDRO",
"attackBonusType": "DMG_BONUS_ELEMENTAL_BURST"
}
},
{
"buffs": [ // 气氛值增益（双对象配置）
{
"index": 5, // 对应param[6]
"target": ["REVERSE_HEALING_BONUS"], // 受到治疗加成
"settingType": "slider", // 滑块型
"sliderInitialValue": 0, // 初始值0
"sliderMax": 300, // 最大300点气氛值
"sliderStep": 1, // 步长1
"isAllTeam": true // 全队生效
},
{
"index": 4, // 对应param[5]
"target": ["DMG_BONUS_ALL"], // 所有伤害加成
"isAllTeam": true // 全队生效
}
]
}
]
计算公式:
伤害提升 = 气氛值 × param[5]
受治疗提升 = 气氛值 × param[6]
例如: 气氛值 = 300（最大值）
伤害提升 = 300 × 0.0007 = 0.21 = 21%
受治疗提升 = 300 × 0.0001 = 0.03 = 3%
机制说明:
⚠️ 重要说明:
settingType 相关字段index 和 target，会自动共享第一个对象的滑块值重要: 原神中的治疗技能通常同时包含百分比倍率和固定数值两部分。以下示例基于实际游戏数据。
角色: 芭芭拉 (10000014) - 元素战技「演唱，开始♪」
源数据:
// paramDescList (元素战技)
[
"持续治疗量|{param1:F2P}生命值上限+{param2:I}",
"命中治疗量|{param3:F2P}生命值上限+{param4:I}",
"水珠伤害|{param5:F1P}",
"持续时间|{param6:F1}秒",
"冷却时间|{param7:F1}秒"
]
说明: 芭芭拉的元素战技有两种不同的治疗效果，每个都需要单独的配置对象。
推断过程:
步骤1: 分析每一行的含义和参数
"持续治疗量|{param1:F2P}生命值上限+{param2:I}"
param1 (百分比)param2 (整数)"命中治疗量|{param3:F2P}生命值上限+{param4:I}"
param3 (百分比)param4 (整数)"水珠伤害|{param5:F1P}"
步骤2: 提取参数索引 (index/constIndex)
paramX 对应 index = X-1param1 → index = 0, param2 → constIndex = 1param3 → index = 2, param4 → constIndex = 3param5 → indexes = [4]步骤3: 确定其他必要字段
base = "HP"healingBonusType = "HEALING_BONUS_SKILL"+号 → constCalRelation = "+"步骤4: 为每个效果创建配置对象
healing 对象healing 对象damage 对象最终配置 (data.json中的实际配置):
"skill": [
{
"healing": {
"index": 0, // param[0] × HP (持续治疗)
"constIndex": 1, // + param[1]
"constCalRelation": "+",
"base": "HP",
"healingBonusType": "HEALING_BONUS_SKILL"
}
},
{
"healing": {
"index": 2, // param[2] × HP (命中治疗)
"constIndex": 3, // + param[3]
"constCalRelation": "+",
"base": "HP",
"healingBonusType": "HEALING_BONUS_SKILL"
}
},
{
"damage": { // 水珠伤害
"indexes": [4],
"base": "ATTACK",
"canOverride": false,
"elementBonusType": "DMG_BONUS_HYDRO",
"attackBonusType": "DMG_BONUS_SKILL"
}
}
]
计算公式:
持续治疗量 = (param[0] × 生命值上限) + param[1]
命中治疗量 = (param[2] × 生命值上限) + param[3]
角色: 久岐忍 (10000065) - 元素战技「越祓雷草之轮」
源数据:
// paramDescList (元素战技)
[
"技能伤害|{param1:P}",
"越祓草轮治疗量|{param2:F1P}生命值上限+{param3:I}",
"越祓草轮伤害|{param4:F1P}",
...
]
推断过程:
步骤1: 识别治疗效果的行
"越祓草轮治疗量|{param2:F1P}生命值上限+{param3:I}" - 这是治疗效果步骤2: 提取参数和计算关系
{param2:F1P}生命值上限+{param3:I}param2 → 数组索引 = 2-1 = 1param3 → 数组索引 = 3-1 = 2+号，表示加法步骤3: 确定基础属性和类型
base = "HP"healingBonusType = "HEALING_BONUS_SKILL"最终配置:
{
"healing": {
"index": 1, // param[1] = param2 in desc
"constIndex": 2, // param[2] = param3 in desc
"constCalRelation": "+",
"base": "HP",
"healingBonusType": "HEALING_BONUS_SKILL"
}
}
计算公式:
治疗量 = (param[1] × 生命值上限) + param[2]
角色: 琴 (10000003) - 元素爆发「蒲公英之风」
源数据:
// paramDescList (元素爆发)
[
"爆发伤害|{param1:P}",
"出入领域伤害|{param2:F1P}",
"领域发动治疗量|{param3:P}攻击力+{param4:I}",
"持续治疗|每秒{param5:F2P}攻击力+{param6:I}",
...
]
推断过程:
步骤1: 识别治疗效果的行
"领域发动治疗量|{param3:P}攻击力+{param4:I}" - 初始治疗"持续治疗|每秒{param5:F2P}攻击力+{param6:I}" - 持续治疗（每秒）步骤2: 提取参数 (以初始治疗为例)
param3 → 数组索引 = 3-1 = 2param4 → 数组索引 = 4-1 = 3步骤3: 确定基础属性
base = "ATTACK"healingBonusType = "HEALING_BONUS_ELEMENTAL_BURST"最终配置 (仅展示初始治疗):
{
"healing": {
"index": 2, // param[2] × 攻击力
"constIndex": 3, // + param[3]
"constCalRelation": "+",
"base": "ATTACK", // 基于攻击力！
"healingBonusType": "HEALING_BONUS_ELEMENTAL_BURST"
}
}
重要: 原神中的护盾技能通常同时包含百分比倍率和固定数值两部分。以下示例基于实际游戏数据。
⚠️ 护盾属性说明: 护盾可以基于不同的属性计算，必须从实际paramDescList确认，不能想当然：
角色: 诺艾尔 (10000034) - 元素战技「护心铠」
源数据:
// paramDescList (元素战技)
[
"技能伤害|{param6:P}防御力",
"吸收量|{param1:P}防御力+{param7:I}",
"治疗量|{param2:F1P}防御力+{param8:I}",
"治疗触发几率|{param3:P}",
"持续时间|{param4:F1}秒",
"冷却时间|{param5:F1}秒"
]
推断过程:
步骤1: 识别护盾效果的行
"吸收量|{param1:P}防御力+{param7:I}" - 这是护盾吸收量步骤2: 提取参数
param1和param7不是连续的！param1 → 数组索引 = 1-1 = 0param7 → 数组索引 = 7-1 = 6步骤3: 确定基础属性
base = "DEFENSE"shieldElementType = "GEO"最终配置:
{
"shield": {
"index": 0, // param[0] × 防御力
"constIndex": 6, // + param[6] (固定值)
"constCalRelation": "+",
"base": "DEFENSE",
"shieldBonusType": "SHIELD_BONUS_SKILL",
"shieldElementType": "GEO" // 岩元素护盾
}
}
计算公式:
护盾量 = (param[0] × 防御力) + param[6]
角色: 迪奥娜 (10000039) - 元素战技「猫爪冻冻」
源数据:
// paramDescList (元素战技)
[
"猫爪伤害|每个{param1:F1P}",
"护盾基础吸收量|{param2:F1P}最大生命值+{param3:I}",
"持续时间|每个猫爪{param6:F1}秒",
"冷却时间|{param7:F1}秒"
]
推断过程:
步骤1: 识别护盾效果的行
"护盾基础吸收量|{param2:F1P}最大生命值+{param3:I}" - 这是护盾吸收量步骤2: 提取参数
param2 → 数组索引 = 2-1 = 1param3 → 数组索引 = 3-1 = 2步骤3: 确定基础属性
base = "HP"shieldElementType = "CRYO"最终配置:
{
"shield": {
"index": 1, // param[1] × 最大生命值
"constIndex": 2, // + param[2]
"constCalRelation": "+",
"base": "HP", // ⚠️ 基于生命值
"shieldBonusType": "SHIELD_BONUS_SKILL",
"shieldElementType": "CRYO" // 冰元素护盾
}
}
计算公式:
护盾量 = (param[1] × 最大生命值) + param[2]
⚠️ 重要说明:
paramDescList描述中确认基础属性角色: 辛焱 (10000044) - 元素战技「热情拂扫」
源数据:
// paramDescList (元素战技)
[
"挥舞伤害|{param1:P}",
"一级护盾吸收量|{param2:F1P}防御力+{param3:I}",
"二级护盾吸收量|{param4:F1P}防御力+{param5:I}",
"三级护盾吸收量|{param6:F1P}防御力+{param7:I}",
"持续伤害|{param8:F1P}",
"护盾持续时间|{param9:F1}秒",
"冷却时间|{param10:F1}秒"
]
说明: 辛焱的护盾根据命中敌人数量有三个等级，每个等级都需要单独的配置对象。
推断过程:
步骤1: 识别所有效果的行
"挥舞伤害|{param1:P}" - 伤害效果"一级护盾吸收量|{param2:F1P}防御力+{param3:I}" - 护盾等级1"二级护盾吸收量|{param4:F1P}防御力+{param5:I}" - 护盾等级2"三级护盾吸收量|{param6:F1P}防御力+{param7:I}" - 护盾等级3"持续伤害|{param8:F1P}" - 持续伤害（仅三级护盾时）步骤2: 为每个护盾等级提取参数
param2 → index = 1, param3 → constIndex = 2param4 → index = 3, param5 → constIndex = 4param6 → index = 5, param7 → constIndex = 6步骤3: 确定基础属性
base = "DEFENSE"shieldElementType = "PYRO"步骤4: 为每个效果创建配置对象
damage 对象shield 对象shield 对象shield 对象damage 对象最终配置 (data.json中的实际配置):
"skill": [
{
"damage": { // 挥舞伤害
"indexes": [0],
"base": "ATTACK",
"canOverride": false,
"elementBonusType": "DMG_BONUS_PYRO",
"attackBonusType": "DMG_BONUS_SKILL"
}
},
{
"shield": { // 一级护盾 (命中0-1人)
"index": 1,
"constIndex": 2,
"constCalRelation": "+",
"base": "DEFENSE",
"shieldBonusType": "SHIELD_BONUS_SKILL",
"shieldElementType": "PYRO"
}
},
{
"shield": { // 二级护盾 (命中2人)
"index": 3,
"constIndex": 4,
"constCalRelation": "+",
"base": "DEFENSE",
"shieldBonusType": "SHIELD_BONUS_SKILL",
"shieldElementType": "PYRO"
}
},
{
"shield": { // 三级护盾 (命中3人以上)
"index": 5,
"constIndex": 6,
"constCalRelation": "+",
"base": "DEFENSE",
"shieldBonusType": "SHIELD_BONUS_SKILL",
"shieldElementType": "PYRO"
}
},
{
"damage": { // 持续伤害 (三级护盾时)
"indexes": [7],
"base": "ATTACK",
"canOverride": false,
"elementBonusType": "DMG_BONUS_PYRO",
"attackBonusType": "DMG_BONUS_SKILL"
}
}
]
重要说明:
| 配置类型 | 关键字段 | 判断依据 |
|---|---|---|
| 基础伤害 | indexes, base, elementBonusType | {paramX} 提取indexes |
| 参考技能 | originSkills, originIndexes | 描述包含"XX伤害" |
| 复合倍率 | indexesAttach, baseAttach | 描述包含 + 连接多个属性 |
| 显示控制 | displayCalQueue | 需要条件判断才显示 |
| 最终修正 | finalResCalQueue | 对最终伤害进行额外计算 |
| 特殊标签 | tag | 生成物、召唤物等特殊机制 |
| 自定义倍率 | customValues | 固定倍率而非参数 |
| 特殊伤害 | specialDamageType | 月反应、后台伤害等 |
"一段伤害|{param1:F1P}" → indexes: [0]
"二段伤害|{param2:F1P}" → indexes: [1]
"伤害|{param1:F1P}攻击力" → base: "ATTACK"
"伤害|{param1:F1P}生命值" → base: "HP"
"伤害|{param1:F1P}防御力" → base: "DEFENSE"
"伤害|{param1:F1P}元素精通" → base: "ELEMENTAL_MASTERY"
"伤害|{param1:F1P}+{param2:I}" → index: 0, constIndex: 1
"伤害|{param1:F1P}普通攻击伤害" → originSkills: ["normal"]
"伤害|{param1:F1P}攻击力+{param2:F1P}元素精通" → indexesAttach, baseAttach
普通攻击 + 非法器 → canOverride: true, elementBonusType: "DMG_BONUS_PHYSICAL"
普通攻击 + 法器 → canOverride: false, elementBonusType: 角色元素
元素战技 → canOverride: false, elementBonusType: 角色元素
元素爆发 → canOverride: false, elementBonusType: 角色元素
"火元素"/"燃烧" → DMG_BONUS_PYRO
"水元素"/"感电" → DMG_BONUS_HYDRO
"风元素"/"扩散" → DMG_BONUS_ANEMO
"雷元素"/"超载" → DMG_BONUS_ELECTRO
"冰元素"/"融化" → DMG_BONUS_CRYO
"岩元素"/"结晶" → DMG_BONUS_GEO
"草元素"/"绽放" → DMG_BONUS_DENDRO