Skip to content

dsh-wkgeo-ops

Verified

dsh-wkgeo-ops · v0.2.4 · MIT · Web UI

AI 时代的一站式网站运营工具:AI 建站、老网站一键导入、GEO·SEO 结构自动生成。

Install

dsh plugin add dsh-wkgeo-ops

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Tags

Creators

Readme

dsh-wkgeo-ops · DSH 插件「网站运营」

悟空GEO·网站运营 —— 一站式建站与上线,全在对话里完成

把 wkgeo CLI(仓库内 cli/wkgeo.mjs,或用 WKGEO_CLI 指到你本机 CLI)的站点运营能力接进 DeepSeek Harness: agent 21 个工具 + 左侧栏「悟空GEO-网站运营」入口(点开是中央面板) + 右侧边栏「网站运营」面板(含三步建站向导)。不新增任何 npm 依赖,插件内不重写任何 HTTP / SQL 业务逻辑——工具只负责 spawn node cli/wkgeo.mjs … --json 再解析信封。

  • key / 包名 / cordis 插件名:dsh-wkgeo-ops
  • 版本: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):「初始化先选站点根目录 → 站点卡片一个一个显示(能点进去)→ 详情里有本地文件夹」;不再用一张表铺列表
  • v0.2.0 口径(老板 2026-10-30「接收 dsh,完成 cli 的后续能力对接,然后发布一个包」):CLI 的 content apply / fill / check、templates list、template init / validate / pack / publish、domain records 全部接成工具,破坏性操作一律 dry-run 默认 + 显式 confirm:true

1. 目录结构

integrations/dsh-wkgeo-ops/
├─ package.json          # manifest:main / files / dsh.bundle.patch / dsh.client / exports / engines / publishConfig
├─ cordis.patch.yml      # 装载层:- insert: id/name = dsh-wkgeo-ops
├─ lib/
│  ├─ wizard.js          # 纯函数:三步向导状态机 + 来源归一 + 能力探测 + 命令构造 + 建站闸门
│  └─ index.js           # 服务端 cordis 插件:21 个工具 + 6 条路由 + 执行层(可单测)
├─ client/
│  └─ client.js          # Web 客户端:左侧栏入口 + 面板(初始化/卡片网格/详情/向导/日志 五态)
├─ skill/                # agent 技能:wkgeo-site-content(建站清单契约 + 示例 manifest)
├─ skills/               # agent 技能:wkgeo-site-build(旧指针,已并入 skill/wkgeo-site-content)
├─ verify/               # 离线回归:tool-schema / panel-registration / dsh-compat(+ schema-subset 校验器)
└─ README.md             # 本文件

2. 三步向导(面板主流程)

步 内容 规则
① 站点名 必填,≤60 字;回车即下一步
② 语言 默认中文(zh-CN),可选英文(en)
③ 内容来源:模板 / 网址 / 文件 三个入口同时摆出来,复选框式可单选可多选;勾谁展开谁的输入

入口位置(老板口径):

  • 没有站点时:空态第一行就是整宽主按钮「+ 创建网站(第一个)」。
  • 有站点时:列表最末尾固定一行虚线「+ 创建新网站(最后一个)」,顶部也有「+ 创建网站」小按钮。

第三步的三种来源:

