dsh-wkgeo-ops
Verifieddsh-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,非装饰):
- 模板 = 设计骨架;网址 / 文件 = 结构与内容来源。
- 只选网址或文件 → 先用它生成模板(
template init),再建站。 - 模板 + 网址/文件 → 模板做骨架,内容按栏目灌入。
- 做不到的组合必须明确标「未填充」(
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):
- 初始化(本机还没设站点根目录时):一张居中卡片「第一步:先选站点根目录」——手输绝对路径,或点「选择根目录」进目录浏览器一层层点。强制第一步、不能跳过:根目录没设就只显示这张卡,不给卡片列表(唯一例外是服务端 config 接口不可用
cfgDown,那时退回列表并在顶栏提示「接口不可用」)。 - 卡片网格:一个站一张卡(站名 + 状态 pill + 主机链接 + 类型/验证/短码 tags + 底部「📁 本地文件夹」行),末尾虚线「+ 新建站点」卡;整张卡可点。
- 详情:点卡进去 → 返回按钮 + 站点信息 7 行 + 本地文件夹面板(绝对路径 / 相对根目录 / HTML 文件清单 / 换文件夹 / 重新扫描 / 打开站点)。
- 向导(三步,见 §2)、5. 执行日志。
- 初始化(本机还没设站点根目录时):一张居中卡片「第一步:先选站点根目录」——手输绝对路径,或点「选择根目录」进目录浏览器一层层点。强制第一步、不能跳过:根目录没设就只显示这张卡,不给卡片列表(唯一例外是服务端 config 接口不可用
目录选择器是固定浮层弹窗(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}保存(相对路径 400ROOT_NOT_ABSOLUTE、不存在 400ROOT_MISSING、不是目录 400ROOT_NOT_DIR);{rootDir:''}清空。GET /wkgeo-ops/browse?path=(v4):目录选择器数据源,回{ok, path, parent, dirs[], files[], htmlCount, insideRoot}。设了根目录后只允许浏览根目录之内(越界 403OUTSIDE_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
唯一本机相关项:工具要调
wkgeoCLI。插件默认取仓库内cli/wkgeo.mjs;装到别的机器 / 别的仓库时,设环境变量WKGEO_CLI=<你那边的仓库>\cli\wkgeo.mjs(可选WKGEO_NODE_BIN)后重启 DSH。没配也能装、能激活,只是工具调用会回SPAWN_FAILED并给出提示。
B. 从本地目录安装(开发期改动还没发包时用)
拷目录(在仓库根目录执行):
Copy-Item -Recurse -Force '.\integrations\dsh-wkgeo-ops' "$env:USERPROFILE\.dsh\plugins-src\dsh-wkgeo-ops"二选一:
- 插件安装 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 会自动应用。- 插件安装 UI「从本地目录安装」选到
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. 已知限制 / 未验证项(如实记录)
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,不会假装成功。sites create的--lang双通道:CLI 现在支持--lang zh-CN|en,但面板向导仍走「建站后lang save」(兼容未升级的 CLI),能力探测到--lang时直接用。wkgeo_site_create工具本身走向导链路,不改。- zip 不支持:Node 内置无解压、CLI 也无
templates import --zip;插件明确回ZIP_UNSUPPORTED,不假装成功。 - 模板「市场/内置」全量目录仍拿不到:
templates list列的是某站点自己的模板(v0.2.0 已接成wkgeo_templates_list);CLI 没有「列全平台模板市场」的命令,所以面板下拉仍只能给「默认模板 +WKGEO_TEMPLATE_KEYS+ 手填」。--template匹配的是 DBpublic.cms_template的 name 或 id。 import需运维权限:它走 service_role 直连库(本机tencent/cloudbase/import-site.mjs),客户/AI 账号不该用;插件只用它做「网址来源」的降级,且会同时标未填充项。- 已装进真实 DSH(
%USERPROFILE%\.dsh\plugins-src\dsh-wkgeo-ops,profile 里是file:依赖 → pnpm link,别删/挪该目录):左栏「网站运营」入口已实测出现在运行中的 GUI 里。但 服务端lib/index.js的改动必须重启 DSH 才生效(工具与路由都在apply()里注册,进程内模块已缓存)。client/client.js的改动可以热重载、不用重启。 - 写操作工具本轮没在真实后端执行:
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(骨架下载)。 - 面板截图里的列表用真实站点(
shot-real.png),不是造的数据;卡片网格/详情/初始化三张用固定的 5 个假站点。 - 站点 ↔ 本地文件夹是本机私有映射:wkgeo 站点模型里没有「本地目录」字段,映射只存在
<DSH_PROFILE_DIR>/wkgeo-ops/config.json(根目录只能设一个、文件夹必须在根目录之内)。换机器 / 换 profile 要重新设根目录并重绑;不会随站点同步。 - 发布到 npm 要用官方 registry:本机
~/.npmrc默认registry=https://registry.npmmirror.com(镜像无凭证),发布必须npm publish --registry https://registry.npmjs.org(账号wkgeocn);npm view同理。 wkgeo_domains_list无site时走聚合:CLI 没有domain list子命令,聚合用sites list的domain/domains[]字段,拿不到 TXT/CNAME/证书明细(要明细就传site)。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)把站落成本地目录,不假装抓取成功。wkgeo_geo_brands需要后端:WKGEO_GEO_API没配时 CLI 回status:"not_configured"(exit 0、零请求、零假数据),工具原样转述成人话 + 接口契约;配好之前拿不到任何品牌收录数据。