About

Imported from xucy10/Mili (SKILL.md). Install upstream with npx skills add xucy10/Mili. Copyright stays with the author.

Mili 代码审查与 bug 修复工作流

Name: Mili
Author: xucy10

目标

对 Mili 项目（基于 Folia 的 Minecraft 26.2 服务端核心）进行系统性 bug 排查与修复，覆盖 Java 源码中的并发安全、NPE、整数溢出、时间尺度混淆、线程静默死亡等问题，以及 Rust JNI 模块的安全加固。

适用场景

全项目代码审查（Java + Rust）
线程安全问题排查（竞态、死锁、线程静默死亡）
JNI 边界安全加固
区域调度系统稳定性优化
网络连接稳定性优化

何时触发

大规模代码变更后需要全面审查
发现服务器线程静默死亡或 OOM 崩溃
JNI 调用导致 native 崩溃
区域调度系统出现任务 ID 碰撞或任务丢失
网络连接不稳定需要优化

前提条件

JDK 25 已安装并配置 JAVA_HOME
Rust toolchain（edition 2024）已安装
项目已 applyAllPatches 并可成功编译
构建环境：./gradlew :mili-server:compileJava + cargo clippy --release + cargo test --release

工作流步骤

1. 环境准备

export JAVA_HOME="C:/Users/Administrator/Downloads/jdk-25_windows-x64_bin/jdk-25.0.4"
export PATH="$JAVA_HOME/bin:$PATH"
cd "E:/Program Files/Tencent/AndrowsData/Mili"
./gradlew :mili-server:compileJava

2. Java 代码审查

按严重程度分类排查：

致命级 — 线程静默死亡：

搜索 catch(Exception) 模式，在调度器/线程上下文中改为 catch(Throwable)
涉及 ScheduledExecutorService、CompletableFuture、线程池的所有 catch 块

致命级 — 数据损坏：

检查浮点位操作（如 SCORE_MASK 破坏 double 位布局）
检查 writeIndex 溢出（Math.floorMod 替代 %）
检查时间尺度混淆（游戏时间 vs 系统时间）

资源泄漏级：

检查 Map/Queue 无限增长（添加 TTL 清理或上限）
检查 Deflater/RandomAccessFile/FileChannel 未在 finally 中关闭
检查 UUID 注册后未注销

并发竞态级：

检查 volatile boolean 初始化标志（改为 AtomicBoolean.compareAndSet）
检查异步遍历 Bukkit 集合（先快照为 ArrayList）
检查 getLocation() 多次调用竞态（调用一次存入局部变量）
检查 .equals() 模式 NPE（改为 Objects.equals()）

3. Rust JNI 安全审查

所有 JNI 入口用 catch_unwind(AssertUnwindSafe(...)) 包装
#[no_mangle] → #[unsafe(no_mangle)]（edition 2024）
unsafe fn 内部显式 unsafe 块
checked_mul 防止长度溢出
负数实体数/null 指针/DirectByteBuffer 容量校验
EPSILON=1e-6 浮点比较防护

4. 验证

# Java 编译
./gradlew :mili-server:compileJava

# Rust clippy（必须 0 warning）
cd mili-rust/src/rust && cargo clippy --release

# Rust 测试（28 tests passed）
cargo test --release

5. 修复标记

所有修复使用 // Mili start - fix: / // Mili end 注释标记。

质量门

Java BUILD SUCCESSFUL
Rust cargo clippy --release — 0 error, 0 warning
Rust cargo test --release — 28 passed, 0 failed

异常处理

编译错误：检查 JDK 版本是否为 25（不是 21）
Rust edition 2024 编译错误：检查 #[unsafe(no_mangle)] 语法
catch_unwind 编译错误：需用 AssertUnwindSafe 包装 JNIEnv

维护记录

版本 0.2 — 适配 Mili 26.2 分支，JDK 25，Rust edition 2024

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/xucy10-mili-mili/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

xucy10-mili-mili.ocm.jsonjson

{
  "ocm": "1",
  "id": "xucy10-mili-mili",
  "kind": "skill",
  "name": "Mili",
  "description": "对 Mili 项目（基于 Folia 的 Minecraft 26.2 服务端核心）进行系统性 bug 排查与修复，覆盖 Java 源码中的并发安全、NPE、整数溢出、时间尺度混淆、线程静默死亡等问题，以及 Rust JNI 模块的安全加固。",
  "publisher": "xucy10",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "code-review",
      "bug-fix",
      "rust",
      "jni",
      "concurrency",
      "minecraft",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "对 Mili 项目（基于 Folia 的 Minecraft 26.2 服务端核心）进行系统性 bug 排查与修复，覆盖 Java 源码中的并发安全、NPE、整数溢出、时间尺度混淆、线程静默死亡等问题，以及 Rust JNI 模块的安全加固。"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/xucy10/Mili",
      "path": "SKILL.md",
      "ref": "0fbde75aaa16832b801fccb61d103bb12006e1ff",
      "url": "https://github.com/xucy10/Mili/blob/0fbde75aaa16832b801fccb61d103bb12006e1ff/SKILL.md",
      "key": "xucy10/Mili/SKILL.md"
    }
  },
  "instructions": "# Mili 代码审查与 bug 修复工作流\n\n## 目标\n\n对 Mili 项目（基于 Folia 的 Minecraft 26.2 服务端核心）进行系统性 bug 排查与修复，覆盖 Java 源码中的并发安全、NPE、整数溢出、时间尺度混淆、线程静默死亡等问题，以及 Rust JNI 模块的安全加固。\n\n## 适用场景\n\n- 全项目代码审查（Java + Rust）\n- 线程安全问题排查（竞态、死锁、线程静默死亡）\n- JNI 边界安全加固\n- 区域调度系统稳定性优化\n- 网络连接稳定性优化\n\n## 何时触发\n\n- 大规模代码变更后需要全面审查\n- 发现服务器线程静默死亡或 OOM 崩溃\n- JNI 调用导致 native 崩溃\n- 区域调度系统出现任务 ID 碰撞或任务丢失\n- 网络连接不稳定需要优化\n\n## 前提条件\n\n- JDK 25 已安装并配置 `JAVA_HOME`\n- Rust toolchain（edition 2024）已安装\n- 项目已 `applyAllPatches` 并可成功编译\n- 构建环境：`./gradlew :mili-server:compileJava` + `cargo clippy --release` + `cargo test --release`\n\n## 工作流步骤\n\n### 1. 环境准备\n\n```bash\nexport JAVA",
  "cost": {
    "context_tokens": 570
  }
}

Fetch it by URL: GET /api/v1/registry/xucy10-mili-mili/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.