@wkgeo/cli 1.1.2 → 1.1.4

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,46 @@
4
4
 
5
5
  ---
6
6
 
7
+ ## 未发布 · 2026-11-10
8
+
9
+ **新增 `data` 命令组(数据交换,全部只读)**:`wkgeo data chat|stats|usage`。
10
+
11
+ - `data chat`:AI 客服会话 / 单会话消息(`/aikefu`,读 MaxKB 只读库);`--from/--to`(北京自然日)、
12
+ `--channel`(MaxKB `chat_user_type`)、`--chat <会话ID>`(消息分页)、`--page/--limit`;
13
+ 问答正文默认 `maskPii` 脱敏、IP 只给掩码(`--raw` 才原文;`--out` 落盘跟随当前模式)。
14
+ - `data stats`:按日 PV / UV / IP 唯一数 + Top 页面 / 来源(`/analytics` 新增只读动作 `statRange`,
15
+ 支持任意日期区间 ≤366 天;`totals` 整段去重、`days[]` 逐日去重)。
16
+ - `data usage`:按日 / 模型 / 站点的大模型请求数、token、费用(`/admin` 的 `llmCostSummary`);
17
+ **令牌 scope 需含 `llm:cost_read`**,缺了 exit 3 并打印精确重授权命令。
18
+ - 统一:`--site <ID|域名>`(域名/短域/站名在本地用 `listSites` 换 ID,`www.` 互认)、`--from/--to`、
19
+ `--json|--text`、`--out <file.csv|file.json>`(CSV 带 UTF-8 BOM)。
20
+ - `/analytics` `/aikefu` 补 **CLI Bearer 只读通道**(只放行 `access:'read'`,写动作进 handler 前 403;
21
+ Cookie 通道行为不变);`/admin` 作为只读前缀登记(不改既有路由)。
22
+
23
+ **修复线上 P1**:`wkgeo-cli-fc` 是网关签名目标,`Authorization` 会被 ACS3 覆盖,而它以前只读
24
+ `authorization` 头 ⇒ 所有 `/cli` 动作 401(`wkgeo sites list` 都跑不了)。改走共享件
25
+ `_shared/client-authorization.js` 的 ACS3-gated 还原后恢复。
26
+
27
+ ---
28
+
29
+ ## 1.1.3 · 2026-11-09
30
+
31
+ **`wkgeo publish` 拦「站点没有自有域名」**(2026-11-09,与 CMS 后台发布按钮同口径):站点唯一地址是平台
32
+ 预览地址(`<slug>.site.wkgeo.cn`,动态实时渲染,内容改完立刻就是最新),静态发布产物只服务客户自有域名 ——
33
+ 所以没绑域名时 `publish` / `publish retry`(**含 dry-run**)**直接拒绝**(exit 1)并提示
34
+ 「当前站点使用平台预览地址,内容实时生效,无需发布;请绑定自有域名后再发布」,**一个发布请求都不发**。
35
+
36
+ - 判据同 CMS `siteCustomDomainState`:`site_domain` 里 `verify_status='verified'`(custom > root > other)
37
+ → 回落 `custom_domain` / `domain`;`--json` 的 `error.details = { reason:'no-custom-domain', hasCustomDomain:false }`;
38
+ - 读不到域名状态时 **fail-open 放行**(与 CMS 同口径,不因一次查询抖动封死发布);
39
+ - `--cancel` / `publish status` / 推送类动作不受影响;服务端 `wkgeo-cli-fc` 也加了同一条 409 闸门。
40
+
41
+ **常量收敛**:新增 `cli/lib/hosts.mjs`(CLI 侧**唯一**的平台域名出处)—— `DEFAULT_OAUTH_WEB_BASE` /
42
+ `DEFAULT_USER_WEB_BASE` / CMS 预览地址 / manifest `$id` / 模板抓取 UA 全部由它派生;
43
+ 再换域(`.com` → `.cn` 这类)只改 `PLATFORM_DOMAIN` 一行。
44
+
45
+ ---
46
+
7
47
  ## 1.1.2 · 2026-11-09
8
48
 
9
49
  **`--open-browser` / `WKONGAI_OPEN_BROWSER=1` 可压过「非交互」判定**:AI 子进程 / 管道 / CI 里只要显式要求,
package/README.md CHANGED
@@ -87,7 +87,7 @@ cd cli && node scripts/build-exe.mjs --sea # 跑 Node SEA 的离线两步(
87
87
 
88
88
  ### 版本与升级策略
89
89
 
