@kevlns/u-cli-mod 0.3.0 → 0.3.1
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 +228 -200
- package/LICENSE +2 -2
- package/README.md +36 -133
- package/dist/cli.js +1 -1
- package/docs/SELF_HOSTED_RUNNER.md +100 -0
- package/docs/documentation.md +24 -0
- package/package.json +8 -9
- package/v-cli.plugin.json +238 -219
package/v-cli.plugin.json
CHANGED
|
@@ -3,8 +3,10 @@
|
|
|
3
3
|
"package": "@kevlns/u-cli-mod",
|
|
4
4
|
"command": "unity",
|
|
5
5
|
"bin": "u-cli-mod",
|
|
6
|
-
"description": "
|
|
7
|
-
"platforms": [
|
|
6
|
+
"description": "按 Unity Editor 精确版本定位工具链,校验和安装 com.unity.pipeline,并执行工程命令。",
|
|
7
|
+
"platforms": [
|
|
8
|
+
"win32"
|
|
9
|
+
],
|
|
8
10
|
"runtime": {
|
|
9
11
|
"node": ">=20",
|
|
10
12
|
"os": "win32"
|
|
@@ -12,15 +14,15 @@
|
|
|
12
14
|
"environment": [
|
|
13
15
|
{
|
|
14
16
|
"name": "LOCALAPPDATA",
|
|
15
|
-
"description": "
|
|
17
|
+
"description": "Windows 用户缓存位于 %LOCALAPPDATA%/editor-pipeline-cli;未设置时使用用户 AppData/Local。工程回执、备份和暂存位于 <project>/Library/editor-pipeline-cli。"
|
|
16
18
|
},
|
|
17
19
|
{
|
|
18
20
|
"name": "PATH",
|
|
19
|
-
"description": "
|
|
21
|
+
"description": "必须能调用 powershell.exe;通过 Windows PowerShell 检查 Unity.exe 是否占用目标工程。"
|
|
20
22
|
}
|
|
21
23
|
],
|
|
22
24
|
"agent": {
|
|
23
|
-
"whenToUse": "
|
|
25
|
+
"whenToUse": "用于 Windows 的 Unity 2022 工程诊断、精确版本路由、已校验工具下载、事务式安装及明确绑定工程的 Pipeline 调用。",
|
|
24
26
|
"globalOptions": [
|
|
25
27
|
{
|
|
26
28
|
"flags": "-V, --version",
|
|
@@ -33,14 +35,16 @@
|
|
|
33
35
|
],
|
|
34
36
|
"commands": [
|
|
35
37
|
{
|
|
36
|
-
"path": [
|
|
38
|
+
"path": [
|
|
39
|
+
"doctor"
|
|
40
|
+
],
|
|
37
41
|
"usage": "u-cli-mod doctor <project> [options]",
|
|
38
42
|
"description": "检查工程版本、路由、CLI 与 Pipeline 状态",
|
|
39
43
|
"arguments": [
|
|
40
44
|
{
|
|
41
45
|
"name": "project",
|
|
42
46
|
"required": true,
|
|
43
|
-
"description": "
|
|
47
|
+
"description": "Unity 工程路径,必须包含 ProjectSettings/ProjectVersion.txt。"
|
|
44
48
|
}
|
|
45
49
|
],
|
|
46
50
|
"options": [
|
|
@@ -51,20 +55,22 @@
|
|
|
51
55
|
],
|
|
52
56
|
"output": {
|
|
53
57
|
"format": "json",
|
|
54
|
-
"description": "
|
|
58
|
+
"description": "返回工程、版本、路由、cli、pipeline、unityProcesses 和 supportedVersions。pipeline 包含 version、patchVersion、installedPatchVersion、sourceReady、present、installed、state;退出 0 仅表示诊断完成。installed 要求完整文件树校验;生成缓存状态单独报告。verification 列出 mismatches、lineEndingDifferences、error。已安装 UTF-8 文本允许 LF/CRLF 等价,二进制与生成源要求精确字节。outdated/invalid 时关闭目标编辑器后执行 pipeline install --force;npm 更新不修改工程包。"
|
|
55
59
|
},
|
|
56
60
|
"exitCodes": {
|
|
57
|
-
"0": "
|
|
58
|
-
"1": "
|
|
61
|
+
"0": "成功。",
|
|
62
|
+
"1": "工程不可读或不匹配已登记的精确版本路由。"
|
|
59
63
|
},
|
|
60
64
|
"safety": [
|
|
61
|
-
"
|
|
62
|
-
"
|
|
63
|
-
"
|
|
65
|
+
"只读,不写入工程或缓存。",
|
|
66
|
+
"精确匹配 m_EditorVersion 和 m_EditorVersionWithRevision,不使用通配匹配。",
|
|
67
|
+
"通过 PowerShell 检查 Unity.exe;查询失败记录在 unityProcesses 中。"
|
|
64
68
|
]
|
|
65
69
|
},
|
|
66
70
|
{
|
|
67
|
-
"path": [
|
|
71
|
+
"path": [
|
|
72
|
+
"routes"
|
|
73
|
+
],
|
|
68
74
|
"usage": "u-cli-mod routes [options]",
|
|
69
75
|
"description": "列出所有已配置的 Editor 精确路由",
|
|
70
76
|
"arguments": [],
|
|
@@ -76,19 +82,22 @@
|
|
|
76
82
|
],
|
|
77
83
|
"output": {
|
|
78
84
|
"format": "json",
|
|
79
|
-
"description": "
|
|
85
|
+
"description": "返回 routes 数组,每项包含 editorVersion、editorRevision、cliVersion、cliSha256、pipelineVersion、pipelineSha256 和 status。"
|
|
80
86
|
},
|
|
81
87
|
"exitCodes": {
|
|
82
|
-
"0": "
|
|
83
|
-
"1": "
|
|
88
|
+
"0": "成功。",
|
|
89
|
+
"1": "Editor 版本未登记或工具内部错误。"
|
|
84
90
|
},
|
|
85
91
|
"safety": [
|
|
86
|
-
"
|
|
87
|
-
"
|
|
92
|
+
"只读,不联网。",
|
|
93
|
+
"只使用随包发布的固定路由元数据。"
|
|
88
94
|
]
|
|
89
95
|
},
|
|
90
96
|
{
|
|
91
|
-
"path": [
|
|
97
|
+
"path": [
|
|
98
|
+
"cli",
|
|
99
|
+
"install"
|
|
100
|
+
],
|
|
92
101
|
"usage": "u-cli-mod cli install [options]",
|
|
93
102
|
"description": "下载并校验固定版本的 Unity CLI(SHA-256 + Authenticode)",
|
|
94
103
|
"arguments": [],
|
|
@@ -104,28 +113,31 @@
|
|
|
104
113
|
],
|
|
105
114
|
"output": {
|
|
106
115
|
"format": "json",
|
|
107
|
-
"description": "
|
|
116
|
+
"description": "返回 cacheDir 和 results;每项包含 editorVersion、cliVersion、path、state(valid/downloaded)和 sha256。"
|
|
108
117
|
},
|
|
109
118
|
"exitCodes": {
|
|
110
|
-
"0": "
|
|
111
|
-
"1": "
|
|
119
|
+
"0": "成功。",
|
|
120
|
+
"1": "下载、大小、SHA-256 或 Authenticode 校验失败。"
|
|
112
121
|
},
|
|
113
122
|
"safety": [
|
|
114
|
-
"
|
|
115
|
-
"
|
|
116
|
-
"
|
|
117
|
-
"
|
|
123
|
+
"只写入用户缓存 %LOCALAPPDATA%/editor-pipeline-cli/cache/cli。",
|
|
124
|
+
"只从路由中固定的 Unity 官方 HTTPS 地址下载。",
|
|
125
|
+
"安装前校验 SHA-256、文件大小、Authenticode 签名主体及证书指纹。",
|
|
126
|
+
"失败时清理未验证的临时下载,通过原子重命名创建最终文件。"
|
|
118
127
|
]
|
|
119
128
|
},
|
|
120
129
|
{
|
|
121
|
-
"path": [
|
|
130
|
+
"path": [
|
|
131
|
+
"pipeline",
|
|
132
|
+
"install"
|
|
133
|
+
],
|
|
122
134
|
"usage": "u-cli-mod pipeline install <project> [options]",
|
|
123
135
|
"description": "按工程 Editor 版本事务式安装适配后的 com.unity.pipeline",
|
|
124
136
|
"arguments": [
|
|
125
137
|
{
|
|
126
138
|
"name": "project",
|
|
127
139
|
"required": true,
|
|
128
|
-
"description": "
|
|
140
|
+
"description": "Unity 工程路径,必须包含 ProjectSettings/ProjectVersion.txt。"
|
|
129
141
|
}
|
|
130
142
|
],
|
|
131
143
|
"options": [
|
|
@@ -144,29 +156,31 @@
|
|
|
144
156
|
],
|
|
145
157
|
"output": {
|
|
146
158
|
"format": "json",
|
|
147
|
-
"description": "
|
|
159
|
+
"description": "返回 status(Installed/AlreadyInstalled/DryRun)、projectPath、编辑器版本、pipelineVersion、packagePath、fileCount、backupPath、sourceDir 和 sourceFileCount。"
|
|
148
160
|
},
|
|
149
161
|
"exitCodes": {
|
|
150
|
-
"0": "
|
|
151
|
-
"1": "
|
|
162
|
+
"0": "成功。",
|
|
163
|
+
"1": "编辑器占用、完整性或安装失败;事务失败时回滚。"
|
|
152
164
|
},
|
|
153
165
|
"safety": [
|
|
154
|
-
"
|
|
155
|
-
"
|
|
156
|
-
"--dry-run
|
|
157
|
-
"
|
|
158
|
-
"
|
|
166
|
+
"按暂存、校验、备份、替换、复核、回执执行安装;失败时自动回滚。",
|
|
167
|
+
"目标编辑器运行时拒绝安装,除非明确指定 --allow-running-editor。",
|
|
168
|
+
"--dry-run 不写入工程或回执。",
|
|
169
|
+
"生成源和安装结果均需匹配 expected-tree 中的 385 个文件及 SHA-256。",
|
|
170
|
+
"只写入 <project>/Packages/com.unity.pipeline 和 <project>/Library/editor-pipeline-cli。"
|
|
159
171
|
]
|
|
160
172
|
},
|
|
161
173
|
{
|
|
162
|
-
"path": [
|
|
174
|
+
"path": [
|
|
175
|
+
"setup"
|
|
176
|
+
],
|
|
163
177
|
"usage": "u-cli-mod setup <project> [options]",
|
|
164
|
-
"description": "cli install
|
|
178
|
+
"description": "依次执行 cli install 和 pipeline install。",
|
|
165
179
|
"arguments": [
|
|
166
180
|
{
|
|
167
181
|
"name": "project",
|
|
168
182
|
"required": true,
|
|
169
|
-
"description": "
|
|
183
|
+
"description": "Unity 工程路径,必须包含 ProjectSettings/ProjectVersion.txt。"
|
|
170
184
|
}
|
|
171
185
|
],
|
|
172
186
|
"options": [
|
|
@@ -189,28 +203,30 @@
|
|
|
189
203
|
],
|
|
190
204
|
"output": {
|
|
191
205
|
"format": "json",
|
|
192
|
-
"description": "
|
|
206
|
+
"description": "返回 cli(path、state、sha256)与 install 结果;--skip-cli 时 cli 为 null。"
|
|
193
207
|
},
|
|
194
208
|
"exitCodes": {
|
|
195
|
-
"0": "
|
|
196
|
-
"1": "
|
|
209
|
+
"0": "成功。",
|
|
210
|
+
"1": "任一子步骤失败,Pipeline 安装事务回滚。"
|
|
197
211
|
},
|
|
198
212
|
"safety": [
|
|
199
|
-
"
|
|
200
|
-
"
|
|
201
|
-
"--dry-run
|
|
202
|
-
"--skip-cli
|
|
213
|
+
"同时遵循 cli install 和 pipeline install 的执行边界。",
|
|
214
|
+
"目标编辑器运行时拒绝操作,除非明确指定 --allow-running-editor。",
|
|
215
|
+
"--dry-run 不写入工程。",
|
|
216
|
+
"--skip-cli 不下载 CLI。"
|
|
203
217
|
]
|
|
204
218
|
},
|
|
205
219
|
{
|
|
206
|
-
"path": [
|
|
220
|
+
"path": [
|
|
221
|
+
"exec"
|
|
222
|
+
],
|
|
207
223
|
"usage": "u-cli-mod exec <project> [options] -- <unity-cli-args...>",
|
|
208
224
|
"description": "调用路由 CLI 执行 Unity Pipeline 命令;--project-path 由工具统一绑定",
|
|
209
225
|
"arguments": [
|
|
210
226
|
{
|
|
211
227
|
"name": "project",
|
|
212
228
|
"required": true,
|
|
213
|
-
"description": "
|
|
229
|
+
"description": "Unity 工程路径,必须包含 ProjectSettings/ProjectVersion.txt。"
|
|
214
230
|
}
|
|
215
231
|
],
|
|
216
232
|
"options": [
|
|
@@ -225,24 +241,27 @@
|
|
|
225
241
|
],
|
|
226
242
|
"output": {
|
|
227
243
|
"format": "text",
|
|
228
|
-
"description": "Unity CLI
|
|
244
|
+
"description": "原样透传 Unity CLI 的标准输出和错误;达到等待时间后后台进程继续运行,返回日志路径和状态查询命令。"
|
|
229
245
|
},
|
|
230
246
|
"exitCodes": {
|
|
231
|
-
"0": "
|
|
232
|
-
"1": "
|
|
233
|
-
"N": "
|
|
247
|
+
"0": "成功。",
|
|
248
|
+
"1": "参数覆盖、CLI 缺失或篡改等调用边界检查失败。",
|
|
249
|
+
"N": "原样返回 Unity CLI 的退出码。"
|
|
234
250
|
},
|
|
235
251
|
"safety": [
|
|
236
|
-
"
|
|
237
|
-
"
|
|
238
|
-
"
|
|
239
|
-
"
|
|
240
|
-
"
|
|
241
|
-
"
|
|
252
|
+
"每次调用前复核固定 CLI 的 SHA-256,校验失败时拒绝执行。",
|
|
253
|
+
"拒绝调用方提供任何 --project-path 大小写或拼写变体。",
|
|
254
|
+
"在末尾附加解析后的 --project-path,由工具确定目标工程。",
|
|
255
|
+
"工程必须精确匹配固定路由。",
|
|
256
|
+
"参数分隔符 -- 由工具消费,不传给 Unity CLI。",
|
|
257
|
+
"长任务默认等待 5 秒后返回,任务继续在编辑器运行;用 test_status 查询,可通过 --wait 指定同步等待时长。"
|
|
242
258
|
]
|
|
243
259
|
},
|
|
244
260
|
{
|
|
245
|
-
"path": [
|
|
261
|
+
"path": [
|
|
262
|
+
"cache",
|
|
263
|
+
"clean"
|
|
264
|
+
],
|
|
246
265
|
"usage": "u-cli-mod cache clean [options]",
|
|
247
266
|
"description": "清理下载缓存与生成的适配包",
|
|
248
267
|
"arguments": [],
|
|
@@ -254,15 +273,15 @@
|
|
|
254
273
|
],
|
|
255
274
|
"output": {
|
|
256
275
|
"format": "json",
|
|
257
|
-
"description": "
|
|
276
|
+
"description": "返回 cacheRoot 与 removed 路径列表。"
|
|
258
277
|
},
|
|
259
278
|
"exitCodes": {
|
|
260
|
-
"0": "
|
|
261
|
-
"1": "
|
|
279
|
+
"0": "成功。",
|
|
280
|
+
"1": "失败。"
|
|
262
281
|
},
|
|
263
282
|
"safety": [
|
|
264
|
-
"
|
|
265
|
-
"
|
|
283
|
+
"只清理 %LOCALAPPDATA%/editor-pipeline-cli 缓存根下的目录。",
|
|
284
|
+
"默认只清理生成包和 Pipeline 下载;未指定 --all 时保留 CLI 缓存与日志。"
|
|
266
285
|
]
|
|
267
286
|
}
|
|
268
287
|
],
|
|
@@ -270,245 +289,245 @@
|
|
|
270
289
|
{
|
|
271
290
|
"group": "GameObject / 组件",
|
|
272
291
|
"tools": {
|
|
273
|
-
"add_component": "
|
|
274
|
-
"create_gameobject": "
|
|
275
|
-
"create_gameobjects": "
|
|
276
|
-
"delete_gameobject": "
|
|
277
|
-
"find_gameobjects": "
|
|
278
|
-
"get_component_properties": "
|
|
279
|
-
"remove_component": "
|
|
280
|
-
"rename_gameobject": "
|
|
281
|
-
"set_active": "
|
|
282
|
-
"set_component_properties": "
|
|
283
|
-
"set_layer": "
|
|
284
|
-
"set_parent": "
|
|
285
|
-
"set_tag": "
|
|
286
|
-
"set_transform": "
|
|
292
|
+
"add_component": "添加组件。",
|
|
293
|
+
"create_gameobject": "创建场景对象。",
|
|
294
|
+
"create_gameobjects": "批量创建场景对象。",
|
|
295
|
+
"delete_gameobject": "删除场景对象,支持撤销。",
|
|
296
|
+
"find_gameobjects": "按名称、标签、组件或层级路径查找场景对象。",
|
|
297
|
+
"get_component_properties": "读取组件序列化属性。",
|
|
298
|
+
"remove_component": "移除指定组件。",
|
|
299
|
+
"rename_gameobject": "重命名场景对象。",
|
|
300
|
+
"set_active": "设置对象激活状态。",
|
|
301
|
+
"set_component_properties": "设置组件序列化属性,支持 ObjectRef 引用。",
|
|
302
|
+
"set_layer": "设置对象层,编号范围 0–31。",
|
|
303
|
+
"set_parent": "设置父对象;未指定父对象时移至场景根。",
|
|
304
|
+
"set_tag": "设置工程中已存在的标签。",
|
|
305
|
+
"set_transform": "设置局部坐标、欧拉旋转和缩放,省略项不变。"
|
|
287
306
|
}
|
|
288
307
|
},
|
|
289
308
|
{
|
|
290
309
|
"group": "场景",
|
|
291
310
|
"tools": {
|
|
292
|
-
"add_scene_to_build": "
|
|
293
|
-
"create_scene": "
|
|
294
|
-
"get_scene_hierarchy": "
|
|
295
|
-
"list_open_scenes": "
|
|
296
|
-
"open_scene": "
|
|
297
|
-
"remove_scene_from_build": "
|
|
298
|
-
"save_all": "
|
|
299
|
-
"save_scene": "
|
|
300
|
-
"set_active_scene": "
|
|
311
|
+
"add_scene_to_build": "将场景加入构建列表。",
|
|
312
|
+
"create_scene": "创建并保存场景。",
|
|
313
|
+
"get_scene_hierarchy": "读取场景层级及 instanceId、hierarchyPath。",
|
|
314
|
+
"list_open_scenes": "列出已打开场景及加载、激活、未保存状态。",
|
|
315
|
+
"open_scene": "打开场景。",
|
|
316
|
+
"remove_scene_from_build": "从构建列表移除场景。",
|
|
317
|
+
"save_all": "保存所有已修改场景和资源。",
|
|
318
|
+
"save_scene": "保存场景。",
|
|
319
|
+
"set_active_scene": "设置活动场景。"
|
|
301
320
|
}
|
|
302
321
|
},
|
|
303
322
|
{
|
|
304
323
|
"group": "资源 / 文件",
|
|
305
324
|
"tools": {
|
|
306
|
-
"copy_asset": "
|
|
307
|
-
"create_asset": "
|
|
308
|
-
"create_folder": "
|
|
309
|
-
"delete_asset": "
|
|
310
|
-
"find_assets": "
|
|
311
|
-
"get_import_settings": "
|
|
312
|
-
"import_asset": "
|
|
313
|
-
"move_asset": "
|
|
314
|
-
"read_text_file": "
|
|
315
|
-
"rename_asset": "
|
|
316
|
-
"set_import_settings": "
|
|
317
|
-
"write_text_file": "
|
|
325
|
+
"copy_asset": "复制资源。",
|
|
326
|
+
"create_asset": "创建指定类型的资源。",
|
|
327
|
+
"create_folder": "创建目录。",
|
|
328
|
+
"delete_asset": "删除资源。需要 confirm=true。",
|
|
329
|
+
"find_assets": "查找资源。",
|
|
330
|
+
"get_import_settings": "读取资源导入设置。",
|
|
331
|
+
"import_asset": "导入或重新导入资源。",
|
|
332
|
+
"move_asset": "移动资源。",
|
|
333
|
+
"read_text_file": "读取文本文件。",
|
|
334
|
+
"rename_asset": "重命名资源。",
|
|
335
|
+
"set_import_settings": "设置资源导入参数。",
|
|
336
|
+
"write_text_file": "写入文本文件。需要 confirm=true。"
|
|
318
337
|
}
|
|
319
338
|
},
|
|
320
339
|
{
|
|
321
340
|
"group": "预制体",
|
|
322
341
|
"tools": {
|
|
323
|
-
"apply_prefab_overrides": "
|
|
324
|
-
"create_prefab": "
|
|
325
|
-
"create_prefab_variant": "
|
|
326
|
-
"instantiate_prefab": "
|
|
327
|
-
"revert_prefab_overrides": "
|
|
328
|
-
"save_prefab_contents": "
|
|
329
|
-
"unpack_prefab": "
|
|
342
|
+
"apply_prefab_overrides": "将实例覆盖应用到预制体。",
|
|
343
|
+
"create_prefab": "从场景对象创建预制体。",
|
|
344
|
+
"create_prefab_variant": "创建预制体变体。",
|
|
345
|
+
"instantiate_prefab": "将预制体实例化到场景。",
|
|
346
|
+
"revert_prefab_overrides": "还原预制体实例覆盖。",
|
|
347
|
+
"save_prefab_contents": "保存预制体内容。",
|
|
348
|
+
"unpack_prefab": "解包预制体实例。"
|
|
330
349
|
}
|
|
331
350
|
},
|
|
332
351
|
{
|
|
333
352
|
"group": "材质 / 着色器",
|
|
334
353
|
"tools": {
|
|
335
|
-
"get_material_properties": "
|
|
336
|
-
"get_shader_properties": "
|
|
337
|
-
"list_shaders": "
|
|
338
|
-
"set_material_properties": "
|
|
354
|
+
"get_material_properties": "读取材质属性。",
|
|
355
|
+
"get_shader_properties": "读取着色器属性。",
|
|
356
|
+
"list_shaders": "列出着色器。",
|
|
357
|
+
"set_material_properties": "设置材质属性。"
|
|
339
358
|
}
|
|
340
359
|
},
|
|
341
360
|
{
|
|
342
361
|
"group": "脚本 / 编译 / 求值",
|
|
343
362
|
"tools": {
|
|
344
|
-
"attach_script": "
|
|
345
|
-
"cleanup_hotreload": "
|
|
346
|
-
"create_script": "
|
|
347
|
-
"eval": "
|
|
348
|
-
"eval_file": "
|
|
349
|
-
"get_serialized_fields": "
|
|
350
|
-
"hotreload_status": "
|
|
351
|
-
"recompile": "
|
|
352
|
-
"recompile_status": "
|
|
353
|
-
"reload_file": "
|
|
354
|
-
"reload_file_override": "
|
|
355
|
-
"set_serialized_field": "
|
|
363
|
+
"attach_script": "将脚本组件添加到对象。",
|
|
364
|
+
"cleanup_hotreload": "清理热重载资源。",
|
|
365
|
+
"create_script": "创建脚本文件。",
|
|
366
|
+
"eval": "执行 C# 表达式或代码。",
|
|
367
|
+
"eval_file": "执行文件中的 C# 代码。",
|
|
368
|
+
"get_serialized_fields": "读取序列化字段。",
|
|
369
|
+
"hotreload_status": "查询热重载状态。",
|
|
370
|
+
"recompile": "触发编译并返回运行身份。",
|
|
371
|
+
"recompile_status": "按 run_id 查询编译;无法关联时返回 unknown_run。",
|
|
372
|
+
"reload_file": "重载脚本文件。",
|
|
373
|
+
"reload_file_override": "重载脚本并明确应用覆盖。",
|
|
374
|
+
"set_serialized_field": "设置序列化字段。"
|
|
356
375
|
}
|
|
357
376
|
},
|
|
358
377
|
{
|
|
359
378
|
"group": "动画 / Timeline",
|
|
360
379
|
"tools": {
|
|
361
|
-
"add_animator_layer": "
|
|
362
|
-
"add_animator_parameter": "
|
|
363
|
-
"add_animator_state": "
|
|
364
|
-
"add_animator_transition": "
|
|
365
|
-
"add_timeline_clip": "
|
|
366
|
-
"add_timeline_track": "
|
|
367
|
-
"create_animation_clip": "
|
|
368
|
-
"create_animator_controller": "
|
|
369
|
-
"create_timeline": "
|
|
370
|
-
"get_animation_clip": "
|
|
371
|
-
"get_animator_controller": "
|
|
372
|
-
"get_timeline": "
|
|
373
|
-
"remove_animation_curve": "
|
|
374
|
-
"set_animation_curve": "
|
|
380
|
+
"add_animator_layer": "添加动画控制器层。",
|
|
381
|
+
"add_animator_parameter": "添加动画参数。",
|
|
382
|
+
"add_animator_state": "添加动画状态。",
|
|
383
|
+
"add_animator_transition": "添加动画过渡。",
|
|
384
|
+
"add_timeline_clip": "添加 Timeline 片段。",
|
|
385
|
+
"add_timeline_track": "添加 Timeline 轨道。",
|
|
386
|
+
"create_animation_clip": "创建动画片段。",
|
|
387
|
+
"create_animator_controller": "创建动画控制器。",
|
|
388
|
+
"create_timeline": "创建 Timeline。",
|
|
389
|
+
"get_animation_clip": "读取动画片段。",
|
|
390
|
+
"get_animator_controller": "读取动画控制器。",
|
|
391
|
+
"get_timeline": "读取 Timeline。",
|
|
392
|
+
"remove_animation_curve": "移除动画曲线。需要 confirm=true。",
|
|
393
|
+
"set_animation_curve": "设置动画曲线。"
|
|
375
394
|
}
|
|
376
395
|
},
|
|
377
396
|
{
|
|
378
397
|
"group": "构建",
|
|
379
398
|
"tools": {
|
|
380
|
-
"build": "
|
|
381
|
-
"build_status": "
|
|
382
|
-
"get_build_settings": "
|
|
383
|
-
"list_build_profiles": "
|
|
384
|
-
"list_build_targets": "
|
|
385
|
-
"set_build_settings": "
|
|
386
|
-
"switch_build_target": "
|
|
387
|
-
"switch_build_target_status": "
|
|
399
|
+
"build": "执行构建。可用 dry_run 预演。",
|
|
400
|
+
"build_status": "查询构建状态。",
|
|
401
|
+
"get_build_settings": "读取构建设置。",
|
|
402
|
+
"list_build_profiles": "列出构建配置。",
|
|
403
|
+
"list_build_targets": "列出构建目标。",
|
|
404
|
+
"set_build_settings": "设置构建参数。可用 dry_run 预演。",
|
|
405
|
+
"switch_build_target": "切换构建目标。需要 confirm=true。",
|
|
406
|
+
"switch_build_target_status": "查询构建目标切换结果。"
|
|
388
407
|
}
|
|
389
408
|
},
|
|
390
409
|
{
|
|
391
410
|
"group": "包管理",
|
|
392
411
|
"tools": {
|
|
393
|
-
"package_add": "
|
|
394
|
-
"package_list": "
|
|
395
|
-
"package_remove": "
|
|
396
|
-
"package_resolve": "
|
|
397
|
-
"package_search": "
|
|
398
|
-
"package_status": "
|
|
412
|
+
"package_add": "添加 UPM 包。需要 confirm=true。可用 dry_run 预演。异步操作查询 package_status;涉及编译时继续查询 recompile_status。",
|
|
413
|
+
"package_list": "列出已安装或注册表中的 UPM 包。",
|
|
414
|
+
"package_remove": "移除 UPM 包。需要 confirm=true。可用 dry_run 预演。异步操作查询 package_status;涉及编译时继续查询 recompile_status。",
|
|
415
|
+
"package_resolve": "解析工程包依赖。异步操作查询 package_status;涉及编译时继续查询 recompile_status。",
|
|
416
|
+
"package_search": "搜索注册表包。",
|
|
417
|
+
"package_status": "查询包操作状态。"
|
|
399
418
|
}
|
|
400
419
|
},
|
|
401
420
|
{
|
|
402
421
|
"group": "测试",
|
|
403
422
|
"tools": {
|
|
404
|
-
"cancel_tests": "
|
|
405
|
-
"list_tests": "
|
|
406
|
-
"run_tests": "
|
|
407
|
-
"test_status": "
|
|
423
|
+
"cancel_tests": "按 run_id 取消测试;不匹配时不产生副作用。",
|
|
424
|
+
"list_tests": "列出 EditMode 或 PlayMode 测试。",
|
|
425
|
+
"run_tests": "按过滤条件执行测试;全量使用 --async_tests。",
|
|
426
|
+
"test_status": "按 run_id 查询测试;无法关联时返回 unknown_run。"
|
|
408
427
|
}
|
|
409
428
|
},
|
|
410
429
|
{
|
|
411
430
|
"group": "烘焙(光照 / NavMesh / 遮挡)",
|
|
412
431
|
"tools": {
|
|
413
|
-
"bake_lighting": "
|
|
414
|
-
"bake_navmesh": "
|
|
415
|
-
"bake_navmesh_surfaces": "
|
|
416
|
-
"bake_occlusion_culling": "
|
|
417
|
-
"cancel_lighting_bake": "
|
|
418
|
-
"cancel_navmesh_bake": "
|
|
419
|
-
"cancel_occlusion_bake": "
|
|
420
|
-
"clear_baked_lighting": "
|
|
421
|
-
"clear_navmesh": "
|
|
422
|
-
"clear_occlusion_culling": "
|
|
423
|
-
"get_lighting_settings": "
|
|
424
|
-
"get_navmesh_settings": "
|
|
425
|
-
"lighting_bake_status": "
|
|
426
|
-
"navmesh_bake_status": "
|
|
427
|
-
"occlusion_bake_status": "
|
|
428
|
-
"set_lighting_settings": "
|
|
429
|
-
"set_navmesh_settings": "
|
|
432
|
+
"bake_lighting": "异步烘焙光照。",
|
|
433
|
+
"bake_navmesh": "异步烘焙导航网格。",
|
|
434
|
+
"bake_navmesh_surfaces": "烘焙 NavMeshSurface;缺少 AI Navigation 包时返回 package_not_found。",
|
|
435
|
+
"bake_occlusion_culling": "异步烘焙遮挡剔除。",
|
|
436
|
+
"cancel_lighting_bake": "取消光照烘焙。",
|
|
437
|
+
"cancel_navmesh_bake": "取消导航网格烘焙。",
|
|
438
|
+
"cancel_occlusion_bake": "取消遮挡剔除烘焙。",
|
|
439
|
+
"clear_baked_lighting": "清理烘焙光照数据。需要 confirm=true。",
|
|
440
|
+
"clear_navmesh": "清理导航网格。需要 confirm=true。",
|
|
441
|
+
"clear_occlusion_culling": "清理遮挡剔除数据。需要 confirm=true。",
|
|
442
|
+
"get_lighting_settings": "读取光照烘焙设置。",
|
|
443
|
+
"get_navmesh_settings": "读取导航网格设置。",
|
|
444
|
+
"lighting_bake_status": "查询光照烘焙状态。",
|
|
445
|
+
"navmesh_bake_status": "查询导航网格烘焙状态。",
|
|
446
|
+
"occlusion_bake_status": "查询遮挡剔除烘焙状态。",
|
|
447
|
+
"set_lighting_settings": "设置光照烘焙参数,返回 applied 和 unknown。",
|
|
448
|
+
"set_navmesh_settings": "设置导航网格参数。"
|
|
430
449
|
}
|
|
431
450
|
},
|
|
432
451
|
{
|
|
433
452
|
"group": "截图 / 捕获",
|
|
434
453
|
"tools": {
|
|
435
|
-
"capture_editor_element": "
|
|
436
|
-
"capture_game_view": "
|
|
437
|
-
"capture_runtime_element": "
|
|
438
|
-
"capture_scene_view": "
|
|
439
|
-
"screenshot": "
|
|
454
|
+
"capture_editor_element": "截取编辑器 UI Toolkit 元素。",
|
|
455
|
+
"capture_game_view": "截取游戏视图;source=screen 需要运行模式并包含叠加画布,source=camera 按相机渲染。设置 save_path 时默认只返回路径,include_inline_image=true 可同时返回图片。",
|
|
456
|
+
"capture_runtime_element": "截取运行时 UI Toolkit 元素。",
|
|
457
|
+
"capture_scene_view": "截取当前场景视图。设置 save_path 时默认只返回路径,include_inline_image=true 可同时返回图片。",
|
|
458
|
+
"screenshot": "截取场景或游戏视图并返回文件路径。"
|
|
440
459
|
}
|
|
441
460
|
},
|
|
442
461
|
{
|
|
443
462
|
"group": "编辑器控制",
|
|
444
463
|
"tools": {
|
|
445
|
-
"editor_focus": "
|
|
446
|
-
"editor_pause": "
|
|
447
|
-
"editor_play": "
|
|
448
|
-
"editor_status": "
|
|
449
|
-
"editor_stop": "
|
|
450
|
-
"menu": "
|
|
451
|
-
"set_autotick": "
|
|
464
|
+
"editor_focus": "激活 Unity Editor 窗口。",
|
|
465
|
+
"editor_pause": "切换运行模式的暂停状态。",
|
|
466
|
+
"editor_play": "进入运行模式。",
|
|
467
|
+
"editor_status": "读取编辑器状态。",
|
|
468
|
+
"editor_stop": "退出运行模式。",
|
|
469
|
+
"menu": "执行或列出菜单项。",
|
|
470
|
+
"set_autotick": "在窗口失焦时保持编辑器周期更新。"
|
|
452
471
|
}
|
|
453
472
|
},
|
|
454
473
|
{
|
|
455
474
|
"group": "可观测性 / 审计",
|
|
456
475
|
"tools": {
|
|
457
|
-
"audit": "
|
|
458
|
-
"audit_status": "
|
|
459
|
-
"clear_console": "
|
|
460
|
-
"console": "
|
|
461
|
-
"get_console_logs": "
|
|
462
|
-
"read_console": "
|
|
463
|
-
"get_performance_stats": "
|
|
464
|
-
"log": "
|
|
476
|
+
"audit": "记录或查询编辑器审计信息。",
|
|
477
|
+
"audit_status": "查询审计状态。",
|
|
478
|
+
"clear_console": "清空 Console。",
|
|
479
|
+
"console": "读取回调捕获的日志流,支持游标跟随。",
|
|
480
|
+
"get_console_logs": "读取原生 Console 日志。",
|
|
481
|
+
"read_console": "读取原生 Console 日志,按类型和数量过滤。",
|
|
482
|
+
"get_performance_stats": "读取性能统计。",
|
|
483
|
+
"log": "写入 Console 日志。"
|
|
465
484
|
}
|
|
466
485
|
},
|
|
467
486
|
{
|
|
468
487
|
"group": "项目设置",
|
|
469
488
|
"tools": {
|
|
470
|
-
"get_audio_settings": "
|
|
471
|
-
"get_graphics_settings": "
|
|
472
|
-
"get_input_settings": "
|
|
473
|
-
"get_physics_settings": "
|
|
474
|
-
"get_player_settings": "
|
|
475
|
-
"get_quality_settings": "
|
|
476
|
-
"get_tags_layers": "
|
|
477
|
-
"get_time_settings": "
|
|
478
|
-
"set_audio_settings": "
|
|
479
|
-
"set_graphics_settings": "
|
|
480
|
-
"set_input_settings": "
|
|
481
|
-
"set_physics_settings": "
|
|
482
|
-
"set_player_settings": "
|
|
483
|
-
"set_quality_settings": "
|
|
484
|
-
"set_tags_layers": "
|
|
485
|
-
"set_time_settings": "
|
|
489
|
+
"get_audio_settings": "读取音频设置。",
|
|
490
|
+
"get_graphics_settings": "读取图形设置。",
|
|
491
|
+
"get_input_settings": "读取输入设置。",
|
|
492
|
+
"get_physics_settings": "读取物理设置。",
|
|
493
|
+
"get_player_settings": "读取应用设置。",
|
|
494
|
+
"get_quality_settings": "读取质量设置。",
|
|
495
|
+
"get_tags_layers": "读取标签与层。",
|
|
496
|
+
"get_time_settings": "读取时间设置。",
|
|
497
|
+
"set_audio_settings": "修改音频设置。需要 confirm=true。可用 dry_run 预演。",
|
|
498
|
+
"set_graphics_settings": "修改图形设置。需要 confirm=true。可用 dry_run 预演。",
|
|
499
|
+
"set_input_settings": "修改输入设置。需要 confirm=true。可用 dry_run 预演。",
|
|
500
|
+
"set_physics_settings": "修改物理设置。需要 confirm=true。可用 dry_run 预演。",
|
|
501
|
+
"set_player_settings": "修改应用设置。需要 confirm=true。可用 dry_run 预演。",
|
|
502
|
+
"set_quality_settings": "修改质量设置。需要 confirm=true。可用 dry_run 预演。",
|
|
503
|
+
"set_tags_layers": "修改标签与层。需要 confirm=true。可用 dry_run 预演。",
|
|
504
|
+
"set_time_settings": "修改时间设置。需要 confirm=true。可用 dry_run 预演。"
|
|
486
505
|
}
|
|
487
506
|
},
|
|
488
507
|
{
|
|
489
508
|
"group": "运行时 / 输入模拟",
|
|
490
509
|
"tools": {
|
|
491
|
-
"quit": "
|
|
492
|
-
"runtime_status": "
|
|
493
|
-
"set_target_framerate": "
|
|
494
|
-
"set_timescale": "
|
|
495
|
-
"simulate_key": "
|
|
496
|
-
"simulate_pointer": "
|
|
510
|
+
"quit": "正常退出 Unity 应用。",
|
|
511
|
+
"runtime_status": "读取运行时状态。",
|
|
512
|
+
"set_target_framerate": "设置目标帧率。",
|
|
513
|
+
"set_timescale": "设置时间缩放。",
|
|
514
|
+
"simulate_key": "模拟键盘事件。",
|
|
515
|
+
"simulate_pointer": "模拟指针事件。"
|
|
497
516
|
}
|
|
498
517
|
},
|
|
499
518
|
{
|
|
500
519
|
"group": "选择 / 搜索",
|
|
501
520
|
"tools": {
|
|
502
|
-
"get_selection": "
|
|
503
|
-
"search": "
|
|
504
|
-
"set_selection": "
|
|
521
|
+
"get_selection": "读取当前选择的对象身份。",
|
|
522
|
+
"search": "执行 Unity Search 查询。",
|
|
523
|
+
"set_selection": "设置当前选择。"
|
|
505
524
|
}
|
|
506
525
|
},
|
|
507
526
|
{
|
|
508
527
|
"group": "Authoring 根路径",
|
|
509
528
|
"tools": {
|
|
510
|
-
"get_authoring_root": "
|
|
511
|
-
"set_authoring_root": "
|
|
529
|
+
"get_authoring_root": "读取资源编辑根目录。",
|
|
530
|
+
"set_authoring_root": "设置并约束资源编辑根目录。"
|
|
512
531
|
}
|
|
513
532
|
}
|
|
514
533
|
]
|