@wkgeo/cli 2.0.0 → 2.0.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/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
- ### 域名只读命令(`domain status|records|dns|check|remind`)
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
- 客户自有域名这条链路的**观察窗口**。**全部只读**:CLI 不会替你加 DNS,也不会绑/解绑域名。
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` / `domain` / `ops` / `dns_credential` / `content` / `asset` / `publish` / `config_auth` / `site` / `plugin` / `console` / `finance_forwarded`) |
593
- | `uncounted_self_hosted` | **不计入** `action_total` 的那批(目前只有域名级 DNS 凭据 4 条 —— 后端口径如此,单列出来免得看着像丢动作) |
594
- | `consistent` | 明细加总(原生 + 自持 + 转发,**不含** `dns_credential`)与 `action_total` 是否对得上;对不上时标 `false`(服务端刚改动作表就会出现) |
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 | **静态发布 / 客户自有域名** | ✅ **0.5.0 起可用了**:`publish` 走 `cmsSitePublishStart` → 轮询 `cmsSitePublishStatus`(`summary` 里有 `pagesFailed` / `finalizeOk`),`--cancel` / `publish cancel` 可中止;域名这块的**只读**能力已补齐:`sites get`(短域 / KV / 存储位 / 开通状态)、`domain status` / `domain records` / `domain dns`(要客户自己加的 TXT-CNAME 清单)/ `domain check`(可注册性)/ `domain remind`(到期提醒,需平台管理员)/ `domain inspection`(巡检,需「系统管理员」)。⚠️ 仍需服务端配 `INNER_PUBLISH_SECRET`,未配时后端 fail-closed 回 503(CLI 会原样报出来)。**绑域写操作 0.6.0 已接**(`domain bind` → 原生 `cliProvisionSiteDomain`);`unbind` / `repair` 仍缺后端动作,见 #16 / #17 | 后端(unbind 动作 / repair 语义) |
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
- * 用户说"**帮我绑自己的域名**" → `domain bind <域名> --site <站点ID>`(成功只是受理,进度看 `domain status`;**通道没开会明确回 503「本次未写入,可直接重试」**,别当成功)
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` →(可选)`domain bind`
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;CLI **没有** `domain repair` 命令(后端也无等价 OAuth 动作) | **别撒谎说"能访问"**:如实告诉用户短域暂不可用,用 `sites get <站点ID>` 复核 `prefix_host` / `prefix_kv_written`;`null` = 旧接口没回这个字段,让用户直接打开短域试 |
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
- | `domain remind` 回 `kind:"domain_remind_forbidden"`(exit 3) | 该命令要**平台管理员**(站点系统管理员不够) | 让平台管理员跑,或到超管后台看;**不要**反复重试 |
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
@@ -151,8 +151,11 @@ export function fnOf(action, { legacy = legacyEndpointsEnabled() } = {}) {
151
151
  /**
152
152
  * ★ 2026-11-17(task-627):账务域下单**只在 `/cli` 后面**(cli-fc 再转发到 `/billing-core`)。
153
153
  * 逃生阀也回不去:`/order` 没有 `orderCreate` 这个动作,`/user` 更没有。
154
+ *
155
+ * ★ 2026-11-20(cli-price-quote):账务域**只读报价** `orderQuote` 同理(cli-fc 白名单转发)——
156
+ * 加购价的唯一来源是它(与 `orderCreate` 实收同源),逃生阀也不许绕到别的函数。
154
157
  */
155
- if (action === 'orderCreate') return 'cli';
158
+ if (action === 'orderCreate' || action === 'orderQuote') return 'cli';
156
159
  if (legacy) {
157
160
  if (FN_ORDER.has(action)) return 'order';
158
161
  return 'user';
package/lib/args.mjs CHANGED
@@ -162,7 +162,7 @@ export function coerceFlags(spec, flags) {
162
162
  /**
163
163
  * 位置参数校验:按顺序、必填在前。
164
164
  *
165
- * 最后一个 arg 可标 `variadic: true`(如 `domain check <域名…>`):
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
- * 从位置参数里认出命令(最长前缀匹配:支持 `domain dns credential set` 这类四词命令)。
201
+ * 从位置参数里认出命令(最长前缀匹配:支持 `publish targets save` 这类三词命令)。
202
202
  * 先按 4 词、再 3 词、再 2 词、再 1 词试,命中即返回,剩下的位置参数归命令自己。
203
203
  *
204
- * ★ 2026-10-28:三词 → 四词(`domain dns credential set`)。顺带补一个坑:
205
- * `wkgeo domain dns credential`(少打最后一个词)原本会退化命中两词命令 `domain dns`,
206
- * 于是 "credential" 被当成域名参数传给一条完全不相干的命令 —— 报错文案极其误导。
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
  */
@@ -1777,7 +1777,7 @@ async function assertPublishHasCustomDomain(ctx, site) {
1777
1777
  const state = await publishCustomDomainState(ctx, site.id);
1778
1778
  if (!state.known) {
1779
1779
  if (!ctx.out.json) {
1780
- ctx.out.warn('读不到该站的自有域名状态,本次不拦发布(发完可用 `wkgeo domain records` 核对)。');
1780
+ ctx.out.warn('读不到该站的自有域名状态,本次不拦发布(发完可在 CMS 后台的「域名」里核对)。');
1781
1781
  }
1782
1782
  return state;
1783
1783
  }
@@ -1790,7 +1790,7 @@ async function assertPublishHasCustomDomain(ctx, site) {
1790
1790
  code: 409,
1791
1791
  hint:
1792
1792
  '平台预览地址本身实时渲染:内容改完刷新就是最新,不需要发布。' +
1793
- '绑定自有域名后再发:CMS 后台站点设置里登记域名 → 按提示加解析 → `wkgeo domain records` 看验证状态。',
1793
+ '绑定自有域名后再发:CMS 后台站点设置里登记域名 → 按提示加解析 → 在「域名」里看验证状态。',
1794
1794
  details: { reason: 'no-custom-domain', hasCustomDomain: false },
1795
1795
  });
1796
1796
  }
@@ -109,7 +109,7 @@ import { CONFIG_AUTH_COMMANDS } from './config-auth.mjs';
109
109
  * `site demo-clear`、`site sync`;`domain inspection` 也从 `/cms` 改走 `/cli`。
110
110
  * 读 = `site:read`、写 = `site:write`,写动作默认 dry-run。
111
111
  * **不迁 2 条**:`cmsCreateSite`(已有原生 `site create`)、`cmsSiteDomainCheck`
112
- * (已有原生 `siteDomainCheck`,`wkgeo domain check` 在用)。
112
+ * (域名命令已随 task-1250 全部删除,这条也不再迁)。
113
113
  */
114
114
  import { SITE_COMMANDS } from './site.mjs';
115
115
 
@@ -396,8 +396,7 @@ const GROUP_SUMMARY = {
396
396
  notify: '我的消息:列表(未读数置顶)/ 标已读(写,默认 dry-run,`--confirm` 才真发)',
397
397
  invoices: '我的开票:可开票订单 + 我的开票申请(只读;开票动作留在会员端)',
398
398
  plans: '套餐目录:订阅套餐 / 加量包套餐 / 我已买的加量包(只读,三块小表)',
399
- site: '站点:选站 / 建站 / 公司信息 / 域名巡检重检 / 示例内容 / 站级同步(写要 site:write,默认 dry-run)',
400
- domain: '域名:绑自有域名 / 看开通进度 / 取解析清单 / 查可用性(购买与解析读写见 domain search / zone / esa)',
399
+ site: '站点:选站 / 建站 / 公司信息 / 示例内容 / 站级同步(写要 site:write,默认 dry-run)',
401
400
  lang: '站点语言:列表 / 新增或修改 / 设默认 / 删除 / 启用停用(写要 site:write,默认 dry-run)',
402
401
  role: '站点角色:列表 / 新增或修改 / 删除(写要 role:write;不许造带「系统管理」权限的角色)',
403
402
  member: '站点成员:列表(手机号掩码)/ 改角色 / 移出本站(只能管站点内角色,不建账号)',
@@ -449,7 +448,7 @@ export function renderHelp(name = null) {
449
448
  out.push('');
450
449
  out.push(line('位置参数:'));
451
450
  for (const a of spec.args) {
452
- /** variadic(如 `domain check <域名…>`):一个参数可以接多个值 */
451
+ /** variadic(如 `<文件…>`):一个参数可以接多个值 */
453
452
  const label = a.variadic ? `<${a.name}…>` : `<${a.name}>`;
454
453
  out.push(line(` ${label}${a.required ? '(必填)' : ''} ${a.desc || ''}`));
455
454
  }
@@ -496,11 +495,11 @@ export function renderHelp(name = null) {
496
495
  }
497
496
 
498
497
  /**
499
- * 分组帮助(2026-10-28 task-12):`wkgeo auth --help` / `wkgeo domain --help` 给
500
- * **这一组的命令清单**,不再掉到全量总帮助里。
498
+ * 分组帮助(2026-10-28 task-12):`wkgeo auth --help` 给**这一组的命令清单**,
499
+ * 不再掉到全量总帮助里。
501
500
  *
502
- * 为什么要加:`auth` 是 task-12 新加的命令组(status / token / revoke),`domain` 组也刚多了
503
- * `bind`;用户/AI 打组名求助时,看到 150 多条的全量帮助根本找不到这几条。
501
+ * 为什么要加:`auth` 是 task-12 新加的命令组(status / token / revoke);
502
+ * 用户/AI 打组名求助时,看到 140 多条的全量帮助根本找不到这几条。
504
503
  */
505
504
  if (name && !name.includes(' ')) {
506
505
  const inGroup = COMMANDS.filter((c) => groupOf(c) === name);
@@ -868,7 +868,7 @@ export const sitesUpdateCommand = {
868
868
  '需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真发。',
869
869
  '**`--remark` 暂时发不通**(服务端 `updateSite` 白名单与站点表都没有备注字段),传了会明确报缺口而不是假装成功。',
870
870
  '回收站里的站不能编辑:要么先 `wkgeo sites recycle restore`,要么彻底删(只有管理员能做)。',
871
- '要改域名/模板/有效期不在这条命令里(域名走 `wkgeo domain bind`、有效期只有管理员能改)。',
871
+ '要改域名/模板/有效期不在这条命令里(域名到会员中心 / CMS 后台的「域名」里操作、有效期只有管理员能改)。',
872
872
  ],
873
873
  async run(ctx) {
874
874
  const { out } = ctx;
@@ -16,6 +16,14 @@
16
16
  * ⚠️ 没有做"把余额补到一个已存在的 pending 订单上"的命令 —— 服务端**没有这个 action**
17
17
  * (`placeOrder` 里余额抵扣只在建单那一刻发生)。要做需要服务端新增接口,
18
18
  * 这属于"要主线程决定"的事,已在报告里列出。
19
+ *
20
+ * ## 加购价从哪来(★ 2026-11-20 cli-price-quote):只认服务端报价
21
+ * `orders create` 的金额 / 单价 / 份数**全部来自** `billing.orderQuote{kind:'quota'}`
22
+ * (`/cli` → `wkgeo-cli-fc` 白名单转发 → 网关 `/billing-core`),与实收
23
+ * `orderCreate{kind:'quota'}` **同源**。
24
+ * CLI 不再本地「单价 × 数量」:旧逻辑 `list.find(quota_key === …)` 取到列表第一条
25
+ * (`mandatory` 行 ¥2.00),而服务端实扣 `addon` 行 ¥1.87 ⇒ 显示 ¥2.00、实扣 ¥1.87。
26
+ * 只查价不建单:`wkgeo orders create --product <代码> --units N --dry-run`。
19
27
  */
20
28
 
21
29
  import { UsageError, CliError, EXIT } from '../errors.mjs';
@@ -36,6 +44,137 @@ function newOrderIdempotencyKey() {
36
44
  return `cli-quota-${Date.now().toString(36)}-${rand}`;
37
45
  }
38
46
 
47
+ /* ------------------------------------------------------------------ */
48
+ /* 计价:只问服务端(CLI 一行乘法都不写) */
49
+ /* ------------------------------------------------------------------ */
50
+
51
+ /**
52
+ * 服务端加购报价 —— **CLI 唯一的取价口径**(★ 2026-11-20 cli-price-quote)。
53
+ *
54
+ * ## 为什么要改成"问服务端"(事故背景)
55
+ * 改造前这里是「本地 `list.find(quota_key === … && kind === 'resource')` + 单价 × 数量」:
56
+ * `listProducts` 的排序是 `order by p.sort_order, p.code`,同一个 `quota_key` 下后台有
57
+ * **两条正常配置的行** —— `mandatory`(套餐必选 / 含项,¥2.00)与 `addon`(资源包,¥1.87)。
58
+ * 本地 `find` 命中**列表第一条** = mandatory ⇒ CLI 显示 ¥2.00,而服务端实扣 addon 行 ¥1.87。
59
+ * 估算与余额预检共用那一刻的 `estimateCents` ⇒ 两处都错。
60
+ *
61
+ * ## 现在的口径
62
+ * `orderQuote{kind:'quota', quota_key, quota_amount}` = 会员端「订单确认页」用的那条报价,
63
+ * 它内部调的就是 `orderCreate` 的计价函数(服务端不变量
64
+ * `orderQuote().payable_cents === orderCreate().amount_cents`)。
65
+ * ⇒ 金额 / 单价 / 份数 / 月数**全部照抄服务端回包**,本地不乘、不取整、不挑行算钱。
66
+ * ⇒ 以后后台怎么调价、加购取哪条产品行,CLI 都自动跟对(不会再有第二套算法)。
67
+ *
68
+ * ## 失败策略:**不回落本地估算**
69
+ * 显示一个"看起来对"的金额比报错更糟(这就是钱的事故)。报价拿不到就明确报错、不给金额,
70
+ * 让用户稍后重试或去网页看价 —— 绝不拿目录价糊一个数出来。
71
+ *
72
+ * @returns {Promise<{payable_cents:number, original_cents:number, unit_price_cents:number|null,
73
+ * units:number|null, unit:string|null, months:number|null, product_code:string|null,
74
+ * product_name:string|null, quota_key:string, quota_amount:number,
75
+ * wallet_balance_cents:number|null, via:string}>}
76
+ */
77
+ async function fetchQuotaQuote(ctx, { quotaKey, quotaAmount }) {
78
+ const payload = { kind: 'quota', quota_key: quotaKey, quota_amount: quotaAmount };
79
+ let res;
80
+ try {
81
+ res = await ctx.callData('orderQuote', payload);
82
+ } catch (e) {
83
+ throw new CliError(`查询加购报价失败:${(e && e.message) || e}`, {
84
+ kind: (e && e.kind) || 'error',
85
+ code: e && e.code !== undefined ? e.code : null,
86
+ exitCode: e && e.exitCode !== undefined ? e.exitCode : EXIT.ERROR,
87
+ hint:
88
+ '报价由服务端账务域给出(与实收同一份算法),拿不到报价就**先不要下单**:' +
89
+ '稍后重试;要核对历史金额用 `wkgeo orders list`,要看网页价去会员中心「产品 / 加购」。',
90
+ details: { action: 'orderQuote', ...payload },
91
+ });
92
+ }
93
+
94
+ const numOf = (v) => {
95
+ if (v === undefined || v === null || v === '') return null;
96
+ const n = Number(v);
97
+ return Number.isFinite(n) ? n : null;
98
+ };
99
+ const payable = numOf(res && res.payable_cents);
100
+ if (payable === null || payable <= 0) {
101
+ /** 报价为空 / 0 ⇒ 绝不显示金额(宁可报错,也不给一个错的价格) */
102
+ throw new CliError('服务端没有给出可用的报价金额(未显示任何金额)', {
103
+ kind: 'quote_empty',
104
+ code: 502,
105
+ hint:
106
+ '报价与实收同源,拿不到就**不要下单**:稍后重试;若一直为空,请在会员中心「产品 / 加购」页核对价格,' +
107
+ '或把这条输出发给平台负责人(附 `--verbose` 的脱敏原文)。',
108
+ details: { action: 'orderQuote', ...payload, raw: res || null },
109
+ });
110
+ }
111
+
112
+ const originalCents = numOf(res && res.original_cents);
113
+ const quotedAmount = numOf(res && res.quota_amount);
114
+ return {
115
+ payable_cents: Math.trunc(payable),
116
+ original_cents: originalCents === null ? Math.trunc(payable) : Math.trunc(originalCents),
117
+ discount_cents: Math.trunc(numOf(res && res.discount_cents) || 0),
118
+ unit_price_cents: numOf(res && res.unit_price_cents),
119
+ units: numOf(res && res.units),
120
+ unit: (res && res.unit) || null,
121
+ months: numOf(res && res.months),
122
+ product_code: (res && res.product_code) || null,
123
+ product_name: (res && res.product_name) || null,
124
+ quota_key: String((res && res.quota_key) || quotaKey),
125
+ quota_amount: quotedAmount === null ? quotaAmount : quotedAmount,
126
+ wallet_balance_cents: numOf(res && res.wallet_balance_cents),
127
+ coupon: (res && res.coupon) || null,
128
+ via: (res && res.via) || 'billing.orderQuote',
129
+ };
130
+ }
131
+
132
+ /**
133
+ * 本地挑产品行 —— **只用来定"买多少"(`quota_amount`),绝不用来算钱**。
134
+ *
135
+ * 顺序:① 产品代码精确命中(用户点名的那条;非资源型直接交给调用方报错);
136
+ * ② **同一 `quota_key` 的资源行里优先 `sale_type='addon'`(资源包)** —— 服务端
137
+ * `orderCreate` / `orderQuote` 永远按 `(sale_type='addon') desc, sort_order, code`
138
+ * 取行(`_shared/addon-product-pick.js`),所以倍率必须按同一行算;
139
+ * ③ 没有 addon 行时回落:用户点的 code 行,再不行第一条。
140
+ *
141
+ * ⚠️ 兜底路径说明(方案 ① 的位置):金额一律来自上面的服务端报价,这里的 `price_cents`
142
+ * **一次都不读**;② 只为把 `quota_multiplier`(⇒ 基础单位数量)算成后台配的那条资源包行,
143
+ * 与 `orderCreate` / `orderQuote` 的取行口径一致。
144
+ * 今天的 `listProducts` **还没下发 `sale_type`**,所以 ② 暂时不生效、实际走 ③ —— 一旦后端
145
+ * 补上该列,这里自动与服务端同序,不需要再改 CLI。**没有"未登录也要显示价格"的命令**:
146
+ * `products list` / `orders create` 都必须是登录态,未登录时 CLI 直接报需要登录、不显示金额。
147
+ */
148
+ function pickProductRow(list, wanted) {
149
+ const byCode = list.find((p) => p.code === wanted);
150
+
151
+ /* 非资源型(套餐 / 一次性服务)交给调用方报"CLI 只支持加量包"——不要拿它去猜配额 */
152
+ if (byCode && byCode.kind !== 'resource') return byCode;
153
+
154
+ /** 目标配额键:`--product` 传的可能是产品代码,也可能是配额键,两种都要能落到同一个 quota_key */
155
+ const quotaKey = (byCode && byCode.params && byCode.params.quota_key) || '';
156
+
157
+ const candidates = list.filter(
158
+ (p) =>
159
+ p.kind === 'resource' &&
160
+ p.params &&
161
+ (quotaKey ? p.params.quota_key === quotaKey : p.params.quota_key === wanted),
162
+ );
163
+ const isAddon = (p) => String(p.sale_type || '').trim().toLowerCase() === 'addon';
164
+
165
+ /**
166
+ * ② 服务端为这个 quota_key 实际会取的那一行(addon 优先)—— **数量以它为准**:
167
+ * `orderCreate` / `orderQuote` 永远按 `(sale_type='addon') desc, sort_order, code` 取行,
168
+ * 所以即使用户点的是必选行的 code,倍率也应当按 addon 行算,别买成另一个数量。
169
+ */
170
+ const addon = candidates.find(isAddon);
171
+ if (addon) return addon;
172
+
173
+ /* ③ 没有 addon 行:服务端回落 `sort_order, code` 的第一条 —— 用户点了 code 就用那一行 */
174
+ return byCode || candidates[0] || null;
175
+ }
176
+
177
+
39
178
  /* ------------------------------------------------------------------ */
40
179
  /* products list */
41
180
  /* ------------------------------------------------------------------ */
@@ -78,6 +217,7 @@ export const productsListCommand = {
78
217
  rows,
79
218
  );
80
219
  out.info(' 下单示例:wkgeo orders create --product <产品代码> --units 1');
220
+ out.info(' 查加购价(不建单、不扣款):wkgeo orders create --product <产品代码> --units 1 --dry-run');
81
221
  }
82
222
  ctx.done(data);
83
223
  return data;
@@ -92,8 +232,8 @@ export const ordersCreateCommand = {
92
232
  name: 'orders create',
93
233
  summary: '下单(余额足够时**当场用钱包余额付清**;不会发起真实微信扣款)',
94
234
  usage:
95
- 'wkgeo orders create --product <产品代码> --units <份数> [--allow-wechat]\n' +
96
- 'wkgeo orders create --quota <配额键> --amount <基础单位数> [--allow-wechat]',
235
+ 'wkgeo orders create --product <产品代码> --units <份数> [--allow-wechat] [--dry-run]\n' +
236
+ 'wkgeo orders create --quota <配额键> --amount <基础单位数> [--allow-wechat] [--dry-run]',
97
237
  flags: {
98
238
  product: { type: 'string', desc: '产品代码或配额键(见 `wkgeo products list`)' },
99
239
  units: { type: 'string', desc: '购买份数(默认 1,按产品单位计价)' },
@@ -103,6 +243,10 @@ export const ordersCreateCommand = {
103
243
  type: 'boolean',
104
244
  desc: '余额不足时仍创建订单(会返回微信 code_url,**需要用户自己扫码**;CLI 不会扣款)',
105
245
  },
246
+ 'dry-run': {
247
+ type: 'boolean',
248
+ desc: '只向服务端查**报价**(不建单、不扣款):加购价以它为准,与实收同一份算法',
249
+ },
106
250
  },
107
251
  async run(ctx) {
108
252
  const { out, flags } = ctx;
@@ -117,8 +261,8 @@ export const ordersCreateCommand = {
117
261
  let quotaKey;
118
262
  let quotaAmount;
119
263
  let units = null;
120
- let estimateCents = null;
121
- let productInfo = null;
264
+ /** 本地命中的产品行:**只用来定数量 / 展示名称**,金额一律不从这里取 */
265
+ let catalogHit = null;
122
266
 
123
267
  if (flags.product) {
124
268
  units = flags.units === undefined ? 1 : Number(flags.units);
@@ -129,9 +273,7 @@ export const ordersCreateCommand = {
129
273
  ...p,
130
274
  params: p.params || {},
131
275
  }));
132
- const hit =
133
- list.find((p) => p.code === flags.product) ||
134
- list.find((p) => p.params.quota_key === flags.product && p.kind === 'resource');
276
+ const hit = pickProductRow(list, flags.product);
135
277
 
136
278
  if (!hit) {
137
279
  throw new CliError(`找不到产品(或配额键)「${flags.product}」`, {
@@ -149,15 +291,9 @@ export const ordersCreateCommand = {
149
291
  }
150
292
  const mult = Number(hit.params.quota_multiplier) || 1;
151
293
  quotaKey = hit.params.quota_key;
294
+ /** ★ 基础单位数量 = 份数 × 倍率;**这是"买多少",不是"多少钱"** */
152
295
  quotaAmount = units * mult;
153
- estimateCents = units * (Number(hit.price_cents) || 0);
154
- productInfo = {
155
- code: hit.code,
156
- name: hit.name,
157
- unit: hit.unit || '份',
158
- unit_price_cents: Number(hit.price_cents) || 0,
159
- quota_multiplier: mult,
160
- };
296
+ catalogHit = hit;
161
297
  } else {
162
298
  quotaKey = flags.quota;
163
299
  quotaAmount = Number(flags.amount);
@@ -167,13 +303,78 @@ export const ordersCreateCommand = {
167
303
  units = null;
168
304
  }
169
305
 
306
+ /**
307
+ * ★ 2026-11-20(cli-price-quote):**金额只问服务端**(不再 `单价 × 数量`)。
308
+ * 报价 = 会员端确认页那条 `orderQuote{kind:'quota'}`,与 `orderCreate` 实收同源。
309
+ * 失败直接抛(不显示任何金额),见 `fetchQuotaQuote()` 的说明。
310
+ */
311
+ const quote = await fetchQuotaQuote(ctx, { quotaKey, quotaAmount });
312
+ const estimateCents = quote.payable_cents;
313
+
314
+ /** 展示用的商品信息:优先服务端报价回显(它就是实收那一条产品行) */
315
+ const productInfo = {
316
+ code: quote.product_code || (catalogHit && catalogHit.code) || null,
317
+ name: quote.product_name || (catalogHit && catalogHit.name) || quotaKey,
318
+ unit: quote.unit || (catalogHit && catalogHit.unit) || '份',
319
+ unit_price_cents: quote.unit_price_cents,
320
+ units: quote.units,
321
+ months: quote.months,
322
+ quota_multiplier: catalogHit ? Number(catalogHit.params.quota_multiplier) || 1 : null,
323
+ /** 金额来源(排查用:永远应是服务端报价,不是本地估算) */
324
+ price_source: 'server_quote',
325
+ };
326
+ /** 下单用的配额数量以**报价回显**为准(保证报价与建单是同一单) */
327
+ const chargeQuotaAmount = quote.quota_amount;
328
+
329
+ /* ---- 只查价:不建单、不扣款(加购价的权威查询入口) ---- */
330
+ if (flags.dryRun === true) {
331
+ const data = {
332
+ dry_run: true,
333
+ writes: 0,
334
+ quote,
335
+ amount_cents: quote.payable_cents,
336
+ amount_text: formatMoney(quote.payable_cents),
337
+ product: productInfo,
338
+ quota: { quota_key: quote.quota_key, quota_amount: chargeQuotaAmount, units },
339
+ balance_before_cents: quote.wallet_balance_cents,
340
+ balance_before_text:
341
+ quote.wallet_balance_cents === null ? null : formatMoney(quote.wallet_balance_cents),
342
+ };
343
+ if (!out.json) {
344
+ out.head('加购报价(dry-run:**没有**下单、**没有**扣款)');
345
+ out.line(` 商品:${productInfo.name}${productInfo.code ? `(${productInfo.code})` : ''}`);
346
+ const unitPrice =
347
+ quote.unit_price_cents === null ? '-' : formatMoney(quote.unit_price_cents);
348
+ const unitLabel = productInfo.unit || '份';
349
+ const unitCount = quote.units === null ? quotaAmount : quote.units;
350
+ const months = quote.months === null ? 1 : quote.months;
351
+ out.line(` 单价:${unitPrice} / ${unitLabel} × ${unitCount} × ${months} 个月`);
352
+ if (quote.discount_cents > 0) {
353
+ out.line(` 原价:${formatMoney(quote.original_cents)}(优惠 ${formatMoney(quote.discount_cents)})`);
354
+ }
355
+ out.line(` 合计:${formatMoney(quote.payable_cents)}`);
356
+ if (quote.wallet_balance_cents !== null) {
357
+ const enough = quote.wallet_balance_cents >= quote.payable_cents;
358
+ out.line(
359
+ ` 钱包余额:${formatMoney(quote.wallet_balance_cents)}(${enough ? '够' : `不够,差 ${formatMoney(quote.payable_cents - quote.wallet_balance_cents)}`})`,
360
+ );
361
+ }
362
+ out.info(` 金额来源:${quote.via}(服务端报价,与实收同一份算法)`);
363
+ out.info(' 真下单:去掉 --dry-run(余额够就当场付清;CLI 不会发起微信扣款)。');
364
+ }
365
+ ctx.done(data);
366
+ return data;
367
+ }
368
+
170
369
  /* ---- 钱包预检:余额不足时**默认拒绝**,而不是悄悄建一张要扫码的单 ---- */
171
- let balanceBefore = null;
172
- try {
173
- const w = await ctx.callData('getMyWallet', { limit: 1 });
174
- balanceBefore = Number(w && w.balance_cents) || 0;
175
- } catch (e) {
176
- out.warn(`读取钱包余额失败(继续下单):${e.message}`);
370
+ let balanceBefore = quote.wallet_balance_cents;
371
+ if (balanceBefore === null) {
372
+ try {
373
+ const w = await ctx.callData('getMyWallet', { limit: 1 });
374
+ balanceBefore = Number(w && w.balance_cents) || 0;
375
+ } catch (e) {
376
+ out.warn(`读取钱包余额失败(继续下单):${e.message}`);
377
+ }
177
378
  }
178
379
  if (
179
380
  balanceBefore !== null &&
@@ -200,32 +401,52 @@ export const ordersCreateCommand = {
200
401
  * 不再打 `/order` 的 `createQuotaOrder`(钱路径只留 billing 一条:
201
402
  * `placeOrder` + `fulfillOrder`,金额只从 `product.price_cents` 算)。
202
403
  * ⚠️ 必须带 `idempotency_key`:同键重放回原单(不会多建单、不会二次扣余额)。
404
+ *
405
+ * ★ 2026-11-20(cli-price-quote):`quota_amount` 用**报价回显的那个数**
406
+ * (`chargeQuotaAmount`)—— 保证"报价的单"和"建出来的单"是同一份参数,
407
+ * 不会出现「报价按 A 行算、下单按 B 行算」。
203
408
  */
204
409
  const res = await ctx.callData('orderCreate', {
205
410
  kind: 'quota',
206
- quota_key: quotaKey,
207
- quota_amount: quotaAmount,
411
+ quota_key: quote.quota_key,
412
+ quota_amount: chargeQuotaAmount,
208
413
  idempotency_key: newOrderIdempotencyKey(),
209
414
  });
210
415
  const paid = !!(res && res.paid);
416
+ const chargedCents = res && res.amount_cents !== undefined ? Number(res.amount_cents) : null;
211
417
  const data = {
212
418
  order_id: (res && res.order_id) || null,
213
419
  out_trade_no: (res && res.out_trade_no) || null,
214
420
  paid,
215
421
  amount_cents: Number(res && res.amount_cents) || null,
216
422
  amount_text: res && res.amount_cents !== undefined ? formatMoney(res.amount_cents) : null,
423
+ /** 服务端报价(下单前展示 / 余额预检用的就是这个数) */
424
+ quoted_cents: quote.payable_cents,
425
+ quoted_text: formatMoney(quote.payable_cents),
217
426
  wallet_paid_cents: Number(res && res.wallet_paid_cents) || 0,
218
427
  pay_amount_cents: res && res.pay_amount_cents !== undefined ? Number(res.pay_amount_cents) : null,
219
428
  code_url: (res && res.code_url) || null,
220
429
  expires_at_minutes: (res && res.expires_at_minutes) || null,
221
430
  message: (res && res.message) || null,
222
431
  product: productInfo,
223
- quota: { quota_key: quotaKey, quota_amount: quotaAmount, units },
432
+ quota: { quota_key: quote.quota_key, quota_amount: chargeQuotaAmount, units },
224
433
  balance_before_cents: balanceBefore,
225
434
  balance_after_cents:
226
435
  balanceBefore !== null && paid ? balanceBefore - (Number(res && res.wallet_paid_cents) || 0) : balanceBefore,
436
+ /** 明细:服务端返回的金额行(来自同一份报价/下单快照) */
437
+ quote,
227
438
  };
228
439
 
440
+ /**
441
+ * 报价 ≠ 实收是一条**钱的不变量**(服务端保证 `orderQuote().payable_cents === orderCreate().amount_cents`)。
442
+ * 真出现不一致就明确提示(不改金额、不重试),把这条输出留给平台负责人排查。
443
+ */
444
+ if (chargedCents !== null && chargedCents !== quote.payable_cents) {
445
+ out.warn(
446
+ `注意:报价 ${formatMoney(quote.payable_cents)} 与实收 ${formatMoney(chargedCents)} 不一致 —— 请把这条输出发给平台负责人(订单 ${data.order_id})`,
447
+ );
448
+ }
449
+
229
450
  if (!out.json) {
230
451
  out.head('下单结果');
231
452
  out.line(` 订单号:${data.order_id}`);
@@ -144,10 +144,10 @@ function printShortDomain(out, site, { channel = 'platform' } = {}) {
144
144
  } else if (site.prefix_kv_written === false) {
145
145
  out.warn('短域解析未写入(prefix_kv_written=false):现在访问短域会 403/404。');
146
146
  /**
147
- * TODO(task-9 / 后端 B2):等 `domain repair`(重写短域 KV)动作上线后接上 ——
148
- * 现在只能在文案里指路,**不要**在 CLI 里假装能修(否则就是"命令回成功、站点还是打不开")。
147
+ * 短域 KV 由服务端在建站时写入,CLI 没有修复能力(2026-11-19 task-1254:域名命令面已全部删除)——
148
+ * 只能在文案里指路,**不要**在 CLI 里假装能修(否则就是"命令回成功、站点还是打不开")。
149
149
  */
150
- out.info(' → 修复要等后端 `domain repair` 上线后跑 `wkgeo domain repair --site <站点ID>`;在此之前请联系管理员重写该站短域 KV。');
150
+ out.info(' → 修复要到会员中心 / CMS 后台的「域名」里看开通状态,并联系管理员重写该站短域 KV。');
151
151
  } else {
152
152
  out.info(' → 短域解析写入结果:服务端未返回(旧版接口)—— 直接打开上面的地址试一下就知道');
153
153
  }
@@ -736,7 +736,7 @@ export const sitesGetCommand = {
736
736
  out.line(` 创建时间:${formatTime(site.created_at)}${detail.updated_at ? ` · 更新时间:${formatTime(detail.updated_at)}` : ''}`);
737
737
  if (detail.last_error) out.warn(`最近一次错误:${detail.last_error}${detail.last_error_at ? `(${formatTime(detail.last_error_at)})` : ''}`);
738
738
  if (!site.custom_domain) {
739
- out.info(' → 还没有自有域名:`wkgeo domain status` 看开通状态,`wkgeo domain dns` 看要加的解析记录。');
739
+ out.info(' → 还没有自有域名:到会员中心 / CMS 后台的「域名」里绑定,并按提示加解析记录。');
740
740
  }
741
741
  }
742
742
  ctx.done(data);
package/lib/runtime.mjs CHANGED
@@ -351,10 +351,10 @@ export function createRuntime({
351
351
  /**
352
352
  * ★ 2026-10-28:把**注入的 stdin** 也挂到 ctx 上。
353
353
  *
354
- * 为什么需要它:`domain dns credential set` 的 AK Secret 只从 stdin(管道)或
355
- * TTY 无回显交互读。命令如果自己用 `process.stdin`,单测注入的假 stdin 就永远不生效
356
- * (用例会挂在真 stdin 上),而且 `stdinIsTTY` 与真正的读取源会**对不上**
357
- * (一个被判成"管道"、另一个却在读终端)。读取源与判定源必须是同一个对象。
354
+ * 为什么需要它:从 stdin(管道)或 TTY 无回显交互读密文(如 `publish targets save`
355
+ * 的密码)时,读取源必须与判定源是同一个对象。命令如果自己用 `process.stdin`,
356
+ * 单测注入的假 stdin 就永远不生效(用例会挂在真 stdin 上),而且 `stdinIsTTY`
357
+ * 与真正的读取源会**对不上**(一个被判成"管道"、另一个却在读终端)。
358
358
  */
359
359
  stdin,
360
360
  /** 时钟(**恒为函数**;不传 = `Date.now`) */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wkgeo/cli",
3
- "version": "2.0.0",
3
+ "version": "2.0.2",
4
4
  "description": "云站平台官方命令行客户端(@wkgeo/cli):授权登录一次,之后建站 / 下单 / 钱包支付 / 查余额都不用再登录(OAuth 授权码 + PKCE,公共客户端,零第三方依赖)",
5
5
  "keywords": [
6
6
  "wkgeo",