@kevlns/v-cli 0.2.15 → 0.2.16

package/AGENTS.md

@@ -7,7 +7,7 @@
 
 ## 核心约定（v-cli 本体）
 
-- 环境要求 Node.js >= 20；v-cli 版本 @kevlns/v-cli@0.2.15
+- 环境要求 Node.js >= 20；v-cli 版本 @kevlns/v-cli@0.2.16
 - 命令分三类：builtin（内置）、local（~/.v-cli/commands/ 下的本地插件）、official（官方插件白名单）；
   **命令集合以实际发现为准**：先运行 `v-cli agent index --json` 获取全部命令与 agent 元数据
 - 单个命令的完整元数据用 `v-cli agent describe <命令名> --json` 查看
@@ -17,12 +17,24 @@
   随包版本是规范唯一权威：同名 SKILL.md 一律按随包版本刷新（本地修改会被覆盖并提示）；随包没有的文件（项目扩展，如 PROJECT.md）默认保留，`--force` 时完全同步
 - **首调规范**：首次调用任何 official 插件命令前，必须先运行 `v-cli agent docs <命令名>`，
   掌握该插件包内 `AGENTS.md`；使用规范、快速流程与禁止事项以插件 AGENTS.md 为准。
-- 官方插件命令（`v-cli xlmerge …`、`v-cli unity …`、`v-cli figma …`、`v-cli ship …`）在子进程中运行（stdio 继承）：v-cli 只做路由，
+- 官方插件命令（`v-cli xlmerge …`、`v-cli unity …`、`v-cli figma …`、`v-cli ship …`、`v-cli art …`）在子进程中运行（stdio 继承）：v-cli 只做路由，
+- `art` 是随包美术工坊插件；先读 `v-cli agent docs art`，用 `v-cli art config show` 和 `v-cli art agent index` 选择正确工程与核心。真实分析和生成按任务授权执行。
 - `ship` 是随包官方插件（@kevlns/ship-cli），随 v-cli 安装并自动发现；先运行 `v-cli agent docs ship`、`v-cli ship doctor --json`，再按 Steam / 微信小游戏流程执行。缺失时明确报告 missing，不在运行时自动安装。
   不解析、不改写插件的 stdout/stderr；插件 `--help`/`--json` 等参数由插件自己消费
 - 插件对 worktree 的写入/提交行为以插件清单 v-cli.plugin.json 的 `agent.safety` 为准：
   v-cli 不替插件做 diff/write-back/commit；**未经显式 flag 不得 push**
 
+## @kevlns/art-workshop — 命令 `v-cli art …`
+
+**版本**：0.1.2
+**描述**：美术工坊：多工程风格分析与核心冻结、统一风格文生图及图编辑，支持计划预演与人工验收。
+**平台**：win32, linux, darwin
+
+**何时使用**：视觉风格分析与冻结、基于正确工程核心生成统一风格图片、按修改与保留计划编辑现有图片，或查看 refs 分类、预演与验收。先 config show 和 agent index 选择工程，远程分析及生图须有任务授权。
+
+**首次调用前必读**：`v-cli agent docs art`（插件包内 AGENTS.md 规范正本）
+**实时参数/命令**：`v-cli agent describe art --json`
+
 ## @kevlns/figma-to-uprefab — 命令 `v-cli figma …`
 
 **版本**：0.1.2

package/README.md

@@ -23,7 +23,7 @@ v-cli 让你**用一个命令沉淀所有个人小工具**，而不用为每个
 它被设计为**依赖极少、秒级启动、写个文件就能扩展**。
 
 - **插件化架构** - 内置命令走注册表随版本发布；本地插件放进 `~/.v-cli/commands/` 立即生效，无需发版
-- **官方插件白名单** - `@kevlns/xlmerge`（`xlmerge`）、`@kevlns/u-cli-mod`（`unity`）与 `@kevlns/figma-to-uprefab`（`figma`），安装后在子进程中运行
+- **官方插件白名单** - `@kevlns/xlmerge`（`xlmerge`）、`@kevlns/u-cli-mod`（`unity`）、`@kevlns/figma-to-uprefab`（`figma`）、`@kevlns/ship-cli`（`ship`）和 `@kevlns/art-workshop`（`art`），随包安装并在子进程中运行
 - **容错加载** - 单个插件语法错误、契约不符或注册异常只会被跳过并报告，绝不阻断其他命令
 - **双通道输出** - 结果走 stdout（可管道、可脚本化），诊断走 stderr
 - **agent 友好** - `agent docs`/`agent init` 让 AI Agent 自举读取引导文档；`agent index/describe` 输出统一索引与完整元数据；仓库内 AGENTS.md 自动生成并有漂移检查
