dsh-wkgeo-ops 0.2.3 → 0.2.4

package/README.md

@@ -3,10 +3,10 @@
 **悟空GEO·网站运营 —— 一站式建站与上线，全在对话里完成**
 
 把 `wkgeo` CLI（仓库内 `cli/wkgeo.mjs`，或用 `WKGEO_CLI` 指到你本机 CLI）的站点运营能力接进 DeepSeek Harness：
-**agent 16 个工具** + **左侧栏「悟空GEO-网站运营」入口（点开是中央面板）** + **右侧边栏「网站运营」面板（含三步建站向导）**。不新增任何 npm 依赖，插件内**不重写**任何 HTTP / SQL 业务逻辑——工具只负责 `spawn node cli/wkgeo.mjs … --json` 再解析信封。
+**agent 21 个工具** + **左侧栏「悟空GEO-网站运营」入口（点开是中央面板）** + **右侧边栏「网站运营」面板（含三步建站向导）**。不新增任何 npm 依赖，插件内**不重写**任何 HTTP / SQL 业务逻辑——工具只负责 `spawn node cli/wkgeo.mjs … --json` 再解析信封。
 
 - key / 包名 / cordis 插件名：`dsh-wkgeo-ops`
-- 版本：**0.2.3**（2026-10-30 发布到公共 npm，可直接 `npm i dsh-wkgeo-ops`；0.2.3 内容：加插件图标 `assets/icon.png`（去底透明品牌猴子头）、中文标题与说明走 `locale/zh.json` + `locale/en.json`、`description` 换成定稿文案。历史：0.2.2 左栏入口文字改为「悟空GEO-网站运营」、补 `LICENSE`、README 去掉本机绝对路径；0.2.0 被 npm 判 staged 冲突，首个正式版是 0.2.1）
+- 版本：**0.2.4**（2026-10-30 发布到公共 npm，可直接 `npm i dsh-wkgeo-ops`；0.2.4 内容：新增 5 个 GEO/SEO 工具——`wkgeo_geo_audit` / `wkgeo_geo_llms` / `wkgeo_geo_robots` / `wkgeo_geo_brands` / `wkgeo_seo_audit`（工具 16 → 21）、`description` 换成 A 版文案、`exports` 放宽 `"./lib/*"` 与 `"./assets/*"` 以便外部深层引用。历史：0.2.3 加插件图标 `assets/icon.png`（去底透明品牌猴子头）、中文标题与说明走 `locale/zh.json` + `locale/en.json`、`description` 换成定稿文案；0.2.2 左栏入口文字改为「悟空GEO-网站运营」、补 `LICENSE`、README 去掉本机绝对路径；0.2.0 被 npm 判 staged 冲突，首个正式版是 0.2.1）
 - 宿主：DSH Web 客户端（`dsh.client.platform = "web"`）+ cordis 服务端插件
 - v2 口径（老板 2026-10-30）：**三步向导**（①站点名 ②语言 ③内容来源）+ **模板 / 网址 / 文件 三选或多选**
 - v4 口径（老板 2026-10-30）：「初始化先选**站点根目录** → **站点卡片**一个一个显示（能点进去）→ 详情里有**本地文件夹**」；不再用一张表铺列表
@@ -22,7 +22,7 @@ integrations/dsh-wkgeo-ops/
 ├─ cordis.patch.yml      # 装载层：- insert: id/name = dsh-wkgeo-ops
 ├─ lib/
 │  ├─ wizard.js          # 纯函数：三步向导状态机 + 来源归一 + 能力探测 + 命令构造 + 建站闸门
-│  └─ index.js           # 服务端 cordis 插件：16 个工具 + 6 条路由 + 执行层（可单测）
+│  └─ index.js           # 服务端 cordis 插件：21 个工具 + 6 条路由 + 执行层（可单测）
 ├─ client/
 │  └─ client.js          # Web 客户端：左侧栏入口 + 面板（初始化/卡片网格/详情/向导/日志 五态）
 ├─ skill/                # agent 技能：wkgeo-site-content（建站清单契约 + 示例 manifest）
@@ -86,10 +86,15 @@ v0.2.0 新增的 9 个工具都是**薄封装**：`spawn node cli/wkgeo.mjs …
 | `wkgeo_template_pack` | `dir`*、`out`、`base` | `template pack --dir <目录> [--out <zip>] [--base] --json`（300s） | 打包结果（`data.zip` / 文件数） |
 | `wkgeo_template_publish` | `dir`*、`key`、`confirm`、`noPrune`、`archive`、`noPreview` | `template publish --dir <目录> [--key] [--dry-run] [--confirm] [--no-prune] [--archive] [--no-preview] --json`（300s） | **发布到模板市场**：默认 dry-run，`confirm:true` 才写 |
 | `wkgeo_domains_list` | `site` | 有 `site` → `domain records --site <id> --json`；无 `site` → `sites list --json` 聚合 | 有 site：`data.domains[]`（TXT/CNAME 记录、`verify_status`、证书 `not_after`、ESA 状态）；无 site：逐站域名汇总。**CLI 没有 `domain list` 子命令**，聚合路径会在 `data.source` 里写明 |
+| `wkgeo_geo_audit` | `dir`* | `geo audit <dir> --json` | **只读** GEO 体检：`data.score/grade/pages/summary{error,warn,info,total}` + `issues[]`（`severity/file/rule/message/suggestion`）；渲染给分数、分布、前 5 条 |
+| `wkgeo_geo_llms` | `dir`*、`confirm` | `geo llms <dir> [--confirm] --json` | 生成 `llms.txt` + `llms-full.txt`；**默认 dry-run（只预览不写盘）**，`confirm:true` 才写；回 `data.written[{name,path,bytes,chars}]` |
+| `wkgeo_geo_robots` | `dir`*、`mode`(allow-ai\|block-ai\|show，默认 show)、`confirm` | `geo robots <dir> --mode <m> [--confirm] --json` | `show` **只读**（看每个 AI 爬虫 allowed/blocked/未列出）；`allow-ai`/`block-ai` **会改 `robots.txt`**，默认 dry-run 回 diff，`confirm:true` 才写 |
+| `wkgeo_geo_brands` | `project`（域名，可选）→ `--domain` | `geo brands [--domain <域>] --json` | 品牌收录 / AI 引用跟踪；**后端未配置（`WKGEO_GEO_API`）时 CLI 回 `status:"not_configured"`**，渲染翻成人话 + 接口契约，**不伪造数据** |
+| `wkgeo_seo_audit` | `dir`*、`url` | `seo audit <dir> --json` | **只读** SEO 体检 13 项：`data.score/grade/summary/issues[]`；**只给 `url` 不联网**（CLI 无抓取能力）→ 回 `supported:false` + `gap` 指向 `wkgeo template init` 的网址模式先落本地目录 |
 
 `*` = 必填。实现细节：
 
-- **`parameters` 必须是 raw JSON Schema**（`{ type:'object', properties, required }`），由 `paramsSchema(properties, required)` 统一生成，`required` 恒输出；传「属性名 → 属性 schema」的映射会被模型 API 判 `schema must be a JSON Schema of 'type': "object", got 'type: null'`（`INVALID_REQUEST`，整轮被打回）。回归脚本：`verify/tool-schema.mjs`（纯 node，不需 Electron/ajv，期望 `RESULT: ALL PASS（16 个工具）`、exit 0）。
+- **`parameters` 必须是 raw JSON Schema**（`{ type:'object', properties, required }`），由 `paramsSchema(properties, required)` 统一生成，`required` 恒输出；传「属性名 → 属性 schema」的映射会被模型 API 判 `schema must be a JSON Schema of 'type': "object", got 'type: null'`（`INVALID_REQUEST`，整轮被打回）。回归脚本：`verify/tool-schema.mjs`（纯 node，不需 Electron/ajv，期望 `RESULT: ALL PASS（21 个工具）`、exit 0）。
 - **DSH schema 子集（v0.2.0 硬约束）**：宿主 `dsh-tools/lib/types/json-schema.js` 只认 `type / oneOf / properties / required / additionalProperties / items / enum / const` + 注解 `description/title/default/examples`；其它键（`format/pattern/minLength/minItems/anyOf/allOf/$ref/...`）一律报 `JsonSchemaError: unsupported JSON schema`。**属性级 `required: true` 只能出现在 `type:'object'` 的属性上**——加在 boolean/integer/array/string 上就是老板 2026-10-30 装插件失败的那条错（`schema.properties.ok.required is not supported on type "boolean"`）；必填一律用顶层 `required: [...]`。`verify/schema-subset.mjs` 复刻了这套校验器，`verify/dsh-compat.mjs` 会拦住违规写法。
 - 一律 `spawn(node, [cli, ...args])`（`shell:false`、`windowsHide:true`）；**普通命令硬超时 30s**，**长任务（模板生成 / 建站 / 导入）300s**（`LONG_TIMEOUT_MS`），超时 `SIGKILL` 回 `code:"TIMEOUT"`；stdout 上限 4MB。
 - 只解析 CLI 的 JSON 信封；失败只回 `error.code/message/hint`，**不打印任何 token、不落日志**。
@@ -135,11 +140,11 @@ DSH 设置里的插件页 →「**添加插件**」→ 填包名：
 dsh-wkgeo-ops
 ```
 
