Repository navigation
v2.1.0 菜单项全部改为面板 + 面板表单能力
Pre-release
Pre-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,都统一写进提示条(⚠️ ...),不会静默失败。
顺手修掉的两个真问题
setStats()把指标条塞进滚动区:v2.0 异步回填走body.prepend(statsEl),指标条被挪进.body,滚动任务行时数值跟着滚走。改为挂在card内、body之前(if (!statsEl.isConnected && card.contains(body)) card.insertBefore(statsEl, body)),指标条常驻。- 字段区与任务行挂载顺序冲突:第一版把字段插在
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 的{ },数括号在第一个}就结束了,会导致抽出的代码语法错误。