@wkgeo/cli 0.0.0-stage → 1.0.0

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.
Files changed (51) hide show
  1. package/CHANGELOG.md +208 -0
  2. package/LICENSE +21 -0
  3. package/README.md +1042 -3
  4. package/SKILL.md +927 -0
  5. package/lib/ai/client.mjs +161 -0
  6. package/lib/ai/config.mjs +221 -0
  7. package/lib/ai/context.mjs +468 -0
  8. package/lib/ai/log.mjs +53 -0
  9. package/lib/api.mjs +339 -0
  10. package/lib/args.mjs +235 -0
  11. package/lib/cli.mjs +168 -0
  12. package/lib/cms.mjs +330 -0
  13. package/lib/commands/ai.mjs +392 -0
  14. package/lib/commands/apps.mjs +116 -0
  15. package/lib/commands/auth.mjs +1288 -0
  16. package/lib/commands/billing.mjs +666 -0
  17. package/lib/commands/cms.mjs +2533 -0
  18. package/lib/commands/config-auth.mjs +621 -0
  19. package/lib/commands/config.mjs +434 -0
  20. package/lib/commands/dnscred.mjs +428 -0
  21. package/lib/commands/domainops.mjs +546 -0
  22. package/lib/commands/domainorder.mjs +439 -0
  23. package/lib/commands/import.mjs +164 -0
  24. package/lib/commands/index.mjs +528 -0
  25. package/lib/commands/logs.mjs +141 -0
  26. package/lib/commands/orders.mjs +444 -0
  27. package/lib/commands/overview.mjs +394 -0
  28. package/lib/commands/plugins.mjs +678 -0
  29. package/lib/commands/site.mjs +435 -0
  30. package/lib/commands/siteops.mjs +1012 -0
  31. package/lib/commands/sites.mjs +905 -0
  32. package/lib/commands/skill.mjs +119 -0
  33. package/lib/config.mjs +351 -0
  34. package/lib/credentials.mjs +160 -0
  35. package/lib/device-store.mjs +132 -0
  36. package/lib/device.mjs +464 -0
  37. package/lib/errors.mjs +299 -0
  38. package/lib/format.mjs +339 -0
  39. package/lib/http.mjs +71 -0
  40. package/lib/index.mjs +44 -0
  41. package/lib/local-import.mjs +185 -0
  42. package/lib/login.mjs +1638 -0
  43. package/lib/oauth-urls.mjs +163 -0
  44. package/lib/page.mjs +393 -0
  45. package/lib/pkce.mjs +48 -0
  46. package/lib/proxy.mjs +454 -0
  47. package/lib/qr.mjs +31 -0
  48. package/lib/runtime.mjs +650 -0
  49. package/lib/site-state.mjs +137 -0
  50. package/package.json +53 -4
  51. package/wkgeo.mjs +17 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,208 @@
