@kevlns/u-cli-mod 0.3.1 → 0.3.2
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.
- package/AGENTS.md +6 -249
- package/README.md +2 -2
- package/package.json +3 -2
- package/skills/unity/SKILL.md +8 -0
- package/skills/unity/references/project.md +268 -0
- package/v-cli.plugin.json +7 -1
package/AGENTS.md
CHANGED
|
@@ -1,267 +1,24 @@
|
|
|
1
|
-
# Vant Unity
|
|
1
|
+
# Vant Unity 工程开发规范
|
|
2
2
|
|
|
3
3
|
## 定位
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
本文件仅指导维护 u-cli-mod 仓库。运行时技能正本为 skills/unity/SKILL.md;命令机器契约为 v-cli.plugin.json。
|
|
6
6
|
|
|
7
7
|
## 调用流程
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
u-cli-mod routes
|
|
11
|
-
u-cli-mod doctor <工程目录>
|
|
12
|
-
u-cli-mod setup <工程目录>
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
首次调用前读取本规范,使用命令帮助或插件清单核对参数和执行范围。
|
|
9
|
+
修改前读取相关源文件与 package.json 中的检查命令,保留已有工作区改动。
|
|
16
10
|
|
|
17
11
|
## 调用规范
|
|
18
12
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
### 何时使用
|
|
22
|
-
|
|
23
|
-
- Windows 主机上,需要按**精确 Unity Editor 版本**(版本号 + revision 双重匹配)对 Unity 工程执行:体检诊断、下载固定版本 Unity CLI、事务式安装适配版 `com.unity.pipeline`、执行 Unity Pipeline 命令。
|
|
24
|
-
- 命令名 `unity`(经 v-cli 路由:`v-cli unity …`;直接安装时为 `u-cli-mod …`)。
|
|
25
|
-
|
|
26
|
-
### 核心命令速览
|
|
27
|
-
|
|
28
|
-
- `u-cli-mod doctor <project>` - 只读体检:路由匹配 / CLI 状态 / 适配包状态
|
|
29
|
-
- `u-cli-mod setup <project>` - CLI + 适配包一键就绪(推荐首次入口)
|
|
30
|
-
- `u-cli-mod pipeline install <project> --dry-run` - 安装预览(不写入工程)
|
|
31
|
-
- `u-cli-mod pipeline install <project>` - 事务式安装适配包(自动备份/回滚/receipt)
|
|
32
|
-
- `u-cli-mod exec <project> [--wait <秒>] -- <pipeline-args>` - 执行 Pipeline 命令(工具统一绑定 `--project-path`);长任务(`run_tests`)默认 5s 后让出控制权,结果用对应的 `command <name>_status` 轮询
|
|
33
|
-
- `u-cli-mod routes` / `u-cli-mod cache clean` - 路由表 / 缓存清理
|
|
34
|
-
|
|
35
|
-
Pipeline 命令全集见文末「Pipeline 工具清单」(适配版 `com.unity.pipeline`,按领域分组)。
|
|
36
|
-
|
|
37
|
-
### 使用规范(Agent 必须遵守)
|
|
38
|
-
|
|
39
|
-
1. **首次对某工程执行 `exec` 前**,必须检查 `doctor` 的 `cli.state="valid"`、`pipeline.state="current"` 且 `pipeline.installed=true`。`doctor` 退出成功仅表示诊断完成,不代表工程已就绪;`pipeline.present=true` 也只表示包存在。`missing` 时先跑 `setup`;`outdated`/`invalid` 时先关闭目标 Editor,再通过 `pipeline install <project> --force` 备份并更新。升级 npm 包不会自动更新工程内适配包,不要直接 `exec`。
|
|
40
|
-
2. **禁止在 `exec` 参数中传入任何 `--project-path` 变体**(`-projectPath`、`--project_path`、大小写混合、`=` 形式等)——目标工程由工具统一绑定,传入即报错是预期保护,不要尝试绕过。
|
|
41
|
-
3. **运行中的 Unity Editor 是 校验失败时拒绝执行**:安装被阻止时引导用户先关闭目标工程的 Editor;除非用户显式要求,不得使用 `--allow-running-editor` 绕过。
|
|
42
|
-
4. **安装是事务式的**(staging → 校验 → 备份 → 替换 → 再校验 → receipt,失败自动回滚):不要手动清理工程内 `Packages/com.unity.pipeline` 或 `Library/editor-pipeline-cli`。
|
|
43
|
-
5. **版本路由是精确匹配**(`m_EditorVersion` + revision 同时一致),没有"就近版本"回退;工程版本不在路由表内时如实报告支持列表,不得猜测、不得改写 `ProjectVersion.txt`。
|
|
44
|
-
6. `exec` 每次调用前都会重新校验 CLI 哈希(防篡改),属正常行为;校验失败按提示跑 `u-cli-mod cli install --force` 修复即可。
|
|
45
|
-
7. **读取 Editor 当前 Console 首选 `command read_console`**,`command console` 读取回调捕获流,适合 `since`/cursor 跟随,但不能代替原生 Console 快照。工具必须经 `command <名>` 调用。若实际 schema 中缺少 `read_console`,先检查 `doctor` 的 `patchVersion`/`installedPatchVersion` 和 `state`,不要将其误认成 `console` 的别名。
|
|
46
|
-
8. **全量测试必须走 `--async_tests`**:Unity CLI 对同步命令有 30 秒硬性等待上限(`--timeout` 无法延长),同步 `run_tests` 全量必然超时且不入 `test_status` 跟踪。用法:`run_tests --mode EditMode --async_tests`(立即返回)→ 轮询 `test_status` 至 `completed` 拿完整 Summary;小范围用 `--filter` 缩到单命名空间/类,可直接同步等待拿 Summary。
|
|
47
|
-
9. **任务身份**:`run_tests --async_tests` 的响应含 `RunId`;`test_status --run_id <id>` 只返回该次运行的记录(不存在/被顶替时返回 `unknown_run`,**绝不回退最近一次**);`cancel_tests --run_id <id>` 定向取消(不匹配或无活动运行返回 `unknown_run`/`no_active_run` 且零副作用)。`recompile` 响应含 `runId`,`recompile_status --run_id <id>` 同语义(引擎自发编译的终态 `runId` 为 null,按 id 查询即 `unknown_run`)。连续启动会替换当前追踪槽位;无法关联的 run_id 返回 unknown_run,不能当作其他运行的结果。已知限制:`recompile` 连发时后发 runId 会覆盖 pending id,前一编译批次的引擎事件终态记在后发 id 名下(旧 id 查询 `unknown_run` 正确拒绝)。
|
|
48
|
-
|
|
49
|
-
### 典型流程
|
|
50
|
-
|
|
51
|
-
```bash
|
|
52
|
-
u-cli-mod doctor <project> # 1. 体检(只读)
|
|
53
|
-
u-cli-mod setup <project> # 2. 就绪(CLI + 适配包)
|
|
54
|
-
u-cli-mod exec <project> -- command editor_status # 3. 执行
|
|
55
|
-
u-cli-mod exec <project> -- command run_tests --mode EditMode --filter <命名空间或类名> # 小范围:同步返回 Summary
|
|
56
|
-
u-cli-mod exec <project> -- command run_tests --mode EditMode --async_tests # 全量:立即返回,轮询 test_status
|
|
57
|
-
u-cli-mod exec <project> -- command read_console --types error,warning --count 100
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
### doctor 输出要点
|
|
61
|
-
|
|
62
|
-
`doctor.pipeline` 的 `patchVersion` 为当前路由要求的补丁版本,`installedPatchVersion` 为 receipt 记录的版本(缺失或未知为 null);`state` 为 `missing | outdated | invalid | current`。完整 expected-tree 校验通过即返回 `installed=true` / `current`,receipt 缺失或过期不触发重装。`verification` 列出内容不匹配、校验错误及仅行尾差异的文件。已安装 UTF-8 文本允许 LF/CRLF 等价,其他内容及二进制仍严格校验;生成源与 staging 保持字节级校验,新生成文本统一 LF。`sourceReady=false` 仅表示生成缓存需重建,不代表已安装包失效。
|
|
63
|
-
|
|
64
|
-
### Pipeline 工具清单
|
|
65
|
-
|
|
66
|
-
> 安装的 `com.unity.pipeline`(适配版 0.5.0-exp.1)共 **154** 个命令,经 `u-cli-mod exec <project> -- command <名> [参数]` 透传执行;参数全集以 `exec <project> -- command <名> --help` 为准。
|
|
67
|
-
|
|
68
|
-
#### GameObject / 组件
|
|
69
|
-
- `add_component` — 添加组件。
|
|
70
|
-
- `create_gameobject` — 创建场景对象。
|
|
71
|
-
- `create_gameobjects` — 批量创建场景对象。
|
|
72
|
-
- `delete_gameobject` — 删除场景对象,支持撤销。
|
|
73
|
-
- `find_gameobjects` — 按名称、标签、组件或层级路径查找场景对象。
|
|
74
|
-
- `get_component_properties` — 读取组件序列化属性。
|
|
75
|
-
- `remove_component` — 移除指定组件。
|
|
76
|
-
- `rename_gameobject` — 重命名场景对象。
|
|
77
|
-
- `set_active` — 设置对象激活状态。
|
|
78
|
-
- `set_component_properties` — 设置组件序列化属性,支持 ObjectRef 引用。
|
|
79
|
-
- `set_layer` — 设置对象层,编号范围 0–31。
|
|
80
|
-
- `set_parent` — 设置父对象;未指定父对象时移至场景根。
|
|
81
|
-
- `set_tag` — 设置工程中已存在的标签。
|
|
82
|
-
- `set_transform` — 设置局部坐标、欧拉旋转和缩放,省略项不变。
|
|
83
|
-
|
|
84
|
-
#### 场景
|
|
85
|
-
- `add_scene_to_build` — 将场景加入构建列表。
|
|
86
|
-
- `create_scene` — 创建并保存场景。
|
|
87
|
-
- `get_scene_hierarchy` — 读取场景层级及 instanceId、hierarchyPath。
|
|
88
|
-
- `list_open_scenes` — 列出已打开场景及加载、激活、未保存状态。
|
|
89
|
-
- `open_scene` — 打开场景。
|
|
90
|
-
- `remove_scene_from_build` — 从构建列表移除场景。
|
|
91
|
-
- `save_all` — 保存所有已修改场景和资源。
|
|
92
|
-
- `save_scene` — 保存场景。
|
|
93
|
-
- `set_active_scene` — 设置活动场景。
|
|
94
|
-
|
|
95
|
-
#### 资源 / 文件
|
|
96
|
-
- `copy_asset` — 复制资源。
|
|
97
|
-
- `create_asset` — 创建指定类型的资源。
|
|
98
|
-
- `create_folder` — 创建目录。
|
|
99
|
-
- `delete_asset` — 删除资源。需要 confirm=true。
|
|
100
|
-
- `find_assets` — 查找资源。
|
|
101
|
-
- `get_import_settings` — 读取资源导入设置。
|
|
102
|
-
- `import_asset` — 导入或重新导入资源。
|
|
103
|
-
- `move_asset` — 移动资源。
|
|
104
|
-
- `read_text_file` — 读取文本文件。
|
|
105
|
-
- `rename_asset` — 重命名资源。
|
|
106
|
-
- `set_import_settings` — 设置资源导入参数。
|
|
107
|
-
- `write_text_file` — 写入文本文件。需要 confirm=true。
|
|
108
|
-
|
|
109
|
-
#### 预制体
|
|
110
|
-
- `apply_prefab_overrides` — 将实例覆盖应用到预制体。
|
|
111
|
-
- `create_prefab` — 从场景对象创建预制体。
|
|
112
|
-
- `create_prefab_variant` — 创建预制体变体。
|
|
113
|
-
- `instantiate_prefab` — 将预制体实例化到场景。
|
|
114
|
-
- `revert_prefab_overrides` — 还原预制体实例覆盖。
|
|
115
|
-
- `save_prefab_contents` — 保存预制体内容。
|
|
116
|
-
- `unpack_prefab` — 解包预制体实例。
|
|
117
|
-
|
|
118
|
-
#### 材质 / 着色器
|
|
119
|
-
- `get_material_properties` — 读取材质属性。
|
|
120
|
-
- `get_shader_properties` — 读取着色器属性。
|
|
121
|
-
- `list_shaders` — 列出着色器。
|
|
122
|
-
- `set_material_properties` — 设置材质属性。
|
|
123
|
-
|
|
124
|
-
#### 脚本 / 编译 / 求值
|
|
125
|
-
- `attach_script` — 将脚本组件添加到对象。
|
|
126
|
-
- `cleanup_hotreload` — 清理热重载资源。
|
|
127
|
-
- `create_script` — 创建脚本文件。
|
|
128
|
-
- `eval` — 执行 C# 表达式或代码。
|
|
129
|
-
- `eval_file` — 执行文件中的 C# 代码。
|
|
130
|
-
- `get_serialized_fields` — 读取序列化字段。
|
|
131
|
-
- `hotreload_status` — 查询热重载状态。
|
|
132
|
-
- `recompile` — 触发编译并返回运行身份。
|
|
133
|
-
- `recompile_status` — 按 run_id 查询编译;无法关联时返回 unknown_run。
|
|
134
|
-
- `reload_file` — 重载脚本文件。
|
|
135
|
-
- `reload_file_override` — 重载脚本并明确应用覆盖。
|
|
136
|
-
- `set_serialized_field` — 设置序列化字段。
|
|
137
|
-
|
|
138
|
-
#### 动画 / Timeline
|
|
139
|
-
- `add_animator_layer` — 添加动画控制器层。
|
|
140
|
-
- `add_animator_parameter` — 添加动画参数。
|
|
141
|
-
- `add_animator_state` — 添加动画状态。
|
|
142
|
-
- `add_animator_transition` — 添加动画过渡。
|
|
143
|
-
- `add_timeline_clip` — 添加 Timeline 片段。
|
|
144
|
-
- `add_timeline_track` — 添加 Timeline 轨道。
|
|
145
|
-
- `create_animation_clip` — 创建动画片段。
|
|
146
|
-
- `create_animator_controller` — 创建动画控制器。
|
|
147
|
-
- `create_timeline` — 创建 Timeline。
|
|
148
|
-
- `get_animation_clip` — 读取动画片段。
|
|
149
|
-
- `get_animator_controller` — 读取动画控制器。
|
|
150
|
-
- `get_timeline` — 读取 Timeline。
|
|
151
|
-
- `remove_animation_curve` — 移除动画曲线。需要 confirm=true。
|
|
152
|
-
- `set_animation_curve` — 设置动画曲线。
|
|
153
|
-
|
|
154
|
-
#### 构建
|
|
155
|
-
- `build` — 执行构建。可用 dry_run 预演。
|
|
156
|
-
- `build_status` — 查询构建状态。
|
|
157
|
-
- `get_build_settings` — 读取构建设置。
|
|
158
|
-
- `list_build_profiles` — 列出构建配置。
|
|
159
|
-
- `list_build_targets` — 列出构建目标。
|
|
160
|
-
- `set_build_settings` — 设置构建参数。可用 dry_run 预演。
|
|
161
|
-
- `switch_build_target` — 切换构建目标。需要 confirm=true。
|
|
162
|
-
- `switch_build_target_status` — 查询构建目标切换结果。
|
|
163
|
-
|
|
164
|
-
#### 包管理
|
|
165
|
-
- `package_add` — 添加 UPM 包。需要 confirm=true。可用 dry_run 预演。异步操作查询 package_status;涉及编译时继续查询 recompile_status。
|
|
166
|
-
- `package_list` — 列出已安装或注册表中的 UPM 包。
|
|
167
|
-
- `package_remove` — 移除 UPM 包。需要 confirm=true。可用 dry_run 预演。异步操作查询 package_status;涉及编译时继续查询 recompile_status。
|
|
168
|
-
- `package_resolve` — 解析工程包依赖。异步操作查询 package_status;涉及编译时继续查询 recompile_status。
|
|
169
|
-
- `package_search` — 搜索注册表包。
|
|
170
|
-
- `package_status` — 查询包操作状态。
|
|
171
|
-
|
|
172
|
-
#### 测试
|
|
173
|
-
- `cancel_tests` — 按 run_id 取消测试;不匹配时不产生副作用。
|
|
174
|
-
- `list_tests` — 列出 EditMode 或 PlayMode 测试。
|
|
175
|
-
- `run_tests` — 按过滤条件执行测试;全量使用 --async_tests。
|
|
176
|
-
- `test_status` — 按 run_id 查询测试;无法关联时返回 unknown_run。
|
|
177
|
-
|
|
178
|
-
#### 烘焙(光照 / NavMesh / 遮挡)
|
|
179
|
-
- `bake_lighting` — 异步烘焙光照。
|
|
180
|
-
- `bake_navmesh` — 异步烘焙导航网格。
|
|
181
|
-
- `bake_navmesh_surfaces` — 烘焙 NavMeshSurface;缺少 AI Navigation 包时返回 package_not_found。
|
|
182
|
-
- `bake_occlusion_culling` — 异步烘焙遮挡剔除。
|
|
183
|
-
- `cancel_lighting_bake` — 取消光照烘焙。
|
|
184
|
-
- `cancel_navmesh_bake` — 取消导航网格烘焙。
|
|
185
|
-
- `cancel_occlusion_bake` — 取消遮挡剔除烘焙。
|
|
186
|
-
- `clear_baked_lighting` — 清理烘焙光照数据。需要 confirm=true。
|
|
187
|
-
- `clear_navmesh` — 清理导航网格。需要 confirm=true。
|
|
188
|
-
- `clear_occlusion_culling` — 清理遮挡剔除数据。需要 confirm=true。
|
|
189
|
-
- `get_lighting_settings` — 读取光照烘焙设置。
|
|
190
|
-
- `get_navmesh_settings` — 读取导航网格设置。
|
|
191
|
-
- `lighting_bake_status` — 查询光照烘焙状态。
|
|
192
|
-
- `navmesh_bake_status` — 查询导航网格烘焙状态。
|
|
193
|
-
- `occlusion_bake_status` — 查询遮挡剔除烘焙状态。
|
|
194
|
-
- `set_lighting_settings` — 设置光照烘焙参数,返回 applied 和 unknown。
|
|
195
|
-
- `set_navmesh_settings` — 设置导航网格参数。
|
|
196
|
-
|
|
197
|
-
#### 截图 / 捕获
|
|
198
|
-
- `capture_editor_element` — 截取编辑器 UI Toolkit 元素。
|
|
199
|
-
- `capture_game_view` — 截取游戏视图;source=screen 需要运行模式并包含叠加画布,source=camera 按相机渲染。设置 save_path 时默认只返回路径,include_inline_image=true 可同时返回图片。
|
|
200
|
-
- `capture_runtime_element` — 截取运行时 UI Toolkit 元素。
|
|
201
|
-
- `capture_scene_view` — 截取当前场景视图。设置 save_path 时默认只返回路径,include_inline_image=true 可同时返回图片。
|
|
202
|
-
- `screenshot` — 截取场景或游戏视图并返回文件路径。
|
|
203
|
-
|
|
204
|
-
#### 编辑器控制
|
|
205
|
-
- `editor_focus` — 激活 Unity Editor 窗口。
|
|
206
|
-
- `editor_pause` — 切换运行模式的暂停状态。
|
|
207
|
-
- `editor_play` — 进入运行模式。
|
|
208
|
-
- `editor_status` — 读取编辑器状态。
|
|
209
|
-
- `editor_stop` — 退出运行模式。
|
|
210
|
-
- `menu` — 执行或列出菜单项。
|
|
211
|
-
- `set_autotick` — 在窗口失焦时保持编辑器周期更新。
|
|
212
|
-
|
|
213
|
-
#### 可观测性 / 审计
|
|
214
|
-
- `audit` — 记录或查询编辑器审计信息。
|
|
215
|
-
- `audit_status` — 查询审计状态。
|
|
216
|
-
- `clear_console` — 清空 Console。
|
|
217
|
-
- `console` — 读取回调捕获的日志流,支持游标跟随。
|
|
218
|
-
- `get_console_logs` — 读取原生 Console 日志。
|
|
219
|
-
- `read_console` — 读取原生 Console 日志,按类型和数量过滤。
|
|
220
|
-
- `get_performance_stats` — 读取性能统计。
|
|
221
|
-
- `log` — 写入 Console 日志。
|
|
222
|
-
|
|
223
|
-
#### 项目设置
|
|
224
|
-
- `get_audio_settings` — 读取音频设置。
|
|
225
|
-
- `get_graphics_settings` — 读取图形设置。
|
|
226
|
-
- `get_input_settings` — 读取输入设置。
|
|
227
|
-
- `get_physics_settings` — 读取物理设置。
|
|
228
|
-
- `get_player_settings` — 读取应用设置。
|
|
229
|
-
- `get_quality_settings` — 读取质量设置。
|
|
230
|
-
- `get_tags_layers` — 读取标签与层。
|
|
231
|
-
- `get_time_settings` — 读取时间设置。
|
|
232
|
-
- `set_audio_settings` — 修改音频设置。需要 confirm=true。可用 dry_run 预演。
|
|
233
|
-
- `set_graphics_settings` — 修改图形设置。需要 confirm=true。可用 dry_run 预演。
|
|
234
|
-
- `set_input_settings` — 修改输入设置。需要 confirm=true。可用 dry_run 预演。
|
|
235
|
-
- `set_physics_settings` — 修改物理设置。需要 confirm=true。可用 dry_run 预演。
|
|
236
|
-
- `set_player_settings` — 修改应用设置。需要 confirm=true。可用 dry_run 预演。
|
|
237
|
-
- `set_quality_settings` — 修改质量设置。需要 confirm=true。可用 dry_run 预演。
|
|
238
|
-
- `set_tags_layers` — 修改标签与层。需要 confirm=true。可用 dry_run 预演。
|
|
239
|
-
- `set_time_settings` — 修改时间设置。需要 confirm=true。可用 dry_run 预演。
|
|
240
|
-
|
|
241
|
-
#### 运行时 / 输入模拟
|
|
242
|
-
- `quit` — 正常退出 Unity 应用。
|
|
243
|
-
- `runtime_status` — 读取运行时状态。
|
|
244
|
-
- `set_target_framerate` — 设置目标帧率。
|
|
245
|
-
- `set_timescale` — 设置时间缩放。
|
|
246
|
-
- `simulate_key` — 模拟键盘事件。
|
|
247
|
-
- `simulate_pointer` — 模拟指针事件。
|
|
248
|
-
|
|
249
|
-
#### 选择 / 搜索
|
|
250
|
-
- `get_selection` — 读取当前选择的对象身份。
|
|
251
|
-
- `search` — 执行 Unity Search 查询。
|
|
252
|
-
- `set_selection` — 设置当前选择。
|
|
253
|
-
|
|
254
|
-
#### Authoring 根路径
|
|
255
|
-
- `get_authoring_root` — 读取资源编辑根目录。
|
|
256
|
-
- `set_authoring_root` — 设置并约束资源编辑根目录。
|
|
13
|
+
技能正文与 references 独立维护,不从本文件生成运行规范。修改命令时同步机器清单及生成的命令文档。宿主配置和状态使用 VANT_HOME(默认 ~/.vant),项目数据保留在工程 .vant;安装不扫描其他 Agent 目录。外部宿主仅显式适配。
|
|
257
14
|
|
|
258
15
|
## 结果验证
|
|
259
16
|
|
|
260
|
-
|
|
17
|
+
运行 package.json 中与改动相关的检查;区分单测、真实后端、界面和安装验证。不得将模拟结果报告为真实生图或发布成功。
|
|
261
18
|
|
|
262
19
|
## 参考资料
|
|
263
20
|
|
|
264
|
-
[使用说明](README.md) · [
|
|
21
|
+
[使用说明](README.md) · [运行技能](skills/unity/SKILL.md)
|
|
265
22
|
|
|
266
23
|
## 许可与版权
|
|
267
24
|
|
package/README.md
CHANGED
|
@@ -104,7 +104,7 @@ u-cli-mod cache clean
|
|
|
104
104
|
```text
|
|
105
105
|
routes/ 精确版本路由;expected-tree/ 子目录为 385 文件 SHA-256 清单(含 Tests.meta)
|
|
106
106
|
templates/ Unity 生成的 .meta 模板(数据,非 Unity 源码)
|
|
107
|
-
|
|
107
|
+
skills/unity/ Unity 运行技能与操作参考
|
|
108
108
|
src/ TypeScript 实现
|
|
109
109
|
tests/ Vitest 单元测试(自编合成 fixture,不含 Unity 源码)
|
|
110
110
|
scripts/ pack-guard / preflight-runner / e2e-windows / test-package-install
|
|
@@ -123,7 +123,7 @@ npm run test:package
|
|
|
123
123
|
|
|
124
124
|
## 文档
|
|
125
125
|
|
|
126
|
-
[Agent 调用规范](
|
|
126
|
+
[Agent 调用规范](skills/unity/SKILL.md) · [文档规范](docs/documentation.md) · [自托管 Unity E2E Runner(本地准备指南)](docs/SELF_HOSTED_RUNNER.md)
|
|
127
127
|
|
|
128
128
|
## 许可与版权
|
|
129
129
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kevlns/u-cli-mod",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.2",
|
|
4
4
|
"description": "按 Unity Editor 精确版本定位工具链,校验和安装 com.unity.pipeline,并执行工程命令。",
|
|
5
5
|
"private": false,
|
|
6
6
|
"publishConfig": {
|
|
@@ -22,7 +22,8 @@
|
|
|
22
22
|
"AGENTS.md",
|
|
23
23
|
"README.md",
|
|
24
24
|
"LICENSE",
|
|
25
|
-
"docs/"
|
|
25
|
+
"docs/",
|
|
26
|
+
"skills/"
|
|
26
27
|
],
|
|
27
28
|
"repository": {
|
|
28
29
|
"type": "git",
|
|
@@ -0,0 +1,268 @@
|
|
|
1
|
+
# Vant Unity 工程工具 Agent 规范
|
|
2
|
+
|
|
3
|
+
## 定位
|
|
4
|
+
|
|
5
|
+
按 Unity Editor 精确版本定位工具链,校验和安装 com.unity.pipeline,并执行工程命令。
|
|
6
|
+
|
|
7
|
+
## 调用流程
|
|
8
|
+
|
|
9
|
+
```sh
|
|
10
|
+
u-cli-mod routes
|
|
11
|
+
u-cli-mod doctor <工程目录>
|
|
12
|
+
u-cli-mod setup <工程目录>
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
首次调用前读取本规范,使用命令帮助或插件清单核对参数和执行范围。
|
|
16
|
+
|
|
17
|
+
## 调用规范
|
|
18
|
+
|
|
19
|
+
> 本文件是 AI Agent 调用本工具的规范正本。参数全集以 `u-cli-mod <命令> --help` 与 `v-cli.plugin.json`(经 v-cli 路由时用 `v-cli agent describe unity`)为准;本文件只锁定使用场景、调用规范与典型流程。
|
|
20
|
+
|
|
21
|
+
### 何时使用
|
|
22
|
+
|
|
23
|
+
- Windows 主机上,需要按**精确 Unity Editor 版本**(版本号 + revision 双重匹配)对 Unity 工程执行:体检诊断、下载固定版本 Unity CLI、事务式安装适配版 `com.unity.pipeline`、执行 Unity Pipeline 命令。
|
|
24
|
+
- 命令名 `unity`(经 v-cli 路由:`v-cli unity …`;直接安装时为 `u-cli-mod …`)。
|
|
25
|
+
|
|
26
|
+
### 核心命令速览
|
|
27
|
+
|
|
28
|
+
- `u-cli-mod doctor <project>` - 只读体检:路由匹配 / CLI 状态 / 适配包状态
|
|
29
|
+
- `u-cli-mod setup <project>` - CLI + 适配包一键就绪(推荐首次入口)
|
|
30
|
+
- `u-cli-mod pipeline install <project> --dry-run` - 安装预览(不写入工程)
|
|
31
|
+
- `u-cli-mod pipeline install <project>` - 事务式安装适配包(自动备份/回滚/receipt)
|
|
32
|
+
- `u-cli-mod exec <project> [--wait <秒>] -- <pipeline-args>` - 执行 Pipeline 命令(工具统一绑定 `--project-path`);长任务(`run_tests`)默认 5s 后让出控制权,结果用对应的 `command <name>_status` 轮询
|
|
33
|
+
- `u-cli-mod routes` / `u-cli-mod cache clean` - 路由表 / 缓存清理
|
|
34
|
+
|
|
35
|
+
Pipeline 命令全集见文末「Pipeline 工具清单」(适配版 `com.unity.pipeline`,按领域分组)。
|
|
36
|
+
|
|
37
|
+
### 使用规范(Agent 必须遵守)
|
|
38
|
+
|
|
39
|
+
1. **首次对某工程执行 `exec` 前**,必须检查 `doctor` 的 `cli.state="valid"`、`pipeline.state="current"` 且 `pipeline.installed=true`。`doctor` 退出成功仅表示诊断完成,不代表工程已就绪;`pipeline.present=true` 也只表示包存在。`missing` 时先跑 `setup`;`outdated`/`invalid` 时先关闭目标 Editor,再通过 `pipeline install <project> --force` 备份并更新。升级 npm 包不会自动更新工程内适配包,不要直接 `exec`。
|
|
40
|
+
2. **禁止在 `exec` 参数中传入任何 `--project-path` 变体**(`-projectPath`、`--project_path`、大小写混合、`=` 形式等)——目标工程由工具统一绑定,传入即报错是预期保护,不要尝试绕过。
|
|
41
|
+
3. **运行中的 Unity Editor 是 校验失败时拒绝执行**:安装被阻止时引导用户先关闭目标工程的 Editor;除非用户显式要求,不得使用 `--allow-running-editor` 绕过。
|
|
42
|
+
4. **安装是事务式的**(staging → 校验 → 备份 → 替换 → 再校验 → receipt,失败自动回滚):不要手动清理工程内 `Packages/com.unity.pipeline` 或 `Library/editor-pipeline-cli`。
|
|
43
|
+
5. **版本路由是精确匹配**(`m_EditorVersion` + revision 同时一致),没有"就近版本"回退;工程版本不在路由表内时如实报告支持列表,不得猜测、不得改写 `ProjectVersion.txt`。
|
|
44
|
+
6. `exec` 每次调用前都会重新校验 CLI 哈希(防篡改),属正常行为;校验失败按提示跑 `u-cli-mod cli install --force` 修复即可。
|
|
45
|
+
7. **读取 Editor 当前 Console 首选 `command read_console`**,`command console` 读取回调捕获流,适合 `since`/cursor 跟随,但不能代替原生 Console 快照。工具必须经 `command <名>` 调用。若实际 schema 中缺少 `read_console`,先检查 `doctor` 的 `patchVersion`/`installedPatchVersion` 和 `state`,不要将其误认成 `console` 的别名。
|
|
46
|
+
8. **全量测试必须走 `--async_tests`**:Unity CLI 对同步命令有 30 秒硬性等待上限(`--timeout` 无法延长),同步 `run_tests` 全量必然超时且不入 `test_status` 跟踪。用法:`run_tests --mode EditMode --async_tests`(立即返回)→ 轮询 `test_status` 至 `completed` 拿完整 Summary;小范围用 `--filter` 缩到单命名空间/类,可直接同步等待拿 Summary。
|
|
47
|
+
9. **任务身份**:`run_tests --async_tests` 的响应含 `RunId`;`test_status --run_id <id>` 只返回该次运行的记录(不存在/被顶替时返回 `unknown_run`,**绝不回退最近一次**);`cancel_tests --run_id <id>` 定向取消(不匹配或无活动运行返回 `unknown_run`/`no_active_run` 且零副作用)。`recompile` 响应含 `runId`,`recompile_status --run_id <id>` 同语义(引擎自发编译的终态 `runId` 为 null,按 id 查询即 `unknown_run`)。连续启动会替换当前追踪槽位;无法关联的 run_id 返回 unknown_run,不能当作其他运行的结果。已知限制:`recompile` 连发时后发 runId 会覆盖 pending id,前一编译批次的引擎事件终态记在后发 id 名下(旧 id 查询 `unknown_run` 正确拒绝)。
|
|
48
|
+
|
|
49
|
+
### 典型流程
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
u-cli-mod doctor <project> # 1. 体检(只读)
|
|
53
|
+
u-cli-mod setup <project> # 2. 就绪(CLI + 适配包)
|
|
54
|
+
u-cli-mod exec <project> -- command editor_status # 3. 执行
|
|
55
|
+
u-cli-mod exec <project> -- command run_tests --mode EditMode --filter <命名空间或类名> # 小范围:同步返回 Summary
|
|
56
|
+
u-cli-mod exec <project> -- command run_tests --mode EditMode --async_tests # 全量:立即返回,轮询 test_status
|
|
57
|
+
u-cli-mod exec <project> -- command read_console --types error,warning --count 100
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### doctor 输出要点
|
|
61
|
+
|
|
62
|
+
`doctor.pipeline` 的 `patchVersion` 为当前路由要求的补丁版本,`installedPatchVersion` 为 receipt 记录的版本(缺失或未知为 null);`state` 为 `missing | outdated | invalid | current`。完整 expected-tree 校验通过即返回 `installed=true` / `current`,receipt 缺失或过期不触发重装。`verification` 列出内容不匹配、校验错误及仅行尾差异的文件。已安装 UTF-8 文本允许 LF/CRLF 等价,其他内容及二进制仍严格校验;生成源与 staging 保持字节级校验,新生成文本统一 LF。`sourceReady=false` 仅表示生成缓存需重建,不代表已安装包失效。
|
|
63
|
+
|
|
64
|
+
### Pipeline 工具清单
|
|
65
|
+
|
|
66
|
+
> 安装的 `com.unity.pipeline`(适配版 0.5.0-exp.1)共 **154** 个命令,经 `u-cli-mod exec <project> -- command <名> [参数]` 透传执行;参数全集以 `exec <project> -- command <名> --help` 为准。
|
|
67
|
+
|
|
68
|
+
#### GameObject / 组件
|
|
69
|
+
- `add_component` — 添加组件。
|
|
70
|
+
- `create_gameobject` — 创建场景对象。
|
|
71
|
+
- `create_gameobjects` — 批量创建场景对象。
|
|
72
|
+
- `delete_gameobject` — 删除场景对象,支持撤销。
|
|
73
|
+
- `find_gameobjects` — 按名称、标签、组件或层级路径查找场景对象。
|
|
74
|
+
- `get_component_properties` — 读取组件序列化属性。
|
|
75
|
+
- `remove_component` — 移除指定组件。
|
|
76
|
+
- `rename_gameobject` — 重命名场景对象。
|
|
77
|
+
- `set_active` — 设置对象激活状态。
|
|
78
|
+
- `set_component_properties` — 设置组件序列化属性,支持 ObjectRef 引用。
|
|
79
|
+
- `set_layer` — 设置对象层,编号范围 0–31。
|
|
80
|
+
- `set_parent` — 设置父对象;未指定父对象时移至场景根。
|
|
81
|
+
- `set_tag` — 设置工程中已存在的标签。
|
|
82
|
+
- `set_transform` — 设置局部坐标、欧拉旋转和缩放,省略项不变。
|
|
83
|
+
|
|
84
|
+
#### 场景
|
|
85
|
+
- `add_scene_to_build` — 将场景加入构建列表。
|
|
86
|
+
- `create_scene` — 创建并保存场景。
|
|
87
|
+
- `get_scene_hierarchy` — 读取场景层级及 instanceId、hierarchyPath。
|
|
88
|
+
- `list_open_scenes` — 列出已打开场景及加载、激活、未保存状态。
|
|
89
|
+
- `open_scene` — 打开场景。
|
|
90
|
+
- `remove_scene_from_build` — 从构建列表移除场景。
|
|
91
|
+
- `save_all` — 保存所有已修改场景和资源。
|
|
92
|
+
- `save_scene` — 保存场景。
|
|
93
|
+
- `set_active_scene` — 设置活动场景。
|
|
94
|
+
|
|
95
|
+
#### 资源 / 文件
|
|
96
|
+
- `copy_asset` — 复制资源。
|
|
97
|
+
- `create_asset` — 创建指定类型的资源。
|
|
98
|
+
- `create_folder` — 创建目录。
|
|
99
|
+
- `delete_asset` — 删除资源。需要 confirm=true。
|
|
100
|
+
- `find_assets` — 查找资源。
|
|
101
|
+
- `get_import_settings` — 读取资源导入设置。
|
|
102
|
+
- `import_asset` — 导入或重新导入资源。
|
|
103
|
+
- `move_asset` — 移动资源。
|
|
104
|
+
- `read_text_file` — 读取文本文件。
|
|
105
|
+
- `rename_asset` — 重命名资源。
|
|
106
|
+
- `set_import_settings` — 设置资源导入参数。
|
|
107
|
+
- `write_text_file` — 写入文本文件。需要 confirm=true。
|
|
108
|
+
|
|
109
|
+
#### 预制体
|
|
110
|
+
- `apply_prefab_overrides` — 将实例覆盖应用到预制体。
|
|
111
|
+
- `create_prefab` — 从场景对象创建预制体。
|
|
112
|
+
- `create_prefab_variant` — 创建预制体变体。
|
|
113
|
+
- `instantiate_prefab` — 将预制体实例化到场景。
|
|
114
|
+
- `revert_prefab_overrides` — 还原预制体实例覆盖。
|
|
115
|
+
- `save_prefab_contents` — 保存预制体内容。
|
|
116
|
+
- `unpack_prefab` — 解包预制体实例。
|
|
117
|
+
|
|
118
|
+
#### 材质 / 着色器
|
|
119
|
+
- `get_material_properties` — 读取材质属性。
|
|
120
|
+
- `get_shader_properties` — 读取着色器属性。
|
|
121
|
+
- `list_shaders` — 列出着色器。
|
|
122
|
+
- `set_material_properties` — 设置材质属性。
|
|
123
|
+
|
|
124
|
+
#### 脚本 / 编译 / 求值
|
|
125
|
+
- `attach_script` — 将脚本组件添加到对象。
|
|
126
|
+
- `cleanup_hotreload` — 清理热重载资源。
|
|
127
|
+
- `create_script` — 创建脚本文件。
|
|
128
|
+
- `eval` — 执行 C# 表达式或代码。
|
|
129
|
+
- `eval_file` — 执行文件中的 C# 代码。
|
|
130
|
+
- `get_serialized_fields` — 读取序列化字段。
|
|
131
|
+
- `hotreload_status` — 查询热重载状态。
|
|
132
|
+
- `recompile` — 触发编译并返回运行身份。
|
|
133
|
+
- `recompile_status` — 按 run_id 查询编译;无法关联时返回 unknown_run。
|
|
134
|
+
- `reload_file` — 重载脚本文件。
|
|
135
|
+
- `reload_file_override` — 重载脚本并明确应用覆盖。
|
|
136
|
+
- `set_serialized_field` — 设置序列化字段。
|
|
137
|
+
|
|
138
|
+
#### 动画 / Timeline
|
|
139
|
+
- `add_animator_layer` — 添加动画控制器层。
|
|
140
|
+
- `add_animator_parameter` — 添加动画参数。
|
|
141
|
+
- `add_animator_state` — 添加动画状态。
|
|
142
|
+
- `add_animator_transition` — 添加动画过渡。
|
|
143
|
+
- `add_timeline_clip` — 添加 Timeline 片段。
|
|
144
|
+
- `add_timeline_track` — 添加 Timeline 轨道。
|
|
145
|
+
- `create_animation_clip` — 创建动画片段。
|
|
146
|
+
- `create_animator_controller` — 创建动画控制器。
|
|
147
|
+
- `create_timeline` — 创建 Timeline。
|
|
148
|
+
- `get_animation_clip` — 读取动画片段。
|
|
149
|
+
- `get_animator_controller` — 读取动画控制器。
|
|
150
|
+
- `get_timeline` — 读取 Timeline。
|
|
151
|
+
- `remove_animation_curve` — 移除动画曲线。需要 confirm=true。
|
|
152
|
+
- `set_animation_curve` — 设置动画曲线。
|
|
153
|
+
|
|
154
|
+
#### 构建
|
|
155
|
+
- `build` — 执行构建。可用 dry_run 预演。
|
|
156
|
+
- `build_status` — 查询构建状态。
|
|
157
|
+
- `get_build_settings` — 读取构建设置。
|
|
158
|
+
- `list_build_profiles` — 列出构建配置。
|
|
159
|
+
- `list_build_targets` — 列出构建目标。
|
|
160
|
+
- `set_build_settings` — 设置构建参数。可用 dry_run 预演。
|
|
161
|
+
- `switch_build_target` — 切换构建目标。需要 confirm=true。
|
|
162
|
+
- `switch_build_target_status` — 查询构建目标切换结果。
|
|
163
|
+
|
|
164
|
+
#### 包管理
|
|
165
|
+
- `package_add` — 添加 UPM 包。需要 confirm=true。可用 dry_run 预演。异步操作查询 package_status;涉及编译时继续查询 recompile_status。
|
|
166
|
+
- `package_list` — 列出已安装或注册表中的 UPM 包。
|
|
167
|
+
- `package_remove` — 移除 UPM 包。需要 confirm=true。可用 dry_run 预演。异步操作查询 package_status;涉及编译时继续查询 recompile_status。
|
|
168
|
+
- `package_resolve` — 解析工程包依赖。异步操作查询 package_status;涉及编译时继续查询 recompile_status。
|
|
169
|
+
- `package_search` — 搜索注册表包。
|
|
170
|
+
- `package_status` — 查询包操作状态。
|
|
171
|
+
|
|
172
|
+
#### 测试
|
|
173
|
+
- `cancel_tests` — 按 run_id 取消测试;不匹配时不产生副作用。
|
|
174
|
+
- `list_tests` — 列出 EditMode 或 PlayMode 测试。
|
|
175
|
+
- `run_tests` — 按过滤条件执行测试;全量使用 --async_tests。
|
|
176
|
+
- `test_status` — 按 run_id 查询测试;无法关联时返回 unknown_run。
|
|
177
|
+
|
|
178
|
+
#### 烘焙(光照 / NavMesh / 遮挡)
|
|
179
|
+
- `bake_lighting` — 异步烘焙光照。
|
|
180
|
+
- `bake_navmesh` — 异步烘焙导航网格。
|
|
181
|
+
- `bake_navmesh_surfaces` — 烘焙 NavMeshSurface;缺少 AI Navigation 包时返回 package_not_found。
|
|
182
|
+
- `bake_occlusion_culling` — 异步烘焙遮挡剔除。
|
|
183
|
+
- `cancel_lighting_bake` — 取消光照烘焙。
|
|
184
|
+
- `cancel_navmesh_bake` — 取消导航网格烘焙。
|
|
185
|
+
- `cancel_occlusion_bake` — 取消遮挡剔除烘焙。
|
|
186
|
+
- `clear_baked_lighting` — 清理烘焙光照数据。需要 confirm=true。
|
|
187
|
+
- `clear_navmesh` — 清理导航网格。需要 confirm=true。
|
|
188
|
+
- `clear_occlusion_culling` — 清理遮挡剔除数据。需要 confirm=true。
|
|
189
|
+
- `get_lighting_settings` — 读取光照烘焙设置。
|
|
190
|
+
- `get_navmesh_settings` — 读取导航网格设置。
|
|
191
|
+
- `lighting_bake_status` — 查询光照烘焙状态。
|
|
192
|
+
- `navmesh_bake_status` — 查询导航网格烘焙状态。
|
|
193
|
+
- `occlusion_bake_status` — 查询遮挡剔除烘焙状态。
|
|
194
|
+
- `set_lighting_settings` — 设置光照烘焙参数,返回 applied 和 unknown。
|
|
195
|
+
- `set_navmesh_settings` — 设置导航网格参数。
|
|
196
|
+
|
|
197
|
+
#### 截图 / 捕获
|
|
198
|
+
- `capture_editor_element` — 截取编辑器 UI Toolkit 元素。
|
|
199
|
+
- `capture_game_view` — 截取游戏视图;source=screen 需要运行模式并包含叠加画布,source=camera 按相机渲染。设置 save_path 时默认只返回路径,include_inline_image=true 可同时返回图片。
|
|
200
|
+
- `capture_runtime_element` — 截取运行时 UI Toolkit 元素。
|
|
201
|
+
- `capture_scene_view` — 截取当前场景视图。设置 save_path 时默认只返回路径,include_inline_image=true 可同时返回图片。
|
|
202
|
+
- `screenshot` — 截取场景或游戏视图并返回文件路径。
|
|
203
|
+
|
|
204
|
+
#### 编辑器控制
|
|
205
|
+
- `editor_focus` — 激活 Unity Editor 窗口。
|
|
206
|
+
- `editor_pause` — 切换运行模式的暂停状态。
|
|
207
|
+
- `editor_play` — 进入运行模式。
|
|
208
|
+
- `editor_status` — 读取编辑器状态。
|
|
209
|
+
- `editor_stop` — 退出运行模式。
|
|
210
|
+
- `menu` — 执行或列出菜单项。
|
|
211
|
+
- `set_autotick` — 在窗口失焦时保持编辑器周期更新。
|
|
212
|
+
|
|
213
|
+
#### 可观测性 / 审计
|
|
214
|
+
- `audit` — 记录或查询编辑器审计信息。
|
|
215
|
+
- `audit_status` — 查询审计状态。
|
|
216
|
+
- `clear_console` — 清空 Console。
|
|
217
|
+
- `console` — 读取回调捕获的日志流,支持游标跟随。
|
|
218
|
+
- `get_console_logs` — 读取原生 Console 日志。
|
|
219
|
+
- `read_console` — 读取原生 Console 日志,按类型和数量过滤。
|
|
220
|
+
- `get_performance_stats` — 读取性能统计。
|
|
221
|
+
- `log` — 写入 Console 日志。
|
|
222
|
+
|
|
223
|
+
#### 项目设置
|
|
224
|
+
- `get_audio_settings` — 读取音频设置。
|
|
225
|
+
- `get_graphics_settings` — 读取图形设置。
|
|
226
|
+
- `get_input_settings` — 读取输入设置。
|
|
227
|
+
- `get_physics_settings` — 读取物理设置。
|
|
228
|
+
- `get_player_settings` — 读取应用设置。
|
|
229
|
+
- `get_quality_settings` — 读取质量设置。
|
|
230
|
+
- `get_tags_layers` — 读取标签与层。
|
|
231
|
+
- `get_time_settings` — 读取时间设置。
|
|
232
|
+
- `set_audio_settings` — 修改音频设置。需要 confirm=true。可用 dry_run 预演。
|
|
233
|
+
- `set_graphics_settings` — 修改图形设置。需要 confirm=true。可用 dry_run 预演。
|
|
234
|
+
- `set_input_settings` — 修改输入设置。需要 confirm=true。可用 dry_run 预演。
|
|
235
|
+
- `set_physics_settings` — 修改物理设置。需要 confirm=true。可用 dry_run 预演。
|
|
236
|
+
- `set_player_settings` — 修改应用设置。需要 confirm=true。可用 dry_run 预演。
|
|
237
|
+
- `set_quality_settings` — 修改质量设置。需要 confirm=true。可用 dry_run 预演。
|
|
238
|
+
- `set_tags_layers` — 修改标签与层。需要 confirm=true。可用 dry_run 预演。
|
|
239
|
+
- `set_time_settings` — 修改时间设置。需要 confirm=true。可用 dry_run 预演。
|
|
240
|
+
|
|
241
|
+
#### 运行时 / 输入模拟
|
|
242
|
+
- `quit` — 正常退出 Unity 应用。
|
|
243
|
+
- `runtime_status` — 读取运行时状态。
|
|
244
|
+
- `set_target_framerate` — 设置目标帧率。
|
|
245
|
+
- `set_timescale` — 设置时间缩放。
|
|
246
|
+
- `simulate_key` — 模拟键盘事件。
|
|
247
|
+
- `simulate_pointer` — 模拟指针事件。
|
|
248
|
+
|
|
249
|
+
#### 选择 / 搜索
|
|
250
|
+
- `get_selection` — 读取当前选择的对象身份。
|
|
251
|
+
- `search` — 执行 Unity Search 查询。
|
|
252
|
+
- `set_selection` — 设置当前选择。
|
|
253
|
+
|
|
254
|
+
#### Authoring 根路径
|
|
255
|
+
- `get_authoring_root` — 读取资源编辑根目录。
|
|
256
|
+
- `set_authoring_root` — 设置并约束资源编辑根目录。
|
|
257
|
+
|
|
258
|
+
## 结果验证
|
|
259
|
+
|
|
260
|
+
核对原始错误、任务身份、停止状态及实际产物。只报告已经完成的验证,模拟测试与真实执行分别说明。
|
|
261
|
+
|
|
262
|
+
## 参考资料
|
|
263
|
+
|
|
264
|
+
使用说明(工具包 `README.md`) · 文档规范(工具包 `docs/documentation.md`) · v-cli.plugin.json
|
|
265
|
+
|
|
266
|
+
## 许可与版权
|
|
267
|
+
|
|
268
|
+
MIT。Copyright © 2026 Vant。
|