-装上后重启 DSH 即生效（左侧栏图标 + 右侧栏页签 + 16 个工具一起出现）。等价命令行：
+装上后重启 DSH 即生效（左侧栏图标 + 右侧栏页签 + 21 个工具一起出现）。等价命令行：
 
 ```powershell
 npm i dsh-wkgeo-ops            # 或 npm i -g / 在 DSH profile 目录里装
-npm view dsh-wkgeo-ops version # 0.2.3
+npm view dsh-wkgeo-ops version # 0.2.4
 ```
 
 > **唯一本机相关项**：工具要调 `wkgeo` CLI。插件默认取仓库内 `cli/wkgeo.mjs`；装到别的机器 / 别的仓库时，设环境变量 `WKGEO_CLI=<你那边的仓库>\cli\wkgeo.mjs`（可选 `WKGEO_NODE_BIN`）后重启 DSH。没配也能装、能激活，只是工具调用会回 `SPAWN_FAILED` 并给出提示。
@@ -157,7 +162,7 @@ npm view dsh-wkgeo-ops version # 0.2.3
 
    > `cordis.patch.yml` 里**不需要**再写 `- id: dsh-wkgeo-ops`：`dsh.profile.bundles` 里的包按 bundle 层挂载，包内自带的 patch 会自动应用。
 
-**C. 验证（装完应同时出现两处入口 + 16 个工具）**
+**C. 验证（装完应同时出现两处入口 + 21 个工具）**
 
 | 位置 | 现象 |
 |---|---|
@@ -167,13 +172,15 @@ npm view dsh-wkgeo-ops version # 0.2.3
 
 三个**只读**工具可以立刻验通（不写任何东西）：`wkgeo_sites_list`（站点列表）、`wkgeo_domains_list`（域名/证书状态）、`wkgeo_templates_list`（站点模板）。
 
+GEO / SEO 一侧同样有立刻能验的只读入口（都**不写任何东西**）：`wkgeo_geo_audit`（GEO 体检，20 项打分）、`wkgeo_seo_audit`（SEO 体检，13 项）、`wkgeo_geo_robots`（`mode` 缺省 `show`：看每个 AI 爬虫放行/禁止）、`wkgeo_geo_llms` 与 `wkgeo_geo_robots` 的 `allow-ai`/`block-ai` 模式默认 **dry-run 只预览**，要真写盘必须显式 `confirm:true`。`wkgeo_geo_brands` 需要后端基址 `WKGEO_GEO_API`，没配时如实回 `not_configured`（不伪造数据）。
+
 左栏入口是插件自己注册的（`client/client.js` 的 `sidebar.panellist` + `main` 两个槽位、共用 id `wkgeo-ops`），**装插件本身不会自动往左栏塞菜单**——所以看到图标就说明这版代码已生效；只看到右侧栏页签则说明装的是旧版（左栏入口是 2026-10-30 加的）。
 
 **D. 别人（另一台机器 / 另一个 profile）首次安装的差异**
 
 - 左栏 / 右栏入口与工具都随包走，**换机器一样出现**；`client` 侧不依赖本机路径。
 - ⚠️ **唯一本机相关的东西是 wkgeo CLI 路径**：`lib/index.js` 的 `DEFAULT_CLI_PATH` 默认指向仓库内 `cli/wkgeo.mjs`。别人机器上 CLI 调不通时，设环境变量 `WKGEO_CLI=<其仓库>/cli/wkgeo.mjs`（`WKGEO_NODE_BIN` 可指定 node）后重启 DSH 即可——左栏图标仍然在，只是面板取数会报 `SPAWN_FAILED`。
-- 插件中心卡片**没有图标和本地化描述**（包内暂无 `locale/` 与 `icon` 导出），不影响功能。
+- 插件中心卡片的图标与本地化描述随包走（`icon` + `locale/zh.json` / `locale/en.json`，0.2.3 起有），不影响功能。
 - 已发布公共 npm：`npm i dsh-wkgeo-ops` / 插件中心填 `dsh-wkgeo-ops`（v0.2.0 起可装）；本仓库目录安装仍可拷目录 / `file:` 依赖。
 
 ## 6. 自测
@@ -182,9 +189,9 @@ npm view dsh-wkgeo-ops version # 0.2.3
 node --check integrations\dsh-wkgeo-ops\lib\index.js       # exit 0
 node --check integrations\dsh-wkgeo-ops\lib\wizard.js      # exit 0
 node --check integrations\dsh-wkgeo-ops\client\client.js   # exit 0
-node integrations\dsh-wkgeo-ops\verify\tool-schema.mjs     # 16 个工具 schema 全过 · RESULT: ALL PASS / exit 0（纯 node，不需 Electron/ajv）
+node integrations\dsh-wkgeo-ops\verify\tool-schema.mjs     # 21 个工具 schema 全过 · RESULT: ALL PASS / exit 0（纯 node，不需 Electron/ajv）
 node integrations\dsh-wkgeo-ops\verify\panel-registration.mjs  # 页签/面板注册静态断言（guide 必须函数、左栏两条、错误边界）· RESULT: ALL PASS / exit 0
-node integrations\dsh-wkgeo-ops\verify\dsh-compat.mjs      # 离线兼容自检：node --check ×3 + schema 子集 + 属性级 required 扫描 + 包形态 · PASSED=39 FAILED=0 / exit 0
+node integrations\dsh-wkgeo-ops\verify\dsh-compat.mjs      # 离线兼容自检：node --check ×3 + schema 子集 + 属性级 required 扫描 + 包形态 · PASSED=44 FAILED=0 / exit 0
 node .tmp-build\t183\tool-smoke.mjs                        # 16 工具：离线参数映射断言 7/7 PASS + 4 个真实只读调用（sites/domains/templates/聚合成 25 站）· REAL_READONLY_OK=true
 node .tmp-build\t159\smoke.mjs                             # SMOKE OK — 40 checks passed / exit 0
 node .tmp-build\t161\api-test.mjs                          # 23/23 PASS · RESULT: ALL PASS / exit 0（v4 三条新路由）
@@ -224,3 +231,5 @@ node .tmp-build\t161\shoot.mjs     # 自动起服务 + Chrome headless(CDP) 1440
 9. **站点 ↔ 本地文件夹是本机私有映射**：wkgeo 站点模型里没有「本地目录」字段，映射只存在 `<DSH_PROFILE_DIR>/wkgeo-ops/config.json`（根目录只能设一个、文件夹必须在根目录之内）。换机器 / 换 profile 要重新设根目录并重绑；不会随站点同步。
 10. **发布到 npm 要用官方 registry**：本机 `~/.npmrc` 默认 `registry=https://registry.npmmirror.com`（镜像无凭证），发布必须 `npm publish --registry https://registry.npmjs.org`（账号 `wkgeocn`）；`npm view` 同理。
 11. **`wkgeo_domains_list` 无 `site` 时走聚合**：CLI 没有 `domain list` 子命令，聚合用 `sites list` 的 `domain/domains[]` 字段，拿不到 TXT/CNAME/证书明细（要明细就传 `site`）。
+12. **`wkgeo_seo_audit` 不联网**：CLI 的 `seo audit` 只吃本地目录（`cli/lib/commands/seo.mjs` 里没有任何 http/fetch），传网址会被当成目录名（实测回 `目录不存在：…\https:\…`）。所以工具里「只给 `url`」一律回 `{supported:false, gap:{code:'URL_AUDIT_UNSUPPORTED'}}` 并提示先用 `wkgeo_template_init`（`mode=url`）把站落成本地目录，**不假装抓取成功**。
+13. **`wkgeo_geo_brands` 需要后端**：`WKGEO_GEO_API` 没配时 CLI 回 `status:"not_configured"`（exit 0、零请求、零假数据），工具原样转述成人话 + 接口契约；配好之前拿不到任何品牌收录数据。