1
+ # 更新日志(`@wkgeo/cli`)
2
+
3
+ 本文件从 **0.5.0** 开始记录。更早的版本变更见 [`README.md`](./README.md) 的「版本记录」表。
4
+
5
+ ---
6
+
7
+ ## 1.0.0 · 2026-10-30
8
+
9
+ **本版是 scoped 新包**:包名从 wkgeo-cli 迁到 npm 组织 @wkgeo 下的 **@wkgeo/cli**,版本从 1.0.0 重新起算;license 改 **MIT**(随包附 LICENSE,年份 2026,版权 WKGEO)、ngines.node 为 >=18、 iles 白名单加 LICENSE。**代码与命令面与旧包最后一版一致**,升级只需把
10
+ px -y wkgeo-cli@latest 换成
11
+ px -y @wkgeo/cli@latest。以下为该版内容:
12
+
13
+ **一句话**:把后台**能干的活整块搬进 CLI**——内容 / 素材 / 发布 / 站点 / 插件 / 配置类 auth / 控制台七批动作全部由自持云函数 `wkgeo-cli-fc` 进程内执行(不再借 `/cms` 会话转发,因而计入 `cli_action_usage`),CLI 侧补齐 `assets` / `publish` / `site` / `plugins` / `config` / `logs` / `overview` / `lang` / `role` / `member` 命令组;**`whoami.action_total` 150 → 185**。**写操作一律默认 dry-run**,`--confirm` 才真发,`--yes` 才是危险动作(删推送目标 / 解绑存储 / 删解析)。**命令、参数、`--json` 信封、退出码与 0.6.0 完全兼容**(只增不改)。
14
+
15
+ | 批次 | 内容 | CLI 命令组 |
16
+ | --- | --- | --- |
17
+ | B1 内容 45 条(task-73) | CMS 内容面逐字复制进 `src/content-core.js`,进 `cli_action_usage` 计数;栏目 / 内容两条线的增删改查全在自持面 | `categories *`、`contents *` |
18
+ | B2 素材 18 条(task-66) | CMS 素材面逐字复制进 `src/asset-core.js`;签名票据复用 CMS 的 OSS PostObject policy + HMAC-SHA1,**CLI 不碰任何 AK**,二进制不进云函数 | `assets list` / `upload` / `sign` / `register` / `delete` / `restore` |
19
+ | B3 发布 16 条(task-68) | CMS 发布面逐字复制进 `src/publish-core.js`,**只做调度层**(校验归属 → 建/查/取消 `cms_site_publish_job` → 异步触发 worker),渲染与上传仍由 `wkgeo-site-publish` / `wkgeo-publish-push` 执行 | `publish` / `status` / `cancel` / `retry` / `jobs *` / `targets *` / `push` / `storage *` |
20
+ | B4 站点 7 条(task-90) | CMS 站点面可迁的 7 条进 `src/site-core.js`(`cmsCreateSite` / `cmsSiteDomainCheck` 不迁,前者已有原生 `site create`,后者已有原生 `siteDomainCheck`);`domain inspection` 从 `/cms` 切到 `/cli` | `site info` / `site info save` / `site domain-recheck` / `site demo-seed` / `site demo-clear` / `site sync` |
21
+ | B5 插件 9 条(task-91) | CMS 插件类 **9 条全迁**进 `src/plugin-core.js`(4 读要 `site:read`、5 写要 `site:write`,服务端另校验 `site.owner_id`:他人站 403 `not_site_owner`,站名/业主一概不回);`pluginMarketDemo` 只读库里 `demo_url`,**不下载外链** | `plugins list` / `access` / `toggle` / `settings` / `market-list` / `install` / `uninstall` / `upgrade` / `demo` |
22
+ | B6 配置类 auth 11 条(task-75 / B7) | CMS 配置面 auth 12 条里可迁的 11 条进 `src/config-auth-core.js`;`userAdd`(加成员建号)与 `userProfileUpdate`(改资料/密码)**不迁**,留在 CMS 会话面;角色写在 handler 前多一道越权闸 | `lang *`、`role *`、`member *` |
23
+ | B7 控制台 8 条(task-92 / B7) | CMS 控制台类 **8 条全迁**进 `src/console-core.js`;平台管理员判定改成真查库(`isPlatformAdminUser`),`traffic` / `dashboard` 的平台门禁照样成立;6 条只读不写审计,只有 `configSave` / `configReview` 落 `admin_audit_log`;`configReview` 另带 `x-review-token` 双闸(未配 `REVIEW_TOKEN` 回 503) | `logs list`、`config get` / `save` / `review` / `capabilities`、`overview summary` / `traffic` / `dashboard` |
24
+
25
+ > 动作面口径:`whoami.action_total = **185**`;域名级 DNS 凭据 4 条按后端口径**不计入**(`auth status` 里单列成 `uncounted_self_hosted`),因此 `/cli` 可见动作实际 **189** = 185 + 4。
26
+
27
+ #### 已知缺口(本版不承诺)
28
+
29
+ * **`templates.*` 仍在 CMS 会话面**(走 `ctx.cmsCall()` → `/cms`):模板 / 预览属老板划定的**冻结范围**,不在本阶段迁;因此模板类命令仍要求令牌带 CMS scope。
30
+ * **AI 后台 7 条不迁**(`aiLogList` / `aiLogDetail` / `aiLogStats` / `aiTaskCreate` / `aiTaskMessages` / `aiTaskModels` / `aiToolConfirm`):后台 AI 功能未完成,按老板口径做完再单开一单,**文档不承诺**。
31
+ * `userAdd` / `userProfileUpdate` 不迁(建号与改资料/密码需要 CMS 会话的第二重身份);`cmsCreateSite` / `cmsSiteDomainCheck` 不迁(已有原生等价动作,迁会双写或重复代理)。
32
+ * `/cli` 对未接管动作仍回 `400 未知动作: X`(如实,不静默转发);`templates` 这类会直接报错,别当成功。
33
+
34
+ #### 测试
35
+
36
+ * `cd cli && node --test "test/*.test.mjs"` → **502 条全绿**(0.6.0 的 468 + 本版新增 34)。
37
+ * `node cli/wkgeo.mjs --help` / `node cli/wkgeo.mjs auth --help` 均为 `exit 0`,分组帮助生效(`wkgeo <组> --help` 只打该组,不再打全量总帮助)。
38
+ * `cd cli && npm pack --dry-run` 干净:无 `.secrets` / `.tmp-build` / `node_modules` / `dist` 二进制。
39
+
40
+ ---
41
+
42
+ ## 0.6.0 · 2026-10-28
43
+
44
+ **一句话**:从「只读观测」到「**能真成交**」——把 CLI 从散着调老网关改成**自持全动作面**(`/cli` 全量迁入自持云函数 `wkgeo-cli-fc`:53 条 = 原生 2 + 自持 37 + 白名单转发 14),并把域名这条链路整条打通:「查可注册 + 报价 → 下单(默认 dry-run)→ 扣费 → 实名模板 → 快速过户 → 解析(自持 alidns)→ ESA 接入 → 建站收口」,外加**域名级 DNS 凭据**(AES-256-GCM 加密存储;secret 只从 stdin / 交互读,永不回传)。本版累计**四批**改动:①只读观测(A1–A10,`sites get` 与 `domain status/records/dns/check/remind` 一族),②全动作面自持,③域名成交链路,④DNS 凭据。**写操作一律默认 dry-run 或要求显式 `--confirm` / `--yes`**,买域名、改解析、扣费都不会手滑就花钱。
45
+
46
+ | 批次 | 内容 |
47
+ | --- | --- |
48
+ | ① 只读观测(A1–A10) | `sites get`、`domain status/records/dns/check/remind`、`sites list --with-prefix`、`sites create --channel`,外加 4 个「会误导人」的老 bug 修复(详见下「第一批」) |
49
+ | ② 全动作面自持(53 条) | `/cli` 全量迁入 `wkgeo-cli-fc`:原生 2 + 自持 37 + 白名单转发 14;`lib/` 新增 `commands/domainops.mjs` / `commands/domainorder.mjs` / `commands/dnscred.mjs` / `commands/siteops.mjs` |
50
+ | ③ 域名成交链路(12+ 动作) | `domain search` / `domain buy` / `domain order` / `domain order create` / `domain order status` / `domain charge` / `domain template create` / `domain template status` / `domain transfer` / `domain zone list\|add\|update\|delete` / `esa site\|record\|hostname\|kv` |
51
+ | ④ 域名级 DNS 凭据(4 动作) | `domain dns credential detect\|set\|status\|delete`:一期两家服务商 adapter;**先调 API 验证通过才落库**;连续失败自动停用;出参是服务端白名单(结构上没有 secret / 密文字段) |
52
+ | ⑤ 收口 `auth` / `domain bind` / 端到端脚本(task-12) | `auth status\|token\|revoke` 三条、`domain bind`(原生 `cliProvisionSiteDomain`,503 人话 + `exit 1`)、`cli/scripts/e2e-site.mjs`(建站→短域→可选绑域→发布→首页 200+指纹);命令帮助新增**分组帮助**(`wkgeo auth --help` / `wkgeo domain --help` 不再打全量总帮助),详见下「第五批」 |
53
+
54
+ > 动作面口径更新:0.6.0 之后 **B1 内容 45 / B2 素材 18 / B3 发布 16** 三批也迁进 `/cli` 自持(task-73 / task-66 / task-68),合计 **150 条**(`cliWhoami.action_total = 150`)。上表②里的「53 条」是当时的口径。
55
+
56
+ ---
57
+
58
+ ### 第五批 · 收口到 `/cli`:`auth` / `domain bind` / 端到端脚本(task-12)
59
+
60
+ **一句话**:把「令牌能干什么」「怎么绑自己的域名」「整条建站链路能不能自己跑一遍」三件事补上——**不新增后端动作、不改令牌模型**,全部复用已经上线的 `/cli` 动作面(150 条)。
61
+
62
+ #### 新增命令
63
+
64
+ | 命令 | 后端动作 / 接口 | 说明 |
65
+ | --- | --- | --- |
66
+ | `auth status` | `cliWhoami`(`/cli`) | 账号 ID / `client_id` / `scopes` / 到期 + **动作面体检**:`action_total`(原样透出)+ `action_surface.{native,self_hosted,forwarded,batches,consistent}` + `action_lists`(9 个动作数组原样)。`--verbose` 加令牌掩码与凭据文件权限 |
67
+ | `auth token` | 纯本地 | 只输出**前 4 位 + 长度 + 到期时间**;完整令牌永不打印(也永不进 JSON) |
68
+ | `auth revoke` | `POST /api/oauth/revoke`(`wkgeo-user`)+ 删本地 | 服务端单令牌吊销(RFC 7009,best-effort)后删凭据;`--local-only` 只删本地。服务端失败时 `revoked_remote:false` + `revoke_error` 如实回,本地照样清 |
69
+ | `domain bind <域名> --site <站点ID>` | `cliProvisionSiteDomain`(**原生**,内部代执行 `wkgeo-domain` 的 `provisionSiteDomainInternal`) | 成功=**受理**开通(`provision_state`/`esa_record_id`/`cname_target`/`check_status` 等可得字段原样打印);平台通道未开 ⇒ 上游 503 ⇒「域名开通通道暂不可用(平台侧未开),本次未写入,可直接重试」+ `exit 1`;平台自有域 ⇒ 403 `platform_owned_domain` ⇒ `exit 3`;已绑异域 ⇒ 409 ⇒ `exit 1`(换域需会员中心解绑) |
70
+
71
+ #### 新增脚本(不是命令,随仓库分发)
72
+
73
+ `cli/scripts/e2e-site.mjs`:建站(指定池)→ `getSite` 校验 `prefix_host` / `prefix_kv_written` / `provision_state` → (可选)`domain bind` → `publish --confirm` 并轮询 job → 轮询短域首页 HTTP 200 + 内容指纹(sha256 + 长度)→ 绑域成功再轮询客户域 → 结果表 / `--json`。**默认不删站**(脚本不提供删除),真建站要显式 `--confirm`,`--dry-run` 零写入。
74
+
75
+ #### 明确**没有**做
76
+
77
+ * **没有** `auth.tokenIssue` / `auth.revoke` 这类新后端动作,也**没有** `cli-token.json`:令牌模型不变(OAuth access_token,30 天)。
78
+ * **没有** `domain unbind` / `domain repair`:`/cli` 动作面里没有等价动作(`releaseSiteDomain` 在 OAuth 下仍是 428 短信二次验证),**不造命令**;解绑去会员中心,重试开通 = 再跑一次 `domain bind`(幂等)。
79
+ * 文档同步:`README.md`(命令表 / 版本 0.6.0 / §9 已知缺口 #16–#19)、`SKILL.md`(`version: 0.6.0` + 命令摘要 + 常见坑)、`docs/规范-CLI-通道与动作映射-20261028.md`(表 A / 表 E / §8.1)。
80
+
81
+ ---
82
+
83
+ ### 第一批 · 站点 / 域名只读观测(A1–A10)
84
+
85
+ **一句话**:补齐站点 / 域名这一块的**可观测性**——能看清单站全字段、短域到底写没写进 KV、域名解析记录长什么样、域名还能不能注册、哪些域名快到期;顺手修三处**会误导人**的老问题(归属假告警、`getSiteDomainReminders` 被打到 `/user` 回「未知操作」、`sites create --domain` 说"会真实绑定域名资源"其实只落库)。**本版不新增任何写操作**。
86
+
87
+ #### 新增命令
88
+
89
+ | 命令 | 后端动作 | 说明 |
90
+ | --- | --- | --- |
91
+ | `sites get <站点ID>` | `getSite` | 单站全字段(短域 / 存储位 / 开通状态 / 地区 / ESA / 证书 / 计费池 / 归属)。`--json` 的 `data.detail` 是原样后端字段(只剔除 `settings`/`theme`/`layout`/`info`/`template_config` 五个大 JSON 块,剔除项在 `data.detail_excluded_fields` 里列明) |
92
+ | `domain status` | `getSiteProvisionStatus` | 开通状态:`provision_state`/`provision_step`/ESA/证书/离线原因/`last_error`/尝试次数 + 客户待办(`customer_todo` 的 TXT/CNAME 记录)+ `provision_log` 末 5 条 |
93
+ | `domain records` | `siteDomainRecords` | 每个域名的解析记录与验证状态(TXT / CNAME / 证书 / ESA);没绑域名时原样给后端 `hint`,**不假装有数据** |
94
+ | `domain dns` | `siteDomainRecords` | 同一份数据,但只按「**要客户自己去域名商加**」的格式输出:主机记录(RR) / 类型 / 记录值(Value) / 状态(已生效 / 未生效 / 未知),便于人工照抄。CLI **不会替你加 DNS** |
95
+ | `domain check <域名…>` | `siteDomainCheck` | 查域名可注册性,一次 1~10 个(>10 本地就拦,不打网络);`reason` 翻人话:`self`=自己的站、`taken`=已被占用、`platform_owned`=平台保留、`invalid`=格式不合法、`null`=可注册。后端限流 30 次/分,429 由错误层转 `exit 4` |
96
+ | `domain remind` | `getSiteDomainReminders` | 域名到期提醒(`--limit` 1~200,默认 50;档位 30/7/1 天)。需要**平台管理员**权限,403 → `kind=domain_remind_forbidden` + `exit 3` 人话,不甩堆栈 |
97
+
98
+ #### 修复
99
+
100
+ * **A3 归属假告警**:建站后打「站点归属(null) ≠ 当前账号」。根因是 `normalizeSite()` 只读 `owner_user_id`,而平台 `listSites` / `getSite` 返回的字段叫 **`owner_id`**(另有 `created_by`)⇒ 永远 `null`。现在按 `owner_user_id → owner_id → ownerId → created_by` 依次兜底;**归属核不出来时不再告警**(`owner_matches_current_user: null`),只有真不一致(`false`)才 warn。
101
+ * **A7 `domain` 路由表漏动作(真 bug,线上可复现)**:`lib/api.mjs` 的 `FN_DOMAIN` 只有 4 条,`getSiteDomainReminders` / `getSiteProvisionStatus` / `siteDomainRecords` / `siteDomainCheck` / `dnsProviderProbe` 全被打到 `/user`,后端回 `400 未知操作: <action>`。已补到 9 条。**改前** `domain remind` → `{"kind":"bad_request","code":400,"message":"未知操作: getSiteDomainReminders"}`;**改后** → 正确打到 `/domain`(无权限时是 403,CLI 翻成 `exit 3`)。
102
+ * **A8 `domain inspection --site`**:多站账号的提示写着「加 `--site`」,但该命令根本没声明这个参数 ⇒ `exit 2 不认识的参数`。现在 `--site` 等价 `x-cms-site`;不带 `--site` 时保持老行为(服务端按令牌自动选站)。
103
+ * **A10 `sites create --domain` 文案**:原来说"会真实绑定域名资源,谨慎使用",实际只写 `site.domains` 落库、**不写 KV / 不碰 DNS / 不触发证书**。文案改成"只登记到 `site.domains`,不触发解析 / 证书;解析要自己去域名商加"。
104
+
105
+ #### 变更
106
+
107
+ * **A9 `sites create --channel platform|cms|auto`**(默认 `auto`):`auto` = 先走 CMS 通道 `cmsCreateSite`,只有「明确不支持」(`not_deployed` / 未知动作 / 400)才回退平台 `createSite`(沿用 0.4.0 的回退判据);网络 / 401 / 429 / 5xx 一律**不回退**。`--json` 里 `data.channel` 标明实际走的通道(`cms` / `platform`),另有 `channel_requested` / `cms_site_created` / `cms_error` / `cms_warnings`。`--channel cms` 配 `--domain` 直接 `exit 2`(CMS 建站不登记域名)。
108
+ * **A2 短域透出 + KV 告警**:`sites create` / 交互引导建站后打印短域地址与 **`prefix_kv_written`**(后端成功时返回 `prefix_host`/`prefix_url`/`prefix_kv_written`/`prefix_kv_verified`;失败时只回 `prefix_host:null` ⇒ CLI 记 `null`,**不当成 false**)。`prefix_kv_written === false` 时打 warn:「短域解析未写入(prefix_kv_written=false):现在访问短域会 403/404」,并提示等后端 `domain repair` 上线后再修。`null` 时提示「服务端未返回(旧版接口),直接打开地址试」。
109
+ * **A1 `sites list` 投影补字段**:新增 `prefix_host` / `prefix_url` / `prefix_kv_written` / `prefix_kv_verified` / `provision_state` / `custom_domain` / `owner_id`;平台 `listSites` 本来就不返回短域,所以列表默认显示 `-`,要补就加 **`--with-prefix`**(逐站 `getSite`,回包 `data.prefix_enriched = {requested,filled,failed}`)。表格列调整为 名称 / 站点 ID / 关系 / 状态 / 开通(`provision_state`)/ 短域 / 域名(去掉了「来源」和「创建时间」两列——来源在 `--json` 的 `source` 里,创建时间在 `sites get` 里)。
110
+ * `args.mjs` 的 `checkPositionals` 支持**变长参数**(最后一个 arg 标 `variadic:true` → 收成数组),`--help` 里显示成 `<name…>`。只有 `domain check` 用。
111
+
112
+ #### 测试
113
+
114
+ * 新增 `test/v052-task9.test.mjs`(18 条):`sites get` 全字段 / blob 不外泄 / 归属兜底 / 用法错误;`sites list --with-prefix`;`sites create` 三种 `--channel` + KV 告警 + 互斥与非法值;`domain status/records/dns/check/remind` 真机口径与 403/限流/空数据;`domain inspection --site` 的请求头。
115
+ * `cd cli && node --test "test/*.test.mjs"` → **454 条全绿**(0.5.1 的 436 + 本批新增 18);**0.6.0 发版前全量 468 条全绿**(436 + 32,含 ②③④ 三批新增)。
116
+
117
+ #### 兼容性
118
+
119
+ * 命令、`--json` 信封、退出码**契约不变**;只做**加法**(新命令、新参数、新字段)。已知行为变化两处:`sites list` 的**表格列**变了(`--json` 字段只增不减);`sites create` 的**默认通道**从"只平台"改成"auto 先 CMS",要老行为就显式 `--channel platform`。
120
+ * Node 仍 `>=20`,依赖仍 **0 个**;本批随 **0.6.0** 一起发布(`prepublishOnly` 会在 `npm publish` 前再跑一遍全量测试)。
121
+
122
+ #### 未做(刻意留白)
123
+
124
+ * `domain bind` / `domain unbind`:权限模型(谁能代表客户改 DNS / 谁能解绑)**还没拍板**,CLI 不做写操作。
125
+ * `domain repair`:等后端 B2 动作上线;当前只在短域 KV 未写入时给提示文案 + 代码里留 `TODO`。
126
+
127
+ ---
128
+
129
+ ## 0.5.1 · 2026-10-26
130
+
131
+ **一句话**:修 0.5.0 的**发布崩溃**——`publish --confirm` 在发布**已经提交成功之后**的轮询里抛 `ctx.sleep is not a function`(`exit 1`,`kind=internal`);CI / 无 `io` 环境下同样必崩。命令语义**没有任何变化**。
132
+
133
+ ### 修复
134
+
135
+ * **`ctx.sleep` 崩(真 bug,线上已被打到)**
136
+ * 现场:`npx -y @wkgeo/cli@0.5.0 publish --confirm` → 发布任务已提交,随后 `exit 1`,输出 `{"kind":"internal","message":"ctx.sleep is not a function"}`。
137
+ * 根因(两处叠加):`lib/cli.mjs` 逐字写 `sleep: io.sleep`,而生产入口 `wkgeo.mjs` 调 `run(argv)` **不传 io** ⇒ 注入了一个 `undefined`(解构默认值只对"没这个键"生效,对"键在、值是 `undefined`"**不**生效);`lib/runtime.mjs` 的默认值又是 `sleep = undefined`;`lib/commands/cms.mjs` 的 `pollPublishJob` 直接 `await ctx.sleep(intervalMs)`。
138
+ * 修法:**所有可选注入项都在 runtime 层落地默认实现**(`defaultSleep` / `now` / `random` / `log` / `clock` / `fetchImpl` 等,非法值一律归一化成默认),`lib/cli.mjs` 改为只透传"调用方真的给了的"注入项(`undefined` 一律不出现,`false` / `0` 这类有语义的值保留)。
139
+ * 影响面:任何调用方漏传 / 传错类型都不再崩;`publish --confirm`、`publish status`、设备码轮询、`import` 子进程等路径全部受益。
140
+ * **可注入项清单补齐**:新增 `ctx.random`、`ctx.log`、`ctx.clock`(`clock.now()` / `clock.sleep()`)三个有默认实现的注入点;`ctx.openBrowser` 明确为「函数 | `false`(`--no-browser`)| `undefined`(用下游生产默认)」三态。
141
+
142
+ ### 测试
143
+
144
+ `cd cli && node --test "test/*.test.mjs"` → **436 条全绿**(0.5.0 的 428 条 + 新增 8 条回归:`defaultSleep` 边界、runtime 无注入项默认值、硬塞 `undefined`/`null`/非函数的归一化、`pickInjectables` 合并逻辑、**不传 io 的 `publish --confirm` 端到端**(success / failed / 人类模式)、`publish status`)。
145
+
146
+ > 为什么 0.5.0 的 428 条没抓到:`test/_runner.mjs` 的 `run()` **总是**注入 `sleep: async () => {}`,等于绕开了"生产入口不传 io"这条最普通的路径。新用例**故意不用**该夹具,直接调 `run(argv, {stdout, stderr, stdin, env, fetchImpl})`。
147
+
148
+ ### 兼容性
149
+
150
+ * 命令、参数、`--json` 信封、退出码**全部不变**;只是不再崩。
151
+ * 最低 Node 版本不变(`>=20`);依赖仍是 0 个。
152
+
153
+ ---
154
+
155
+ ## 0.5.0 · 2026-10-26
156
+
157
+ **一句话**:发布接真后端;新增插件 / 表单 / 域名巡检 / 预览 / 导入 v2 五组命令;新增 `ai` 与 `context export`,**CLI 可以接本地大模型**了。
158
+
159
+ ### 新增
160
+
161
+ | 命令 | 后端动作 | 说明 |
162
+ | --- | --- | --- |
163
+ | `publish`(真发) | `cmsSitePublishStart` → `cmsSitePublishStatus` | 默认 **dry-run**(只读算页数);`--confirm` 才发;轮询到终态打印 `total/done/pagesFailed/finalizeOk` |
164
+ | `publish status` | `cmsSitePublishStatus` | 只查状态,不触发任何发布 |
165
+ | `publish cancel` / `publish --cancel` | `cmsSitePublishCancel` | 取消正在跑的发布任务 |
166
+ | `plugins list` | `pluginList` | 启用状态 / 分类 / 是否装过;`editor` 单选互斥会提示「已停用:xxx」 |
167
+ | `plugins toggle` | `pluginToggle` | `--key` + `--enable`/`--disable`;回包里 `category/exclusive/disabledKeys` 全部展示 |
168
+ | `forms list` | `/form` `formList` | 表单清单(字段数 / 提交数 / 未读数) |
169
+ | `forms entries` | `/form` `formEntryList` | 提交记录;**默认脱敏**手机 / 邮箱 / IP / UA,`--raw` 必须再加 `--confirm` |
170
+ | `domain inspection` | `cmsSiteDomainInspectionList` | 只读;403 → 人话「需要系统管理员权限」(`exit 3`,不抛堆栈) |
171
+ | `preview <path>` | 无(零后端) | 拼 `https://wkgeo.com/cms/preview/<站点ID>/<路径>`;`--open` 用系统默认浏览器打开 |
172
+ | `import-v2 start` | `importV2Start` | 默认 dry-run;`--confirm` 才提交,回 `runId` |
173
+ | `import-v2 status` | `importV2Get` | 看导入进度 |
174
+ | `ai ping` | 本机模型 `GET {baseUrl}/models` | 列可用模型;**不打印 apiKey** |
175
+ | `ai ask <问题>` | 本机模型 `POST /chat/completions` | 先按 `--context` 取数 → `maskPii` 脱敏 → 拼 prompt → 回答;`--json` 给结构化 |
176
+ | `ai chat` | 同上 | 多轮;非 TTY / `--json` 自动退化成一次问答 |
177
+ | `context export` | 复用上面各域动作 | 导出 JSON / Markdown(栏目树+内容列表+插件+表单结构+发布状态+站点信息),`--with-body` 才带正文 |
178
+
179
+ ### 修复 / 改造
180
+
181
+ * **`fnOf()` 前缀化**:`/form` `/ai` `/member` `/channel` `/ai-tools` 五个新网关前缀现在能路由(以前一律打到 `/api/user`);`api.data()` 新增 `prefix` / `headers` / `timeoutMs` 选项。
182
+ * **`config.version` 不再写死 `0.1.0`**:改为运行时读 `package.json`(`readPackageVersion()`)。
183
+ * **`CMS_ACTIONS` 补齐**:`cmsSitePublishStart/Status/Cancel`、`pluginList/pluginToggle`、`cmsSiteDomainInspectionList`、`importV2Start/importV2Get`。
184
+ * **`CATEGORY_FIELDS` 补列**(14 → 23):新增 `link-category/link-category_id`、`--link-plugin`、`--link-plugin-sub`、`--seo-jsonld`、`--cover`、`--attachments`、`--fields-enabled`、`--max-depth`、`--template-path`,与 CMS `categorySave` 的真实列对齐(`categories create/update` 都能用)。
185
+ * **`publish` 的旧结论段重写**:原文「前台按需渲染、没有发布这一步」已过期,改为指引 `publish --confirm` / `publish status` / `publish cancel`。
186
+ * **`publish` 强制显式站点**:没 `--site` 也没 `site use` → `UsageError`(`exit 2`),绝不猜站。
187
+ * **脱敏统一**:`format.mjs` 新增 `maskPii()` / `maskByKind()` / `maskPiiDeep()`(手机 `138****1234`、邮箱 `zh***@e***.com`、IP 留三段、订单号留后 6 位、密钥只报长度、OSS 签名链接抹掉);`forms entries`、`ai ask`、`context export` 共用同一套。
188
+ * **防 PII 泄漏**:`forms entries` 的 `rows_count` 以前会把原始记录带进输出,改为只报条数。
189
+ * 新增 `CHANGELOG.md`(本文件)。
190
+
191
+ ### 已知后端缺口(CLI 不假造)
192
+
193
+ | 缺口 | 现象 | CLI 行为 |
194
+ | --- | --- | --- |
195
+ | `/form` 只认后台 Cookie 登录态 | CLI 用 OAuth Bearer → 401/403 | `kind=form_backend_gap`,`exit 3`,人话提示「后端还没接 Bearer 桥」 |
196
+ | `INNER_PUBLISH_SECRET` 未配 | 发布 Start 回 503(fail-closed) | 原样报 503 文案,不重试、不假发 |
197
+ | `/ai` 云函数 | 与本地模型无关(CLI 直连本机端点,不走网关) | — |
198
+
199
+ ### 安全
200
+
201
+ * 只连本机模型(`localhost` / `127.0.0.1` / `[::1]`);要连远程必须显式 `ai.allowRemote=true`,且 CLI 会先警告。
202
+ * 上下文白名单 10 个数据域;`wallet`(钱包流水)/ `users`(账号明细)**硬禁**;`orders`(订单明细)需 `--context orders` + `ai.allowOrders=true`。
203
+ * AI 日志 `~/.wkongai/logs/ai-<日期>.jsonl` **只记元信息**(时长、模型、字符数、命令),**不记 prompt 与回答**。
204
+ * `context export` 只写到你指定的本地文件,**不上传任何地方**。
205
+
206
+ ### 测试
207
+
208
+ `cd cli && node --test "test/*.test.mjs"` → **428 条全绿**(原 393 条 + 新增 35 条:新命令注册/帮助、脱敏断言、`--raw` 需 `--confirm`、403/401 人话、ai 桩验证调用链、context export 两种格式、maskPii 单元)。
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 WKGEO
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.