@@ -114,7 +114,7 @@ v-cli plugin list     # [local] hello 已出现
 ```
 
 > 缺少 `apiVersion: 1` 的插件会被拒绝并给出解释性错误，补上字段后重载即可。
-> 本地插件不能占用内置命令名（`doctor`/`plugin`/`ts`/`agent`/`help`）或官方命令名（`xlmerge`/`unity`/`figma`）。
+> 本地插件不能占用内置命令名（`doctor`/`plugin`/`ts`/`agent`/`help`）或官方命令名（`xlmerge`/`unity`/`figma`/`ship`/`art`）。
 
 ### 在脚本中消费输出
 
@@ -213,7 +213,7 @@ kevlns 工具家族共享同一套发布约定（tag 驱动、CI 护栏、MIT）
 
 | Package | Purpose | Version |
 | --- | --- | --- |
-| [`v-cli`](https://github.com/kevlns/v-cli) | 个人工具箱 CLI（本仓库） | v0.2.15 |
+| [`v-cli`](https://github.com/kevlns/v-cli) | 个人工具箱 CLI（本仓库） | v0.2.16 |
 | [`xlmerge`](https://github.com/kevlns/xlmerge) | Git 中 .xlsx/.xlsm 冲突可视化解决工具 | v2.0.1 |
 | [`u-cli-mod`](https://github.com/kevlns/u-cli-mod) | Unity 精确版本路由 + CLI + pipeline 包（Windows-first） | v0.2.4 |
 | [`figma-to-uprefab`](https://github.com/kevlns/figma-to-uprefab) | Figma 导出、契约校验与 Unity UGUI staging Prefab 构建 | v0.1.2 |
@@ -225,7 +225,7 @@ kevlns 工具家族共享同一套发布约定（tag 驱动、CI 护栏、MIT）
 | Node.js | `20` and later |
 | TypeScript | `5.6` and later（仅开发时） |
 
-CLI 核心逻辑以单文件 ESM（`dist/cli.mjs`）分发，运行时依赖 `commander` 与三个官方插件包
+CLI 核心逻辑以单文件 ESM（`dist/cli.mjs`）分发，运行时依赖 `commander` 与五个官方插件包
 （`@kevlns/xlmerge`、`@kevlns/u-cli-mod`、`@kevlns/figma-to-uprefab`，均为精确固定版本；安装 v-cli 时一起安装，
 未装时 `plugin list`/`doctor`/`agent index` 会如实报告 `missing` 状态）。
 
@@ -263,4 +263,8 @@ v-cli ship wx validate --json
 v-cli ship wx push --version 1.0.0 --json
 ```
 
-缺失时会显示 missing。完整 Steam / 微信小游戏流程以 ship 的随包规范为准。隔离接入验证：`npm run test:package`，覆盖四个官方依赖的安装、发现、清单、规范哈希与真实子进程路由。
+缺失时会显示 missing。完整 Steam / 微信小游戏流程以 ship 的随包规范为准。隔离接入验证：`npm run test:package`，覆盖五个官方依赖的安装、发现、清单、规范哈希与真实子进程路由。
+
+# 美术工坊官方插件 art
+
+`@kevlns/art-workshop@0.1.2` 随 v-cli 安装，自动发现为 `art`。先读 `v-cli agent docs art`，用 `v-cli agent describe art --json` 查看完整参数，再用 `v-cli art config show` 与 `v-cli art agent index` 选择正确工程。风格分析与冻结用 `v-cli art style`，文生图用 `v-cli art generate`，图编辑用 `v-cli art edit`。参数与独立工具一致；本地配置、冻结核心及全部外部资源路径一致。`v-cli art --help` 与 `v-cli art agent docs` 提供入口和完整规范。

package/dist/cli.mjs