90
- * 当前版本 **`1.0.0`**(`cli/package.json`,**2026-10-30 已发布到 npm 组织 `@wkgeo`**):在 0.6.0 之上把后台**整块搬进 CLI** —— 内容 45 / 素材 18 / 发布 16 / 配置类 auth 11 / 站点 7 / 插件 9 / 控制台 8 七批动作全部由自持云函数 `wkgeo-cli-fc` 进程内执行(不再借 `/cms` 会话转发,因而计入 `cli_action_usage`),**`whoami.action_total` 150 → 185**,新增 / 补齐 `assets`、`publish`、`site info`、`plugins`、`config`、`logs`、`overview`、`lang`/`role`/`member` 命令组;上一个版本 **`0.6.0`**(2026-10-28:`/cli` 收口 + `auth` 命令组 + `domain bind` + 域名成交链路);更早的补丁版 **`0.5.1`**(2026-10-26:修 0.5.0 的 `publish --confirm` 轮询崩溃 `ctx.sleep is not a function`)。
90
+ * 当前版本 **`1.1.3`**(`cli/package.json`,**2026-11-09 已发布到 npm 组织 `@wkgeo`**;1.1.0–1.1.3 是增量补丁,逐版明细见 [`CHANGELOG.md`](./CHANGELOG.md));**`1.0.0`**(2026-10-30)在 0.6.0 之上把后台**整块搬进 CLI** —— 内容 45 / 素材 18 / 发布 16 / 配置类 auth 11 / 站点 7 / 插件 9 / 控制台 8 七批动作全部由自持云函数 `wkgeo-cli-fc` 进程内执行(不再借 `/cms` 会话转发,因而计入 `cli_action_usage`),**`whoami.action_total` 150 → 185**,新增 / 补齐 `assets`、`publish`、`site info`、`plugins`、`config`、`logs`、`overview`、`lang`/`role`/`member` 命令组;上一个版本 **`0.6.0`**(2026-10-28:`/cli` 收口 + `auth` 命令组 + `domain bind` + 域名成交链路);更早的补丁版 **`0.5.1`**(2026-10-26:修 0.5.0 的 `publish --confirm` 轮询崩溃 `ctx.sleep is not a function`)。
91
91
  * **本版只加命令、不改契约**:原有命令 / 参数 / `--json` 信封 / 退出码与 0.6.0 完全一致,AI 端继续用 `npx -y @wkgeo/cli@latest` 即可;逐批明细与已知缺口见 [`CHANGELOG.md`](./CHANGELOG.md) 顶部「1.0.0」。
92
92
  * **同一个版本号不能覆盖**:改了代码必须 `npm version patch|minor|major` 再发布。
93
93
  * AI 端统一用 **`npx -y @wkgeo/cli@latest`** → 每次自动拿最新版;
@@ -99,6 +99,7 @@ cd cli && node scripts/build-exe.mjs --sea # 跑 Node SEA 的离线两步(
99
99
 
100
100
  | 版本 | 日期 | 变更 |
101
101
  | --- | --- | --- |
102
+ | **1.1.3** | 2026-11-09 | **`publish` / `publish retry`(含 dry-run)在站点没有客户自有域名时直接拒绝**(exit 1,一个发布请求都不发),提示「当前站点使用平台预览地址,内容实时生效,无需发布;请绑定自有域名后再发布」;判据同 CMS 后台(`site_domain` verified → 回落 `custom_domain`/`domain`),读不到域名状态 fail-open;`--cancel` / `publish status` 不受影响。服务端 `wkgeo-cli-fc` 同批加 `409 no-custom-domain` 兜底。另新增 `lib/hosts.mjs`(CLI 侧唯一平台域名源,12 处域名收口到常量),1.1.1 的 `.com`→`.cn` 默认值也由它派生 |
102
103
  | **1.0.0** | 2026-10-30 | **本版是 scoped 新包**:包名 `@wkgeo/cli`(npm 组织 `@wkgeo`),命令 / 参数 / `--json` 信封 / 退出码与旧包最后一版完全一致;`license` 改 MIT、随包附 `LICENSE`、`engines.node` 为 `>=18`。以下是本版带来的动作面: **七批后台动作全量进自持面(动作面 150 → 185)**。① **插件类 9 条**(task-91 / B5):`plugins` 从 2 条扩到 **9 条**(`list` / `access` / `toggle` / `settings` / `market-list` / `install` / `uninstall` / `upgrade` / `demo`),全部由 `wkgeo-cli-fc/src/plugin-core.js`(逐字复制 CMS handler,生成器拼装)执行,**不再借 `/cms` 转发**,因此进 `cli_action_usage` 计数;权限:4 条读 `site:read`,5 条写 `site:write`(服务端另校验 `site.owner_id`:他人站 403 `not_site_owner`,站名/业主一概不回);写命令一律**默认 dry-run**,`--confirm` 才真发;**9 条全迁、无不迁条目**(`pluginMarketDemo` 只读库里 `demo_url`,不下载外链)。② **站点类 7 条**(task-90 / B4):新增 `site info`、`site info save`、`site domain-recheck`、`site demo-seed`、`site demo-clear`、`site sync`,并把 `domain inspection` 从 `/cms` 切到 `/cli` 的 `cmsSiteDomainInspectionList`;**不迁** `cmsCreateSite`(`site create` 已是原生动作,迁会双写 `site` / `cms_site_member`)与 `cmsSiteDomainCheck`(`domain check` 已走原生 `siteDomainCheck`)。③ **控制台类 8 条**(task-92 / B7):新增 `logs list`、`config get\|save\|review\|capabilities`、`overview summary\|traffic\|dashboard`;平台管理员判定改成真查库(`isPlatformAdminUser`)⇒ `traffic` / `dashboard` 的平台门禁照样成立;6 条只读**不写审计**,只有 `configSave` / `configReview` 落 `admin_audit_log`;`configReview` 另带 `x-review-token` 双闸(未配 `REVIEW_TOKEN` 回 503)。动作面推进:**150(0.6.0)→ 168(B4)→ 177(B5)→ 185(B7)**;域名级 DNS 凭据 4 条按后端口径不计入(`auth status` 单列 `uncounted_self_hosted`),`/cli` 可见动作实际 189 = 185 + 4。 |
