@wkgeo/cli 1.1.5 → 2.0.1
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 +8 -0
- package/README.md +6 -43
- package/SKILL.md +4 -34
- package/lib/api.mjs +8 -26
- package/lib/args.mjs +5 -5
- package/lib/cms.mjs +0 -2
- package/lib/commands/auth.mjs +10 -18
- package/lib/commands/cms.mjs +66 -18
- package/lib/commands/index.mjs +15 -82
- package/lib/commands/member.mjs +936 -985
- package/lib/commands/site.mjs +388 -435
- package/lib/commands/siteops.mjs +438 -1013
- package/lib/commands/sites.mjs +4 -4
- package/lib/commands/template.mjs +1 -1
- package/lib/runtime.mjs +4 -4
- package/lib/template-publish.mjs +36 -78
- package/package.json +1 -1
- package/lib/commands/dnscred.mjs +0 -428
- package/lib/commands/domainops.mjs +0 -546
- package/lib/commands/domainorder.mjs +0 -439
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,14 @@
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
## 2.0.0 · 2026-11-19
|
|
8
|
+
|
|
9
|
+
- BREAKING: 移除全部域名相关命令(domain / esa / dns credential / site domain-recheck 共 30 条)
|
|
10
|
+
- 域名与解析相关操作请在会员中心 / CMS 后台进行
|
|
11
|
+
- CLI 聚焦 CMS 内容管理:站点 / 内容 / 素材 / 发布 / 模板 / 插件
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
7
15
|
## 1.1.5 · 2026-11-17
|
|
8
16
|
|
|
9
17
|
**`orders create` 改调账务域**(`/cli` 白名单转发 → `wkgeo-billing` 的 `orderCreate{kind:'quota'}`)。
|
package/README.md
CHANGED
|
@@ -461,7 +461,6 @@ wkgeo login --device-continue --json
|
|
|
461
461
|
| `member remove` | 把成员移出本站(**只删成员行**,账号与别的站不受影响;**默认 dry-run**) | `<用户ID>`、`--confirm`、`--site` |
|
|
462
462
|
| `site info` | 公司信息(字段定义 + 当前值 + 素材;首次读会幂等补建 `cms_field` 预设字段,与后台同行为) | `--site` |
|
|
463
463
|
| `site info save` | 存公司信息(只改给了的字段,`version` 自增;必填/格式校验与后台一致;**默认 dry-run**) | `--company-name`、`--site-title`、`--keywords`、`--description`、`--values <JSON>`、`--confirm`、`--site` |
|
|
464
|
-
| `site domain-recheck` | 提交域名重新检测(只置 `next_check_at=now()`,后台 worker 下一轮跑;可只重检一个域名;**默认 dry-run**) | `[域名]`、`--confirm`、`--site` |
|
|
465
464
|
| `site demo-seed` | 导入行业示例内容(栏目/文章/图片/标签;按 `path`、`(栏目,slug)` 幂等,重复导入不重复建;**默认 dry-run**) | `--demo`、`--template`、`--confirm`、`--site` |
|
|
466
465
|
| `site demo-clear` | 清空示例内容(只回收 `is_demo` / `demo/` 前缀,**客户自建内容一律不动**;**默认 dry-run**) | `--confirm`、`--site` |
|
|
467
466
|
| `site sync` | 站级同步(站点表合并后是 no-op,回 `skipped=merged-into-site`;**默认 dry-run**) | `--confirm`、`--site` |
|
|
@@ -484,13 +483,6 @@ wkgeo login --device-continue --json
|
|
|
484
483
|
| `overview dashboard` | 数据看板快照(每日 01:00 快照:存储、流量、费用、额度、下一次统计日期;非平台管理员看不到账号级流量与费用,会给 `account_restricted` 说明) | `--site` |
|
|
485
484
|
| `forms list` | 本站表单(字段、提交数、未读数) | `--site` |
|
|
486
485
|
| `forms entries` | 表单提交记录(**默认脱敏**:手机/邮箱/IP/浏览器标识) | `--form`、`--status new\|read`、`--keyword`、`--page`、`--page-size`、`--raw --confirm` |
|
|
487
|
-
| `domain inspection` | 域名巡检结果(只读;需「系统管理员」权限,403 给人话) | `--site`(多站账号必须带,等价 `x-cms-site`)、`--keyword`、`--status pending\|resolved\|verified\|failed\|timeout`、`--page`、`--page-size`、`--scope all` |
|
|
488
|
-
| `domain bind` | **绑自有域名**(原生动作 `cliProvisionSiteDomain`,免 OAuth 的 428 短信二次验证):成功只表示"受理开通",`provision_state` 一般是 `provisioning`,进度看 `domain status`。**平台侧通道没开时上游回 503** ⇒ 打印「域名开通通道暂不可用(平台侧未开),本次未写入,可直接重试」并 `exit 1`(**不假装成功**) | `<域名>`(必填)、`--site` |
|
|
489
|
-
| `domain status` | 域名开通状态(只读):`provision_state` / 步骤 / ESA / 证书 / 离线原因 / `last_error` / 尝试次数 / 客户待办(要加的 TXT、CNAME)/ 日志末 5 条 | `--site` |
|
|
490
|
-
| `domain records` | 已绑域名的解析记录与验证状态(只读):每域 TXT / CNAME / 证书 / ESA;没绑域名时给后端 `hint` | `--site` |
|
|
491
|
-
| `domain dns` | 把解析记录按「**客户自己去域名商加**」的格式打出来:主机记录(RR) / 类型 / 记录值(Value) / 状态(只读,**CLI 不加 DNS**) | `--site` |
|
|
492
|
-
| `domain check` | 域名可注册性(只读;一次 1~10 个,429 = 查太快被限流) | `<域名…>`(必填) |
|
|
493
|
-
| `domain remind` | 域名到期提醒(只读;需**平台管理员**,403 → `exit 3` 人话) | `--limit`(1~200,默认 50) |
|
|
494
486
|
| `preview` | 拼预览地址(`https://wkgeo.cn/cms/preview/<站点ID>/<路径>`,**零后端**) | `<路径>`、`--site`、`--open` |
|
|
495
487
|
| `import-v2 start` | 从老网站导入内容 v2(**默认 dry-run**;`--confirm` 才提交) | `--url`(必填)、`--confirm`、`--max-pages`、`--list-limit`、`--news-limit`、`--other-list-limit`、`--overwrite`、`--no-search` |
|
|
496
488
|
| `import-v2 status` | 看导入 v2 任务进度(只读) | `--run`(必填) |
|
|
@@ -556,23 +548,9 @@ wkgeo login --device-continue --json
|
|
|
556
548
|
* **短域要显式补**:平台 `listSites` 不返回 `prefix_host`,所以列表默认那列是 `-`;加 **`--with-prefix`** 会逐站调 `getSite` 补齐(`data.prefix_enriched = {requested,filled,failed}`,站点多时多打几次接口)。
|
|
557
549
|
* 要看**单站全字段**用 `wkgeo sites get <站点ID>`(人读版分块打印;`--json` 的 `data.detail` 是后端 `getSite` 原样字段,只剔除 `settings`/`theme`/`layout`/`info`/`template_config` 五个大 JSON 块)。
|
|
558
550
|
|
|
559
|
-
|
|
551
|
+
> **短域 KV 告警**:建站后端若回 `prefix_kv_written:false`,说明短域解析没写进 KV,**现在访问会 403/404**。`sites create` 只保证把结果说清楚(`--json` 里有 `prefixHost` / `url`),KV 是否写成功按 `wkgeo sites get <站点ID>` 的 `prefix_host` / `prefix_kv_written` 定位;确认短域打不开就联系管理员重写该站短域 KV,或重发建站。
|
|
560
552
|
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
| 命令 | 什么时候用 | 看什么 |
|
|
564
|
-
| --- | --- | --- |
|
|
565
|
-
| `wkgeo domain status` | 「我的域名怎么还没生效」 | `provision_state` / 步骤 / ESA / 证书 / 离线原因 / `last_error` / 尝试次数;有 `customer_todo` 就列出**要加哪些 TXT / CNAME** |
|
|
566
|
-
| `wkgeo domain records` | 想核对每条记录验没验过 | 每域 TXT / CNAME / 证书 / ESA + `verify_checked_at` / `next_check_at`;没绑域名时原样给后端 `hint` |
|
|
567
|
-
| `wkgeo domain dns` | 要**照着抄**去域名商加记录 | 只打 主机记录(RR) / 类型 / 记录值(Value) / 状态(已生效 / 未生效 / 未知) |
|
|
568
|
-
| `wkgeo domain check <域名…>` | 买域名前探一下 | `available` + `reason`(`self` / `taken` / `platform_owned` / `invalid`);一次 1~10 个 |
|
|
569
|
-
| `wkgeo domain remind` | 运营查哪些域名快到期 | 30 / 7 / 1 天档位;**需平台管理员**,否则 `exit 3` |
|
|
570
|
-
|
|
571
|
-
`--site` 等价 `x-cms-site`:账号下有多站时**必须带**,否则服务端可能报「需要指定站点」。
|
|
572
|
-
|
|
573
|
-
> **短域 KV 告警**:建站后端若回 `prefix_kv_written:false`,说明短域解析没写进 KV,**现在访问会 403/404**。`sites create` 只保证把结果说清楚(`--json` 里有 `prefixHost` / `url`),KV 是否写成功按 `wkgeo sites get <站点ID>` 的 `prefix_host` / `prefix_kv_written` 定位;**没有** `domain repair` 命令 —— 后端也没有等价的 OAuth 可调动作,确认短域打不开就重发建站。
|
|
574
|
-
|
|
575
|
-
### 令牌体检与绑域(`auth *` / `domain bind`,2026-10-28 新增)
|
|
553
|
+
### 令牌体检(`auth *`,2026-10-28 新增)
|
|
576
554
|
|
|
577
555
|
**令牌模型没有变**:CLI 用的就是 `wkgeo login` 拿到的 **OAuth access_token**(服务端只存 sha256 + 过期时间,TTL 30 天),**没有**"CLI 专用令牌"、也没有 `cli-token.json`。新增的三条 `auth` 命令只是把**已经有的东西**查清楚:
|
|
578
556
|
|
|
@@ -589,22 +567,13 @@ wkgeo auth revoke --local-only # 只删本地
|
|
|
589
567
|
| --- | --- |
|
|
590
568
|
| `action_total` | 后端 `cliWhoami` 报的合计(当前 **185** 条),**原样透出** |
|
|
591
569
|
| `native` / `self_hosted` / `forwarded` | 原生(按 scope 过滤后的 `actions`)/ 自持(进程内重建的各批次)/ 金融面白名单转 `wkgeo-order` |
|
|
592
|
-
| `batches` | 自持各批 + 转发各多少条(`user` / `
|
|
593
|
-
| `uncounted_self_hosted` | **不计入** `action_total`
|
|
594
|
-
| `consistent` | 明细加总(原生 + 自持 +
|
|
570
|
+
| `batches` | 自持各批 + 转发各多少条(`user` / `content` / `asset` / `publish` / `config_auth` / `site` / `finance_forwarded`) |
|
|
571
|
+
| `uncounted_self_hosted` | **不计入** `action_total` 的那批(域名面已删,当前恒为 `0`;字段保留,老脚本读它不会拿到 `undefined`) |
|
|
572
|
+
| `consistent` | 明细加总(原生 + 自持 + 转发)与 `action_total` 是否对得上;对不上时标 `false`(服务端刚改动作表就会出现) |
|
|
595
573
|
| `action_lists` | 各批动作数组**原样**(agent 可直接按清单挑动作,不截断、不重排) |
|
|
596
574
|
|
|
597
575
|
`auth status --json` 里还有 `fn:"wkgeo-cli-fc"` / `via`(确认"到底打没打到自己的函数")、`token_ttl_hint`,以及 `whoami` 原始返回。
|
|
598
576
|
|
|
599
|
-
**绑自有域名**:`wkgeo domain bind <域名> --site <站点ID>`
|
|
600
|
-
|
|
601
|
-
* 后端动作是**原生 `cliProvisionSiteDomain`**(`wkgeo-cli-fc` 接,代执行 `wkgeo-domain` 的内部开通编排),不受 OAuth 「绑域要短信二次验证」的限制。
|
|
602
|
-
* 成功只是**受理**:`provision_state` 通常是 `provisioning`,看进度用 `wkgeo domain status`,要客户去域名商加的解析用 `wkgeo domain dns`。
|
|
603
|
-
* **通道依赖**:内部通道由部署侧 `DOMAIN_INTERNAL_CHANNEL_ENABLED` 控制,**当前线上仍是 `false`** ⇒ 上游回 503,CLI 打印
|
|
604
|
-
「域名开通通道暂不可用(平台侧未开),本次未写入,可直接重试」并 `exit 1`(**本次没有写入任何东西,平台开通后直接重跑同一条命令**)。
|
|
605
|
-
* 平台自有域名(`wkgeo.com` 等)→ 403 `platform_owned_domain`(`exit 3`);站点已绑了**别的**域名 → 409(换域要先去会员中心解绑,短信二次验证,CLI 不支持)。
|
|
606
|
-
* **没有** `domain unbind` / `domain repair`:`/cli` 的动作面里没有等价动作(解绑只有 `releaseSiteDomain`,OAuth 下照样 428)。**"重试开通"就是再跑一次 `domain bind`**(后端幂等,同站同域重复调用会复用记录、不重置状态)。
|
|
607
|
-
|
|
608
577
|
### 抓整站:`wkgeo crawl`(2026-11-01 · task-84)
|
|
609
578
|
|
|
610
579
|
**一句话**:抓老站别再「一页一次模型往返」——`crawl` 是代码并发(默认 6、上限 10)、**零模型调用**,
|
|
@@ -963,8 +932,6 @@ wkgeo context export --format md --out .\site-context.md
|
|
|
963
932
|
| `publish`:任务终态是 `failed` / `partial` | `publish_failed` | 1 | 看输出的 `pages_failed` 与 `errors`(每条的 `path` + `message`);修完再 `publish --confirm`,后端是幂等的 |
|
|
964
933
|
| `publish`:等太久没到终态 | `publish_timeout` | 1 | 加 `--wait-timeout`,或先 `publish status` 看进度(发布本身还在跑);连不上就别重复发,后端有活跃任务会直接复用 |
|
|
965
934
|
| `forms`:`/form` 只认后台登录态 | `form_backend_gap` | 3 | **后端缺口**(插件函数还没接 Bearer 桥),文档见 §9.15;暂时用网页后台看表单提交 |
|
|
966
|
-
| `domain inspection`:403 | `domain_inspection_forbidden` | 3 | 需要「系统管理」权限 + 平台管理员或站点系统管理员;普通账号只能找管理员看 |
|
|
967
|
-
| `domain remind`:403 | `domain_remind_forbidden` | 3 | 只有**平台管理员**能查全平台域名到期提醒;让平台管理员跑,或到超管后台看 |
|
|
968
935
|
| `ai`:连不上本机模型 | `ai_unreachable` | 1 | `ollama serve` 起了吗?端口对不对(Ollama 11434 / LM Studio 1234)?`wkgeo ai ping` 先探一下 |
|
|
969
936
|
| `ai`:模型不存在 | `ai_not_found` | 1 | `ollama list` 看有哪些,然后 `--model` 指定,或 `ollama pull qwen2.5:7b` |
|
|
970
937
|
| `ai`:上下文超限 | `ai_context_too_long` | 1 | 缩 `--context`(少取几个域),或换长上下文模型;`maxContextChars` 也可调 |
|
|
@@ -1172,11 +1139,7 @@ node aliyun/fc/_tests/oauth-device-live-e2e.js # 结束按 su
|
|
|
1172
1139
|
| 13 | **CMS 写操作 / 导入没有真接口验证** | 只读命令已真跑;**写操作**(建栏目/发内容/传素材/存模板)与**导入**没有真跑(会改数据/需数据库凭证)。它们由 66 条离线单测覆盖,**不声称已端到端验证** | 需要时人工验收(写库前先 `site use` 选对站) |
|
|
1173
1140
|
| 13b | **旧令牌缺 CMS scope** | 2026-10-18 之前授权的令牌只有 `site:read/site:write/billing:self` ⇒ `templates list` / `assets list` 报 `cms_scope`(403)。**重新 `wkgeo login` 即可**(默认 scope 与客户端 `allowed_scopes` 都已补齐) | 用户侧一次重新授权 |
|
|
1174
1141
|
| 14 | **`import` 走本机运维脚本** | 后端**没有**带鉴权的 HTTP 导入入口,CLI 调用本仓库的 `tencent/cloudbase/import-site.mjs`(`service_role` 直连库,需运维权限)。命令默认 dry-run、只增不毁;客户/AI 端不应当用它 | 后端补 HTTP 导入动作(`docs/规划-CLI与AI建站.md` §5.2) |
|
|
1175
|
-
| 15 |
|
|
1176
|
-
| 16 | **`domain bind` 的平台通道仍关着** | `wkgeo-cli-fc` 把绑域代执行交给 `wkgeo-domain` 的内部通道,线上 `DOMAIN_INTERNAL_CHANNEL_ENABLED` **目前是 false** ⇒ 上游回 503,CLI 打印「域名开通通道暂不可用(平台侧未开),本次未写入,可直接重试」并 `exit 1`。**CLI 侧没有假装成功的分支**;通道一开,同一条命令直接可用(`domain bind` 幂等) | 部署侧开开关(权限复核后) |
|
|
1177
|
-
| 17 | **没有 `domain unbind` / `domain repair`** | `/cli` 动作面里**没有**等价动作:解绑只有 `releaseSiteDomain`(OAuth 下 428 短信二次验证,未收录);`retrySiteProvision` 的语义是"重跑一次开通"而不是"修复",**不另造命令**。等价做法:重试 = 再跑 `domain bind`(幂等);解绑 = 会员中心 →「我的授权/我的站点」自助解绑(短信二次验证) | 后端补 unbind 动作 + 权限模型 |
|
|
1178
|
-
| 18 | **客户域自动写 DNS / 证书 / 备案** | CLI **不写** DNS(只打印要客户自己加的 TXT / CNAME 清单,见 `domain dns`);证书与 ESA 编排都在 `wkgeo-domain` 侧,CLI 只观察(`domain status` 的 `cert_status` / `esa_status`);**备案**不在 CLI 能力范围(国内加速需要客户自行备案,平台侧校验) | 平台侧;CLI 只读 |
|
|
1179
|
-
| 19 | **平台自有域策略** | `wkgeo.com` / `wkgeo.com.cn` 等平台自有域名,CLI 绑域一律 403 `platform_owned_domain`(`exit 3`)——只有超管后台能配,CLI **故意不提供**绕过入口 | 产品策略(已定) |
|
|
1142
|
+
| 15 | **静态发布** | ✅ **0.5.0 起可用了**:`publish` 走 `cmsSitePublishStart` → 轮询 `cmsSitePublishStatus`(`summary` 里有 `pagesFailed` / `finalizeOk`),`--cancel` / `publish cancel` 可中止。⚠️ 仍需服务端配 `INNER_PUBLISH_SECRET`,未配时后端 fail-closed 回 503(CLI 会原样报出来) | 后端(配 `INNER_PUBLISH_SECRET`) |
|
|
1180
1143
|
| 20 | **站点备注(`sites update --remark`)发不通** | 服务端 `updateSite` 的字段白名单是 `name / template_id / status / settings / domain / domains / expires_at / asset_storage_mode`,**没有 `remark`**;`public.site` 表里也没有这一列(`remark` 只出现在 `wallet_txn` / `user_debt` / `invoice_request` / `site_quota_purchase` 等别的表)。白名单外的 key 会被**静默忽略** ⇒ CLI 传了也是假成功,所以 `sites update --remark` **直接报缺口**(`kind:"unsupported"`、`exit 1`、一个请求都不发)。也**没有**用 `settings.remark` 变通:`settings` 是整块覆盖,读-改-写会吞掉原有设置 | 后端加列 + 加白名单(另开任务) |
|
|
1181
1144
|
| 21 | **`purgeSite`(彻底删站)刻意没有 CLI 命令** | 服务端只允许 `role==='owner'` 调,非 owner 会回「彻底删除只能由管理员操作;你可以把它还原回站点列表」。CLI 只给**可逆**的 `sites delete`(进回收站)与 `sites recycle restore`,不给不可逆入口 | 产品策略(已定) |
|
|
1182
1145
|
| 22 | **开票 / 取消开票 / 优惠券核销不做** | 开票要填抬头、税号、收件信息,交互式拼字段易错且难撤销;券核销发生在下单接口内部(用 CLI 传的金额去核销等于绕过服务端的重算)。CLI 只做**只读**的 `invoices list` 与 `coupons [--usable]`,写动作留在会员端 | 有意为之 |
|
package/SKILL.md
CHANGED
|
@@ -41,7 +41,7 @@ version: 1.0.0
|
|
|
41
41
|
* 用户说"**我授权过哪些应用**"/"取消某个应用的授权" → `apps list` / `apps revoke`
|
|
42
42
|
* 需要确认"现在是谁在操作" → `whoami`
|
|
43
43
|
* 用户问"**这个令牌能干什么 / 还剩多久 / 怎么立刻作废**" → `auth status`(账号 + scopes + 动作面)/ `auth token`(只给前 4 位 + 长度 + 到期)/ `auth revoke`(服务端吊销 + 删本地)
|
|
44
|
-
* 用户说"**帮我绑自己的域名**" →
|
|
44
|
+
* 用户说"**帮我绑自己的域名**" → CLI **没有**域名能力(域名命令已全部删除);引导到会员中心 / CMS 后台的「域名」里操作,**不要**自己编一条域名命令
|
|
45
45
|
* **你自己需要这份手册**(换机器、上下文被截断、想确认某个参数)→ `skill`(把本文件原文打出来,见 §2)
|
|
46
46
|
|
|
47
47
|
**不要用**:
|
|
@@ -153,7 +153,6 @@ npx -y @wkgeo/cli@latest skill > SKILL.md # 直接落一份到本地,离线
|
|
|
153
153
|
| `apps revoke` | 一键吊销某应用授权(令牌立即失效) | `<client_id>` |
|
|
154
154
|
| `site use` | **选中要操作的站点**(存本地,之后的 CMS 命令默认用它;不带参数 = 看当前) | `<站点ID或域名>`、`--clear` |
|
|
155
155
|
| `site create` | 建站 + 自持收口(池位 / 短域 / host KV 回读确认;**默认 dry-run**,`--confirm` 才真建) | `--name`、`--pool`、`--confirm` |
|
|
156
|
-
| `esa site` / `esa record` / `esa hostname` / `esa kv` | 确认池位对应 ESA 站点就绪(只读,**不开新站——开站花钱**)/ 建改 S3 回源记录(同值幂等,记录名必须单标签子域)/ 接 CustomHostname + 申请免费证书(幂等;**100 次/小时限流,别重试**)/ 把域名写进边缘路由 KV(`host:<域名>` → 站点目录,写后 GetKv 回读) | `--site`、`--hostname`、`--record`、`--value` |
|
|
157
156
|
| `categories list/get/create/update/delete` | 栏目:列表 / 详情 / 新建 / 改 / 删 | 见 §7.5 |
|
|
158
157
|
| `categories bind-template` | 给栏目绑定模板 html(`--clear` 解绑) | `<栏目>` `<模板文件>`、`--clear` |
|
|
159
158
|
| `contents list/get/create/update/delete` | 内容:列表 / 详情 / 新建 / 改 / 删 | 见 §7.5 |
|
|
@@ -174,7 +173,6 @@ npx -y @wkgeo/cli@latest skill > SKILL.md # 直接落一份到本地,离线
|
|
|
174
173
|
| `role list` / `role save` / `role delete` | 站点角色:列表(含权限明细)/ 保存(**改角色必须带 `--permissions`**,否则会清空)/ 删(预置角色 403、有成员在用 409)。**写要 `role:write`**,不许造带「系统管理」权限的角色 | `[角色ID]`、`--name`、`--description`、`--permissions`(JSON 或 `content=view,edit`)、`--confirm`、`--site` |
|
|
175
174
|
| `member list` / `member update` / `member remove` | 站点成员:列表(**手机号恒为掩码** `138****8000`)/ 改角色(不能动业主·不能改自己)/ 移出本站(只删成员行,账号还在);**写默认 dry-run** | `<用户ID>`、`--role`、`--confirm`、`--site` |
|
|
176
175
|
| `site info` / `site info save` | 公司信息:读(字段定义 + 当前值 + 素材;**首次读会幂等补建预设字段**,与后台同行为)/ 存(只改给了的字段,`version` 自增,必填与格式校验同后台);读要 `site:read`、写要 `site:write`;**写默认 dry-run** | `--company-name`、`--site-title`、`--keywords`、`--description`、`--values <JSON>`、`--confirm`、`--site` |
|
|
177
|
-
| `site domain-recheck` | 提交域名重新检测(只置 `next_check_at=now()`,后台 worker 下一轮跑),可只重检一个域名;**默认 dry-run** | `[域名]`、`--confirm`、`--site` |
|
|
178
176
|
| `site demo-seed` / `site demo-clear` | 示例内容:导入行业示例(栏目/文章/图片/标签,按 `path` 与「栏目+slug」幂等,重复导入不重复建)/ 清空示例(**只回收 `is_demo` 与 `demo/` 前缀,客户自建内容一律不动**);**默认 dry-run** | `--demo`、`--template`、`--confirm`、`--site` |
|
|
179
177
|
| `site sync` | 站级同步:站点表合并后是 **no-op**(回 `skipped=merged-into-site`),留着只为兼容老脚本;**默认 dry-run** | `--confirm`、`--site` |
|
|
180
178
|
| `plugins list` / `plugins access` | 本站插件清单(启用/装过/分类/**模板锁**,`editor` 单选互斥会提示「已停用:xxx」)/ 插件按角色·成员的访问范围(`plugin_access`;迁移没跑时 `available:false`,按全站可见理解);读要 `site:read` | `--site`、`--key`(access 可选,给就只查这一个) |
|
|
@@ -189,20 +187,6 @@ npx -y @wkgeo/cli@latest skill > SKILL.md # 直接落一份到本地,离线
|
|
|
189
187
|
| `overview traffic` | 账号级流量与费用(**只给平台管理员**,其他人 403;1 小时缓存,`--refresh` 强制重取) | `--refresh`、`--site` |
|
|
190
188
|
| `overview dashboard` | 数据看板快照(存储 / 流量 / 费用 / 额度 / 下次统计日期;非平台管理员看不到账号级流量费用,给 `account_restricted` + 说明) | `--site` |
|
|
191
189
|
| `forms list` / `forms entries` | 表单清单 / 提交记录(**默认脱敏**手机·邮箱·IP·UA) | `--site`、`--form`、`--status`、`--keyword`、`--page`、`--page-size`、`--raw --confirm` |
|
|
192
|
-
| `domain inspection` | 域名巡检(只读;需系统管理员,403 给人话) | `--site`(多站必须带)、`--keyword`、`--status`、`--page`、`--page-size`、`--scope all` |
|
|
193
|
-
| `domain bind` | **绑自有域名**(原生 `cliProvisionSiteDomain`):成功=受理开通(`provision_state` 多为 `provisioning`,进度看 `domain status`)。**平台通道没开时上游 503** ⇒ 「域名开通通道暂不可用(平台侧未开),本次未写入,可直接重试」+ `exit 1`(**不假装成功**) | `<域名>`(必填)、`--site` |
|
|
194
|
-
| `domain status` / `domain records` | 域名开通状态(含客户待办 TXT/CNAME)/ 每域解析与验证状态(只读) | `--site` |
|
|
195
|
-
| `domain dns` | 把要**客户自己去加**的解析打成 RR / Type / Value / 状态(只读,**CLI 不加 DNS**) | `--site` |
|
|
196
|
-
| `domain check` | 域名可注册性(只读;1~10 个,429=被限流) | `<域名…>`(必填) |
|
|
197
|
-
| `domain remind` | 域名到期提醒(只读;**需平台管理员**,403 → exit 3) | `--limit`(1~200,默认 50) |
|
|
198
|
-
| `domain search` | 查域名能不能注册 + **真实报价**(阿里云 CheckDomain,走自持 fc;只读,不下单) | `<域名…>` |
|
|
199
|
-
| `domain buy` | 买域名(**默认 dry-run**:校验 + 报价 + 余额预检;真下单要 `--confirm`) | `<域名>`、`--confirm`、`--years`、`--template` |
|
|
200
|
-
| `domain order` / `domain order create` / `domain order status` | 查注册任务状态或某域归属与到期 / 买域名并建单(**默认 dry-run**:预检 + 建单,不提交注册、不花钱)/ 看订单走到哪一步(各步时间戳 + 阿里云订单/任务号) | `<订单ID>`、`--confirm` |
|
|
201
|
-
| `domain charge` | 扣费(自持钱包,**幂等**:同一单重复调用不会重复扣) | `<订单ID>`、`--confirm` |
|
|
202
|
-
| `domain template create` / `domain template status` | 建客户实名模板(只要一张营业执照)+ 提交实名审核 / 查模板审核 + 域名侧实名(两份状态分开看) | `--name`、`--license`、`<模板ID>` |
|
|
203
|
-
| `domain transfer` | 快速过户(按客户模板 ID 改持有者信息,不收集资料、不走人工流) | `<域名>`、`--template`、`--confirm` |
|
|
204
|
-
| `domain zone list` / `domain zone add` / `domain zone update` / `domain zone delete` | **真实解析**(自持 alidns,不是"照抄表"):列出 / 加一条(写后自动回读确认,同值幂等)/ 按 RecordId 全量覆盖 / 删一条(**必须 `--yes`**,重复删幂等) | `<域名>`、`--rr`、`--type`、`--value`、`--record-id`、`--yes` |
|
|
205
|
-
| `domain dns credential detect` / `set` / `status` / `delete` | **域名级 DNS 凭据**:只看 NS 判断托管在哪家 / 配 AK(**先调 API 验证通过才落库**,secret 只从 stdin/交互读)/ 看状态(**永不回传 secret**)/ 删(必须 `--yes`,删后解析降级人工兜底) | `<域名>`、`--provider`、`--yes` |
|
|
206
190
|
| `preview` | 拼预览地址(零后端,不写任何东西) | `<路径>`、`--site`、`--open` |
|
|
207
191
|
| `import-v2 start` / `import-v2 status` | 老站导入 v2(默认 dry-run;`--confirm` 才提交)/ 看进度 | `--url`(必填)、`--confirm`、`--max-pages`、… / `--run`(必填) |
|
|
208
192
|
| `ai ping` / `ai ask` / `ai chat` | **接本机大模型**:探端点 / 单问(CLI 取数+脱敏)/ 多轮 | `--context`、`--site`、`--model`、`--base-url`;`ai ask` 需 `<问题>` |
|
|
@@ -297,12 +281,6 @@ wkgeo data usage --model deepseek-flash --out usage.csv
|
|
|
297
281
|
* 人类终端里"回车=上次";从没选过时回车=第 1 个(提示里会写明)。
|
|
298
282
|
* **短域默认不显示**(平台 `listSites` 不返回 `prefix_host`):加 `--with-prefix` 逐站补(多发几次 `getSite`,
|
|
299
283
|
回包 `data.prefix_enriched = {requested,filled,failed}`);要看单站全字段用 `sites get <站点ID>`。
|
|
300
|
-
* **域名链路只读命令**(2026-10-28 起):`domain status`(开通状态 + 客户待办 TXT/CNAME)、
|
|
301
|
-
`domain records`(每域解析与验证状态)、`domain dns`(把要客户**自己去加**的记录打成 RR/Type/Value/状态)、
|
|
302
|
-
`domain check <域名…>`(可注册性,1~10 个)、`domain remind`(到期提醒,**需平台管理员**)。
|
|
303
|
-
账号下多站时这些命令都要带 `--site <站点ID>`(等价 `x-cms-site`)。
|
|
304
|
-
**`domain bind` 已实现**(= 受理开通,进度看 `domain status`);**`domain unbind` / `domain repair` 仍未实现**(`releaseSiteDomain` 在 OAuth 下仍是 428 短信二次验证,不造命令 —— 解绑去会员中心,重试开通 = 再跑一次 `domain bind`,幂等)。
|
|
305
|
-
解析**能写**:`domain zone add|update|delete`(自持 alidns,写后回读确认);但 `domain dns` 那份清单仍按「要客户自己去域名商加」的格式输出。
|
|
306
284
|
|
|
307
285
|
### 4.1.5 抓整站:`crawl`(2026-11-01 · task-84)
|
|
308
286
|
|
|
@@ -334,7 +312,7 @@ node scripts/e2e-site.mjs --dry-run # 干跑:只校验参数
|
|
|
334
312
|
node scripts/e2e-site.mjs --confirm --pool global --keep # 真建站(写一条真站点)
|
|
335
313
|
```
|
|
336
314
|
|
|
337
|
-
* 链路:建站(指定池)→ `getSite` 校验 `prefix_host` / `prefix_kv_written` / `provision_state`
|
|
315
|
+
* 链路:建站(指定池)→ `getSite` 校验 `prefix_host` / `prefix_kv_written` / `provision_state` →(可选)绑自有域名(`cliProvisionSiteDomain`)
|
|
338
316
|
→ `publish --confirm` 并轮询 job → 轮询短域首页 HTTP 200 + 内容指纹(sha256 + 长度)→ 绑域成功再轮询客户域 → 结果表 / `--json`。
|
|
339
317
|
* ⚠️ **默认不删站**(脚本不提供删除);真建站必须显式 `--confirm`,`--dry-run` 零写入。
|
|
340
318
|
|
|
@@ -716,8 +694,6 @@ Set-Content -LiteralPath "$env:USERPROFILE\.dsh\browser-open.txt" -Value "<完
|
|
|
716
694
|
| `import_failed` | 导入脚本非 0 退出 | 念 `hint` 与日志尾巴;dry-run 失败不动库,可安全重试 |
|
|
717
695
|
| `missing_skill` | `skill` 在本包里找不到 `SKILL.md`(包被裁剪/只拷了 `lib/`) | 换官方包 `npx -y @wkgeo/cli@latest skill`;**不是**命令用错了,别让用户去排查 |
|
|
718
696
|
| `server` / `5xx` | 服务端错误 | 保留原文告知用户,可稍后重试 |
|
|
719
|
-
| `domain_inspection_forbidden` / `domain_remind_forbidden`(exit 3) | 域名巡检要「系统管理员」、到期提醒要**平台管理员** | 如实说权限不够,让对应管理员跑;**不要**换成用户自己的令牌反复试 |
|
|
720
|
-
| `rate_limited` / 429(`domain check`) | 查域名**限流 30 次/分** | 等 `retry_after` 秒;一次最多 10 个域名 |
|
|
721
697
|
| `network` | 连不上/超时 | 检查网络后重试;`message` 里是原始错误(如 `getaddrinfo ENOTFOUND`) |
|
|
722
698
|
|
|
723
699
|
**通用规则**:先看 `error.hint` —— 那是 CLI 写好的"下一步";`message` 是服务端原文,
|
|
@@ -1013,15 +989,9 @@ npx -y @wkgeo/cli@latest context export --format md --out ./site-context.md --si
|
|
|
1013
989
|
| `sites create` 报 400 参数错误 | 客户层已删,归属无需指定;400 只剩参数问题(名称/区域等) | 按错误提示补参数 |
|
|
1014
990
|
| `sites create` 报 409「该区域名额已满(系统正在自动扩容)」 | 该区域池位满(`POOL_EXHAUSTED`);服务端可能已先插了一行 draft 再失败 | 换区再建:`--region overseas` 或 `--region global`;别原地重试同一区 |
|
|
1015
991
|
| `sites create --template` 报「模板市场里没有…」exit 2 | `--template` 只认模板市场已有 key(内置如 `classic-blue` 默认模板 / `warm-amber`) | 按报错 hint 里的现有 key 重填;不想装模板就去掉 `--template`(空站) |
|
|
1016
|
-
| 短域访问 403/404 且 `sites get` 里 `prefix_kv_written:false` | 短域没写进 KV
|
|
1017
|
-
| `domain bind` 回 exit 1 +「域名开通通道暂不可用(平台侧未开),本次未写入,可直接重试」 | 上游 `wkgeo-domain` 的内部通道没开(部署侧 `DOMAIN_INTERNAL_CHANNEL_ENABLED=false`)⇒ 服务端 503 | **如实说"没绑上、没写入"**,别当成成功;平台开通后**直接重跑同一条命令**(`domain bind` 幂等),也可以先用 `domain status` 看现状 |
|
|
1018
|
-
| `domain bind` 回 `platform_owned_domain`(exit 3) | 想绑平台自有域名(`wkgeo.com` 等) | 换用户自己的域名;平台自有域只有超管后台能配,别找绕过 |
|
|
1019
|
-
| `domain bind` 回 `domain_already_bound`(exit 1) | 站点已绑了**别的**域名 | 换域要先去会员中心解绑(短信二次验证,CLI 不支持);不要反复重试 bind |
|
|
1020
|
-
| 用户问「怎么解绑域名 / 怎么修复解析」 | `/cli` 动作面**没有** unbind / repair:解绑只有 `releaseSiteDomain`(OAuth 下 428 短信二次验证)、`retrySiteProvision` 语义是"重跑开通" | 解绑 → 引导去会员中心;重试开通 → 再跑一次 `domain bind`(幂等);查现状 → `domain status` / `domain records` / `domain dns` |
|
|
992
|
+
| 短域访问 403/404 且 `sites get` 里 `prefix_kv_written:false` | 短域没写进 KV(CLI 没有修复能力) | **别撒谎说"能访问"**:如实告诉用户短域暂不可用,用 `sites get <站点ID>` 复核 `prefix_host` / `prefix_kv_written`;`null` = 旧接口没回这个字段,让用户直接打开短域试 |
|
|
1021
993
|
| `auth status` 的 `data.action_surface.consistent:false` | 后端 `action_total` 与明细加总对不上(服务端刚改过动作表) | 以 `data.action_lists` 明细为准,把差异报给服务端;**不要**据此说"能力丢了" |
|
|
1022
|
-
|
|
|
1023
|
-
| `domain check` 回 429 / `retry_after` | 查域名限流 30 次/分 | 等 `retry_after` 秒再查;一次最多 10 个域名 |
|
|
1024
|
-
| 用户问「域名怎么还不生效 / 要加什么解析」 | 需要看开通状态与记录 | 依次 `domain status`(状态 + 客户待办)→ `domain dns`(RR/Type/Value 照抄给用户,**CLI 不会替他加**)→ 加完再 `domain status` 复核 |
|
|
994
|
+
| 用户问「域名怎么还不生效 / 要加什么解析 / 怎么解绑」 | 域名相关操作**不在 CLI**(2026-11-19 task-1254 起全部域名命令已删除) | 引导到会员中心 / CMS 后台的「域名」里操作;**不要**凭空编一条域名命令出来 |
|
|
1025
995
|
| CMS 命令报 `cms_auth`(401) | 令牌失效(过期/吊销/客户端停用);旧部署才可能是"没启用 CLI 认证桥" | 先 `wkgeo login` 重新授权一次;仍 401 再让管理员确认服务是否为新版(**别**反复 login) |
|
|
1026
996
|
| CMS 命令报 `cms_site_required` | 账号有多个站点、没指定 | `wkgeo site use <站点ID>` 或加 `--site <站点ID>` |
|
|
1027
997
|
| `--site` 写了域名没生效 | 后端只按**站点 id** 查,域名会被当成"没指定" | 先 `wkgeo site use <域名>` 解析成 id(CLI 已在本地挡住这种写法) |
|
package/lib/api.mjs
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
*
|
|
7
7
|
* ⚠️ 2026-10-28(老板拍板「所有 cli 的操作都通过自己的云函数来实现」):业务面**收敛到 `/cli`**
|
|
8
8
|
* (云函数 `wkgeo-cli-fc`)—— 站点 / 域名 / 模板 / 发布 / 资产 / 钱包 / 套餐 / 应用授权
|
|
9
|
-
* 这些动作在 `wkgeo-cli-fc` 里**自持重建**(进程内副本),金融面
|
|
9
|
+
* 这些动作在 `wkgeo-cli-fc` 里**自持重建**(进程内副本),金融面 13 条由它**白名单转发**给
|
|
10
10
|
* `wkgeo-order`。CLI 侧不再需要「action → 哪个函数」那套路由表猜谜。
|
|
11
11
|
* · 默认:`data()` 一律打 `/cli`;只有**插件面**动作按 `GATEWAY_PREFIXES` 打各自前缀
|
|
12
12
|
* (`/form` `/member` `/channel`;`/ai` `/ai-tools` 仅显式 `prefix:` 时用)。
|
|
@@ -26,7 +26,7 @@ import { request, encodeForm } from './http.mjs';
|
|
|
26
26
|
import { classifyResponse, toCliError, networkError, CliError } from './errors.mjs';
|
|
27
27
|
|
|
28
28
|
/**
|
|
29
|
-
* 金融面动作(`wkgeo-order`
|
|
29
|
+
* 金融面动作(`FN_ORDER` 13 条;`wkgeo-order` 现 dispatch 20 个动作)—— 2026-10-28 起**不再由 CLI 直接寻址**,
|
|
30
30
|
* 而是 `wkgeo-cli-fc` 用白名单转发(`ORDER_FORWARD_ACTIONS`)。
|
|
31
31
|
*
|
|
32
32
|
* 这张表留在 CLI 侧只做两件事:
|
|
@@ -35,7 +35,8 @@ import { classifyResponse, toCliError, networkError, CliError } from './errors.m
|
|
|
35
35
|
*
|
|
36
36
|
* 为什么当初要把这份表搬到 CLI:CLI 以前统一打 `/api/data`,靠 data 内部转发;
|
|
37
37
|
* data 下线后必须自己决定打哪个函数。**只列 order / domain 的例外,其余一律 user**
|
|
38
|
-
* ——
|
|
38
|
+
* —— 逃生阀口径:`FN_ORDER` 13 条打 `/order`、`FN_DOMAIN` 9 条打 `/domain`、其余打 `/user`
|
|
39
|
+
* (data 当年那份 47 条映射已随 data 下线,不再是真源)。
|
|
39
40
|
*
|
|
40
41
|
* ⚠️ 加新 action 时:先确认它属于哪个函数,不在这两个集合里就当 user(user 会回"未知操作",与以前 data 的行为一致)。
|
|
41
42
|
*
|
|
@@ -48,7 +49,6 @@ const FN_ORDER = new Set([
|
|
|
48
49
|
'createRechargeTicket',
|
|
49
50
|
'createRechargeOrderByTicket',
|
|
50
51
|
'getRechargeTicketInfo',
|
|
51
|
-
'createSubscriptionOrder',
|
|
52
52
|
'createQuotaOrder',
|
|
53
53
|
'createSiteRenewOrder',
|
|
54
54
|
'userQuoteBundle',
|
|
@@ -60,26 +60,9 @@ const FN_ORDER = new Set([
|
|
|
60
60
|
'paymentNotify',
|
|
61
61
|
]);
|
|
62
62
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
* ⚠️ 这张表**漏一条,动作就会被发到 `/user`**,服务端回 `未知操作: <action>`,
|
|
67
|
-
* CLI 看起来像"后端没实现",其实是本地路由错(2026-10-28 task-9 / A7 踩过:
|
|
68
|
-
* `getSiteDomainReminders` 怎么调都 400)。加域名前先核对 domain 函数的 dispatch,
|
|
69
|
-
* 不要凭印象编。
|
|
70
|
-
*/
|
|
71
|
-
const FN_DOMAIN = new Set([
|
|
72
|
-
'provisionSiteDomain',
|
|
73
|
-
'checkSiteProvision',
|
|
74
|
-
'retrySiteProvision',
|
|
75
|
-
'releaseSiteDomain',
|
|
76
|
-
// 2026-10-28 task-9 / A7 补:只读查询类(dispatch 见 wkgeo-domain/src/index.js:1211-1259)
|
|
77
|
-
'getSiteProvisionStatus',
|
|
78
|
-
'siteDomainRecords',
|
|
79
|
-
'siteDomainCheck',
|
|
80
|
-
'getSiteDomainReminders',
|
|
81
|
-
'dnsProviderProbe',
|
|
82
|
-
]);
|
|
63
|
+
/* ★ 2026-11-19 task-1250(老板:CLI 只做 CMS 内容管理,跟域名没有关系):
|
|
64
|
+
原 `FN_DOMAIN`(`wkgeo-domain` 的 9 条动作 → 前缀 `/domain`)已整张删除 ——
|
|
65
|
+
CLI 不再有任何域名动作,逃生阀 `WKONGAI_LEGACY_ENDPOINTS=1` 也回不到 `/domain`。 */
|
|
83
66
|
|
|
84
67
|
/**
|
|
85
68
|
* 表单插件(`plug/contact-form/fn/src/index.js`)的后台动作 —— 前缀 `/form`。
|
|
@@ -159,7 +142,7 @@ export function legacyEndpointsEnabled(env = process.env) {
|
|
|
159
142
|
* 一律 `cli` —— `wkgeo-cli-fc` 自己分发;不认识的动作由它回 `400 未知动作`。
|
|
160
143
|
*
|
|
161
144
|
* 逃生阀 `WKONGAI_LEGACY_ENDPOINTS=1` 时退回老口径:
|
|
162
|
-
* order /
|
|
145
|
+
* order / form / member / channel 按显式表,其余 `user`(`/domain` 已随 task-1250 删除)。
|
|
163
146
|
*/
|
|
164
147
|
export function fnOf(action, { legacy = legacyEndpointsEnabled() } = {}) {
|
|
165
148
|
if (FN_FORM.has(action)) return 'form';
|
|
@@ -172,7 +155,6 @@ export function fnOf(action, { legacy = legacyEndpointsEnabled() } = {}) {
|
|
|
172
155
|
if (action === 'orderCreate') return 'cli';
|
|
173
156
|
if (legacy) {
|
|
174
157
|
if (FN_ORDER.has(action)) return 'order';
|
|
175
|
-
if (FN_DOMAIN.has(action)) return 'domain';
|
|
176
158
|
return 'user';
|
|
177
159
|
}
|
|
178
160
|
return 'cli';
|
package/lib/args.mjs
CHANGED
|
@@ -162,7 +162,7 @@ export function coerceFlags(spec, flags) {
|
|
|
162
162
|
/**
|
|
163
163
|
* 位置参数校验:按顺序、必填在前。
|
|
164
164
|
*
|
|
165
|
-
* 最后一个 arg 可标 `variadic: true`(如
|
|
165
|
+
* 最后一个 arg 可标 `variadic: true`(如 `<文件…>`):
|
|
166
166
|
* 它会把剩下的位置参数全部收进一个**数组**,不再报「参数过多」。
|
|
167
167
|
*/
|
|
168
168
|
export function checkPositionals(spec, rest) {
|
|
@@ -198,12 +198,12 @@ export function checkPositionals(spec, rest) {
|
|
|
198
198
|
}
|
|
199
199
|
|
|
200
200
|
/**
|
|
201
|
-
* 从位置参数里认出命令(最长前缀匹配:支持 `
|
|
201
|
+
* 从位置参数里认出命令(最长前缀匹配:支持 `publish targets save` 这类三词命令)。
|
|
202
202
|
* 先按 4 词、再 3 词、再 2 词、再 1 词试,命中即返回,剩下的位置参数归命令自己。
|
|
203
203
|
*
|
|
204
|
-
* ★ 2026-10-28
|
|
205
|
-
* `wkgeo
|
|
206
|
-
* 于是 "
|
|
204
|
+
* ★ 2026-10-28:两词 → 更长命令(当时最长四词)。顺带补一个坑:
|
|
205
|
+
* `wkgeo publish targets`(少打最后一个词)原本会退化命中两词命令 `publish targets`,
|
|
206
|
+
* 于是 "save" 被当成位置参数传给一条完全不相干的命令 —— 报错文案极其误导。
|
|
207
207
|
* 所以这里先查"打了一半的更长命令",有就直接报"命令不完整"。
|
|
208
208
|
* @param {Array} commands 命令 spec 数组(必须带 name,如 'sites create')
|
|
209
209
|
*/
|
package/lib/cms.mjs
CHANGED
|
@@ -69,8 +69,6 @@ export const CMS_ACTIONS = {
|
|
|
69
69
|
// 插件(插件中心)
|
|
70
70
|
pluginList: 'pluginList',
|
|
71
71
|
pluginToggle: 'pluginToggle',
|
|
72
|
-
// 域名巡检(只读;要「系统管理」权限,普通账号 403)
|
|
73
|
-
domainInspectionList: 'cmsSiteDomainInspectionList',
|
|
74
72
|
// 老网站导入 v2
|
|
75
73
|
importV2Start: 'importV2Start',
|
|
76
74
|
importV2Get: 'importV2Get',
|
package/lib/commands/auth.mjs
CHANGED
|
@@ -901,7 +901,7 @@ export const whoamiCommand = {
|
|
|
901
901
|
*
|
|
902
902
|
* 口径(与 `wkgeo-cli-fc` 的 `cliWhoami` / 映射文档一致):
|
|
903
903
|
* * 原生 —— 本函数 switch 里按 scope 过滤后的 `actions`;
|
|
904
|
-
* * 自持 —— 进程内重建(用户面 /
|
|
904
|
+
* * 自持 —— 进程内重建(用户面 / 内容 / 素材 / 发布 / 配置 / 站点 / 插件 / 控制台);
|
|
905
905
|
* * 转发 —— 金融面白名单转给 `wkgeo-order`(钱逻辑不复制)。
|
|
906
906
|
*/
|
|
907
907
|
export function summarizeActionSurface(who = {}) {
|
|
@@ -909,9 +909,6 @@ export function summarizeActionSurface(who = {}) {
|
|
|
909
909
|
const native = n(who.actions);
|
|
910
910
|
const batches = {
|
|
911
911
|
user: n(who.self_hosted_actions),
|
|
912
|
-
domain: n(who.domain_actions),
|
|
913
|
-
ops: n(who.ops_actions),
|
|
914
|
-
dns_credential: n(who.dns_credential_actions),
|
|
915
912
|
content: n(who.content_actions),
|
|
916
913
|
asset: n(who.asset_actions),
|
|
917
914
|
publish: n(who.publish_actions),
|
|
@@ -919,12 +916,13 @@ export function summarizeActionSurface(who = {}) {
|
|
|
919
916
|
site: n(who.site_actions),
|
|
920
917
|
finance_forwarded: n(who.forwarded_actions),
|
|
921
918
|
};
|
|
922
|
-
/* 口径对齐后端 `cliWhoami.action_total
|
|
923
|
-
|
|
924
|
-
|
|
919
|
+
/* 口径对齐后端 `cliWhoami.action_total`:自持各批次相加即总数。
|
|
920
|
+
★ 2026-11-19 task-1250:域名面(domain / ops / dns_credential)已从后端删除,
|
|
921
|
+
`uncounted_self_hosted` 恒为 0(字段保留,老脚本读它不会 undefined)。 */
|
|
922
|
+
const selfHosted = batches.user + batches.content + batches.asset + batches.publish
|
|
925
923
|
+ batches.config_auth + batches.site;
|
|
926
924
|
const forwarded = batches.finance_forwarded;
|
|
927
|
-
const uncounted =
|
|
925
|
+
const uncounted = 0;
|
|
928
926
|
const total = Number(who.action_total);
|
|
929
927
|
return {
|
|
930
928
|
action_total: Number.isFinite(total) && total > 0 ? total : native + selfHosted + forwarded,
|
|
@@ -937,21 +935,19 @@ export function summarizeActionSurface(who = {}) {
|
|
|
937
935
|
};
|
|
938
936
|
}
|
|
939
937
|
|
|
940
|
-
/** 「自持批次」的人话标签(顺序 =
|
|
938
|
+
/** 「自持批次」的人话标签(顺序 = 迁移批次;域名面已随 task-1250 删除) */
|
|
941
939
|
const SURFACE_BATCH_LABEL = [
|
|
942
940
|
['user', '账号/站点面(自持副本)'],
|
|
943
|
-
['domain', '域名面(自持副本)'],
|
|
944
|
-
['ops', '自持新链(域名购买/解析/ESA/建站收口)'],
|
|
945
941
|
['content', '内容类(B1)'],
|
|
946
942
|
['asset', '素材类(B2)'],
|
|
947
943
|
['publish', '发布类(B3)'],
|
|
948
944
|
['config_auth', '配置类 auth 面(B7:成员 / 角色 / 语言)'],
|
|
949
|
-
['site', '站点类(B4:公司信息 /
|
|
945
|
+
['site', '站点类(B4:公司信息 / 示例内容 / 站级同步)'],
|
|
950
946
|
['finance_forwarded', '金融面(白名单转发 wkgeo-order)'],
|
|
951
947
|
];
|
|
952
948
|
|
|
953
|
-
/** 不计入 `action_total`
|
|
954
|
-
const SURFACE_EXTRA_LABEL = [
|
|
949
|
+
/** 不计入 `action_total` 的批次:★ task-1250 起为空(域名面已删) */
|
|
950
|
+
const SURFACE_EXTRA_LABEL = [];
|
|
955
951
|
|
|
956
952
|
export const authStatusCommand = {
|
|
957
953
|
name: 'auth status',
|
|
@@ -966,7 +962,6 @@ export const authStatusCommand = {
|
|
|
966
962
|
'后端动作 `cliWhoami`(无 scope 要求、只读):返回账号标识 / client_id / scopes / 动作面清单,CLI 原样透出。',
|
|
967
963
|
'后端**没有** `account_id` 字段:账号唯一标识就是 `user_id`(本命令里 `account_id` ≡ `user_id`)。',
|
|
968
964
|
'动作面 = 原生(本函数 switch)+ 自持(进程内重建)+ 转发(金融面白名单给 wkgeo-order);`action_total` 与明细对不上时会标 `action_surface.consistent=false`。',
|
|
969
|
-
'口径:域名级 DNS 凭据 4 条**不计入** `action_total`(后端一致口径,防动作面漂移),单列在 `action_surface.uncounted_self_hosted`。',
|
|
970
965
|
'绝不打印令牌:要看"还剩多久、有多长"用 `wkgeo auth token`。',
|
|
971
966
|
],
|
|
972
967
|
async run(ctx) {
|
|
@@ -998,9 +993,6 @@ export const authStatusCommand = {
|
|
|
998
993
|
action_lists: {
|
|
999
994
|
actions: who.actions || [],
|
|
1000
995
|
self_hosted_actions: who.self_hosted_actions || [],
|
|
1001
|
-
domain_actions: who.domain_actions || [],
|
|
1002
|
-
ops_actions: who.ops_actions || [],
|
|
1003
|
-
dns_credential_actions: who.dns_credential_actions || [],
|
|
1004
996
|
content_actions: who.content_actions || [],
|
|
1005
997
|
asset_actions: who.asset_actions || [],
|
|
1006
998
|
publish_actions: who.publish_actions || [],
|
package/lib/commands/cms.mjs
CHANGED
|
@@ -1651,16 +1651,42 @@ function publishSiteOrThrow(ctx) {
|
|
|
1651
1651
|
/* ---- 发布前置:自有域名闸门(口径同 CMS 的 `siteCustomDomainState`) ---- */
|
|
1652
1652
|
|
|
1653
1653
|
/**
|
|
1654
|
-
*
|
|
1655
|
-
*
|
|
1656
|
-
*
|
|
1654
|
+
* 平台存储站没有自有域名时的提示 —— **一句中文说完「为什么不用发 + 下一步做什么」**。
|
|
1655
|
+
*
|
|
1656
|
+
* ⚠️ **必须与服务端逐字一致**(2026-11-18 task-985 老板改的文案):唯一真源是
|
|
1657
|
+
* `aliyun/fc/wkgeo-cms/src/cms-publish.js` 的 `PUBLISH_NO_CUSTOM_DOMAIN_MESSAGE`;
|
|
1658
|
+
* 同样逐字的一份副本在 `aliyun/fc/wkgeo-cli-fc/src/publish-core.js`。
|
|
1659
|
+
* 三处(CMS / cli-fc / 本文件)**任何一个字不同步,客户就会在不同入口看到两种说法**;
|
|
1660
|
+
* 三个包各自独立打包,没法共享常量,只能人工逐字同步 ⇒ 改文案时三处一起改。
|
|
1657
1661
|
*/
|
|
1658
1662
|
const PUBLISH_NO_CUSTOM_DOMAIN_MESSAGE =
|
|
1659
|
-
'
|
|
1663
|
+
'你的站点现在就能看:平台给的站点地址是实时预览,改完马上是最新的,这一步不用发布;绑定自己的域名之后,发布才会生效。';
|
|
1660
1664
|
|
|
1661
1665
|
/** 认「有自有域名」的 kind(与 CMS 的 SITE_PRIMARY_DOMAIN_SQL 一致,custom > root > other) */
|
|
1662
1666
|
const PUBLISH_CUSTOM_DOMAIN_KINDS = ['custom', 'root', 'other'];
|
|
1663
1667
|
|
|
1668
|
+
/**
|
|
1669
|
+
* 站点是不是「自有存储」(`own`)—— 与服务端判据的**前一半**同一口径。
|
|
1670
|
+
*
|
|
1671
|
+
* 服务端(CMS `publishPreconditionOf` / cli-fc `publishOwnStorageReady()`)读的是
|
|
1672
|
+
* `site_storage.mode='own'`;CLI 只读 `getSite` 回包的 `storage_kind`,而它正是服务端
|
|
1673
|
+
* `siteStorageKindOf()` 用同一份 `site_storage.mode` 归一出来的(`own ⇒ 'self'`)。
|
|
1674
|
+
*
|
|
1675
|
+
* ⚠️ **后一半(有启用的存储目标)CLI 拿不到**:服务端数的是 `site_remote_target` 上
|
|
1676
|
+
* 8 种 kind × `enabled` × `purpose` 的 `remote_count`,而 CLI 只有两条只读动作 ——
|
|
1677
|
+
* `cmsSitePublishTargetGet`(只覆盖 `purpose='publish'`)和 `cmsSiteStorageTargetGet`
|
|
1678
|
+
* (只覆盖 oss/cos/bos/s3 的**一行**)—— 凑不出与 `remote_count` 等价的数字。
|
|
1679
|
+
* ⇒ 本地**不猜**存储目标:自有存储站直接放行,由服务端 `publishOwnStorageReady()` 准确判
|
|
1680
|
+
* (真缺目标时服务端回 409 `no-storage-target`,文案由服务端给)。这样最坏只是"少拦一次、
|
|
1681
|
+
* 服务端再拦一次",绝不会用近似判据把客户的手动发布误封。
|
|
1682
|
+
*
|
|
1683
|
+
* 取不到 `storage_kind`(老服务端 / 字段缺失)⇒ 按平台存储处理 = 保持 2026-11-09 的原判据。
|
|
1684
|
+
*/
|
|
1685
|
+
function publishStorageKindOf(row) {
|
|
1686
|
+
const kind = String((row && row.storage_kind) || '').trim().toLowerCase();
|
|
1687
|
+
return kind === 'self' || kind === 'own' ? 'own' : 'platform';
|
|
1688
|
+
}
|
|
1689
|
+
|
|
1664
1690
|
/** 站点行 / 域名接口上「客户自有域名」的候选列(平台面 custom_domain / CMS 面 cms_domain / 老列 domain) */
|
|
1665
1691
|
function publishSiteDomainOf(row) {
|
|
1666
1692
|
if (!row) return '';
|
|
@@ -1701,7 +1727,10 @@ function publishVerifiedDomainOf(payload) {
|
|
|
1701
1727
|
* **fail-open**(与 CMS 同口径):两级里只要有一级**读失败**、拿不到结论,就不下"没有域名"的判断,
|
|
1702
1728
|
* 照旧放行 —— 宁可多跑一次发布,也不能因为一次查询抖动把客户的手动发布永久封死。
|
|
1703
1729
|
*
|
|
1704
|
-
*
|
|
1730
|
+
* ★ 2026-11-18 task-992:同一次 `getSite` 顺手取回 `storage_kind`(见 `publishStorageKindOf()`),
|
|
1731
|
+
* 让闸门能按服务端口径区分「自有存储(不要求域名行)」与「平台存储(必须绑域名)」。
|
|
1732
|
+
*
|
|
1733
|
+
* @returns {Promise<{known:boolean, hasCustomDomain:boolean, customDomain:string, storage:'own'|'platform'}>}
|
|
1705
1734
|
*/
|
|
1706
1735
|
async function publishCustomDomainState(ctx, siteId) {
|
|
1707
1736
|
let siteRow = null;
|
|
@@ -1718,38 +1747,50 @@ async function publishCustomDomainState(ctx, siteId) {
|
|
|
1718
1747
|
readFailed = true;
|
|
1719
1748
|
}
|
|
1720
1749
|
|
|
1750
|
+
const storage = publishStorageKindOf(siteRow);
|
|
1721
1751
|
const verified = publishVerifiedDomainOf(records);
|
|
1722
|
-
if (verified) return { known: true, hasCustomDomain: true, customDomain: verified };
|
|
1752
|
+
if (verified) return { known: true, hasCustomDomain: true, customDomain: verified, storage };
|
|
1723
1753
|
|
|
1724
1754
|
const fallback = publishSiteDomainOf(siteRow) || publishSiteDomainOf(records);
|
|
1725
|
-
if (fallback) return { known: true, hasCustomDomain: true, customDomain: fallback };
|
|
1755
|
+
if (fallback) return { known: true, hasCustomDomain: true, customDomain: fallback, storage };
|
|
1726
1756
|
|
|
1727
|
-
if (readFailed) return { known: false, hasCustomDomain: true, customDomain: '' };
|
|
1728
|
-
return { known: true, hasCustomDomain: false, customDomain: '' };
|
|
1757
|
+
if (readFailed) return { known: false, hasCustomDomain: true, customDomain: '', storage };
|
|
1758
|
+
return { known: true, hasCustomDomain: false, customDomain: '', storage };
|
|
1729
1759
|
}
|
|
1730
1760
|
|
|
1731
1761
|
/**
|
|
1732
|
-
*
|
|
1762
|
+
* 发布前拦一道:**平台存储站没有客户自有域名 ⇒ 拒绝并给一句中文提示**(exit code 非 0)。
|
|
1733
1763
|
*
|
|
1734
1764
|
* 2026-11-09 口径:站点唯一地址 `<slug>.site.wkgeo.cn` 是动态实时渲染,
|
|
1735
1765
|
* 内容改完立刻生效;静态发布产物只服务客户自有域名 —— 没绑域名时发布对客户没有任何可见效果。
|
|
1736
1766
|
* `--cancel` / `publish status` 不受影响(取消永远要能用)。
|
|
1767
|
+
*
|
|
1768
|
+
* ★ 2026-11-18 task-992(老板口径,与 CMS / cli-fc 服务端同源):
|
|
1769
|
+
* **自有存储的站不再本地拦** —— 产物推到客户自己的 ftp / sftp / oss 主机,没有 `site_domain`
|
|
1770
|
+
* 行也送得到(「悟空GEO官网」这类 own-storage 站以前被这道客户端闸门误伤,exit 1)。
|
|
1771
|
+
* 判据的顺序与服务端一致:
|
|
1772
|
+
* ① `storage_kind='self'`(= `site_storage.mode='own'`)⇒ 放行,存储目标由服务端判;
|
|
1773
|
+
* ② 否则(平台存储)⇒ 照旧要求域名,没有就 409 `no-custom-domain`。
|
|
1774
|
+
* **平台存储站别放开**:它的静态产物只由客户自有域名回源,没域名发了也没人看。
|
|
1737
1775
|
*/
|
|
1738
1776
|
async function assertPublishHasCustomDomain(ctx, site) {
|
|
1739
1777
|
const state = await publishCustomDomainState(ctx, site.id);
|
|
1740
1778
|
if (!state.known) {
|
|
1741
1779
|
if (!ctx.out.json) {
|
|
1742
|
-
ctx.out.warn('
|
|
1780
|
+
ctx.out.warn('读不到该站的自有域名状态,本次不拦发布(发完可在 CMS 后台的「域名」里核对)。');
|
|
1743
1781
|
}
|
|
1744
1782
|
return state;
|
|
1745
1783
|
}
|
|
1784
|
+
/** ① 自有存储:本地不判(服务端 `publishOwnStorageReady()` 会准确判"有没有启用的存储目标") */
|
|
1785
|
+
if (state.storage === 'own') return state;
|
|
1786
|
+
/** ② 平台存储:保持 2026-11-09 原判据 */
|
|
1746
1787
|
if (state.hasCustomDomain) return state;
|
|
1747
1788
|
throw new CliError(PUBLISH_NO_CUSTOM_DOMAIN_MESSAGE, {
|
|
1748
1789
|
kind: 'no_custom_domain',
|
|
1749
1790
|
code: 409,
|
|
1750
1791
|
hint:
|
|
1751
1792
|
'平台预览地址本身实时渲染:内容改完刷新就是最新,不需要发布。' +
|
|
1752
|
-
'绑定自有域名后再发:CMS 后台站点设置里登记域名 → 按提示加解析 →
|
|
1793
|
+
'绑定自有域名后再发:CMS 后台站点设置里登记域名 → 按提示加解析 → 在「域名」里看验证状态。',
|
|
1753
1794
|
details: { reason: 'no-custom-domain', hasCustomDomain: false },
|
|
1754
1795
|
});
|
|
1755
1796
|
}
|
|
@@ -1844,7 +1885,8 @@ export const publishCommand = {
|
|
|
1844
1885
|
notes: [
|
|
1845
1886
|
'**站点必须显式**:`--site` 或先 `wkgeo site use <id>`;都没配就报用法错误(不猜站点)。',
|
|
1846
1887
|
'不加 `--confirm` 一律 dry-run:只读 `overview` / `publishStatus` 算计划,**不发发布请求**。',
|
|
1847
|
-
'
|
|
1888
|
+
'**平台存储站没有客户自有域名会被拒**(exit 1,一个发布请求都不发):站点唯一地址是平台预览地址(动态实时渲染,内容改完立刻生效),静态发布只服务客户自有域名 —— 与 CMS 后台发布按钮同一口径;绑定域名后再发。',
|
|
1889
|
+
'**自有存储站不受上一条限制**:产物直接推到客户自己的 FTP / SFTP / 对象存储,没有域名行也送得到;有没有可用的存储目标由服务端判(缺了会回 409 并说明要补什么)。',
|
|
1848
1890
|
'真发前会打印站点名、域名、将发布页面数;需要「系统管理 / 全局配置」写权限,没有会回 403 并给权限提示。',
|
|
1849
1891
|
'后端没配 `INNER_PUBLISH_SECRET` 时会 fail-closed 回 503 —— 那是服务端部署问题,不是 CLI 的错。',
|
|
1850
1892
|
],
|
|
@@ -1857,8 +1899,8 @@ export const publishCommand = {
|
|
|
1857
1899
|
// 1) 取消分支:`--cancel` 与 `publish cancel` 同一个实现
|
|
1858
1900
|
if (ctx.flags.cancel) return runPublishCancel(ctx, site, row);
|
|
1859
1901
|
|
|
1860
|
-
// 2)
|
|
1861
|
-
//
|
|
1902
|
+
// 2) 前置闸门:**平台存储站**没有绑定客户自有域名 ⇒ 拒绝(exit code 非 0、一个发布请求都不发);
|
|
1903
|
+
// 自有存储站放行(判据见 `assertPublishHasCustomDomain()`)。口径同 CMS 后台的发布按钮。
|
|
1862
1904
|
const domainState = await assertPublishHasCustomDomain(ctx, site);
|
|
1863
1905
|
|
|
1864
1906
|
// 3) 先看清现状(只读):最新任务 + 内容计数
|
|
@@ -1889,7 +1931,8 @@ export const publishCommand = {
|
|
|
1889
1931
|
const data = {
|
|
1890
1932
|
...publishResultData(site, row, latest, { action: 'dry_run', confirmed: false }),
|
|
1891
1933
|
site_source: site.source,
|
|
1892
|
-
|
|
1934
|
+
/** 如实回:自有存储站可能真的没有域名行(闸门放行是因为存储方式,不是因为"有域名") */
|
|
1935
|
+
has_custom_domain: domainState.hasCustomDomain,
|
|
1893
1936
|
custom_domain: domainState.customDomain || '',
|
|
1894
1937
|
counts,
|
|
1895
1938
|
estimated_pages: estimate,
|
|
@@ -1898,7 +1941,12 @@ export const publishCommand = {
|
|
|
1898
1941
|
out.head('发布计划(dry-run,未发送任何发布请求)');
|
|
1899
1942
|
out.line(` 站点:${data.site_name || '(未取到站名)'}(${site.id})`);
|
|
1900
1943
|
out.line(` 域名:${domains.length ? domains.join('、') : '(平台没登记域名)'}`);
|
|
1901
|
-
out.line(
|
|
1944
|
+
out.line(
|
|
1945
|
+
` 自有域名:${
|
|
1946
|
+
domainState.customDomain ||
|
|
1947
|
+
(domainState.storage === 'own' ? '(自有存储站,不要求域名行)' : '(已绑定,平台没回具体域名)')
|
|
1948
|
+
}`,
|
|
1949
|
+
);
|
|
1902
1950
|
if (counts) {
|
|
1903
1951
|
out.line(
|
|
1904
1952
|
` 内容:栏目 ${counts.categories} 个 | 内容 ${counts.contents} 条(已发布 ${counts.published} / 草稿 ${counts.drafts})`,
|
|
@@ -2146,7 +2194,7 @@ export const publishRetryCommand = {
|
|
|
2146
2194
|
const { out } = ctx;
|
|
2147
2195
|
const site = publishSiteOrThrow(ctx);
|
|
2148
2196
|
const row = await publishSiteRow(ctx, site.id);
|
|
2149
|
-
// 重发同样是"真发"
|
|
2197
|
+
// 重发同样是"真发",先过同一道前置闸门(平台存储站没有自有域名 ⇒ 拒绝,见 publishCommand)
|
|
2150
2198
|
await assertPublishHasCustomDomain(ctx, site);
|
|
2151
2199
|
const previous = await publishJobOf(ctx, ctx.flags.job).catch(() => ({}));
|
|
2152
2200
|
const active = previous.status === 'queued' || previous.status === 'running';
|