更新示例代码实现

Author: hobobo

.cursor/rules/project-positioning.mdc

@@ -7,7 +7,7 @@ alwaysApply: true
 
 ## 工程概述
 
-AbilityKit 是一个**生产级 MOBA 游戏技能框架**，具备完整的技术架构和跨平台能力。
+AbilityKit 是一个**完整 MOBA 游戏技能框架**，具备完整的技术架构和跨平台能力。
 
 ### 核心技术能力
 
@@ -271,7 +271,7 @@ Console Demo 必须实现与生产环境相同的架构模式：
 
 | 维度 | 定位 |
 |------|------|
-| **工程类型** | 生产级 MOBA 游戏技能框架 |
+| **工程类型** | 完整 MOBA 游戏技能框架 |
 | **核心能力** | 帧同步、状态同步、回放、跨平台 |
 | **Console Demo** | 功能完整的帧同步验证环境 |
 | **架构原则** | 四层架构、单向依赖、跨平台优先 |

Docs/MobaAcceptanceScenarioDSLGuide.md

@@ -22,8 +22,9 @@
 - 支持 actor alias 到 actorId/playerId 的映射。
 - 支持时间轴按 `atMs` 驱动技能输入与等待。
 - 输入模型支持 actor、target、position、direction、phase、slot。
+- `setupActions` 已接入测试工程内命令执行器，支持第一阶段环境准备命令：`spawn_actor`、`set_attr`、`move_to`、`add_buff`、`remove_buff`、`wait` / `tick`。
 - trace exporter 会输出 scenario 相关字段，便于后续报告工具读取。
-- assertion 支持 trace/state/context 三类断言。
+- assertion 支持 trace/state/context 三类断言，并支持基础 buff 状态断言。
 - `AbilityKit.Game.UnitTests.csproj` 已通过编译验证。
 
 ## 3. 推荐测试文件组织
@@ -40,6 +41,7 @@ Unity/Packages/com.abilitykit.demo.moba.view.runtime/Runtime/Game/Test/
   UnitTest/
     MobaAcceptanceModels.cs
     MobaAcceptanceRunner.cs
+    MobaAcceptanceSetupActionExecutor.cs
     MobaAcceptanceExpectationAssert.cs
     MobaAcceptanceTraceExporter.cs
     MobaSkillConfigTestHarness.cs
@@ -118,32 +120,47 @@ Unity/Packages/com.abilitykit.demo.moba.view.runtime/Runtime/Game/Test/
 
 ## 6. SetupActions 约定
 
-`setupActions` 用于进入游戏后、timeline 执行前做一次性准备。
+`setupActions` 用于进入游戏后、timeline 执行前做一次性准备。第一阶段命令只放在测试工程内执行：runner 负责识别 setup action，`MobaAcceptanceSetupActionExecutor` 负责分发命令，实际运行时变更继续委托 `MobaSkillConfigTestHarness` 与正式 runtime service。
 
-当前建议先保持轻量，主要用于：
+当前支持命令：
 
-- 等待若干 tick/ms。
-- 未来扩展：加 buff、改属性、移动 actor、生成召唤物、设置 CD、设置资源。
+| action | 语义 | 常用字段 |
+|---|---|---|
+| `wait` / `tick` | 推进测试世界时间 | `durationMs` |
+| `spawn_actor` | 生成测试场景 actor / 召唤物 / 特殊实体，并注册 alias | `alias`、`kind`、`teamId`、`heroId`、`attributeTemplateId`、`unitSubType`、`mainType`、`sourceAlias`、`sourceKind`、`position` |
+| `set_attr` | 修改 actor 属性 | `actorAlias`、`actorId`、`targetActorId`、`property`、`value` / `intValue` |
+| `move_to` | 移动 actor 到指定位置 | `actorAlias`、`actorId`、`targetActorId`、`position` |
+| `add_buff` | 对 actor 应用 buff | `targetAlias`、`actorAlias`、`sourceAlias`、`buffId`、`durationOverrideMs` |
+| `remove_buff` | 从 actor 移除 buff | `targetAlias`、`actorAlias`、`sourceAlias`、`buffId`、`removeAll` |
 
 示例：
 
 ```json
 {
   "scenario": {
     "setupActions": [
-      { "action": "wait", "durationMs": 100 }
+      { "action": "wait", "durationMs": 100 },
+      { "action": "move_to", "actorAlias": "target", "position": { "x": 4, "y": 0, "z": 0 } },
+      { "action": "set_attr", "actorAlias": "target", "property": "hp", "value": 1000 },
+      { "action": "add_buff", "targetAlias": "caster", "sourceAlias": "caster", "buffId": 1, "durationOverrideMs": 5000 },
+      {
+        "action": "spawn_actor",
+        "alias": "summon_1",
+        "teamId": 1,
+        "heroId": 1,
+        "attributeTemplateId": 1001,
+        "unitSubType": 2,
+        "mainType": 1,
+        "sourceAlias": "caster",
+        "sourceKind": "Summon",
+        "position": { "x": 2, "y": 0, "z": 3 }
+      }
     ]
   }
 }
 ```
 
