src/data/

游戏数据层，包含角色构建系统的核心计算逻辑和游戏数据。

目录结构

``
data/
├── d/ # 静态数据文件
│ ├── abyss.data.ts # 深渊副本和增益数据
│ ├── achievement.data.ts # 成就数据
│ ├── base.data.ts # 基础数据
│ ├── buff.data.ts # 增益数据
│ ├── char.data.ts # 角色数据
│ ├── draft.data.ts # 抽卡数据
│ ├── dungeon.data.ts # 副本数据
│ ├── effect.data.ts # 效果数据
│ ├── fish.data.ts # 钓鱼数据
│ ├── map.data.ts # 地图数据
│ ├── mod.data.ts # MOD 数据
│ ├── monster.data.ts # 怪物数据
│ ├── pet.data.ts # 宠物数据
│ ├── reward.data.ts # 奖励数据
│ └── walnut.data.ts # 胡桃数据
├── leveled/ # 带等级的游戏对象类
│ ├── LeveledBuff.ts # 带等级的增益
│ ├── LeveledChar.ts # 带等级的角色
│ ├── LeveledMod.ts # 带等级的 MOD
│ ├── LeveledMonster.ts # 带等级的怪物
│ ├── LeveledPet.ts # 带等级的宠物
│ ├── LeveledSkill.ts # 带等级的技能
│ ├── LeveledSkillWeapon.ts # 带等级的同律武器
│ ├── LeveledWeapon.ts # 带等级的武器
│ └── index.ts # 导出和升级倍率表
├── tests/ # 单元测试
│ ├── CharBuild.test.ts
│ ├── data-types.test.ts
│ ├── evaluateAST.test.ts
│ ├── leveled.test.ts
│ └── index.test.ts
├── ast.ts # AST（抽象语法树）解析器
├── CharBuild.ts # 角色构建核心类
├── data-types.ts # 数据类型定义
├── index.ts # 导出入口
├── package.json # 包配置
├── tsconfig.json # TypeScript 配置
└── vitest.config.ts # 测试配置
`

核心模块

$3

角色构建系统的核心类，负责计算角色属性和伤害。

主要功能：

- 属性计算：计算角色基础属性（攻击、生命、护盾、防御、神智）和其他属性（技能威力、耐久、效益、范围等）
- 武器属性计算：计算近战武器、远程武器、同律武器的属性
- 伤害计算：
- 技能伤害计算（考虑属性穿透、昂扬、背水、增伤、独立增伤、失衡易伤等乘区）
- 武器伤害计算（考虑暴击、触发、攻速、多重等）
- 防御乘区计算
- AST 表达式求值：支持自定义目标函数表达式，如 伤害、DPS、每神智DPS 等
- 时间线模拟：支持技能释放时间线的 DPS 模拟

关键类和方法：

`typescript
class CharBuild {
// 静态宏定义，用于 AST 表达式的快捷替换
static macros: Record

// 计算角色所有属性
calculateAttributes(): CharAttr

// 计算武器属性
calculateWeaponAttributes(weapon): CharAttr & { weapon?: WeaponAttr }

// 计算技能伤害
calculateSkillDamage(attrs): DamageResult

// 计算武器伤害
calculateWeaponDamage(attrs, weapon): DamageResult

// 计算 AST 目标函数
evaluateAST(astInput, attrs): number

// 验证 AST 表达式
validateAST(astInput): string | undefined

// 计算随机伤害（用于模拟）
calculateRandomDamage(baseWithTarget, enemy?): number
}
`

$3

所有数据类型的接口定义和枚举。

主要接口：

- Char：角色数据结构
- Weapon：武器数据结构
- Skill：技能数据结构
- Mod：MOD 数据结构
- Monster：怪物数据结构
- Buff：增益数据结构
- SkillField：技能字段
- SkillEffect：技能效果
- SkillBuff：技能增益

主要枚举：

- Elem：元素类型（光、暗、水、火、雷、风）
- WeaponCategory：武器类别（单手剑、长柄、重剑、双刀、鞭刃、太刀、手枪、双枪、榴炮、霰弹枪、突击枪、弓）
- WeaponSkillType：武器技能类型（普通攻击、蓄力攻击、下落攻击、滑行攻击、射击）
- HpType：生命值类型（生命、护盾、战姿）
- DmgType：伤害类型（切割、贯穿、震荡）
- SkillType：技能类型（伤害、召唤、增益、治疗、被动、防御）
- Faction：阵营
- Quality：MOD 品质（白、紫、绿、蓝、金）
- ModType：MOD 类型（角色、近战、远程、同律近战、同律远程）
- ModSeries：MOD 系列（不死鸟、中庭蛇、人面狮、冥犬、囚狼、夜使、夜魔、契约者等）

$3

带等级的游戏对象类，根据等级倍率表计算属性。

CommonLevelUp：角色/武器 1-80 级的升级倍率表。

主要类：

- LeveledChar：带等级的角色，计算基础属性和技能等级
- LeveledWeapon：带等级的武器，计算基础属性和武器技能
- LeveledSkillWeapon：带等级的同律武器
- LeveledMod：带等级的 MOD，计算属性加成
- LeveledBuff：带等级的增益
- LeveledSkill：带等级的技能，计算技能字段值
- LeveledMonster：带等级的怪物，计算属性和当前状态
- LeveledPet：带等级的宠物

$3

AST（抽象语法树）解析器和求值器。

功能：

- 词法分析：将表达式字符串转换为 Token 流
- 语法分析：将 Token 流转换为 AST
- 宏替换：支持宏定义的快捷替换（如 DPS → or(攻速,1+技能速度)or(多重,1)伤害）
- 支持的表达式特性：
- 基本运算：+、-、*、/、//（整数除法）、%（取模）
- 属性访问：攻击、伤害、[幻象]伤害
- 函数调用：max(a, b)、or(a, b)
- 命名空间访问：Q::伤害（技能 Q 的伤害）
- 成员访问：伤害.N（伤害的不考虑血量版本）

AST 节点类型：

- binary：二元运算（a + b）
- unary：一元运算（-a、+a）
- property：属性（攻击）
- function：函数调用（max(a, b)）
- member_access：成员访问（伤害.N）
- number：数字字面量

$3

静态游戏数据文件，包含所有角色的技能、武器、MOD、怪物等数据。

主要数据文件：

- char.data.ts：角色数据（基础属性、技能、同律武器）
- weapon.data.ts：武器数据（基础属性、武器技能）
- mod.data.ts：MOD 数据（系列、品质、属性加成）
- monster.data.ts：怪物数据（属性、阵营）
- buff.data.ts：增益数据
- achievement.data.ts：成就数据
- abyss.data.ts：深渊副本数据
- dungeon.data.ts：副本数据
- fish.data.ts：钓鱼数据
- walnut.data.ts：胡桃数据

$3

单元测试，使用 Vitest 框架。

测试文件：

- CharBuild.test.ts：角色构建功能测试
- data-types.test.ts：数据类型测试
- evaluateAST.test.ts：AST 求值测试
- leveled.test.ts：带等级对象测试
- index.test.ts：导出测试

伤害计算公式

$3

`
伤害 = 基础伤害 × 属性穿透 × 增伤 × 独立增伤 × 失衡易伤 × 血量乘区 × 防御乘区
`

乘区说明：

- 属性穿透：max(0, (1 - 敌方抗性) × (1 + 属性穿透))
- 增伤：1 + 增伤 + 技能伤害
- 独立增伤：1 + 独立增伤（乘法叠加）
- 失衡易伤：失衡状态 ? (1 + 失衡易伤 + 1.5) : 1
- 血量乘区：
- 昂扬乘区：1 + 昂扬 × 当前血量百分比
- 背水乘区：1 + 4 × 背水 × (1 - hp%) × (1.5 - hp%)
- 防御乘区：1 - 防御 / (300 + 防御 - 等级差 × 10)

$3

`
期望伤害 = (物理部分 × 物理倍率 + 元素部分 × 元素倍率 × 抗性) × 暴击期望 × 增伤 × 独立增伤 × 追加伤害 × 失衡易伤 × 血量乘区 × 抗性穿透
`

暴击期望计算：

`
暴击期望 = 1 + 暴击率 × (暴击伤害 - 1)
`

触发伤害期望：

`
触发期望 = 触发率 × 触发倍率
`

AST 目标函数

系统支持自定义目标函数，使用 AST 表达式语法。

$3

- DPS：or(攻速,1+技能速度)or(多重,1)伤害
- 总伤：max(1,召唤物攻击次数)*伤害
- 暴击伤害：伤害.暴击
- 每神智DPH：1/神智消耗*伤害
- 每神智DPS：or(攻速,1+技能速度)/神智消耗*伤害
- 范围收益：技能范围*伤害
- 耐久收益：技能耐久*伤害
- 效益收益：技能效益*伤害

$3

`javascript
// 基础伤害
"伤害"

