@wkgeo/cli 2.0.3 → 2.1.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.
- package/CHANGELOG.md +10 -2
- package/README.md +7 -7
- package/SKILL.md +1038 -1038
- package/lib/api.mjs +351 -351
- package/lib/args.mjs +235 -235
- package/lib/build.mjs +1047 -0
- package/lib/cms.mjs +328 -328
- package/lib/commands/auth.mjs +1280 -1280
- package/lib/commands/data.mjs +694 -694
- package/lib/commands/index.mjs +15 -1
- package/lib/commands/init.mjs +111 -111
- package/lib/commands/orders.mjs +691 -691
- package/lib/commands/site.mjs +82 -0
- package/lib/commands/siteops.mjs +248 -0
- package/lib/commands/sites.mjs +968 -801
- package/lib/commands/spec.mjs +72 -72
- package/lib/commands/template.mjs +1484 -1484
- package/lib/config.mjs +57 -4
- package/lib/errors.mjs +446 -336
- package/lib/manifest-apply.mjs +1650 -1650
- package/lib/manifest-schema.json +480 -480
- package/lib/manifest.mjs +1106 -1106
- package/lib/runtime.mjs +767 -654
- package/lib/site-create.mjs +537 -537
- package/lib/site-credentials.mjs +157 -0
- package/lib/site-meta.mjs +474 -0
- package/lib/site-spec.mjs +302 -302
- package/lib/site-template.mjs +405 -0
- package/lib/template-gen.mjs +1354 -1354
- package/lib/template-publish.mjs +696 -696
- package/lib/templates-sync.mjs +676 -644
- package/lib/workspace-sync.mjs +386 -0
- package/package.json +56 -56
- package/spec/SITE-SPEC.md +198 -198
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,14 @@
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
## 2.1.0 · 2026-11-22
|
|
8
|
+
|
|
9
|
+
- 新增 `site build`:把站点静态生成到本地 `html/`(页面引用 `/template/` 模板资产、不复制资产;生成清单可幂等跳过未变页面),产物结构与发布器落桶口径一致
|
|
10
|
+
- 新增 `site sync diff`(本地 ↔ 上次 pull 的线上基线差异,只读零网络,给出待发布 / 待下载计数)、`site template new`(先建模板行 → 拉成带 manifest 的本地工程,pull 失败自动回滚)、`site build` 附带 `.wkgeo/site.json` 栏目树镜像
|
|
11
|
+
- `cmsAuth()`:CMS 管理动作改用账号 OAuth 令牌(Key 模式 / 站点短票自动回落到本机账号登录态,不再被误报「令牌过期」);`templates pull` 目录里只有 build 资产包时视为空目录,不再要求 `--force`
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
7
15
|
## 2.0.0 · 2026-11-19
|
|
8
16
|
|
|
9
17
|
- BREAKING: 移除全部域名相关命令(domain / esa / dns credential / site domain-recheck 共 30 条)
|
|
@@ -105,7 +113,7 @@
|
|
|
105
113
|
(只登记域名的旧语义)、`--max-pages` / `--work-dir` / `--no-design`;对应的抓取、zip/目录解析、多来源合并代码
|
|
106
114
|
(`parseSourceList` / `resolveSourcePlan` / `readTemplateDir` / `readTemplateZip` / `unzipEntries` / `stripSharedRoot` 等)一并删除。
|
|
107
115
|
传旧参数会明确报「不认识的参数」并 exit 2。
|
|
108
|
-
- **来源分析不在 CLI**:从网址 / 文档生成站点是 A 侧(配 skill)的活,规范见 `docs/规范-建站三来源-20261031.md`(task-73 产出)。
|
|
116
|
+
- **来源分析不在 CLI**:从网址 / 文档生成站点是 A 侧(配 skill)的活,规范见 `docs/归档/迁移草案-AI计费统一-20261104/规范-建站三来源-20261031.md`(task-73 产出)。
|
|
109
117
|
- 建站失败时 hint 会带「站点已创建(<id>),可删:`wkgeo sites delete <id>`」;池位满会提示换 `--region overseas|global`。
|
|
110
118
|
|
|
111
119
|
---
|
|
@@ -197,7 +205,7 @@
|
|
|
197
205
|
|
|
198
206
|
* **没有** `auth.tokenIssue` / `auth.revoke` 这类新后端动作,也**没有** `cli-token.json`:令牌模型不变(OAuth access_token,30 天)。
|
|
199
207
|
* **没有** `domain unbind` / `domain repair`:`/cli` 动作面里没有等价动作(`releaseSiteDomain` 在 OAuth 下仍是 428 短信二次验证),**不造命令**;解绑去会员中心,重试开通 = 再跑一次 `domain bind`(幂等)。
|
|
200
|
-
* 文档同步:`README.md`(命令表 / 版本 0.6.0 / §9 已知缺口 #16–#19)、`SKILL.md`(`version: 0.6.0` + 命令摘要 + 常见坑)、`docs/规范-CLI-通道与动作映射-20261028.md`(表 A / 表 E / §8.1)。
|
|
208
|
+
* 文档同步:`README.md`(命令表 / 版本 0.6.0 / §9 已知缺口 #16–#19)、`SKILL.md`(`version: 0.6.0` + 命令摘要 + 常见坑)、`docs/归档/迁移草案-AI计费统一-20261104/规范-CLI-通道与动作映射-20261028.md`(表 A / 表 E / §8.1)。
|
|
201
209
|
|
|
202
210
|
---
|
|
203
211
|
|
package/README.md
CHANGED
|
@@ -108,7 +108,7 @@ cd cli && node scripts/build-exe.mjs --sea # 跑 Node SEA 的离线两步(
|
|
|
108
108
|
|
|
109
109
|
### 版本与升级策略
|
|
110
110
|
|
|
111
|
-
* 当前版本 **`
|
|
111
|
+
* 当前版本 **`2.0.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`)。
|
|
112
112
|
* **本版只加命令、不改契约**:原有命令 / 参数 / `--json` 信封 / 退出码与 0.6.0 完全一致,AI 端继续用 `npx -y @wkgeo/cli@latest` 即可;逐批明细与已知缺口见 [`CHANGELOG.md`](./CHANGELOG.md) 顶部「1.0.0」。
|
|
113
113
|
* **同一个版本号不能覆盖**:改了代码必须 `npm version patch|minor|major` 再发布。
|
|
114
114
|
* AI 端统一用 **`npx -y @wkgeo/cli@latest`** → 每次自动拿最新版;
|
|
@@ -124,7 +124,7 @@ cd cli && node scripts/build-exe.mjs --sea # 跑 Node SEA 的离线两步(
|
|
|
124
124
|
| **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。 |
|
|
125
125
|
| **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 天)。 |
|
|
126
126
|
| **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` 信封、退出码全部不变**。 |
|
|
127
|
-
| **0.5.0** | 2026-10-26 | **发布接真后端 + 本地大模型**。① `publish` 不再是"只看 overview":默认 **dry-run**(只读算页面数),`--confirm` 才调 `cmsSitePublishStart` 并轮询 `cmsSitePublishStatus` 到终态,打印 `total/done/pagesFailed/finalizeOk`;另有 `publish status` / `publish cancel` / `--cancel`;**站点必须显式**(没 `--site` 也没 `site use` 就报用法错误,绝不猜站)。② 新增 `plugins list\|toggle`(`pluginList`/`pluginToggle`,`editor` 单选互斥会提示「已停用:xxx」)、`forms list\|entries`(`/form` 前缀;**手机/邮箱/IP/UA 默认脱敏**,`--raw` 必须再加 `--confirm`)、`domain inspection`(`cmsSiteDomainInspectionList`;403 → 人话「需要系统管理员权限」而不是堆栈)、`preview <path>`(零后端拼预览地址,`--open`)、`import-v2 start\|status`(`importV2Start`/`importV2Get`,默认 dry-run)。③ **本地大模型**:`ai ping\|ask\|chat` + `context export`(只连本机、上下文白名单 10 域、日志只记元信息),详见 [`../docs/CLI-本地大模型接入.md`](../docs/CLI-本地大模型接入.md)。④ 修 6 处过时项:`fnOf()` 支持 `/form` `/ai` `/member` `/channel` `/ai-tools` 五个新网关前缀;`config.version` 改为读 `package.json`;`CMS_ACTIONS` 补新动作;`CATEGORY_FIELDS` 补 `cover/attachments/fields_enabled/max_depth/template_path/seo_jsonld/link_category_id/link_plugin_key/link_plugin_sub`;`categories` 加 `--link-plugin/--link-plugin-sub`;新增 `CHANGELOG.md`。 |
|
|
127
|
+
| **0.5.0** | 2026-10-26 | **发布接真后端 + 本地大模型**。① `publish` 不再是"只看 overview":默认 **dry-run**(只读算页面数),`--confirm` 才调 `cmsSitePublishStart` 并轮询 `cmsSitePublishStatus` 到终态,打印 `total/done/pagesFailed/finalizeOk`;另有 `publish status` / `publish cancel` / `--cancel`;**站点必须显式**(没 `--site` 也没 `site use` 就报用法错误,绝不猜站)。② 新增 `plugins list\|toggle`(`pluginList`/`pluginToggle`,`editor` 单选互斥会提示「已停用:xxx」)、`forms list\|entries`(`/form` 前缀;**手机/邮箱/IP/UA 默认脱敏**,`--raw` 必须再加 `--confirm`)、`domain inspection`(`cmsSiteDomainInspectionList`;403 → 人话「需要系统管理员权限」而不是堆栈)、`preview <path>`(零后端拼预览地址,`--open`)、`import-v2 start\|status`(`importV2Start`/`importV2Get`,默认 dry-run)。③ **本地大模型**:`ai ping\|ask\|chat` + `context export`(只连本机、上下文白名单 10 域、日志只记元信息),详见 [`../docs/归档/迁移草案-AI计费统一-20261104/CLI-本地大模型接入.md`](../docs/归档/迁移草案-AI计费统一-20261104/CLI-本地大模型接入.md)。④ 修 6 处过时项:`fnOf()` 支持 `/form` `/ai` `/member` `/channel` `/ai-tools` 五个新网关前缀;`config.version` 改为读 `package.json`;`CMS_ACTIONS` 补新动作;`CATEGORY_FIELDS` 补 `cover/attachments/fields_enabled/max_depth/template_path/seo_jsonld/link_category_id/link_plugin_key/link_plugin_sub`;`categories` 加 `--link-plugin/--link-plugin-sub`;新增 `CHANGELOG.md`。 |
|
|
128
128
|
| **0.4.0** | 2026-10-22 | **修「建站只建平台站」**:`sites list` 的建站引导把 CMS 动作 `cmsCreateSite` 误发到平台 `/api/data`(永远回"未知动作")→ 改为走 **CMS 通道** `ctx.cmsCall('createCmsSite', …, {noSite:true})`,一次建出 CMS 站 + 平台站(`cms_site` / 成员行 / 内置模板 / `public.site`)。仅当 CMS 通道回"未知动作/400"才回退平台 `createSite` 并提示「CMS 站点未创建」;网络 / 401 / 429 / 5xx 不回退。新增 `cmsCall(..., {noSite:true})` 无站点模式(建站时本地可能残留旧站点 id,带 `x-cms-site` 会被服务端按成员关系 403 挡掉)。 |
|
|
129
129
|
| 0.3.0 | 2026-10-22 | **默认 API 基址从腾讯 CloudBase 网关切到阿里云 `https://api.wkgeo.com`**(`lib/config.mjs` 的 `DEFAULT_BASE`)。切换前已逐路径门禁比对:`/api/data`、`/api/oauth/{metadata,userinfo,token,introspect,revoke,device_authorization}` 与未知路径 404 的状态码 / JSON 形状新旧完全一致。CMS 基址本来就是 `https://api.wkgeo.com/cms`,未变。旧网关可用 `WKONGAI_BASE=https://wkongai-….tcloudbase.com` 临时覆盖回滚。 |
|
|
130
130
|
| 0.2.4 | 2026-10-21 | 本地回调端口被占用自动换端口;绑定失败不再静默改设备码;成功页 / 失败页都自动关闭。 |
|
|
@@ -442,7 +442,7 @@ wkgeo login --device-continue --json
|
|
|
442
442
|
| `config` | 显示生效配置与登录状态(无令牌) | — |
|
|
443
443
|
| `sites list` | **站点管理入口**:默认只看**我名下的站**;没站会引导建站,有站会让你选一个来管理(写本地 config,等同 `site use`) | `--mine`(默认)、`--managed`、`--all`、`--limit`、`--offset`、`--with-prefix`(逐站补短域 / 开通状态,多个站会多打几次 `getSite`) |
|
|
444
444
|
| `sites get` | 单站详情(只读):短域 / 存储位 / 开通状态 / 地区 / ESA / 证书 / 计费池 / 归属;`--json` 的 `data.detail` 是后端 `getSite` 原样字段(只剔除 `settings` 等 5 个大 JSON 块) | `<站点ID>` |
|
|
445
|
-
| `sites create` | **建站原语**(三步,都可选):建站(平台通道分配池位 / 短域 / KV,站**建在令牌所属用户名下**)→ 装模板市场的模板 → 发布;`--json` 输出 `{ siteId, name, prefixHost, url, published }`。**来源分析不在 CLI**:不抓网址、不解析 zip/目录、不做多来源合成,见 [docs/规范-建站三来源-20261031.md](../docs/规范-建站三来源-20261031.md)(task-73 产出) | `--name`(必填)、`--lang zh-CN\|en`(默认 zh-CN)、`--template <模板key>`、`--publish`、`--dry-run`(只打印计划,零写入)、`--region domestic\|overseas\|global`(默认 domestic;池位满会提示换区) |
|
|
445
|
+
| `sites create` | **建站原语**(三步,都可选):建站(平台通道分配池位 / 短域 / KV,站**建在令牌所属用户名下**)→ 装模板市场的模板 → 发布;`--json` 输出 `{ siteId, name, prefixHost, url, published }`。**来源分析不在 CLI**:不抓网址、不解析 zip/目录、不做多来源合成,见 [docs/归档/迁移草案-AI计费统一-20261104/规范-建站三来源-20261031.md](../docs/归档/迁移草案-AI计费统一-20261104/规范-建站三来源-20261031.md)(task-73 产出) | `--name`(必填)、`--lang zh-CN\|en`(默认 zh-CN)、`--template <模板key>`、`--publish`、`--dry-run`(只打印计划,零写入)、`--region domestic\|overseas\|global`(默认 domestic;池位满会提示换区) |
|
|
446
446
|
| `sites delete` | 删站(服务端是**软删除**,进回收站) | `<站点ID>` |
|
|
447
447
|
| `sites update` | 改站点信息(目前只开放**改站名**;**默认 dry-run**,`--confirm` 才真发)。`--remark` **发不通**:服务端 `updateSite` 白名单与站点表都没有备注字段,传了会明确报缺口而不是假装成功 | `<站点ID>`、`--name`、`--confirm` |
|
|
448
448
|
| `sites recycle` | **回收站**:我删掉的站(软删除,可还原;非管理员只看得到自己删的) | `--limit`(1~200,默认 50)、`--offset` |
|
|
@@ -582,7 +582,7 @@ wkgeo auth revoke # 服务端吊销(POST /api/oauth/revoke)+ 删本地
|
|
|
582
582
|
wkgeo auth revoke --local-only # 只删本地
|
|
583
583
|
```
|
|
584
584
|
|
|
585
|
-
`auth status` 的 `data.action_surface` 是**动作面体检**(口径与 [`../docs/规范-CLI-通道与动作映射-20261028.md`](../docs/规范-CLI-通道与动作映射-20261028.md) 一致):
|
|
585
|
+
`auth status` 的 `data.action_surface` 是**动作面体检**(口径与 [`../docs/归档/迁移草案-AI计费统一-20261104/规范-CLI-通道与动作映射-20261028.md`](../docs/归档/迁移草案-AI计费统一-20261104/规范-CLI-通道与动作映射-20261028.md) 一致):
|
|
586
586
|
|
|
587
587
|
| 字段 | 含义 |
|
|
588
588
|
| --- | --- |
|
|
@@ -830,7 +830,7 @@ wkgeo data usage --out usage.csv # CSV 落「按日」明细
|
|
|
830
830
|
1. **正文默认脱敏**:`data chat` 的 `question` / `answer` 走 `maskPii`(手机号留 3+4、邮箱打码、IP 留前三段);
|
|
831
831
|
`--raw` 才原样。`--out` 落盘**同样按当前模式**脱敏 —— 红线是「不导出未脱敏 PII 到仓库」,默认就是安全的。
|
|
832
832
|
2. **不提供 IP 清单**:访问统计只存不可逆 `ip_hash`(`unique_ips` 是数量),客服会话的 `ip` 只给掩码样例。
|
|
833
|
-
这是隐私口径(`docs/功能-访问统计-埋点注入.md` §7),不是缺口。
|
|
833
|
+
这是隐私口径(`docs/归档/迁移草案-AI计费统一-20261104/功能-访问统计-埋点注入.md` §7),不是缺口。
|
|
834
834
|
3. **区间合计 ≠ 按日相加**:`stats.totals` 是整段去重(一次 `count(distinct)`),`days[]` 是逐日去重;
|
|
835
835
|
跨日把 UV/IP 相加会把人算重,所以两个口径分开给。
|
|
836
836
|
4. **`data usage` 需要 scope `llm:cost_read`**(默认登录 scope 不含)。缺了会 exit 3 并打印精确的重授权命令:
|
|
@@ -907,7 +907,7 @@ wkgeo data usage --out usage.csv # CSV 落「按日」明细
|
|
|
907
907
|
|
|
908
908
|
CLI 不只是"给 AI 用的命令行"——它也能**把本站数据喂给本机跑的模型**,全程不经过任何云厂商。
|
|
909
909
|
两个入口:`wkgeo ai ask`(一问一答,CLI 现场取数 + 脱敏)与 `wkgeo context export`(导出一份上下文文件,丢给任意模型)。
|
|
910
|
-
完整说明、Ollama / LM Studio 两套可复制示例、"能读到哪些数据"表格见 **[`../docs/CLI-本地大模型接入.md`](../docs/CLI-本地大模型接入.md)**。
|
|
910
|
+
完整说明、Ollama / LM Studio 两套可复制示例、"能读到哪些数据"表格见 **[`../docs/归档/迁移草案-AI计费统一-20261104/CLI-本地大模型接入.md`](../docs/归档/迁移草案-AI计费统一-20261104/CLI-本地大模型接入.md)**。
|
|
911
911
|
|
|
912
912
|
```bash
|
|
913
913
|
# ① 本机起 Ollama(另开一个窗口;LM Studio 见文档)
|
|
@@ -1159,7 +1159,7 @@ node aliyun/fc/_tests/oauth-device-live-e2e.js # 结束按 su
|
|
|
1159
1159
|
| 12 | **CMS 认证桥(Bearer → 站点成员)** | ✅ **已上线并实测**(2026-10-18 下午):`categories list` / `contents list` / `publish` 用 Bearer + `x-cms-site` 真跑成功;多站未指定 → 400(CLI 译成 `cms_site_required`)。⚠️ 15:15 首次实测时线上还是旧函数(401 老文案),15:22 复测已通 —— 排障时先看 401 的**文案** | 已完成(后端 `resolveIdentity`) |
|
|
1160
1160
|
| 13 | **CMS 写操作 / 导入没有真接口验证** | 只读命令已真跑;**写操作**(建栏目/发内容/传素材/存模板)与**导入**没有真跑(会改数据/需数据库凭证)。它们由 66 条离线单测覆盖,**不声称已端到端验证** | 需要时人工验收(写库前先 `site use` 选对站) |
|
|
1161
1161
|
| 13b | **旧令牌缺 CMS scope** | 2026-10-18 之前授权的令牌只有 `site:read/site:write/billing:self` ⇒ `templates list` / `assets list` 报 `cms_scope`(403)。**重新 `wkgeo login` 即可**(默认 scope 与客户端 `allowed_scopes` 都已补齐) | 用户侧一次重新授权 |
|
|
1162
|
-
| 14 | **`import` 走本机运维脚本** | 后端**没有**带鉴权的 HTTP 导入入口,CLI 调用本仓库的 `tencent/cloudbase/import-site.mjs`(`service_role` 直连库,需运维权限)。命令默认 dry-run、只增不毁;客户/AI 端不应当用它 | 后端补 HTTP 导入动作(`docs/规划-CLI与AI建站.md` §5.2) |
|
|
1162
|
+
| 14 | **`import` 走本机运维脚本** | 后端**没有**带鉴权的 HTTP 导入入口,CLI 调用本仓库的 `tencent/cloudbase/import-site.mjs`(`service_role` 直连库,需运维权限)。命令默认 dry-run、只增不毁;客户/AI 端不应当用它 | 后端补 HTTP 导入动作(`docs/归档/迁移草案-AI计费统一-20261104/规划-CLI与AI建站.md` §5.2) |
|
|
1163
1163
|
| 15 | **静态发布** | ✅ **0.5.0 起可用了**:`publish` 走 `cmsSitePublishStart` → 轮询 `cmsSitePublishStatus`(`summary` 里有 `pagesFailed` / `finalizeOk`),`--cancel` / `publish cancel` 可中止。⚠️ 仍需服务端配 `INNER_PUBLISH_SECRET`,未配时后端 fail-closed 回 503(CLI 会原样报出来) | 后端(配 `INNER_PUBLISH_SECRET`) |
|
|
1164
1164
|
| 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` 是整块覆盖,读-改-写会吞掉原有设置 | 后端加列 + 加白名单(另开任务) |
|
|
1165
1165
|
| 21 | **`purgeSite`(彻底删站)刻意没有 CLI 命令** | 服务端只允许 `role==='owner'` 调,非 owner 会回「彻底删除只能由管理员操作;你可以把它还原回站点列表」。CLI 只给**可逆**的 `sites delete`(进回收站)与 `sites recycle restore`,不给不可逆入口 | 产品策略(已定) |
|