Commit Graph

87 Commits

Author SHA1 Message Date
晴天
ac2282591d feat(hermes): add provider routing config 2026-05-26 03:00:31 +08:00
晴天
fb7ae3f15c feat(hermes): add openrouter cache config 2026-05-26 02:36:37 +08:00
晴天
a52b70ade7 feat(hermes): add auxiliary model config 2026-05-26 02:18:03 +08:00
晴天
c5ed3ba5aa feat(hermes): add platform toolsets config 2026-05-26 01:50:06 +08:00
晴天
30dd6cc2e2 feat(hermes): add stt config form 2026-05-26 01:29:32 +08:00
晴天
bc7fa7b11b fix(hermes): improve dashboard touch targets 2026-05-26 01:05:17 +08:00
晴天
f4f65449f8 fix(hermes): stabilize chat health banner 2026-05-25 07:44:56 +08:00
晴天
c41340a9e0 feat(hermes): add prompt caching settings 2026-05-25 07:07:47 +08:00
晴天
e091a975c0 feat(hermes): add display output controls 2026-05-25 04:09:55 +08:00
晴天
a22b5b503d feat(hermes): add display run controls 2026-05-25 03:49:41 +08:00
晴天
054e45a8b3 feat(hermes): add logging settings 2026-05-25 03:29:56 +08:00
晴天
92d64efd8e feat(hermes): add cron output settings 2026-05-25 03:01:14 +08:00
晴天
e74df5f288 feat(hermes): add approval safety settings 2026-05-25 02:26:50 +08:00
晴天
ae1208d856 feat(hermes): add checkpoint rollback settings 2026-05-25 02:00:24 +08:00
晴天
77cadf9e0a feat(hermes): add agent runtime guard settings 2026-05-25 01:29:28 +08:00
晴天
4766a99d87 feat(hermes): add global toolset disable settings 2026-05-25 01:03:14 +08:00
晴天
8d5d21f908 feat(hermes): add browser tool settings 2026-05-25 00:27:06 +08:00
晴天
26d6ad18bc feat(hermes): add privacy redaction setting 2026-05-24 23:54:46 +08:00
晴天
459811b188 feat(hermes): add input output safety settings 2026-05-24 23:33:03 +08:00
晴天
d245d2e320 feat(hermes): add display reliability settings 2026-05-24 23:03:41 +08:00
晴天
8c963cd3d4 feat(hermes): add human delay settings 2026-05-24 22:31:52 +08:00
晴天
b2146b54cb feat(hermes): add tirith security settings 2026-05-24 22:08:12 +08:00
晴天
7be0ec66cc feat(hermes): add unauthorized dm policy form 2026-05-24 21:41:17 +08:00
晴天
2de5d1e38a feat(hermes): add quick commands config form 2026-05-24 21:21:16 +08:00
晴天
01f17f0a2a feat(hermes): add skills config form 2026-05-24 20:54:29 +08:00
晴天
d9fc9a8783 feat(hermes): add memory flush setting 2026-05-24 20:34:12 +08:00
晴天
56e41dd512 feat(hermes): add terminal execution config form 2026-05-24 20:06:50 +08:00
晴天
122d7a63be feat(hermes): add execution limits config form 2026-05-24 19:28:30 +08:00
晴天
c0b40070c0 feat(hermes): add channel display settings form 2026-05-24 18:42:34 +08:00
晴天
a1307716dd feat(hermes): add streaming config form 2026-05-24 08:40:53 +08:00
晴天
1883e18f02 feat(hermes): add memory config form 2026-05-24 08:04:31 +08:00
晴天
18ca140af8 feat(hermes): add tool loop guardrails form 2026-05-24 07:38:42 +08:00
晴天
5dd6f1be40 feat(hermes): add compression config form 2026-05-24 07:16:00 +08:00
晴天
f500da39c1 feat(hermes): add session runtime config form 2026-05-24 06:49:17 +08:00
晴天
4c29ed68ab fix(hermes): validate raw config saves 2026-05-24 06:10:07 +08:00
晴天
ff4da27eeb feat(hermes): add bundled plugin channel configs 2026-05-24 05:12:17 +08:00
晴天
6c947a1fec feat(hermes): support Discord plugin runtime config 2026-05-23 06:41:49 +08:00
晴天
d3d527ca34 feat(hermes): add dingtalk channel config 2026-05-23 03:48:33 +08:00
晴天
f7518ae4b3 fix(hermes): align channel secrets with runtime env 2026-05-23 02:49:31 +08:00
晴天
eccf91ed1e feat(hermes): add channel configuration editor 2026-05-23 01:51:08 +08:00
晴天
12cc9cd6ce fix(assistant): give assistant a Hermes identity, surface raw install hint, unblock CI
Three follow-ups the user spotted in one round.