// DPS
"DPS"

// 考虑技能效益和神智消耗
"技能效益*伤害/神智消耗"

// 技能 Q 的伤害
"Q::伤害"

// 考虑暴击和触发的期望伤害
"伤害.N 暴击伤害.暴击 (1 + 触发伤害)"

// 技能范围和效益的加权平均
"0.5技能范围伤害 + 0.5技能效益伤害"
`

使用示例

$3

`typescript
import { CharBuild, LeveledChar, LeveledWeapon, LeveledMod, LeveledBuff } from "dna-builder-data"

const charBuild = new CharBuild({
char: new LeveledChar("黎瑟", 80),
melee: new LeveledWeapon("铸铁者"),
ranged: new LeveledWeapon("烈焰孤沙"),
charMods: [new LeveledMod(41324)],
buffs: [new LeveledBuff("黎瑟E")],
hpPercent: 1,
resonanceGain: 0,
baseName: "普通攻击",
targetFunction: "DPS",
enemyId: 130,
enemyLevel: 80,
skillLevel: 10,
})

// 计算伤害
const damage = charBuild.calculate()
`

$3

`typescript
const charBuild = new CharBuild({...})

// 设置自定义目标函数
charBuild.targetFunction = "技能范围伤害 + 技能效益伤害/神智消耗"