103
104
  | **0.6.0** | 2026-10-28 | **CLI 收口到自己的云函数 `wkgeo-cli-fc`(网关 `/cli`)**。① 业务面从 `/user` `/order` `/domain` 收敛到 `/cli`(`WKONGAI_LEGACY_ENDPOINTS=1` 才走老路径),动作面 **150 条**(原生 + 自持重建 + 金融面白名单转发)。② 新增 **`auth` 命令组**:`auth status`(`cliWhoami`:账号 / `client_id` / `scopes` / 到期 / 动作面体检)、`auth token`(只给前 4 位 + 长度 + 到期)、`auth revoke`(`POST /api/oauth/revoke` + 删本地)。③ 新增 **`domain bind`**(原生 `cliProvisionSiteDomain`;平台通道没开时上游 503 → 明确「本次未写入,可直接重试」+ exit 1)。④ 新增 `sites get`、`domain status\|records\|dns\|check\|remind`(只读)、`sites list --with-prefix`、`sites create --channel auto\|platform\|cms`。⑤ 新增建站端到端脚本 `cli/scripts/e2e-site.mjs`(建站 → 校验短域 → 可选绑域 → 发布 → 盯首页 200 + 指纹;**默认不删站**、真建站需 `--confirm`)。**令牌模型不变**(OAuth access_token,30 天)。 |
104
105
  | **0.5.1** | 2026-10-26 | **修 `publish --confirm` 崩在轮询**。0.5.0 在**发布已经提交成功之后**抛 `{"kind":"internal","message":"ctx.sleep is not a function"}`(exit 1):`lib/cli.mjs` 逐字透传 `sleep: io.sleep`,而生产入口 `wkgeo.mjs` 调 `run(argv)` 不传 `io`,`undefined` 覆盖了默认值;`lib/runtime.mjs` 的 `sleep` 默认值本身也是 `undefined`。修法:**所有可选注入项在 runtime 层落地默认实现**(`sleep`/`now`/`random`/`log`/`clock`/`fetchImpl` 等,非法值一律归一化),`cli.mjs` 只透传真的给了的注入项(`undefined` 不出现,`false`/`0` 保留)。新增 8 条回归(含「不传 io 的 publish --confirm 端到端」)。**命令、参数、`--json` 信封、退出码全部不变**。 |
@@ -444,7 +445,7 @@ wkgeo login --device-continue --json
444
445
  | `templates save` | 新建/覆盖模板文件(html/css/js,≤40 万字符;可用 `assets/site.css` 这种子目录路径) | `<文件名.html\|css\|js>` + `--file <本地文件>` 或 `--content <源码>` |
445
446
  | `templates pull` | **把整套模板拉到本地目录**(按模板内相对路径落盘 + 生成 `template-manifest.json` 记 sha256;二进制按 base64 还原成真文件) | `--dir`(必填)、`--template <key\|id>`、`--force`、`--site` |
446
447
  | `templates push` | **把本地改动推回线上模板**(逐文件比 sha256;**默认只算计划、零写请求**,`--confirm` 才写;默认不删远端) | `--dir`(必填)、`--dry-run`、`--confirm`、`--prune`、`--site` |
447
- | `publish` | **发布站点**(0.5.0 起接真后端):默认 **dry-run**,只读算出会发多少页;`--confirm` 才 `cmsSitePublishStart` 并轮询 `cmsSitePublishStatus` 到终态,打印 `total/done/pagesFailed/finalizeOk` | `--site`、`--confirm`、`--cancel`、`--no-wait`、`--job <任务ID>`、`--interval`、`--wait-timeout` |
448
+ | `publish` | **发布站点**(0.5.0 起接真后端):默认 **dry-run**,只读算出会发多少页;`--confirm` 才 `cmsSitePublishStart` 并轮询 `cmsSitePublishStatus` 到终态,打印 `total/done/pagesFailed/finalizeOk`。**站点没有客户自有域名时直接拒绝**(1.1.3 起,dry-run 也拦,exit 1,一个发布请求都不发):平台预览地址 `<slug>.site.wkgeo.cn` 是动态实时渲染,内容改完即时生效,绑定域名后再发 | `--site`、`--confirm`、`--cancel`、`--no-wait`、`--job <任务ID>`、`--interval`、`--wait-timeout` |
448
449
  | `publish status` | 只看发布任务状态(只读、不触发发布) | `--site`、`--job` |
449
450
  | `publish cancel` | 取消该站正在跑的发布任务(等同 `publish --cancel`) | `--site`、`--job` |
450
451
  | `lang list` | 站点语言列表(代码 / 名称 / 是否默认 / 是否启用;需要 `site:read`) | `--site` |
@@ -797,6 +798,67 @@ wkgeo overview dashboard # 数据看板快照(存储 / 流量
797
798
 
798
799
  > AI 类命令(`aiLogList` 等 7 条)后台功能还没做完(老板 2026-10-29),本批**没有**迁、CLI 也**不提供**对应子命令 —— 别在脚本里当它存在。
799
800
 
