@wkgeo/cli 0.0.0-stage → 1.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 +223 -0
- package/LICENSE +21 -0
- package/README.md +1042 -3
- package/SKILL.md +927 -0
- package/lib/ai/client.mjs +161 -0
- package/lib/ai/config.mjs +221 -0
- package/lib/ai/context.mjs +468 -0
- package/lib/ai/log.mjs +53 -0
- package/lib/api.mjs +339 -0
- package/lib/args.mjs +235 -0
- package/lib/cli.mjs +168 -0
- package/lib/cms.mjs +330 -0
- package/lib/commands/ai.mjs +392 -0
- package/lib/commands/apps.mjs +116 -0
- package/lib/commands/auth.mjs +1288 -0
- package/lib/commands/billing.mjs +666 -0
- package/lib/commands/cms.mjs +2533 -0
- package/lib/commands/config-auth.mjs +621 -0
- package/lib/commands/config.mjs +434 -0
- package/lib/commands/dnscred.mjs +428 -0
- package/lib/commands/domainops.mjs +546 -0
- package/lib/commands/domainorder.mjs +439 -0
- package/lib/commands/import.mjs +164 -0
- package/lib/commands/index.mjs +541 -0
- package/lib/commands/logs.mjs +141 -0
- package/lib/commands/orders.mjs +444 -0
- package/lib/commands/overview.mjs +394 -0
- package/lib/commands/plugins.mjs +678 -0
- package/lib/commands/site.mjs +435 -0
- package/lib/commands/siteops.mjs +1012 -0
- package/lib/commands/sites.mjs +905 -0
- package/lib/commands/skill.mjs +119 -0
- package/lib/commands/template.mjs +258 -0
- package/lib/config.mjs +351 -0
- package/lib/credentials.mjs +160 -0
- package/lib/device-store.mjs +132 -0
- package/lib/device.mjs +464 -0
- package/lib/errors.mjs +299 -0
- package/lib/format.mjs +339 -0
- package/lib/http.mjs +71 -0
- package/lib/index.mjs +44 -0
- package/lib/local-import.mjs +185 -0
- package/lib/login.mjs +1638 -0
- package/lib/oauth-urls.mjs +163 -0
- package/lib/page.mjs +393 -0
- package/lib/pkce.mjs +48 -0
- package/lib/proxy.mjs +454 -0
- package/lib/qr.mjs +31 -0
- package/lib/runtime.mjs +650 -0
- package/lib/site-state.mjs +137 -0
- package/lib/tar.mjs +207 -0
- package/lib/template-package.mjs +522 -0
- package/package.json +53 -4
- package/wkgeo.mjs +17 -0
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 「当前选中站点」的本地状态:**`<凭据目录>/config.json`**(默认 `~/.wkongai/config.json`)。
|
|
3
|
+
*
|
|
4
|
+
* 为什么需要它:CMS(栏目 / 内容 / 素材 / 模板)的每个动作都必须落在一个站点上,
|
|
5
|
+
* 而 CMS 的 `site_id` **只从会话或 `x-cms-site` 头里取**(body 里的 `site_id` 后端故意忽略,
|
|
6
|
+
* 见 `aliyun/fc/wkgeo-cms/src/index.js` 的 `resolveSite`)。CLI 没有 Cookie 会话,
|
|
7
|
+
* 所以只能把"我这次要操作哪个站"记在本地,之后每个请求带 `x-cms-site`。
|
|
8
|
+
*
|
|
9
|
+
* 为什么不放进 `credentials.json`:
|
|
10
|
+
* * 那个文件是**凭据**(0600、只存令牌与账号),删除它 = 退出登录;
|
|
11
|
+
* * "选了哪个站"只是操作上下文,`logout` 不该把它一起带走,反过来重新登录也不该丢。
|
|
12
|
+
* 分成两个文件之后,两件事的语义各自清楚。
|
|
13
|
+
*
|
|
14
|
+
* 为什么放在凭据文件同目录:`--credentials` / `WKONGAI_CREDENTIALS` 已经在做"换一套身份"的隔离
|
|
15
|
+
* (单测、多人共机、联调都靠它),站点选择跟着走最不容易串;
|
|
16
|
+
* 默认情况下就是规划文档里写的 `~/.wkongai/config.json`。
|
|
17
|
+
*
|
|
18
|
+
* ⚠️ 这个文件**不含任何秘密**(只有站点 id / 名字),但仍然用原子写 + 0600:
|
|
19
|
+
* 权限口径统一,省得以后往里加别的东西时忘了。
|
|
20
|
+
*/
|
|
21
|
+
|
|
22
|
+
import fs from 'node:fs';
|
|
23
|
+
import path from 'node:path';
|
|
24
|
+
|
|
25
|
+
import { CliError } from './errors.mjs';
|
|
26
|
+
|
|
27
|
+
/** 状态文件版本(将来改结构时用来判断要不要迁移;现在只写不读) */
|
|
28
|
+
export const SITE_STATE_VERSION = 1;
|
|
29
|
+
|
|
30
|
+
/** 文件名(与规划文档一致:`~/.wkongai/config.json`) */
|
|
31
|
+
export const SITE_STATE_FILE_NAME = 'config.json';
|
|
32
|
+
|
|
33
|
+
/** 读原始 JSON 对象;文件不存在 / 坏掉都返回 `{}`(写路径用,绝不因为"读不懂"而写不进去) */
|
|
34
|
+
function readRawObjectQuiet(file) {
|
|
35
|
+
try {
|
|
36
|
+
const text = fs.readFileSync(file, 'utf8');
|
|
37
|
+
const parsed = JSON.parse(text);
|
|
38
|
+
return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
|
|
39
|
+
} catch {
|
|
40
|
+
return {};
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* 读当前选中的站点。
|
|
46
|
+
*
|
|
47
|
+
* @param {string} file 状态文件路径
|
|
48
|
+
* @returns {{id:string, label:string, saved_at:string|null}|null} 没选过 → `null`
|
|
49
|
+
* @throws {CliError} 文件存在但**不是合法 JSON / 内容形状不对**(明确报错,不静默当"没选"——
|
|
50
|
+
* 否则用户会一直看到"还没有选择站点",却不知道自己有个坏文件在那儿)
|
|
51
|
+
*/
|
|
52
|
+
export function readSiteState(file) {
|
|
53
|
+
if (!file) return null;
|
|
54
|
+
let text;
|
|
55
|
+
try {
|
|
56
|
+
text = fs.readFileSync(file, 'utf8');
|
|
57
|
+
} catch (e) {
|
|
58
|
+
if (e && e.code === 'ENOENT') return null;
|
|
59
|
+
throw new CliError(`读取本地站点配置失败:${e.message}`, {
|
|
60
|
+
kind: 'config',
|
|
61
|
+
hint: `文件位置:${file}`,
|
|
62
|
+
cause: e,
|
|
63
|
+
});
|
|
64
|
+
}
|
|
65
|
+
let parsed;
|
|
66
|
+
try {
|
|
67
|
+
parsed = JSON.parse(text);
|
|
68
|
+
} catch (e) {
|
|
69
|
+
throw new CliError(`本地站点配置不是合法 JSON:${file}`, {
|
|
70
|
+
kind: 'config',
|
|
71
|
+
hint: '删掉它,或重新运行 `wkgeo site use <站点ID>`(会覆盖写入)',
|
|
72
|
+
cause: e,
|
|
73
|
+
});
|
|
74
|
+
}
|
|
75
|
+
const one = parsed && typeof parsed === 'object' ? parsed.cms_site : null;
|
|
76
|
+
if (!one || typeof one !== 'object' || !one.id) return null;
|
|
77
|
+
return {
|
|
78
|
+
id: String(one.id),
|
|
79
|
+
label: String(one.label || ''),
|
|
80
|
+
saved_at: one.saved_at || null,
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* 记住"当前站点"(**保留文件里的其它键**:以后往里放别的本地设置时不用改这里)。
|
|
86
|
+
*
|
|
87
|
+
* @param {string} file
|
|
88
|
+
* @param {{id:string, label?:string}} site
|
|
89
|
+
*/
|
|
90
|
+
export function writeSiteState(file, site, { now = Date.now() } = {}) {
|
|
91
|
+
const id = String((site && site.id) || '').trim();
|
|
92
|
+
if (!id) throw new CliError('内部错误:写本地站点配置时缺少站点 id');
|
|
93
|
+
const dir = path.dirname(file);
|
|
94
|
+
fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
|
|
95
|
+
|
|
96
|
+
const payload = {
|
|
97
|
+
version: SITE_STATE_VERSION,
|
|
98
|
+
...readRawObjectQuiet(file),
|
|
99
|
+
cms_site: {
|
|
100
|
+
id,
|
|
101
|
+
label: String((site && site.label) || ''),
|
|
102
|
+
saved_at: new Date(now).toISOString(),
|
|
103
|
+
},
|
|
104
|
+
};
|
|
105
|
+
|
|
106
|
+
const tmp = `${file}.tmp-${process.pid}`;
|
|
107
|
+
const fd = fs.openSync(tmp, 'w', 0o600);
|
|
108
|
+
try {
|
|
109
|
+
fs.writeFileSync(fd, JSON.stringify(payload, null, 2) + '\n', 'utf8');
|
|
110
|
+
} finally {
|
|
111
|
+
fs.closeSync(fd);
|
|
112
|
+
}
|
|
113
|
+
fs.renameSync(tmp, file);
|
|
114
|
+
return payload.cms_site;
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
/**
|
|
118
|
+
* 取消选中(`wkgeo site use --clear`)。
|
|
119
|
+
*
|
|
120
|
+
* @returns {boolean} 之前有没有选中过(用来决定提示文案)
|
|
121
|
+
*/
|
|
122
|
+
export function clearSiteState(file) {
|
|
123
|
+
const raw = readRawObjectQuiet(file);
|
|
124
|
+
const had = Boolean(raw.cms_site && raw.cms_site.id);
|
|
125
|
+
delete raw.cms_site;
|
|
126
|
+
const dir = path.dirname(file);
|
|
127
|
+
fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
|
|
128
|
+
const tmp = `${file}.tmp-${process.pid}`;
|
|
129
|
+
const fd = fs.openSync(tmp, 'w', 0o600);
|
|
130
|
+
try {
|
|
131
|
+
fs.writeFileSync(fd, JSON.stringify({ version: SITE_STATE_VERSION, ...raw }, null, 2) + '\n', 'utf8');
|
|
132
|
+
} finally {
|
|
133
|
+
fs.closeSync(fd);
|
|
134
|
+
}
|
|
135
|
+
fs.renameSync(tmp, file);
|
|
136
|
+
return had;
|
|
137
|
+
}
|
package/lib/tar.mjs
ADDED
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 极简 tar.gz 读取器(node 内置 zlib,**零第三方依赖**)。
|
|
3
|
+
*
|
|
4
|
+
* 为什么手写:`wkgeo template init` 要从 registry 下 `.tgz` 并解包,而 CLI 的硬约定是
|
|
5
|
+
* **零依赖**(见 cli/README)。tar 格式本身只有 512 字节定长头 + 512 对齐的数据块,
|
|
6
|
+
* 只需要支持 npm pack 实际会产出的三种记录:
|
|
7
|
+
* * `0` / `\0` —— 普通文件
|
|
8
|
+
* * `5` —— 目录
|
|
9
|
+
* * `x` / `g` / `L` / `K` —— PAX 扩展头 / GNU 长名(npm 打包长路径时会出现)
|
|
10
|
+
* 符号链接 / 硬链接 / 设备文件**一律拒绝**(防止压缩包把文件写到目标目录外面去)。
|
|
11
|
+
*
|
|
12
|
+
* 安全边界都收在 `safeEntryPath()` 一处:绝对路径、盘符(`C:`)、任何 `..` 段、
|
|
13
|
+
* 反斜杠路径穿越,统统抛错;解包时再 `resolve()` 复核一次目标仍在根目录内。
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
import fs from 'node:fs';
|
|
17
|
+
import path from 'node:path';
|
|
18
|
+
import zlib from 'node:zlib';
|
|
19
|
+
|
|
20
|
+
const BLOCK = 512;
|
|
21
|
+
|
|
22
|
+
function cstr(buf, off, len) {
|
|
23
|
+
const slice = buf.subarray(off, off + len);
|
|
24
|
+
const end = slice.indexOf(0);
|
|
25
|
+
return slice.toString('utf8', 0, end === -1 ? slice.length : end);
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
function octal(buf, off, len) {
|
|
29
|
+
const raw = cstr(buf, off, len).trim();
|
|
30
|
+
if (!raw) return 0;
|
|
31
|
+
// base-256(大文件用):首字节最高位为 1
|
|
32
|
+
if (buf[off] & 0x80) {
|
|
33
|
+
let n = 0;
|
|
34
|
+
for (let i = off + 1; i < off + len; i += 1) n = n * 256 + buf[i];
|
|
35
|
+
return n;
|
|
36
|
+
}
|
|
37
|
+
const n = parseInt(raw.replace(/[^0-7]/g, ''), 8);
|
|
38
|
+
return Number.isFinite(n) ? n : 0;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** PAX 记录:`<len> <key>=<value>\n` 串联 */
|
|
42
|
+
function parsePax(data) {
|
|
43
|
+
const out = {};
|
|
44
|
+
let pos = 0;
|
|
45
|
+
while (pos < data.length) {
|
|
46
|
+
const sp = data.indexOf(0x20, pos);
|
|
47
|
+
if (sp === -1) break;
|
|
48
|
+
const len = parseInt(data.toString('latin1', pos, sp), 10);
|
|
49
|
+
if (!Number.isFinite(len) || len <= 0) break;
|
|
50
|
+
const record = data.toString('utf8', sp + 1, pos + len - 1); // 去掉尾部 \n
|
|
51
|
+
const eq = record.indexOf('=');
|
|
52
|
+
if (eq > 0) out[record.slice(0, eq)] = record.slice(eq + 1);
|
|
53
|
+
pos += len;
|
|
54
|
+
}
|
|
55
|
+
return out;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* 读 tar.gz,返回条目数组(**只含普通文件与目录**,带数据)。
|
|
60
|
+
* @param {Buffer} gzBuffer .tgz 原始字节
|
|
61
|
+
* @returns {Array<{path:string,type:'file'|'dir',mode:number,size:number,data:Buffer|null}>}
|
|
62
|
+
*/
|
|
63
|
+
export function readTarGz(gzBuffer) {
|
|
64
|
+
const buf = zlib.gunzipSync(gzBuffer);
|
|
65
|
+
const entries = [];
|
|
66
|
+
let pos = 0;
|
|
67
|
+
let pendingLongName = null;
|
|
68
|
+
let pendingPax = null;
|
|
69
|
+
|
|
70
|
+
while (pos + BLOCK <= buf.length) {
|
|
71
|
+
const header = buf.subarray(pos, pos + BLOCK);
|
|
72
|
+
// 全零块 = 结束(正常会有两块,一块也照停)
|
|
73
|
+
if (header.every((b) => b === 0)) break;
|
|
74
|
+
|
|
75
|
+
const name = cstr(header, 0, 100);
|
|
76
|
+
const mode = octal(header, 100, 8);
|
|
77
|
+
const size = octal(header, 124, 12);
|
|
78
|
+
const typeflag = String.fromCharCode(header[156] || 0x30);
|
|
79
|
+
const prefix = cstr(header, 345, 155);
|
|
80
|
+
const dataStart = pos + BLOCK;
|
|
81
|
+
const dataEnd = dataStart + size;
|
|
82
|
+
|
|
83
|
+
// 校验和(只用来发现"这不是 tar",不用于安全)
|
|
84
|
+
let sum = 0;
|
|
85
|
+
for (let i = 0; i < BLOCK; i += 1) sum += i >= 148 && i < 156 ? 0x20 : header[i];
|
|
86
|
+
const want = octal(header, 148, 8);
|
|
87
|
+
if (want && sum !== want) {
|
|
88
|
+
throw new Error(`tar 头校验和不符(偏移 ${pos}):可能是文件损坏,拒绝解包`);
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
const data = buf.subarray(dataStart, Math.min(dataEnd, buf.length));
|
|
92
|
+
const next = dataStart + Math.ceil(size / BLOCK) * BLOCK;
|
|
93
|
+
|
|
94
|
+
if (typeflag === 'x' || typeflag === 'g') {
|
|
95
|
+
pendingPax = { ...(pendingPax || {}), ...parsePax(data) };
|
|
96
|
+
pos = next;
|
|
97
|
+
continue;
|
|
98
|
+
}
|
|
99
|
+
if (typeflag === 'L') {
|
|
100
|
+
pendingLongName = cstr(data, 0, data.length);
|
|
101
|
+
pos = next;
|
|
102
|
+
continue;
|
|
103
|
+
}
|
|
104
|
+
if (typeflag === 'K') {
|
|
105
|
+
// GNU longlink:目标名,只在链接条目上有意义 —— 链接本身下面会被拒
|
|
106
|
+
pos = next;
|
|
107
|
+
continue;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
let entryPath = pendingPax?.path || pendingLongName || (prefix ? `${prefix}/${name}` : name);
|
|
111
|
+
pendingPax = null;
|
|
112
|
+
pendingLongName = null;
|
|
113
|
+
|
|
114
|
+
if (typeflag === '0' || typeflag === '\0' || typeflag === '7') {
|
|
115
|
+
entries.push({ path: entryPath, type: 'file', mode, size, data });
|
|
116
|
+
} else if (typeflag === '5') {
|
|
117
|
+
entries.push({ path: entryPath.replace(/\/+$/, ''), type: 'dir', mode, size: 0, data: null });
|
|
118
|
+
} else if (typeflag === '1' || typeflag === '2') {
|
|
119
|
+
throw new Error(
|
|
120
|
+
`压缩包含符号/硬链接条目(${entryPath}),已拒绝解包(防止越界写入)。` +
|
|
121
|
+
'正常 npm 包里不会有链接,这通常意味着包被篡改。',
|
|
122
|
+
);
|
|
123
|
+
} else {
|
|
124
|
+
throw new Error(`压缩包含不支持的条目类型 ${JSON.stringify(typeflag)}(${entryPath}),已拒绝解包`);
|
|
125
|
+
}
|
|
126
|
+
pos = next;
|
|
127
|
+
}
|
|
128
|
+
return entries;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* 把条目路径变成安全的相对路径(**所有越界判定只在这里**)。
|
|
133
|
+
* @param {string} raw tar 里的路径
|
|
134
|
+
* @param {string} [stripPrefix] 去掉的前缀(npm 包是 `package/`)
|
|
135
|
+
*/
|
|
136
|
+
export function safeEntryPath(raw, stripPrefix = '') {
|
|
137
|
+
let p = String(raw || '');
|
|
138
|
+
if (stripPrefix && p.startsWith(stripPrefix)) p = p.slice(stripPrefix.length);
|
|
139
|
+
p = p.replace(/^\.\//, '');
|
|
140
|
+
if (!p) return '';
|
|
141
|
+
if (p.includes('\\')) throw new Error(`压缩包路径含反斜杠(${raw}),拒绝解包`);
|
|
142
|
+
if (/^[a-zA-Z]:/.test(p)) throw new Error(`压缩包路径含盘符(${raw}),拒绝解包`);
|
|
143
|
+
if (p.startsWith('/')) throw new Error(`压缩包路径是绝对路径(${raw}),拒绝解包`);
|
|
144
|
+
const parts = p.split('/');
|
|
145
|
+
if (parts.some((s) => s === '..')) throw new Error(`压缩包路径含 ..(${raw}),拒绝解包`);
|
|
146
|
+
if (parts.some((s) => s === '.' && parts.length > 1) || parts.includes('')) {
|
|
147
|
+
// 空的中间段(`a//b`)只是写法怪,抹平即可,不算攻击
|
|
148
|
+
p = parts.filter((s) => s && s !== '.').join('/');
|
|
149
|
+
}
|
|
150
|
+
return p;
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* 解包到目录。**先校验全部条目再落盘**:一个坏条目都不写。
|
|
155
|
+
* @returns {{files:number,dirs:number,bytes:number}}
|
|
156
|
+
*/
|
|
157
|
+
export function extractTarGz(gzBuffer, destDir, { stripPrefix = 'package/', allowTop = null } = {}) {
|
|
158
|
+
const entries = readTarGz(gzBuffer);
|
|
159
|
+
const root = path.resolve(destDir);
|
|
160
|
+
const allow = Array.isArray(allowTop) ? new Set(allowTop) : null;
|
|
161
|
+
const plan = [];
|
|
162
|
+
const skipped = [];
|
|
163
|
+
let bytes = 0;
|
|
164
|
+
let fileCount = 0;
|
|
165
|
+
|
|
166
|
+
for (const one of entries) {
|
|
167
|
+
const rel = safeEntryPath(one.path, stripPrefix);
|
|
168
|
+
if (!rel) continue;
|
|
169
|
+
if (allow) {
|
|
170
|
+
const top = rel.split('/')[0];
|
|
171
|
+
if (!allow.has(top)) {
|
|
172
|
+
// 白名单外的东西**不落盘**,但记下来(报告里要能看见"包里多了什么")
|
|
173
|
+
skipped.push(rel);
|
|
174
|
+
continue;
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
const abs = path.resolve(root, rel);
|
|
178
|
+
if (abs !== root && !abs.startsWith(root + path.sep)) {
|
|
179
|
+
throw new Error(`压缩包条目越界(${one.path}),拒绝解包`);
|
|
180
|
+
}
|
|
181
|
+
if (one.type === 'file') {
|
|
182
|
+
bytes += one.size;
|
|
183
|
+
fileCount += 1;
|
|
184
|
+
}
|
|
185
|
+
plan.push({ ...one, rel, abs });
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
fs.mkdirSync(root, { recursive: true });
|
|
189
|
+
let dirCount = 0;
|
|
190
|
+
for (const one of plan) {
|
|
191
|
+
if (one.type === 'dir') {
|
|
192
|
+
fs.mkdirSync(one.abs, { recursive: true });
|
|
193
|
+
dirCount += 1;
|
|
194
|
+
continue;
|
|
195
|
+
}
|
|
196
|
+
fs.mkdirSync(path.dirname(one.abs), { recursive: true });
|
|
197
|
+
fs.writeFileSync(one.abs, one.data);
|
|
198
|
+
if (one.mode) {
|
|
199
|
+
try {
|
|
200
|
+
fs.chmodSync(one.abs, one.mode & 0o777);
|
|
201
|
+
} catch {
|
|
202
|
+
/* Windows 上 chmod 基本无效,忽略 */
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
return { files: fileCount, dirs: dirCount, bytes, skipped };
|
|
207
|
+
}
|