// 验证表达式
const error = charBuild.validateAST(charBuild.targetFunction)
if (error) {
console.error("表达式错误:", error)
} else {
const result = charBuild.calculate()
console.log("目标函数值:", result)
}
`

$3

`typescript
import { WeaponSkillType } from "./data-types"

// 计算所有技能的伤害
const skills = charBuild.charSkills
skills.forEach(skill => {
const [attrs, damage] = charBuild.calculateByBasename(skill.名称)
console.log(${skill.名称}: ${damage.expectedDamage})
})

// 计算所有武器技能的伤害
const weaponSkills = charBuild.weaponSkills
weaponSkills.forEach(skill => {
const [attrs, damage] = charBuild.calculateByBasename(skill.名称)
console.log(${skill.名称}: ${damage.expectedDamage})
})
`

运行测试

`bash


运行所有测试

pnpm test

运行特定测试文件

pnpm test src/data/tests/CharBuild.test.ts

运行测试并生成覆盖率报告

pnpm coverage
`

注意事项

1. 等级系统：所有带等级的对象都使用 CommonLevelUp 数组计算属性倍率
2. MOD 限制：MOD 有系列限制和极性限制，同一系列的 MOD 最多装备 1 个
3. 属性上限：某些属性有上限（如技能效益上限 175%，技能范围上限 280%）
4. AST 缓存：AST 解析结果会被缓存以提高性能
5. 动态增益：支持带 code 属性的动态增益，可以在运行时修改属性

扩展指南

$3

1. 在 data-types.ts 中定义接口
2. 在 d/ 目录下创建数据文件
3. 在 index.ts 中导出

$3

1. 在 leveled/ 目录下创建新文件
2. 实现 getLevelValue 方法使用 CommonLevelUp 计算属性
3. 在 leveled/index.ts 中导出

$3

1. 在 ast.ts 中的 evaluateIdentity 函数中添加处理逻辑
2. 在 CharBuild.macros` 中添加宏定义（可选）

相关文档

- ../AGENTS.md - AI 助手指南
- ../../README.md - 项目总览
- d/AI.md - 系统文档