npm - kcode-pi - Versions diffs - 0.1.0 - Mend

kcode-pi 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (219) hide show

package/vendor/kingdee-skills/cosmic-unittest/cosmic-unittest-skill-overview.html ADDED Viewed

@@ -0,0 +1,746 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>cosmic-unittest 技能总览 v1.4</title>
+<style>
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif; background: #f0f2f5; color: #24292e; font-size: 14px; line-height: 1.6; }
+  .header { background: linear-gradient(135deg, #1a1f2e 0%, #2d3a5c 50%, #1e4080 100%); color: white; padding: 32px 40px; }
+  .header h1 { font-size: 26px; font-weight: 700; margin-bottom: 6px; letter-spacing: 1px; }
+  .header .subtitle { font-size: 14px; opacity: 0.8; }
+  .badge { display: inline-block; background: rgba(255,255,255,0.15); border: 1px solid rgba(255,255,255,0.3); border-radius: 12px; padding: 2px 10px; font-size: 12px; margin-left: 10px; vertical-align: middle; }
+  .main { max-width: 1400px; margin: 0 auto; padding: 24px 32px; }
+  .grid-2 { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; margin-bottom: 20px; }
+  .grid-3 { display: grid; grid-template-columns: 1fr 1fr 1fr; gap: 20px; margin-bottom: 20px; }
+  .grid-4 { display: grid; grid-template-columns: 1fr 1fr 1fr 1fr; gap: 20px; margin-bottom: 20px; }
+  .full-width { margin-bottom: 20px; }
+  .card { background: white; border-radius: 8px; padding: 20px; box-shadow: 0 1px 4px rgba(0,0,0,0.08); }
+  .card h2 { font-size: 15px; font-weight: 700; color: #1a1f2e; margin-bottom: 14px; padding-bottom: 8px; border-bottom: 2px solid #e1e4e8; display: flex; align-items: center; gap: 8px; }
+  .card h3 { font-size: 13px; font-weight: 600; color: #444d56; margin: 12px 0 6px; }
+  .step-flow { display: flex; align-items: center; gap: 0; flex-wrap: wrap; }
+  .step-box { background: #f6f8fa; border: 1px solid #d1d5da; border-radius: 6px; padding: 8px 14px; text-align: center; min-width: 80px; }
+  .step-box .step-num { font-size: 10px; color: #6a737d; font-weight: 600; text-transform: uppercase; }
+  .step-box .step-name { font-size: 13px; font-weight: 600; color: #1a1f2e; margin-top: 2px; }
+  .step-box .step-desc { font-size: 11px; color: #586069; margin-top: 2px; }
+  .step-arrow { font-size: 18px; color: #aaa; padding: 0 6px; }
+  .step-box.highlight { background: #0366d6; border-color: #0366d6; color: white; }
+  .step-box.highlight .step-num, .step-box.highlight .step-name, .step-box.highlight .step-desc { color: white; }
+  .tree-item { padding: 4px 0; display: flex; align-items: flex-start; gap: 6px; font-size: 13px; }
+  .tree-item .icon { width: 18px; height: 18px; border-radius: 4px; display: flex; align-items: center; justify-content: center; font-size: 10px; flex-shrink: 0; margin-top: 1px; font-weight: 700; }
+  .tree-sub { margin-left: 22px; }
+  .tree-sub .tree-item { font-size: 12px; color: #586069; }
+  .badge-blue { background: #dbeafe; color: #1d4ed8; border-radius: 4px; padding: 1px 7px; font-size: 11px; font-weight: 600; white-space: nowrap; }
+  .badge-green { background: #dcfce7; color: #15803d; border-radius: 4px; padding: 1px 7px; font-size: 11px; font-weight: 600; white-space: nowrap; }
+  .badge-orange { background: #fef3c7; color: #d97706; border-radius: 4px; padding: 1px 7px; font-size: 11px; font-weight: 600; white-space: nowrap; }
+  .badge-red { background: #fee2e2; color: #dc2626; border-radius: 4px; padding: 1px 7px; font-size: 11px; font-weight: 600; white-space: nowrap; }
+  .badge-purple { background: #ede9fe; color: #7c3aed; border-radius: 4px; padding: 1px 7px; font-size: 11px; font-weight: 600; white-space: nowrap; }
+  .badge-gray { background: #f1f3f5; color: #495057; border-radius: 4px; padding: 1px 7px; font-size: 11px; font-weight: 600; white-space: nowrap; }
+  code { font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace; font-size: 12px; background: #f6f8fa; border: 1px solid #e1e4e8; border-radius: 3px; padding: 1px 5px; }
+  pre { background: #1e2433; color: #e6edf3; border-radius: 6px; padding: 14px 16px; font-size: 12px; line-height: 1.7; overflow-x: auto; margin-top: 8px; font-family: "SFMono-Regular", Consolas, monospace; }
+  pre .kw { color: #ff7b72; }
+  pre .str { color: #a5d6ff; }
+  pre .cmt { color: #8b949e; font-style: italic; }
+  pre .ann { color: #ffa657; }
+  pre .cls { color: #79c0ff; }
+  pre .num { color: #79c0ff; }
+  table { width: 100%; border-collapse: collapse; font-size: 12px; }
+  thead tr { background: #f6f8fa; }
+  th { padding: 7px 10px; text-align: left; font-weight: 600; color: #444d56; border-bottom: 2px solid #d1d5da; white-space: nowrap; }
+  td { padding: 6px 10px; border-bottom: 1px solid #e1e4e8; vertical-align: top; }
+  tr:last-child td { border-bottom: none; }
+  tr:hover td { background: #f6f8fa; }
+  .rule-item { display: flex; align-items: flex-start; gap: 8px; padding: 6px 0; border-bottom: 1px solid #e1e4e8; font-size: 12px; }
+  .rule-item:last-child { border-bottom: none; }
+  .rule-icon { font-size: 14px; flex-shrink: 0; margin-top: 1px; }
+  .rule-text strong { color: #1a1f2e; }
+  .rule-text span { color: #586069; }
+  .warn-box { background: #fff8e1; border-left: 4px solid #f59e0b; border-radius: 0 6px 6px 0; padding: 10px 14px; margin-top: 8px; font-size: 12px; }
+  .warn-box strong { color: #b45309; }
+  .ok-box { background: #f0fff4; border-left: 4px solid #10b981; border-radius: 0 6px 6px 0; padding: 10px 14px; margin-top: 8px; font-size: 12px; }
+  .ok-box strong { color: #047857; }
+  .module-card { border: 1px solid #e1e4e8; border-radius: 6px; padding: 12px; margin-bottom: 10px; }
+  .module-card:last-child { margin-bottom: 0; }
+  .module-title { font-size: 13px; font-weight: 700; margin-bottom: 6px; }
+  .module-meta { font-size: 11px; color: #586069; }
+  .confusion-row-bad { background: #fff5f5; }
+  .confusion-row-good { background: #f0fff4; }
+  .x-mark { color: #dc2626; font-weight: 700; }
+  .check-mark { color: #16a34a; font-weight: 700; }
+  .two-col { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; }
+  .section-title { font-size: 16px; font-weight: 700; color: #1a1f2e; margin: 8px 0 16px; padding-left: 10px; border-left: 4px solid #0366d6; }
+</style>
+</head>
+<body>
+<div class="header">
+  <h1>cosmic-unittest 苍穹模块单元测试编写技能 <span class="badge">v1.4</span></h1>
+  <div class="subtitle">适用于任何遵循 common / business / opplugin / formplugin 四工程结构的金蝶云苍穹模块 &nbsp;·&nbsp; JUnit 4 + Mockito 2.x &nbsp;·&nbsp; 6 项性能优化</div>
+</div>
+<div class="main">
+  <!-- 执行流程 -->
+  <div class="full-width">
+    <p class="section-title">技能执行流程</p>
+    <div class="card">
+      <div class="step-flow">
+        <div class="step-box">
+          <div class="step-num">Step 0.0</div>
+          <div class="step-name">识别模块组</div>
+          <div class="step-desc">从包名推导前缀</div>
+        </div>
+        <div class="step-arrow">→</div>
+        <div class="step-box">
+          <div class="step-num">Step 0.1</div>
+          <div class="step-name">判断测试类型</div>
+          <div class="step-desc">工程 → 模式</div>
+        </div>
+        <div class="step-arrow">→</div>
+        <div class="step-box highlight">
+          <div class="step-num">Step 0.5</div>
+          <div class="step-name">获取 Author</div>
+          <div class="step-desc">缓存 → git → 询问</div>
+        </div>
+        <div class="step-arrow">→</div>
+        <div class="step-box">
+          <div class="step-num">Step 1</div>
+          <div class="step-name">分析被测类</div>
+          <div class="step-desc">依赖 + Bug 审查</div>
+        </div>
+        <div class="step-arrow">→</div>
+        <div class="step-box">
+          <div class="step-num">Step 2</div>
+          <div class="step-name">编写测试类</div>
+          <div class="step-desc">注解 + Mock + 断言</div>
+        </div>
+        <div class="step-arrow">→</div>
+        <div class="step-box">
+          <div class="step-num">Step 3</div>
+          <div class="step-name">覆盖场景</div>
+          <div class="step-desc">边界值 + 分支</div>
+        </div>
+        <div class="step-arrow">→</div>
+        <div class="step-box">
+          <div class="step-num">Step 4</div>
+          <div class="step-name">验证运行</div>
+          <div class="step-desc">静态分析 + Gradle</div>
+        </div>
+      </div>
+    </div>
+  </div>
+  <!-- Step 0.1 + v1.4 性能优化专区 -->
+  <div class="full-width">
+    <p class="section-title">⚡ v1.4 性能优化专区</p>
+    <div class="grid-3">
+      <div class="card">
+        <h2>📂 按需加载 pattern 文件</h2>
+        <p style="font-size:12px;color:#586069;margin-bottom:8px;">根据工程类型只读取 <strong>1 个</strong> pattern，禁止全量加载：</p>
+        <table>
+          <thead><tr><th>工程类型</th><th>pattern 文件</th></tr></thead>
+          <tbody>
+            <tr><td>common - POJO</td><td><code>common-module.md #POJO</code></td></tr>
+            <tr><td>common - 枚举</td><td><code>common-module.md #Enum</code></td></tr>
+            <tr><td>common - 工具类</td><td><code>common-module.md #Utils</code></td></tr>
+            <tr><td>business</td><td><code>business-helper.md</code></td></tr>
+            <tr><td>opplugin - Validator</td><td><code>validator.md</code></td></tr>
+            <tr><td>opplugin - OpPlugin</td><td><code>op-plugin.md</code></td></tr>
+            <tr><td>opplugin - Convert</td><td><code>convert-plugin.md</code></td></tr>
+            <tr><td>formplugin</td><td><code>formplugin.md</code></td></tr>
+          </tbody>
+        </table>
+        <div class="ok-box">example 文件仅在需要参考具体写法时按需读取，非必读。</div>
+      </div>
+      <div class="card">
+        <h2>🚀 并行全量读取</h2>
+        <p style="font-size:12px;color:#586069;margin-bottom:8px;">读取被测类源码后，以下全部<strong>同一轮并行发起</strong>：</p>
+        <div class="rule-item">
+          <span class="rule-icon">📄</span>
+          <div class="rule-text"><strong>常量/枚举类</strong> <span>import 提取 → grep_code 并行搜索</span></div>
+        </div>
+        <div class="rule-item">
+          <span class="rule-icon">📄</span>
+          <div class="rule-text"><strong>BaseTest 源码</strong> <span>search_file 搜索确认预置 Mock</span></div>
+        </div>
+        <div class="rule-item">
+          <span class="rule-icon">📄</span>
+          <div class="rule-text"><strong>对应 pattern</strong> <span>直接 read_file 补读</span></div>
+        </div>
+        <div class="rule-item">
+          <span class="rule-icon">📄</span>
+          <div class="rule-text"><strong>关联类签名</strong> <span>import 提取 → grep_code 搜索方法签名</span></div>
+        </div>
+        <div class="warn-box" style="margin-top:8px;">v1.3 只并行读取常量，v1.4 扩展为全量并行，减少多轮串行等待。</div>
+      </div>
+      <div class="card">
+        <h2>🧠 智能 Mock 推断</h2>
+        <p style="font-size:12px;color:#586069;margin-bottom:8px;">从 import 自动匹配映射表，规则驱动取代经验驱动：</p>
+        <table>
+          <thead><tr><th>import 中的类</th><th>Mock 方式</th></tr></thead>
+          <tbody>
+            <tr><td><code>QueryServiceHelper</code></td><td>mockStatic + when(query)</td></tr>
+            <tr><td><code>BusinessDataServiceHelper</code></td><td>mockStatic + when(load...)</td></tr>
+            <tr><td><code>OperationServiceHelper</code></td><td>mockStatic + when(executeOperate)</td></tr>
+            <tr><td><code>SaveServiceHelper</code></td><td>mockStatic + when(save/update)</td></tr>
+            <tr><td><code>OrgUnitServiceHelper</code></td><td>mockStatic（通常无需 stub）</td></tr>
+            <tr><td><code>ResManager</code></td><td>mockStatic + thenAnswer(getArg(0))</td></tr>
+            <tr><td><code>DB</code></td><td style="color:#dc2626;">必须先 ClassPool defrost</td></tr>
+            <tr><td><code>ProcessSettleHelper</code></td><td style="color:#dc2626;">禁止直接 mockStatic，用 MockHelper</td></tr>
+          </tbody>
+        </table>
+      </div>
+    </div>
+    <div class="grid-2" style="margin-top:20px;">
+      <div class="card">
+        <h2>🧹 BaseTest Mock 继承去重</h2>
+        <p style="font-size:12px;color:#586069;margin-bottom:8px;">仅声明 BaseTest 未预置的 MockedStatic <strong>差集</strong>：</p>
+        <pre><span class="kw">public class</span> <span class="cls">SomeHelperTest</span> <span class="kw">extends</span> <span class="cls">BaseTest</span> {
+    <span class="cmt">// 仅声明 BaseTest 未预置的</span>
+    <span class="cls">MockedStatic</span>&lt;<span class="cls">ProcessPlanHelper</span>&gt; planHelper;
+    <span class="ann">@Before</span> <span class="kw">public void</span> before() {
+        <span class="kw">super</span>.before();  <span class="cmt">// 先触发 BaseTest</span>
+        planHelper = mockStatic(<span class="cls">ProcessPlanHelper</span>.class);
+    }
+    <span class="ann">@After</span> <span class="kw">public void</span> after() {
+        planHelper.close();
+        <span class="kw">super</span>.after();
+    }
+}</pre>
+      </div>
+      <div class="card">
+        <h2>📦 批量模式并行策略</h2>
+        <p style="font-size:12px;color:#586069;margin-bottom:8px;">同工程多被测类，最大化并行：</p>
+        <table>
+          <thead><tr><th>步骤</th><th>并行策略</th></tr></thead>
+          <tbody>
+            <tr><td>源码读取</td><td>所有被测类 + 常量 + BaseTest <strong>同一轮并行</strong></td></tr>
+            <tr><td>逻辑分析</td><td>逐类分析，汇总输出一次（跳过确认）</td></tr>
+            <tr><td>代码生成</td><td>互不依赖的测试类可<strong>并行生成</strong></td></tr>
+            <tr><td>Gradle 验证</td><td>只冷启动<strong>一次</strong>，合并运行</td></tr>
+          </tbody>
+        </table>
+        <div class="ok-box" style="margin-top:8px;">核心价值：Gradle 冷启动一次 + 文件读取并行化 + 测试类并行生成</div>
+      </div>
+    </div>
+  </div>
+  <!-- Step 0.0 + Step 0.1 -->
+  <div class="grid-2">
+    <div class="card">
+      <h2>📦 Step 0.0 — 识别模块组前缀</h2>
+      <p style="font-size:12px;color:#586069;margin-bottom:10px;">从被测类的包名或文件路径中提取 <code>&lt;模块组&gt;</code>，后续所有工程名、包名、路径均基于此推导。</p>
+      <table>
+        <thead><tr><th>包名示例</th><th>模块组前缀</th></tr></thead>
+        <tbody>
+          <tr><td><code>kd.mmc.sfc.business.XxxHelper</code></td><td><span class="badge-blue">mmc-sfc</span></td></tr>
+          <tr><td><code>kd.bd.mpdm.business.XxxHelper</code></td><td><span class="badge-blue">bd-mpdm</span></td></tr>
+          <tr><td><code>kd.sys.xkbase.business.XxxHelper</code></td><td><span class="badge-blue">sys-xkbase</span></td></tr>
+          <tr><td><code>kd.mmc.pom.business.XxxHelper</code></td><td><span class="badge-blue">mmc-pom</span></td></tr>
+        </tbody>
+      </table>
+    </div>
+    <div class="card">
+      <h2>🏗️ Step 0.1 — 工程 → 测试模式</h2>
+      <div class="module-card">
+        <div class="module-title"><span class="badge-purple">&lt;模块组&gt;-common</span> &nbsp; 公共模块</div>
+        <div class="tree-sub">
+          <div class="tree-item"><span style="color:#7c3aed">●</span> POJO/DTO/Bean → <span class="badge-gray">POJO 模式</span> 无需 Mock 直接 new</div>
+          <div class="tree-item"><span style="color:#7c3aed">●</span> 枚举类（含业务方法）→ <span class="badge-gray">Enum 模式</span> 继承 AbstractJunitNoDependenciesTest</div>
+          <div class="tree-item"><span style="color:#7c3aed">●</span> 工具类 XxxUtil/XxxUtils → <span class="badge-gray">Utils 模式</span> 继承 BaseTest</div>
+        </div>
+      </div>
+      <div class="module-card">
+        <div class="module-title"><span class="badge-blue">&lt;模块组&gt;-business</span> &nbsp; 业务帮助类</div>
+        <div class="module-meta">XxxHelper / XxxService → Business Helper 模式，继承 BaseTest 或 AbstractJunitNoDependenciesResManagerTest</div>
+      </div>
+      <div class="module-card">
+        <div class="module-title"><span class="badge-orange">&lt;模块组&gt;-opplugin</span> &nbsp; 操作插件工程</div>
+        <div class="tree-sub">
+          <div class="tree-item"><span style="color:#d97706">●</span> Validator → <span class="badge-gray">Validator 模式</span></div>
+          <div class="tree-item"><span style="color:#d97706">●</span> AbstractOperationServicePlugIn → <span class="badge-gray">OpPlugin 模式</span></div>
+          <div class="tree-item"><span style="color:#d97706">●</span> ConvertPlugin/BotpPlugin → <span class="badge-gray">ConvertPlugin 模式</span></div>
+        </div>
+      </div>
+      <div class="module-card">
+        <div class="module-title"><span class="badge-green">&lt;模块组&gt;-formplugin</span> &nbsp; 表单插件工程</div>
+        <div class="module-meta">继承 AbstractFormPlugin/ListPlugin/BillPlugin → FormPlugin 模式，优先继承 BasePluginTest&lt;T&gt;</div>
+      </div>
+    </div>
+  </div>
+  <!-- Step 0.5 Author + Step 1 分析 -->
+  <div class="grid-2">
+    <div class="card">
+      <h2>👤 Step 0.5 — 获取 Author 信息（三级优先级）</h2>
+      <div class="rule-item">
+        <span class="rule-icon">1️⃣</span>
+        <div class="rule-text"><strong>缓存文件</strong> <span>— 读取 <code>.qoder/skills/cosmic-unittest/author-cache.json</code>，若 author 非空直接使用，跳过 git 命令</span></div>
+      </div>
+      <div class="rule-item">
+        <span class="rule-icon">2️⃣</span>
+        <div class="rule-text"><strong>git config</strong> <span>— 缓存不存在或 author 为空时，执行 <code>git config user.name</code> + <code>git config user.email</code>，读取成功后写入缓存</span></div>
+      </div>
+      <div class="rule-item">
+        <span class="rule-icon">3️⃣</span>
+        <div class="rule-text"><strong>询问用户</strong> <span>— git config 读取失败时，主动询问用户提供姓名和邮箱，填入缓存</span></div>
+      </div>
+      <div class="ok-box" style="margin-top:10px;">
+        <strong>格式规范：</strong><code>&lt;name&gt; &lt;&lt;name&gt;@kingdee.com&gt;</code><br>
+        例如：<code>zhang_san &lt;zhang_san@kingdee.com&gt;</code>
+      </div>
+      <div class="warn-box">
+        首次写入 <code>author-cache.json</code> 后，检查 <code>.gitignore</code> 是否已包含该文件的忽略规则，避免个人信息提交到 git。
+      </div>
+    </div>
+    <div class="card">
+      <h2>🔍 Step 1 — 分析被测类</h2>
+      <div class="rule-item">
+        <span class="rule-icon">1️⃣</span>
+        <div class="rule-text"><strong>读取完整源码</strong> <span>— 识别所有 public/protected 方法</span></div>
+      </div>
+      <div class="rule-item">
+        <span class="rule-icon">2️⃣</span>
+        <div class="rule-text"><strong>依赖识别</strong> <span>— 静态方法（MockedStatic）、外部服务、DynamicObject 结构</span></div>
+      </div>
+      <div class="rule-item">
+        <span class="rule-icon">3️⃣</span>
+        <div class="rule-text"><strong>分支识别</strong> <span>— switch 分支 / if-else 判断分支（用于 Step 3 拆分策略）</span></div>
+      </div>
+      <div class="rule-item">
+        <span class="rule-icon">4️⃣</span>
+        <div class="rule-text"><strong>Bug 审查</strong> <span>— 边界方向错误、空指针风险、逻辑取反、计算错误、集合遗漏</span></div>
+      </div>
+      <div class="rule-item" style="background:#eff6ff;border-radius:6px;padding:8px;">
+        <span class="rule-icon">⚡</span>
+        <div class="rule-text"><strong>v1.4 并行全量读取</strong> <span>— 常量类 + BaseTest + pattern + 关联类方法签名，同一轮并行拿齐</span></div>
+      </div>
+      <div class="rule-item" style="background:#eff6ff;border-radius:6px;padding:8px;">
+        <span class="rule-icon">⚡</span>
+        <div class="rule-text"><strong>v1.4 智能 Mock 推断</strong> <span>— 从 import 自动匹配「import → Mock 映射表」，规则驱动取代经验驱动</span></div>
+      </div>
+      <div class="warn-box">
+        <strong>强制输出：</strong>分析完成后必须输出「被测逻辑分析」摘要（含 Bug 检查结论），<strong>不得跳过直接给代码</strong>。<br>
+        发现 Bug → 测试断言反映正确预期（让测试失败暴露 Bug）+ 注释 <code>// ⚠️ BUG: ...</code> + 告知用户。
+      </div>
+    </div>
+  </div>
+  <!-- Step 2 编写规则 -->
+  <div class="full-width">
+    <p class="section-title">Step 2 — 编写测试类</p>
+    <div class="grid-2">
+      <div class="card">
+        <h2>⚙️ 2.1 通用编写规则</h2>
+        <table>
+          <thead><tr><th>规则</th><th>说明</th></tr></thead>
+          <tbody>
+            <tr><td>测试框架</td><td>JUnit 4（<code>@Test</code> / <code>@Before</code> / <code>@After</code>）</td></tr>
+            <tr><td>Mock 框架</td><td>Mockito 2.x + <code>MockedStatic</code></td></tr>
+            <tr><td><strong>Mockito 静态导入</strong></td><td>❌ 禁用通配符 <code>import static ...ArgumentMatchers.*</code><br>✅ 必须显式逐个导入：<code>any</code> / <code>anyBoolean</code> / <code>anyInt</code> / <code>anyLong</code> / <code>anyString</code> / <code>eq</code> / <code>isNull</code>（ArgumentMatchers）；<code>atLeastOnce</code> / <code>mock</code> / <code>never</code> / <code>verify</code> / <code>when</code>（Mockito）</td></tr>
+            <tr><td>数据构造</td><td><code>DynamicObjectMocker</code> 链式 <code>.add(key, value)</code></td></tr>
+            <tr><td>基类选择</td><td>无 ResManager → <code>AbstractJunitNoDependenciesTest</code><br>有 ResManager → <code>AbstractJunitNoDependenciesResManagerTest</code><br>多依赖 → 继承工程 <code>BaseTest</code></td></tr>
+            <tr><td>反射工具</td><td><code>ReflectHelper.invokeProtectedMethod()</code><br><code>ReflectHelper.invokeStaticMethod()</code></td></tr>
+            <tr><td>资源释放</td><td>所有 MockedStatic 必须在 <code>@After</code> 中 <code>.close()</code></td></tr>
+            <tr><td>注解要求</td><td>每个 <code>@Test</code> 方法<strong>必须</strong>加 <code>@UnittestCaseInfo</code> 和 <code>@DisplayName</code></td></tr>
+            <tr><td><strong>断言质量</strong></td><td>❌ 禁止假断言（<code>assertTrue(true)</code> 等）<br>❌ 禁止无断言测试方法<br>✅ 每个 @Test 至少一条有效 assert/verify</td></tr>
+            <tr><td>switch 策略</td><td>每个 case 必须拆为<strong>独立测试方法</strong></td></tr>
+            <tr><td>if/else 覆盖</td><td>尽量覆盖所有条件组合（笛卡尔积），可合并到同一方法</td></tr>
+            <tr><td>常量/枚举引用</td><td>找不到时<strong>主动告知用户</strong>，<strong>禁止字面值替代</strong></td></tr>
+            <tr style="background:#eff6ff;"><td><strong>⚡ BaseTest Mock 去重</strong></td><td>不得重复声明 BaseTest 已预置的 MockedStatic，仅声明「候选 Mock 类 - BaseTest 已预置」的<strong>差集</strong><br>@Before 中先 <code>super.before()</code> 再初始化自有 Mock</td></tr>
+          </tbody>
+        </table>
+      </div>
+      <div class="card">
+        <h2>📝 2.2 @UnittestCaseInfo 注解规范</h2>
+        <pre><span class="ann">@UnittestCaseInfo</span>(
+    <span class="str">author</span> = <span class="str">"&lt;name&gt; &lt;&lt;name&gt;@kingdee.com&gt;"</span>,
+    <span class="cmt">// git config user.name 拼接邮箱</span>
+    <span class="str">title</span> = <span class="str">"英文标题（简短描述测试目的）"</span>,
+    <span class="str">targetClass</span> = <span class="str">"被测类全限定名"</span>,
+    <span class="str">targetMethod</span> = <span class="str">"被测方法名（小写）"</span>,
+    <span class="str">lastUpdateTime</span> = <span class="str">"yyyy-MM-dd HH:mm:ss"</span>,
+    <span class="str">lastUpdateAuthor</span> = <span class="str">"&lt;name&gt; &lt;&lt;name&gt;@kingdee.com&gt;"</span>,
+    <span class="str">methodSignature</span> = <span class="str">"被测方法完整签名"</span>,
+    <span class="str">testPoints</span> = {<span class="str">"Functionality"</span>},
+    <span class="str">description</span> = <span class="str">"英文描述"</span>
+)</pre>
+        <h3>2.3 测试方法注释规范</h3>
+        <pre><span class="ann">@Test</span>
+<span class="ann">@DisplayName</span>(<span class="str">"中文描述：测试场景说明"</span>)
+<span class="kw">public void</span> <span class="cls">testMethodName_ScenarioDescription</span>() {
+    <span class="cmt">//step 准备测试数据 / 构建 Mock</span>
+    ...
+    <span class="cmt">//step 执行被测方法</span>
+    ...
+    <span class="cmt">//assert 断言结果</span>
+    ...
+    reset(); <span class="cmt">// 如有 reset 方法</span>
+}</pre>
+        <div style="margin-top:10px;font-size:12px;color:#586069;">
+          <code>DisplayName</code> 来自 <code>kd.bos.form.unittest.DisplayName</code>（非 org.junit.DisplayName）
+        </div>
+      </div>
+    </div>
+  </div>
+  <!-- Step 2 特殊Mock -->
+  <div class="full-width">
+    <div class="grid-3">
+      <div class="card">
+        <h2>🔧 2.4–2.5 MockedStatic &amp; DynamicObjectMocker</h2>
+        <h3>MockedStatic 生命周期</h3>
+        <pre><span class="cmt">// 成员变量声明</span>
+<span class="cls">MockedStatic</span>&lt;<span class="cls">XxxHelper</span>&gt; xxxHelper;
+<span class="ann">@Before</span>
+<span class="kw">public void</span> before() {
+    xxxHelper = mockStatic(<span class="cls">XxxHelper</span>.class);
+}
+<span class="ann">@After</span>
+<span class="kw">public void</span> after() {
+    xxxHelper.close(); <span class="cmt">// 必须关闭！</span>
+}
+<span class="kw">public void</span> reset() {
+    xxxHelper.reset();
+}</pre>
+        <h3 style="margin-top:12px;">DynamicObjectMocker 链式构造</h3>
+        <pre><span class="cmt">// 简单对象</span>
+<span class="cls">DynamicObject</span> obj = <span class="kw">new</span> <span class="cls">DynamicObjectMocker</span>()
+    .add(<span class="str">"id"</span>, <span class="num">1L</span>)
+    .add(<span class="str">"billno"</span>, <span class="str">"TEST-001"</span>)
+    .getObject();
+<span class="cmt">// 分录集合（用 getCollection）</span>
+<span class="cls">DynamicObject</span> bill = <span class="kw">new</span> <span class="cls">DynamicObjectMocker</span>()
+    .add(<span class="str">"entryentity"</span>, <span class="kw">new</span> <span class="cls">DynamicObjectMocker</span>()
+        .add(<span class="str">"qty"</span>, <span class="cls">BigDecimal</span>.TEN)
+        .getCollection())
+    .getObject();</pre>
+      </div>
+      <div class="card">
+        <h2>⚠️ 2.6 DB 类特殊 Mock（ClassPool Defrost）</h2>
+        <p style="font-size:12px;color:#586069;margin-bottom:8px;">DB 类存在字节码冻结问题，mock 前必须先执行 defrost 处理：</p>
+        <pre><span class="ann">@Before</span>
+<span class="kw">public void</span> before() {
+    <span class="kw">try</span> {
+        <span class="cls">CtClass</span> cls = <span class="cls">ClassPool</span>.getDefault()
+            .get(<span class="cls">DB</span>.class.getName());
+        <span class="kw">if</span> (cls.isFrozen()) {
+            cls.defrost();
+        }
+    } <span class="kw">catch</span> (<span class="cls">Exception</span> e) {}
+    dbMocked = <span class="cls">Mockito</span>.mockStatic(<span class="cls">DB</span>.class);
+}</pre>
+        <h2 style="margin-top:16px;">⚠️ 2.7 ProcessSettleHelper 特殊 Mock</h2>
+        <p style="font-size:12px;color:#586069;margin-bottom:8px;">含分布式缓存，不可直接 mockStatic：</p>
+        <pre><span class="cls">MockedStatic</span>&lt;<span class="cls">ProcessSettleHelper</span>&gt; mock =
+    <span class="cls">ProcessSettleMockHelper</span>
+        .mockDistributeSessionlessCache();</pre>
+        <div class="warn-box">
+          在<strong>当前被测类所属工程</strong>的 <code>src/test/java/</code> 下查找 <code>ProcessSettleMockHelper</code>。找不到则主动告知用户在对应工程 test 目录下添加。
+        </div>
+      </div>
+      <div class="card">
+        <h2>🏗️ 2.8–2.10 高级 Mock 技巧</h2>
+        <h3>MockedConstruction（Mock 构造函数）</h3>
+        <pre><span class="ann">@Test</span>
+<span class="kw">public void</span> testMethod() {
+  <span class="kw">try</span> (<span class="cls">MockedConstruction</span>&lt;<span class="cls">PushArgs</span>&gt; m =
+       <span class="cls">Mockito</span>.mockConstruction(<span class="cls">PushArgs</span>.class)) {
+    <span class="cls">SomeUtil</span>.doSomething(params);
+    assertEquals(<span class="num">1</span>, m.constructed().size());
+  } <span class="cmt">// 自动关闭</span>
+}</pre>
+        <h3>thenAnswer 动态返回</h3>
+        <pre>helper.when(() -> <span class="cls">QueryServiceHelper</span>
+    .query(anyString(), anyString(), any()))
+  .thenAnswer(inv -> {
+    <span class="cls">String</span> entity = inv.getArgument(<span class="num">0</span>);
+    <span class="kw">if</span> (<span class="str">"mmc_plan"</span>.equals(entity))
+      <span class="kw">return</span> mockPlanData();
+    <span class="kw">return new</span> <span class="cls">DynamicObjectCollection</span>();
+  });</pre>
+        <h3>DynamicObject 断言规范</h3>
+        <table>
+          <thead><tr><th>方法</th><th>默认值</th><th>断言</th></tr></thead>
+          <tbody>
+            <tr><td><code>getString()</code></td><td><code>""</code></td><td><code>assertEquals("", ...)</code></td></tr>
+            <tr><td><code>getLong()</code></td><td><code>0L</code></td><td><code>assertEquals(0L, ...)</code></td></tr>
+            <tr><td><code>getBigDecimal()</code></td><td><code>ZERO</code></td><td><code>assertEquals(ZERO, ...)</code></td></tr>
+            <tr><td><code>getBoolean()</code></td><td><code>false</code></td><td><code>assertFalse(...)</code></td></tr>
+            <tr><td><code>getDate()</code></td><td><strong>可能 null</strong></td><td><code>assertNull(...)</code></td></tr>
+          </tbody>
+        </table>
+      </div>
+    </div>
+  </div>
+  <!-- Step 3 测试场景 -->
+  <div class="full-width">
+    <p class="section-title">Step 3 — 测试场景设计</p>
+    <div class="grid-2">
+      <div class="card">
+        <h2>🎯 场景类型与边界值要求</h2>
+        <table>
+          <thead><tr><th>场景类型</th><th>说明</th></tr></thead>
+          <tbody>
+            <tr><td><span class="badge-green">正常路径</span></td><td>标准输入，预期正常输出</td></tr>
+            <tr><td><span class="badge-orange">边界条件</span></td><td>空值 / 空集合 / 零值</td></tr>
+            <tr><td><span class="badge-red">⭐ 边界值（重点）</span></td><td>比较运算符临界点，必须覆盖「刚好满足」和「刚好不满足」两侧</td></tr>
+            <tr><td><span class="badge-blue">异常路径</span></td><td>查询返回 null、抛异常</td></tr>
+            <tr><td><span class="badge-purple">业务规则</span></td><td>特定业务条件分支</td></tr>
+          </tbody>
+        </table>
+        <h3 style="margin-top:12px;">边界值覆盖要求</h3>
+        <table>
+          <thead><tr><th>运算符</th><th>必须覆盖的值</th></tr></thead>
+          <tbody>
+            <tr><td><code>&gt; 0</code></td><td>等于0（不通过）、大于0（通过）</td></tr>
+            <tr><td><code>&gt;= 0</code></td><td>等于0（通过）、小于0（不通过）</td></tr>
+            <tr><td><code>compareTo &gt; 0</code></td><td>a==b（不通过）、a&gt;b（通过）、a&lt;b（不通过）</td></tr>
+            <tr><td><code>size() &gt; N</code></td><td>size==N（不通过）、size==N+1（通过）</td></tr>
+            <tr><td><code>isEmpty()</code></td><td>空集合、恰好1条、多条</td></tr>
+          </tbody>
+        </table>
+      </div>
+      <div class="card">
+        <h2>🌿 switch / if-else 分支拆分策略</h2>
+        <table>
+          <thead><tr><th>分支类型</th><th>拆分规则</th></tr></thead>
+          <tbody>
+            <tr><td><strong>switch 分支</strong></td><td>每个 case <strong>必须</strong>定义为独立测试方法<br><code>testPropertyChanged_CaseFieldA()</code></td></tr>
+            <tr><td>switch case 内部多场景</td><td>允许在同一方法中测试（过复杂时可进一步拆分）</td></tr>
+            <tr><td><strong>if/else 判断</strong></td><td>覆盖所有条件组合（笛卡尔积），可合并到同一方法</td></tr>
+            <tr><td>关联方法的分支</td><td>被测方法调用的其他方法中的分支也需覆盖</td></tr>
+          </tbody>
+        </table>
+        <h3 style="margin-top:14px;">Step 4 — 验证与运行</h3>
+        <div class="rule-item">
+          <span class="rule-icon">✅</span>
+          <div class="rule-text"><strong>静态分析</strong> <span>import 完整 / MockedStatic 全部关闭 / 方法命名清晰 / 常量引用正确 / <strong style="color:#0366d6">BaseTest 未重复声明（v1.4）</strong> / <strong style="color:#0366d6">super.before() 在前（v1.4）</strong></span></div>
+        </div>
+        <div class="rule-item">
+          <span class="rule-icon">▶️</span>
+          <div class="rule-text"><strong>Gradle 运行前快速判断</strong> <span>— 先检查 ① biz lib 中被测模块 jar 是否存在 ② config.gradle 中 biz 路径是否真实存在；任一失败 → 直接跳过 Gradle，提示用户 IDE 运行（节省 ~8min）</span></div>
+        </div>
+        <div class="rule-item">
+          <span class="rule-icon">▶️</span>
+          <div class="rule-text"><strong>Gradle 运行</strong> <span>（将 <code>&lt;模块组&gt;</code> 替换为实际前缀）</span></div>
+        </div>
+        <pre style="margin-top:6px;">gradle :&lt;模块组&gt;-common:test
+gradle :&lt;模块组&gt;-business:test
+gradle :&lt;模块组&gt;-opplugin:test
+gradle :&lt;模块组&gt;-formplugin:test
+<span class="cmt"># 例如 mmc-sfc 模块：</span>
+gradle :mmc-sfc-business:test</pre>
+      </div>
+    </div>
+  </div>
+  <!-- BaseTest 差异对比 -->
+  <div class="full-width">
+    <p class="section-title">BaseTest 差异对比</p>
+    <div class="grid-2">
+      <div class="card">
+        <h2>📋 通用 BaseTest 发现规则</h2>
+        <p style="font-size:12px;color:#586069;margin-bottom:10px;"><strong>实际使用时必须先读取目标工程的 BaseTest 源码</strong>，确认其预置了哪些 MockedStatic。</p>
+        <table>
+          <thead><tr><th>工程</th><th>BaseTest 包名规律</th><th>查找路径</th></tr></thead>
+          <tbody>
+            <tr><td><code>&lt;模块组&gt;-common</code></td><td><code>kd.&lt;包路径&gt;.common.BaseTest</code></td><td><code>&lt;模块组&gt;-common/src/test/.../BaseTest.java</code></td></tr>
+            <tr><td><code>&lt;模块组&gt;-business</code></td><td><code>kd.&lt;包路径&gt;.business.BaseTest</code></td><td><code>&lt;模块组&gt;-business/src/test/.../BaseTest.java</code></td></tr>
+            <tr><td><code>&lt;模块组&gt;-opplugin</code></td><td><code>kd.&lt;包路径&gt;.opplugin.BaseTest</code></td><td><code>&lt;模块组&gt;-opplugin/src/test/.../BaseTest.java</code></td></tr>
+            <tr><td><code>&lt;模块组&gt;-formplugin</code></td><td><code>kd.&lt;包路径&gt;.formplugin.BasePluginTest</code></td><td><code>&lt;模块组&gt;-formplugin/src/test/.../BasePluginTest.java</code></td></tr>
+          </tbody>
+        </table>
+      </div>
+      <div class="card">
+        <h2>🔖 mmc-sfc 模块已知预置 Mock（参考）</h2>
+        <p style="font-size:12px;color:#586069;margin-bottom:8px;">三个工程（common/business/opplugin）共同预置 8 个 MockedStatic：OrgUnitServiceHelper、BillTypeParamHelper、ResManager、SystemParamServiceHelper、QueryServiceHelper、BusinessDataServiceHelper、OperationServiceHelper、BaseDataServiceHelper。</p>
+        <table>
+          <thead><tr><th>工程</th><th>额外预置 Mock</th></tr></thead>
+          <tbody>
+            <tr><td>mmc-sfc-common</td><td>SaveServiceHelper + EntityMetadataCache</td></tr>
+            <tr><td>mmc-sfc-business</td><td>SaveServiceHelper + IDataModel/IFormView；BillUnitAndQtytHelper（仅声明未初始化）</td></tr>
+            <tr><td>mmc-sfc-opplugin</td><td>Singleton + BFTrackerServiceHelper + MutexUtils</td></tr>
+            <tr><td>mmc-sfc-formplugin</td><td>BasePluginTest&lt;T&gt; 独立管理，以实际文件为准</td></tr>
+          </tbody>
+        </table>
+      </div>
+    </div>
+  </div>
+  <!-- 常用 Mock 清单 -->
+  <div class="full-width">
+    <p class="section-title">常用 Mock 静态类清单</p>
+    <div class="card">
+      <table>
+        <thead><tr><th>静态类</th><th>用途</th><th>常见 Mock 方式</th><th>特殊要求</th></tr></thead>
+        <tbody>
+          <tr><td><code>QueryServiceHelper</code></td><td>数据库查询</td><td><code>.when(() -&gt; query(...)).thenReturn(...)</code></td><td>—</td></tr>
+          <tr><td><code>BusinessDataServiceHelper</code></td><td>业务数据加载</td><td><code>.when(() -&gt; loadSingle/load/loadFromCache(...)).thenReturn(...)</code></td><td>—</td></tr>
+          <tr><td><code>OperationServiceHelper</code></td><td>操作执行</td><td><code>.when(() -&gt; executeOperate(...)).thenReturn(opResult)</code></td><td>—</td></tr>
+          <tr><td><code>SaveServiceHelper</code></td><td>数据保存</td><td><code>.when(() -&gt; save/update(...)).thenReturn(...)</code></td><td>—</td></tr>
+          <tr><td><code>BaseDataServiceHelper</code></td><td>基础资料</td><td><code>.when(() -&gt; getBaseDataFromCache(...)).thenReturn(...)</code></td><td>—</td></tr>
+          <tr><td><code>ResManager</code></td><td>多语言资源</td><td><code>.thenAnswer(inv -&gt; inv.getArgument(0))</code></td><td>—</td></tr>
+          <tr><td><code>EntityMetadataCache</code></td><td>元数据缓存</td><td>直接 mockStatic</td><td>common 工程常用</td></tr>
+          <tr><td><code>CacheFactory</code></td><td>缓存工厂</td><td>Mock getCommonCacheFactory 链式调用</td><td>—</td></tr>
+          <tr><td><code>ConvertServiceHelper</code></td><td>BOTP 转换</td><td>Mock push/convert 方法</td><td>—</td></tr>
+          <tr><td><code>DB</code>（kd.bos.db.DB）</td><td>数据库操作</td><td>mockStatic</td><td style="color:#dc2626;font-weight:600;">必须先 ClassPool defrost（见 2.6）</td></tr>
+          <tr><td><code>ProcessSettleHelper</code></td><td>工序结算</td><td><code>ProcessSettleMockHelper.mockDistributeSessionlessCache()</code></td><td style="color:#dc2626;font-weight:600;">禁止直接 mockStatic（见 2.7）</td></tr>
+        </tbody>
+      </table>
+    </div>
+  </div>
+  <!-- 高频混淆场景 -->
+  <div class="full-width">
+    <p class="section-title">高频混淆场景速查</p>
+    <div class="card">
+      <table>
+        <thead><tr><th>场景</th><th class="x-mark">❌ 错误做法</th><th class="check-mark">✅ 正确做法</th></tr></thead>
+        <tbody>
+          <tr class="confusion-row-bad"><td>测试 protected 方法</td><td>改方法可见性为 public</td><td><code>ReflectHelper.invokeProtectedMethod()</code></td></tr>
+          <tr class="confusion-row-bad"><td>测试 private static 方法</td><td>跳过或改可见性</td><td><code>ReflectHelper.invokeStaticMethod()</code></td></tr>
+          <tr class="confusion-row-bad"><td>校验器收集错误</td><td>直接 validate 不收集</td><td>匿名子类重写 <code>addMessage/addErrorMessage</code> 收集到 List</td></tr>
+          <tr class="confusion-row-bad"><td>POJO 测试用 Mock</td><td>给纯 POJO 加 MockedStatic</td><td>直接 <code>new</code> 对象，无需任何 Mock</td></tr>
+          <tr class="confusion-row-bad"><td>断言写法</td><td><code>assertTrue(true)</code> 假断言 / 测试方法无任何 assert</td><td>断言真实输出或 <code>verify()</code> 交互；提前返回用 <code>verify(mock, never()).method()</code></td></tr>
+          <tr class="confusion-row-bad"><td>Mockito 重载歧义</td><td><code>any()</code> 无法区分重载</td><td>显式指定 <code>any(DynamicObject.class)</code></td></tr>
+          <tr class="confusion-row-bad"><td><strong>any() 类型歧义</strong></td><td><code>any()</code> 用于 Date/Set/String 等具体类型参数</td><td>必须明确类型：<code>any(Date.class)</code>、<code>any(Set.class)</code>、<code>anyString()</code>；<code>any()</code> 仅在参数类型为 Object 且无歧义时使用</td></tr>
+          <tr class="confusion-row-bad"><td>varargs 参数匹配</td><td><code>any(String[].class)</code></td><td><code>anyString()</code>（varargs 专用）</td></tr>
+          <tr class="confusion-row-bad"><td>DynamicObjectCollection 状态</td><td><code>new DynamicObjectCollection().add()</code> 后 isEmpty/size 不可靠</td><td><code>mock(DynamicObjectCollection.class)</code> + 显式 stub</td></tr>
+          <tr class="confusion-row-bad"><td>点分隔字段名</td><td><code>DynamicObjectMocker.add("a.b", v)</code> 后 <code>getLong("a.b")</code> 抛 ORMDesignException</td><td>平展查询结果用 <code>mock(DynamicObject.class)</code> + <code>when().thenReturn()</code></td></tr>
+          <tr class="confusion-row-bad"><td>Mock DB 类</td><td>直接 <code>mockStatic(DB.class)</code></td><td>先执行 ClassPool defrost（见 2.6）</td></tr>
+          <tr class="confusion-row-bad"><td>常量/枚举引用不到</td><td>用字面值 <code>"A"</code> 替代</td><td><strong>禁止字面值替代</strong>，主动告知用户补充</td></tr>
+          <tr class="confusion-row-bad"><td>DynamicObject 空值断言</td><td><code>assertNull(obj.getString("field"))</code></td><td><code>getString()</code>/<code>getLong()</code>/<code>getInt()</code>/<code>getBigDecimal()</code>/<code>getBoolean()</code> 平台默认不返回 null（即使 set null 也转为基本值）：空字符串用 <code>assertEquals("", obj.getString(...))</code>、空数值用 <code>assertEquals(0L, obj.getLong(...))</code>、空 BigDecimal 用 <code>assertEquals(BigDecimal.ZERO, ...)</code>、布尔用 <code>assertFalse(obj.getBoolean(...))</code>。<br>若被测代码对 getter 结果做 <code>null</code> 检查（如 <code>if (obj.getBigDecimal("qty") != null)</code>），说明字段可能开启「允许为空」，测试必须覆盖 null 和非 null 两分支；无法判断时默认按非 null，在测试方法中加注释 <code>// 假设字段未开启"允许为空"，若实际可为 null 请告知</code>。<br><code>getDate(key)</code> 是例外，始终可能为 null，用 <code>assertNull</code> 或具体日期值断言。</td></tr>
+          <tr class="confusion-row-bad"><td><strong>DynamicObjectMocker + .set()</strong></td><td>被测代码调 <code>dataEntity.set(field, v)</code>，dataEntity 由 DynamicObjectMocker 创建</td><td>改用 <code>mock(DynamicObject.class)</code> + stub，<code>.set()</code> 在 mock 对象上是空操作，不抛 ORMDesignException</td></tr>
+        </tbody>
+      </table>
+    </div>
+  </div>
+  <!-- 各模式快速参考 -->
+  <div class="full-width">
+    <p class="section-title">各测试模式快速参考</p>
+    <div class="grid-2">
+      <div class="card">
+        <h2>📦 common 模块 — POJO 模式</h2>
+        <pre><span class="kw">public class</span> <span class="cls">XxxModelTest</span> {
+    <span class="kw">private</span> <span class="cls">XxxModel</span> model;
+    <span class="ann">@Before</span>
+    <span class="kw">public void</span> setUp() { model = <span class="kw">new</span> <span class="cls">XxxModel</span>(); }
+    <span class="ann">@UnittestCaseInfo</span>(author = <span class="str">"..."</span>, ...)
+    <span class="ann">@Test</span>
+    <span class="kw">public void</span> testGetSetFieldName() {
+        model.setFieldName(<span class="str">"value"</span>);
+        assertEquals(<span class="str">"value"</span>, model.getFieldName());
+    }
+    <span class="ann">@Test</span>
+    <span class="kw">public void</span> testDefaultValues() {
+        <span class="cmt">// 输出字段默认为 ZERO，输入字段默认 null</span>
+        assertEquals(<span class="cls">BigDecimal</span>.ZERO, model.getAmount());
+        assertNull(model.getFormId());
+    }
+}</pre>
+      </div>
+      <div class="card">
+        <h2>🏭 business 模块 — Helper 模式</h2>
+        <pre><span class="kw">public class</span> <span class="cls">XxxHelperTest</span>
+    <span class="kw">extends</span> <span class="cls">AbstractJunitNoDependenciesResManagerTest</span> {
+    <span class="cls">MockedStatic</span>&lt;<span class="cls">QueryServiceHelper</span>&gt; qsh;
+    <span class="ann">@Before</span> <span class="kw">public void</span> before() {
+        qsh = mockStatic(<span class="cls">QueryServiceHelper</span>.class);
+    }
+    <span class="ann">@After</span> <span class="kw">public void</span> after() { qsh.close(); }
+    <span class="ann">@UnittestCaseInfo</span>(...)
+    <span class="ann">@Test</span>
+    <span class="ann">@DisplayName</span>(<span class="str">"正常路径"</span>)
+    <span class="kw">public void</span> testMethod_NormalCase() {
+        qsh.when(() -> <span class="cls">QueryServiceHelper</span>.query(...))
+            .thenReturn(mockData);
+        <span class="cls">Object</span> result = <span class="cls">XxxHelper</span>.method(param);
+        assertNotNull(result);
+        reset();
+    }
+}</pre>
+      </div>
+    </div>
+    <div class="grid-2" style="margin-top:20px;">
+      <div class="card">
+        <h2>🔒 opplugin — Validator 模式</h2>
+        <pre><span class="kw">public class</span> <span class="cls">XxxValidatorTest</span>
+    <span class="kw">extends</span> <span class="cls">AbstractJunitNoDependenciesResManagerTest</span> {
+    <span class="kw">private final</span> List&lt;String&gt; errors = <span class="kw">new</span> ArrayList&lt;&gt;();
+    <span class="kw">private</span> <span class="cls">XxxValidator</span> buildValidator() {
+        <span class="kw">return new</span> <span class="cls">XxxValidator</span>() {
+            <span class="ann">@Override</span>
+            <span class="kw">protected void</span> addErrorMessage(
+                <span class="cls">ExtendedDataEntity</span> e, <span class="cls">String</span> msg) {
+                errors.add(msg);
+            }
+        };
+    }
+    <span class="ann">@Test</span>
+    <span class="kw">public void</span> testValidate_ShouldPass() {
+        <span class="cls">XxxValidator</span> v = buildValidator();
+        v.setDataEntities(buildData());
+        v.validate();
+        assertEquals(<span class="num">0</span>, errors.size());
+    }
+}</pre>
+      </div>
+      <div class="card">
+        <h2>🖥️ formplugin — FormPlugin 模式</h2>
+        <pre><span class="kw">public class</span> <span class="cls">XxxPluginTest</span>
+    <span class="kw">extends</span> <span class="cls">BasePluginTest</span>&lt;<span class="cls">XxxPlugin</span>&gt; {
+    <span class="kw">private</span> <span class="cls">MockedStatic</span>&lt;<span class="cls">SomeHelper</span>&gt; someHelper;
+    <span class="ann">@Before</span> <span class="kw">public void</span> before() {
+        someHelper = mockStatic(<span class="cls">SomeHelper</span>.class);
+    }
+    <span class="ann">@After</span> <span class="kw">public void</span> after() {
+        someHelper.close();
+    }
+    <span class="cmt">// switch 每个 case 独立方法</span>
+    <span class="ann">@Test</span>
+    <span class="kw">public void</span> testPropertyChanged_CaseMaterialId() { ... }
+    <span class="ann">@Test</span>
+    <span class="kw">public void</span> testPropertyChanged_CaseQty() { ... }
+}</pre>
+      </div>
+    </div>
+  </div>
+  <div style="text-align:center;padding:20px 0 10px;color:#9ca3af;font-size:12px;">
+    cosmic-unittest v1.4 &nbsp;·&nbsp; 适用于 common / business / opplugin / formplugin 四工程结构的苍穹模块 &nbsp;·&nbsp; 6 项性能优化
+  </div>
+</div>
+</body>
+</html>