القائمة
Eyelib Clientsmoke 客户端烟雾测试——@ClientSmoke 注解、三层架构、运行、报告。Use when writing or running clientsmoke tests.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | eyelib-clientsmoke |
| description | Eyelib Clientsmoke 客户端烟雾测试——@ClientSmoke 注解、三层架构、运行、报告。Use when writing or running clientsmoke tests. |
| license | MIT |
| compatibility | opencode |
| metadata | {"author":"https://github.com/TT432","version":"1.0.0","tags":"eyelib, testing, clientsmoke, mc","related-skills":"eyelib, eyelib-build, eyelib-debug"} |
clientsmoke 是 eyelib 的客户端烟雾测试框架——在 MC 客户端加载后、world 就绪时自动执行 @ClientSmoke 注解的测试类，输出 JSON/XML 报告。
| 层 | 环境 | 测试内容 |
|---|---|---|
| Layer 1 domain spec | 纯 JUnit (:test) | MaterialResolver, BrRenderStateFactory, Molang, CODEC |
| Layer 2a 管道 | 纯 JUnit | BrMaterialEntry → BrRenderState 语义映射 |
| Layer 2b Bridge | clientsmoke | RenderTypeResolver, RenderPassAdapter, EntityPortAdapter — 需 MC 类型 |
| Layer 3 接线 | clientsmoke + Fake | EntityRenderSystem.setupClientEntity — Component 接线 |
在 build.gradle 的 client run 配置中添加：
systemProperty 'clientsmoke.enabled', 'true'
systemProperty 'clientsmoke.autoExit', 'false' // 测试结束后保持开启
clientsmoke.enabled默认false，不加此属性状态机进入 IDLE 不执行。
测试类放在 src/main/java/io/github/tt432/eyelib/smoke/。模式：
@ClientSmoke(description = "简短描述", priority = 10)
public class MySmoke {
public MySmoke() {
// 全部逻辑在无参构造器中执行
// throw = fail, 正常返回 = pass
// 可调用 Minecraft.getInstance()、所有 Manager、所有 Bridge 类
var materials = MaterialManager.INSTANCE.getAllData();
require(!materials.isEmpty(), "No materials");
}
private static void require(boolean cond, String msg) {
if (!cond) throw new AssertionError(msg);
}
}
eyelib_debug_launch(timeout=180) # 启动 + 自动编译
# ⚠️ 不要调用 eyelib_debug_enter_world！clientsmoke 自己创建 ClientSmokeTest 世界
# 等待 ~30s → 状态机 INIT → CONFIG_LOAD → SCAN → WORLD_CREATE → STABILIZE → TEST_EXEC → REPORT
输出（gameDir = versions/<version>/run/clientsmoke，由 build.gradle clientSmoke run config 决定）：
versions/<version>/run/clientsmoke/clientsmoke-reports/report-YYYYMMDD-HHmmss.jsonversions/<version>/run/clientsmoke/clientsmoke-reports/junit-YYYYMMDD-HHmmss.xmlversions/<version>/run/clientsmoke/clientsmoke-reports/screenshots/ — 每测试一张截图name:base 格式：.mcpack 中的 key 是 entity_nocull:entity 不是 entity_noculleyelib_debug_enter_world 同时使用：clientsmoke 自己创建世界，手动 enter_world 会冲突ResourceLocation 用 new ResourceLocation(ns, path)：MC 1.20.1 没有 fromNamespaceAndPathEyelib 构建、测试、环境——Gradle(Stonecutter 多版本) + eyelib-debug MCP 全流程。Use when building, testing, or troubleshooting Gradle builds for the eyelib project.
Eyelib MCP 调试——启动客户端、/eval 执行代码、渲染诊断 Phase、实体操作。Use when debugging rendering, executing /eval code, or diagnosing entity issues.
Eyelib Forge 模组开发总索引——项目概览、Skill 导航、跨域约束。Load first for any eyelib task.
Extract a Port from a domain module in the hexagonal architecture refactoring — locate MC contact points, create Port interfaces, migrate glue code to bridge, and verify with ArchUnit.
Eyelib GPU 调试——RenderDoc 截帧、headless 回放、Windows Python replay、renderdoc-mcp。Use when capturing or analyzing RenderDoc frames.
Write Mixin accessors and injectors for eyelib. Use when replacing reflection with @Accessor/@Invoker, injecting into vanilla methods, or debugging Mixin AP compilation errors. Covers Forge 1.20.1 (Mixin AP active) and NeoForge 1.21.1 (no Mixin AP) dual-version patterns.