@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/README.md CHANGED
@@ -1,60 +1,42 @@
1
- <div align="center">
1
+ # Vant Unity 工程工具
2
2
 
3
- <img src="https://raw.githubusercontent.com/kevlns/u-cli-mod/main/logo.png" alt="u-cli-mod logo" width="320" />
3
+ `@kevlns/u-cli-mod`
4
4
 
5
- # u-cli-mod
5
+ ## 功能
6
6
 
7
- **按精确 Unity Editor 版本路由、下载并安装 Unity CLI 与适配后 `com.unity.pipeline` 的命令行工具(Windows-first)。**
7
+ 按 Unity Editor 精确版本定位工具链,校验和安装 com.unity.pipeline,并执行工程命令。
8
8
 
9
- [![npm version](https://img.shields.io/npm/v/%40kevlns%2Fu-cli-mod?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@kevlns/u-cli-mod)
10
- [![npm downloads](https://img.shields.io/npm/dm/%40kevlns%2Fu-cli-mod?style=flat-square&color=4c8bf5)](https://www.npmjs.com/package/@kevlns/u-cli-mod)
11
- [![CI](https://img.shields.io/github/actions/workflow/status/kevlns/u-cli-mod/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/kevlns/u-cli-mod/actions/workflows/ci.yml)
12
- [![license](https://img.shields.io/github/license/kevlns/u-cli-mod?style=flat-square&color=2e8b57)](./LICENSE)
9
+ ## 环境要求
13
10
 
14
- [Getting started](#getting-started) · [Usage](#usage) · [Routes](#routes) · [Package family](#package-family)
11
+ Node.js 20 及以上、Windows 10 及以上;支持的 Editor 版本与 revision 由 routes 命令提供。
15
12
 
16
- </div>
13
+ ## 安装
17
14
 
18
- ---
15
+ ```sh
16
+ npm install -g @kevlns/u-cli-mod
17
+ ```
19
18
 
20
- > **这不是 Unity 官方项目**,与 Unity Technologies 无隶属关系;`com.unity.pipeline` 的 Unity 2022 适配属于非官方移植。
19
+ ## 快速开始
21
20
 
22
- ## Why u-cli-mod?
21
+ ```sh
22
+ u-cli-mod routes
23
+ u-cli-mod doctor <工程目录>
24
+ u-cli-mod setup <工程目录>
25
+ ```
26
+
27
+ ## 使用说明
28
+
29
+ ### 功能说明
23
30
 
24
31
  Unity 工程自动化通常需要把「编辑器版本」与「CLI 工具链」精确锁定。u-cli-mod 让这件事在 Windows 上**可复现、可校验、可回滚**:
25
32
 
26
33
  - **精确版本路由** - 以 `m_EditorVersion` + revision 双重匹配定位路由,没有“就近版本”回退,版本不在路由表内时如实报告而非猜测
27
34
  - **可验证下载** - Unity CLI 固定 SHA-256 + 文件大小 + Authenticode 签名主体与证书指纹;`com.unity.pipeline` 固定 SHA-256(主)+ SHA-1(交叉)
28
35
  - **确定性转换** - 在用户缓存中把 `com.unity.pipeline` 适配到 Unity 2022,输出与 `routes/expected-tree/*.json`(385 个文件)逐字节一致
29
- - **事务式安装** - staging → 校验 → 备份 → 替换 → 再校验 → receipt,任一步失败自动回滚;运行中的 Editor fail-closed
36
+ - **事务式安装** - staging → 校验 → 备份 → 替换 → 再校验 → receipt,任一步失败自动回滚;运行中的 Editor 校验失败时拒绝执行
30
37
  - **工程绑定** - `exec` 每次重新校验 CLI 哈希,并禁止任何 `--project-path` 变体覆盖目标工程
31
38
 
32
- ## Getting started
33
-
34
- ### Install
35
-
36
- ```bash
37
- npm install -g @kevlns/u-cli-mod
38
-
39
- # 或不安装,直接运行:
40
- npx --package @kevlns/u-cli-mod u-cli-mod routes
41
- ```
42
-
43
- 要求 Node.js >= 20(Windows 10+)。
44
-
45
- ### Quick start
46
-
47
- ```bash
48
- u-cli-mod doctor <project> # 只读体检:路由 / CLI / 适配包状态
49
- u-cli-mod setup <project> # CLI + 适配包一键就绪(推荐首次入口)
50
- u-cli-mod routes # 列出支持的 Editor 路由
51
- ```
52
-
53
- 升级 npm 包不会自动替换已有工程的 `Packages/com.unity.pipeline`。检查 `doctor` 的 `pipeline.state`:只有 `current` 且 `installed=true` 才表示当前补丁完整;`outdated`/`invalid` 时关闭目标 Unity Editor 后执行 `u-cli-mod pipeline install <project> --force`(自动备份)。`patchVersion` 是路由要求,`installedPatchVersion` 来自安装 receipt;仅看到上游版本 `0.5.0-exp.1` 或诊断退出码 0 不代表适配包已更新。
54
-
55
- 就绪状态以当前路由的完整文件树为准,旧 receipt、缺失 receipt 或生成缓存未就绪均不会推翻已通过校验的安装。`pipeline.verification` 提供 `mismatches`、`lineEndingDifferences` 和 `error`,可直接定位失效原因。新生成的文本统一 LF;已安装 UTF-8 文本只接受 LF/CRLF 的等价差异,不忽略 BOM、空白、实际内容、缺失或额外文件,二进制保持 SHA-256 严格校验。生成缓存与安装 staging 仍要求精确字节。
56
-
57
- ## Usage
39
+ ### 操作流程
58
40
 
59
41
  > 示例中的 `<project>` 指代你的 Unity 工程目录,请替换为实际路径。
60
42
 
@@ -97,78 +79,18 @@ u-cli-mod cache clean
97
79
 
98
80
  长任务(`run_tests`)默认只等待 5 秒:到点后任务仍在 Unity Editor 内继续执行,工具打印输出日志路径并立即返回(退出码 0);结果用 `command test_status` 轮询,需要同步等待时用 `--wait <秒>`(`0` = 立即返回)。
99
81
 
100
- ## 原理
101
-
102
- 1. 读取目标工程 `ProjectSettings/ProjectVersion.txt`,要求 `m_EditorVersion` 与 `m_EditorVersionWithRevision` **同时存在且与路由完全一致**(fail-closed,无通配、无“最近版本”回退)。
103
- 2. 按路由下载固定版本的 Unity CLI:HTTPS 白名单(仅 Unity 官方 CDN),校验固定 SHA-256 + 文件大小 + Authenticode 签名主体与证书指纹,临时文件原子更名为最终文件。
104
- 3. 按路由下载固定版本的 `com.unity.pipeline` tgz:固定 SHA-256(主)+ SHA-1(交叉),安全解包(解包前逐项拒绝绝对路径、`..`、符号/硬链接等非常规条目)。
105
- 4. 在**用户缓存**中确定性转换:`package.json` 最低 Unity 版本、`PhysicsMaterial` 兼容、`rawRenderQueue` 读取兼容、基于 `UnityEditor.LogEntries` 的 `read_console`、Roslyn DLL 的 `.meta` 转为 Unity 2022 格式(保留 GUID)、删除 `Tests` 源码与失效签名文件;输出必须与 `routes/expected-tree/*.json`(含 `Tests.meta` 共 385 个文件)逐字节一致。
106
- 5. 事务式安装到 `Packages/com.unity.pipeline`:staging → 校验 → 备份 → 替换 → 再校验 → receipt;任一步失败自动回滚。运行中的 Unity Editor 会 fail-closed 阻止安装。
107
- 6. `exec` 每次调用前重新校验 CLI 哈希,并**禁止任何 `--project-path` 变体覆盖目标工程**。
82
+ ### 工作原理
108
83
 
109
- > **缓存目录说明**:用户缓存固定为 `%LOCALAPPDATA%\editor-pipeline-cli`,工程内的安装事务目录固定为 `Library/editor-pipeline-cli`。两个目录名是缓存与 receipt 契约的一部分,不随 npm 包名(`@kevlns/u-cli-mod`)变化;改名会使既有缓存与 receipt 失效。
84
+ 读取 `ProjectSettings/ProjectVersion.txt` 中的版本和 revision,按精确路由下载并校验工具。安装按暂存、校验、备份、替换、复核、回执顺序执行,失败时回滚。用户缓存位于 `%LOCALAPPDATA%/editor-pipeline-cli`,工程事务记录位于 `Library/editor-pipeline-cli`。缓存生成要求精确字节;已安装文本允许 LF/CRLF 等价,实际内容与二进制仍严格校验。
110
85
 
111
- ## 包内容与分发边界
86
+ ### 分发边界
112
87
 
113
88
  - ✅ 只包含本工具自己的 TypeScript 代码、版本路由元数据与哈希清单。
114
89
  - ✅ Unity CLI 与 `com.unity.pipeline` 在**运行时**从 Unity 官方地址下载到**用户缓存**。
115
90
  - ❌ 仓库和 npm 包**不包含**任何 Unity 二进制(`.exe`/`.dll`)、tgz 或 `com.unity.pipeline` 源码。
116
91
  - ❌ 无 `postinstall`;安装 npm 包不会下载或修改任何工程。
117
92
 
118
- ## 质量与 CI
119
-
120
- ### 单元测试与打包守卫
121
-
122
- ```bash
123
- npm run check # build + lint + vitest 测试 + pack guard
124
- ```
125
-
126
- > 发版除 `npm version` 外,还需同步 tests/scripts 中的版本断言(`cli.test.ts`、`vcli-manifest.test.ts`、`pack-guard.mjs`、`test-package-install.mjs`):grep 旧版本号应为零,再打 tag。
127
-
128
- `pack:guard` 会执行真实 `npm pack`(含文件清单校验),断言发布包:
129
-
130
- - 包名为 `@kevlns/u-cli-mod`,tgz 文件名精确为 `kevlns-u-cli-mod-0.2.3.tgz`(与 package.json 版本一致);
131
- - `files` 必须包含 `v-cli.plugin.json`,且清单身份字段(schemaVersion/package/command/bin/platforms)与包一致;
132
- - 不出现:
133
-
134
- ```text
135
- *.exe *.dll *.tgz *.pdb
136
- *.cs *.unity *.asmdef *.prefab *.asset
137
- 完整 com.unity.pipeline 目录树
138
- ```
139
-
140
- ### v-cli 插件清单
141
-
142
- `v-cli.plugin.json` 随包发布(`package.json` 中 `vCli.manifest` 指向),声明 v-cli 命令 `unity`(平台 win32)与全部公共命令路径、参数、选项、输出与副作用元数据。`tests/vcli-manifest.test.ts` 以 `buildProgram()` 为行为源校验清单:命令树、参数、选项(flags 与描述)、usage 逐项一致;同一测试还把 AGENTS.md 的 154 条 Pipeline 命令目录与清单逐条互锁——两处任一未同步都会失败。
143
-
144
- ### 本地 tarball 安装矩阵(三模式验证)
145
-
146
- ```bash
147
- npm run test:package
148
- ```
149
-
150
- 构建真实 tgz,并在本地验证三种消费方式:工程 devDependency(`node_modules/.bin`)、带临时 `--prefix` 的全局安装、`npx --package <本地tgz>`;每种都执行 `u-cli-mod --version` 与 `u-cli-mod routes`。**不会**向任何 registry 发布。报告:`C:/tmp/u-cli-mod-package-test-report.json`(可用 `EPC_PKG_REPORT` 覆盖)。
151
-
152
- ### 自托管 Runner 与 Unity E2E
153
-
154
- ```bash
155
- npm run preflight:runner # 注册前环境预检(Node/npm/Git/Unity 版本/revision/许可证探针)
156
- npm run e2e:windows # 完整 Unity E2E(真实下载/转换/编译/命令/重载/重启/多编辑器)
157
- ```
158
-
159
- - `preflight:runner` 只读,不下载/注册 Runner;结果 JSON 输出到 stdout。
160
- - `e2e:windows` 默认使用隔离缓存(设 `EPC_E2E_FRESH_CACHE=0` 可复用真实用户缓存),在 `C:/tmp/u-cli-mod-e2e/` 下创建独立临时工程,全部结束后杀掉它启动的所有 Unity 进程并清理临时工程;报告写入 `C:/tmp/u-cli-mod-e2e-report.json`(分别可用 `EPC_E2E_ROOT`、`EPC_E2E_REPORT` 覆盖)。
161
- - 验收指标:200 次只读调用 100% 成功并记录 P50/P95、`read_console` 原生 Console 历史读取与统一清理、20 轮资源修改、5 次 Domain Reload 首次恢复、强杀重启恢复、双工程显式路由 60 次无误选、运行中 Editor 防护与 `--project-path` 覆盖拒绝。
162
-
163
- 详细说明见 `docs/SELF_HOSTED_RUNNER.md`。
164
-
165
- ### GitHub Actions
166
-
167
- - `.github/workflows/ci.yml`:hosted windows runner 上跑 `npm ci` + `npm run check` + `npm audit --omit=dev` + 违禁产物扩展名扫描;push/PR 触发。
168
- - `.github/workflows/e2e-windows.yml`:**self-hosted** runner(标签 `self-hosted/windows/unity-2022.3.62f3c1`)上跑 Unity E2E;仅 `workflow_dispatch` 与受保护 `v*` tag 触发,不跑 pull_request,不发布;权限最小化(contents: read);产物 `u-cli-mod-e2e-report`。
169
- - `.github/workflows/publish.yml`:`v*` tag 触发,GitHub 托管 runner 上以 OIDC Trusted Publisher 短期凭证发布到 npm,不保存长期 NPM_TOKEN。
170
-
171
- ## Routes
93
+ ### 支持路由
172
94
 
173
95
  | Editor | Revision | CLI | Pipeline | 状态 |
174
96
  |---|---|---|---|---|
@@ -177,7 +99,7 @@ npm run e2e:windows # 完整 Unity E2E(真实下载/转换/编译/命
177
99
 
178
100
  新增 Editor 版本要求:添加 `routes/<版本>.json` 与 `routes/expected-tree/<版本>.json`、对应转换模板与补丁规则,并在该版本 Unity 上完成编译与回归测试;相近版本不得复用既有路由。
179
101
 
180
- ## 目录
102
+ ### 目录结构
181
103
 
182
104
  ```text
183
105
  routes/ 精确版本路由;expected-tree/ 子目录为 385 文件 SHA-256 清单(含 Tests.meta)
@@ -189,39 +111,20 @@ scripts/ pack-guard / preflight-runner / e2e-windows / test-package-inst
189
111
  .github/workflows/ hosted CI + self-hosted E2E
190
112
  ```
191
113
 
192
- ## Package family
193
-
194
- kevlns 工具家族共享同一套发布约定(tag 驱动、CI 护栏、MIT)。
114
+ ## 开发与验证
195
115
 
196
- | Package | Purpose | Version |
197
- | --- | --- | --- |
198
- | [`v-cli`](https://github.com/kevlns/v-cli) | 个人工具箱 CLI | v0.2.14 |
199
- | [`xlmerge`](https://github.com/kevlns/xlmerge) | Git 中 .xlsx/.xlsm 冲突可视化解决工具 | v2.0.0 |
200
- | [`u-cli-mod`](https://github.com/kevlns/u-cli-mod) | Unity 精确版本路由 + CLI + pipeline 包(Windows-first,本仓库) | v0.2.3 |
201
- | [`figma-to-uprefab`](https://github.com/kevlns/figma-to-uprefab) | Figma 导出、契约校验与 Unity UGUI staging Prefab 构建 | v0.1.1 |
202
-
203
- ## Compatibility
204
-
205
- | Runtime | Supported versions |
206
- | --- | --- |
207
- | Node.js | `20` and later |
208
- | Unity Editor | `2022.3.62f3c1` / `2022.3.59f1c1`(精确路由,见 Routes) |
209
-
210
- ## Contributing
211
-
212
- ```bash
116
+ ```sh
213
117
  npm ci
214
- npm run check # build + lint + vitest 测试 + pack guard
118
+ npm run check
119
+ npm run test:package
215
120
  ```
216
121
 
217
- For bugs and feature requests, use [GitHub Issues](https://github.com/kevlns/u-cli-mod/issues).
218
-
219
- ## License
122
+ 命令返回、结构校验、模拟测试与外部平台实际运行分别核验。发布版本和依赖以随包 `package.json` 为准。
220
123
 
221
- 本工具代码为 MIT(见 LICENSE)。运行时下载的 Unity CLI 与 `com.unity.pipeline` 归其各自的 Unity 许可(如 Unity Package Distribution License)约束,不在本仓库/包内分发。
124
+ ## 文档
222
125
 
223
- <div align="center">
126
+ [Agent 调用规范](AGENTS.md) · [文档规范](docs/documentation.md) · [自托管 Unity E2E Runner(本地准备指南)](docs/SELF_HOSTED_RUNNER.md)
224
127
 
225
- Part of the **kevlns** tool family.
128
+ ## 许可与版权
226
129
 
227
- </div>
130
+ 本工具采用 [MIT 许可](LICENSE)。Copyright © 2026 Vant。Vant 为工具集品牌;Figma、Unity、Steam、微信及其组件归各自权利人所有,第三方组件适用各自许可。
package/dist/cli.js CHANGED
@@ -88,7 +88,7 @@ export function buildProgram() {
88
88
  });
89
89
  program
90
90
  .command('setup <project>')
91
- .description('cli install + pipeline install')
91
+ .description('依次执行 cli install 和 pipeline install。')
92
92
  .option('--force', '覆盖现有不一致的包')
93
93
  .option('--allow-running-editor', '跳过运行中 Editor 的 fail-closed 保护')
94
94
  .option('--dry-run', '只校验与预览,不写入工程')
@@ -0,0 +1,100 @@
1
+ # Vant 自托管 Unity E2E Runner(本地准备指南)
2
+
3
+ ## 定位
4
+
5
+ 自托管 Unity E2E Runner(本地准备指南),适用于当前随包实现。
6
+
7
+ ## 前置条件
8
+
9
+ 先按包的环境要求准备工程与工具,使用实际配置和命令帮助核对目标。
10
+
11
+ ## 操作流程
12
+
13
+ 仓库:github.com/kevlns/u-cli-mod(Windows-first,非 Unity 官方项目)。
14
+ 本仓库工具链不含发布能力,npm 发布仅由 GitHub Actions 的 publish 工作流完成。以下内容是 **注册前检查清单**。实际注册
15
+ 应在 GitHub 仓库 `Settings -> Actions -> Runners` 中完成(需要仓库管理员权限),
16
+ 本工具只会做只读预检,**不会下载或注册 Runner**。
17
+
18
+ ### 建议机器
19
+
20
+ - 专用 Windows 10/11 或 Windows Server 虚拟机(推荐),或专用物理机。
21
+ - 至少 8 GB 内存、20 GB 空闲磁盘。
22
+ - 不建议长期使用日常开发机,避免执行仓库内不可信任务。
23
+
24
+ ### 必须安装
25
+
26
+ | 组件 | 要求 | 验证 |
27
+ |---|---|---|
28
+ | Windows | 10/11 x64 | `winver` |
29
+ | Git | >= 2.40 | `git --version` |
30
+ | Node.js | >= 20 LTS | `node --version` |
31
+ | npm | 随 Node | `npm --version` |
32
+ | Unity Hub | 任意近期版本 | - |
33
+ | Unity Editor | `2022.3.62f3c1`,含 Windows build support | 见下方预检 |
34
+ | Unity 许可证 | 可用的个人/专业许可 | 预检中的 license probe |
35
+
36
+ ### 预检命令(不注册、不下载、只读)
37
+
38
+ ```powershell
39
+ cd u-cli-mod
40
+ npm ci
41
+ npm run build
42
+ npm run preflight:runner
43
+ ```
44
+
45
+ 输出为 JSON:`pass: true` 且所有 `checks[].ok` 为 true 时,环境即可注册。
46
+ 预检包含一个 Unity batchmode 许可证探针(在临时目录创建一次性 scratch
47
+ 工程并 `-quit`,结束后删除),耗时约 1–3 分钟;
48
+ 可用 `EPC_PREFLIGHT_SKIP_LICENSE=1` 跳过。
49
+
50
+ 常用环境变量:
51
+
52
+ - `EPC_UNITY_PATH`:Unity.exe 自定义路径。
53
+ - `EPC_RUNNER_DIR`:建议的 Runner 目录(默认 `C:\unity-runner`)。
54
+ - `EPC_PREFLIGHT_VERSION` / `EPC_PREFLIGHT_REVISION`:期望的 Editor 版本/revision。
55
+
56
+ ### 注册后标签
57
+
58
+ Runner 必须带以下标签,E2E 工作流才会路由到它:
59
+
60
+ ```text
61
+ self-hosted
62
+ windows
63
+ unity-2022.3.62f3c1
64
+ ```
65
+
66
+ 建议注册命令(示例,以仓库页面给出的为准):
67
+
68
+ ```powershell
69
+ # 在 C:\unity-runner 下执行 GitHub 给出的注册命令,并追加:
70
+ .\config.cmd --labels self-hosted,windows,unity-2022.3.62f3c1
71
+ ```
72
+
73
+ ### 安全策略
74
+
75
+ - E2E 工作流**只**从 `workflow_dispatch` 与受保护 tag(`v*`)触发,
76
+ **不运行 pull_request**,避免不可信 Fork 代码在自托管机器上执行。
77
+ - Runner 机器不放生产密钥;npm 发布由 GitHub 托管 runner 上的 `publish.yml`(OIDC Trusted Publisher 短期凭证)完成,自托管 Runner 不接触发布凭证。
78
+ - 建议在 VM 上启用快照/恢复点;E2E 会在 finally 中清理其生成的 Unity 进程
79
+ 与临时工程,但快照仍是兜底。
80
+ - Unity 许可证建议使用专用 CI 授权或浮动许可证环境。
81
+ - 定期更新 Runner 与 Unity Patch;升级 Unity 版本必须在
82
+ `routes/<版本>.json` 新增独立路由并完成回归后才能使用。
83
+
84
+ ### 自测(不依赖 GitHub)
85
+
86
+ 注册前可在本机完整跑一遍 E2E:
87
+
88
+ ```powershell
89
+ npm run e2e:windows
90
+ ```
91
+
92
+ 报告默认写入 `C:/tmp/u-cli-mod-e2e-report.json`(可用 `EPC_E2E_REPORT` 覆盖)。E2E 默认使用隔离缓存(设 `EPC_E2E_FRESH_CACHE=0` 可复用真实用户缓存)并清理所有它启动的 Unity 进程。
93
+
94
+ ## 结果验证
95
+
96
+ 结合原始错误、结构化结果和实际产物核验;测试与真实平台执行分别记录。
97
+
98
+ ## 参考资料
99
+
100
+ [使用说明](../README.md)
@@ -0,0 +1,24 @@
1
+ # Vant 文档规范
2
+
3
+ ## 定位
4
+
5
+ 所有包以简体中文为默认语言。包名、命令、参数、路径、协议、字段、错误码、第三方产品名与许可原文保留必要英文。品牌统一使用 Vant,版权统一为 Copyright © 2026 Vant;第三方归属声明保持准确。
6
+
7
+ ## 结构
8
+
9
+ | 文档 | 一级内容顺序 |
10
+ | --- | --- |
11
+ | README | 功能、环境要求、安装、快速开始、使用说明、开发与验证、文档、许可与版权 |
12
+ | Agent 规范 | 定位、调用流程、调用规范、结果验证、参考资料、许可与版权 |
13
+ | 命令参考 | 定位、调用方式、参数与输出、执行边界、结果验证、参考资料 |
14
+ | 配置与协议 | 定位、前置条件、字段与示例、执行边界、结果验证、参考资料 |
15
+ | 操作指南 | 定位、前置条件、操作流程、结果验证、参考资料 |
16
+ | 故障诊断 | 定位、问题与处理、结果验证、参考资料 |
17
+
18
+ ## 内容
19
+
20
+ 只描述当前版本的功能、约束和可执行流程。正文不保存研发过程、历史兼容方案、失效版本表或未经验证的成功结论。版本历史集中在 CHANGELOG。已实现的数据转换命令按当前功能说明,不将历史方案混入常规操作。
21
+
22
+ ## 维护
23
+
24
+ 修改生成器、插件清单与源文档后重新生成随包文档。示例使用占位符,不包含账号、密钥或具体业务数据。命令、字段、链接和打包内容应通过检查;模拟验证不能替代真实平台结果。
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@kevlns/u-cli-mod",
3
- "version": "0.3.0",
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.",
3
+ "version": "0.3.1",
4
+ "description": "按 Unity Editor 精确版本定位工具链,校验和安装 com.unity.pipeline,并执行工程命令。",
5
5
  "private": false,
6
6
  "publishConfig": {
7
7
  "access": "public"
@@ -21,7 +21,8 @@
21
21
  "v-cli.plugin.json",
22
22
  "AGENTS.md",
23
23
  "README.md",
24
- "LICENSE"
24
+ "LICENSE",
25
+ "docs/"
25
26
  ],
26
27
  "repository": {
27
28
  "type": "git",
@@ -31,10 +32,7 @@
31
32
  "bugs": {
32
33
  "url": "https://github.com/kevlns/u-cli-mod/issues"
33
34
  },
34
- "author": {
35
- "name": "kevlns",
36
- "email": "936277610@qq.com"
37
- },
35
+ "author": "Vant",
38
36
  "keywords": [
39
37
  "unity",
40
38
  "unity-editor",
@@ -51,10 +49,11 @@
51
49
  "test": "vitest run",
52
50
  "lint": "eslint src tests --max-warnings=0",
53
51
  "pack:guard": "node scripts/pack-guard.mjs",
54
- "check": "npm run build && npm run lint && npm test && npm run pack:guard",
52
+ "check": "npm run docs:style && npm run build && npm run lint && npm test && npm run pack:guard",
55
53
  "preflight:runner": "node scripts/preflight-runner.mjs",
56
54
  "e2e:windows": "node scripts/e2e-windows.mjs",
57
- "test:package": "node scripts/test-package-install.mjs"
55
+ "test:package": "node scripts/test-package-install.mjs",
56
+ "docs:style": "node scripts/check-documentation.mjs"
58
57
  },
59
58
  "dependencies": {
60
59
  "commander": "^13.1.0",