801
+ ### 数据交换命令(`data chat|stats|usage`,2026-11-10 老板单)
802
+
803
+ 老板要的「数据交换」第一块:**本地 CLI 能拿到三类只读数据**,默认表格、`--json` 给稳定结构、
804
+ `--out` 落 CSV / JSON 给下游交换。三条命令全部**只读**,没有任何 `--confirm` 写动作。
805
+
806
+ ```bash
807
+ # ① AI 客服会话 / 消息(数据在 MaxKB,服务端按本站 application_id 强制过滤)
808
+ wkgeo data chat # 会话列表(最新在前;默认不限日期)
809
+ wkgeo data chat --from 2026-11-01 --to 2026-11-10 # 按日期筛(北京自然日,闭区间)
810
+ wkgeo data chat --channel ANONYMOUS_USER # 按渠道筛(MaxKB chat_user_type)
811
+ wkgeo data chat --chat <会话ID> --limit 50 # 单会话消息(按对话顺序;分页)
812
+ wkgeo data chat --out chat.csv # 落 CSV(正文仍是脱敏后的)
813
+
814
+ # ② 访问统计(按日 PV / UV / IP 唯一数 + Top 页面 / 来源)
815
+ wkgeo data stats # 默认最近 7 天(含今天)
816
+ wkgeo data stats --from 2026-11-01 --to 2026-11-10 --top 20
817
+ wkgeo data stats --out stats.json # 完整结构(含 days / top_pages / top_referrers)
818
+
819
+ # ③ 大模型消耗(按日 / 模型 / 站点:请求数、token、费用)
820
+ wkgeo data usage # 默认最近 7 天
821
+ wkgeo data usage --model deepseek-flash --from 2026-11-01 --to 2026-11-10
822
+ wkgeo data usage --out usage.csv # CSV 落「按日」明细
823
+ ```
824
+
825
+ **统一参数**:`--site <ID|域名>`(域名/短域/站名会在本地用 `listSites` 换成 ID)、
826
+ `--from` / `--to`(`YYYY-MM-DD`,北京自然日,闭区间;`stats` / `usage` 默认最近 7 天,`chat` 默认不限)、
827
+ `--page` / `--limit`(只有 `chat` 分页)、`--json` / `--text`、`--out <file.csv|file.json>`。
828
+
829
+ **输出字段(`--json` 的 `data`,下游交换按这些键取值)**:
830
+
831
+ | 命令 | 顶层字段 | 行字段 |
832
+ |---|---|---|
833
+ | `data chat`(会话) | `site_id` `view:"sessions"` `from` `to` `channel` `page` `page_size` `total` `channels[]` `rows[]` | `chat_id` `channel` `record_count` `ip`(掩码)`started_at` `last_at` |
834
+ | `data chat --chat`(消息) | `site_id` `view:"messages"` `chat_id` `page` `page_size` `total` `rows[]` | `record_id` `chat_id` `index` `question` `answer` `message_tokens` `answer_tokens` `run_time_ms` `vote` `created_at` |
835
+ | `data stats` | `site_id` `from` `to` `timezone` `totals{pv,uv,unique_ips,visits,bots}` `days[]` `top_pages[]` `top_referrers[]` | 日:`day pv uv unique_ips visits bots`;页:`path pv uv unique_ips last_at`;来源:`domain hits uv` |
836
+ | `data usage` | `site_id` `from` `to` `days` `model` `currency:"CNY"` `total{calls,errors,prompt_tokens,completion_tokens,total_tokens,cached_tokens,cost_yuan,cost_cents}` `by_day[]` `by_model[]` `by_site[]` `by_action[]` | `day`/`model`/`site_id`+`site_name`/`biz_action`、`calls`、`total_tokens`、`cost_yuan` |
837
+
838
+ **六条口径(踩过就知道为什么写在这里)**:
839
+
840
+ 1. **正文默认脱敏**:`data chat` 的 `question` / `answer` 走 `maskPii`(手机号留 3+4、邮箱打码、IP 留前三段);
841
+ `--raw` 才原样。`--out` 落盘**同样按当前模式**脱敏 —— 红线是「不导出未脱敏 PII 到仓库」,默认就是安全的。
842
+ 2. **不提供 IP 清单**:访问统计只存不可逆 `ip_hash`(`unique_ips` 是数量),客服会话的 `ip` 只给掩码样例。
843
+ 这是隐私口径(`docs/功能-访问统计-埋点注入.md` §7),不是缺口。
844
+ 3. **区间合计 ≠ 按日相加**:`stats.totals` 是整段去重(一次 `count(distinct)`),`days[]` 是逐日去重;
845
+ 跨日把 UV/IP 相加会把人算重,所以两个口径分开给。
846
+ 4. **`data usage` 需要 scope `llm:cost_read`**(默认登录 scope 不含)。缺了会 exit 3 并打印精确的重授权命令:
847
+ ```bash
848
+ wkgeo login --scope "site:read site:write attachment:read attachment:write template:read template:write billing:self llm:cost_read"
849
+ ```
850
+ 旧令牌不会自动获得新能力;重授权后再跑即可。数据源是超管 `llmCostSummary`(`llm_usage` UNION `llm_tool_usage`),
851
+ 数据范围随身份:平台管理员看全量,普通账号只看自己名下站点。
852
+ 5. **站点身份走 CLI Bearer 只读通道**:`/analytics` / `/aikefu` 以前只认 CMS Cookie;2026-11-10 起补了
853
+ **只读** Bearer 通道(无 Cookie + 有 Bearer ⇒ 只放行 `access:'read'`,站点从 `x-cms-site` 取并复核成员关系;
854
+ 写动作在进 handler 前就 403)。浏览器 Cookie 通道行为不变。
855
+ 6. **`--site` 传域名**是本地解析(`listSites` 里按 domain / custom_domain / 短域 / 站名匹配,`www.` 互认);
856
+ 解析不到直接 exit 2 并让你改用站点 ID,**不会**把域名当 ID 丢给服务端(那只会换来一个无意义的 400)。
857
+
858
+ > 顺带修掉一个线上 P1:`wkgeo-cli-fc` 是网关签名目标,`Authorization` 会被 ACS3 覆盖,
859
+ > 而它以前只读 `authorization` 头 ⇒ **所有 `/cli` 动作 401**(`wkgeo sites list` 都跑不了)。
860
+ > 2026-11-10 起改走共享件 `_shared/client-authorization.js` 的 ACS3-gated 还原,`/cli` 恢复正常。
861
+
800
862
  ### 「钱包余额支付」到底发生在哪一步(**别被命令名骗了**)
801
863
 
802
864
  服务端 `placeOrder()` 的行为是:**下单时就先用余额抵扣**,余额够就立刻 `moveWallet(-金额)` +