-后续建议把 setup action 扩展为明确命令集，而不是直接暴露 service 细节，例如：
-
-```json
-{ "action": "set_attr", "actor": "target", "property": "hp", "value": 1000 }
-{ "action": "add_buff", "actor": "caster", "buffId": 2001001 }
-{ "action": "move_to", "actor": "target", "position": { "x": 4, "y": 0, "z": 0 } }
-```
+设计边界：setup action 是验收测试 DSL，不是生产玩法脚本。不要在 JSON 中暴露 service/method 细节，也不要在 runner 中直接堆业务分支；新增命令应优先扩展测试工程内 executor/harness。
 
 ## 7. Timeline 约定
 
@@ -275,6 +292,8 @@ trace 断言用于验证技能配置链路是否执行到了关键节点。
 | `maxHp` | 最大生命值 |
 | `maxMana` | 最大法力值 |
 | `teamId` | 队伍 ID |
+| `buff` / `hasBuff` | 是否拥有指定 buff，使用 `expectedInt` 或 `expectedValue` 表示 buffId，使用 `expectedBool` 表示期望是否存在 |
+| `buffCount` | 指定 buff 数量，使用 `expectedInt` 或 `expectedValue` 表示 buffId；不传 buffId 时统计全部 active buff |
 | `position` / `transform.position` | actor 当前位置 |
 
 当前支持 comparator：
@@ -370,7 +389,7 @@ trace 断言用于验证技能配置链路是否执行到了关键节点。
 ### P0：补齐可用性
 
 - 增加一到两个真实 scenario JSON 样例。
-- 给 `setupActions` 增加 `set_attr`、`add_buff`、`move_to`。
+- `setupActions` 第一阶段命令已落地：`spawn_actor`、`set_attr`、`move_to`、`add_buff`、`remove_buff`、`wait` / `tick`。
 - trace summary 中增加失败时的 nearest records 辅助定位。
 - runner 输出更明确的 alias、actorId、timeline 当前帧日志。
 
@@ -450,8 +469,9 @@ Web 分析模型建议长期保持以下关联字段稳定：
 | 文件 | 职责 |
 |---|---|
 | `MobaAcceptanceModels.cs` | JSON DTO / scenario DSL 数据结构 |
-| `MobaSkillConfigTestHarness.cs` | headless world 创建、actor/player alias、输入提交 |
+| `MobaSkillConfigTestHarness.cs` | headless world 创建、actor/player alias、输入提交、测试环境命令底层辅助 API |
 | `MobaAcceptanceRunner.cs` | legacy/scenario 路由、setup/timeline 执行 |
+| `MobaAcceptanceSetupActionExecutor.cs` | 测试工程内 setup action 命令分发器，承载第一阶段环境准备命令 |
 | `MobaAcceptanceExpectationAssert.cs` | trace/state/context 断言 |
 | `MobaAcceptanceTraceExporter.cs` | trace 与 summary artifact 导出 |
 | `GatewaySkillAcceptanceArtifacts.cs` | Web 后台只读 artifact 扫描、case 读取、run-plan 边界描述，包含路径约束、结构化错误与常量化文件元数据 |

Docs/Shooter示例定位与完成度阶段性分析.md

@@ -8,7 +8,7 @@ Shooter 示例当前已经不再是“临时拼出来的同步样例”，而是
 - Unity 侧不只是概念设计，已经存在独立 Editor 包、窗口、SceneView 绘制和输入采集外壳。
 - 纯 C# 验收、DemoHarness、Svelto 基准、Orleans 世界管理都已经落地。
 
-但它还没有达到“生产级大规模纯状态同步方案”的完整完成度。当前最明显的缺口不在外壳，而在三条真正决定成熟度的链路：
+但它还没有达到“完整大规模纯状态同步方案”的完整完成度。当前最明显的缺口不在外壳，而在三条真正决定成熟度的链路：
 
 1. 时间锚/时钟链路已经进入 PlayMode/Remote PlayMode 步进与诊断投影，但还需要继续接入更多生产链路。
 2. 服务端回溯命中判定已经形成 runtime→host diagnostics 的可观察验收闭环，但还需要进一步挂入远程服务器链路和健康事件。

Docs/design/01-OverviewAndGettingStarted/01-WhatIsAbilityKit.md

@@ -1,6 +1,6 @@
 # 1.1 AbilityKit 是什么
 
-> 一句话了解 AbilityKit：生产级 MOBA 游戏技能框架，具备完整帧同步、网络同步、回放系统能力。
+> 一句话了解 AbilityKit：完整 MOBA 游戏技能框架，具备完整帧同步、网络同步、回放系统能力。
 
 ---
 