来源 角色 勾选后展开的输入
模板 设计骨架 模板中心下拉(默认模板 + WKGEO_TEMPLATE_KEYS 配置的名字)+ 手填模板名/uuid
网址 结构与内容来源 老站 URL(http(s)://…)
文件 结构与内容来源 本地目录(逐个 *.html)或 zip 路径

合并语义(UI 文案与文档同一份 MERGE_SEMANTICS,非装饰):

  1. 模板 = 设计骨架;网址 / 文件 = 结构与内容来源。
  2. 只选网址或文件 → 先用它生成模板(template init),再建站。
  3. 模板 + 网址/文件 → 模板做骨架,内容按栏目灌入。
  4. 做不到的组合必须明确标「未填充」(unfilled[] + 面板黄色提示),不许静默忽略。

深层链接(截图 / 复现用):?wizard=1&step=3&name=…&lang=zh-CN&sources=template,url&templateKey=…&url=…。

3. 工具清单(agent 侧,16 个)

v0.2.0 新增的 9 个工具都是薄封装:spawn node cli/wkgeo.mjs … --json → 解析 JSON 信封 → 统一返回 { ok, code, command, executed, needsConfirm, reason?, data?, stderr?, error?, errorCode?, errorHint? }。 code 是 CLI 退出码(0 成功 / 1 校验失败 / 2 用法或环境错误 / 3 需要 wkgeo login / 4 被限流;插件内部错误用 -1), errorHint 给出中文处置建议。破坏性操作(建站 / 发布 / 内容落库 / 模板发布)默认 dry-run,必须 confirm:true 才真写。

工具 参数 底层命令 返回要点
wkgeo_sites_list 无 sites list --json { ok, count, sites[] },每站 id/name/status/shortHost/shortUrl/domain/domainVerification/provisionState/relation/cmsOnly
wkgeo_site_status site* sites get <id> --json { ok, site }:状态、短域、域名验证(含 verifiedAt)、证书、备案、开通状态
wkgeo_site_preview site*、path preview <path> --site <id> --json { ok, url, siteId, path } → https://wkgeo.com/cms/preview/<站点ID>/about/
wkgeo_publish site、confirm、wait publish --site <id> --confirm [--no-wait] --json 缺 confirm:true 不执行,回 {executed:false,needsConfirm:true,reason,risk}
wkgeo_site_create name、lang、source、templateKey、url、dir、zipPath、confirm 计划式执行:sites create →(lang save)→(templates save×N)→(import --apply) 缺 confirm:true 只回 {executed:false,needsConfirm:true,plan[],risk};有 confirm 才逐步执行,回 {ok,siteId,steps[],unfilled[],gaps[],warnings[]}
wkgeo_template_from_url url*、out、site、confirm template init --from-url <url> [--out <dir>] --json(长任务 300s) CLI 没这个子命令时 → {supported:false,executed:false,gap,command,fallback},0 次 CLI 调用,不假装成功
wkgeo_template_from_dir dir、zipPath、out、site、confirm template init --from-dir <dir> [--out <dir>] --json(300s);没有该子命令时降级 templates save 只给 zip → {supported:false,gap:{code:'ZIP_UNSUPPORTED'}};无 site/confirm → needsConfirm:true + 将执行的命令清单
wkgeo_content_apply file*、site、confirm、publish、wait、allowNameMismatch content apply --file <site-manifest.json> [--site] [--publish [--no-wait]] [--allow-name-mismatch] [--confirm] --json(300s) 整站落库:无 confirm:true = CLI dry-run,回 {executed:false,needsConfirm:true,reason};有 confirm 才写库,publish:true 顺带发布
wkgeo_content_fill site、manifest | manifestJson、lang、confirm content fill --manifest <文件> [--site] [--lang] [--confirm] --json(300s) 模板内容填充:manifestJson 会落到临时目录再调用、调用后清理;默认 dry-run
wkgeo_content_check site、template、lang、maxDetails(默认 50) content check … --max-details <n> --json 只读一致性自检;四类硬问题 → CLI exit 1 → ok:false + errorHint
wkgeo_templates_list site templates list [--site <id>] --json 站点自己的模板列表(count + data.templates[]:name/source/isActive/isDefault/summary/files[]);首次调用 CLI 会自动 seed
wkgeo_template_init mode(blank|url|dir)、url、dir、key*、out、version、registry、offline、force、chrome、maxPages、noDesign template init [--to] [--version] [--registry] [--offline] [--force] --json;生成模式 --from-url / --from-dir + --key(300s) 空白骨架(不带 mode);网址 / 目录生成必须给 key,缺了回 MISSING_KEY;网址模式很慢,maxPages 可限页
wkgeo_template_validate dir*、base、noDesign template validate --dir <目录> [--base] [--no-design] --json(300s) 9 关校验,不合格 → CLI exit 1 → ok:false
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(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、不落日志。
  • node 解析顺序:WKGEO_NODE_BIN → process.execPath(仅当是 node.exe)→ node;CLI 路径可用 WKGEO_CLI 覆盖,默认取仓库内 cli/wkgeo.mjs。
  • 能力探测(10 分钟缓存):读 template init --help / sites create --help / import --help 文本,判断 --from-url、--from-dir、--lang、--url 是否真的存在;探测不到就不硬塞参数,改走降级路径并在返回里标 capabilities。
  • 模板中心下拉的选项来自 WKGEO_TEMPLATE_KEYS(逗号分隔的内置模板名/uuid)+ 一个「默认模板(不指定)」+ 手填框;CLI 没有「列模板」的命令,缺口见 §7。

4. 面板(Web 客户端侧)

  • 左侧栏入口(v3):sidebar.panellist(id: wkgeo-ops、order: 30、图标 OpsIcon)+ main(key: wkgeo-ops,渲染同一个 PanelBody)。两条的 id/key 必须相同:①只注册就有点不开、②只注册就先没图标;装插件本身不会自动往左栏加菜单,这两条必须自己写。停用插件时若该面板正激活,先 layout.selectPanel(null) 把界面交还对话。

  • 注册 sidebarRightTabs(id: wkgeo-ops、priority: fallback)+ sidebar.right.pane.tab / .title 两个 slot,与 dsh-bili-panel 范式一致;右栏页签与左栏入口渲染的是同一个 PanelBody。

  • 五态(v4):

    1. 初始化(本机还没设站点根目录时):一张居中卡片「第一步:先选站点根目录」——手输绝对路径,或点「选择根目录」进目录浏览器一层层点。强制第一步、不能跳过:根目录没设就只显示这张卡,不给卡片列表(唯一例外是服务端 config 接口不可用 cfgDown,那时退回列表并在顶栏提示「接口不可用」)。
    2. 卡片网格:一个站一张卡(站名 + 状态 pill + 主机链接 + 类型/验证/短码 tags + 底部「📁 本地文件夹」行),末尾虚线「+ 新建站点」卡;整张卡可点。
    3. 详情:点卡进去 → 返回按钮 + 站点信息 7 行 + 本地文件夹面板(绝对路径 / 相对根目录 / HTML 文件清单 / 换文件夹 / 重新扫描 / 打开站点)。
    4. 向导(三步,见 §2)、5. 执行日志。
  • 目录选择器是固定浮层弹窗(v4.1):position: fixed 全屏遮罩 + 720px 白卡(role="dialog"、aria-modal),点遮罩即取消;顶部手输路径 + ↑ 上一级 + → 跳转,中间子目录列表、底部「取消 / 用这个目录」。不要改回普通区块:面板容器高度有限,内联区块会被挤成 0 高(老板 2026-10-30 报「点了没弹出选择器」,根因见下一条)。

  • 真 React 两个坑(v4.1 修):① 目录取数的 useEffect 必须带依赖数组 [path]——无依赖写法每轮渲染都重跑,React 先执行上一轮清理把 alive 置 false,首个 fetch 响应被丢弃且守卫拦住重试,表现就是永远停在「读取目录中…」(自写的轻量垫片不复现,真 React 必现);② 受控输入框用 onChange,不要用 onInput(真 React 里等价只读)。

  • 页签 guide 的 title / description 必须是函数(v4.2 修,事故级):sidebarRightTabs.register({ guide: [{ title: '站点状态' }] }) 这种字符串写法会让 DSH 在渲染右栏 guide 时抛 TypeError: entry.title is not a function;它发生在右栏同一个 React 树里 → 整个右侧栏被卸载成一片空白(连 DSH 自带的「开始」页签内容也没了),左侧栏 / 中央面板不受影响。正确写法 title: () => '…'(dsh-image-gen 即如此),本仓库再用 asLabel() 兜底。回归:node integrations/dsh-wkgeo-ops/verify/panel-registration.mjs → RESULT: ALL PASS。

  • v5(2026-10-30):面板根节点自己撑满宽度 —— STYLE.wrap 必须带 width:'100%'; minWidth:0; flex:'1 1 auto',顶栏 STYLE.bar 带 flexWrap:'wrap'、标题/计数 whiteSpace:'nowrap';否则在右栏(flex 项、宽度窄)里整块会收缩成一竖条。

  • v5:右栏与中央共用同一个入口组件 OpsPanel(apply 内定义:h(PanelBoundary, null, h(PanelBody, ctx))),两处槽位都直接传这个组件(和 dsh-bili-panel 同形),不要再套 PaneShell 之类的额外外壳;面板标题后有一个 v5 小标记,用来确认客户端加载的是哪一版。

  • 取数路由(服务端自注册、与 DSH GUI 同源):

    • GET /wkgeo-ops/sites(?refresh=1 强刷,默认 15s 缓存)
    • GET /wkgeo-ops/templates → {ok, choices[], manual, note, gap, mergeSemantics[]}
    • POST /wkgeo-ops/site-create → application/x-ndjson 逐步流(先 {type:'plan'} 再 {type:'step'}…最后 {type:'done'});缺 confirm:true 一律 200 + needsConfirm:true,不执行;非 POST → 405。
    • GET|POST /wkgeo-ops/config(v4):读/写本机站点根目录。GET → {ok, rootDir, exists};POST {rootDir} 保存(相对路径 400 ROOT_NOT_ABSOLUTE、不存在 400 ROOT_MISSING、不是目录 400 ROOT_NOT_DIR);{rootDir:''} 清空。
    • GET /wkgeo-ops/browse?path=(v4):目录选择器数据源,回 {ok, path, parent, dirs[], files[], htmlCount, insideRoot}。设了根目录后只允许浏览根目录之内(越界 403 OUTSIDE_ROOT);没设根目录时可从家目录/盘符起随便翻。
    • GET|POST|DELETE /wkgeo-ops/site-folder(v4):站点 ↔ 本地文件夹映射。GET 无参回全部 folders{}、?site=<id> 回单站(含 rel/exists/htmlCount/files[],未绑定 bound:false);POST {siteId, dir} 绑定(要求已有根目录 ROOT_UNSET、绝对路径 DIR_NOT_ABSOLUTE、在根目录内 OUTSIDE_ROOT、目录真实存在 DIR_MISSING/DIR_NOT_DIR);DELETE ?site=<id> 解绑。
    • 存储位置:<DSH_PROFILE_DIR 或 ~/.dsh>/wkgeo-ops/config.json,形状 { rootDir, folders: { [siteId]: dir }, updatedAt }。只存本机,不上传、不写进站点、不进 CLI。
  • 样式只用 --dsw-alias-* CSS 变量,不引外部资源、不引 CSS 文件。

  • 拿不到 webServer 服务时只跳过路由(面板顶栏提示「接口不可用」并退回列表),7 个工具照常可用。

5. 安装(老板侧)

前置:wkgeo CLI 已登录(node <仓库>\cli\wkgeo.mjs login,或直接用 WKGEO_CLI 指到你本机的 CLI),DSH 已在运行。

A. 从 npm 安装(v0.2.0 起,推荐 —— 老板要的就是这条路)

DSH 设置里的插件页 →「添加插件」→ 填包名:

dsh-wkgeo-ops

装上后重启 DSH 即生效(左侧栏图标 + 右侧栏页签 + 21 个工具一起出现)。等价命令行:

npm i dsh-wkgeo-ops            # 或 npm i -g / 在 DSH profile 目录里装
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 并给出提示。

B. 从本地目录安装(开发期改动还没发包时用)

  1. 拷目录(在仓库根目录执行):

    Copy-Item -Recurse -Force '.\integrations\dsh-wkgeo-ops' "$env:USERPROFILE\.dsh\plugins-src\dsh-wkgeo-ops"
    
  2. 二选一:

    • 插件安装 UI「从本地目录安装」选到 %USERPROFILE%\.dsh\plugins-src\dsh-wkgeo-ops;
    • 手动挂 profile(两处,不用改 cordis.patch.yml):%USERPROFILE%\.dsh\profiles\desktop\package.json 的 dependencies 加 "dsh-wkgeo-ops": "file:C:/Users/Administrator/.dsh/plugins-src/dsh-wkgeo-ops",同文件 dsh.profile.bundles 数组加一项 dsh-wkgeo-ops,重启 DSH。

    cordis.patch.yml 里不需要再写 - id: dsh-wkgeo-ops:dsh.profile.bundles 里的包按 bundle 层挂载,包内自带的 patch 会自动应用。

C. 验证(装完应同时出现两处入口 + 21 个工具)

位置 现象
左侧栏 第 5 个图标(显示器+双卡片,order: 30,排在「工作台」后面),文字为 「悟空GEO-网站运营」(client/client.js 的 SIDEBAR_ROW_LABEL);点它 → 中央区渲染「网站运营」面板
右侧栏 「网站运营」页签(与左栏入口并存,两条路都能进)
对话 让 agent「列一下我的站点」→ 调 wkgeo_sites_list,回 {ok:true,count:25,sites:[…]}

三个只读工具可以立刻验通(不写任何东西):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。
  • 插件中心卡片的图标与本地化描述随包走(icon + locale/zh.json / locale/en.json,0.2.3 起有),不影响功能。
  • 已发布公共 npm:npm i dsh-wkgeo-ops / 插件中心填 dsh-wkgeo-ops(v0.2.0 起可装);本仓库目录安装仍可拷目录 / file: 依赖。

6. 自测

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     # 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=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 三条新路由)
node .tmp-build\t161\shoot.mjs                             # SHOTS=5 / exit 0(v4 五张截图)
node .tmp-build\t162\repro.mjs                             # 真 React 18 全流程:init → 浮层选根目录 → 卡片 → 详情 → 绑定文件夹,打印 CLICK_*/AFTER_* 文本、ERRS=[]

smoke 的 40 项断言分组(v2 起的回归基线):①三文件 node --check ②manifest + exports + peerDeps ③cordis.patch.yml ④v1/v2 纯函数导出 ⑤列表/详情/预览解析 ⑥publish 闸门(缺 confirm 0 次 CLI)⑦七个工具齐 + name/confirm 必填内联 ⑧建站闸门:缺 confirm → needsConfirm:true + 0 次 CLI ⑨四种来源组合的命令序列(模板 / 网址 / 文件 / 模板+网址,含 from-url 先于 create)⑩三步向导状态机(不能跳步 / 语言默认中文 / 多选至少一项 / 三步走完)⑪zip 与 from-url 缺口 ⑫三条面板路由 ⑬文件扫描 ⑭客户端 __internal 纯函数与深链还原。

t161/api-test.mjs(v4)用临时 store 文件起本地 HTTP 服务,断言:config 初始空 / 相对路径 ROOT_NOT_ABSOLUTE / 不存在 ROOT_MISSING / 保存落盘;browse 默认落根目录且 insideRoot / 越界 403 OUTSIDE_ROOT;folder 绑定 rel/htmlCount/index.html 排最前 / ?site= 单站 / 全量映射 / 未绑定 / 越界 403 / DIR_MISSING / DIR_NOT_ABSOLUTE / DELETE 解绑;isPathInside/relToRoot 四个纯函数。

面板渲染证据(不装进真 DSH,用本地静态服务 + Chrome headless 截真实 client.js):

node .tmp-build\t161\preview.mjs   # 打印 PANEL_URL / BROWSE_URL / CARDS_URL / DETAIL_URL / REAL_URL
node .tmp-build\t161\shoot.mjs     # 自动起服务 + Chrome headless(CDP) 1440×900 截五张
  • 初始化(先选站点根目录):.tmp-build\t161\shot-init.png
  • 目录选择器(一层层点):.tmp-build\t161\shot-browse.png
  • 卡片网格(状态 pill / tags / 本地文件夹行 / +新建卡):.tmp-build\t161\shot-cards.png
  • 站点详情(站点信息 + 本地文件夹清单):.tmp-build\t161\shot-detail.png
  • 真实 CLI 的 23 个站点渲染成卡片:.tmp-build\t161\shot-real.png

t162/repro.mjs 是真 React 18(unpkg UMD,存在 .tmp-build\t162\vendor)的端到端复现:自起 http 服务发真实 client.js + mock 五条路由,Chrome headless 里按文字点按钮、取 innerText、收集 window.onerror,跑完打印 AFTER_USE_TEXT(=卡片)AFTER_CARD_TEXT(=详情)BOUND_TEXT(=已绑定文件夹)与 ERRS3=[];产物 after.png(浮层)/after-use.png/after-card.png/after-bind-modal.png/after-bound.png。改面板交互后先跑这个,轻量垫片(t161/t159)复现不了 effect 时序类 bug。

7. 已知限制 / 未验证项(如实记录)

  1. template init --from-url 很慢且必须先定 key:CLI 已支持(template init --from-url/--from-dir),但抓站 + 生成要几分钟,插件给的是 300s 超时;缺 key 直接回 MISSING_KEY。实测跑通的是「空白骨架」模式(template init --to <dir> → 从 npm 拉 @wkgeo/[email protected],61 个文件、2064484 字节、self_check PASS、289ms 命中缓存)。网址/目录生成模式本轮没有真跑(会写模板目录 + 耗时长),失败时会回 ok:false + errorHint,不会假装成功。
  2. sites create 的 --lang 双通道:CLI 现在支持 --lang zh-CN|en,但面板向导仍走「建站后 lang save」(兼容未升级的 CLI),能力探测到 --lang 时直接用。wkgeo_site_create 工具本身走向导链路,不改。
  3. zip 不支持:Node 内置无解压、CLI 也无 templates import --zip;插件明确回 ZIP_UNSUPPORTED,不假装成功。
  4. 模板「市场/内置」全量目录仍拿不到:templates list 列的是某站点自己的模板(v0.2.0 已接成 wkgeo_templates_list);CLI 没有「列全平台模板市场」的命令,所以面板下拉仍只能给「默认模板 + WKGEO_TEMPLATE_KEYS + 手填」。--template 匹配的是 DB public.cms_template 的 name 或 id。
  5. import 需运维权限:它走 service_role 直连库(本机 tencent/cloudbase/import-site.mjs),客户/AI 账号不该用;插件只用它做「网址来源」的降级,且会同时标未填充项。
  6. 已装进真实 DSH(%USERPROFILE%\.dsh\plugins-src\dsh-wkgeo-ops,profile 里是 file: 依赖 → pnpm link,别删/挪该目录):左栏「网站运营」入口已实测出现在运行中的 GUI 里。但 服务端 lib/index.js 的改动必须重启 DSH 才生效(工具与路由都在 apply() 里注册,进程内模块已缓存)。client/client.js 的改动可以热重载、不用重启。
  7. 写操作工具本轮没在真实后端执行:wkgeo_content_apply / wkgeo_content_fill / wkgeo_site_create / wkgeo_publish / wkgeo_template_publish 只做了「闸门 + 参数映射」离线断言(stub runCli)与 CLI dry-run 语义核对,没有真写库(按项目门禁:破坏性写要老板点头)。真实只读验证过的是 wkgeo_sites_list(25 站)、wkgeo_domains_list(2 条域名 + 证书)、wkgeo_templates_list(2 个模板)、wkgeo_content_check(score 80/94)、wkgeo_template_init(骨架下载)。
  8. 面板截图里的列表用真实站点(shot-real.png),不是造的数据;卡片网格/详情/初始化三张用固定的 5 个假站点。
  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、零请求、零假数据),工具原样转述成人话 + 接口契约;配好之前拿不到任何品牌收录数据。