qiyu-cli 0.2.0 → 0.2.2
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/README.md +349 -57
- package/dist/cli.js +48 -7
- package/dist/commands/api-notes.js +54 -0
- package/dist/commands/api.js +113 -39
- package/dist/commands/auth.js +150 -28
- package/dist/commands/credentials-source.js +30 -5
- package/dist/commands/db-notes.js +75 -0
- package/dist/commands/db.js +112 -113
- package/dist/commands/query-notes.js +58 -0
- package/dist/commands/query.js +427 -56
- package/dist/commands/skill.js +477 -38
- package/dist/commands/spec-types.js +101 -1
- package/dist/commands/stats.js +139 -30
- package/dist/commands/store-flags.js +18 -0
- package/dist/commands/store-notes.js +38 -0
- package/dist/commands/store-precheck.js +254 -0
- package/dist/commands/store.js +128 -75
- package/dist/commands/sync-notes.js +367 -0
- package/dist/commands/sync-run.js +155 -44
- package/dist/commands/sync.js +182 -121
- package/dist/core/config.js +274 -24
- package/dist/core/credentials.js +38 -4
- package/dist/core/edition.js +13 -3
- package/dist/core/envelope.js +73 -9
- package/dist/core/errors.js +73 -16
- package/dist/core/http.js +151 -52
- package/dist/core/ratelimit.js +5 -1
- package/dist/core/registry/index.js +26 -2
- package/dist/core/registry/params/export.session.check.json +17 -2
- package/dist/core/registry/params/export.session.json +24 -2
- package/dist/core/registry/params/export.session.one.json +10 -2
- package/dist/core/registry/params/export.session.one.message.json +17 -2
- package/dist/core/registry/specs.json +64 -42
- package/dist/core/shell.js +30 -0
- package/dist/core/time.js +1 -1
- package/dist/core/validate.js +21 -2
- package/dist/output.js +204 -28
- package/dist/postinstall.js +14 -5
- package/dist/query/errors.js +145 -45
- package/dist/query/mask.js +1277 -25
- package/dist/query/metric-catalog.js +11 -0
- package/dist/query/native-error.js +189 -0
- package/dist/query/sandbox.js +129 -24
- package/dist/query/table-query.js +36 -5
- package/dist/schedule/install.js +136 -13
- package/dist/skill/check.js +11 -6
- package/dist/skill/detect.js +122 -27
- package/dist/skill/install.js +233 -43
- package/dist/skill/paths.js +54 -0
- package/dist/skill/qiyu/SKILL.md +38 -8
- package/dist/skill/qiyu/errors.md +5 -4
- package/dist/skill/qiyu/protocols.md +57 -5
- package/dist/skill/qiyu/setup.md +6 -2
- package/dist/store/config.js +92 -16
- package/dist/store/duckdb.js +51 -5
- package/dist/store/retry.js +92 -4
- package/dist/store/schema.js +26 -3
- package/dist/sync/engine.js +257 -65
- package/dist/sync/registry.js +4 -0
- package/dist/sync/state.js +20 -0
- package/dist/sync/tasks/dim.js +23 -14
- package/dist/sync/tasks/knowledge.js +50 -8
- package/dist/sync/tasks/pipeline.js +29 -9
- package/dist/sync/tasks/reports.js +176 -49
- package/dist/sync/tasks/sessions.js +88 -21
- package/dist/sync/tasks/tickets.js +59 -8
- package/dist/sync/types.js +60 -1
- package/dist/sync/windowing.js +0 -22
- package/dist/sync/write-contract.js +47 -0
- package/package.json +1 -1
package/dist/cli.js
CHANGED
|
@@ -7,6 +7,7 @@ import { PACKAGE_VERSION, SKILL_CONTRACT_VERSION } from './core/edition.js';
|
|
|
7
7
|
import { detectSkillState, entityUndeterminedNote, npmRelativeBase, resolveEntityDirSources, resolveSkillSourceDir, skillWarning, } from './skill/detect.js';
|
|
8
8
|
import { apiCommand } from './commands/api.js';
|
|
9
9
|
import { prettyAfterSubcommand } from './commands/spec-types.js';
|
|
10
|
+
import { DB_PATH_HELP } from './commands/store-flags.js';
|
|
10
11
|
import { wireLocalFallback } from './commands/local-fallback-wiring.js';
|
|
11
12
|
import { storeCommand } from './commands/store.js';
|
|
12
13
|
import { syncCommand } from './commands/sync.js';
|
|
@@ -18,6 +19,27 @@ import { skillCommand } from './commands/skill.js';
|
|
|
18
19
|
// 它只 import 各命令模块、不含入口逻辑,将来 `src/skill/check.ts` 从**那里**消费。
|
|
19
20
|
// 本文件 re-export 只是兼容入口(计划原文写的是 `cli.ts` 汇总),免得调用方改路径。
|
|
20
21
|
export { COMMAND_TREE } from './commands/tree.js';
|
|
22
|
+
/**
|
|
23
|
+
* `--version` 的 `meta.field_notes`。
|
|
24
|
+
*
|
|
25
|
+
* ⚠️ 为什么需要:`skill_contract_version` 是 CLI **自己**的正文契约号,而 SKILL.md 教
|
|
26
|
+
* Agent「用它判断手上的正文能否配这份 CLI」—— 手上有两个同名的数(CLI 的、已安装那份的),
|
|
27
|
+
* 不点名就会拿错(2026-10-28 实测:两者可以不等,且 `--version` 不报已安装那份)。
|
|
28
|
+
*/
|
|
29
|
+
export function versionFieldNotes() {
|
|
30
|
+
return {
|
|
31
|
+
version: 'CLI 包版本(npm 包的语义版本号)',
|
|
32
|
+
skill_contract_version: 'CLI 自己的正文契约号 —— 不是已安装那份的。'
|
|
33
|
+
+ '要判断已安装的 skill 正文能否配这份 CLI,拿它与 `skill where` 的 '
|
|
34
|
+
+ 'entity.installed.skill_contract_version 比,相等才配。'
|
|
35
|
+
+ '⚠️ `--version` 既不读安装清单、也不读已安装正文:这个值是 CLI 自己的常量,'
|
|
36
|
+
+ '上文「相等才配」只是拿它与 `skill where` 报出的数比。那个数的可靠性由 `skill where` 兜:'
|
|
37
|
+
+ '它会拿实体当前内容与清单记录的 content_hash 比对,正文被手工改过(或读不动)时'
|
|
38
|
+
+ '`entity.installed.compatible` 报 null(判定不了),不会拿旧清单给改过的正文背书。'
|
|
39
|
+
+ '⚠️ 清单缺失或损坏时整个 entity.installed 是 null(不是它下面某个字段为 null)——'
|
|
40
|
+
+ '先判 entity.installed 非 null 再读,也不要把 null 当 0',
|
|
41
|
+
};
|
|
42
|
+
}
|
|
21
43
|
// —— 限流 fallback 接线(G1 契约小件)——
|
|
22
44
|
// `api call` 的限流错误要附「改用本地查询」建议(retry_strategy/fallback),
|
|
23
45
|
// 而该建议需要 sync 任务注册表与本地库探测;`commands/api.ts` 按分层红线
|
|
@@ -41,6 +63,14 @@ const COMMANDS = {
|
|
|
41
63
|
* ⚠️ 全局约束承诺了「CLI 的 `--help` 一律中文」,所以这里必须实现它,
|
|
42
64
|
* 不能让它落到「未知子命令」分支(实测那会输出「未知子命令:--help」,退出码 2)。
|
|
43
65
|
*/
|
|
66
|
+
/**
|
|
67
|
+
* 分派层三条伪命令(`--help` / `--version` / `--pretty`)共同接受的 token。
|
|
68
|
+
*
|
|
69
|
+
* ⚠️ **一份**清单而不是三份(2026-11-06 审查):此前三条分支各写各的豁免,缺少对方
|
|
70
|
+
* 的 token,于是 `--help --version` / `--pretty --version` 会把另一个合法全局选项
|
|
71
|
+
* 说成「未知参数」——同一命令行换个顺序就换一种结果(`--version --help` 是 0)。
|
|
72
|
+
*/
|
|
73
|
+
const PSEUDO_TOKENS = new Set(['--help', '-h', '--version', '--pretty']);
|
|
44
74
|
const USAGE = `用法:qiyu <子命令> [参数]
|
|
45
75
|
|
|
46
76
|
全局选项:
|
|
@@ -52,7 +82,9 @@ const USAGE = `用法:qiyu <子命令> [参数]
|
|
|
52
82
|
Agent 解析不需要它)
|
|
53
83
|
|
|
54
84
|
子命令:
|
|
55
|
-
auth whoami
|
|
85
|
+
auth whoami 检查凭证是否已配置(只查存在性,不校验有效性)
|
|
86
|
+
auth login [--profile <name>]
|
|
87
|
+
把环境变量里的凭证写入配置文件(新建目录 0700、文件 0600)
|
|
56
88
|
api list [--all] 列出接口(默认只列可主动调用的出站接口)
|
|
57
89
|
api call <id> [--body <JSON>] [--yes] [--no-validate] [--strict]
|
|
58
90
|
调用接口;危险接口必须加 --yes
|
|
@@ -87,12 +119,13 @@ const USAGE = `用法:qiyu <子命令> [参数]
|
|
|
87
119
|
行数上限 / 超时 / 关闭默认脱敏(细节见 qiyu query --help)
|
|
88
120
|
--db <path> / --profile <name> / --backend <name>
|
|
89
121
|
db / query / stats 共用的存储定位(与 store / sync 同族)
|
|
122
|
+
${DB_PATH_HELP}
|
|
90
123
|
|
|
91
124
|
出错时 stdout 是 {"ok":false,"error":{code,kind,retryable,message,hint?}}。
|
|
92
125
|
⚠️ 请按 kind 分支,不要按 code —— code 只是个标签:它可能是服务端的
|
|
93
126
|
数字码(如 14009),也可能是本 CLI 合成的词(usage / network / internal /
|
|
94
|
-
auth_missing / config_insecure / confirm_required / store_locked / store_not_initialized /
|
|
95
|
-
local_rate_limit / query_error / sandbox_blocked / query_timeout / unknown)。
|
|
127
|
+
auth_missing / config_insecure / config_invalid / confirm_required / store_locked / store_not_initialized /
|
|
128
|
+
local_rate_limit / query_error / sandbox_blocked / query_timeout / sync_not_run / unknown)。
|
|
96
129
|
合成词查不到官方错误码表。
|
|
97
130
|
|
|
98
131
|
退出码:0 成功 · 1 业务错误 · 2 用法错误 · 3 网络错误 · 4 需要 --yes
|
|
@@ -137,7 +170,10 @@ export async function run(argv) {
|
|
|
137
170
|
// (与 `api list --help --help` 同答 —— 都不算"额外参数")。
|
|
138
171
|
// ⚠️ `--pretty` 同样豁免(2026-10-08;G1 起已实现为缩进开关):它是**合法 flag**,
|
|
139
172
|
// 不是"额外参数"—— `qiyu --help --pretty` 给帮助(与 `api list --help --pretty` 同答)。
|
|
140
|
-
|
|
173
|
+
// ⚠️ 三条伪命令的豁免清单必须**互相包含**(2026-11-06 审查):此前各写各的,
|
|
174
|
+
// 于是 `--help --version` 退 2 并说 `--version` 是「未知参数」——一个就在这张帮助里
|
|
175
|
+
// 列着的全局选项被自己的 CLI 称作未知,取决于书写顺序(`--version --help` 却是 0)。
|
|
176
|
+
const extra = rest.filter((a) => !PSEUDO_TOKENS.has(a));
|
|
141
177
|
if (extra.length > 0) {
|
|
142
178
|
return usageFail(`未知参数:${describeArgs(extra)}。--help 不接受额外参数`);
|
|
143
179
|
}
|
|
@@ -156,14 +192,14 @@ export async function run(argv) {
|
|
|
156
192
|
// 输出走 `ok()`(而非自己写 stdout):skill 安装态提示要能经 `meta.warnings`
|
|
157
193
|
// 合并进来,且成功信封的形态由 output.ts 一处统一。
|
|
158
194
|
if (sub === '--version') {
|
|
159
|
-
const extra = rest.filter((a) => a
|
|
195
|
+
const extra = rest.filter((a) => !PSEUDO_TOKENS.has(a));
|
|
160
196
|
if (extra.length > 0) {
|
|
161
197
|
return usageFail(`未知参数:${describeArgs(extra)}。--version 不接受额外参数`);
|
|
162
198
|
}
|
|
163
199
|
// G1:--version --pretty → 缩进的版本 JSON(帮助/版本检查是例外:--pretty 有可修饰的对象)
|
|
164
200
|
if (rest.includes('--pretty'))
|
|
165
201
|
setPretty(true);
|
|
166
|
-
return ok({ version: PACKAGE_VERSION, skill_contract_version: SKILL_CONTRACT_VERSION });
|
|
202
|
+
return ok({ version: PACKAGE_VERSION, skill_contract_version: SKILL_CONTRACT_VERSION }, { field_notes: versionFieldNotes() });
|
|
167
203
|
}
|
|
168
204
|
// ⚠️ 分派层的 `--pretty` 必须与叶子层同答(2026-10-08 统一)。此前它落到
|
|
169
205
|
// 「未知子命令:--pretty」—— 而 `--pretty` 是真实存在的输出开关(G1 已实现)
|
|
@@ -174,7 +210,12 @@ export async function run(argv) {
|
|
|
174
210
|
// G1:--pretty 已实现,但它必须写在具体子命令之后(`qiyu api list --pretty`)。
|
|
175
211
|
// 写在顶层时没有任何可修饰的输出(帮助是裸文本、version 是另一条伪命令)。
|
|
176
212
|
if (sub === '--pretty') {
|
|
177
|
-
|
|
213
|
+
// `--version` 是合法全局选项,但它必须写在 `--pretty` **之前**(`qiyu --version
|
|
214
|
+
// --pretty`)—— 报「未知参数:--version」是事实错误(2026-11-06 审查)。
|
|
215
|
+
if (rest.includes('--version')) {
|
|
216
|
+
return usageFail('--version 必须写在 --pretty 之前:`qiyu --version --pretty`');
|
|
217
|
+
}
|
|
218
|
+
const unknown = rest.filter((a) => a.startsWith('-') && !PSEUDO_TOKENS.has(a));
|
|
178
219
|
const positional = rest.filter((a) => !a.startsWith('-'));
|
|
179
220
|
const extra = [...unknown, ...positional];
|
|
180
221
|
if (extra.length > 0) {
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
// src/commands/api-notes.ts
|
|
2
|
+
//
|
|
3
|
+
// `api call` 的 `meta.field_notes` 图例(2026-10-28)。
|
|
4
|
+
//
|
|
5
|
+
// ⚠️ 为什么 `api call` 需要图例:它的 `data` 是**上游载荷**,与其余命令的
|
|
6
|
+
// `data`(CLI 自己的契约)不是一回事 —— 不点破,Agent 会按 `qiyu db tables` 的
|
|
7
|
+
// 形状去读 `ticket.search` 的返回。`meta` 里的 `endpoint` / `not_found` /
|
|
8
|
+
// `warnings` / `note` 也各有坑(尤其 `not_found` 只覆盖**结构性为空**)。
|
|
9
|
+
//
|
|
10
|
+
// ⚠️ 为什么键是 `data`(信封顶层):图例解释的是「读者会读的那个键」,而 `data`
|
|
11
|
+
// 恰恰是最容易被误读的一个 —— 它是本输出里唯一来自上游的键。
|
|
12
|
+
export function callFieldNotes() {
|
|
13
|
+
return {
|
|
14
|
+
data: '上游响应解包后的载荷:本 CLI 按信封形状取出 data / result / staffInfo 等键'
|
|
15
|
+
// ⚠️ 不能说「原样透传、不改写」(2026-11-07 审查实测):形状 M 的载荷在透传前被
|
|
16
|
+
// trim(),形状 C 的畸形 JSON 先经 repairUnquotedIntKeys 修复再解析。
|
|
17
|
+
// ⚠️ 也不能让读者去 `api schema` 查响应字段:它只有请求侧 params 与
|
|
18
|
+
// `response_shape:{kind}`,没有任何响应字段表(2026-11-07 审查)。
|
|
19
|
+
+ '(信封形状 M 会 trim 首尾空白,形状 C 的畸形 JSON 键会先被修复再解析)。'
|
|
20
|
+
+ '⚠️ 本 CLI 没有响应字段表:`qiyu api schema` 只给请求参数与信封种类,'
|
|
21
|
+
+ '各字段的确切含义以七鱼官方文档为准,不要按其他命令 data 的形状推断',
|
|
22
|
+
endpoint: '本次调用的接口 id(把结果与请求对上用)',
|
|
23
|
+
warnings: '⚠️ 这是多来源数组,元素形状不统一:'
|
|
24
|
+
+ '① body 校验的软告警(对象,含 `kind` / `message`),'
|
|
25
|
+
// ⚠️ `field` **不保证**存在(Sourcery 指出):`non_json_body`(body_kind 非 json 时
|
|
26
|
+
// 整条请求级的提示 —— 传输层仍按 JSON.stringify 发 JSON 字节,不是该编码的原文)是**整条请求**级的提示,没有单一字段可归因 —— 它只带 `kind` 与
|
|
27
|
+
// `message`。消费者按 `w.field` 取值会拿到 `undefined`。
|
|
28
|
+
+ '`field` 仅在告警属于某个具体字段时出现(如 `unknown_field` / '
|
|
29
|
+
+ '`type_mismatch` / `alias_normalized`),`non_json_body` 这类整条请求级的提示没有它,'
|
|
30
|
+
+ '② CLI 级的安装态提示(如 skill 未安装)——'
|
|
31
|
+
+ '同一次输出里已有 ① 时它被包成 `{kind:"skill_drift", message}`,否则是裸字符串。'
|
|
32
|
+
+ '故按 `w.kind` 取值前先判元素类型,别假定它一定是对象。'
|
|
33
|
+
+ '⚠️ 键不出现 ≠ body 正确:它只在「没有软告警且没有 CLI 提示」时不出现,'
|
|
34
|
+
+ '--no-validate 只保证不产生 ①(body 未校验),② 照旧出现。'
|
|
35
|
+
+ '⚠️ `missing_required` 永远不会出现在这里 —— 缺必填是硬拒绝(退出码 2、错误信封),'
|
|
36
|
+
+ '不要写「在 warnings 里找 missing_required」的分支。'
|
|
37
|
+
+ '它是本 CLI 的提示,不是上游的业务告警',
|
|
38
|
+
not_found: 'true = 解包后的载荷为空。判据作用在解包后的 payload 上:'
|
|
39
|
+
+ 'data / result 形状下是 {} / []。形状 C 且 message 能解析成 JSON 时,'
|
|
40
|
+
+ '解析出的 {} / [] 同样置位(message 缺失或解析失败是失败,不是 not_found)。'
|
|
41
|
+
+ 'envelope 未登记的宽松模式下,message 能解析成 JSON 且结果为空同样置位。'
|
|
42
|
+
+ '整条 200 响应没有载荷键时,只有信封已实测且不是 D 族(A/B/D-nf)的接口判为查无此物'
|
|
43
|
+
// ⚠️ 形状 C **不在**这个列表里:C 分支对任何响应都会先尝试解析 message,
|
|
44
|
+
// `{code:200}`(无 message)在 C 上直接判失败,根本走不到末尾兜底。
|
|
45
|
+
+ '(形状 C 不在此列:它的无 message 是失败,不是查无此物)'
|
|
46
|
+
+ '(envelope 为 null 不在此断言。形状 M 的空 message 判失败,不判 not_found)。'
|
|
47
|
+
+ 'staffInfo 形状恒不置位。'
|
|
48
|
+
+ '⚠️ 只覆盖结构性为空:业务为空(如 ticket.search 查到 0 条返回 {total:0,tickets:[]})'
|
|
49
|
+
+ '不会置位 —— 没有 not_found 不等于有数据',
|
|
50
|
+
warning: '与 not_found 同时出现的一句话说明(固定文案)',
|
|
51
|
+
note: '该接口的已知坑(来自注册表,只在登记了 note 的接口上出现)。'
|
|
52
|
+
+ '⚠️ 它是静态说明、不是本次调用的结果',
|
|
53
|
+
};
|
|
54
|
+
}
|
package/dist/commands/api.js
CHANGED
|
@@ -7,9 +7,9 @@ import { loadValidationOverrides } from '../core/registry/validation-overrides.j
|
|
|
7
7
|
import { loadParams } from '../core/registry/params.js';
|
|
8
8
|
import { effectiveBodyParams, normalizeAliases, validateBody } from '../core/validate.js';
|
|
9
9
|
import { ok, fail, usageFail, describeArgs, setPretty, EXIT } from '../output.js';
|
|
10
|
-
import { sanitizeMessage } from '../core/sanitize.js';
|
|
11
10
|
import { localFallbackFor } from './local-fallback.js';
|
|
12
|
-
import {
|
|
11
|
+
import { callFieldNotes } from './api-notes.js';
|
|
12
|
+
import { GLOBAL_FLAGS, prettyAfterSubcommand, prettyPositionalProblem, REJECTED_FLAGS, renderFlagNames } from './spec-types.js';
|
|
13
13
|
/** `api list` 的业务 flag(`flags` 里还要再并上全局 flag)。 */
|
|
14
14
|
const LIST_FLAGS = [{ name: '--all', kind: 'bool' }];
|
|
15
15
|
/** `api call` 的业务 flag;顺序即「可用:」文案的顺序。 */
|
|
@@ -19,7 +19,7 @@ const CALL_FLAGS = [
|
|
|
19
19
|
{ name: '--no-validate', kind: 'bool' },
|
|
20
20
|
{ name: '--strict', kind: 'bool' },
|
|
21
21
|
];
|
|
22
|
-
/** `api schema` 没有业务 flag——只有全局 flag
|
|
22
|
+
/** `api schema` 没有业务 flag——只有全局 flag(`--pretty` 是可用的输出开关)。 */
|
|
23
23
|
const SCHEMA_FLAGS = [];
|
|
24
24
|
/**
|
|
25
25
|
* 命令契约(F 组 D4):`skill check` 据此判断 skill 正文里的 `qiyu api …` 是否真的存在。
|
|
@@ -59,13 +59,19 @@ const LIST_KNOWN = new Set([...GLOBAL_FLAGS, ...LIST_FLAGS].map((f) => f.name));
|
|
|
59
59
|
const CALL_KNOWN = new Set([...GLOBAL_FLAGS, ...CALL_FLAGS].map((f) => f.name));
|
|
60
60
|
const SCHEMA_KNOWN = new Set([...GLOBAL_FLAGS, ...SCHEMA_FLAGS].map((f) => f.name));
|
|
61
61
|
/**
|
|
62
|
-
* 「可用:…」文案里的 flag 清单。`api list`
|
|
62
|
+
* 「可用:…」文案里的 flag 清单。`api list` 从常量渲染即可。
|
|
63
|
+
*
|
|
64
|
+
* ⚠️ 三条命令都必须列 `--pretty`(2026-11-06 审查):同一个拼错(`--prety`)此前得到
|
|
65
|
+
* 三种答案——`api list` 说「可用:--all」、`api call` 说「…--strict」、`api schema`
|
|
66
|
+
* 说「可用:--pretty」,而三条**都接受** `--pretty`。文案是给 Agent 的纠错依据,
|
|
67
|
+
* 漏列等于让它继续拼错。
|
|
63
68
|
* ⚠️ `api call` / `api schema` 的文案保持**字面量**:`readme.test.ts:58` 按**源文本**
|
|
64
69
|
* 钉着 `可用:--body <JSON>、--yes、--no-validate、--strict`,改成渲染会让它变红;
|
|
65
|
-
* 而两处的运行时文案又被 `api.test.ts`
|
|
70
|
+
* 而两处的运行时文案又被 `api.test.ts` 钉着。事实源仍是上面的 `FlagSpec` 常量
|
|
66
71
|
* ——`command-tree.test.ts` 有一条断言把文案里点名的 flag 与 spec 的接受集对齐。
|
|
67
72
|
*/
|
|
68
|
-
const
|
|
73
|
+
const PRETTY_FLAG = GLOBAL_FLAGS.find((f) => f.name === '--pretty');
|
|
74
|
+
const LIST_AVAILABLE = renderFlagNames([...LIST_FLAGS, PRETTY_FLAG]);
|
|
69
75
|
const API_USAGE = `用法:qiyu api <list|call|schema> [参数]
|
|
70
76
|
|
|
71
77
|
qiyu api list [--all] 列出接口
|
|
@@ -75,13 +81,13 @@ const API_USAGE = `用法:qiyu api <list|call|schema> [参数]
|
|
|
75
81
|
--all 连同不可主动调用的接口一起列出
|
|
76
82
|
--body 请求体(JSON 字面量)。省略与传 {} 是两条不同的服务端路径
|
|
77
83
|
--yes 危险接口(写/破坏性操作)必须显式确认
|
|
78
|
-
--no-validate 关闭 body
|
|
84
|
+
--no-validate 关闭 body 校验与别名改写(CLI 级安装提示照旧出现在 warnings;危险门禁不受影响)
|
|
79
85
|
--strict 把「未知字段/类型不符」的提示升级为拒绝
|
|
80
86
|
|
|
81
87
|
出错时 stdout 是 {"ok":false,"error":{code,kind,retryable,message,hint?}}。
|
|
82
88
|
⚠️ 请按 kind 分支,不要按 code —— code 只是个标签:它可能是服务端的
|
|
83
89
|
数字码(如 14009),也可能是本 CLI 合成的词(usage / network / internal /
|
|
84
|
-
auth_missing / config_insecure / confirm_required / store_locked / store_not_initialized / local_rate_limit / unknown)。合成词查不到官方错误码表。
|
|
90
|
+
auth_missing / config_insecure / confirm_required / store_locked / store_not_initialized / local_rate_limit / sync_not_run / unknown)。合成词查不到官方错误码表。
|
|
85
91
|
|
|
86
92
|
退出码:0 成功 · 1 业务错误 · 2 用法错误 · 3 网络错误 · 4 需要 --yes
|
|
87
93
|
`;
|
|
@@ -113,15 +119,19 @@ export async function apiCommand(argv) {
|
|
|
113
119
|
// 子命令之后(`api list --pretty`)。次序保持 **未知/位置 → help → pretty 指引**。
|
|
114
120
|
if (sub === '--pretty') {
|
|
115
121
|
const unknown = argv.slice(1).filter((a) => a.startsWith('-') && a !== '--pretty' && a !== '--help' && a !== '-h');
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
if (extra.length > 0) {
|
|
119
|
-
return usageFail(`未知参数:${describeArgs(extra)}。--pretty 不接受额外参数`);
|
|
122
|
+
if (unknown.length > 0) {
|
|
123
|
+
return usageFail(`未知参数:${describeArgs(unknown)}。--pretty 不接受额外参数`);
|
|
120
124
|
}
|
|
125
|
+
// ⚠️ 位置参数里的拼错子命令名必须在 help 之前拒绝(Codex 2026-11-08 第四轮 P2)——
|
|
126
|
+
// `api --pretty typo --help` 曾经把 typo 静默吞掉、help 退 0。
|
|
127
|
+
const badPos = prettyPositionalProblem(argv.slice(1), API_SPECS);
|
|
128
|
+
if (badPos !== undefined)
|
|
129
|
+
return usageFail(badPos);
|
|
121
130
|
if (argv.includes('--help') || argv.includes('-h')) {
|
|
122
131
|
process.stdout.write(API_USAGE);
|
|
123
132
|
return EXIT.OK;
|
|
124
133
|
}
|
|
134
|
+
// ⚠️ 位置参数按「顺序写反」引导(2026-11-07 审查)—— 见 db.ts 同款注释。
|
|
125
135
|
return usageFail(prettyAfterSubcommand('api'));
|
|
126
136
|
}
|
|
127
137
|
if (sub === 'list')
|
|
@@ -272,16 +282,29 @@ function list(argv) {
|
|
|
272
282
|
// 旧文「false = 仅有文档依据」——但 settings.wxTemplates 实测时真调用过
|
|
273
283
|
// (每次都 14004 appId not bind,错误模式有实测片段,只是成功路径没走通)。
|
|
274
284
|
// 全局只当**索引**:true/false 各自测到/没测到什么,以该行 note 为准。
|
|
275
|
-
verified: 'true =
|
|
276
|
-
'
|
|
285
|
+
verified: 'true = 该接口被真实观测过(不是「成功路径一定走通过」:验证了什么以该行 ' +
|
|
286
|
+
'note 为准 —— 可能是成功响应,也可能只是错误形态或不可调用状态,如 receive.message);' +
|
|
287
|
+
'没有 note 时只能按最弱含义理解「至少接触过真实服务」,不要假定成功路径已验证。' +
|
|
288
|
+
'false = 成功路径未实测(可能只有错误响应或纯文档依据)。具体范围只在该行有 note 时才有说明',
|
|
277
289
|
dangerous: 'true = 危险操作,调用时需 --yes',
|
|
278
290
|
// ⚠️ direction 也必须解释 —— 它是 Agent 判断「我方能调它」还是「它回调我方」
|
|
279
291
|
// 的唯一依据。只输出 `outbound`/`inbound` 两个英文词,Agent 无从知道哪个
|
|
280
|
-
// 是"我可以主动调用",可能对着 inbound 的接口去拼 URL
|
|
281
|
-
//
|
|
282
|
-
//
|
|
283
|
-
|
|
284
|
-
|
|
292
|
+
// 是"我可以主动调用",可能对着 inbound 的接口去拼 URL。与 verified/dangerous
|
|
293
|
+
// 同一条标准:只输出不解释 = 没输出。
|
|
294
|
+
//
|
|
295
|
+
// ⚠️⚠️ 措辞**不能**说「inbound 的 path 是占位符 `/`」(2026-11-02 审查实测):
|
|
296
|
+
// 那是全称断言,而 17 条 inbound 里 9 条是 `/`、**5 条有真实路径**
|
|
297
|
+
// (`get_token` `/get_token`、`get_order` `/get_order`、`get_user_info`
|
|
298
|
+
// `/get_user_info`、`get_call_order` `/get_call_order`、`get_call_user_info`
|
|
299
|
+
// `/get_call_user_info`,全部 `callable: false`)、3 条是 `null`(路径未收录)。
|
|
300
|
+
// 旧措辞会让 Agent 拿「path 是不是 `/`」当 inbound 的判据:看到 `/get_token`
|
|
301
|
+
// 就以为它可主动调用 —— 而它同样不可调用(这几条是**厂商推送给本方、由本方提供
|
|
302
|
+
// 的地址**,方向是入站)。真正的判据只有 `callable` 与 `direction` 两个字段。
|
|
303
|
+
direction: 'outbound = 本方主动调用它;inbound = 对方向本方推送(**一律不可主动调用**,'
|
|
304
|
+
+ '以 direction 与 callable 为准)。⚠️ inbound 的 path **不保证**是占位符 `/`:'
|
|
305
|
+
+ '多数(9/17)是占位符,另有若干是真实路径(如 `/get_token`)——那是厂商推送给'
|
|
306
|
+
+ '本方时用的地址,`direction: inbound` 的那些即便有真实路径也不可主动调用;'
|
|
307
|
+
+ '另有 3 条是 `null`(路径未收录,见 path 说明)。',
|
|
285
308
|
callable: 'false = 结构上不可主动调用(如 inbound 推送);Agent 只能查、不能调',
|
|
286
309
|
// ⚠️ **`path` 的两种"不可用"必须区分**(2026-10-05 加)。`api list --all` 会输出
|
|
287
310
|
// `path: null` 的行(`wecom.robot.switch` 的文档页 paths 键是中文散文、解析不出路径)。
|
|
@@ -292,8 +315,10 @@ function list(argv) {
|
|
|
292
315
|
// ② 认为该接口"方向未知"从而不去用它 —— 而它其实只是**路径未收录**。
|
|
293
316
|
// 必须点明:`null` = 路径未收录(数据缺口),不是"方向未知"也不是"不存在"。
|
|
294
317
|
path: '本行 path 的两种不可用形态含义不同:' +
|
|
295
|
-
'`null` =
|
|
296
|
-
'
|
|
318
|
+
'`null` = **路径未收录**(文档页未提供可用路径,是数据缺口;不代表接口不存在)。' +
|
|
319
|
+
'⚠️ 本注册表里 null 路径**必然伴随 callable=false**(加载器强制:callable 但无路径' +
|
|
320
|
+
'会直接拒绝加载,避免拼出 `…/null?appKey=`),即结构上不可主动调用;' +
|
|
321
|
+
'direction 仍可为 outbound —— 方向描述协议流向,不是可调用性;' +
|
|
297
322
|
'`"/"` = **入站推送的占位符**(path 是占位符不是真实路径,见 direction 说明)。' +
|
|
298
323
|
'两种情况都**不可**据此拼 URL 调用。',
|
|
299
324
|
// ⚠️ `max_window_days` 的语义必须解释 —— 它是最容易被误读的字段。
|
|
@@ -301,8 +326,10 @@ function list(argv) {
|
|
|
301
326
|
// 而字段只存一个数字。若不说明"按精确比较理解",Agent 会按向下取整
|
|
302
327
|
// 切到"31 天零 23 小时",然后在精确比较的接口(robot.statistic.summary)
|
|
303
328
|
// 上撞 14004 —— 而它无从知道是自己把上界理解松了。
|
|
304
|
-
max_window_days: '
|
|
329
|
+
max_window_days: '时间跨度上界(天),**按毫秒精确比较**:`end - start` 不得超过 `max_window_days * 86400000`。' +
|
|
305
330
|
'不要按"向下取整"切到 N 天零若干小时 —— 部分接口(robot.statistic.summary)会拒绝。' +
|
|
331
|
+
'⚠️ 边界开闭**随接口而变**:报表族实测恰好等于上界可接受;export.session 实测**恰好等于也会被拒**' +
|
|
332
|
+
'(14004 Timestamp interval limit,上界减 1ms 通过)—— 对它必须严格小于。拿不准时留出余量。' +
|
|
306
333
|
'未输出该键的接口没有已知上限',
|
|
307
334
|
// ⚠️ category 的**来源与稳定度**都必须说清:它是 Apifox 文档目录路径,
|
|
308
335
|
// 不是厂商 API 契约的一部分。不说清,Agent 会把它当稳定枚举去写分支逻辑
|
|
@@ -323,22 +350,29 @@ function list(argv) {
|
|
|
323
350
|
'⚠️ `--strict` 把「未知字段/类型不符」升级为拒绝,但那是「本地参数表闭集一致性」检查,' +
|
|
324
351
|
'**不是对服务端行为的保证**——参数表漏记时它会误拒合法字段,此时**不要删字段重试**。' +
|
|
325
352
|
'⚠️ 传错的字段可能被服务端以 **14004** 拒绝,也可能被**静默忽略**——**别把「返回成功」当作「字段写对了」**。',
|
|
353
|
+
// ⚠️ 这四个是 **meta 键**(不在行里),此前完全裸奔(2026-11-04 反向 sweep 实测):
|
|
354
|
+
// Agent 读 `registry_complete` 判断「能不能假定清单全」、读 `rows` 判断「拿到几条」,
|
|
355
|
+
// 而 `rows` 是**过滤后**的条数 —— 不与注册表总数相等是设计如此,不是数据缺口。
|
|
356
|
+
rows: '本次输出的行数(= data.length。缺省只列可主动调用的出站接口,所以不等于注册表总数)',
|
|
357
|
+
filter: '本次的过滤口径:`可主动调用`(缺省)= 只含 callable 且 outbound 的接口;`全部` = 带 --all,含入站与不可调用。不要拿缺省行数当注册表总量',
|
|
358
|
+
registry_complete: 'true = 本地注册表已收录全部接口(154 条);false = 尚未收录完整,未列出的接口不等于不存在',
|
|
359
|
+
registry_note: '上面那个布尔的人读说明(与 registry_complete 同源,同时输出不会自相矛盾)',
|
|
326
360
|
},
|
|
327
361
|
});
|
|
328
362
|
}
|
|
329
363
|
const SCHEMA_USAGE = `用法:qiyu api schema <接口id> [--pretty]\n\n 查看某接口的请求参数表(params)与响应形状(response_shape)。\n\n--pretty 输出缩进 JSON(人类可读;Agent 解析不需要它,默认紧凑输出已是合法 JSON)\n`;
|
|
330
364
|
async function schema(argv) {
|
|
331
365
|
const unknown = argv.filter((a) => a.startsWith('-') && !SCHEMA_KNOWN.has(a));
|
|
332
|
-
// ⚠️ 文案逐字保留 `可用:--pretty
|
|
333
|
-
//
|
|
366
|
+
// ⚠️ 文案逐字保留 `可用:--pretty`:`--help`/`-h` 是帮助开关、不进「可用参数」清单,
|
|
367
|
+
// `--pretty` 是唯一非业务的接受项(三条 api 子命令的清单口径一致,2026-11-06 审查)。
|
|
334
368
|
if (unknown.length > 0)
|
|
335
369
|
return usageFail(`未知参数:${describeArgs(unknown)}。可用:--pretty`);
|
|
336
370
|
const positional = argv.filter((a) => !a.startsWith('-'));
|
|
337
371
|
const help = argv.includes('--help') || argv.includes('-h');
|
|
338
|
-
// 3a/3b:help 优先于「缺 id」与「位置参数 > 1
|
|
372
|
+
// 3a/3b:help 优先于「缺 id」与「位置参数 > 1」。⚠️ 帮助请求不再校验位置参数
|
|
373
|
+
// (2026-11-06 审查):`api schema ticket.search --help` 是常规写法,此前被判
|
|
374
|
+
// 「未知参数:ticket.search」退 2 —— 而它正是用户想看帮助的那个 id。
|
|
339
375
|
if (help) {
|
|
340
|
-
if (positional.length > 0)
|
|
341
|
-
return usageFail(`未知参数:${describeArgs(positional)}。--help 不接受额外参数`);
|
|
342
376
|
process.stdout.write(SCHEMA_USAGE);
|
|
343
377
|
return EXIT.OK;
|
|
344
378
|
}
|
|
@@ -398,13 +432,51 @@ async function schema(argv) {
|
|
|
398
432
|
'⚠️ 限频桶是**进程内**的,跨 `qiyu api call` 不共享状态 —— 本表只用于告诉调用方' +
|
|
399
433
|
'「撞上限流后该等多久」,不承诺 CLI 会替你排队',
|
|
400
434
|
has_body_schema: 'true = 本接口有可比对的 body 参数表(body_kind 为 json 且 body 参数数 > 0);不代表本次请求已校验,也不代表其余 bodyKind。本次校验结果见 api call 的 meta.warnings',
|
|
401
|
-
body_kind: '只有 json 会被 api call
|
|
402
|
-
|
|
435
|
+
body_kind: '只有 json 会被 api call 比对字段;其余(none/xml/multipart/text/form)不做字段校验。' +
|
|
436
|
+
'⚠️ 但传输层**恒为 JSON**:请求体一律 `JSON.stringify`、Content-Type 恒 `application/json` —— ' +
|
|
437
|
+
'`--body` 必须是合法 JSON,xml/multipart/text 的原始字节(如 `<xml>...</xml>`)无法通过本 CLI 表达。' +
|
|
438
|
+
'需要此类编码的接口经 api call 实际不可用;传 JSON 对象给它们只会发出 JSON 字节,' +
|
|
439
|
+
'别把「返回成功」当成「字段按接口文档生效了」',
|
|
440
|
+
'params[].auto': 'true = 仅对 callable 且 auth 为 checksum 的接口,CLI 自填鉴权 query 参数(appKey/time/checksum);入站/eventType 接口由回调方提供,不标 auto,调用方不要也不能通过 --body 传',
|
|
441
|
+
// ⚠️ params[] 的元素键此前只解释了 `auto`,其余六个全裸奔(2026-11-04 反向 sweep 实测)。
|
|
442
|
+
// ⚠️⚠️ 2026-11-04 自查修正:`in` 的初版写成「该参数放哪里:path = 进路径占位符、
|
|
443
|
+
// header = 进请求头」,读起来像调用方有这四个通道 —— 而 api call 的 URL 是
|
|
444
|
+
// `${BASE}${spec.path}?${q}`(不做路径占位符替换),headers 只有硬编码的
|
|
445
|
+
// Content-Type。这正是本仓库在 http.ts 自己的注释里警告过的「不要写到不存在的
|
|
446
|
+
// 通道上」。只有 `in=body` 是调用方经 --body 亲手传的通道;query 鉴权三件套由
|
|
447
|
+
// CLI 自填;path/header 没有人工通道。同样的话不要再说回「放哪里」。
|
|
448
|
+
'params[].in': '参数在「上游协议」里的位置(文档口径,不等于本 CLI 给了你对应通道)。'
|
|
449
|
+
+ '`body` = 请求体 —— 唯一能由 `--body` 传的位置;`query` = URL 查询串 —— 本 CLI 只自填鉴权三件套(标 auto),'
|
|
450
|
+
+ '非鉴权的 query 参数只出现在不可主动调用的入站接口上;`path` = 路径占位符 —— 本 CLI 不做占位符替换,'
|
|
451
|
+
+ '带 path 参数的接口也都不可主动调用;`header` = 请求头 —— 现注册表里只有 content-type,由 CLI 固定发送。'
|
|
452
|
+
+ '⚠️ 不要把非 body 参数塞进 --body —— 只有该接口有 JSON body 参数表(has_body_schema=true)'
|
|
453
|
+
+ '且未加 --no-validate 时才会得到 unknown_field 提示;其余情形它照样随请求发出(不做字段检查;'
|
|
454
|
+
+ '整条 body 仍会被 JSON.stringify 重写为紧凑 JSON,不是逐字节原样)、服务端大概率忽略'
|
|
455
|
+
+ '(别把「返回成功」当成「字段生效了」)',
|
|
456
|
+
'params[].type': '参数类型(string/integer/array/object/boolean/number)。⚠️ 只有该接口 `body_kind=json`、'
|
|
457
|
+
+ '`in=body` 且本次传入的字段会被 api call 比对:类型不符是软告警(integer 要求整数,1.5 也判不符),'
|
|
458
|
+
+ '--strict 下升级为拒绝;非 body 参数与非 json body_kind 都不做类型校验',
|
|
459
|
+
'params[].required': '上游文档声明必填。⚠️ 本 CLI 只对 **`body_kind=json` 且 `in=body`** 的必填做校验:'
|
|
460
|
+
+ '缺了拒绝(退出码 2;--no-validate 时不校验)。非 json bodyKind(xml/multipart/text/form)**不做任何必填检查**,'
|
|
461
|
+
+ '缺字段照样发出。'
|
|
462
|
+
+ 'query 的鉴权三件套(required=true)与 header 的 content-type 由 CLI 自填、不用你传 —— '
|
|
463
|
+
+ '⚠️ 这只对 callable 且 `auth=checksum` 的接口成立;入站接口的 required=true 鉴权字段没有任何自动填充,'
|
|
464
|
+
+ '本 CLI 也没有它们的传参通道。path 参数只出现在不可主动调用的接口上。'
|
|
465
|
+
+ '⚠️ false 有两种含义:普通可选;或它在某个 one_of 组里(组内任一存在即可,不是「可省」)—— 看 one_of 判断',
|
|
466
|
+
'params[].name': '参数名。⚠️ 只有 `in=body` 的字段能作为 `--body` 的键传入:'
|
|
467
|
+
+ 'in=query 的鉴权三件套由 CLI 自填,in=path 只出现在不可主动调用的接口上,in=header 由 CLI 固定发送 —— 本 CLI 没有这三者的传参通道',
|
|
468
|
+
'params[].description': '参数的文档说明(来自厂商文档,原样透出,不做校验)',
|
|
469
|
+
'params[].example': '文档给的示例值。⚠️ 含 `{{appKey}}` 这类模板占位符的不是字面值:'
|
|
470
|
+
+ '鉴权三件套的占位符由 CLI 自填(别塞进 --body);其余含占位符的示例只出现在不可主动调用的入站接口上',
|
|
403
471
|
dangerous: 'true = 危险操作,调用时需 --yes,否则退出码 4。必须由人类确认,不要自动追加 --yes',
|
|
404
472
|
callable: 'false = 结构上不可主动调用(如 inbound 推送);Agent 只能查、不能调',
|
|
405
473
|
path: 'null = 路径未收录(数据缺口);"/" = 入站占位符。两者都不可据此拼 URL',
|
|
406
474
|
response_shape: '仅供参照,不做校验',
|
|
407
475
|
one_of: 'one_of 数组每项是一组「组内任一存在即可满足」的字段,全缺会被拒绝(退出码 2);组内字段的 required 已因此降为 false —— false 是「二选一」的意思,不是「两个都可省」',
|
|
476
|
+
// meta 的两个键(2026-11-04 反向 sweep 实测此前裸奔):`endpoint` 回显查询的
|
|
477
|
+
// 是哪个接口(与 data.id 同值);`note` 是注册表里的静态说明(同 api call 的 note)。
|
|
478
|
+
endpoint: '本次查询的接口 id(回显输入,用来把结果与请求对上)',
|
|
479
|
+
note: '该接口在注册表里登记的已知坑(只在登记了 note 的接口上出现)。⚠️ 它是静态说明,不是本次请求的结果',
|
|
408
480
|
},
|
|
409
481
|
});
|
|
410
482
|
}
|
|
@@ -523,7 +595,7 @@ async function callOne(argv) {
|
|
|
523
595
|
// ⚠️ 这一句保持**字面量**:`readme.test.ts:58` 按源文本逐字钉着它(含 `<JSON>` 占位符,
|
|
524
596
|
// 渲染无法无参复现)。`command-tree.test.ts` 有一条断言把这里点名的 flag 与
|
|
525
597
|
// `CALL_FLAGS` 对齐,所以它不会与 spec 漂移。
|
|
526
|
-
return usageFail(`未知参数:${describeArgs(unknown)}。可用:--body <JSON>、--yes、--no-validate、--strict`);
|
|
598
|
+
return usageFail(`未知参数:${describeArgs(unknown)}。可用:--body <JSON>、--yes、--no-validate、--strict、--pretty`);
|
|
527
599
|
}
|
|
528
600
|
// ⚠️ **位置参数同样必须报错** —— 上面那条只筛 `-` 开头的。`api call` 除接口 id
|
|
529
601
|
// 外不接受任何位置参数,而此前它们被无声丢弃(实测 `call ticket.search extra`
|
|
@@ -647,6 +719,7 @@ async function callOne(argv) {
|
|
|
647
719
|
// 该接口的 note 恰恰逐字写明了这个坑,而它就在注册表里,只差没被读。
|
|
648
720
|
// 只给有 note 的接口输出(`api list` 已是这个口径),保持两处一致。
|
|
649
721
|
return ok(r.payload, {
|
|
722
|
+
field_notes: callFieldNotes(),
|
|
650
723
|
endpoint: spec.id,
|
|
651
724
|
...(warnings.length ? { warnings } : {}),
|
|
652
725
|
...(r.notFound ? { not_found: true, warning: '接口返回成功但无数据' } : {}),
|
|
@@ -731,14 +804,15 @@ function mapThrownToExit(e, spec) {
|
|
|
731
804
|
...(fallback !== undefined ? { fallback } : {}),
|
|
732
805
|
});
|
|
733
806
|
}
|
|
734
|
-
//
|
|
735
|
-
// ⚠️
|
|
736
|
-
//
|
|
737
|
-
//
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
807
|
+
// 用法错误走 `usageFail`(**唯一出口**,2026-11-02 收敛)。
|
|
808
|
+
// ⚠️ 这里曾是**手写的第三个出口**:自己净化、自己写 stderr、自己调 `fail()` ——
|
|
809
|
+
// 前两项与 `usageFail` 逐字重复(架构审查 F3 曾为此补过一次),第三项漏了它最重要的一条
|
|
810
|
+
// 契约:**用法错误永远是紧凑 JSON,即使 `--pretty` 已开启**(README「输出格式」/
|
|
811
|
+
// 设计稿 §11.2)。实测:`api call nosuchid --pretty` 与 `api call ticket.search --body '[]' --pretty`
|
|
812
|
+
// 都输出**缩进**的错误信封,而同一 exit 2 的 `api list extra --pretty`(走 usageFail)是紧凑的
|
|
813
|
+
// —— 同一退出码两种报文形态,而 Agent 会拿缩进当「格式化已生效」的证据。
|
|
814
|
+
// 那三条断言之所以没抓到:`tests/commands/api.test.ts` 只钉了走 `usageFail` 的那三条分支。
|
|
815
|
+
return usageFail(e instanceof Error ? e.message : String(e), err.hint);
|
|
742
816
|
}
|
|
743
817
|
/** 私有:`--no-validate` 与 `--strict` 同传 → 抛普通 Error(→ 退出码 2)。 */
|
|
744
818
|
export function assertNoValidateStrictConflict(argv) {
|
|
@@ -764,7 +838,7 @@ export function assertNoValidateStrictConflict(argv) {
|
|
|
764
838
|
export function assertGetHasNoBody(spec, body) {
|
|
765
839
|
if (spec.method === 'GET' && body !== undefined) {
|
|
766
840
|
throw new Error(`接口 ${spec.id} 是 GET 接口,不接受请求体 —— 去掉 --body。` +
|
|
767
|
-
'⚠️ 本 CLI
|
|
841
|
+
'⚠️ 本 CLI 目前没有 GET 的 query 参数通道(还没有可主动调用的 GET 接口),' +
|
|
768
842
|
'所以现在无法给它带任何参数;这道守卫是为了将来出现可调用 GET 时不静默丢弃 body');
|
|
769
843
|
}
|
|
770
844
|
}
|