package/client/client.js

@@ -131,6 +131,25 @@ window.__ModuleLoader__.load({
         initTitle: '第一步：先选站点根目录',
         initHint: '所有站点的本地文件夹都放在这个根目录下。可以直接粘路径，也可以点「选择根目录」一层层点进来。',
         initNote: '根目录只存在本机（DSH profile 里），不上传；只有根目录里面的文件夹能绑定给站点。',
+        // ---- v5：首次进入三步（① 选页根目录 → ② 授权 → ③ 建站，老板 2026-10-30 定） ----
+        stepRoot: '选页根目录',
+        stepAuth: '授权',
+        stepCreate: '建站',
+        stepRootDone: '页根目录：{dir}',
+        stepHint: '首次进入按顺序走：第 1 步选页根目录 → 第 2 步授权 → 第 3 步建站。',
+        authTitle: '第二步：授权 wkgeo 账号',
+        authHint: '建站要走 wkgeo CLI 的写接口，必须先授权。在终端里执行下面这条命令，浏览器会打开授权页；完成后回到这里点「我已授权，重新检查」。',
+        authCommand: 'wkgeo login',
+        authCheck: '我已授权，重新检查',
+        authChecking: '正在检查授权…',
+        authOk: '已授权：能读到站点列表',
+        authNote: '授权凭据由 wkgeo CLI 自己保存，本插件不读取、不显示、不上传账号密码或 token。',
+        needRoot: '先去第 1 步选页根目录，选定后才能建站。',
+        needAuth: '先去第 2 步完成授权（wkgeo login），之后才能建站。',
+        blockedTitle: '还差一步才能建站',
+        crashTitle: '悟空GEO-网站运营 · 面板异常',
+        crashRefresh: '刷新界面',
+        regWarn: '面板自检：',
         rootLabel: '站点根目录',
         rootUnset: '未设置根目录',
         rootPick: '选择根目录',
@@ -248,6 +267,25 @@ window.__ModuleLoader__.load({
         initTitle: 'Step 1: choose a site root folder',
         initHint: 'Every site keeps its local folder under this root. Paste a path, or click "Choose root" and browse into it.',
         initNote: 'The root is stored locally (in your DSH profile), never uploaded. Only folders inside the root can be bound to a site.',
+        // ---- v5: first run = root folder -> authorization -> create ----
+        stepRoot: 'root folder',
+        stepAuth: 'authorize',
+        stepCreate: 'create',
+        stepRootDone: 'Root folder: {dir}',
+        stepHint: 'First run goes in order: step 1 pick a root folder, step 2 authorize, step 3 create.',
+        authTitle: 'Step 2: authorize the wkgeo account',
+        authHint: 'Creating a site uses the wkgeo CLI write API, so authorization is required. Run the command below in a terminal; a browser page opens for authorization, then come back and click "I have authorized, check again".',
+        authCommand: 'wkgeo login',
+        authCheck: 'I have authorized, check again',
+        authChecking: 'Checking authorization…',
+        authOk: 'Authorized: the site list is readable',
+        authNote: 'Credentials are kept by the wkgeo CLI itself; this plugin never reads, shows or uploads your password or token.',
+        needRoot: 'Pick a root folder in step 1 first, then you can create a site.',
+        needAuth: 'Finish authorization in step 2 (wkgeo login) before creating a site.',
+        blockedTitle: 'One more step before creating a site',
+        crashTitle: 'wkgeo site ops · panel error',
+        crashRefresh: 'Reload UI',
+        regWarn: 'Panel self-check: ',
         rootLabel: 'Site root folder',
         rootUnset: 'no root folder yet',
         rootPick: 'Choose root',
@@ -331,7 +369,9 @@ window.__ModuleLoader__.load({
         height: '100%',
         width: '100%',
         minWidth: 0,
-        minHeight: 0,
+        // 老板 2026-10-30 白屏复盘：主区容器是 flex 项，历史上有过「高度塌成 0、看起来全白」的情况，
+        // 这里给一个最小高度兜底；真渲染出来了，内容就一定会占可见高度。
+        minHeight: '320px',
         flex: '1 1 auto',
         gap: '10px',
         padding: '12px',
@@ -956,12 +996,8 @@ window.__ModuleLoader__.load({
       }
       render() {
         if (this.state.error) {
-          const msg = String((this.state.error && this.state.error.message) || this.state.error || 'unknown')
-          return h(
-            'div',
-            { style: { ...STYLE.err, margin: '12px', fontSize: '12px', whiteSpace: 'pre-wrap' } },
-            '面板渲染出错：' + msg.slice(0, 600),
-          )
+          // 老板 2026-10-30：渲染异常不许变成一片空白 —— 消息 + 堆栈摘要直接打在面板上。
+          return h(PanelCrash, { error: this.state.error, where: '面板渲染（PanelBoundary 捕获）' })
         }
         return this.props.children
       }
@@ -1512,6 +1548,107 @@ window.__ModuleLoader__.load({
       )
     }
 
+    /**
+     * 面板自检记录（老板 2026-10-30 白屏复盘）：
+     * 旧代码里注册失败被 `try{...}catch{return undefined}` 静默吞掉 —— 左栏有图标、点进去一片空白，
+     * 界面上一个字都没有，只能靠猜。现在所有注册失败都记进这里，面板会把它打在首屏/错误页上。
+     */
+    const REGISTRATION = { ok: {}, errors: [] }
+
+    function noteRegistration(label, err) {
+      if (!err) {
+        REGISTRATION.ok[label] = true
+        return
+      }
+      const msg = String((err && err.message) || err || 'unknown')
+      REGISTRATION.ok[label] = false
+      const entry = label + ' → ' + msg
+      if (REGISTRATION.errors[REGISTRATION.errors.length - 1] !== entry) {
+        REGISTRATION.errors.push(entry)
+        if (REGISTRATION.errors.length > 6) REGISTRATION.errors.shift()
+      }
+      try {
+        console.error('[wkgeo-ops] slot register failed · ' + label, err)
+      } catch (_consoleErr) {
+        /* 忽略 */
+      }
+    }
+
+    /** 错误兜底页：异常消息 + 堆栈摘要 + 注册自检，保证「绝不静默空白」。 */
+    function PanelCrash(props) {
+      const err = props ? props.error : null
+      const where = (props && props.where) || '面板'
+      const msg = String((err && err.message) || err || 'unknown')
+      const stack = err && err.stack ? String(err.stack) : ''
+      const trace = stack ? stack.split('\n').slice(0, 8).join('\n') : ''
+      return h(
+        'div',
+        { style: STYLE.wrap },
+        h('div', { style: STYLE.bar }, h('span', { style: STYLE.barTitle }, MESSAGES.zh.crashTitle)),
+        h(
+          'div',
+          {
+            style: {
+              ...STYLE.err,
+              whiteSpace: 'pre-wrap',
+              wordBreak: 'break-word',
+              fontFamily: 'ui-monospace, SFMono-Regular, Consolas, monospace',
+              fontSize: '12px',
+              lineHeight: '1.5',
+              padding: '10px',
+              border: '1px solid var(--dsw-alias-border-l2)',
+              borderRadius: '8px',
+              background: 'var(--dsw-alias-bg-layer-2)',
+            },
+          },
+          '位置：' + where + '\n' + msg + (trace ? '\n\n堆栈摘要：\n' + trace : ''),
+        ),
+        REGISTRATION.errors.length
+          ? h(
+              'div',
+              { style: { ...STYLE.warn, whiteSpace: 'pre-wrap', fontSize: '11px' } },
+              MESSAGES.zh.regWarn + '\n' + REGISTRATION.errors.slice(-4).join('\n'),
+            )
+          : null,
+        h(
+          'div',
+          { style: STYLE.actions },
+          h(
+            'button',
+            {
+              type: 'button',
+              style: STYLE.btnPrimary,
+              onClick: () => {
+                try {
+                  if (typeof window !== 'undefined' && window.location) window.location.reload()
+                } catch (_reloadErr) {
+                  /* 忽略 */
+                }
+              },
+            },
+            MESSAGES.zh.crashRefresh,
+          ),
+        ),
+      )
+    }
+
+    /** 首次进入的三步指示条：① 选页根目录 → ② 授权 → ③ 建站 */
+    function stepChip(t, label, done, active) {
+      const mark = done ? '✓ ' : active ? '● ' : '○ '
+      return h(
+        'span',
+        {
+          style: {
+            ...STYLE.pill,
+            color: done ? '#15803d' : active ? 'var(--dsw-alias-label-primary)' : 'var(--dsw-alias-label-tertiary)',
+            borderColor: done ? '#15803d' : undefined,
+            opacity: done || active ? 1 : 0.75,
+          },
+        },
+        mark + label,
+      )
+    }
+
     /** 面板主体 */
     function PanelBody(ctx) {
       const t = makeT(ctx)
@@ -1570,6 +1707,18 @@ window.__ModuleLoader__.load({
       }, [])
 
       const openWizard = () => {
+        // 三步顺序（老板 2026-10-30）：① 页根目录 → ② 授权 → ③ 建站。前两步没完成不许进向导。
+        if (!rootReady) {
+          setView('init')
+          setInitError(t('needRoot'))
+          return
+        }
+        if (!authed) {
+          setInitError('')
+          setView('list')
+          load(true)
+          return
+        }
         setWizard(defaultWizard())
         setWizardError('')
         setRun({ busy: false, ok: false, siteId: '', log: [], unfilled: [], gaps: [] })
@@ -1824,12 +1973,25 @@ window.__ModuleLoader__.load({
       const rootReady = Boolean(cfg.rootDir)
       const boundCount = Object.keys(folders || {}).length
       const cfgDown = cfg.phase === 'error'
+      // 第 2 步「授权」的判定：站点接口能拿到 ok 数据即视为已授权；明确返回 NOT_LOGGED_IN 即未授权。
+      const authed = Boolean(data) && data.ok !== false && !isLoginIssue
+      const needAuth = Boolean(data) && isLoginIssue
+      const canCreate = rootReady && authed
+      const blockedHint = !rootReady ? t('needRoot') : !authed ? t('needAuth') : ''
+
+      const steps = h(
+        'div',
+        { style: { display: 'flex', alignItems: 'center', flexWrap: 'wrap', gap: '6px' } },
+        stepChip(t, '1 · ' + t('stepRoot'), rootReady, !rootReady),
+        stepChip(t, '2 · ' + t('stepAuth'), authed, rootReady && !authed),
+        stepChip(t, '3 · ' + t('stepCreate'), false, canCreate),
+      )
 
       const head = h(
         'div',
         { style: STYLE.bar },
         h('span', { style: STYLE.barTitle }, t('title')),
-        h('span', { style: { ...STYLE.barMeta, fontSize: '10px', opacity: 0.65 }, title: 'client build' }, 'v5'),
+        h('span', { style: { ...STYLE.barMeta, fontSize: '10px', opacity: 0.65 }, title: 'client build' }, 'v6'),
         h(
           'span',
           { style: { ...STYLE.badge, cursor: 'pointer' }, title: cfg.rootDir || t('rootUnset'), onClick: openBrowserRoot },
@@ -1837,7 +1999,17 @@ window.__ModuleLoader__.load({
         ),
         h('button', { type: 'button', style: STYLE.btn, disabled: busy, onClick: () => load(true), title: t('refresh') }, busy ? t('refreshing') : t('refresh')),
         sites.length > 0 && (view === 'list' || view === 'detail')
-          ? h('button', { type: 'button', style: STYLE.btn, onClick: openWizard }, t('create'))
+          ? h(
+              'button',
+              {
+                type: 'button',
+                style: canCreate ? STYLE.btn : { ...STYLE.btn, opacity: 0.55, cursor: 'not-allowed' },
+                disabled: !canCreate,
+                title: blockedHint || t('create'),
+                onClick: openWizard,
+              },
+              t('create'),
+            )
           : null,
         h(
           'span',
@@ -1847,6 +2019,34 @@ window.__ModuleLoader__.load({
         ),
       )
 
+      // 第 2 步：授权卡片（放在建站之前，未授权时首屏就是它，建站按钮全部禁用并提示去哪一步）
+      const authPanel = h(
+        'div',
+        { style: STYLE.initCard },
+        h('div', { style: STYLE.bar }, h('span', { style: STYLE.barTitle }, t('authTitle'))),
+        h('div', { style: STYLE.hint }, t('authHint')),
+        h('div', { style: STYLE.growRow }, h('code', { style: STYLE.code }, t('authCommand'))),
+        h(
+          'div',
+          { style: STYLE.actions },
+          h(
+            'button',
+            { type: 'button', style: STYLE.btnPrimary, disabled: busy, onClick: () => load(true) },
+            busy ? t('authChecking') : t('authCheck'),
+          ),
+          h('button', { type: 'button', style: STYLE.btn, onClick: () => setView('init') }, t('rootChange')),
+          // 第 3 步的入口先亮出来但禁用：未授权时点不动，title 说明缺的是哪一步
+          h(
+            'button',
+            { type: 'button', style: STYLE.btn, disabled: true, title: blockedHint || t('needAuth') },
+            t('create'),
+          ),
+        ),
+        needAuth && !busy ? h('div', { style: STYLE.err }, t('loginHint')) : null,
+        state.error ? h('div', { style: STYLE.err }, String(state.error).slice(0, 300)) : null,
+        h('div', { style: STYLE.note }, t('authNote')),
+      )
+
       const initPanel = h(
         'div',
         { style: STYLE.initCard },
@@ -1945,6 +2145,9 @@ window.__ModuleLoader__.load({
         })
       } else if (!rootReady && !cfgDown) {
         body = initPanel
+      } else if (needAuth) {
+        // 第 2 步：目录已选、但还没授权 → 先授权，建站按钮此时是禁用的
+        body = authPanel
       } else if (state.phase === 'loading' && !data) {
         body = h('div', { style: STYLE.state }, h('div', { style: STYLE.stateTitle }, t('refreshing')))
       } else if (state.error) {
@@ -1953,9 +2156,19 @@ window.__ModuleLoader__.load({
           { style: STYLE.state },
           h('div', { style: STYLE.stateTitle }, isLoginIssue ? t('loginHint') : t('error')),
           h('div', null, String(state.error).slice(0, 300)),
-          isLoginIssue ? h('div', null, t('emptyHint')) : null,
+          !canCreate ? h('div', { style: STYLE.hint }, blockedHint) : null,
           h('button', { type: 'button', style: STYLE.btn, onClick: () => load(true) }, t('retry')),
-          h('button', { type: 'button', style: STYLE.btnPrimary, onClick: openWizard }, t('create')),
+          h(
+            'button',
+            {
+              type: 'button',
+              style: canCreate ? STYLE.btnPrimary : { ...STYLE.btnPrimary, opacity: 0.55, cursor: 'not-allowed' },
+              disabled: !canCreate,
+              title: blockedHint || t('create'),
+              onClick: openWizard,
+            },
+            t('create'),
+          ),
         )
       } else if (sites.length === 0) {
         body = h(
@@ -1963,7 +2176,18 @@ window.__ModuleLoader__.load({
           { style: STYLE.state },
           h('div', { style: STYLE.stateTitle }, t('empty')),
           h('div', null, t('emptyHint')),
-          h('button', { type: 'button', style: { ...STYLE.btnPrimary, ...STYLE.btnBlock }, onClick: openWizard }, t('createFirst')),
+          !canCreate ? h('div', { style: STYLE.hint }, blockedHint) : null,
+          h(
+            'button',
+            {
+              type: 'button',
+              style: canCreate ? { ...STYLE.btnPrimary, ...STYLE.btnBlock } : { ...STYLE.btn, ...STYLE.btnBlock, opacity: 0.55, cursor: 'not-allowed' },
+              disabled: !canCreate,
+              title: blockedHint || t('createFirst'),
+              onClick: openWizard,
+            },
+            t('createFirst'),
+          ),
           h('div', { style: STYLE.hint }, '没登录会取不到站点：', h('code', { style: STYLE.code }, 'wkgeo login')),
         )
       } else {
@@ -1980,7 +2204,16 @@ window.__ModuleLoader__.load({
               onPickFolder: openBrowserSite,
             }),
           ),
-          h('div', { key: '__new__', style: STYLE.newCard, onClick: openWizard }, t('newCard')),
+          h(
+            'div',
+            {
+              key: '__new__',
+              style: canCreate ? STYLE.newCard : { ...STYLE.newCard, opacity: 0.55, cursor: 'not-allowed' },
+              title: blockedHint || t('newCard'),
+              onClick: canCreate ? openWizard : undefined,
+            },
+            canCreate ? t('newCard') : t('blockedTitle') + '：' + blockedHint,
+          ),
         )
       }
 
@@ -1988,6 +2221,8 @@ window.__ModuleLoader__.load({
         'div',
         { style: STYLE.wrap },
         head,
+        steps,
+        rootReady ? h('div', { style: { ...STYLE.hint, fontSize: '11px' }, title: cfg.rootDir }, t('stepRootDone', { dir: cfg.rootDir })) : null,
         cfgDown ? h('div', { style: STYLE.warn }, t('cfgUnavailable')) : null,
         rootReady && cfg.exists === false ? h('div', { style: STYLE.warn }, t('rootMissingNow')) : null,
         folderError ? h('div', { style: STYLE.err }, String(folderError).slice(0, 300)) : null,
@@ -1998,25 +2233,98 @@ window.__ModuleLoader__.load({
           data && data.ageMs != null ? t('updated', { t: new Date().toLocaleTimeString() }) : '',
           boundCount > 0 ? ' · 📁 ' + boundCount : '',
         ),
+        REGISTRATION.errors.length
+          ? h(
+              'div',
+              { style: { ...STYLE.warn, whiteSpace: 'pre-wrap', fontSize: '11px' } },
+              t('regWarn') + REGISTRATION.errors.slice(-3).join(' | '),
+            )
+          : null,
       )
     }
 
     function apply(ctx) {
       // 面板入口：错误边界包住面板本身 —— 渲染异常变成可复制的报错文本，绝不整块空白。
-      const OpsPanel = () => h(PanelBoundary, null, h(PanelBody, ctx))
+      // 面板入口：① 函数级 try/catch 兜住「构造元素树就抛错」；② PanelBoundary 兜住渲染期异常。
+      // 两条都不许再变成空白 —— 出错就打错误页（异常消息 + 堆栈摘要 + 注册自检）。
+      const OpsPanel = () => {
+        try {
+          return h(PanelBoundary, null, h(PanelBody, ctx))
+        } catch (err) {
+          return h(PanelCrash, { error: err, where: 'OpsPanel 构造元素树' })
+        }
+      }
 
-      const scope = (label, fn) => {
+      /** 注册期兜底：失败必须记账（旧代码在这里静默 return undefined，正是白屏查不出来的原因）。 */
+      const guard = (label, fn) => {
         try {
           if (typeof ctx.effect === 'function') return ctx.effect(fn, label)
           return fn()
-        } catch (_err) {
+        } catch (err) {
+          noteRegistration(label, err)
           return undefined
         }
       }
 
-      scope('wkgeo-ops:locale', () => ctx.locale.register(NS, { zh: MESSAGES.zh, en: MESSAGES.en }))
+      const SLOT_RETRY_MAX = 20
+      const SLOT_RETRY_MS = 300
+
+      /**
+       * 槽位注册（白屏根因修复，老板 2026-10-30）：
+       * DSH 的 SlotCore.register 在「槽位还没被父 entry 的 children 表声明」时会**同步抛错**
+       * （`slot "main" is not declared (a parent entry's children table must declare it)`）。
+       * 旧代码是「直接 register + catch 静默吞掉」：只要那次 register 抛了，`main` 就永远不存在，
+       * 结果正是「左栏图标在、点进去一片空白、界面没有任何报错」。
+       * 官方范式（DSH 内置插件全部如此）是 ctx.slots.inject(name, () => ctx.slots.register(...))：
+       * 声明前挂起、声明后自动补注册；这里再叠加定时重试，双保险。
+       */
+      const slotRegister = (label, options, component) => {
+        const name = options && options.name
+        let off = null
+        let timer = null
+        let tries = 0
+        let disposed = false
+        const attempt = () => {
+          if (disposed) return undefined
+          try {
+            off = ctx.slots.register(options, component)
+            noteRegistration(label, null)
+            return off
+          } catch (err) {
+            noteRegistration(label, err)
+            tries += 1
+            if (tries <= SLOT_RETRY_MAX && !timer) {
+              timer = setTimeout(() => {
+                timer = null
+                attempt()
+              }, SLOT_RETRY_MS)
+            }
+            return undefined
+          }
+        }
+        let offInject = null
+        if (typeof ctx.slots.inject === 'function') {
+          try {
+            offInject = ctx.slots.inject(name, attempt)
+          } catch (err) {
+            noteRegistration(label, err)
+            attempt()
+          }
+        } else {
+          attempt()
+        }
+        return () => {
+          disposed = true
+          if (timer) clearTimeout(timer)
+          timer = null
+          if (typeof offInject === 'function') offInject()
+          if (typeof off === 'function') off()
+        }
+      }
+
+      guard('wkgeo-ops:locale', () => ctx.locale.register(NS, { zh: MESSAGES.zh, en: MESSAGES.en }))
 
-      scope('wkgeo-ops:tab', () =>
+      guard('wkgeo-ops:tab', () =>
         ctx.sidebarRightTabs.register({
           id: PANEL_ID,
           kind: 'wkgeo-ops',
@@ -2043,18 +2351,19 @@ window.__ModuleLoader__.load({
         }),
       )
 
-      scope('wkgeo-ops:pane', () =>
-        ctx.slots.inject('sidebar.right.pane.tab', () =>
-          ctx.slots.register(
-            { name: 'sidebar.right.pane.tab', key: PANEL_ID, locale: NS, inject: () => ({}) },
-            OpsPanel,
-          ),
+      guard('wkgeo-ops:pane', () =>
+        slotRegister(
+          'sidebar.right.pane.tab',
+          { name: 'sidebar.right.pane.tab', key: PANEL_ID, locale: NS, inject: () => ({}) },
+          OpsPanel,
         ),
       )
 
-      scope('wkgeo-ops:pane-title', () =>
-        ctx.slots.inject('sidebar.right.pane.tab.title', () =>
-          ctx.slots.register({ name: 'sidebar.right.pane.tab.title', key: PANEL_ID }, () => h('span', null, MESSAGES.zh.title)),
+      guard('wkgeo-ops:pane-title', () =>
+        slotRegister(
+          'sidebar.right.pane.tab.title',
+          { name: 'sidebar.right.pane.tab.title', key: PANEL_ID },
+          () => h('span', null, SIDEBAR_ROW_LABEL),
         ),
       )
 
@@ -2063,8 +2372,9 @@ window.__ModuleLoader__.load({
       //   ① sidebar.panellist —— 左栏里的一行图标（id = PANEL_ID）
       //   ② main             —— 点该图标后中央区域渲染的面板（key = PANEL_ID）
       // 少一条就看不到入口（只有①会点不开，只有②没有图标）。停用插件时把界面交还对话。
-      scope('wkgeo-ops:sidebar-entry', () => {
-        const offRow = ctx.slots.register(
+      guard('wkgeo-ops:sidebar-row', () =>
+        slotRegister(
+          'sidebar.panellist',
           {
             name: 'sidebar.panellist',
             id: PANEL_ID,
@@ -2073,24 +2383,23 @@ window.__ModuleLoader__.load({
             locale: NS,
           },
           (owner = {}) => h(OpsIcon, { size: owner.size }),
-        )
-        const offPanel = ctx.slots.register(
-          { name: 'main', key: PANEL_ID, locale: NS, inject: () => ({}) },
-          OpsPanel,
-        )
-        return () => {
-          try {
-            const layout = typeof ctx.get === 'function' ? ctx.get('layout') : null
-            const info = layout && layout.panelInfo
-            if (info && typeof info.getSnapshot === 'function') {
-              const snapshot = info.getSnapshot()
-              if (snapshot && snapshot.activePanelId === PANEL_ID) layout.selectPanel(null)
-            }
-          } catch (_err) {
-            /* 尽力而为 */
+        ),
+      )
+
+      guard('wkgeo-ops:main', () =>
+        slotRegister('main', { name: 'main', key: PANEL_ID, locale: NS, inject: () => ({}) }, OpsPanel),
+      )
+
+      guard('wkgeo-ops:cleanup', () => () => {
+        try {
+          const layout = typeof ctx.get === 'function' ? ctx.get('layout') : null
+          const info = layout && layout.panelInfo
+          if (info && typeof info.getSnapshot === 'function') {
+            const snapshot = info.getSnapshot()
+            if (snapshot && snapshot.activePanelId === PANEL_ID) layout.selectPanel(null)
           }
-          offRow()
-          offPanel()
+        } catch (_err) {
+          /* 尽力而为 */
         }
       })
     }

package/lib/index.js

@@ -2,7 +2,10 @@
  * dsh-wkgeo-ops · DSH 插件「网站运营」——服务端 cordis 插件
  *
  * 作用：把 wkgeo CLI（仓库内 cli/wkgeo.mjs，默认值见 DEFAULT_CLI_PATH）的站点运营能力，
- *      以 16 个 DSH agent 工具 + 6 条同源 HTTP 路由（面板取数 / 建站向导 / 模板选项 / 根目录 / 浏览 / 站点文件夹）暴露给 DSH。
+ *      以 21 个 DSH agent 工具 + 6 条同源 HTTP 路由（面板取数 / 建站向导 / 模板选项 / 根目录 / 浏览 / 站点文件夹）暴露给 DSH。
+ *
+ * v0.2.4（2026-10-30 老板「加 GEO/SEO CLI 工具」）：新增 5 个工具 —— geo audit（只读体检）/ geo llms（默认 dry-run）/
+ * geo robots（show 只读，allow-ai / block-ai 需 confirm）/ geo brands（后台未配置时原样转述 not_configured）/ seo audit（只读）。
  *
  * v0.2.0（2026-10-30 老板「接收 dsh，完成 cli 后续能力对接，然后发布一个包」）：
  * 在原有 7 个工具上补齐 content apply / fill / check、templates list、template init / validate / pack / publish、domains list；
@@ -283,6 +286,59 @@ export function buildDomainRecordsArgs({ site } = {}) {
   return args
 }
 
+// ---------------------------------------------------------------------------
+// 1c. 纯函数：v0.2.4 新增 GEO / SEO 工具的 CLI 参数（同样只拼参数，不重写业务）
+// ---------------------------------------------------------------------------
+
+/** `geo robots --mode` 的三个合法值（与 CLI 的 --mode 完全一致） */
+export const GEO_ROBOTS_MODES = ['allow-ai', 'block-ai', 'show']
+
+/** mode 归一：非法 / 缺省一律落到只读的 show（绝不因为写错参数就改成写盘） */
+export function normalizeGeoRobotsMode(mode) {
+  const value = typeof mode === 'string' ? mode.trim().toLowerCase() : ''
+  return GEO_ROBOTS_MODES.includes(value) ? value : 'show'
+}
+
+/** `geo audit <dir> --json`（只读） */
+export function buildGeoAuditArgs({ dir } = {}) {
+  return ['geo', 'audit', String(dir == null ? '' : dir), '--json']
+}
+
+/** `geo llms <dir> [--check] [--base-url <url>] [--confirm] --json`（不加 --confirm 就是 CLI 自己的 dry-run） */
+export function buildGeoLlmsArgs({ dir, check, baseUrl, confirm } = {}) {
+  const args = ['geo', 'llms', String(dir == null ? '' : dir)]
+  pushFlag(args, '--check', check)
+  if (baseUrl) args.push('--base-url', String(baseUrl))
+  pushFlag(args, '--confirm', confirm)
+  args.push('--json')
+  return args
+}
+
+/** `geo robots <dir> --mode <allow-ai|block-ai|show> [--confirm] --json` */
+export function buildGeoRobotsArgs({ dir, mode, confirm } = {}) {
+  const args = ['geo', 'robots', String(dir == null ? '' : dir), '--mode', normalizeGeoRobotsMode(mode)]
+  pushFlag(args, '--confirm', confirm)
+  args.push('--json')
+  return args
+}
+
+/**
+ * `geo brands [--domain <域>] [--lang <语言>] --json`。
+ * 插件的 project 参数映射到 CLI 的 --domain（CLI 那个参数就叫 --domain）。
+ */
+export function buildGeoBrandsArgs({ project, lang } = {}) {
+  const args = ['geo', 'brands']
+  if (project) args.push('--domain', String(project))
+  if (lang) args.push('--lang', String(lang))
+  args.push('--json')
+  return args
+}
+
+/** `seo audit <dir> --json`（只读；CLI 这一层不联网，只认本地目录） */
+export function buildSeoAuditArgs({ dir } = {}) {
+  return ['seo', 'audit', String(dir == null ? '' : dir), '--json']
+}
+
 /** 把用户给的站点路径规整成 CLI 认识的形式（前导斜杠、去空白、空则 "/"） */
 export function normalizePath(path) {
   if (typeof path !== 'string') return '/'
@@ -1333,6 +1389,122 @@ export function renderDomainsText(value = {}) {
   return renderCliText(value)
 }
 
+/**
+ * GEO / SEO 体检结果渲染：分数 + 等级 + 问题分布 + 关键 issue 前 5 条。
+ * 两个 audit（geo / seo）共用；只读命令，所以不给「要不要写盘」这类提示。
+ */
+export function renderAuditText(value = {}, label = '体检') {
+  if (!value || value.ok !== true) return renderCliText(value)
+  const data = value.data || {}
+  const lines = []
+  const score = data.score
+  const grade = data.grade ? '（' + data.grade + '）' : ''
+  const pages = Number.isFinite(data.pages) ? data.pages : 0
+  lines.push('✔ ' + label + '：' + (score != null ? score + ' / 100' + grade : '未给分数') + ' · ' + pages + ' 个页面' + (data.dir ? '\n  目录：' + data.dir : ''))
+  const sum = data.summary || {}
+  if (sum.total != null) {
+    lines.push('问题分布：error ' + (sum.error || 0) + ' / warn ' + (sum.warn || 0) + ' / info ' + (sum.info || 0) + '，共 ' + (sum.total || 0) + ' 条' + (data.truncated ? '（已截断）' : ''))
+  }
+  const issues = Array.isArray(data.issues) ? data.issues : []
+  const top = issues.slice(0, 5)
+  top.forEach((it, i) => {
+    const item = it || {}
+    const where = item.file || item.page || item.url || ''
+    lines.push('  ' + (i + 1) + '. [' + (item.severity || 'info') + '] ' + (where ? where + ' · ' : '') + (item.message || item.rule || ''))
+    if (item.suggestion) lines.push('     → ' + item.suggestion)
+  })
+  if (issues.length > top.length) lines.push('… 其余 ' + (issues.length - top.length) + ' 条在工具返回值的 data.issues 里')
+  else if (issues.length === 0) lines.push('没有发现问题。')
+  return lines.join('\n')
+}
+
+/** 写盘清单渲染：CLI 里 written[] 可能是「路径字符串」也可能是 `{name,path,bytes}` 对象 */
+function writtenPaths(list) {
+  if (!Array.isArray(list)) return []
+  return list
+    .map((item) => (typeof item === 'string' ? item : item && typeof item === 'object' ? item.path || item.name || '' : ''))
+    .filter((item) => typeof item === 'string' && item !== '')
+}
+
+/** `geo llms` 渲染：写了哪两个文件（或 dry-run 预览）、覆盖多少页 */
+export function renderGeoLlmsText(value = {}) {
+  if (!value || value.ok !== true) return renderCliText(value)
+  const data = value.data || {}
+  const dry = data.dry_run === true
+  const lines = [dry ? '👀 geo llms 预览（dry-run，一个字节都没写）' : '✔ geo llms 已生成']
+  const txt = data.llms_txt || {}
+  const full = data.llms_full || {}
+  lines.push('  - llms.txt：' + (txt.path || '(未给路径)') + (txt.chars != null ? '（' + txt.chars + ' 字符）' : ''))
+  lines.push('  - llms-full.txt：' + (full.path || '(未给路径)') + (full.chars != null ? '（' + full.chars + ' 字符）' : ''))
+  const written = writtenPaths(data.written)
+  lines.push(written.length > 0 ? '写入：' + written.join(' / ') : '本次没有写任何文件' + (dry ? '（dry-run）' : ''))
+  const pages = Array.isArray(data.pages) ? data.pages.length : 0
+  const categories = Array.isArray(data.categories) ? data.categories : []
+  lines.push('覆盖页面 ' + pages + ' 个' + (categories.length > 0 ? '，栏目：' + categories.join(' / ') : ''))
+  const notes = Array.isArray(data.notes) ? data.notes : []
+  notes.slice(0, 3).forEach((note) => lines.push('注意：' + (typeof note === 'string' ? note : note.message || previewJson(note, 200))))
+  if (dry) lines.push('要真写盘：同一个工具带 confirm:true 重跑（写完仍是幂等的）。')
+  return lines.join('\n')
+}
+
+/** `geo robots` 渲染：show 看每个爬虫的状态；allow-ai / block-ai 看 diff 与是否写盘 */
+export function renderGeoRobotsText(value = {}) {
+  if (!value || value.ok !== true) return renderCliText(value)
+  const data = value.data || {}
+  const mode = data.mode || 'show'
+  const lines = []
+  if (mode === 'show') {
+    lines.push('✔ robots.txt 的 AI 爬虫规则（只读，未写盘）：' + (data.path || ''))
+    lines.push(data.exists === false ? '  robots.txt 不存在：目前没有任何 AI 策略（也没有被整站封禁）' : '  robots.txt 已存在；wkgeo 托管段' + (data.managed_block ? '存在' : '不存在（还没生成过）'))
+    const bots = Array.isArray(data.bots) ? data.bots : []
+    bots.forEach((bot) => {
+      lines.push('  - ' + (bot.bot || bot.user_agent || '?') + '：' + (bot.status || '') + (bot.explicit ? '（显式规则）' : '（未显式列出）') + (bot.rules ? ' · ' + bot.rules : ''))
+    })
+    const counts = data.counts || {}
+    if (counts.allowed != null) lines.push('汇总：放行 ' + (counts.allowed || 0) + ' / 禁止 ' + (counts.blocked || 0) + ' / 未列出 ' + (counts.unlisted || 0))
+    return lines.join('\n')
+  }
+  const dry = data.dry_run === true
+  lines.push((dry ? '👀 geo robots ' + mode + ' 预览（dry-run，未写盘）' : '✔ geo robots ' + mode + ' 已写入') + (data.path ? '\n  ' + data.path : ''))
+  const added = Array.isArray(data.added) ? data.added.length : 0
+  const removed = Array.isArray(data.removed) ? data.removed.length : 0
+  lines.push('改动：' + (data.action || '（未给）') + (added > 0 ? ' · 新增 ' + added + ' 行' : '') + (removed > 0 ? ' · 删除 ' + removed + ' 行' : ''))
+  const bots = Array.isArray(data.bots) ? data.bots : []
+  if (bots.length > 0) lines.push('涉及 UA：' + bots.map((bot) => (typeof bot === 'string' ? bot : (bot && (bot.bot || bot.user_agent)) || '?')).join(' / '))
+  const written = writtenPaths(data.written)
+  if (written.length > 0) lines.push('写入：' + written.join(' / '))
+  if (dry) lines.push(mode === 'block-ai' ? '注意：block-ai 会真的挡住 AI 收录；确认后带 confirm:true 重跑。' : '要真写盘：同一个工具带 confirm:true 重跑。')
+  return lines.join('\n')
+}
+
+/** `geo brands` 渲染：未配置后端时把 not_configured 翻成人话（绝不假装成功） */
+export function renderGeoBrandsText(value = {}) {
+  const data = (value && value.data) || {}
+  if (value && value.ok === true && data.status === 'not_configured') {
+    const contract = data.contract || {}
+    const env = contract.env || 'WKGEO_GEO_API'
+    const req = contract.request || {}
+    const lines = [
+      '⚠ 品牌收录跟踪还没接上（CLI 返回 status: not_configured）',
+      '  后台基址没配置：本次一个请求都没发，也没有任何本地假数据。',
+      '要启用：在运行 DSH 的环境里配置环境变量 ' + env + '（后台基址），再重跑本工具。',
+    ]
+    if (req.path) lines.push('接口契约：' + (req.method || 'GET') + ' ' + req.path + '?domain=<站点域名>&lang=<语言> → brands[].platforms[]（status: none | listed | top | cited）')
+    lines.push('说明：品牌数据只能来自后台，CLI 绝不本地伪造「看起来像真数据」的占位记录。')
+    return lines.join('\n')
+  }
+  if (!value || value.ok !== true) return renderCliText(value)
+  const brands = Array.isArray(data.brands) ? data.brands : []
+  if (brands.length === 0) return '✔ geo brands 成功，但后台返回的品牌列表为空（暂时没有收录 / 引用记录）。'
+  const lines = ['✔ 品牌收录：' + brands.length + ' 个（平台 ' + (data.platforms != null ? data.platforms : '?') + ' 个）']
+  brands.slice(0, 5).forEach((brand) => {
+    const platforms = Array.isArray(brand.platforms) ? brand.platforms : []
+    lines.push('  - ' + (brand.name || '(未命名)') + '：' + (platforms.length > 0 ? platforms.map((p) => (p.platform || '?') + '=' + (p.status || '?') + (p.rank != null ? ' #' + p.rank : '')).join(' / ') : '无平台数据'))
+  })
+  if (brands.length > 5) lines.push('… 其余 ' + (brands.length - 5) + ' 个见 data.brands')
+  return lines.join('\n')
+}
+
 /**
  * 造 4 个工具定义。deps.run 可注入（测试用假输出）。
  * @returns {Array<object>} 工具定义数组（形状对齐 DSH 已装插件的 tools.register）
@@ -1972,7 +2144,138 @@ export function createTools(deps = {}) {
     },
   }
 
-  return [sitesList, siteStatus, sitePreview, publish, siteCreate, templateFromUrl, templateFromDir, contentApply, contentFill, contentCheck, templatesList, templateInit, templateValidate, templatePack, templatePublish, domainsList]
+  // -------------------------------------------------------------------------
+  // v0.2.4：GEO / SEO 六件套里的 5 个（geo audit / llms / robots / brands + seo audit）
+  // 全部是薄封装：spawn node cli/wkgeo.mjs … --json → 解析信封 → 结构化返回。
+  // -------------------------------------------------------------------------
+
+  const geoAudit = {
+    name: 'wkgeo_geo_audit',
+    description:
+      '本地站点产物 GEO（生成式引擎优化）体检，底层 `wkgeo geo audit`：20 项加权评分（0-100）+ 等级（good / fair / poor）+ issues[]（error / warn / info，每条带位置与改法）。**只读**：不联网、不写任何文件；要补 llms.txt / robots.txt 用 wkgeo_geo_llms / wkgeo_geo_robots。有问题也返回 ok:true（看 score / issues），只有目录不存在或目录里没有 .html 才 ok:false。',
+    parameters: paramsSchema(
+      {
+        dir: { type: 'string', description: '站点产物目录（含 index.html 等静态页面；建议给绝对路径，如 F:\\cloudbase\\dist）' },
+      },
+      ['dir'],
+    ),
+    output: { schema: RESULT_SCHEMA, render: (_args, value) => [{ type: 'text', text: renderAuditText(value, 'GEO 体检（geo audit）') }] },
+    async execute(args = {}) {
+      const dir = textOf(args.dir)
+      if (!dir) return missingArg('dir', '给站点产物目录（含 index.html 的目录，建议绝对路径）', 'geo audit')
+      const res = await runCli(buildGeoAuditArgs({ dir }))
+      return normalizeCliResult(res, { command: 'geo audit' })
+    },
+  }
+
+  const geoLlms = {
+    name: 'wkgeo_geo_llms',
+    description:
+      '按目录生成给 AI 读的两份索引：llms.txt（站点标题 + 描述 + 按栏目分节的「- [标题](URL)：一句话摘要」）与 llms-full.txt（每页正文全文），底层 `wkgeo geo llms`。**不传 confirm 就是 dry-run**：只把两份文件内容算出来给你看，一个字节都不写；使用者确认后才带 confirm:true 真写盘（写到 <dir>/llms.txt 与 <dir>/llms-full.txt，幂等可重跑）。标题 / 摘要只从页面与站点清单里取，取不到就留空，不编造。',
+    parameters: paramsSchema({
+      dir: { type: 'string', description: '站点产物目录（写 <dir>/llms.txt 与 <dir>/llms-full.txt；建议绝对路径）' },
+      confirm: { type: 'boolean', description: '确认真写盘才传 true；不传或 false = 只预览（dry-run）' },
+    }),
+    output: { schema: RESULT_SCHEMA, render: (_args, value) => [{ type: 'text', text: renderGeoLlmsText(value) }] },
+    async execute(args = {}) {
+      const dir = textOf(args.dir)
+      if (!dir) return missingArg('dir', '给站点产物目录（llms.txt 会写在这个目录下）', 'geo llms')
+      const confirm = args.confirm === true
+      const res = await runCli(buildGeoLlmsArgs({ dir, confirm }))
+      return normalizeCliResult(res, {
+        command: 'geo llms',
+        executed: confirm,
+        needsConfirm: !confirm,
+        reason: confirm ? '' : 'dry-run：只打印 llms.txt / llms-full.txt 的内容，一个字节都没写。看完无误后，同一个工具带 confirm:true 重跑才落盘。',
+      })
+    },
+  }
+
+  const geoRobots = {
+    name: 'wkgeo_geo_robots',
+    description:
+      '管理 robots.txt 里的 AI 爬虫策略段（GPTBot / OAI-SearchBot / ClaudeBot / PerplexityBot / Google-Extended / Bingbot），底层 `wkgeo geo robots`。mode=show（默认）**只读**：列出当前每个 AI 爬虫的放行 / 封禁状态，不写盘；mode=allow-ai / block-ai 是**会写文件**的策略生成——不传 confirm 只给 diff（dry-run），确认后带 confirm:true 才写。幂等：策略段用 `# >>> wkgeo:geo-ai >>>` 包起来整段替换，段外人工规则一个字节都不动。**block-ai 会真的挡住 AI 收录**，除非使用者明确要求，别用。',
+    parameters: paramsSchema({
+      dir: { type: 'string', description: '站点产物目录（读 / 写 <dir>/robots.txt；建议绝对路径）' },
+      mode: { type: 'string', enum: GEO_ROBOTS_MODES, description: 'allow-ai = 6 个 AI 爬虫各写 Allow: /；block-ai = 换成 Disallow: /（会真挡住 AI 收录，慎用）；show = 只看当前规则' },
+      confirm: { type: 'boolean', description: 'allow-ai / block-ai 要真写盘才传 true；不传 = 只打印 diff。show 忽略此参数' },
+    }),
+    output: { schema: RESULT_SCHEMA, render: (_args, value) => [{ type: 'text', text: renderGeoRobotsText(value) }] },
+    async execute(args = {}) {
+      const dir = textOf(args.dir)
+      if (!dir) return missingArg('dir', '给站点产物目录（robots.txt 在这个目录下）', 'geo robots')
+      const mode = normalizeGeoRobotsMode(args.mode)
+      const confirm = mode !== 'show' && args.confirm === true
+      const res = await runCli(buildGeoRobotsArgs({ dir, mode, confirm }))
+      const reason =
+        mode === 'show'
+          ? 'show 只读：只列当前 robots.txt 的 AI 规则与每个 UA 的策略状态，不写盘。'
+          : confirm
+            ? ''
+            : 'dry-run：只打印 diff，没写盘。确认要改 robots.txt 后带 confirm:true 重跑' + (mode === 'block-ai' ? '（block-ai 会真的挡住 AI 收录）。' : '。')
+      return normalizeCliResult(res, {
+        command: 'geo robots --mode ' + mode,
+        executed: mode === 'show' ? true : confirm,
+        needsConfirm: mode !== 'show' && !confirm,
+        reason,
+      })
+    },
+  }
+
+  const geoBrands = {
+    name: 'wkgeo_geo_brands',
+    description:
+      '品牌在 AI 平台上的收录 / 引用跟踪，底层 `wkgeo geo brands`（只读，不写文件）。**后台 API 未就绪**：没配置环境变量 WKGEO_GEO_API 时，CLI 一个请求都不发，返回 status=not_configured + 接口契约，本工具会把这句话原样翻成人话，**不会假装查到了品牌**。project 传站点域名（映射到 CLI 的 --domain）。',
+    parameters: paramsSchema({
+      project: { type: 'string', description: '项目 / 站点域名（如 example.com，映射到 CLI 的 --domain；可留空，留空只看配置状态）' },
+    }),
+    output: { schema: RESULT_SCHEMA, render: (_args, value) => [{ type: 'text', text: renderGeoBrandsText(value) }] },
+    async execute(args = {}) {
+      const project = textOf(args.project)
+      const res = await runCli(buildGeoBrandsArgs({ project }))
+      return normalizeCliResult(res, { command: 'geo brands' })
+    },
+  }
+
+  const seoAudit = {
+    name: 'wkgeo_seo_audit',
+    description:
+      '本地站点产物 SEO 体检，底层 `wkgeo seo audit`：13 项加权评分（title / description / canonical / og / JSON-LD / H1 / 标题层级 / 图片 alt / 内链死链 / llms.txt / sitemap.xml / robots.txt）+ 等级 + issues[]（每条带位置与改法）。**只读**：不联网、不写任何文件。有问题也返回 ok:true（看 score / issues），只有目录不存在或没有 .html 才 ok:false。**注意**：CLI 这一层不联网，只认本地目录；url 只是别名入口，填了 url 没有 dir 时会明确告诉你先落成本地目录，不会假装抓取成功。',
+    parameters: paramsSchema({
+      dir: { type: 'string', description: '本地站点产物目录（含 index.html 等静态页面；建议绝对路径）。dir 与 url 二选一，优先 dir' },
+      url: { type: 'string', description: '站点网址（http / https，如 https://www.example.com）。可填网址，但 CLI 的 seo audit 只做本地产物目录体检、不联网；只给 url 时会提示先落成本地目录再传 dir' },
+    }),
+    output: { schema: RESULT_SCHEMA, render: (_args, value) => [{ type: 'text', text: renderAuditText(value, 'SEO 体检（seo audit）') }] },
+    async execute(args = {}) {
+      const dir = textOf(args.dir)
+      const url = textOf(args.url)
+      if (!dir) {
+        if (!url) return missingArg('dir', '给本地站点产物目录（dir，推荐），或给网址（url）——注意 CLI 的 seo audit 只做本地目录体检、不联网', 'seo audit')
+        return {
+          ok: false,
+          code: -1,
+          command: 'seo audit',
+          supported: false,
+          executed: false,
+          needsConfirm: false,
+          reason: '',
+          gap: {
+            code: 'URL_AUDIT_UNSUPPORTED',
+            message: '`wkgeo seo audit` 只接受本地产物目录：CLI 这一层不联网，拿到网址也不会去抓页面。',
+            instead: '先把网址落成本地目录再传 dir：wkgeo template init --mode url --url ' + url + ' --key <key> --out <目录>（Chrome 抓站镜像），或直接用已发布的产物目录（通常是站点的 dist 目录）。',
+          },
+          stderr: '',
+          error: '只给 url 不能体检：`wkgeo seo audit` 只做本地产物目录、不联网（没有假装抓取成功）',
+          errorCode: 'URL_AUDIT_UNSUPPORTED',
+          errorHint: '用 dir 指向本地站点产物目录；要按网址体检就先把网址落成本地目录（wkgeo_template_init 的 mode=url），再传 dir。',
+        }
+      }
+      const res = await runCli(buildSeoAuditArgs({ dir }))
+      return normalizeCliResult(res, { command: 'seo audit' })
+    },
+  }
+
+  return [sitesList, siteStatus, sitePreview, publish, siteCreate, templateFromUrl, templateFromDir, contentApply, contentFill, contentCheck, templatesList, templateInit, templateValidate, templatePack, templatePublish, domainsList, geoAudit, geoLlms, geoRobots, geoBrands, seoAudit]
 }
 
 // ---------------------------------------------------------------------------

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Site Operations",
-    "description": "Build a live site from a template, an existing website, or your own files — write content once, self-check, then publish."
+    "description": "All-in-one website operations for the AI era: AI site building, one-click import of existing sites, and automatic GEO/SEO structure generation."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "网站运营",
-    "description": "对话式建站：模板、老站、客户资料都能变成站点；内容一次落库，自检通过再发布上线。"
+    "description": "AI 时代的一站式网站运营工具：AI 建站、老网站一键导入、GEO·SEO 结构自动生成。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-wkgeo-ops",
-  "version": "0.2.3",
-  "description": "对话式建站：模板、老站、客户资料都能变成站点；内容一次落库，自检通过再发布上线。",
+  "version": "0.2.4",
+  "description": "AI 时代的一站式网站运营工具：AI 建站、老网站一键导入、GEO·SEO 结构自动生成。",
   "type": "module",
   "main": "lib/index.js",
   "icon": "assets/icon.png",
@@ -40,6 +40,8 @@
     "./client": "./client/client.js",
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./locale/*.json": "./locale/*.json",
+    "./lib/*": "./lib/*",
+    "./assets/*": "./assets/*",
     "./package.json": "./package.json"
   },
   "peerDependencies": { "@deepseek-ai/cordis": "^4.0.1" }