@@ -1039,7 +1101,7 @@ cli/
1039
1101
  ├── scripts/
1040
1102
  │ ├── e2e-site.mjs 建站全链路端到端(建站→短域→可选绑域→发布→首页 200+指纹;**默认不删站**,真跑要 --confirm)
1041
1103
  │ ├── live-verify.mjs 真环境**可逆**端到端验证(--write 才做写操作)
1042
- │ ├── live-sql.mjs 只读 SQL 排查工具(写语句直接拒绝)
1104
+ │ ├── live-sql.mjs 只读 SQL 排查工具(写语句直接拒绝;**默认真库 RDS**,旧网关要 --channel=legacy --legacy-ok)
1043
1105
  │ ├── build-zip.mjs 打 zip(自实现 ZIP 写入,零依赖)
1044
1106
  │ └── build-exe.mjs 独立可执行方案(默认只打印,`--sea` 跑离线两步)
1045
1107
  └── docs/设备码授权-服务端最小方案.md
@@ -1054,7 +1116,7 @@ node scripts/e2e-site.mjs --confirm --pool global --keep # 真建站(**留
1054
1116
  node scripts/build-zip.mjs # 打 zip(带安全闸门扫描)
1055
1117
  node scripts/live-verify.mjs # 真环境只读验证(需本机测试账号,见发布流程 §7)
1056
1118
  node scripts/live-verify.mjs --write # 追加可逆写操作(建站→下单→支付→退款→回收,零残留)