Docs/同步演示框架示例层重构设计.md

@@ -8,7 +8,7 @@
 
 ## 1. 背景与问题
 
-当前 Shooter 示例已经落地两种生产级同步模式（PredictRollback、AuthoritativeInterpolation），且 Moba 已复用框架的 `RemoteInterpolationPlayback<TSample>` 验证了「通用同步能力下沉框架、玩法只留 Sample/Projector」的可行性。
+当前 Shooter 示例已经落地两种完整同步模式（PredictRollback、AuthoritativeInterpolation），且 Moba 已复用框架的 `RemoteInterpolationPlayback<TSample>` 验证了「通用同步能力下沉框架、玩法只留 Sample/Projector」的可行性。
 
 但目标是把示例层做成一个**同步演示框架**：
 

Docs/网络同步框架阶段性设计.md

@@ -157,7 +157,7 @@ demo 控制器（如 `ShooterClientAuthoritativeInterpolationSyncController`）
 
 ## 6. 现状与方向
 
-已落地的两种生产级客户端能力：
+已落地的两种完整客户端能力：
 
 - **PredictRollback**：本地预测 + 权威回滚 + 对账，含漂移检测与强同步恢复。
 - **AuthoritativeInterpolation**：远端实体延迟插值播放，配置 / 诊断 / 编排全部下沉框架层。

README.md

@@ -399,7 +399,6 @@ dotnet run
 
 | 模块                                                                                                | 文档                                         |
 | ------------------------------------------------------------------------------------------------- | ------------------------------------------ |
-| [工程化测试门禁](./Docs/AbilityKit测试门禁与批量回归规范.md)                                                 | P0/P1/P2 测试门禁、批量回归、xUnit Trait 标签与 CI 接入规范 |
 | [技术选型](./Unity/Packages/技术选型文档.md)                                                                | 从零开发战斗框架的技术选型                              |
 | [Host 模块](./Unity/Packages/com.abilitykit.host.extension/Document/)                               | 游戏服务器运行时框架                                 |
 | [状态同步与预测](./Unity/Packages/com.abilitykit.world.statesync/Document/StateSyncDesign.md)            | 客户端预测、Rollback、StateHash 校验                |

Server/AdminConsole/src/components/SkillAcceptancePanel.vue

@@ -45,13 +45,25 @@
     <div class="ops-status acceptance-summary"><div><span>产物目录</span><strong>{{ admin.acceptanceBatch.value?.artifactDirectory || admin.acceptance.artifactDirectory }}</strong></div><div><span>批次摘要</span><strong>{{ admin.acceptanceBatch.value?.hasBatchSummary ? '已找到' : '缺失' }}</strong></div><div><span>通过</span><strong>{{ admin.acceptancePassedCount.value }}</strong></div><div><span>失败</span><strong>{{ admin.acceptanceFailedCount.value }}</strong></div><div><span>未知</span><strong>{{ admin.acceptanceUnknownCount.value }}</strong></div><div><span>过滤后</span><strong>{{ admin.acceptanceFilteredCases.value.length }}</strong></div></div>
     <div class="acceptance-layout">
       <div class="acceptance-case-list">
