晴天
|
b9a7c043d2
|
fix(audit): 复查发现的 5 个 bug — 双 listener / duplicate stub / timer leak / i18n
逐项排错盘点（OpenClaw + Hermes 引擎 + 共享层全面复查）。
## Bug #1 — Hermes 引擎双 listener 数组混用
src/engines/hermes/index.js
onStateChange / onReadyChange 共用一个 `_listeners` 数组：
```js
onStateChange(fn) { _listeners.push(fn); ... }
onReadyChange(fn) { _listeners.push(fn); ... } ← 同一数组
```
main.js 注册 sidebar 渲染回调时两个都注册：
```js
_engineStateUnsub = engine.onStateChange(() => renderSidebar(sidebar))
_engineReadyUnsub = engine.onReadyChange(() => renderSidebar(sidebar))
```
结果：每次 detectHermesStatus（15s 一次 poll）触发，sidebar 被
renderSidebar 调两遍。OpenClaw 引擎用的 lib/app-state.js 早就是分开
两个数组（_gwListeners + _listeners），Hermes 是退化实现。
修复：
- 拆成 _stateListeners / _readyListeners 两个数组
- 加 prevReady / prevRunning 做 diff，仅在状态实际变化时通知
## Bug #2 — Web 模式下 check_panel_update 永远返回 false
scripts/dev-api.js
`check_panel_update` 在 line 6785 有完整实现（fetch GitHub/Gitee
release API），但 line 8586 又 stub 了一次：
```js
check_panel_update() { return { hasUpdate: false } }
```
Object literal 后定义覆盖前定义，Web 模式下用户永远看不到「有新版」
提示，必须升级到桌面客户端才能查更新。
修复：删掉重复 stub，留注释说明真实实现位置。
esbuild 之前就在 build 里 warn `Duplicate key "check_panel_update"
in object literal`，现在 warning 也消失了。
## Bug #3 — engine-select.js setTimeout 不在 cleanup 时清
src/pages/engine-select.js
choose 动画里两个 setTimeout (600ms + 1300ms) 没保存 id，路由
cleanup 时不清。极端情况：用户点完 OpenClaw 后立刻点 secondary
"稍后再说" → 1300ms 后被强制 navigate 回原 targetRoute，把用户拉走。
修复：
- 模块级 _animTimers 数组追踪所有动画 setTimeout id
- cleanup 时 clearTimeout 全清
- stage.dataset 防御性访问（路由切走后 stage 可能已不在 DOM）
## Bug #4 — router.js 三处中文硬编码
src/router.js
之前页面 loading / 加载失败 / 重新加载按钮直接写死"加载中..."
"页面加载失败" "重新加载"。i18n 里 `common.loading` /
`common.pageLoadFailed` / `common.reloadRetry` 早已存在但没用上。
修复：import t() + 三处替换。
## Bug #5 — dashboard.js Promise 超时 Error 写死中文
src/pages/dashboard.js
`new Error(\`超时(${ms/1000}s)\`)` — 这条错误最后被 humanizeError
处理后展示给用户，本来应该走 i18n。改成英文 `Timed out after Xs`，
统一与日志聚合（其他地方都是英文）。
## 验证
- npm run build：PASS（1.85s, 无 duplicate-key warning）
- cargo fmt --check：PASS（无改动）
- 受影响场景：
- 引擎切换 sidebar 性能（Hermes 双重渲染消失）
- Web 模式更新提示（恢复正常）
- engine-select 动画中途切走（不再被强拉回）
- 加载/错误页（i18n 完整）
|
2026-05-14 07:17:28 +08:00 |
|
晴天
|
6a0d87479c
|
feat(engine-select): Monolith 对角线全屏选择屏
替换原卡片网格为「左上 OpenClaw（石墨黑）vs 右下 Hermes（象牙白）」对角线全屏设计。
启动屏 / 引擎切换时给用户一个有冲击力的「选择时刻」。
## 核心设计
- position: fixed 跳出 #content 范围，覆盖整个 viewport（含 sidebar）
- 双三角形 clip-path: polygon (0 0, 0 100%, 100% 0) / (100% 0, 100% 100%, 0 100%)
- 内容用 absolute 定位到三角形质心（左上 11%/6.5% / 右下 11%/6.5%），永不重叠
- 微妙的 60px 网格纹 + 角落极光（紫蓝 / 橙金）+ 极细中线分割
- clamp(80px, 13vw, 200px) 巨字标题 + 序号 + Logo + tagline + 特性列表 + CTA
## 交互
- hover 联动：用 [data-hover] attribute 替代 :has()，兼容旧 WebKit
- 鼠标悬停一侧 → 该侧亮起 + 内容平移 + CTA 反白；另一侧变暗 + 内容模糊缩小
- 点击三角形 → 三角形 clip-path 扩满（0.8s）→ 中心圆扩散（0.9s）→ 进入主页
- reveal 节点 attach 到 body，跨路由切换存活，新页面渲染后再淡出
## Both / Later 处理
- 两个次级选项保留，做成底部居中的玻璃 pill 链接（不抢戏）
- 不走对角线扩散动画，点击后直接 applyEngineSelection + navigate
## 兼容性
- prefers-reduced-motion: reduce → 关闭所有动画
- 移动端响应式：< 760px 调整字号 / 边距 / 角标
- 用 Vite define 注入的 __APP_VERSION__ 显示版本号（与 main.js / sidebar.js 一致）
## i18n
- engine.choiceTopBanner / choiceCtaEnter
- choiceOpenclaw{Tagline,Feat1,Feat2,Feat3,Category}
- choiceHermes{Tagline,Feat1,Feat2,Feat3,Category}
- choiceSecondary{Both,Later}
- 三语完整（zh-CN / en / zh-TW）
## 抽卡 prototype
保留 docs/engine-select-mockups/ 下的 V2 4 张设计 + 索引页（v2-monolith.html
即本次接入的最终版本）。
|
2026-05-14 06:22:32 +08:00 |
|