@kevlns/v-cli 0.2.16 → 0.2.17
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 +2 -2
- package/LICENSE +21 -21
- package/dist/cli.mjs +1 -1
- package/package.json +4 -4
- package/schemas/v-cli-plugin.schema.json +143 -143
package/AGENTS.md
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
|
|
8
8
|
## 核心约定（v-cli 本体）
|
|
9
9
|
|
|
10
|
-
- 环境要求 Node.js >= 20；v-cli 版本 @kevlns/v-cli@0.2.
|
|
10
|
+
- 环境要求 Node.js >= 20；v-cli 版本 @kevlns/v-cli@0.2.17
|
|
11
11
|
- 命令分三类：builtin（内置）、local（~/.v-cli/commands/ 下的本地插件）、official（官方插件白名单）；
|
|
12
12
|
**命令集合以实际发现为准**：先运行 `v-cli agent index --json` 获取全部命令与 agent 元数据
|
|
13
13
|
- 单个命令的完整元数据用 `v-cli agent describe <命令名> --json` 查看
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
|
|
27
27
|
## @kevlns/art-workshop — 命令 `v-cli art …`
|
|
28
28
|
|
|
29
|
-
**版本**：0.1.
|
|
29
|
+
**版本**：0.1.3
|
|
30
30
|
**描述**：美术工坊：多工程风格分析与核心冻结、统一风格文生图及图编辑，支持计划预演与人工验收。
|
|
31
31
|
**平台**：win32, linux, darwin
|
|
32
32
|
|
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 kevlns <936277610@qq.com>
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 kevlns <936277610@qq.com>
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/dist/cli.mjs
CHANGED
|
@@ -638,7 +638,7 @@ import { createHash, randomBytes } from "crypto";
|
|
|
638
638
|
import { fileURLToPath as fileURLToPath2 } from "url";
|
|
639
639
|
|
|
640
640
|
// src/version.ts
|
|
641
|
-
var VERSION = "0.2.
|
|
641
|
+
var VERSION = "0.2.17";
|
|
642
642
|
|
|
643
643
|
// src/core/agent-docs.ts
|
|
644
644
|
var BUNDLED_DOCS_FILE = "AGENTS.md";
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kevlns/v-cli",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.17",
|
|
4
4
|
"description": "kevlns 的个人工具箱 CLI（插件化架构，内置 + 本地插件）+ doctor/plugin/ts 命令",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -46,12 +46,12 @@
|
|
|
46
46
|
"personal"
|
|
47
47
|
],
|
|
48
48
|
"dependencies": {
|
|
49
|
+
"@kevlns/art-workshop": "0.1.3",
|
|
49
50
|
"@kevlns/figma-to-uprefab": "0.1.2",
|
|
51
|
+
"@kevlns/ship-cli": "0.1.1",
|
|
50
52
|
"@kevlns/u-cli-mod": "0.2.4",
|
|
51
53
|
"@kevlns/xlmerge": "2.0.1",
|
|
52
|
-
"commander": "^12.1.0"
|
|
53
|
-
"@kevlns/ship-cli": "0.1.1",
|
|
54
|
-
"@kevlns/art-workshop": "0.1.2"
|
|
54
|
+
"commander": "^12.1.0"
|
|
55
55
|
},
|
|
56
56
|
"devDependencies": {
|
|
57
57
|
"@types/node": "^20.14.0",
|
|
@@ -1,144 +1,144 @@
|
|
|
1
|
-
{
|
|
2
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
|
-
"$id": "https://github.com/kevlns/v-cli/schemas/v-cli-plugin.schema.json",
|
|
4
|
-
"title": "v-cli plugin manifest",
|
|
5
|
-
"description": "官方插件清单（v-cli.plugin.json）契约，schemaVersion 1。v-cli 使用内置校验器（src/core/manifest.ts）执行等价规则；本文件供编辑器提示与文档使用。",
|
|
6
|
-
"type": "object",
|
|
7
|
-
"additionalProperties": true,
|
|
8
|
-
"required": [
|
|
9
|
-
"schemaVersion",
|
|
10
|
-
"package",
|
|
11
|
-
"command",
|
|
12
|
-
"bin",
|
|
13
|
-
"description",
|
|
14
|
-
"platforms",
|
|
15
|
-
"runtime",
|
|
16
|
-
"environment",
|
|
17
|
-
"agent"
|
|
18
|
-
],
|
|
19
|
-
"properties": {
|
|
20
|
-
"schemaVersion": {
|
|
21
|
-
"const": 1,
|
|
22
|
-
"description": "清单契约版本。v-cli 0.2 仅支持 1；未知 major（>=2）会被拒绝。"
|
|
23
|
-
},
|
|
24
|
-
"package": {
|
|
25
|
-
"type": "string",
|
|
26
|
-
"pattern": "^@[a-zA-Z0-9][a-zA-Z0-9._~-]*/[a-zA-Z0-9][a-zA-Z0-9._~-]*$",
|
|
27
|
-
"description": "npm 包名（@scope/name），必须与 package.json 的 name 一致。"
|
|
28
|
-
},
|
|
29
|
-
"command": {
|
|
30
|
-
"type": "string",
|
|
31
|
-
"pattern": "^[a-z][a-z0-9-]*$",
|
|
32
|
-
"description": "v-cli 路由命令名。不可与内置命令（doctor/plugin/ts/agent/help）重名。"
|
|
33
|
-
},
|
|
34
|
-
"bin": {
|
|
35
|
-
"type": "string",
|
|
36
|
-
"description": "package.json bin 中的键名；由 v-cli 以子进程方式调用。"
|
|
37
|
-
},
|
|
38
|
-
"description": {
|
|
39
|
-
"type": "string",
|
|
40
|
-
"minLength": 1
|
|
41
|
-
},
|
|
42
|
-
"platforms": {
|
|
43
|
-
"type": "array",
|
|
44
|
-
"minItems": 1,
|
|
45
|
-
"uniqueItems": true,
|
|
46
|
-
"items": {
|
|
47
|
-
"type": "string",
|
|
48
|
-
"enum": ["darwin", "linux", "win32"]
|
|
49
|
-
}
|
|
50
|
-
},
|
|
51
|
-
"runtime": {
|
|
52
|
-
"type": "object",
|
|
53
|
-
"description": "运行时要求（node/python/os 等，自由形状）。"
|
|
54
|
-
},
|
|
55
|
-
"environment": {
|
|
56
|
-
"type": "array",
|
|
57
|
-
"items": {
|
|
58
|
-
"type": "object",
|
|
59
|
-
"required": ["name", "description"],
|
|
60
|
-
"properties": {
|
|
61
|
-
"name": { "type": "string", "minLength": 1 },
|
|
62
|
-
"description": { "type": "string", "minLength": 1 }
|
|
63
|
-
}
|
|
64
|
-
}
|
|
65
|
-
},
|
|
66
|
-
"agent": {
|
|
67
|
-
"type": "object",
|
|
68
|
-
"required": ["whenToUse", "globalOptions", "commands"],
|
|
69
|
-
"properties": {
|
|
70
|
-
"whenToUse": {
|
|
71
|
-
"type": "string",
|
|
72
|
-
"description": "给 AI agent 的判断条件：什么场景该调用本插件。"
|
|
73
|
-
},
|
|
74
|
-
"globalOptions": {
|
|
75
|
-
"type": "array",
|
|
76
|
-
"items": {
|
|
77
|
-
"type": "object",
|
|
78
|
-
"required": ["flags", "description"],
|
|
79
|
-
"properties": {
|
|
80
|
-
"flags": { "type": "string", "minLength": 1 },
|
|
81
|
-
"description": { "type": "string", "minLength": 1 }
|
|
82
|
-
}
|
|
83
|
-
}
|
|
84
|
-
},
|
|
85
|
-
"commands": {
|
|
86
|
-
"type": "array",
|
|
87
|
-
"items": {
|
|
88
|
-
"type": "object",
|
|
89
|
-
"required": ["path", "usage", "description", "arguments", "options", "output", "exitCodes", "safety"],
|
|
90
|
-
"properties": {
|
|
91
|
-
"path": {
|
|
92
|
-
"type": "array",
|
|
93
|
-
"minItems": 1,
|
|
94
|
-
"items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" }
|
|
95
|
-
},
|
|
96
|
-
"usage": { "type": "string", "minLength": 1 },
|
|
97
|
-
"description": { "type": "string", "minLength": 1 },
|
|
98
|
-
"arguments": {
|
|
99
|
-
"type": "array",
|
|
100
|
-
"items": {
|
|
101
|
-
"type": "object",
|
|
102
|
-
"required": ["name", "required", "description"],
|
|
103
|
-
"properties": {
|
|
104
|
-
"name": { "type": "string", "minLength": 1 },
|
|
105
|
-
"required": { "type": "boolean" },
|
|
106
|
-
"description": { "type": "string", "minLength": 1 }
|
|
107
|
-
}
|
|
108
|
-
}
|
|
109
|
-
},
|
|
110
|
-
"options": {
|
|
111
|
-
"type": "array",
|
|
112
|
-
"items": {
|
|
113
|
-
"type": "object",
|
|
114
|
-
"required": ["flags", "description"],
|
|
115
|
-
"properties": {
|
|
116
|
-
"flags": { "type": "string", "minLength": 1 },
|
|
117
|
-
"description": { "type": "string", "minLength": 1 }
|
|
118
|
-
}
|
|
119
|
-
}
|
|
120
|
-
},
|
|
121
|
-
"output": {
|
|
122
|
-
"type": "object",
|
|
123
|
-
"required": ["format", "description"],
|
|
124
|
-
"properties": {
|
|
125
|
-
"format": { "type": "string", "enum": ["json", "stdout", "text"] },
|
|
126
|
-
"description": { "type": "string", "minLength": 1 }
|
|
127
|
-
}
|
|
128
|
-
},
|
|
129
|
-
"exitCodes": {
|
|
130
|
-
"type": "object",
|
|
131
|
-
"description": "code -> 含义 映射。",
|
|
132
|
-
"additionalProperties": { "type": "string" }
|
|
133
|
-
},
|
|
134
|
-
"safety": {
|
|
135
|
-
"type": "array",
|
|
136
|
-
"items": { "type": "string" }
|
|
137
|
-
}
|
|
138
|
-
}
|
|
139
|
-
}
|
|
140
|
-
}
|
|
141
|
-
}
|
|
142
|
-
}
|
|
143
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
|
+
"$id": "https://github.com/kevlns/v-cli/schemas/v-cli-plugin.schema.json",
|
|
4
|
+
"title": "v-cli plugin manifest",
|
|
5
|
+
"description": "官方插件清单（v-cli.plugin.json）契约，schemaVersion 1。v-cli 使用内置校验器（src/core/manifest.ts）执行等价规则；本文件供编辑器提示与文档使用。",
|
|
6
|
+
"type": "object",
|
|
7
|
+
"additionalProperties": true,
|
|
8
|
+
"required": [
|
|
9
|
+
"schemaVersion",
|
|
10
|
+
"package",
|
|
11
|
+
"command",
|
|
12
|
+
"bin",
|
|
13
|
+
"description",
|
|
14
|
+
"platforms",
|
|
15
|
+
"runtime",
|
|
16
|
+
"environment",
|
|
17
|
+
"agent"
|
|
18
|
+
],
|
|
19
|
+
"properties": {
|
|
20
|
+
"schemaVersion": {
|
|
21
|
+
"const": 1,
|
|
22
|
+
"description": "清单契约版本。v-cli 0.2 仅支持 1；未知 major（>=2）会被拒绝。"
|
|
23
|
+
},
|
|
24
|
+
"package": {
|
|
25
|
+
"type": "string",
|
|
26
|
+
"pattern": "^@[a-zA-Z0-9][a-zA-Z0-9._~-]*/[a-zA-Z0-9][a-zA-Z0-9._~-]*$",
|
|
27
|
+
"description": "npm 包名（@scope/name），必须与 package.json 的 name 一致。"
|
|
28
|
+
},
|
|
29
|
+
"command": {
|
|
30
|
+
"type": "string",
|
|
31
|
+
"pattern": "^[a-z][a-z0-9-]*$",
|
|
32
|
+
"description": "v-cli 路由命令名。不可与内置命令（doctor/plugin/ts/agent/help）重名。"
|
|
33
|
+
},
|
|
34
|
+
"bin": {
|
|
35
|
+
"type": "string",
|
|
36
|
+
"description": "package.json bin 中的键名；由 v-cli 以子进程方式调用。"
|
|
37
|
+
},
|
|
38
|
+
"description": {
|
|
39
|
+
"type": "string",
|
|
40
|
+
"minLength": 1
|
|
41
|
+
},
|
|
42
|
+
"platforms": {
|
|
43
|
+
"type": "array",
|
|
44
|
+
"minItems": 1,
|
|
45
|
+
"uniqueItems": true,
|
|
46
|
+
"items": {
|
|
47
|
+
"type": "string",
|
|
48
|
+
"enum": ["darwin", "linux", "win32"]
|
|
49
|
+
}
|
|
50
|
+
},
|
|
51
|
+
"runtime": {
|
|
52
|
+
"type": "object",
|
|
53
|
+
"description": "运行时要求（node/python/os 等，自由形状）。"
|
|
54
|
+
},
|
|
55
|
+
"environment": {
|
|
56
|
+
"type": "array",
|
|
57
|
+
"items": {
|
|
58
|
+
"type": "object",
|
|
59
|
+
"required": ["name", "description"],
|
|
60
|
+
"properties": {
|
|
61
|
+
"name": { "type": "string", "minLength": 1 },
|
|
62
|
+
"description": { "type": "string", "minLength": 1 }
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
},
|
|
66
|
+
"agent": {
|
|
67
|
+
"type": "object",
|
|
68
|
+
"required": ["whenToUse", "globalOptions", "commands"],
|
|
69
|
+
"properties": {
|
|
70
|
+
"whenToUse": {
|
|
71
|
+
"type": "string",
|
|
72
|
+
"description": "给 AI agent 的判断条件：什么场景该调用本插件。"
|
|
73
|
+
},
|
|
74
|
+
"globalOptions": {
|
|
75
|
+
"type": "array",
|
|
76
|
+
"items": {
|
|
77
|
+
"type": "object",
|
|
78
|
+
"required": ["flags", "description"],
|
|
79
|
+
"properties": {
|
|
80
|
+
"flags": { "type": "string", "minLength": 1 },
|
|
81
|
+
"description": { "type": "string", "minLength": 1 }
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
},
|
|
85
|
+
"commands": {
|
|
86
|
+
"type": "array",
|
|
87
|
+
"items": {
|
|
88
|
+
"type": "object",
|
|
89
|
+
"required": ["path", "usage", "description", "arguments", "options", "output", "exitCodes", "safety"],
|
|
90
|
+
"properties": {
|
|
91
|
+
"path": {
|
|
92
|
+
"type": "array",
|
|
93
|
+
"minItems": 1,
|
|
94
|
+
"items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" }
|
|
95
|
+
},
|
|
96
|
+
"usage": { "type": "string", "minLength": 1 },
|
|
97
|
+
"description": { "type": "string", "minLength": 1 },
|
|
98
|
+
"arguments": {
|
|
99
|
+
"type": "array",
|
|
100
|
+
"items": {
|
|
101
|
+
"type": "object",
|
|
102
|
+
"required": ["name", "required", "description"],
|
|
103
|
+
"properties": {
|
|
104
|
+
"name": { "type": "string", "minLength": 1 },
|
|
105
|
+
"required": { "type": "boolean" },
|
|
106
|
+
"description": { "type": "string", "minLength": 1 }
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
},
|
|
110
|
+
"options": {
|
|
111
|
+
"type": "array",
|
|
112
|
+
"items": {
|
|
113
|
+
"type": "object",
|
|
114
|
+
"required": ["flags", "description"],
|
|
115
|
+
"properties": {
|
|
116
|
+
"flags": { "type": "string", "minLength": 1 },
|
|
117
|
+
"description": { "type": "string", "minLength": 1 }
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
},
|
|
121
|
+
"output": {
|
|
122
|
+
"type": "object",
|
|
123
|
+
"required": ["format", "description"],
|
|
124
|
+
"properties": {
|
|
125
|
+
"format": { "type": "string", "enum": ["json", "stdout", "text"] },
|
|
126
|
+
"description": { "type": "string", "minLength": 1 }
|
|
127
|
+
}
|
|
128
|
+
},
|
|
129
|
+
"exitCodes": {
|
|
130
|
+
"type": "object",
|
|
131
|
+
"description": "code -> 含义 映射。",
|
|
132
|
+
"additionalProperties": { "type": "string" }
|
|
133
|
+
},
|
|
134
|
+
"safety": {
|
|
135
|
+
"type": "array",
|
|
136
|
+
"items": { "type": "string" }
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
144
|
}
|