-        <h3>用例列表</h3>
-        <article v-for="item in admin.acceptanceFilteredCases.value" :key="item.caseId" class="acceptance-case" :class="{ active: item.caseId === admin.acceptance.selectedCaseId, failed: item.passed === false }" @click="admin.refreshAcceptanceCase(item.caseId)">
-          <div><strong>{{ item.caseId }}</strong><small>{{ item.description || item.worldId || item.summaryPath }}</small></div>
-          <span class="badge" :class="item.passed === false ? 'danger' : ''">{{ item.passed === false ? '失败' : item.passed === true ? '通过' : '未知' }}</span>
-          <p><span class="badge">{{ item.category || 'contract' }}</span> {{ (item.tags || []).join(' / ') || 'no-tags' }}</p>
-          <p>帧 {{ item.finalFrame }} / {{ item.finalTimeMs }}ms / 追踪 {{ item.traceNodeCount }}</p>
-          <p v-if="item.missingTraceNodes || item.missingActions || item.missingRelationships" class="muted">缺口：{{ item.missingTraceNodes || 'trace ok' }} / {{ item.missingActions || 'actions ok' }} / {{ item.missingRelationships || 'relations ok' }}</p>
+        <div class="acceptance-list-toolbar">
+          <h3>用例列表</h3>
+          <div class="actions">
+            <span class="badge">已选 {{ admin.acceptanceSelectedCount.value }}</span>
+            <button class="secondary" :disabled="admin.busy.value || !admin.acceptanceFilteredCases.value.length" @click="admin.selectAllFilteredAcceptanceCases">全选过滤结果</button>
+            <button class="secondary" :disabled="admin.busy.value || !admin.acceptanceSelectedCount.value" @click="admin.clearAcceptanceCaseSelection">清空选择</button>
+            <button class="danger" :disabled="admin.busy.value || !admin.acceptanceSelectedCount.value" @click="admin.deleteAcceptanceCases()">删除选中</button>
+            <button class="secondary" :disabled="admin.busy.value" @click="admin.refreshAcceptanceArtifacts">刷新列表</button>
+          </div>
+        </div>
+        <article v-for="item in admin.acceptanceFilteredCases.value" :key="item.caseId" class="acceptance-case" :class="{ active: item.caseId === admin.acceptance.selectedCaseId, selected: admin.isAcceptanceCaseSelected(item.caseId), failed: item.passed === false }" @click="admin.refreshAcceptanceCase(item.caseId)">
+          <label class="acceptance-case-select" @click.stop>
+            <input type="checkbox" :checked="admin.isAcceptanceCaseSelected(item.caseId)" @change="admin.toggleAcceptanceCaseSelection(item.caseId)" />
+          </label>
+          <div class="acceptance-case-main"><div><strong>{{ item.caseId }}</strong><small>{{ item.description || item.worldId || item.summaryPath }}</small></div><p><span class="badge">{{ item.category || 'contract' }}</span> {{ (item.tags || []).join(' / ') || 'no-tags' }}</p><p>帧 {{ item.finalFrame }} / {{ item.finalTimeMs }}ms / 追踪 {{ item.traceNodeCount }}</p><p v-if="item.missingTraceNodes || item.missingActions || item.missingRelationships" class="muted">缺口：{{ item.missingTraceNodes || 'trace ok' }} / {{ item.missingActions || 'actions ok' }} / {{ item.missingRelationships || 'relations ok' }}</p></div>
+          <div class="acceptance-case-actions">
+            <span class="badge" :class="item.passed === false ? 'danger' : ''">{{ item.passed === false ? '失败' : item.passed === true ? '通过' : '未知' }}</span>
+            <button class="danger" :disabled="admin.busy.value" @click.stop="admin.deleteAcceptanceCase(item.caseId)">删除</button>
+          </div>
         </article>
         <p v-if="!admin.acceptanceBatch.value?.cases?.length" class="muted">尚未读取到场景产物；先通过 Unity、单元测试或 CI 生成 batch_summary.json 与 *_trace.jsonl。</p>
         <p v-else-if="!admin.acceptanceFilteredCases.value.length" class="muted">当前过滤条件下没有匹配的用例。</p>

Server/AdminConsole/src/services/domainApi.ts

@@ -1,5 +1,5 @@
 import { AdminApiClient } from './adminApiClient';
-import type { AdminClusterDiagnostics, AdminDashboardResponse, AdminServerOperationResponse, AdminServerStatus, AdminSkillAcceptanceArtifactDirectoryList, AdminSkillAcceptanceBatch, AdminSkillAcceptanceCase, AdminSkillAcceptanceRunPlan, AdminSkillAcceptanceRunResponse, AdminSkillAcceptanceTemplateList, AdminSkillAnalysisModel, AdminSkillDiagnosticsEvents, AdminSkillDiagnosticsSummary, CreateRoomResponse, RestoreRoomResponse, RoomRuntimeState, RoomSnapshot, SessionResponse, ShooterSandboxState } from '../types';
+import type { AdminClusterDiagnostics, AdminDashboardResponse, AdminServerOperationResponse, AdminServerStatus, AdminSkillAcceptanceArtifactDirectoryList, AdminSkillAcceptanceBatch, AdminSkillAcceptanceCase, AdminSkillAcceptanceDeleteResponse, AdminSkillAcceptanceRunPlan, AdminSkillAcceptanceRunResponse, AdminSkillAcceptanceTemplateList, AdminSkillAnalysisModel, AdminSkillDiagnosticsEvents, AdminSkillDiagnosticsSummary, CreateRoomResponse, RestoreRoomResponse, RoomRuntimeState, RoomSnapshot, SessionResponse, ShooterSandboxState } from '../types';
 
 export class AdminDashboardApi {
   public constructor(private readonly client: AdminApiClient) {}
@@ -64,6 +64,10 @@ export class AdminSkillApi {
     return this.client.request<AdminSkillAcceptanceBatch>(`/api/admin/skills/acceptance/batch${query}`, undefined, 'GET');
   }
 
+  public acceptanceDelete(request: unknown) {
+    return this.client.request<AdminSkillAcceptanceDeleteResponse>('/api/admin/skills/acceptance/delete', request);
+  }
+
   public acceptanceRun(request: unknown) {
     return this.client.request<AdminSkillAcceptanceRunResponse>('/api/admin/skills/acceptance/run', request);
   }