assistant.js — assistant did not know it was on Hermes
  Both engines (OpenClaw and Hermes Agent) reuse the same /assistant
  page (engines/hermes/index.js comments it as "共用页面/引擎无关"),
  but getSystemPromptBase() hard-coded the OpenClaw self-introduction:
  "你帮助用户管理和排障 OpenClaw AI Agent 平台 / 你精通 OpenClaw 的架
  构…", followed by a CLI cheatsheet for `openclaw gateway start` and
  `openclaw config apply`. Result: under the Hermes engine, the
  assistant happily told users to run `openclaw doctor` and edit
  `~/.openclaw/openclaw.json` — neither of which exists in the Hermes
  world.

  Split into a per-engine dispatcher:
    getSystemPromptBase()
      └ if hermes  → getHermesSystemPromptBase()  (new)
      └ else       → getOpenclawSystemPromptBase() (renamed, same body)

  The new Hermes base prompt covers the facts that actually matter:
   - dual-process layout: Gateway 8642 (chat API, what ClawPanel
     mostly drives) vs Dashboard 9119 (admin/profiles/skills/oauth/
     kanban — must be started separately)
   - Profile system (independent workspaces, switchProfile restarts
     dashboard, multi-gateway view)
   - lazy_deps allowlist and why pre-installing matters
   - paths: ~/.hermes (data) and ~/.hermes-venv (interpreter), with a
     reminder that ~/.openclaw/clawpanel.json is the panel config
     shared with the OpenClaw engine — not Hermes data
   - Top-5 problem playbook (9119 not running, venv missing, channels
     hanging on first launch, gateway crashing, profile drift)
   - Explicit "do not give the user `openclaw …` commands"

  Two more spots in buildSystemPrompt() are also engine-aware now:
   - the "ClawPanel 工具能力" bullet list inside the soul-cache branch
   - the "跨平台路径" reminder (Hermes points to .hermes / .hermes-venv)

lazy-deps.js — "请确认目标资源是否仍存在" was masking the real hint
  When the user has not installed Hermes yet, Rust's
  `hermes_lazy_deps_features` returns the very actionable string
  "Hermes venv 未找到(~/.hermes-venv 不存在)。请先安装 Hermes。".
  humanize-error.js then sees "未找到", classifies the error as
  notFound, and replaces the message with the generic template
  "请确认目标资源是否仍存在" — which tells the user nothing about
  installing Hermes.

  Take humanizeError() but render `message + raw` instead of
  `message + hint`. The user now sees both the friendly title and the
  exact Rust-side instruction. Drop the unused humanizeErrorText
  import that this commit replaces.

