@kevlns/v-cli 0.2.12 → 0.2.13

package/AGENTS.md

@@ -7,7 +7,7 @@
 
 ## 核心约定（v-cli 本体）
 
-- 环境要求 Node.js >= 20；v-cli 版本 @kevlns/v-cli@0.2.12
+- 环境要求 Node.js >= 20；v-cli 版本 @kevlns/v-cli@0.2.13
 - 命令分三类：builtin（内置）、local（~/.v-cli/commands/ 下的本地插件）、official（官方插件白名单）；
   **最新、live 的命令集合以实际发现为准**：先运行 `v-cli agent index --json` 获取全部命令与 agent 元数据
 - 单个命令的完整元数据用 `v-cli agent describe <命令名> --json` 查看
@@ -24,7 +24,7 @@
 
 ## @kevlns/u-cli-mod — 命令 `v-cli unity …`
 
-**版本**：0.2.2
+**版本**：0.2.3
 **描述**：Pin a Unity project to its exact editor version route, download the verified Unity CLI and install the adapted com.unity.pipeline package for Unity 2022 (Windows-first, non-official Unity tooling).
 **平台**：win32（仅 Windows 主机可用；非 Windows 上 v-cli 会拒绝路由）
 

package/README.md

@@ -73,7 +73,7 @@ v-cli xlmerge --repo <repo> detect            # 路由到 xlmerge 子进程
 v-cli xlmerge --repo <repo> resolve
 
 # Unity 工具链（仅 Windows 主机可用；其他平台 v-cli 会拒绝路由并说明原因）
-npm install -g @kevlns/u-cli-mod@0.2.2
+npm install -g @kevlns/u-cli-mod@0.2.3
 v-cli unity doctor <project>
 ```
 
@@ -189,9 +189,11 @@ npm run check:agents      # AGENTS.md 漂移检查（默认与已安装依赖比
 npm run pack:guard        # 发布内容护栏：身份/必需文件/禁止内容/依赖精确固定/engines
 npm run test:package      # 发布后安装冒烟：npm pack → 隔离 prefix 全局安装 → 运行 bin wrapper 断言
 npm run check             # build + typecheck + test + check:agents + pack:guard
+
+> 发版除 `npm version` 外，还需同步全仓版本断言（`grep -rn 旧版本号 tests/ scripts/ src/` 应为零，含 pack-guard 依赖精确固定与 smoke 的插件版本期望），再打 tag。
 ```
 
-> `@kevlns/xlmerge@2.0.0` / `@kevlns/u-cli-mod@0.2.2` 已发布并随 `npm install` 装入仓库
+> `@kevlns/xlmerge@2.0.0` / `@kevlns/u-cli-mod@0.2.3` 已发布并随 `npm install` 装入仓库
 > node_modules，`check:agents` 的 installed-deps 检查即为最终形态；预发布阶段需要以本地
 > 清单 bootstrap 时显式传 `--manifest <path>`。
 
@@ -201,9 +203,9 @@ kevlns 工具家族共享同一套发布约定（tag 驱动、CI 护栏、MIT）
 
 | Package | Purpose | Status |
 | --- | --- | --- |
-| [`v-cli`](https://github.com/kevlns/v-cli) | 个人工具箱 CLI（本仓库） | v0.2.12 |
+| [`v-cli`](https://github.com/kevlns/v-cli) | 个人工具箱 CLI（本仓库） | v0.2.13 |
 | [`xlmerge`](https://github.com/kevlns/xlmerge) | Git 中 .xlsx/.xlsm 冲突可视化解决工具 | v2.0.0 |
-| [`u-cli-mod`](https://github.com/kevlns/u-cli-mod) | Unity 精确版本路由 + CLI + pipeline 包（Windows-first） | v0.2.2 |
+| [`u-cli-mod`](https://github.com/kevlns/u-cli-mod) | Unity 精确版本路由 + CLI + pipeline 包（Windows-first） | v0.2.3 |
 
 ## Compatibility
 

package/dist/cli.mjs

@@ -627,7 +627,7 @@ import { createHash, randomBytes } from "crypto";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/version.ts
-var VERSION = "0.2.12";
+var VERSION = "0.2.13";
 
 // src/core/agent-docs.ts
 var BUNDLED_DOCS_FILE = "AGENTS.md";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kevlns/v-cli",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "description": "kevlns 的个人工具箱 CLI（插件化架构，内置 + 本地插件）+ doctor/plugin/ts 命令",
   "type": "module",
   "bin": {
@@ -46,7 +46,7 @@
     "personal"
   ],
   "dependencies": {
-    "@kevlns/u-cli-mod": "0.2.2",
+    "@kevlns/u-cli-mod": "0.2.3",
     "@kevlns/xlmerge": "2.0.0",
     "commander": "^12.1.0"
   },
@@ -59,4 +59,4 @@
   "allowScripts": {
     "esbuild@0.27.2": true
   }
-}
+}

package/skills/v-cli/SKILL.md

@@ -92,7 +92,7 @@ Unity 2022 工程**精确版本路由**（版本号 + revision 双重匹配）+
 | `outdated` / `invalid` | 先关闭目标工程 Editor，再 `v-cli unity pipeline install <project> --force`（自动备份，备份与 receipt 都在 `Library/editor-pipeline-cli/`，已被 gitignore） |
 | `current` | 可直接 `exec` |
 
-receipt 属工程本地生成物：新克隆 / 清理 Library 后即使 `Packages/com.unity.pipeline` 已入库且文件树完好，`state` 仍会是 `invalid`，需按上一行重装一次补齐 receipt。
+receipt 属工程本地生成物；就绪以当前路由的完整文件树校验为准。新克隆 / 清理 Library 后，文件树完好仍为 `current`，不因 receipt 缺失或陈旧要求重装。`pipeline.verification` 列出不匹配文件与仅行尾差异；`sourceReady=false` 只表示生成缓存需重建，不代表已安装包失效。新生成文本统一 LF，已安装文本兼容 LF/CRLF 等价，二进制和实际内容仍严格校验。
 
 ### 关键规则（违反即报错或导致损坏，必须遵守）
 
@@ -128,4 +128,4 @@ v-cli unity exec <project> -- command run_tests --mode EditMode --filter <类名
 v-cli unity exec <project> -- command run_tests --mode EditMode --async_tests     #    全量：立即返回，轮询 test_status
 v-cli xlmerge --repo . detect                                       # 配置表：只读检测
 v-cli xlmerge --repo . launch                                       # 有冲突时启动本地 UI，把 url 交给用户
-```
+```