Skip to content

v2.1.0 菜单项全部改为面板 + 面板表单能力

Pre-release
Pre-release

Choose a tag to compare

@vfuncyy vfuncyy released this 16 Nov 16:36
· 4 commits to main since this release

v2.1.0:所有菜单项都变成了面板

上一版(v2.0.0)把「运行状态 / 调试信息 / 诊断数据」三个入口做成了暗色控制台面板,但其余菜单项还是原生 prompt / confirm / alert:点「粘贴/兑换授权码」要先读一段 prompt 说明再粘,点「配置 PushPlus」要在 prompt 里背 1/2/3/9/0 的含义,点「通知开关」直接反转并刷新页面、连确认的机会都没有。

这一版把这些交互全部收进面板。

六个菜单项的前后对照

菜单项 之前 现在
🔑 手动授权 直接开标签页,没有任何说明 面板:四步流程 + 授权链接可复制 +「打开授权页面 / 复制链接」
📋 粘贴/兑换授权码 prompt 粘贴 → alert 结果 面板:多行输入框 +「兑换」(异步,结果回写提示条)+「清空输入」
🚀 立即运行 点完立刻开跑,无确认无说明 面板:本轮五步顺序说明 +「开始运行」
🔔 配置 PushPlus 推送 prompt 选 1/2/3/9/0 面板:开关 + Token 密码框 + 动态摘要 +「保存 / 发送测试 / 清空 Token」
🔧 诊断信息 prompt 选 1/2/0 面板:「查看调试信息」「导出诊断 JSON」
🔕 通知开关 点一下直接反转并刷新页面 面板:开关 +「保存并刷新」

每个入口都保留 if (!panel) 分支——后台上下文(no DOM)时按旧逻辑执行,换界面不牺牲「后台也能用」。

Utils.showPanel 获得表单能力

新增 opts.fields,支持 checkbox / text / password / textarea 四种字段,可带 label、placeholder、hint、rows:

fields: [
  { type: "textarea", key: "code", label: "授权码", hint: "留空 = 用设置面板里的链接" },
  { type: "password", key: "token", label: "PushPlus Token", value: cfg.token },
  { type: "checkbox", key: "enabled", label: "开启微信推送", value: cfg.enabled }
]

按钮回调签名扩展为 onClick(area, close, api),api 提供:

方法 作用
values() 返回 key -> string|boolean 当前值表
setValue(key, value) 写入单个字段(checkbox 走 checked)
focusField(key) 聚焦指定字段
setNote(text) 改写顶部提示条;空串即隐藏,之后还能再显示
setFields(fields) 整组重绘字段区
close() 关闭面板

返回句柄同步新增 setNote(text) 与 setFields(fields)。提示条从「没有 note 就 display:none 且不挂载」改为常驻 DOM + hidden 切换——原来建好面板后再想补提示无从下手。回调抛错或返回 rejected Promise,都统一写进提示条(⚠️ ...),不会静默失败。

顺手修掉的两个真问题

  1. setStats() 把指标条塞进滚动区:v2.0 异步回填走 body.prepend(statsEl),指标条被挪进 .body,滚动任务行时数值跟着滚走。改为挂在 card 内、body 之前(if (!statsEl.isConnected && card.contains(body)) card.insertBefore(statsEl, body)),指标条常驻。
  2. 字段区与任务行挂载顺序冲突:第一版把字段插在 rowsWrap 前,renderRows 又插到 body.firstChild,setRows 一调就把任务行顶到表单上方。改为字段区先挂载、renderRows 优先插到 fieldsWrap.nextSibling。

字段区现在固定在滚动区最前面:配置类面板里表单才是主体,任务行退居其次。

版本与体积

  • @version 与 engineVersion 双升 2.1.0;业务判定、重置逻辑、@grant 列表(11 项)均未变
  • @description 补上「六个菜单项都改成可视化面板」
  • 脚本 5,065 行 / 282,752 B → 5,340 行 / 297,781 B(+275 行 / +15,029 B)
    • 六个入口的面板改造:5,065 → 5,217 行 / 290,505 B
    • showPanel 表单内核:5,217 → 5,336 行 / 297,334 B
    • 挂载修复 + 版本升级:5,336 → 5,340 行 / 297,781 B

发布前验证

项 方法 结果
语法 node --check exit 0
表单渲染 源码抽出 panelCss/buildPanelModel/showPanel 注入测试台,Edge headless + CDP 3 个字段(textarea / password / checkbox)全部渲染,label 正确
字段读写 点「兑换」触发 api.values() {"code":"","token":"abc123","enabled":true};setValue 后回读 overwritten;focusField 后 activeElement 是 TEXTAREA
提示条 setNote / setNote("") / 再次 setNote 可见 → hidden=true → 重新可见,内容正确
字段顺序 setStats+setRows 后看 .body 子节点 [fields, DIV, sec, log, rawbox],字段始终最前,9 行任务行完整
指标条位置 断言 .card > .stats 为真(滚动区之外)
关闭方式 Esc 键 / 点遮罩 两种都从 DOM 移除
渲染截图 900×820 与 420×800 指标条 4 列 / 2×2,表单、任务行、按钮全部可读

面板内核对源码的抽取方式也固化了:方法边界按「从起点向下的第一个恰好 }, 行」判定,不再数花括号——panelCss() 里全是 CSS 的 { },数括号在第一个 } 就结束了,会导致抽出的代码语法错误。