config.rs — unblock CI (clippy too_many_arguments on existing code)
  The clippy gate has been red on main since e1eda2d ("import external
  client configs") because two helpers in commands/config.rs take >7
  positional parameters:
    - push_client_candidate (14 params)
    - scan_json_client_file (10 params)

  Both helpers exist purely to push a flat record into a Vec<Value>.
  Wrapping them in a struct just to satisfy clippy would force every
  caller to first build that struct, hurting readability. Suppress
  clippy::too_many_arguments locally on these two functions with an
  inline comment explaining why.

## Verification
- node --check + npm run build: clean
- cargo clippy --all-targets -- -D warnings: now compiles to
  "Finished `dev` profile" with zero errors/warnings (previously
  failed with two too_many_arguments)
- Playwright: import lazy-deps with api.hermesLazyDepsFeatures mocked
  to throw "Hermes venv 未找到 … 请先安装 Hermes。", rendered content
  contains "请先安装 Hermes" (hasRaw=true), does not contain the
  generic "请确认目标资源是否仍存在" (hasGenericNotFound=false), and
  does not contain "[object Object]"
2026-05-16 14:24:45 +08:00
晴天
4b0d8e5042 fix(ui): hide useless docker manager on desktop, auto-start hermes dashboard, polish layout
Four independent UI fixes the user spotted in one screenshot tour:

services.js — desktop docker manager
  ClawPanel is not a docker management tool. The "Docker 多实例管理"
  block on the OpenClaw services page only makes sense for users who
  deployed ClawPanel itself in Web mode (serve.js / dev-api) and want
  to orchestrate multiple OpenClaw containers from one panel.

  On desktop Tauri this block always degrades to either "未启用" with
  a connect ENOENT error (no docker daemon on the user box) or to a
  generic "unavailable" placeholder — pure visual noise. Skip the
  whole config-section in render() and bail out of loadDockerManager()
  when isTauriRuntime() is true. Web mode keeps the feature.

profiles.js — Hermes Profile manager could not load
  Profile API only exists on the Hermes Dashboard process at 9119,
  which the user has to start by hand. When it is offline, the page
  showed a raw "由于目标计算机积极拒绝, 无法连接 (10061)" error which
  is useless: users do not know they need to start a separate process.

  load() now does the same probe → auto-start dance that
  extensions.js / dashboard.js use for their 9119 links: probe first,
  call hermesDashboardStart() if not running, only then issue the
  /api/profiles request. If the start itself fails, we fall through to
  the original catch and humanize-error renders a real reason.

lazy-deps.js — "[object Object]" on load failure
  humanizeError() returns { message, hint, raw, action? }, not a
  string. The catch branch passed the object straight into
  escapeHtml(), so String(obj) coerced to "[object Object]". Switch
  to humanizeErrorText() which is exactly the (message + hint)
  one-liner string variant.

layout.css — header buttons crammed against the description
  Several pages (hermes profiles / lazy-deps / files / gateways /
  group-chat / kanban / oauth) put their header buttons inside
  <div class="config-actions"> nested in <div class="page-header">,
  but the existing flex layout rule only matched .page-actions. The
  buttons therefore stacked directly under .page-desc with zero
  visible gap. Add .config-actions to both the desktop flex selector
  and the @media (max-width:768px) column-stack selector so all
  these pages get the same title-left / actions-right layout.

## Verification
- npm run build (no warnings beyond the existing chunk size note)
- Playwright on /services in browser mode: docker section present;
  same page after mocking window.__TAURI_INTERNALS__: section gone
- Playwright on /lazy-deps: rendered content does not contain the
  string "[object Object]"
- Playwright dynamic-imports profiles / lazy-deps / files render():
  computed style on .page-header is display:flex, flex-direction:row,
  title and button share the same getBoundingClientRect().top, button
  pushed to the right edge (justify-content:space-between effective)
2026-05-16 13:46:24 +08:00
晴天
2256c2c711 fix(audit): 复查第三波 — Hermes 安装向导 i18n 化漏网中文
第三轮逐文件复查发现 hermes/pages/setup.js 还有大量用户首屏可见的
中文硬编码(之前两轮主要扫 timer/cleanup/syntax/listener 类 bug)。

## 涉及修复

### setup.js phase 标签(5 处)
phase indicator 是用户最早看到的 UI 元素:
```
{ id: 'detect',    label: '检测' }   →  t('engine.hermesPhaseDetect')
{ id: 'install',   label: '安装' }   →  t('engine.hermesPhaseInstall')
{ id: 'configure', label: '配置' }   →  t('engine.hermesPhaseConfigure')
{ id: 'gateway',   label: '启动' }   →  t('engine.hermesPhaseGateway')
{ id: 'complete',  label: '完成' }   →  t('engine.hermesPhaseComplete')
```
英文用户原本看到的是 5 个汉字,现在按系统语言显示
Detect / Install / Configure / Start / Complete。

### setup.js Provider 分组标题(4 组)
configure 阶段渲染 provider 选择按钮时分组标题:
```
'国际 · API Key'        →  hermesProviderGroupIntl
'国内 · API Key'        →  hermesProviderGroupCn
'聚合 / 路由'           →  hermesProviderGroupAggregator
'OAuth 登录(需终端)'   →  hermesProviderGroupOAuth
'<provider>:需运行'     →  hermesProviderOAuthRunHint
```

### setup.js Provider 加载失败 fallback 文案
Web 模式下 provider 列表加载失败时的 12 行多行 hint,原本只有中文,
现已 11 语言 i18n。

### setup.js 检测异常日志 prefix
```js
logs.push(`检测错误: ${e}`)  →  `[detect error] ${e?.message || e}`
```
日志输出(用户在向导首屏可见)跟其他英文 prefix 一致,便于日志聚合。

## 新增 i18n key(engine 模块)
- hermesPhaseDetect / Install / Configure / Gateway / Complete
- hermesProviderGroupIntl / Cn / Aggregator / OAuth
- hermesProviderOAuthRunHint
- hermesProvidersLoadFallback

11 语言全覆盖(zh-CN / zh-TW / en / ja / ko / vi / es / pt / ru / fr / de)。

## 复查范围(第三轮)
- src-tauri/src/commands/*.rs  unwrap 全 safe(regex / SystemTime / Mutex)
- src/lib/  humanize-error / engine-manager / ws-client / message-db / tts 全部健全
- src/components/  modal / toast 无问题
- scripts/dev-api.js  176 个 handler 无 duplicate / 关键命令全有
- src/pages/  没发现新硬编码(之前的 i18n 覆盖到位)
- src/engines/hermes/pages/  setup.js 是唯一遗漏的中文重灾区,已修

## 验证
- npm run build:PASS(1.46s)
- 总计三轮复查共修 11 个 bug + 5 个 i18n 漏网
2026-05-14 07:41:01 +08:00
晴天
d30714d406 fix(audit): 复查第二波 — alert/confirm 统一 + chat.js 潜伏语法 bug
## Bug #6 — chat.js 末尾多余 `}` 让 Vite build 卡死
src/engines/hermes/pages/chat.js

文件结尾 line 1635 已经闭合 render 函数,但 line 1636 多了一个孤立的
`}`,导致 esbuild 解析陷入回溯(build 卡在 transforming 47 modules
不退出)。删除多余括号后 build 1.55s 通过。

## Bug #7 — alert() / window.confirm 跨平台行为不一致
- src/engines/hermes/pages/setup.js  3 处 alert()
  · API Key 必填校验
  · 配置保存失败
  · Gateway 启动失败 fallback
- src/engines/hermes/pages/memory.js  2 处 window.confirm
  · 关闭未保存编辑窗
  · 取消编辑前的确认
- src/engines/hermes/pages/env-editor.js  1 处 confirm()
  · 删除环境变量

Tauri webview 在 macOS / Windows / Linux 三平台对原生 alert/confirm
处理不同(macOS 需要 webview 设置 navigation_handler,部分场景直接
忽略)。统一改用项目 components/toast + components/modal.showConfirm,
保证跨平台一致 + 可被样式化。

涉及函数 closeWithConfirm 改为 async 以等待 showConfirm Promise。

## Bug #8 — gateways.js 错误显示与其他页面风格不一致
src/engines/hermes/pages/gateways.js

`error = String(e?.message || e)` 直接显示 raw error 字符串,与
profiles/kanban/oauth 三个最近升级的页面不一致。改用 humanizeError
让用户看到友好提示 + 可折叠原始错误详情。

emoji ⚙️ 设置图标改用项目 svg-icons.js 的 settings SVG,与 Bug #5
emoji→SVG 重构保持一致。

## 验证
- npm run build:PASS(1.55s)
- 受影响场景:
  - 安装向导 API Key 缺失提示(toast 而不是阻塞 alert)
  - 记忆页未保存确认(modal 而不是平台原生 confirm)
  - 环境变量删除确认(modal 而不是平台原生 confirm)
  - 多 Gateway 加载失败错误展示(友好 + 可展开技术详情)
2026-05-14 07:24:47 +08:00
晴天
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
晴天
bf55ca0135 refactor(hermes): emoji → SVG 图标,统一视觉语言
## 问题
新加的 hermes 页面里到处是 emoji(⚠️📁📋💬🔐🔗🖼️📝⚙️📦💬🔊🎙🔍✓ 等),
不同 OS 渲染样式差异大(macOS Apple Color Emoji vs Windows Segoe UI Emoji
vs Linux Noto Color Emoji),看着很不专业,也跟现有 SVG 图标系统割裂。

## 方案
新建 src/engines/hermes/lib/svg-icons.js — 集中所有需要的 SVG path:
  状态:alert-triangle, check, x, check-circle, x-circle, info
  文件:folder, folder-up, file, file-text, image, link-2, settings
  列表:clipboard-list, message-square, inbox
  安全:lock, shield, key
  媒体:volume, mic, search

导出 svgIcon(name, opts) — 渲染时统一 viewBox / stroke-width / currentColor,
size 可选覆盖。

## 替换覆盖(7 个页面 + 2 处 CSS)
- profiles.js:    ⚠️ → alert-triangle, 📁 → folder
- kanban.js:      ⚠️ → alert-triangle, 📋 → clipboard-list, 💬 → message-square
- oauth.js:       ⚠️ → alert-triangle, 🔐 → lock
- group-chat.js:  ⚠️ → alert-triangle
- logs.js:        ⚠️ → 纯文本 [ERROR](log raw 字段不需要图标)
- files.js:       📁🔗🖼️📝⚙️📄 全部 → folder/link-2/image/file-text/settings/file
                  ".." → folder-up
- lazy-deps.js:   7 个 category emoji → message-square/volume/mic/search/
                  shield/inbox/image
                  ✓ 装好标识 → check svg
                  📦 empty → inbox

CSS 适配:
- .page-inline-error-icon: 加 inline-flex + 自动 currentColor,svg 20×20
- .empty-state .empty-icon: 加 inline-flex + svg 跟 font-size 走(1em)

## 范围控制
本次只处理我最近 3 个 commit 里新加的页面 emoji。
历史代码(setup.js / services.js / chat.js 的 ✓ 等)暂不动 — 那是
跨工作流的复杂改动,单独评估再做,避免连锁影响 CI。

## 验证
✓ npm run build PASS(1.80s)
2026-05-14 06:50:14 +08:00
晴天
d97e196a48 fix(chat): 会话列表无区分度,让用户误以为是 mock 数据
## 问题
用户截图:会话列表 20+ 项全部显示「新对话 / QC-505 / 5月8日」,
完全相同,怀疑是写死的 mock 数据。

## 真相
数据其实是真实的(hermes sessions export 输出的 JSONL):
- title 全空 → fallback 到 t('chatNewSession') = "新对话"
- 用户用同一模型 QC-505 跑了所有会话
- 用户在同一天(5月8日)跑的
- 视觉冗余 100% → 看起来像写死

## 修复(让真实数据显示出区分度)
1. sessionDisplayTitle: 没标题时不再统一显示「新对话」,
   改为「未命名 · {id 后6位}」(每个会话不同后缀,一眼能区分)
2. meta 行加 messageCount —— 显示「N 条」让每个会话有自己的数字
3. 加 i18n 键 chatUntitledSession + chatSessionMsgCount(11 语完整)

## 效果
之前:
  新对话
  QC-505 5月8日
  新对话
  QC-505 5月8日
  ... × 20

之后:
  未命名 · a3f2b8
  QC-505 5月8日 28 条
  未命名 · 7c91d4
  QC-505 5月8日 14 条
  未命名 · e082f1
  QC-505 5月8日 3 条
  ...

用户立刻能看出每个会话是真实独立的,不会再怀疑 mock。
2026-05-14 06:40:41 +08:00
晴天
1873e23371 fix(critical): 5 个用户报告的真 bug 一次性修
## P0 Bug 1: chat.js `t is not defined` (页面渲染崩溃)
- chat.js 用了 30+ 处 t() 但**完全忘记 import i18n**
- 路由进入 /h/chat 立即抛 ReferenceError,整页渲染失败
- 修复:补 `import { t } from '../../../lib/i18n.js'`

## P0 Bug 2: i18n 嵌套对象解析失败 (所有 humanizeError 显示原始 key)
- 用户截图:`common.errorHint.generic` 直接显示而非翻译
- 根因:buildLocales() 不递归嵌套对象,把 common.error / errorHint /
  errorAction 这种嵌套 dict 当作 _() 翻译对象处理 →
  `result[lang].common.errorHint = 'errorHint'` (字符串)
- 影响:t('common.errorHint.network'/auth/timeout/...) 全部返回 key 自身
  → toast 用 humanizeError 的所有页面都看到原始 key
- 修复:buildLocales 加 _isTranslationObject + _materialize 递归

## P0 Bug 3: dev-api.js `Dynamic require of "node:fs" is not supported`
- 用户截图:文件管理器红字 "Dynamic require of node:fs"
- 根因:我之前在 hermes_fs_* / _validateFsPath / _hermesHome 用了
  `const fs = require('node:fs')` —— 但 Vite 插件运行在 ESM 上下文,
  CommonJS dynamic require 不支持
- 修复:删除所有 require('node:fs/path/os') —— 文件顶部已经 ESM
  `import fs from 'fs'` 等,直接复用即可

## P1 Bug 4: profiles/kanban/oauth fetch failed 错误丑陋
- 用户截图:3 个页面都显示红字 "fetch failed"(无任何上下文)
- 修复 1(dev-api.js):hermes_dashboard_api_proxy 把 ECONNREFUSED /
  fetch failed 转成 "Hermes Dashboard 未运行(端口 9119 无服务)。
  请在桌面端 ClawPanel 启动 Hermes Agent" — 含「未运行」关键字会被
  humanizeError 的 gatewayDown 正则匹配
- 修复 2(3 个页面):用 humanizeError 拆出 message + hint + 折叠 raw,
  渲染统一的 .page-inline-error 卡片(icon + 主行 + 副提示 + 技术详情
  details)。错误对象不再 stringify,保留给 humanizeError 完整识别

## P2 Bug 5: 重复的 require('node:path') in hermes_fs_list
- 同 Bug 3,循环里又 require 了一次 path,现已用顶部 import

## 影响面
 /h/chat 不再崩溃,profile switcher 正常显示
 所有用 humanizeError 的 toast 看到正确翻译(不再显示原始 key)
 文件管理器 Web 模式正常列出 ~/.hermes 目录
 Profile / Kanban / OAuth 显示「Hermes Dashboard 未运行」+
   「请前往仪表盘启动 Gateway 后重试」+ 折叠原始错误(点击展开)
 npm build pass
2026-05-14 06:35:20 +08:00
晴天
cc19a07999 fix(hermes): sidebar 缺失 group-chat / files 入口 + 补 folder 图标
复查发现 2 个真 bug:路由注册了但 sidebar 没入口,用户点不到。

## §N 群聊 - sidebar 缺入口
- /h/group-chat 已注册路由(debce2f),但 sidebar monitor section 没加
- 修复:紧跟 /h/chat 之后插入「群聊」(agents 图标)

## §L 文件管理器 - sidebar 缺入口
- /h/files 已注册路由(129d8c0),但 sidebar manage section 没加
- 修复:紧跟 /h/oauth 之后插入「文件管理器」(folder 图标)

## sidebar.js 补 folder 图标
- ICONS 表里没有 'folder',导致 /h/files sidebar 项无图标(fallback 到空字符串)
- 加进去(24x24 viewBox 的标准 folder svg)

## 复查覆盖
✓ 61 个 hermes_* Tauri 命令全部在 lib.rs invoke_handler 注册
✓ 63 个 invoke('hermes_*') 调用在 dev-api.js 都有 fallback (除 hermes_agent_run_stream 走 webStream)
✓ 6 个新页面所有 t('engine.*') 键在 engine.js 都有定义(含 zh-CN/en/zh-TW 三语)
✓ 19 个 Hermes 页面文件齐备(最大 chat.js 1626 行,最小 channels.js 占位 17 行)
✓ cargo check 干净(仅 1 个 unused field 警告,不影响)
✓ npm build ✓
2026-05-14 05:53:32 +08:00
晴天
6b118877f1 refactor(hermes): UX 小白化最后一波 - skills/memory/cron 升级 humanizeError
完成 Hermes 引擎所有页面的统一错误处理改造。

## skills.js (2 处)
- 加载技能失败 → humanizeError(e, t('engine.skillsLoadFailed'))
- 启用/禁用切换失败 → humanizeError(e, t('engine.skillsToggleFailed'))

## memory.js (1 处)
- 保存记忆失败 → humanizeError(e, t('engine.memorySaveFailed'))

## cron.js (2 处)
- 加载定时任务失败 → humanizeError(e, t('engine.cronLoadFailed'))
- 保存定时任务失败 → humanizeError(e, t('engine.cronSaveFailed'))

## i18n 新增 2 键
- cronLoadFailed / cronSaveFailed × 3 语言

## 现在 Hermes 全部 16 个页面均统一了错误处理
统计:sessions / extensions / env-editor / usage / lazy-deps / config /
       skills / memory / cron / chat / setup / dashboard / services /
       profiles / kanban / oauth / files / gateways / group-chat

剩余原始 raw error 显示的位置都是合理的:
- dashboard.js install modal 日志 — 用户在看安装日志,raw 信息有用
- setup.js fetch 模型 — 已分类处理 403/404/timeout
- chat.js RUNNING_SESSION 错误 — 已特殊处理
2026-05-14 05:46:44 +08:00