#MoonDES

通用离散事件仿真引擎，基于国产 MoonBit 编译型语言构建。

#特性

• 最小堆优先级事件队列：按 (time, priority) 排序，保证时序正确性
• 协程进程调度：进程可 timeout / wait_event / request_resource，挂起恢复不占用线程
• 三类资源模型：独占式 Exclusive / 共享容量 Capacity / 优先级抢占 Preemptive
• 实验管理：批量仿真、参数遍历、快照保存、断点回滚、结果统计
• 插件扩展接口：标准化 on_step / on_event / on_finish 生命周期回调
• 多实例并行：仿真环境无全局共享状态，天然支持并行仿真
• 跨后端：一次开发，编译为 Native / WASI / WASM 三种部署形态

#快速开始

#环境要求

• MoonBit 工具链（moon 命令行工具）

#安装

moon add moondes/moondes

#最小示例

///|
test {
  inspect(version(), content="0.1.0")
}

///|
test {
  let env = new_env(until=10.0)
  let log : Array[String] = []
  ignore(env.schedule(time=2.0, callback=fn() { log.push("event@2.0") }))
  ignore(env.schedule(time=1.0, callback=fn() { log.push("event@1.0") }))
  env.run()
  assert_eq(log[0], "event@1.0")
  assert_eq(log[1], "event@2.0")
}

#运行示例工程

moon run examples/hello_des        # 最简事件调度
moon run examples/mm1_queue        # M/M/1 排队系统
moon run examples/resource_sharing # 实验管理与插件

#项目结构

MoonDES/
├── core/          # 层级1：仿真内核（SimulationEnv / EventQueue / Event）
├── process/       # 层级2：协程进程调度（Process / timeout / wait_event）
├── resource/      # 层级3：资源管理（Exclusive / Capacity / Preemptive）
├── experiment/    # 层级4：实验管理（ExpConfig / ExpResult / Snapshot）
├── plugin/        # 层级5：插件接口（PluginManager / PluginCallbacks）
├── examples/      # 可执行示例
│   ├── hello_des/
│   ├── mm1_queue/
│   └── resource_sharing/
└── docs/          # 项目文档

#依赖层级

core (无依赖) ← process / resource / experiment / plugin

#API 概览

#测试

moon check              # 类型检查
moon test --target native  # 运行测试
moon info               # 生成 API 接口文件

#贡献指南

1. Fork 仓库并创建特性分支：git checkout -b feature/your-feature
2. 遵循约定式提交：feat: / fix: / docs: / refactor:
3. 确保 moon check 与 moon test 全部通过
4. 公开 API 必须附 /// 文档注释
5. 新增功能必须配套单元测试
6. 提交 Pull Request

#路线图

#许可证

#致谢

• MoonBit — 国产编译型编程语言
• 仿真引擎设计参考：SimPy（协程调度内核）、DESMO-J（实验分层架构）