@wkgeo/cli 2.0.3 → 2.1.0
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/CHANGELOG.md +10 -2
- package/README.md +7 -7
- package/SKILL.md +1038 -1038
- package/lib/api.mjs +351 -351
- package/lib/args.mjs +235 -235
- package/lib/build.mjs +1047 -0
- package/lib/cms.mjs +328 -328
- package/lib/commands/auth.mjs +1280 -1280
- package/lib/commands/data.mjs +694 -694
- package/lib/commands/index.mjs +15 -1
- package/lib/commands/init.mjs +111 -111
- package/lib/commands/orders.mjs +691 -691
- package/lib/commands/site.mjs +82 -0
- package/lib/commands/siteops.mjs +248 -0
- package/lib/commands/sites.mjs +968 -801
- package/lib/commands/spec.mjs +72 -72
- package/lib/commands/template.mjs +1484 -1484
- package/lib/config.mjs +57 -4
- package/lib/errors.mjs +446 -336
- package/lib/manifest-apply.mjs +1650 -1650
- package/lib/manifest-schema.json +480 -480
- package/lib/manifest.mjs +1106 -1106
- package/lib/runtime.mjs +767 -654
- package/lib/site-create.mjs +537 -537
- package/lib/site-credentials.mjs +157 -0
- package/lib/site-meta.mjs +474 -0
- package/lib/site-spec.mjs +302 -302
- package/lib/site-template.mjs +405 -0
- package/lib/template-gen.mjs +1354 -1354
- package/lib/template-publish.mjs +696 -696
- package/lib/templates-sync.mjs +676 -644
- package/lib/workspace-sync.mjs +386 -0
- package/package.json +56 -56
- package/spec/SITE-SPEC.md +198 -198
package/lib/commands/spec.mjs
CHANGED
|
@@ -1,72 +1,72 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `spec` 命令:把**随包分发**的建站规范 `spec/SITE-SPEC.md` 原文打印出来。
|
|
3
|
-
*
|
|
4
|
-
* ## 为什么是一条命令,而不是"看 README 某一节"
|
|
5
|
-
* 规范和代码一样会变:写在 README 里,AI 端拿到的是**它当时抓到的那一版**;写成命令,
|
|
6
|
-
* `npx @wkgeo/cli@latest spec` 每次都拿到**当前安装包里的那一版**(与 `wkgeo skill` 同理)。
|
|
7
|
-
*
|
|
8
|
-
* ## 三个出口同源(**这是本命令存在的核心理由**)
|
|
9
|
-
* * `wkgeo spec` → 全文(本命令)
|
|
10
|
-
* * `wkgeo spec --agents` → 只打「给 AI 的精简版」,**与 `wkgeo init` 写进项目的内容逐字节相同**
|
|
11
|
-
* * `wkgeo-site-spec` skill → 由 `cli/scripts/gen-site-spec.mjs` 从同一份 markdown 生成
|
|
12
|
-
* 三处都不另写规则;改规则只改 `cli/spec/SITE-SPEC.md`。
|
|
13
|
-
*
|
|
14
|
-
* ## 输出形态(**刻意的例外**,与 `skill` 同一套记法)
|
|
15
|
-
* * 默认(**包括管道/非终端**)→ 纯 markdown 原文,不套 JSON 信封 ——
|
|
16
|
-
* 否则 `wkgeo spec > 规范.md` 得到的是 `{"ok":true,…"markdown":"…\n…"}`,白折腾。
|
|
17
|
-
* * `--json` → 标准信封(给必须统一按 JSON 解析的宿主)。
|
|
18
|
-
*
|
|
19
|
-
* ## 鉴权
|
|
20
|
-
* 不需要登录、不发网络请求(纯本地读文件)。
|
|
21
|
-
*/
|
|
22
|
-
|
|
23
|
-
import { SPEC_URL, extractAgentsBrief, readSpecMarkdown } from '../site-spec.mjs';
|
|
24
|
-
|
|
25
|
-
export const specCommand = {
|
|
26
|
-
name: 'spec',
|
|
27
|
-
summary: '打印建站规范(栏目 / 模板 / 首页版块 / 图标)',
|
|
28
|
-
usage: 'wkgeo spec [--agents] [--json]',
|
|
29
|
-
flags: {
|
|
30
|
-
agents: {
|
|
31
|
-
type: 'boolean',
|
|
32
|
-
desc: '只打印「给 AI 的精简版」那一节(= `wkgeo init` 写进 AGENTS.md / CLAUDE.md / .cursorrules / Copilot 指令的内容)',
|
|
33
|
-
},
|
|
34
|
-
},
|
|
35
|
-
examples: [
|
|
36
|
-
'wkgeo spec # 全文',
|
|
37
|
-
'wkgeo spec --agents # 只打精简版(要写进项目的那一段)',
|
|
38
|
-
'wkgeo spec > SITE-SPEC.md # 存成文件(默认就是纯 markdown,不会套 JSON)',
|
|
39
|
-
'wkgeo spec --json # 机器可读信封',
|
|
40
|
-
],
|
|
41
|
-
notes: [
|
|
42
|
-
'默认**永远输出 markdown 原文**,即使输出到管道/非终端也不套 JSON 信封 —— 所以 `wkgeo spec > x.md` 直接得到可读文档。',
|
|
43
|
-
'只有显式 `wkgeo spec --json` 才输出信封:{"ok":true,"command":"spec","data":{"path":…,"markdown":…,"bytes":…,"lines":…}}。',
|
|
44
|
-
'本命令不需要登录、不发任何网络请求(纯本地读包内的 spec/SITE-SPEC.md)。',
|
|
45
|
-
'规范里的规则都标了「已实现 / 实现中」;实现中的条目别当既有行为依赖。',
|
|
46
|
-
],
|
|
47
|
-
async run(ctx) {
|
|
48
|
-
const { out, flags } = ctx;
|
|
49
|
-
const info = readSpecMarkdown(SPEC_URL);
|
|
50
|
-
const agentsOnly = flags.agents === true;
|
|
51
|
-
const markdown = agentsOnly ? extractAgentsBrief(info.markdown) : info.markdown;
|
|
52
|
-
const data = {
|
|
53
|
-
path: info.path,
|
|
54
|
-
agents_only: agentsOnly,
|
|
55
|
-
bytes: Buffer.byteLength(markdown, 'utf8'),
|
|
56
|
-
lines: markdown.split('\n').length,
|
|
57
|
-
markdown,
|
|
58
|
-
};
|
|
59
|
-
|
|
60
|
-
/**
|
|
61
|
-
* 判断依据必须是**用户显式写的 `--json`**(`ctx.flags.json`),不能用 `out.json`:
|
|
62
|
-
* 后者在非终端会自动变 true(全 CLI 的通用约定),那样管道里 `wkgeo spec > x.md`
|
|
63
|
-
* 就会灌进一坨 JSON 信封 —— 正是这里要避免的(与 `wkgeo skill` 同一处理)。
|
|
64
|
-
*/
|
|
65
|
-
if (flags.json === true) {
|
|
66
|
-
ctx.done(data);
|
|
67
|
-
return data;
|
|
68
|
-
}
|
|
69
|
-
out.plain(markdown.endsWith('\n') ? markdown : markdown + '\n');
|
|
70
|
-
return data;
|
|
71
|
-
},
|
|
72
|
-
};
|
|
1
|
+
/**
|
|
2
|
+
* `spec` 命令:把**随包分发**的建站规范 `spec/SITE-SPEC.md` 原文打印出来。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么是一条命令,而不是"看 README 某一节"
|
|
5
|
+
* 规范和代码一样会变:写在 README 里,AI 端拿到的是**它当时抓到的那一版**;写成命令,
|
|
6
|
+
* `npx @wkgeo/cli@latest spec` 每次都拿到**当前安装包里的那一版**(与 `wkgeo skill` 同理)。
|
|
7
|
+
*
|
|
8
|
+
* ## 三个出口同源(**这是本命令存在的核心理由**)
|
|
9
|
+
* * `wkgeo spec` → 全文(本命令)
|
|
10
|
+
* * `wkgeo spec --agents` → 只打「给 AI 的精简版」,**与 `wkgeo init` 写进项目的内容逐字节相同**
|
|
11
|
+
* * `wkgeo-site-spec` skill → 由 `cli/scripts/gen-site-spec.mjs` 从同一份 markdown 生成
|
|
12
|
+
* 三处都不另写规则;改规则只改 `cli/spec/SITE-SPEC.md`。
|
|
13
|
+
*
|
|
14
|
+
* ## 输出形态(**刻意的例外**,与 `skill` 同一套记法)
|
|
15
|
+
* * 默认(**包括管道/非终端**)→ 纯 markdown 原文,不套 JSON 信封 ——
|
|
16
|
+
* 否则 `wkgeo spec > 规范.md` 得到的是 `{"ok":true,…"markdown":"…\n…"}`,白折腾。
|
|
17
|
+
* * `--json` → 标准信封(给必须统一按 JSON 解析的宿主)。
|
|
18
|
+
*
|
|
19
|
+
* ## 鉴权
|
|
20
|
+
* 不需要登录、不发网络请求(纯本地读文件)。
|
|
21
|
+
*/
|
|
22
|
+
|
|
23
|
+
import { SPEC_URL, extractAgentsBrief, readSpecMarkdown } from '../site-spec.mjs';
|
|
24
|
+
|
|
25
|
+
export const specCommand = {
|
|
26
|
+
name: 'spec',
|
|
27
|
+
summary: '打印建站规范(栏目 / 模板 / 首页版块 / 图标)',
|
|
28
|
+
usage: 'wkgeo spec [--agents] [--json]',
|
|
29
|
+
flags: {
|
|
30
|
+
agents: {
|
|
31
|
+
type: 'boolean',
|
|
32
|
+
desc: '只打印「给 AI 的精简版」那一节(= `wkgeo init` 写进 AGENTS.md / CLAUDE.md / .cursorrules / Copilot 指令的内容)',
|
|
33
|
+
},
|
|
34
|
+
},
|
|
35
|
+
examples: [
|
|
36
|
+
'wkgeo spec # 全文',
|
|
37
|
+
'wkgeo spec --agents # 只打精简版(要写进项目的那一段)',
|
|
38
|
+
'wkgeo spec > SITE-SPEC.md # 存成文件(默认就是纯 markdown,不会套 JSON)',
|
|
39
|
+
'wkgeo spec --json # 机器可读信封',
|
|
40
|
+
],
|
|
41
|
+
notes: [
|
|
42
|
+
'默认**永远输出 markdown 原文**,即使输出到管道/非终端也不套 JSON 信封 —— 所以 `wkgeo spec > x.md` 直接得到可读文档。',
|
|
43
|
+
'只有显式 `wkgeo spec --json` 才输出信封:{"ok":true,"command":"spec","data":{"path":…,"markdown":…,"bytes":…,"lines":…}}。',
|
|
44
|
+
'本命令不需要登录、不发任何网络请求(纯本地读包内的 spec/SITE-SPEC.md)。',
|
|
45
|
+
'规范里的规则都标了「已实现 / 实现中」;实现中的条目别当既有行为依赖。',
|
|
46
|
+
],
|
|
47
|
+
async run(ctx) {
|
|
48
|
+
const { out, flags } = ctx;
|
|
49
|
+
const info = readSpecMarkdown(SPEC_URL);
|
|
50
|
+
const agentsOnly = flags.agents === true;
|
|
51
|
+
const markdown = agentsOnly ? extractAgentsBrief(info.markdown) : info.markdown;
|
|
52
|
+
const data = {
|
|
53
|
+
path: info.path,
|
|
54
|
+
agents_only: agentsOnly,
|
|
55
|
+
bytes: Buffer.byteLength(markdown, 'utf8'),
|
|
56
|
+
lines: markdown.split('\n').length,
|
|
57
|
+
markdown,
|
|
58
|
+
};
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* 判断依据必须是**用户显式写的 `--json`**(`ctx.flags.json`),不能用 `out.json`:
|
|
62
|
+
* 后者在非终端会自动变 true(全 CLI 的通用约定),那样管道里 `wkgeo spec > x.md`
|
|
63
|
+
* 就会灌进一坨 JSON 信封 —— 正是这里要避免的(与 `wkgeo skill` 同一处理)。
|
|
64
|
+
*/
|
|
65
|
+
if (flags.json === true) {
|
|
66
|
+
ctx.done(data);
|
|
67
|
+
return data;
|
|
68
|
+
}
|
|
69
|
+
out.plain(markdown.endsWith('\n') ? markdown : markdown + '\n');
|
|
70
|
+
return data;
|
|
71
|
+
},
|
|
72
|
+
};
|