这是一个用Swift实现的骰子表达式解析器，完整复现了JavaScript版本的所有功能。提供了两个产品：
- DiceParser库 - 可供其他项目导入和使用的核心库
- DiceParserCLI - 命令行工具，用于直接执行骰子表达式
- ✅ 标准骰子投掷（如 2d6, d20）
- ✅ 百分骰投掷（d100）
- ✅ 优势/劣势投掷（Adv(d20), Dis(d6)）
- ✅ 数学运算支持（+ - * / ()）
- ✅ 错误处理和验证
- ✅ 详细的投掷记录
- ✅ 完整的单元测试
- ✅ 作为库供其他项目使用
├── Package.swift # Swift包配置文件
├── Sources/
│ ├── DiceParser/ # 核心库
│ │ ├── DiceParser.swift # 主解析器类
│ │ ├── DiceParser+*.swift # 扩展功能
│ │ ├── DiceParserError.swift # 错误定义
│ │ └── DiceRollResult.swift # 结果结构
│ └── DiceParserCLI/ # CLI工具
│ └── main.swift # 命令行程序
├── Tests/
│ └── DiceParserTests/ # 单元测试
└── README.md # 说明文档
GitHub: https://github.com/zsy78192/DiceParser.git
swift buildswift run DiceParserCLI "2d6 + 3"
swift run DiceParserCLI "Adv(d20) + 5"swift test在您的Package.swift中添加依赖：
dependencies: [
.package(url: "https://github.com/zsy78192/DiceParser.git", from: "1.0.0")
],
targets: [
.target(
name: "YourTarget",
dependencies: ["DiceParser"]),
]swift run DiceParserCLI "2d6 + 3"# 简单骰子投掷
swift run DiceParserCLI "d20"
# 多个骰子加修饰符
swift run DiceParserCLI "3d6 + 5"
# 优势投掷
swift run DiceParserCLI "Adv(d20)"
# 劣势投掷
swift run DiceParserCLI "Dis(d6)"
# 复杂表达式
swift run DiceParserCLI "(2d6 + d4) * 2"
# 百分骰
swift run DiceParserCLI "d100 + 20"swift run DiceParserCLI --help在您的Swift代码中导入和使用：
import DiceParser
let parser = DiceParser()
do {
let result = try parser.evaluateExpression("2d6 + 3")
// 获取最终结果
if let finalResult = result["finalResult"] as? Double {
print("结果: \(Int(finalResult))")
}
// 获取计算步骤
if let steps = result["steps"] as? String {
print("步骤: \(steps)")
}
// 获取骰子投掷详情
if let rolls = result["rolls"] as? [[String: Any]] {
print("投掷详情:")
for roll in rolls {
print(roll)
}
}
} catch let error as DiceParserError {
print("错误: \(error.localizedDescription)")
} catch {
print("未知错误: \(error)")
}import Foundation
let parser = DiceParser()
do {
let result = try parser.evaluateExpression("2d6 + Adv(d20)")
if let rolls = result["rolls"] as? [[String: Any]] {
print("投掷记录: \(rolls)")
}
if let steps = result["steps"] as? String {
print("计算步骤: \(steps)")
}
if let finalResult = result["finalResult"] as? Double {
print("最终结果: \(Int(finalResult))")
}
} catch {
print("错误: \(error.localizedDescription)")
}| 表达式 | 说明 |
|---|---|
d6 |
投掷一个6面骰子 |
2d6 |
投掷两个6面骰子 |
d100 |
投掷百分骰 |
Adv(d20) |
d20优势投掷（取最大值） |
Dis(d6) |
d6劣势投掷（取最小值） |
2d6 + 3 |
两个6面骰子加3 |
(d6 + d8) * 2 |
括号内的计算 |
解析器会抛出以下错误：
DiceParserError.emptyExpression: 空表达式DiceParserError.invalidOperatorCombination: 无效运算符组合DiceParserError.invalidDiceFaces: 骰子面数无效（1-1000）DiceParserError.invalidCharacter: 无效字符DiceParserError.missingOperator: 缺少运算符DiceParserError.diceCountExceeded: 骰子数量超过限制（100）DiceParserError.invalidExpression: 无效表达式
swift run
# 选择选项 1 查看演示swift run
# 选择选项 2 进入交互模式swift run
# 选择选项 3 运行单元测试| 特性 | Swift版本 | JavaScript版本 |
|---|---|---|
| 随机数生成 | Swift原生 | Math.random() |
| 数学计算 | NSExpression | math.js |
| 错误处理 | Swift Error | JavaScript Error |
| 测试框架 | XCTest | Jest |
| 包管理 | Swift Package Manager | npm |
🎲 骰子表达式解析器演示
========================================
表达式: 2d6 + 3
--------------------
投掷结果:
d6: 4
d6: 5
计算步骤: [4+5] + 3
最终结果: 12
表达式: Adv(d20)
--------------------
投掷结果:
Adv(d20): [15,12] → 15
计算步骤: [15,12→15]
最终结果: 15
- Swift版本: 5.7+
- 依赖: 无外部依赖，使用Foundation框架
- 平台: macOS, Linux, iOS (需适配)
- 架构: 面向对象设计，封装为DiceParser类
- 添加自定义骰子类型：可以扩展支持更多骰子类型
- 历史记录：添加投掷历史记录功能
- 统计分析：计算平均值、标准差等统计信息
- UI集成：为iOS/macOS应用创建图形界面
- 网络功能：添加在线骰子投掷服务
MIT License - 可自由使用和修改