@@ -322,7 +322,8 @@ var OFFICIAL_PLUGINS = [
     package: "@kevlns/ship-cli",
     command: "ship",
     description: "\u5DF2\u6784\u5EFA\u6E38\u620F\u7684 Steam/\u5FAE\u4FE1\u5C0F\u6E38\u620F\u6821\u9A8C\u3001\u9884\u6F14\u548C\u6D4B\u8BD5\u901A\u9053\u4E0A\u4F20"
-  }
+  },
+  { package: "@kevlns/art-workshop", command: "art", description: "\u7F8E\u672F\u5DE5\u574A\uFF1A\u98CE\u683C\u5206\u6790\u4E0E\u51BB\u7ED3\u3001\u591A\u5DE5\u7A0B\u6587\u751F\u56FE\u53CA\u56FE\u7F16\u8F91" }
 ];
 var OFFICIAL_COMMAND_NAMES = new Set(
   OFFICIAL_PLUGINS.map((p) => p.command)
@@ -637,7 +638,7 @@ import { createHash, randomBytes } from "crypto";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/version.ts
-var VERSION = "0.2.15";
+var VERSION = "0.2.16";
 
 // 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.15",
+  "version": "0.2.16",
   "description": "kevlns 的个人工具箱 CLI（插件化架构，内置 + 本地插件）+ doctor/plugin/ts 命令",
   "type": "module",
   "bin": {
@@ -50,7 +50,8 @@
     "@kevlns/u-cli-mod": "0.2.4",
     "@kevlns/xlmerge": "2.0.1",
     "commander": "^12.1.0",
-    "@kevlns/ship-cli": "0.1.1"
+    "@kevlns/ship-cli": "0.1.1",
+    "@kevlns/art-workshop": "0.1.2"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",

package/skills/v-cli/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: v-cli
 description: >
-  使用 kevlns 的个人工具箱 CLI（v-cli）处理配置表冲突、Unity 工程精确版本工具链、Figma 转 Unity UGUI Prefab 和 Steam/微信小游戏交付。当任务提到 v-cli、xlmerge、ship-cli、
+  使用 kevlns 的个人工具箱 CLI（v-cli）处理配置表冲突、Unity 工程精确版本工具链、Figma 转 Unity UGUI Prefab、Steam/微信小游戏交付与美术工坊风格分析、生图和图编辑。当任务提到 v-cli、xlmerge、ship-cli、美术工坊、art-workshop、
   unity / figma 命令、figma-to-uprefab、配置表 .xlsx/.xlsm Git 冲突处理、Unity CLI 安装、Unity 工程诊断/体检（doctor）、
   com.unity.pipeline 适配包安装、v-cli agent init 工作区初始化时使用本 skill。
 ---
@@ -14,7 +14,7 @@ description: >
 - 命令分三类：
   - **builtin**（内置）：`doctor`（环境体检）、`plugin list/path`（插件管理）、`ts`（时间戳互转）、`agent index/describe/docs/init`（agent 引导）。
   - **local**：`~/.v-cli/commands/` 下的本地插件。
-  - **official**（官方插件，经 v-cli 路由）：`xlmerge`、`unity`、`figma`，以及`ship`。
+  - **official**（官方插件，经 v-cli 路由）：`xlmerge`、`unity`、`figma`、`ship`、`art`。
 - **本文件不写死任何版本号**：v-cli 本体与官方插件的实际版本、命令集合、参数一律以 `v-cli doctor` 与 `v-cli agent index --json` 的实时输出为准。
 
 ## 能力发现协议（核心规则，必须遵守）
@@ -29,7 +29,7 @@ description: >
 
 ## 首调规范
 
-**首次调用任何 official 插件命令（`v-cli xlmerge …`、`v-cli unity …`、`v-cli figma …`）前，必须先运行 `v-cli agent docs <命令名>` 读取该插件包内的 AGENTS.md 规范正本。** 使用规范、快速流程与禁止事项以插件自身 AGENTS.md 为准。
+**首次调用任何 official 插件命令（`v-cli xlmerge …`、`v-cli unity …`、`v-cli figma …`、`v-cli ship …`、`v-cli art …`）前，必须先运行 `v-cli agent docs <命令名>` 读取该插件包内的 AGENTS.md 规范正本。** 使用规范、快速流程与禁止事项以插件自身 AGENTS.md 为准。
 
 官方插件命令在子进程中运行（stdio 继承）：v-cli 只做路由，不解析、不改写插件输出；插件 `--help`/`--json` 等参数由插件自己消费。插件对 worktree 的写入/提交行为以插件清单的安全标签为准；**未经显式 flag 不得 push**。
 
@@ -144,3 +144,7 @@ v-cli xlmerge --repo . launch                                       # 有冲突
 对已构建游戏进行 Steam / 微信小游戏校验、扫码预览或开发版上传时，先 `v-cli agent describe ship --json` 确认可用，再读取 `v-cli agent docs ship`。`ship` 是官方插件，与 v-cli 安装在同一 npm prefix 后自动发现；缺失时报告 missing，安装需要对应任务授权。
 
 选择正确工程后执行 `v-cli ship --project <工程目录> doctor --json`，检查体检 ok 和 fail 项。具体平台命令、上传授权边界、凭据和体积口径以 ship 随包规范为准。Steam preview 不上传；微信 preview 调用服务并返回二维码路径。正式发布由平台后台处理。
+
+## 美术工坊插件 art
+
+风格分析与核心冻结、统一风格多工程生图或编辑现有图片时，先读 `v-cli agent docs art`，用 `v-cli agent describe art --json` 查看参数。再用 `v-cli art config show`、`v-cli art agent index` 选择外部工作目录、正确工程与核心。完整规范用 `v-cli art agent docs` 查看；按 style、generate、edit 三个模块执行。plan 和 --dry 不调用远程模型，真实分析、生图与编辑按任务授权执行。