@wkgeo/cli 1.1.0 → 1.1.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 +31 -0
- package/README.md +151 -19
- package/SKILL.md +108 -27
- package/lib/args.mjs +2 -2
- package/lib/asset-role.mjs +68 -0
- package/lib/cms.mjs +2 -2
- package/lib/commands/billing.mjs +56 -10
- package/lib/commands/cms.mjs +49 -13
- package/lib/commands/content.mjs +108 -0
- package/lib/commands/crawl.mjs +219 -0
- package/lib/commands/geo.mjs +1673 -0
- package/lib/commands/index.mjs +640 -541
- package/lib/commands/member.mjs +930 -0
- package/lib/commands/seo.mjs +1386 -0
- package/lib/commands/siteops.mjs +3 -3
- package/lib/commands/sites.mjs +21 -125
- package/lib/commands/template.mjs +1222 -6
- package/lib/config.mjs +16 -13
- package/lib/content-apply.mjs +664 -0
- package/lib/content-check.mjs +887 -0
- package/lib/content-contract.mjs +957 -0
- package/lib/errors.mjs +6 -0
- package/lib/format.mjs +5 -1
- package/lib/manifest-apply.mjs +1499 -0
- package/lib/manifest-schema.json +476 -0
- package/lib/manifest.mjs +1082 -0
- package/lib/oauth-urls.mjs +1 -1
- package/lib/runtime.mjs +5 -1
- package/lib/site-create.mjs +536 -0
- package/lib/template-anim.mjs +1338 -0
- package/lib/template-animation.mjs +232 -0
- package/lib/template-capture.mjs +700 -0
- package/lib/template-gen.mjs +1204 -0
- package/lib/template-pack.mjs +206 -0
- package/lib/template-publish.mjs +733 -0
- package/lib/template-score.mjs +865 -0
- package/lib/template-validate.mjs +368 -0
- package/lib/template-verify.mjs +434 -0
- package/lib/templates-sync.mjs +616 -0
- package/package.json +2 -2
package/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: wkgeo-cli
|
|
3
|
-
description: "Use this skill when the user wants to 建站 / 创建网站 / 下单 / 购买加量包 / 钱包支付 / 充值 / 查余额 / 查钱包流水 / 查订单 / 查我已授权的应用 on the 云站(悟空AI,wkgeo.
|
|
3
|
+
description: "Use this skill when the user wants to 建站 / 创建网站 / 下单 / 购买加量包 / 钱包支付 / 充值 / 查余额 / 查钱包流水 / 查订单 / 查我已授权的应用 on the 云站(悟空AI,wkgeo.cn)platform from the command line or as an AI agent. Covers installing the official CLI (npx -y @wkgeo/cli@latest or npm i -g @wkgeo/cli), one-time OAuth login (browser callback or device code), local credential storage, machine-readable JSON output and its error codes (40101 expired / 40102 revoked / 429 rate limited / 403 scope). Do NOT use for other platforms, for admin/ops actions requiring step-up (refund, price change, permission change), or for real WeChat payments (the CLI never charges money)."
|
|
4
4
|
description_zh: 云站平台官方命令行客户端:授权登录一次,之后建站 / 下单 / 钱包余额支付 / 充值 / 查余额 / 查订单都不再需要登录。
|
|
5
5
|
description_en: Official CLI for the wkgeo Cloud Site platform — one-time OAuth login, then create sites, place orders, pay from wallet balance, and check balance/orders without logging in again.
|
|
6
6
|
version: 1.0.0
|
|
@@ -25,10 +25,18 @@ version: 1.0.0
|
|
|
25
25
|
* 用户说"**用钱包付**"/"余额支付"/"帮我付钱" → `orders create`(余额够会**当场付清**)+ `wallet` 复核
|
|
26
26
|
* 用户说"**充值**"/"充 100 块" → `wallet recharge`(下单后在**人类终端**里会自动打开我们网站的收银台页面,用户在那里扫码支付;CI/非交互只输出 `pay_url`)
|
|
27
27
|
* 用户说"**充值**"但**没说金额**、或说"**我自己选金额**"/"给我个充值链接" → `wallet recharge-link`
|
|
28
|
-
(生成**独立充值页**链接:`https://pay.wkgeo.
|
|
28
|
+
(生成**独立充值页**链接:`https://pay.wkgeo.cn/recharge/?ticket=…`,用户在网页上自己选金额
|
|
29
29
|
—— ¥10 / ¥20 快捷,或自定义,**最低 ¥9.90、不设上限** —— 然后扫码支付;**不需要登录会员中心**。
|
|
30
30
|
默认**不**弹浏览器:把 `data.pay_url` 原样交给用户即可。⛔ 不要用它代替用户付款。)
|
|
31
31
|
* 用户说"**查余额**"/"我的钱包"/"账单流水" → `wallet` / `wallet txns`
|
|
32
|
+
* 用户说"**我的账单**"/"我的套餐还有多少额度"/"配额" → `wallet billing`(订阅 + 生效配额三列,`null` = 不限量)
|
|
33
|
+
* 用户说"**我欠费吗**"/"该交钱了" → `wallet debt`(只读;**还款要在会员端**,CLI 不收钱)
|
|
34
|
+
* 用户说"**我有哪些券**"/"这张单能用哪张券" → `coupons`(全部)/ `coupons --usable --kind subscribe --amount-cents 2990`(这笔单能用的券 + 预览)
|
|
35
|
+
* 用户说"**我有什么消息**"/"帮我标已读" → `notify list` / `notify read <消息ID> --confirm`(⚠️ 不带 `--confirm` 只 dry-run,不会真标)
|
|
36
|
+
* 用户说"**我要开票**"/"能开哪些单" → `invoices list`(只读;**开票动作在会员端**,CLI 不做)
|
|
37
|
+
* 用户说"**有哪些套餐 / 多少钱**" → `plans list`(订阅套餐 / 站点续费价 / 加量包套餐 / 我已买的加量包)
|
|
38
|
+
* 用户说"**我删掉的站还能恢复吗**"/"回收站" → `sites recycle` → `sites recycle restore <站点ID> --confirm`(⚠️ 不带 `--confirm` 只 dry-run)
|
|
39
|
+
* 用户说"**改一下站名**" → `sites update <站点ID> --name <新站名> --confirm`(⚠️ 只有站名能改;`--remark` 服务端还不支持)
|
|
32
40
|
* 用户说"**我的订单**"/"订单状态" → `orders list` / `orders get` / `orders check`
|
|
33
41
|
* 用户说"**我授权过哪些应用**"/"取消某个应用的授权" → `apps list` / `apps revoke`
|
|
34
42
|
* 需要确认"现在是谁在操作" → `whoami`
|
|
@@ -42,7 +50,7 @@ version: 1.0.0
|
|
|
42
50
|
(step-up)。OAuth 令牌**永远过不了**(会返回 403/428)→ 让用户去网页后台做。
|
|
43
51
|
* ❌ **代替用户完成微信支付**:CLI 不会发起任何真实扣款,也不会模拟"支付成功"。
|
|
44
52
|
它只能创建待支付订单并把支付链接交给用户。
|
|
45
|
-
* ❌ 其他平台的网站/订单(本 CLI 只服务 `wkgeo.
|
|
53
|
+
* ❌ 其他平台的网站/订单(本 CLI 只服务 `wkgeo.cn` 这一套站点与账号体系)。
|
|
46
54
|
|
|
47
55
|
---
|
|
48
56
|
|
|
@@ -119,12 +127,22 @@ npx -y @wkgeo/cli@latest skill > SKILL.md # 直接落一份到本地,离线
|
|
|
119
127
|
| `config` | 生效配置 / 登录状态 | — |
|
|
120
128
|
| `sites list` | **站点管理入口**:默认只看**我名下的站**;没站引导建站,有站让你选一个来管理(写本地 config,等同 `site use`) | `--mine`(默认)、`--managed`、`--all`、`--limit`、`--offset`、`--with-prefix`(逐站补短域/开通状态) |
|
|
121
129
|
| `sites get` | 单站详情(只读):短域 / 存储位 / 开通状态 / 地区 / ESA / 证书 / 计费池 / 归属 | `<站点ID>` |
|
|
122
|
-
| `sites create` |
|
|
130
|
+
| `sites create` | **建站原语**:建站(平台通道分配池位 / 短域 / KV,站**建在令牌所属用户名下**)→ 可选装模板市场的模板 → 可选发布;`--json` 输出 `{ siteId, name, prefixHost, url, published }`。**来源分析不在 CLI**(不抓网址、不解析 zip/目录),见 `docs/规范-建站三来源-20261031.md`(task-73 产出) | `--name`(必填)、`--lang zh-CN\|en`、`--template <模板key>`、`--publish`、`--dry-run`、`--region domestic\|overseas\|global` |
|
|
123
131
|
| `sites delete` | 删站(软删进回收站) | `<站点ID>` |
|
|
132
|
+
| `sites update` | 改站点信息(目前只开放**改站名**;**默认 dry-run**,`--confirm` 才真发)。`--remark` **发不通**(服务端白名单与站点表都没有备注字段),传了会明确报缺口 | `<站点ID>`、`--name`、`--confirm` |
|
|
133
|
+
| `sites recycle` | 回收站(我删掉的站,可还原) | `--limit`、`--offset` |
|
|
134
|
+
| `sites recycle restore` | 从回收站还原(**默认 dry-run**,`--confirm` 才真发;池退役/名额满 → 409 原样透传) | `<站点ID>`、`--confirm` |
|
|
124
135
|
| `wallet` | 余额 + 最近流水 | `--limit` `--entitlements` |
|
|
125
136
|
| `wallet txns` | 钱包流水 | `--limit` |
|
|
126
137
|
| `wallet recharge` | 充值下单,**人类终端会自动打开我们网站的收银台页面**扫码支付(CI/非交互只输出链接;**不扣款**) | `--amount-cents`(分,必填)、`--no-browser`、`--open-browser`、`--dry-run` |
|
|
127
138
|
| `wallet recharge-link` | 生成**独立充值页**链接(用户在网页上**自己选金额**并扫码支付;**不扣款**、不建单) | `--open-browser`(默认**不**弹)、`--no-browser` |
|
|
139
|
+
| `wallet billing` | **我的账单**:订阅(套餐名/期间/是否过期)+ 生效配额(套餐内 / 加量包 / 生效合计三列,`null` = 不限量)+ 余额(只读) | — |
|
|
140
|
+
| `wallet debt` | **我的欠费**:金额 / 状态 / 应缴日期 / 宽限期 / 明细(只读,**不含还款**) | — |
|
|
141
|
+
| `coupons` | 我的优惠券(面额/门槛/状态/到期);`--usable` = 换成"**这笔单能用的券** + 抵扣/应付预览"(另一条动作,必须给 `--kind` 与 `--amount-cents`) | `--status unused\|used\|expired`、`--usable`、`--kind subscribe\|site_renew\|quota`、`--amount-cents`(分)、`--page`、`--page-size` |
|
|
142
|
+
| `notify list` | 我的消息(未读数 + 列表) | `--limit`(1~50)、`--offset` |
|
|
143
|
+
| `notify read` | 把一条消息标已读(**默认 dry-run**,`--confirm` 才真发;幂等) | `<消息ID>`(纯数字)、`--confirm` |
|
|
144
|
+
| `invoices list` | 我的开票:可开票订单 + 我的开票申请两张表(只读;**不含开票动作**) | `--limit` |
|
|
145
|
+
| `plans list` | 套餐目录四张小表:订阅套餐 / 站点续费价 / 加量包套餐 / 我已买的加量包 | `--no-bundles` |
|
|
128
146
|
| `products list` | 能买什么 | — |
|
|
129
147
|
| `orders create` | 下单(余额够**当场付清**) | `--product <代码>` `--units <份数>`(或 `--quota <键>` `--amount <数量>`)`--allow-wechat` |
|
|
130
148
|
| `orders check` | 查支付结果 + 最新余额 | `<订单ID>` |
|
|
@@ -139,10 +157,10 @@ npx -y @wkgeo/cli@latest skill > SKILL.md # 直接落一份到本地,离线
|
|
|
139
157
|
| `categories list/get/create/update/delete` | 栏目:列表 / 详情 / 新建 / 改 / 删 | 见 §7.5 |
|
|
140
158
|
| `categories bind-template` | 给栏目绑定模板 html(`--clear` 解绑) | `<栏目>` `<模板文件>`、`--clear` |
|
|
141
159
|
| `contents list/get/create/update/delete` | 内容:列表 / 详情 / 新建 / 改 / 删 | 见 §7.5 |
|
|
142
|
-
| `assets list` / `assets upload` | 素材:列表 / 上传(签名 → 直传 OSS → 登记) | `assets upload <文件>`、`--name
|
|
160
|
+
| `assets list` / `assets upload` | 素材:列表 / 上传(签名 → 直传 OSS → 登记) | `assets upload <文件>`、`--name`、`--role image\|css\|js\|file`(缺省按扩展名推断) |
|
|
143
161
|
| `assets sign` / `assets register` | 只取直传票据(**不上传、不登记**,agent/脚本自己 POST 文件用)/ 把已直传的 key 登记成素材(服务端会回读一次,确认文件真的在) | `sign <文件名> --bytes <字节数>`、`register <key>`、`--name` |
|
|
144
162
|
| `assets delete` / `assets restore` | 删素材(**默认进回收站**;`--purge --confirm` 才是彻底删除)/ 从回收站恢复(文件已被彻底删掉的会明确拒绝) | `<素材ID>`、`--purge`、`--confirm`、`--site` |
|
|
145
|
-
| `templates list/get/save` | 模板:清单 / 看源码(直出)/
|
|
163
|
+
| `templates list/get/save` | 模板:清单 / 看源码(直出)/ 保存(`html` / `css` / `js`,可带 `assets/site.css` 这种子目录路径) | `templates get <文件>`、`templates save <文件> --file <本地>` |
|
|
146
164
|
| `publish` | **发布站点**(0.5.0 接真后端):默认 **dry-run** 只算页数;`--confirm` 才真发并轮询到结束 | `--site`、`--confirm`、`--cancel`、`--no-wait`、`--job`、`--interval`、`--wait-timeout` |
|
|
147
165
|
| `publish status` / `publish cancel` | 只查状态 / 取消正在跑的发布 | `--site`、`--job` |
|
|
148
166
|
| `publish retry` | 重发一次(旧任务不动,新建一个发布任务) | `--site`、`--job` |
|
|
@@ -189,6 +207,7 @@ npx -y @wkgeo/cli@latest skill > SKILL.md # 直接落一份到本地,离线
|
|
|
189
207
|
| `import-v2 start` / `import-v2 status` | 老站导入 v2(默认 dry-run;`--confirm` 才提交)/ 看进度 | `--url`(必填)、`--confirm`、`--max-pages`、… / `--run`(必填) |
|
|
190
208
|
| `ai ping` / `ai ask` / `ai chat` | **接本机大模型**:探端点 / 单问(CLI 取数+脱敏)/ 多轮 | `--context`、`--site`、`--model`、`--base-url`;`ai ask` 需 `<问题>` |
|
|
191
209
|
| `context export` | 把站点上下文导出给任意模型吃(**不外传**) | `--site`、`--out`、`--format json\|md`、`--with-body`、`--context` |
|
|
210
|
+
| `crawl` | **并发抓整站**(确定性爬虫、**零模型调用**、**不回传整页 HTML**):只出标题 / 正文 / 图片 / 结构信号 | `<url>`(必填)、`--max-pages`、`--concurrency`、`--page-timeout`、`--min-interval`、`--no-robots`、`--out` |
|
|
192
211
|
| `import` | 老站导入(**默认 dry-run**;走本机运维脚本,**需运维权限**) | `--url`(必填)、`--apply`、`--site` |
|
|
193
212
|
| `skill` | **打印给 AI 端的操作手册**(本文件原文,随包分发) | `--json`(默认纯文本原文;不受"非终端自动 JSON"影响) |
|
|
194
213
|
|
|
@@ -252,6 +271,26 @@ wkgeo overview dashboard # 数据看板快照(存储/流量/费
|
|
|
252
271
|
**`domain bind` 已实现**(= 受理开通,进度看 `domain status`);**`domain unbind` / `domain repair` 仍未实现**(`releaseSiteDomain` 在 OAuth 下仍是 428 短信二次验证,不造命令 —— 解绑去会员中心,重试开通 = 再跑一次 `domain bind`,幂等)。
|
|
253
272
|
解析**能写**:`domain zone add|update|delete`(自持 alidns,写后回读确认);但 `domain dns` 那份清单仍按「要客户自己去域名商加」的格式输出。
|
|
254
273
|
|
|
274
|
+
### 4.1.5 抓整站:`crawl`(2026-11-01 · task-84)
|
|
275
|
+
|
|
276
|
+
**规矩(AI 端照做,不要自己写逐页循环)**:
|
|
277
|
+
- 要「把客户老站抓下来」时,**一律先调 `wkgeo crawl <url> --json`**(或 `--out <文件>` 让它落盘),**不要逐页抓、不要一页一次模型往返**。
|
|
278
|
+
- 抓取器是**代码并发**(默认 6、上限 10),**零模型调用**;它只回**标题 / 正文 / 图片 / 结构信号**,**整页 HTML 不回传**(体积可控,别指望拿 html)。
|
|
279
|
+
- 抓完把 `pages[]` **按 10–20 页一批**送模型做结构化抽取;只有失败的页再单独托底(每批 ≤20 页)。
|
|
280
|
+
- 抓到的内容要**落进 CMS** 才走 `wkgeo import` / `wkgeo import-v2 start` —— 那条链才有三档容错(规则 → 容错解析 → AI 托底)与 AI 预算。
|
|
281
|
+
- 合规:只抓**企业站**;政府 / 教育 / 军队 / 协会域名、黑名单域名、内网地址由闸门直接拒(`exit 1`),**不要想办法绕过**。别人家的站先问老板。
|
|
282
|
+
|
|
283
|
+
```bash
|
|
284
|
+
wkgeo crawl https://old-site.com --json > crawl.json
|
|
285
|
+
wkgeo crawl https://old-site.com --max-pages 60 --out .tmp-build/crawl.json
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
返回在信封 `data` 里:`{ url, entry, stats, pages[], failures[] }`;
|
|
289
|
+
`stats.modelCalls` **恒 0**,另有 `concurrencyPeak` / `throttled` / `pagesPerSecond` / 跳过统计 / `robots`;
|
|
290
|
+
`pages[]` 每项 `{url, title, description, chars, text, markdown, images[], headings[], signals{}}`(**无 `html` / `bodyHtml`**)。
|
|
291
|
+
|
|
292
|
+
**为什么不让模型逐页抓**(30 页夹具站实测,2026-11-01):串行 1 并发 15.34s(1.96 页/秒)→ 并发 6 带 150ms 礼貌间隔 5.28s(**2.91×**)→ 并发 6 无间隔 3.13s(**4.90×**),失败率都是 0%;
|
|
293
|
+
模型调用从「30 页 × 1 次 = 30 次」降到「抓取 0 次 + 批量抽取 2 次」。
|
|
255
294
|
### 4.2 端到端脚本(`cli/scripts/e2e-site.mjs`)
|
|
256
295
|
|
|
257
296
|
建站全链路脚本,**随仓库分发、不在 npm 包里**(`package.json` 的 `files` 白名单只有 `wkgeo.mjs` / `lib` / `README.md` / `SKILL.md` / `CHANGELOG.md`):
|
|
@@ -317,11 +356,12 @@ $ npx -y @wkgeo/cli@latest orders create --product storage_gb --units 10
|
|
|
317
356
|
## 5. 授权流程(**必须让用户动手的那一步**)
|
|
318
357
|
|
|
319
358
|
> ★ **2026-10-18 域名统一到路径**:授权站 canonical 从 `https://oauth.wkgeo.com/` 改成
|
|
320
|
-
> **`https://wkgeo.
|
|
359
|
+
> **`https://wkgeo.cn/oauth/`**(同意页 `/oauth/authorize/`、设备码页 `/oauth/device/`)。
|
|
321
360
|
> 老子域**继续可用**(老板要求并存);CLI 以 `WKONGAI_OAUTH_WEB_BASE` 为 canonical,
|
|
322
361
|
> 服务端 metadata 只提供路径 —— 所以**服务端还没部署新地址时,CLI 打印的也是新地址**。
|
|
323
362
|
> 回滚一条环境变量即可:`WKONGAI_OAUTH_WEB_BASE=https://oauth.wkgeo.com`(不用改代码)。
|
|
324
|
-
>
|
|
363
|
+
> ★ **2026-11-09(老板定)**:`wkgeo.com` 已无 A 记录、全面退役,默认基址统一 `.cn`。
|
|
364
|
+
> ⚠️ 给用户看的地址**原样转述**,别自己把 `wkgeo.cn/oauth` 改回 `oauth.wkgeo.com` 去"纠错"。
|
|
325
365
|
|
|
326
366
|
### 5.1 本地回调模式(默认)
|
|
327
367
|
|
|
@@ -342,7 +382,7 @@ npx -y @wkgeo/cli@latest login --json --timeout 500ms # 也可以显式写毫
|
|
|
342
382
|
// 第一行 —— 拿到它就应该**立刻**把网址交给用户(不要等命令结束!)
|
|
343
383
|
// ⚠️ `authorize/` 的**尾斜杠不能丢**:它是托管侧 302(会丢掉全部 query)的分界线
|
|
344
384
|
{"ok":true,"command":"login","mode":"callback","stage":"awaiting_callback",
|
|
345
|
-
"authorization_url":"https://wkgeo.
|
|
385
|
+
"authorization_url":"https://wkgeo.cn/oauth/authorize/?client_id=wkgeo-cli&…",
|
|
346
386
|
"redirect_uri":"http://127.0.0.1:53682/callback","scope":"site:read site:write billing:self",
|
|
347
387
|
"timeout_ms":300000,
|
|
348
388
|
"user_action_required":"请让用户在浏览器中打开上面的 authorization_url,登录并点「同意」"}
|
|
@@ -424,7 +464,7 @@ npx -y @wkgeo/cli@latest login --json --timeout 500ms # 也可以显式写毫
|
|
|
424
464
|
# ① 交互式终端 / 你有长超时能力:一口气跑完(阻塞,最多 expires_in 秒)
|
|
425
465
|
npx -y @wkgeo/cli@latest login --device --json
|
|
426
466
|
# → {"stage":"awaiting_user","user_code":"ABCD-1234",
|
|
427
|
-
# "verification_uri":"https://wkgeo.
|
|
467
|
+
# "verification_uri":"https://wkgeo.cn/oauth/device/",
|
|
428
468
|
# "verification_uri_complete":"…/?user_code=ABCD-1234","open_url":"…",
|
|
429
469
|
# "expires_in":600,"interval":5,"paste_text":"请打开 … 并完成「同意授权」(短码:ABCD-1234)。",
|
|
430
470
|
# "user_action_required":"请让用户访问 … 并输入短码 ABCD-1234"}
|
|
@@ -590,7 +630,7 @@ Set-Content -LiteralPath "$env:USERPROFILE\.dsh\browser-open.txt" -Value "<完
|
|
|
590
630
|
```
|
|
591
631
|
|
|
592
632
|
约 **1.2 秒**后在**右侧内置浏览器**打开,收件文件会被**自动删除**(删掉 = 客户端真的执行了)。
|
|
593
|
-
原理 / 三层验证 / 回滚见
|
|
633
|
+
原理 / 三层验证 / 回滚见 本文「并入:AI客户端-内置浏览器打开」节。
|
|
594
634
|
|
|
595
635
|
**CLI 这边的行为(你不需要自己判断,照着字段走就行)**:
|
|
596
636
|
|
|
@@ -663,18 +703,20 @@ npx -y @wkgeo/cli@latest sites list
|
|
|
663
703
|
# data.hint == "no_sites" → 没有站:走 sites create;否则把 data.sites 交给用户选
|
|
664
704
|
# ⚠️ CMS-only 站点也在 data.sites 里(source:"cms"),别只看平台面
|
|
665
705
|
|
|
666
|
-
# ③
|
|
667
|
-
npx -y @wkgeo/cli@latest sites create --name "我的新站"
|
|
668
|
-
# 读 data.
|
|
706
|
+
# ③ 建站(名字由用户给;建站原语:建站 → 可选装模板 → 可选发布)
|
|
707
|
+
npx -y @wkgeo/cli@latest sites create --name "我的新站" --lang zh-CN --template classic-blue --publish --json
|
|
708
|
+
# 读 data.siteId / data.prefixHost / data.url / data.published(steps 里每步的 ok 与耗时)
|
|
669
709
|
# ℹ️ 客户(customer)层已于 2026-10-27 删除:建站不需要任何归属参数,归属固定为令牌所属用户。
|
|
670
|
-
# ℹ️
|
|
671
|
-
#
|
|
672
|
-
#
|
|
673
|
-
#
|
|
674
|
-
#
|
|
675
|
-
#
|
|
676
|
-
# ⚠️
|
|
677
|
-
#
|
|
710
|
+
# ℹ️ 走平台通道 createSite:服务端分配池位 + 短域 + KV;池位满回 409(POOL_EXHAUSTED),
|
|
711
|
+
# 换区再建:--region overseas(intl.wkgeo.com.cn)/ --region global。
|
|
712
|
+
# ℹ️ --template 只认**模板市场已有的 key**(填错会列出现有 key,exit 2);不给就是空站;
|
|
713
|
+
# 装完会自动启用(templateInstall → templateActivate)。
|
|
714
|
+
# ℹ️ 不给 --publish 只建不发:短域还没内容(404 属正常),要上线加 --publish。
|
|
715
|
+
# ℹ️ 先看计划不写库:--dry-run(零写入,输出 create_site / install_template / ensure_lang / publish 四步)。
|
|
716
|
+
# ⚠️ 短域打不开时用 sites get <站点ID> 复核 prefix_host / prefix_kv_written(null = 旧接口没回);
|
|
717
|
+
# KV 没写成功就说"短域暂不可用",别撒谎说能访问。
|
|
718
|
+
# ⚠️ **来源分析不在 CLI**:本命令不抓网址、不解析 zip/目录、不做多来源合成;
|
|
719
|
+
# 从网址/文档生成站点是 A 侧(配 skill)的活,规范见 docs/规范-建站三来源-20261031.md(task-73 产出)。
|
|
678
720
|
|
|
679
721
|
# ④ 看能买什么 + 余额够不够
|
|
680
722
|
npx -y @wkgeo/cli@latest products list
|
|
@@ -695,7 +737,7 @@ npx -y @wkgeo/cli@latest wallet txns --limit 3
|
|
|
695
737
|
```bash
|
|
696
738
|
npx -y @wkgeo/cli@latest wallet recharge --dry-run --amount-cents 10000 # 先彩排,确认金额
|
|
697
739
|
npx -y @wkgeo/cli@latest wallet recharge --amount-cents 10000 # 生成待支付订单,并把收银台地址交出来(不扣款)
|
|
698
|
-
# ★ 读 data.pay_url —— 这是**我们网站的收银台页面**(https://pay.wkgeo.
|
|
740
|
+
# ★ 读 data.pay_url —— 这是**我们网站的收银台页面**(https://pay.wkgeo.cn/?order_id=…&token=…)。
|
|
699
741
|
# ⚠️ **不要把 data.code_url 当成主流程丢给用户自己想办法**(那是微信内部支付链接,
|
|
700
742
|
# 手机直接扫不了;终端二维码只是"网页打不开"时的兜底)。
|
|
701
743
|
# ★ `token=` 是服务端在下单那一刻签发的**订单支付令牌**(只对这一单有效):
|
|
@@ -737,7 +779,7 @@ npx -y @wkgeo/cli@latest orders check <order_id> # 用
|
|
|
737
779
|
|
|
738
780
|
```bash
|
|
739
781
|
npx -y @wkgeo/cli@latest wallet recharge-link # 默认不弹浏览器:交接物就是链接本身
|
|
740
|
-
# ★ 读 data.pay_url —— 形如 https://pay.wkgeo.
|
|
782
|
+
# ★ 读 data.pay_url —— 形如 https://pay.wkgeo.cn/recharge/?ticket=…
|
|
741
783
|
# 把它**原样**发给用户(或做成可点的链接)。他在那一页上:
|
|
742
784
|
# 选金额(¥10 / ¥20 快捷,或自定义;最低 ¥9.90、**不设上限**)→ 提交 → 微信扫码支付。
|
|
743
785
|
# ⚠️ **不需要登录会员中心** —— 凭证就是地址里的 ticket,整条链路与登录态无关。
|
|
@@ -809,7 +851,7 @@ npx -y @wkgeo/cli@latest contents create --category 新闻 --title "公司参展
|
|
|
809
851
|
npx -y @wkgeo/cli@latest assets upload ./banner.jpg --json # 读 data.asset.id
|
|
810
852
|
npx -y @wkgeo/cli@latest contents update <内容ID> --cover <素材ID> --json
|
|
811
853
|
|
|
812
|
-
# ⑤
|
|
854
|
+
# ⑤ 改版式(2026-11-01 起推荐整包拉改推:`templates pull` → 本地改 → `templates push`,见 §7.5.1)
|
|
813
855
|
npx -y @wkgeo/cli@latest templates list --json # 读 data.files[].path
|
|
814
856
|
npx -y @wkgeo/cli@latest templates get index.html > index.html # 人类模式直出源码(备份)
|
|
815
857
|
npx -y @wkgeo/cli@latest templates save index.html --file ./index.html --json
|
|
@@ -844,6 +886,43 @@ npx -y @wkgeo/cli@latest publish --site <站点ID> --confirm --json # 真发,
|
|
|
844
886
|
|
|
845
887
|
---
|
|
846
888
|
|
|
889
|
+
### 7.5.1 用户说"我要改模板 / 在本地改这套模板"(`templates pull` / `push`,2026-11-01)
|
|
890
|
+
|
|
891
|
+
老板口径:**模板编辑走 CLI,不走网页**(CMS 的在线代码编辑器入口已下线;服务端保存动作仍在,push 用它)。
|
|
892
|
+
整条链路就是「拉下来 → 本地编辑器改 → 推回 → 发布」:
|
|
893
|
+
|
|
894
|
+
```bash
|
|
895
|
+
# ① 拉整包(不给 --template 就拉当前启用那套)
|
|
896
|
+
npx -y @wkgeo/cli@latest templates pull --dir ./my-template --json
|
|
897
|
+
# → data.file_count / data.template.key / data.content_hash / data.manifest(manifest 路径)
|
|
898
|
+
|
|
899
|
+
# ② 本地改(用户的 VS Code / Cursor)—— 你不用动,等他说改完
|
|
900
|
+
# ← 真源在本地目录:pages/index.html、partials/header.html、assets/style.css、template.json…
|
|
901
|
+
|
|
902
|
+
# ③ 先看差异(零写请求,exit 0;四类:added / changed / removed / unchanged)
|
|
903
|
+
npx -y @wkgeo/cli@latest templates push --dir ./my-template --dry-run --json
|
|
904
|
+
# → data.plan.added[] / changed[] / removed[] / unchanged[]
|
|
905
|
+
|
|
906
|
+
# ④ 真写(不加 --confirm 只打计划并 exit 2,error.kind = "confirm_required")
|
|
907
|
+
npx -y @wkgeo/cli@latest templates push --dir ./my-template --confirm --json
|
|
908
|
+
|
|
909
|
+
# ⑤ 发布(只 push 不发布 = 线上还是旧的)
|
|
910
|
+
npx -y @wkgeo/cli@latest publish --confirm --json
|
|
911
|
+
```
|
|
912
|
+
|
|
913
|
+
| 情形 | 真实含义 | 对用户怎么说 |
|
|
914
|
+
|---|---|---|
|
|
915
|
+
| `error.kind = "confirm_required"`(exit 2) | 没加 `--confirm`,**一个写请求都没发** | 把计划念给他(新增 N / 改动 N),确认后再加 `--confirm` |
|
|
916
|
+
| `error.kind = "push_failed"` | 有文件写失败(`error.details.failed[]` 有路径与原因) | 报「第几个文件 + 哪个文件 + 什么原因」,别念文件内容 |
|
|
917
|
+
| 计划里 `removed[]` 非空 | 本地删了、远端还在(`--prune` 才列进 `willDelete`) | 说明服务端**没有删模板文件的动作**,要删只能在 CMS 里删 |
|
|
918
|
+
| 某个 `assets/*.png\|woff2` 被标成写不进去 | 服务端只收 `.html/.css/.js/.json` | 让他改走 `assets upload`,不要硬塞进 `templateFileSave` |
|
|
919
|
+
| 报「这个目录是从**别的站**拉的」 | `manifest.siteId` ≠ 当前选中的站,**一个请求都没发** | 让他先 `site use <manifest 里那个站>`(或加 `--site`)再 push |
|
|
920
|
+
|
|
921
|
+
**铁律(模板面)**:① **`--dry-run` 先看**,`--confirm` 才写;② 不要手工改 `template-manifest.json`
|
|
922
|
+
(push 靠它对账 `templateId` 与 sha256,改了会拉到错的那套或算错差异);③ push 完**别忘 `publish --confirm`**;
|
|
923
|
+
④ 同一套模板**不要两个人同时 push**(服务端是逐文件覆盖,后写的赢,没有合并/锁)。
|
|
924
|
+
|
|
925
|
+
|
|
847
926
|
### 7.6 用户说"让我本机的大模型看看这个站"
|
|
848
927
|
|
|
849
928
|
**CLI 可以接本地大模型,详见 [`../docs/CLI-本地大模型接入.md`](../docs/CLI-本地大模型接入.md)。**
|
|
@@ -873,7 +952,7 @@ npx -y @wkgeo/cli@latest context export --format md --out ./site-context.md --si
|
|
|
873
952
|
5. **不要发起真实扣款**:`login`/`wallet recharge` 只创建订单/链接;
|
|
874
953
|
所有"付款"都必须由用户在**我们网站的收银台页面**用微信完成。自动化测试里**绝不**走真钱路径。
|
|
875
954
|
6. **收银台是我们自己的页面**:`wallet recharge` 的正确交接物是 `pay_url`
|
|
876
|
-
(`https://pay.wkgeo.
|
|
955
|
+
(`https://pay.wkgeo.cn/?order_id=…`),不是 `code_url`。
|
|
877
956
|
不要在本地自己画一个二维码页面让用户扫 —— 那是被明确否掉的做法。
|
|
878
957
|
7. **限流是保护,不是故障**:429 时按 `retry_after` 退避;**不要**用重新登录或换令牌来"绕过"限流。
|
|
879
958
|
8. 遇到 `client_secret`、`authorization_code`、`access_token` 之类的字段:
|
|
@@ -895,7 +974,9 @@ npx -y @wkgeo/cli@latest context export --format md --out ./site-context.md --si
|
|
|
895
974
|
| `login --device-continue` 报 `kind:"expired"` | 短码过期(默认 10 分钟)或已被换过票 | 重新 `login --device --no-wait` 申请新短码;**别**反复续跑 |
|
|
896
975
|
| 下单直接返回 `paid:true` | 服务端设计:下单时余额足够就直接扣款并履约 | 这是正常的"钱包支付";用 `wallet` 复核余额 |
|
|
897
976
|
| `sites create` 报 400 参数错误 | 客户层已删,归属无需指定;400 只剩参数问题(名称/区域等) | 按错误提示补参数 |
|
|
898
|
-
| `sites create`
|
|
977
|
+
| `sites create` 报 409「该区域名额已满(系统正在自动扩容)」 | 该区域池位满(`POOL_EXHAUSTED`);服务端可能已先插了一行 draft 再失败 | 换区再建:`--region overseas`(intl.wkgeo.com.cn)或 `--region global`;别原地重试同一区 |
|
|
978
|
+
| `sites create --template` 报「模板市场里没有…」exit 2 | `--template` 只认模板市场已有 key(内置如 `classic-blue` 默认模板 / `warm-amber`) | 按报错 hint 里的现有 key 重填;不想装模板就去掉 `--template`(空站) |
|
|
979
|
+
| 短域访问 403/404 且 `sites get` 里 `prefix_kv_written:false` | 短域没写进 KV;CLI **没有** `domain repair` 命令(后端也无等价 OAuth 动作) | **别撒谎说"能访问"**:如实告诉用户短域暂不可用,用 `sites get <站点ID>` 复核 `prefix_host` / `prefix_kv_written`;`null` = 旧接口没回这个字段,让用户直接打开短域试 |
|
|
899
980
|
| `domain bind` 回 exit 1 +「域名开通通道暂不可用(平台侧未开),本次未写入,可直接重试」 | 上游 `wkgeo-domain` 的内部通道没开(部署侧 `DOMAIN_INTERNAL_CHANNEL_ENABLED=false`)⇒ 服务端 503 | **如实说"没绑上、没写入"**,别当成成功;平台开通后**直接重跑同一条命令**(`domain bind` 幂等),也可以先用 `domain status` 看现状 |
|
|
900
981
|
| `domain bind` 回 `platform_owned_domain`(exit 3) | 想绑平台自有域名(`wkgeo.com` 等) | 换用户自己的域名;平台自有域只有超管后台能配,别找绕过 |
|
|
901
982
|
| `domain bind` 回 `domain_already_bound`(exit 1) | 站点已绑了**别的**域名 | 换域要先去会员中心解绑(短信二次验证,CLI 不支持);不要反复重试 bind |
|
package/lib/args.mjs
CHANGED
|
@@ -21,10 +21,10 @@ import { UsageError } from './errors.mjs';
|
|
|
21
21
|
export const GLOBAL_FLAGS = {
|
|
22
22
|
base: { type: 'string', desc: 'API 基址(默认线上网关,可用 WKONGAI_BASE 覆盖)' },
|
|
23
23
|
/**
|
|
24
|
-
* CMS 面是**另一个云函数 / 另一个域名**(新写法 `https://api.wkgeo.
|
|
24
|
+
* CMS 面是**另一个云函数 / 另一个域名**(新写法 `https://api.wkgeo.cn/cms`),
|
|
25
25
|
* 所以单独给一个基址开关:联调 / 换环境时不用去改平台面的 `--base`。
|
|
26
26
|
*/
|
|
27
|
-
'cms-base': { type: 'string', desc: 'CMS 接口基址(默认 https://api.wkgeo.
|
|
27
|
+
'cms-base': { type: 'string', desc: 'CMS 接口基址(默认 https://api.wkgeo.cn/cms,可用 WKONGAI_CMS_BASE 覆盖)' },
|
|
28
28
|
'web-base': { type: 'string', desc: '前端基址(授权页兜底地址)' },
|
|
29
29
|
'client-id': { type: 'string', desc: 'OAuth 客户端 id(默认 wkgeo-cli)' },
|
|
30
30
|
scope: { type: 'string', desc: '申请的能力范围(空格分隔)' },
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 素材角色(task-46):一份文件到底是「图片 / 站点样式 / 站点脚本 / 其它附件」。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么要有 role
|
|
5
|
+
* 老口径靠「显示名」去重(`manifest-apply` 第二次 apply 按 name 认领已有素材),
|
|
6
|
+
* 于是同一份 `site.css` 在 manifest 里既当站点样式、又被人顺手当附件挂上时,
|
|
7
|
+
* 只能靠改名字绕开;反过来同一个文件换两个 key 声明,又会各传一遍。
|
|
8
|
+
* 新口径:**去重键 = `(sha256, role)`** ——
|
|
9
|
+
* * 同一份文件 + 同一个 role,换 key 声明 → 合并成一条素材(旧 key 记成 `aliases`);
|
|
10
|
+
* * 同一份文件 + 不同 role(比如既当 css 又当 image)→ 各登记一次,互不串。
|
|
11
|
+
*
|
|
12
|
+
* ## 和素材库的关系
|
|
13
|
+
* 服务端 `assetSign` / `assetRegister`(`aliyun/fc/wkgeo-cli-fc/src/asset-core.js`)目前
|
|
14
|
+
* **没有** role 列,也没收 role 参数(多传的字段会被静默忽略,不会报错)。所以 role 现在是
|
|
15
|
+
* **CLI 侧口径**:负责解析、校验、去重、透传;等服务端补 `asset.role` 列 + 入参后才真正落库。
|
|
16
|
+
* CLI 只透传、不猜服务端行为 —— 服务端哪天收了下限也不用改这边。
|
|
17
|
+
*/
|
|
18
|
+
|
|
19
|
+
/** 角色封闭取值;顺序即报错文案里的顺序 */
|
|
20
|
+
export const ASSET_ROLES = ['image', 'css', 'js', 'file'];
|
|
21
|
+
|
|
22
|
+
/** 按扩展名推断默认角色(显式给了 `role` 就听显式的) */
|
|
23
|
+
const ROLE_BY_EXT = Object.freeze({
|
|
24
|
+
css: 'css',
|
|
25
|
+
js: 'js',
|
|
26
|
+
mjs: 'js',
|
|
27
|
+
png: 'image',
|
|
28
|
+
jpg: 'image',
|
|
29
|
+
jpeg: 'image',
|
|
30
|
+
gif: 'image',
|
|
31
|
+
webp: 'image',
|
|
32
|
+
avif: 'image',
|
|
33
|
+
svg: 'image',
|
|
34
|
+
bmp: 'image',
|
|
35
|
+
ico: 'image',
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
/** 角色说明(报错 / 帮助文案共用一份,别两处各写一套) */
|
|
39
|
+
export const ASSET_ROLE_HINT = 'image(图片)/ css(站点样式)/ js(站点脚本)/ file(其它附件)';
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* 按路径扩展名推断角色。
|
|
43
|
+
* @param {string} relPath 本地相对路径(如 `assets/site.css`)
|
|
44
|
+
* @returns {'image'|'css'|'js'|'file'}
|
|
45
|
+
*/
|
|
46
|
+
export function inferAssetRole(relPath) {
|
|
47
|
+
const m = String(relPath == null ? '' : relPath)
|
|
48
|
+
.toLowerCase()
|
|
49
|
+
.match(/\.([a-z0-9]+)$/);
|
|
50
|
+
return (m && ROLE_BY_EXT[m[1]]) || 'file';
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* 归一 role:显式值优先(小写 + trim),否则按扩展名推断。
|
|
55
|
+
* @param {unknown} raw manifest / 命令行给的 role
|
|
56
|
+
* @param {string} relPath 用来推断的路径
|
|
57
|
+
* @returns {{role:string, error:string}} `error` 非空表示显式 role 不认识
|
|
58
|
+
*/
|
|
59
|
+
export function normalizeAssetRole(raw, relPath) {
|
|
60
|
+
const given = String(raw == null ? '' : raw)
|
|
61
|
+
.trim()
|
|
62
|
+
.toLowerCase();
|
|
63
|
+
if (!given) return { role: inferAssetRole(relPath), error: '' };
|
|
64
|
+
if (!ASSET_ROLES.includes(given)) {
|
|
65
|
+
return { role: inferAssetRole(relPath), error: `role 只能是 ${ASSET_ROLES.join(' / ')},收到 "${given}"` };
|
|
66
|
+
}
|
|
67
|
+
return { role: given, error: '' };
|
|
68
|
+
}
|
package/lib/cms.mjs
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* ## 接口形态(照 `aliyun/fc/wkgeo-cms/src/index.js` 的动作表,别自己编)
|
|
5
5
|
* `POST {CMS_BASE}/<action>`,JSON body,响应统一信封 `{code, message, data}`,
|
|
6
6
|
* `code === 0` 才算成功 —— 与 `/api/data` 完全同一套约定。
|
|
7
|
-
* `CMS_BASE` 默认 `https://api.wkgeo.
|
|
7
|
+
* `CMS_BASE` 默认 `https://api.wkgeo.cn/cms`(`--cms-base` / `WKONGAI_CMS_BASE` 可覆盖),
|
|
8
8
|
* 动作名就是动作表的键(`categoryList` / `contentSave` / `templateGet` …),**URL 最后一段就是动作名**:
|
|
9
9
|
* 云函数支持"从路径取动作"(`actionFromPath`),所以 `/api/cms/categoryList` 与
|
|
10
10
|
* `body.action = 'categoryList'` 等价;这里用路径写法,身体里只放业务参数(干净、可读)。
|
|
@@ -114,7 +114,7 @@ function cmsUnavailableError(action, res) {
|
|
|
114
114
|
kind: 'cms_unavailable',
|
|
115
115
|
code: status || null,
|
|
116
116
|
hint:
|
|
117
|
-
'检查 `wkgeo config` 里的 CMS 基址(默认 `https://api.wkgeo.
|
|
117
|
+
'检查 `wkgeo config` 里的 CMS 基址(默认 `https://api.wkgeo.cn/cms`,' +
|
|
118
118
|
'可用 `--cms-base` / `WKONGAI_CMS_BASE` 临时切换);若地址没错,多半是云函数 `cms` 还没部署。',
|
|
119
119
|
});
|
|
120
120
|
}
|
package/lib/commands/billing.mjs
CHANGED
|
@@ -19,11 +19,52 @@ import { formatMoney, formatTime } from '../format.mjs';
|
|
|
19
19
|
import { openUrlForUser, browserPasteText, browserOpenedText, browserFailedHintLines, detectNonInteractive, nonInteractiveBrowserHintLines } from '../login.mjs';
|
|
20
20
|
import { renderQrOptional } from '../qr.mjs';
|
|
21
21
|
|
|
22
|
+
/**
|
|
23
|
+
* 按 `#` / `?` 把地址切成 `{ head, query, hash }`。
|
|
24
|
+
* hash 里也可能有 `?`(`#/overview?x=1`),所以必须先切 hash 再找 query。
|
|
25
|
+
*/
|
|
26
|
+
function splitUrl(raw) {
|
|
27
|
+
const s = String(raw == null ? '' : raw);
|
|
28
|
+
const hashAt = s.indexOf('#');
|
|
29
|
+
const hash = hashAt >= 0 ? s.slice(hashAt) : '';
|
|
30
|
+
const beforeHash = hashAt >= 0 ? s.slice(0, hashAt) : s;
|
|
31
|
+
const qAt = beforeHash.indexOf('?');
|
|
32
|
+
return {
|
|
33
|
+
head: qAt >= 0 ? beforeHash.slice(0, qAt) : beforeHash,
|
|
34
|
+
query: qAt >= 0 ? beforeHash.slice(qAt + 1) : '',
|
|
35
|
+
hash,
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* 往地址里追加查询参数 —— **本文件唯一的"追加 query"实现**。
|
|
41
|
+
*
|
|
42
|
+
* 为什么要有它(2026-11-01 线上日志里抓到一大片「query 被拼两遍」):
|
|
43
|
+
* `base + '?' + query` 这种写法遇到**已经带 query 的基址**就会产出
|
|
44
|
+
* `...?from=wx?order_id=…` —— 整段 query 被 `?` 再拼一次,参数作废。
|
|
45
|
+
* 这里一律先用 `URLSearchParams` 解析已有 query,再 `set()` 合并:
|
|
46
|
+
* * 一个地址里**只有 1 个 `?`**;
|
|
47
|
+
* * **同名参数只留一份**(新值覆盖旧值),不会累积成 `?a=1?a=2`;
|
|
48
|
+
* * 基址原有的其它参数原样保留;
|
|
49
|
+
* * 值统一过编码(订单号 / 凭证里的特殊字符不会把后面的参数吃掉)。
|
|
50
|
+
*
|
|
51
|
+
* @param {string} target 可能已带 query(甚至已带尾斜杠)的地址
|
|
52
|
+
* @param {Record<string, string>} params 要合并进去的参数
|
|
53
|
+
* @returns {string}
|
|
54
|
+
*/
|
|
55
|
+
function mergeQuery(target, params) {
|
|
56
|
+
const { head, query, hash } = splitUrl(target);
|
|
57
|
+
const sp = new URLSearchParams(query);
|
|
58
|
+
for (const [k, v] of Object.entries(params)) sp.set(k, v);
|
|
59
|
+
const qs = sp.toString();
|
|
60
|
+
return `${head}${qs ? `?${qs}` : ''}${hash}`;
|
|
61
|
+
}
|
|
62
|
+
|
|
22
63
|
/**
|
|
23
64
|
* 拼出「我们自己的网上收银台」地址:`<webBase>/?order_id=<id>&token=<支付令牌>`
|
|
24
65
|
*
|
|
25
66
|
* ★ 2026-10-02(第二次拍板):收银台站去掉了冗余的 `/pay` 前缀 —— **收银台就是站根 `/`**
|
|
26
|
-
* (`https://pay.wkgeo.
|
|
67
|
+
* (`https://pay.wkgeo.cn/?order_id=…`,原来是 `…/?order_id=…`)。
|
|
27
68
|
*
|
|
28
69
|
* ## 为什么必须走这里、不许在命令里手拼
|
|
29
70
|
*
|
|
@@ -57,7 +98,7 @@ import { renderQrOptional } from '../qr.mjs';
|
|
|
57
98
|
* 行为与改造前逐字一致(不因为"新功能没上线"就把命令搞失败)。
|
|
58
99
|
*
|
|
59
100
|
* @param {string} webBase 前端基址。★ 2026-10-02 起传的是 `config.payWebBase`
|
|
60
|
-
* (`https://pay.wkgeo.
|
|
101
|
+
* (`https://pay.wkgeo.cn`),老站基址只是兜底
|
|
61
102
|
* @param {string} orderId 订单号
|
|
62
103
|
* @param {string} [payToken] 订单支付令牌(`pay_token`),没有就不带这个参数
|
|
63
104
|
* @returns {string|null} 订单号缺失时返回 null(没订单号就拼不出能用的收银台地址)
|
|
@@ -70,13 +111,14 @@ export function buildPayUrl(webBase, orderId, payToken) {
|
|
|
70
111
|
const token =
|
|
71
112
|
payToken === undefined || payToken === null ? '' : String(payToken).trim();
|
|
72
113
|
if (token) params.token = token;
|
|
73
|
-
const query = new URLSearchParams(params).toString();
|
|
74
114
|
// ★ 2026-10-02(第二次拍板):收银台站去掉冗余的 `/pay` 前缀 —— **收银台就是站根 `/`**
|
|
75
|
-
// (原来是 `${base}/pay`)。`withTrailingSlash('https://pay.wkgeo.
|
|
76
|
-
// `https://pay.wkgeo.
|
|
115
|
+
// (原来是 `${base}/pay`)。`withTrailingSlash('https://pay.wkgeo.cn')` 补出
|
|
116
|
+
// `https://pay.wkgeo.cn/`,正好是收银台首页;尾斜杠在 `?` 之前这条规矩也仍然成立。
|
|
77
117
|
// ⚠️ 站根是桶里真实存在的 `index.html`(不是"目录路径"),不会再触发
|
|
78
118
|
// 下面第 1 条那个"目录 302 丢 query"的坑。
|
|
79
|
-
|
|
119
|
+
// ★ 2026-11-03(task-60):改走 mergeQuery —— 基址若自带 query(如 `?from=wx`),
|
|
120
|
+
// 旧写法 `withTrailingSlash(base) + '?' + query` 会拼出 `?from=wx?order_id=…`。
|
|
121
|
+
return mergeQuery(withTrailingSlash(base), params);
|
|
80
122
|
}
|
|
81
123
|
|
|
82
124
|
/**
|
|
@@ -104,11 +146,15 @@ export function buildPayUrl(webBase, orderId, payToken) {
|
|
|
104
146
|
export function buildRechargeTicketUrl(webBase, ticket) {
|
|
105
147
|
const t = ticket === undefined || ticket === null ? '' : String(ticket).trim();
|
|
106
148
|
if (!t) return null;
|
|
107
|
-
|
|
108
|
-
const
|
|
149
|
+
// 基址只取**路径部分**:`?from=wx` 这类收银台参数不该被带到充值页上。
|
|
150
|
+
const { head } = splitUrl(String(webBase || '').replace(/\/+$/, ''));
|
|
109
151
|
// `/recharge` 是收银台站上的一级路径(构建期由 `SITES.pay.rewritePaths` 把
|
|
110
152
|
// `/pay/recharge` 改写成 `/recharge`;子域已说明是哪个站,路径不再重复 `/pay`)。
|
|
111
|
-
|
|
153
|
+
// ★ 2026-11-03(task-60):改走 mergeQuery,基址带 query 时不再拼出第二个 `?`
|
|
154
|
+
// (旧写法会把路径拼到 query 后面:`?from=wx/recharge?ticket=…`)。
|
|
155
|
+
// 基址已经是 `/recharge`(重试链路把上一次的产物又传进来)时不再叠一层路径。
|
|
156
|
+
const path = /\/recharge\/?$/.test(head) ? head : `${head}/recharge`;
|
|
157
|
+
return mergeQuery(withTrailingSlash(path), { ticket: t });
|
|
112
158
|
}
|
|
113
159
|
|
|
114
160
|
const KIND_LABEL = {
|
|
@@ -319,7 +365,7 @@ export const walletRechargeCommand = {
|
|
|
319
365
|
* ⚠️ 老服务端没这个字段时就是 `undefined` ⇒ 地址退回只有 `order_id` 的老形态。
|
|
320
366
|
*
|
|
321
367
|
* ★ 2026-10-02(三站拆分):基址改用**收银台子域** `config.payWebBase`
|
|
322
|
-
* (`https://pay.wkgeo.
|
|
368
|
+
* (`https://pay.wkgeo.cn`)。`config.webBase` 只作为老配置对象的兜底
|
|
323
369
|
* (联调时 `WKONGAI_WEB_BASE` 总覆盖会把两者设成同一个值)。
|
|
324
370
|
*/
|
|
325
371
|
const payUrl = buildPayUrl(
|