@kevlns/u-cli-mod 0.1.1 → 0.1.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/README.md +12 -10
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -52,9 +52,11 @@ u-cli-mod routes # 列出支持的 Editor 路由
|
|
|
52
52
|
|
|
53
53
|
## Usage
|
|
54
54
|
|
|
55
|
+
> 示例中的 `<project>` 指代你的 Unity 工程目录,请替换为实际路径。
|
|
56
|
+
|
|
55
57
|
```bash
|
|
56
58
|
# 只读检查工程与路由
|
|
57
|
-
u-cli-mod doctor
|
|
59
|
+
u-cli-mod doctor <project>
|
|
58
60
|
|
|
59
61
|
# 列出支持的 Editor 路由
|
|
60
62
|
u-cli-mod routes
|
|
@@ -63,17 +65,17 @@ u-cli-mod routes
|
|
|
63
65
|
u-cli-mod cli install
|
|
64
66
|
|
|
65
67
|
# 预览 Pipeline 安装(不写入)
|
|
66
|
-
u-cli-mod pipeline install
|
|
68
|
+
u-cli-mod pipeline install <project> --dry-run
|
|
67
69
|
|
|
68
70
|
# 正式安装(先关闭目标工程的 Unity Editor)
|
|
69
|
-
u-cli-mod pipeline install
|
|
71
|
+
u-cli-mod pipeline install <project>
|
|
70
72
|
|
|
71
73
|
# CLI + Pipeline 一键准备
|
|
72
|
-
u-cli-mod setup
|
|
74
|
+
u-cli-mod setup <project>
|
|
73
75
|
|
|
74
76
|
# 执行 Unity Pipeline 命令(自动绑定目标工程)
|
|
75
|
-
u-cli-mod exec
|
|
76
|
-
u-cli-mod exec
|
|
77
|
+
u-cli-mod exec <project> -- command editor_status
|
|
78
|
+
u-cli-mod exec <project> -- command get_scene_hierarchy
|
|
77
79
|
|
|
78
80
|
# 清理缓存
|
|
79
81
|
u-cli-mod cache clean
|
|
@@ -109,7 +111,7 @@ npm run check # build + lint + 110 个 vitest 测试 + pack guard
|
|
|
109
111
|
|
|
110
112
|
`pack:guard` 会执行真实 `npm pack`(含文件清单校验),断言发布包:
|
|
111
113
|
|
|
112
|
-
- 包名为 `@kevlns/u-cli-mod`,tgz 文件名精确为 `kevlns-u-cli-mod-0.1.
|
|
114
|
+
- 包名为 `@kevlns/u-cli-mod`,tgz 文件名精确为 `kevlns-u-cli-mod-0.1.2.tgz`(与 package.json 版本一致);
|
|
113
115
|
- `files` 必须包含 `v-cli.plugin.json`,且清单身份字段(schemaVersion/package/command/bin/platforms)与包一致;
|
|
114
116
|
- 不出现:
|
|
115
117
|
|
|
@@ -129,7 +131,7 @@ npm run check # build + lint + 110 个 vitest 测试 + pack guard
|
|
|
129
131
|
npm run test:package
|
|
130
132
|
```
|
|
131
133
|
|
|
132
|
-
构建真实 tgz,并在本地验证三种消费方式:工程 devDependency(`node_modules/.bin`)、带临时 `--prefix` 的全局安装、`npx --package <本地tgz>`;每种都执行 `u-cli-mod --version` 与 `u-cli-mod routes`。**不会**向任何 registry
|
|
134
|
+
构建真实 tgz,并在本地验证三种消费方式:工程 devDependency(`node_modules/.bin`)、带临时 `--prefix` 的全局安装、`npx --package <本地tgz>`;每种都执行 `u-cli-mod --version` 与 `u-cli-mod routes`。**不会**向任何 registry 发布。报告:`<临时目录>/u-cli-mod-package-test-report.json`(可用 `EPC_PKG_REPORT` 覆盖)。
|
|
133
135
|
|
|
134
136
|
### 自托管 Runner 与 Unity E2E
|
|
135
137
|
|
|
@@ -139,7 +141,7 @@ npm run e2e:windows # 完整 Unity E2E(真实下载/转换/编译/命
|
|
|
139
141
|
```
|
|
140
142
|
|
|
141
143
|
- `preflight:runner` 只读,不下载/注册 Runner;结果 JSON 输出到 stdout。
|
|
142
|
-
- `e2e:windows` 使用**隔离缓存**(干净环境)或显式复用已验证缓存,创建
|
|
144
|
+
- `e2e:windows` 使用**隔离缓存**(干净环境)或显式复用已验证缓存,创建 `<临时目录>/u-cli-mod-e2e/` 下独立临时工程,全部结束后杀掉它启动的所有 Unity 进程并清理临时工程;报告写入 `<临时目录>/u-cli-mod-e2e-report.json`(分别可用 `EPC_E2E_ROOT`、`EPC_E2E_REPORT` 覆盖)。
|
|
143
145
|
- 验收指标:200 次只读调用 100% 成功并记录 P50/P95、20 轮资源修改、5 次 Domain Reload 首次恢复、强杀重启恢复、双工程显式路由 60 次无误选、运行中 Editor 防护与 `--project-path` 覆盖拒绝。
|
|
144
146
|
|
|
145
147
|
详细说明见 `docs/SELF_HOSTED_RUNNER.md`。
|
|
@@ -179,7 +181,7 @@ kevlns 工具家族共享同一套发布约定(tag 驱动、CI 护栏、MIT)
|
|
|
179
181
|
| --- | --- | --- |
|
|
180
182
|
| [`v-cli`](https://github.com/kevlns/v-cli) | 个人工具箱 CLI | v0.2.1 |
|
|
181
183
|
| [`xlmerge`](https://github.com/kevlns/xlmerge) | Git 中 .xlsx/.xlsm 冲突可视化解决工具 | v1.2.2 |
|
|
182
|
-
| [`u-cli-mod`](https://github.com/kevlns/u-cli-mod) | Unity 精确版本路由 + CLI + pipeline 包(Windows-first,本仓库) | v0.1.
|
|
184
|
+
| [`u-cli-mod`](https://github.com/kevlns/u-cli-mod) | Unity 精确版本路由 + CLI + pipeline 包(Windows-first,本仓库) | v0.1.2 |
|
|
183
185
|
|
|
184
186
|
## Compatibility
|
|
185
187
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kevlns/u-cli-mod",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "u-cli-mod: pin exact Unity Editor version routes and install the adapted com.unity.pipeline package for Unity 2022 (Windows-first). Downloads Unity assets at runtime into the user cache; the package itself contains no Unity binaries or package source. Not an official Unity project.",
|
|
5
5
|
"private": false,
|
|
6
6
|
"publishConfig": {
|