1057
- node scripts/live-sql.mjs --sql "select …" # 只读查库(只允许 SELECT)
1119
+ node scripts/live-sql.mjs --sql "select …" # 只读查库(只允许 SELECT;默认走真库 RDS)
1058
1120
  ```
1059
1121
 
1060
1122
  设备码这条路的**真环境**端到端验证在云函数测试目录(默认只读,实跑需显式开关):
package/SKILL.md CHANGED
@@ -243,6 +243,39 @@ wkgeo overview dashboard # 数据看板快照(存储/流量/费
243
243
  * 写命令**默认 dry-run**,`--confirm` 才发;`config review` 另需 `--review-token`(只走请求头,不打印)。
244
244
  * AI 类命令(`aiLogList` 等 7 条)**本批没迁**(后台功能未完成),别假设存在。
245
245
 
246
+ ### 4.0.5 数据交换命令(`data chat|stats|usage`,2026-11-10)
247
+
248
+ 三类**只读**运营数据的稳定导出(默认表格,`--json` 给下游,`--out` 落 CSV/JSON):
249
+
250
+ ```bash
251
+ wkgeo data chat # AI 客服会话(最新在前;正文默认脱敏、IP 只给掩码)
252
+ wkgeo data chat --from 2026-11-01 --to 2026-11-10 --channel ANONYMOUS_USER
253
+ wkgeo data chat --chat <会话ID> --limit 50 # 单会话消息(按对话顺序,分页)
254
+ wkgeo data chat --out chat.csv # 导出(仍是脱敏后的内容;--raw 才原文)
255
+
256
+ wkgeo data stats # 最近 7 天:按日 PV/UV/IP 唯一数 + Top 页面/来源
257
+ wkgeo data stats --from 2026-11-01 --to 2026-11-10 --top 20 --out stats.json
258
+
259
+ wkgeo data usage # 最近 7 天:按日/模型/站点 的请求数、token、费用
260
+ wkgeo data usage --model deepseek-flash --out usage.csv
261
+ ```
262
+
263
+ 稳定结构(`--json` 的 `data`):
264
+ - chat 会话:`site_id` `view:"sessions"` `from` `to` `channel` `page` `page_size` `total` `channels[]` `rows[]`
265
+ (行:`chat_id` `channel` `record_count` `ip` `started_at` `last_at`)
266
+ - chat 消息:`site_id` `view:"messages"` `chat_id` `page` `page_size` `total` `rows[]`
267
+ (行:`record_id` `chat_id` `index` `question` `answer` `message_tokens` `answer_tokens` `run_time_ms` `vote` `created_at`)
268
+ - stats:`site_id` `from` `to` `timezone` `totals{pv,uv,unique_ips,visits,bots}` `days[]` `top_pages[]` `top_referrers[]`
269
+ - usage:`site_id` `from` `to` `days` `model` `currency` `total{calls,errors,prompt_tokens,completion_tokens,total_tokens,cached_tokens,cost_yuan,cost_cents}` `by_day[]` `by_model[]` `by_site[]` `by_action[]`
270
+
271
+ 四条必读口径:
272
+ 1. `--site <ID|域名>`:域名/短域/站名在**本地**用 `listSites` 换 ID(`www.` 互认);换不到就 exit 2,不会把域名丢给服务端。
273
+ 2. `--from/--to` 是**北京自然日闭区间**;`stats`/`usage` 默认最近 7 天,`chat` 默认不限。
274
+ 3. `data usage` 要令牌 scope 含 **`llm:cost_read`**(默认不含);缺了 exit 3 并打印精确的 `wkgeo login --scope "… llm:cost_read"`。
275
+ 数据源 = 超管 `llmCostSummary`(`llm_usage` UNION `llm_tool_usage`),平台管理员看全量、普通账号只看自己名下站点。
276
+ 4. 隐私:`stats` 只给 IP **数量**(库里只有 `ip_hash`,无明文 IP);`chat` 正文默认 `maskPii` 脱敏、IP 只给掩码样例。
277
+ 红线是「不导出未脱敏 PII」⇒ 默认就安全,`--raw` 只用于本地排查,别把 `--raw --out` 的结果进仓库。
278
+
246
279
  ### 4.1 站点管理入口(`sites list`)
247
280
 
248
281
  `sites list` 是"先看清我在哪、再决定下一步"的命令(2026-10-22 起):
@@ -711,7 +744,7 @@ npx -y @wkgeo/cli@latest sites create --name "我的新站" --lang zh-CN --templ
711
744
  # 读 data.siteId / data.prefixHost / data.url / data.published(steps 里每步的 ok 与耗时)
712
745
  # ℹ️ 客户(customer)层已于 2026-10-27 删除:建站不需要任何归属参数,归属固定为令牌所属用户。
713
746
  # ℹ️ 走平台通道 createSite:服务端分配池位 + 短域 + KV;池位满回 409(POOL_EXHAUSTED),
714
- # 换区再建:--region overseas(intl.wkgeo.com.cn)/ --region global。
747
+ # 换区再建:--region overseas / --region global。
715
748
  # ℹ️ --template 只认**模板市场已有的 key**(填错会列出现有 key,exit 2);不给就是空站;
716
749
  # 装完会自动启用(templateInstall → templateActivate)。
717
750
  # ℹ️ 不给 --publish 只建不发:短域还没内容(404 属正常),要上线加 --publish。
@@ -978,7 +1011,7 @@ npx -y @wkgeo/cli@latest context export --format md --out ./site-context.md --si
978
1011
  | `login --device-continue` 报 `kind:"expired"` | 短码过期(默认 10 分钟)或已被换过票 | 重新 `login --device --no-wait` 申请新短码;**别**反复续跑 |
979
1012
  | 下单直接返回 `paid:true` | 服务端设计:下单时余额足够就直接扣款并履约 | 这是正常的"钱包支付";用 `wallet` 复核余额 |
980
1013
  | `sites create` 报 400 参数错误 | 客户层已删,归属无需指定;400 只剩参数问题(名称/区域等) | 按错误提示补参数 |
981
- | `sites create` 报 409「该区域名额已满(系统正在自动扩容)」 | 该区域池位满(`POOL_EXHAUSTED`);服务端可能已先插了一行 draft 再失败 | 换区再建:`--region overseas`(intl.wkgeo.com.cn)或 `--region global`;别原地重试同一区 |
1014
+ | `sites create` 报 409「该区域名额已满(系统正在自动扩容)」 | 该区域池位满(`POOL_EXHAUSTED`);服务端可能已先插了一行 draft 再失败 | 换区再建:`--region overseas` 或 `--region global`;别原地重试同一区 |
982
1015
  | `sites create --template` 报「模板市场里没有…」exit 2 | `--template` 只认模板市场已有 key(内置如 `classic-blue` 默认模板 / `warm-amber`) | 按报错 hint 里的现有 key 重填;不想装模板就去掉 `--template`(空站) |
983
1016
  | 短域访问 403/404 且 `sites get` 里 `prefix_kv_written:false` | 短域没写进 KV;CLI **没有** `domain repair` 命令(后端也无等价 OAuth 动作) | **别撒谎说"能访问"**:如实告诉用户短域暂不可用,用 `sites get <站点ID>` 复核 `prefix_host` / `prefix_kv_written`;`null` = 旧接口没回这个字段,让用户直接打开短域试 |
984
1017
  | `domain bind` 回 exit 1 +「域名开通通道暂不可用(平台侧未开),本次未写入,可直接重试」 | 上游 `wkgeo-domain` 的内部通道没开(部署侧 `DOMAIN_INTERNAL_CHANNEL_ENABLED=false`)⇒ 服务端 503 | **如实说"没绑上、没写入"**,别当成成功;平台开通后**直接重跑同一条命令**(`domain bind` 幂等),也可以先用 `domain status` 看现状 |
package/lib/api.mjs CHANGED
@@ -117,6 +117,20 @@ export const GATEWAY_PREFIXES = Object.freeze({
117
117
  member: 'wkgeo-plugin-member',
118
118
  channel: 'wkgeo-plugin-channel-code',
119
119
  'ai-tools': 'wkgeo-plugin-ai-tools',
120
+ /**
121
+ * ★ 2026-11-10(数据交换单):三个**只读**数据面,供 `wkgeo data chat|stats|usage` 用。
122
+ *
123
+ * · `aikefu` → `wkgeo-plugin-aikefu`(MaxKB 会话/消息,只读库)
124
+ * · `analytics` → `wkgeo-plugin-analytics`(PV / UV / IP 唯一数、Top 页面/来源)
125
+ * · `admin` → `wkgeo-admin`(大模型费用账单 `llmCostSummary`,只读位 `llm:cost_read`)
126
+ *
127
+ * 为什么现在才登记:这三个前缀网关早就有了(`wkgeo-gw` 的 `defaultRoutes`),
128
+ * 但 CLI 以前没有命令要打它们。**只登记前缀,不改任何现有动作的路由**:
129
+ * `fnOf()` 的默认仍是 `cli`,只有显式 `prefix:` 才会走这三条。
130
+ */
131
+ aikefu: 'wkgeo-plugin-aikefu',
132
+ analytics: 'wkgeo-plugin-analytics',
133
+ admin: 'wkgeo-admin',
120
134
  });
121
135
 
122
136
  /** 前缀是否合法(HTTP 层的唯一闸门:不认的前缀直接报用法错误,绝不瞎打) */
@@ -1648,6 +1648,112 @@ function publishSiteOrThrow(ctx) {
1648
1648
  return site;
1649
1649
  }
1650
1650
 
1651
+ /* ---- 发布前置:自有域名闸门(口径同 CMS 的 `siteCustomDomainState`) ---- */
1652
+
1653
+ /**
1654
+ * 无自有域名时的提示 —— **一句中文说完「为什么不用发 + 下一步做什么」**。
1655
+ * 与 CMS 后台同一口径(那边 `PUBLISH_NO_CUSTOM_DOMAIN_MESSAGE` 是「请绑定自有域名后再发布」,
1656
+ * CLI 多解释一句「平台预览地址实时生效」,因为命令行用户看不到后台那张提示卡)。
1657
+ */
1658
+ const PUBLISH_NO_CUSTOM_DOMAIN_MESSAGE =
1659
+ '当前站点使用平台预览地址,内容实时生效,无需发布;请绑定自有域名后再发布';
1660
+
1661
+ /** 认「有自有域名」的 hostname_kind(与 CMS 的 SITE_PRIMARY_DOMAIN_SQL 一致,custom > root > other) */
1662
+ const PUBLISH_CUSTOM_DOMAIN_KINDS = ['custom', 'root', 'other'];
1663
+
1664
+ /** 站点行 / 域名接口上「客户自有域名」的候选列(平台面 custom_domain / CMS 面 cms_domain / 老列 domain) */
1665
+ function publishSiteDomainOf(row) {
1666
+ if (!row) return '';
1667
+ for (const key of ['custom_domain', 'cms_domain', 'domain']) {
1668
+ const text = String(row[key] || '').trim().toLowerCase();
1669
+ if (text) {
1670
+ return text.replace(/^https?:\/\//, '').replace(/\/.*$/, '');
1671
+ }
1672
+ }
1673
+ return '';
1674
+ }
1675
+
1676
+ /** `siteDomainRecords` 回包里**已验证**的客户域名(custom > root > other;同级按接口顺序 = id 升序) */
1677
+ function publishVerifiedDomainOf(payload) {
1678
+ const rows = Array.isArray(payload && payload.domains) ? payload.domains : [];
1679
+ for (const kind of PUBLISH_CUSTOM_DOMAIN_KINDS) {
1680
+ const hit = rows.find(
1681
+ (one) =>
1682
+ one &&
1683
+ String(one.verify_status || '').toLowerCase() === 'verified' &&
1684
+ String(one.hostname_kind || '').toLowerCase() === kind,
1685
+ );
1686
+ if (hit && String(hit.hostname || '').trim()) return String(hit.hostname).trim().toLowerCase();
1687
+ }
1688
+ return '';
1689
+ }
1690
+
1691
+ /**
1692
+ * 站点「有没有绑定客户自有域名」—— 判据**逐条对齐** CMS 的 `siteCustomDomainState`:
1693
+ * ① `site_domain` 里 `verify_status='verified'` 的客户域名(custom > root > other);
1694
+ * ② 回落站点行上的 `custom_domain` / `domain`(以及域名接口回的 `custom_domain`)。
1695
+ * 任一有值 ⇒ 有。
1696
+ *
1697
+ * CLI 为什么要自己判一次:`cmsSitePublishStart` 走的是 CLI 自己的调度副本
1698
+ * (`wkgeo-cli-fc`),CMS 后台那道 409 闸门管不到这条路径;不判就会白跑几百页,
1699
+ * 而客户在自有域名上一点变化也看不到。
1700
+ *
1701
+ * **fail-open**(与 CMS 同口径):两级里只要有一级**读失败**、拿不到结论,就不下"没有域名"的判断,
1702
+ * 照旧放行 —— 宁可多跑一次发布,也不能因为一次查询抖动把客户的手动发布永久封死。
1703
+ *
1704
+ * @returns {Promise<{known:boolean, hasCustomDomain:boolean, customDomain:string}>}
1705
+ */
1706
+ async function publishCustomDomainState(ctx, siteId) {
1707
+ let siteRow = null;
1708
+ let records = null;
1709
+ let readFailed = false;
1710
+ try {
1711
+ siteRow = await ctx.callData('getSite', { id: siteId });
1712
+ } catch {
1713
+ readFailed = true;
1714
+ }
1715
+ try {
1716
+ records = await ctx.callData('siteDomainRecords', { id: siteId });
1717
+ } catch {
1718
+ readFailed = true;
1719
+ }
1720
+
1721
+ const verified = publishVerifiedDomainOf(records);
1722
+ if (verified) return { known: true, hasCustomDomain: true, customDomain: verified };
1723
+
1724
+ const fallback = publishSiteDomainOf(siteRow) || publishSiteDomainOf(records);
1725
+ if (fallback) return { known: true, hasCustomDomain: true, customDomain: fallback };
1726
+
1727
+ if (readFailed) return { known: false, hasCustomDomain: true, customDomain: '' };
1728
+ return { known: true, hasCustomDomain: false, customDomain: '' };
1729
+ }
1730
+
1731
+ /**
1732
+ * 发布前拦一道:**没有客户自有域名 ⇒ 拒绝并给一句中文提示**(exit code 非 0)。
1733
+ *
1734
+ * 2026-11-09 口径:站点唯一地址 `<slug>.site.wkgeo.cn` 是动态实时渲染,
1735
+ * 内容改完立刻生效;静态发布产物只服务客户自有域名 —— 没绑域名时发布对客户没有任何可见效果。
1736
+ * `--cancel` / `publish status` 不受影响(取消永远要能用)。
1737
+ */
1738
+ async function assertPublishHasCustomDomain(ctx, site) {
1739
+ const state = await publishCustomDomainState(ctx, site.id);
1740
+ if (!state.known) {
1741
+ if (!ctx.out.json) {
1742
+ ctx.out.warn('读不到该站的自有域名状态,本次不拦发布(发完可用 `wkgeo domain records` 核对)。');
1743
+ }
1744
+ return state;
1745
+ }
1746
+ if (state.hasCustomDomain) return state;
1747
+ throw new CliError(PUBLISH_NO_CUSTOM_DOMAIN_MESSAGE, {
1748
+ kind: 'no_custom_domain',
1749
+ code: 409,
1750
+ hint:
1751
+ '平台预览地址本身实时渲染:内容改完刷新就是最新,不需要发布。' +
1752
+ '绑定自有域名后再发:CMS 后台站点设置里登记域名 → 按提示加解析 → `wkgeo domain records` 看验证状态。',
1753
+ details: { reason: 'no-custom-domain', hasCustomDomain: false },
1754
+ });
1755
+ }
1756
+
1651
1757
  async function publishJobOf(ctx, jobId) {
1652
1758
  const payload = jobId ? { jobId } : {};
1653
1759
  return (await ctx.publishCall('cmsSitePublishStatus', payload)) || {};
@@ -1738,6 +1844,7 @@ export const publishCommand = {
1738
1844
  notes: [
1739
1845
  '**站点必须显式**:`--site` 或先 `wkgeo site use <id>`;都没配就报用法错误(不猜站点)。',
1740
1846
  '不加 `--confirm` 一律 dry-run:只读 `overview` / `publishStatus` 算计划,**不发发布请求**。',
1847
+ '**没有客户自有域名会被拒**(exit 1,一个发布请求都不发):站点唯一地址是平台预览地址(动态实时渲染,内容改完立刻生效),静态发布只服务客户自有域名 —— 与 CMS 后台发布按钮同一口径;绑定域名后再发。',
1741
1848
  '真发前会打印站点名、域名、将发布页面数;需要「系统管理 / 全局配置」写权限,没有会回 403 并给权限提示。',
1742
1849
  '后端没配 `INNER_PUBLISH_SECRET` 时会 fail-closed 回 503 —— 那是服务端部署问题,不是 CLI 的错。',
1743
1850
  ],
@@ -1750,7 +1857,11 @@ export const publishCommand = {
1750
1857
  // 1) 取消分支:`--cancel` 与 `publish cancel` 同一个实现
1751
1858
  if (ctx.flags.cancel) return runPublishCancel(ctx, site, row);
1752
1859
 
1753
- // 2) 先看清现状(只读):最新任务 + 内容计数
1860
+ // 2) 前置闸门:站点没有绑定客户自有域名 ⇒ 拒绝(exit code 非 0、一个发布请求都不发)。
1861
+ // 口径同 CMS 后台的发布按钮:平台预览地址是实时渲染,发布对客户没有可见效果。
1862
+ const domainState = await assertPublishHasCustomDomain(ctx, site);
1863
+
1864
+ // 3) 先看清现状(只读):最新任务 + 内容计数
1754
1865
  let latest = {};
1755
1866
  try {
1756
1867
  latest = await publishJobOf(ctx, ctx.flags.job);
@@ -1773,11 +1884,13 @@ export const publishCommand = {
1773
1884
  : null;
1774
1885
  const estimate = counts ? counts.categories + counts.contents + 1 : null;
1775
1886
 
1776
- // 3) dry-run:把"要打哪个站、发多少页"摊开说
1887
+ // 4) dry-run:把"要打哪个站、发多少页"摊开说
1777
1888
  if (!ctx.flags.confirm) {
1778
1889
  const data = {
1779
1890
  ...publishResultData(site, row, latest, { action: 'dry_run', confirmed: false }),
1780
1891
  site_source: site.source,
1892
+ has_custom_domain: true,
1893
+ custom_domain: domainState.customDomain || '',
1781
1894
  counts,
1782
1895
  estimated_pages: estimate,
1783
1896
  };
@@ -1785,6 +1898,7 @@ export const publishCommand = {
1785
1898
  out.head('发布计划(dry-run,未发送任何发布请求)');
1786
1899
  out.line(` 站点:${data.site_name || '(未取到站名)'}(${site.id})`);
1787
1900
  out.line(` 域名:${domains.length ? domains.join('、') : '(平台没登记域名)'}`);
1901
+ out.line(` 自有域名:${domainState.customDomain || '(已绑定,平台没回具体域名)'}`);
1788
1902
  if (counts) {
1789
1903
  out.line(
1790
1904
  ` 内容:栏目 ${counts.categories} 个 | 内容 ${counts.contents} 条(已发布 ${counts.published} / 草稿 ${counts.drafts})`,
@@ -1802,7 +1916,7 @@ export const publishCommand = {
1802
1916
  return data;
1803
1917
  }
1804
1918
 
1805
- // 4) 真发
1919
+ // 5) 真发
1806
1920
  if (!out.json) {
1807
1921
  out.head(`开始发布:${(row && row.name) || site.label || site.id}`);
1808
1922
  out.line(` 站点:${site.id}`);
@@ -2032,6 +2146,8 @@ export const publishRetryCommand = {
2032
2146
  const { out } = ctx;
2033
2147
  const site = publishSiteOrThrow(ctx);
2034
2148
  const row = await publishSiteRow(ctx, site.id);
2149
+ // 重发同样是"真发",先过同一道前置闸门(没有自有域名 ⇒ 拒绝,见 publishCommand)
2150
+ await assertPublishHasCustomDomain(ctx, site);
2035
2151
  const previous = await publishJobOf(ctx, ctx.flags.job).catch(() => ({}));
2036
2152
  const active = previous.status === 'queued' || previous.status === 'running';
2037
2153
  if (active) {