GithubBackup/clawpanel
1
0
Fork 0
mirror of https://github.com/qingchencloud/clawpanel.git synced 2026-05-31 05:10:14 +08:00
Code Issues Packages Projects Releases Wiki Activity
455 Commits 16 Branches 69 Tags
debce2f8107f0ca55c3d96cd8024aa38a5ddc90c
Commit Graph

69 Commits

Author SHA1 Message Date
晴天
debce2f810 feat(hermes): Batch 3 §N - 群聊（多 Agent 并行响应） 
Hermes 内核没有「群聊」概念，由 ClawPanel 前端编排：
- 用户选 1-N 个 Profile（每个对应一个 Agent 配置）
- 发消息 → 串行调度（用 hermes_profile_use 切换 + hermesAgentRun 阻塞调用）
- 每个 Profile 的回复用 @profile_name 标记后显示在统一界面

## 新页面 /h/group-chat（~250 行）

### UI 布局
- 左侧 240px: Profile 多选列表
  · 顶部说明 + 已选 N 个统计
  · checkbox 风格，is-checked 高亮
- 右侧主区: 消息列表 + 输入框
  · user 消息右对齐（accent 蓝色气泡）
  · assistant 消息左对齐（每条带 @profile 徽章）
  · loading 状态用三点跳动动画
  · error 状态红色 + ⚠️ 图标
  · 输入框 Enter 发送 / Shift+Enter 换行

### 调度策略
- 当前实现：串行（hermes_profile_use 切换 + hermesAgentRun）
  · 简单稳健，避免后端并发对同一 profile 状态的竞态
  · 缺点：N 个 profile 总耗时 = N × 单次耗时
- 真正并发需后端支持 hermes_agent_run(profile=...) 参数
  · 留作下次内核改造（设计稿已记下）

### 限制（明确告知用户）
- 仅 Tauri 桌面端（Web 模式显示禁用提示）
- 非流式（用阻塞式 hermesAgentRun，等所有完成后一起显示）
- 不持久化（一次性会话，刷新清空，不挂 chat-store）
- 切 profile 后不还原（用户后续 /h/chat 会保持最后切到的 profile）

### sidebar
- 监控 section 加群聊入口（agents icon，紧跟 /h/chat 之后）
- /h/group-chat 路由注册

### CSS（~180 行）
- .hm-gc-layout: grid 双栏（响应式 → 单栏）
- .hm-gc-side: 左侧 profile 多选
- .hm-gc-main: 右侧消息列表 + 输入区
- 加载点动画 hm-gc-pulse
- @profile 徽章用 mono 字体 + accent 色

### i18n
- 13 个新键 × 3 语言（hermesGroupChat*）

## 累计
- 1 个新页面 ~250 行 + CSS ~180 行 + i18n 39 字符串
- npm build ✓
 2026-05-14 05:39:36 +08:00
晴天
129d8c0ac1 feat(hermes): Batch 3 §L - 文件管理器（限定在 ~/.hermes 子树内） 
校对：Hermes 没有 file HTTP API，必须自建。

## Rust 后端：3 个安全 fs 命令（~180 行）

### 安全策略
- 所有路径必须在 hermes_home() 子树内（防 path traversal）
- canonicalize 后用 starts_with 验证
- 拒绝绝对路径跳出 + .. 跳出
- 5 MB 文件大小上限
- 单次列目录最多 2000 条

### 命令
- hermes_fs_list(path) → { path, entries: [{name, kind, size, modified}] }
  · 隐藏文件默认不显示（.env 除外）
  · 排序：目录在前，文件在后，按名字
- hermes_fs_read(path) → { path, size, text?, binary_b64? }
  · UTF-8 文本 → text
  · 二进制 → 内置 base64 编码（不引新依赖）
- hermes_fs_write(path, content) → { path, size }
  · 父目录必须存在
  · 5 MB 上限

## 前端 /h/files 页面（~270 行）

### UI 布局
- 左侧：面包屑 + 目录树（点目录进入 / 点文件选中）
- 右侧：编辑器（文本）/ 预览（图片）/ 元信息（其他二进制）

### 文件树
- 文件图标按扩展名（📁/🔗/🖼️/📝/⚙️/📄）
- 文件大小显示（B/KB/MB）
- ".." 返回上级
- 选中态高亮

### 编辑器
- textarea 编辑，monospace 字体
- "保存 *" 状态标记 dirty
- 切目录/文件前 showConfirm 「丢弃未保存修改？」
- 保存成功 toast

### 二进制预览
- 图片 (png/jpg/gif/webp/svg) → 用 data: URL 显示
- 其他 → 「二进制文件（不可编辑）」+ 文件大小

## sidebar
- 「管理」section 加文件管理器入口（folder icon）
- /h/files 路由注册（含意外的 routes 顺序修复）

### dev-api.js
- Web 模式走 Node fs.readdirSync/readFileSync/writeFileSync
- 同样的安全策略：根目录 hermes_home() = process.env.HERMES_HOME 或 ~/.hermes
- realpath 验证 + 5 MB 限制

### CSS（~165 行）
- .hm-files-layout: grid 双栏（响应式 → 单栏）
- .hm-files-tree: 左侧树，breadcrumb + entry 列表
- .hm-files-pane: 右侧编辑器/预览
- .hm-files-editor: 全宽 textarea，monospace
- 响应式：768px 以下单栏

### i18n
- 12 个新键 × 3 语言（hermesFiles*）

## 修复
- src/engines/hermes/index.js 末尾多余 `}` 删除（之前 edit 留下）

## 累计
- Rust ~180 行 + 前端 ~270 行 + CSS ~165 行 + dev-api ~55 行
- 12 个 i18n × 3 语言
- cargo check ✓ + npm build ✓
 2026-05-14 05:36:50 +08:00
晴天
0d6c4614e4 feat(hermes): Batch 2 §G - 多 Gateway 看板（同时运行多 profile Gateway） 
设计：让用户给多个 profile 各自配 Gateway 实例，同时运行。
端口完全由 profile 的 config.yaml model.gateway.port 决定，ClawPanel 只负责 spawn + PID 跟踪。

## Rust 后端（~350 行）

### 数据结构
- MULTI_GW_PIDS: Mutex<Option<HashMap<String, u32>>> 全局 PID 表
- 持久化在 panelConfig.hermes.multiGateways: [{name, profile}]

### Helper 函数
- multi_gw_pids_get/set/remove: 线程安全 PID 表读写
- read_multi_gateways_config / write_multi_gateways_config: panel config R/W（保留其他字段）
- read_profile_gateway_port(profile): 缩进感知解析 profile config.yaml 的 model.gateway.port
- pid_is_alive(pid): Windows 用 tasklist /FI，Unix 用 kill -0 检测

### 5 个新 Tauri 命令
- hermes_multi_gateway_list() → [{name, profile, port, running, pid, owned}]
  · running = PID 存活 || TCP 探测可达
  · owned = ClawPanel spawn（可控制）vs 外部进程占着端口
- hermes_multi_gateway_add(name, profile) - 写入 panel config，名称合法性检查
- hermes_multi_gateway_remove(name) - 先停掉，再从配置删除
- hermes_multi_gateway_start(name) - spawn `hermes --profile <name> gateway run`
  · 注入 profile 的 .env
  · 等待端口可达（8 秒超时）
  · 记 PID
- hermes_multi_gateway_stop(name) - taskkill /F /PID (Windows) 或 kill -TERM (Unix)

### 发射 hermes-multi-gateway-changed 事件（前端可监听刷新）

## 前端（~230 行）

### /h/gateways 页面
- 顶部 + 添加 按钮
- 卡片网格（复用 .lazy-deps-grid）显示每个 Gateway:
  · name + status badge (运行中/已停止)
  · profile + port + PID + owned 提示
  · 启动 / 停止 / 删除 按钮
- 添加弹窗：name 输入 + profile 下拉（拉自 hermesProfilesList）
- 停止 / 删除均有 showConfirm（带 in-flight 警告）
- 外部进程占端口时 stop 按钮 disabled + tooltip

### sidebar
- 「管理」section 加 Gateways 入口（gateway icon）
- /h/gateways 路由注册

### dev-api.js
- Web 模式 fallback: 多 Gateway 不支持本地进程管理（throw friendly error）

### i18n
- 26 个新键 × 3 语言（hermesGateway*）

## 累计
- Rust ~350 行 + 前端 ~230 行 + i18n 78 字符串 + 路由/sidebar
- cargo check ✓ + npm build ✓
 2026-05-14 05:30:18 +08:00
晴天
b656ce74f8 refactor(hermes): UX 小白化 - chat.js profile 切换错误用 humanizeError 
之前是 toast(err?.message || String(err))，raw error 用户看到一堆英文 traceback。
现在用 humanizeError 自动：
- 分类（NETWORK/TIMEOUT/AUTH/NOT_FOUND/PERMISSION/...）
- 友好文案（中英繁三语）
- 自动加 action button（如「打开设置」「重试」「查看文档」）

## 文件
- chat.js: import humanizeError，profile 切换 catch 改 humanizeError(err, t('engine.chatProfileSwitchFailed'))
- i18n: 新增 chatProfileSwitchFailed × 3 语言

## 范围
仅 profile 切换这个高频操作 — 其他 chat-store 路径错误已通过系统消息气泡展示
（chat-store.js 添加错误消息时本身已经友好），不需要再改。
 2026-05-14 05:25:08 +08:00
晴天
d483e5bff9 feat(hermes): Batch 3 §Q - OAuth 三种登录 (PKCE / device_code / external) 
校对发现端点 + token 注入已就位（前一 commit），可直接做 UI。

## 新页面 /h/oauth (~250 行)

### 数据流
- GET /api/providers/oauth - 列表 + 状态（公开）
- POST /api/providers/oauth/{id}/start - PKCE 返回 auth_url，device_code 返回 user_code + verification_url
- POST /api/providers/oauth/{id}/submit { session_id, code } - PKCE 提交
- GET /api/providers/oauth/{id}/poll/{session_id} - device_code 轮询（公开）
- DELETE /api/providers/oauth/{id} - 断开

### UI
- 卡片网格（复用 .lazy-deps-grid）展示每个 provider
- active 徽章 + flow 标签 + token preview + expires 信息
- 「登录」按钮按 flow 类型分发：
  · **external** (claude-code 等)：showContentModal 显示 CLI 命令，用户终端运行后回点刷新
  · **PKCE** (anthropic)：
    1. 系统 window.open(auth_url) 打开浏览器授权
    2. showModal 弹窗：显示授权链接 + 让用户粘贴回调 code
    3. POST submit → 刷新状态
  · **device_code** (qwen / minimax / nous / openai)：
    1. window.open(verification_url) 打开授权页
    2. showContentModal 显示 6 位 user_code（大字号 mono 字体）
    3. 每 2.5s 自动 GET poll 轮询直到 success/failed/expired
    4. 10 分钟超时
    5. MutationObserver 监听模态关闭自动停轮询

### sidebar
- 管理 section 加 OAuth 入口（memory icon）
- 路由 /h/oauth 注册

### 修复：之前 edit 弄坏的 sidebar 结构
- 恢复 monitor 5 项（dashboard/chat/sessions/logs/usage）
- 恢复 manage 8 项（skills/memory/cron/profiles/kanban/oauth/lazy-deps/extensions）
- 删除文件末尾多余的 `}`

### i18n
- 26 个新键 × 3 语言（hermesOAuth*）

## 复用基础设施
- hermes_dashboard_api_proxy 自动注入 session token（前一 commit 已做）
- humanizeError 友好错误
- showModal / showContentModal / toast / lazy-deps-grid 样式

## 累计
- 1 个新页面 ~250 行
- sidebar 结构修复 + /h/oauth 路由注册
- 26 个 i18n 键 × 3 语言
- npm build ✓
 2026-05-14 05:23:02 +08:00
晴天
64f4668522 feat(hermes): Batch 3 §P TTS + Dashboard session token 自动注入 
核查发现：
- §P TTS: Hermes 内核没有 HTTP TTS 端点（只有 lazy_deps 的 tts.edge/elevenlabs PyPI 包） → 改用浏览器 Web Speech API（100% 离线、跨平台）
- Dashboard token: 9119 大部分 /api/* 需要 token 鉴权，token 注入到 SPA HTML 的 window.__HERMES_SESSION_TOKEN__ → 必须从 HTML 抓

## §P TTS — 浏览器原生（src/lib/tts.js）

新工具模块 src/lib/tts.js（~110 行）:
- speak(text, lang?) - 异步播放，返回 Promise
- toggle(text, lang?) - 重复播放则停止
- stopSpeaking() / isSpeaking() / isSupported()
- 自动语言检测：中/英/日/韩
- pickVoice 启发式：精确匹配 > 前缀匹配 > 默认
- Chrome bug 兼容：voiceschanged 异步加载 + 100ms 兜底

### chat.js 接入
- assistant 消息 footer 复制按钮旁加 🔊 朗读按钮（图标 speaker）
- 仅 tts.isSupported() 时渲染（不支持的浏览器隐藏）
- 点击 toggle，简化文本（去 markdown 代码块、url）
- 失败 toast 提示

### i18n
- chatSpeak / chatSpeakShort / chatSpeakFailed × 3 语言

### CSS
- .hm-chat-msg-tts 复用 copy 按钮风格

## Dashboard session token 自动注入器（解锁 §J/§O/§Q）

校对发现：dashboard 9119 大部分 /api/* 端点 _require_token 保护，
token 是进程启动时 secrets.token_urlsafe(32) 生成，没有公开获取 API，
只能 GET / 抓 SPA HTML 提取 window.__HERMES_SESSION_TOKEN__="..."。

### Rust 后端增强 hermes_dashboard_api_proxy
- 模块级 DASHBOARD_SESSION_TOKEN: Mutex<Option<String>> 缓存
- fetch_dashboard_session_token(port): GET / + 字符串搜索 needle 提取 token
- dashboard_session_token(port, force_refresh): 缓存 + 强刷接口
- proxy 实现：
  1. 拿缓存 token，注入 X-Hermes-Session-Token header
  2. 发请求；若 401 → 强刷 token 重试一次
  3. 仍失败抛 HTTP 错
- build_request 闭包复用避免重复代码

### Web 模式 dev-api 同步
- _fetchDashboardToken(port) 抓 HTML 正则提取
- _getDashboardToken(port, forceRefresh) 模块级缓存
- hermes_dashboard_api_proxy 401 重试逻辑

## 影响
- 已用 dashboard_api_proxy 的 §H Profiles + §M Kanban 立即受益（之前 401 会失败）
- §J dashboard plugin 可见性、§Q OAuth 现在可直接复用
- §O Terminal 走 WS，token 注入路径不同，但 _getDashboardToken 可复用

## 累计
- Rust: ~60 行（token 抓取 + 缓存 + 重试）
- 前端: tts.js 新文件 110 行 + chat.js TTS 按钮 + dev-api token 注入
- i18n: 3 个新键 × 3 语言
- cargo check ✓ + npm build ✓
 2026-05-14 05:19:02 +08:00
晴天
6a45c12d67 feat(hermes): UX 小白化第一步 - services restart/stop 加 showConfirm 防误触 
Gateway restart/stop 是高影响动作（in-flight agent runs 会断），
对应 Approval Flow / multimodal 等改进可能正在跑 — 误触代价大。

## services.js
- runGatewayAction('restart' | 'stop') 调用前先 showConfirm
- 文案：「正在进行的 Agent 会话会被中断」（impact 列表）
- danger 变体（红色确认按钮）
- start 不加 confirm（用户主动启动不需要）
- 复用 confirmText 用 dashRestartGw / dashStopGw（已有 i18n）

## i18n
- servicesConfirmRestart / servicesConfirmStop / servicesImpactInflight 3 个新键 × 3 语言
 2026-05-14 05:15:03 +08:00
晴天
3c8c315402 feat(hermes): Batch 2 §I + Batch 3 §M - 流恢复 + Kanban 看板 
## Batch 2 §I 流恢复（chat 在切页/刷新后能接上 run）

校对稿：用 run_id 持久化到 localStorage，新页面挂载时查询 status 决定是否重连。

### 后端
- 新 Tauri 命令 hermes_run_status(run_id):
  · GET /v1/runs/{run_id} 返回 { run_id, status, last_event, output?, ... }
  · status: running / stopping / completed / failed / cancelled / waiting_for_approval
  · 404 友好返回 status='not_found' 而不是抛错

### 前端 chat-store
- 新 STORAGE_ACTIVE_RUN 持久化 { runId, sessionId, profile, t }
- hermes-run-started 监听里 safeSet 持久化
- cleanupAfterRun 里 safeRemove 清理
- 新方法 recoverIfRunning():
  · 跨 profile / 1 小时过期 → 直接清
  · status=running/stopping/waiting_for_approval → attachStreamListeners + 恢复 streaming
  · status=已结束 → 拉最新 messages
  · 404 → 静默清

### chat.js
- 页面挂载时 store.recoverIfRunning() — 切页/刷新后无缝接上流

## Batch 3 §M Kanban 看板（Hermes 已内置）

校对稿：「Hermes 已内置 kanban 系统，直接调 /api/plugins/kanban/* 即可」。
设计稿原本是「自建本地存储」(~800 行)，复用 Hermes 内置后大幅缩减。

### 新页面 /h/kanban
- 全部走 hermesDashboardApi（复用 §H 的基础设施）
- 顶部 board 切换器 + 「+ 新任务」按钮
- 渲染 board.columns（按状态分列：todo / in_progress / blocked / done / archived）
- 任务卡片：title + summary（2 行截断）+ priority badge + assignee + 评论数
- 点卡片 → showContentModal 显示详情 + 「修改状态」按钮
- 修改状态 → PATCH /api/plugins/kanban/tasks/{id} { status }
- board 切换 → POST /api/plugins/kanban/boards/{slug}/switch

### sidebar
- 「管理」section 加 Kanban 入口（inbox 图标）
- /h/kanban 路由注册

### CSS (.hm-kanban-*)
- 水平滚动 board 容器
- 280px 固定宽度列 + 内部滚动
- 卡片 hover 边框变 accent 色 + 轻阴影
- 优先级 badge（琥珀色）/ assignee（accent 色）

### i18n
- 27 个新键 × 3 语言（zh-CN/en/zh-TW）

## 累计
- Rust: 1 个新命令（hermes_run_status ~30 行）
- 前端: chat-store 流恢复（~40 行）+ kanban 新页面（~230 行）
- i18n: 27 个新键 × 3 语言
- CSS: ~100 行
- cargo check ✓ + npm build ✓
 2026-05-14 05:12:37 +08:00
晴天
3168551569 feat(hermes): Batch 2 §H - Profiles 管理 UI + Dashboard API 通用代理 
校对稿要点：「Profiles 全部走 HTTP /api/profiles*，无需自己写 CLI 桥接」。

## 基础设施: hermes_dashboard_api_proxy（通用 9119 HTTP 代理）

新增 Tauri 命令 hermes_dashboard_api_proxy(method, path, body, headers):
- 支持 GET/POST/PUT/PATCH/DELETE
- 走 Dashboard 9119 端口（无需 API_SERVER_KEY，本地绑定）
- 自动 JSON parse + 错误时友好提示「请先启动 Dashboard」
- 一次实现，未来 Batch 2/3 的 Profiles/Kanban/OAuth/Sessions 都走这一个入口

前端 wrapper: api.hermesDashboardApi(method, path, body, headers)
dev-api.js: Web 模式同步实现

## Profiles 管理页 /h/profiles

新文件 src/engines/hermes/pages/profiles.js:
- GET /api/profiles 列表 → 渲染卡片网格（复用 .lazy-deps-grid 样式）
- 每张卡片：profile 名 + active 徽章 + Switch/Rename/Delete 按钮
- 「+ 新建」按钮 → showModal 弹窗（name + clone_from_default 选项）
- 「重命名」→ PATCH /api/profiles/{name} { new_name }
- 「删除」→ showConfirm（带 impact 提示「永久清除会话/凭据/记忆」）→ DELETE /api/profiles/{name}
- 「切换到此」→ 复用现有 chatStore.switchProfile（CLI 实现）
- 失败走 humanizeError 友好提示
- active profile 与 chatStore.state.activeProfile 对齐

## sidebar + 路由
- Hermes 引擎「管理」section 加 Profile 管理入口
- 路由 /h/profiles 注册到 hermes/index.js

## i18n
- engine.hermesProfilesTitle / hermesProfilesDesc / hermesProfilesEmpty
- hermesProfileNew / NewTitle / NameLabel / NameRequired / CloneFromDefault / CloneHint
- hermesProfileSwitch / Switched / SwitchFailed
- hermesProfileRename / RenameTitle / NewNameLabel / Renamed / RenameFailed
- hermesProfileDelete / DeleteConfirm / DeleteImpact / Deleted / DeleteFailed
- hermesProfileActive / Created / CreateFailed
- 共 21 个键 × 3 语言

## 累计
- Rust: 1 个新命令（hermes_dashboard_api_proxy ~50 行）
- 前端: 1 个 wrapper + 新页面 ~180 行
- dev-api.js: 1 个 handler
- i18n: 21 个新键 × 3 语言
- cargo check ✓ + npm build ✓
 2026-05-14 05:04:53 +08:00
晴天
8eb8a7666e feat(hermes): Batch 3 §K - 多模态图片上传（chat attach + 拖拽 + 粘贴 + base64） 
Hermes Agent 已支持 OpenAI 多模态格式（tests/gateway/test_api_server_multimodal.py），
ClawPanel 前端补 attach UI 即可对接 Claude 3.5 / GPT-4o / Gemini 等视觉模型。

## 后端
- HermesAttachment 结构：{ kind, mime, name?, data_base64 }
- build_multimodal_input(text, attachments) 把 text 转成
  [{type:"text",text}, {type:"image_url",image_url:{url:"data:..;base64,.."}}, ...]
- hermes_agent_run 加 attachments 参数（向后兼容：未传时走原 string input）

## 前端
- tauri-api.js: hermesAgentRun 加 attachments 参数
- chat-store sendMessage:
  · 允许 text 空但有 attachments 也能发
  · user 消息记录 attachments[].dataUrl 用于气泡内渲染
  · isTauriRuntime 时 await api.hermesAgentRun(...,atts)
- chat.js 渲染层:
  · renderMessage 在内容前插入 .hm-chat-msg-attachments + .hm-chat-msg-image（点击放大）
  · 输入栏前面增加 .hm-chat-attach-preview 预览条（缩略图 + 文件名 + × 移除）
  · 输入框左侧加 paperclip attach 按钮 + 隐藏 <input type="file" accept="image/*" multiple>
  · 发送按钮 disabled 条件改为 (!text && !attachments)
- chat.js 交互:
  · fileToBase64 用 FileReader 转纯 base64
  · addAttachmentFromFile 校验 image/* + 10MB + 最多 5 张
  · attach 按钮 click → 触发文件选择器
  · 拖拽到输入区 → dragover 高亮 + drop 加附件
  · 粘贴图片 → clipboardData 读 image 文件
  · 移除按钮 splice
- chat-store.sendMessage 后清 pendingAttachments

## 限制
- 单图最大 10 MB（base64 后约 13 MB）
- 一次最多 5 张
- 超限 toast 友好提示
- 非图片格式拒收

## CSS
- .hm-chat-attach-btn / hover / disabled
- .hm-chat-attach-preview / chip / chip-name / chip-remove
- .hm-chat-input-wrap--dragover（拖拽虚线高亮）
- .hm-chat-msg-attachments / msg-image / msg-image--zoom（点击放大模式）

## i18n
- engine.chatAttach / chatAttachRemove / chatAttachOnlyImage
- chatAttachTooBig / chatAttachTooMany / chatAttachReadFailed
- 3 语言（zh-CN/en/zh-TW）

## 注意
- Web 模式（dev-api 走 SSE）暂不支持 attachments 透传（hermes_agent_run_stream 没改），
  原因：Web 模式当前 chat 是 stream-only 路径，需要单独改 dev-api 的 hermes_agent_run_stream handler
- 桌面端 Tauri 模式开箱可用
- 累计变动：6 个文件，~120 行新代码，6 个 i18n 键
- cargo check ✓ + npm build ✓
 2026-05-14 04:59:36 +08:00
晴天
112963b2b7 feat(hermes): Batch 1 §E - Sessions 导出（走 dashboard /api/sessions/{id}/messages） 
校对稿订正：不走 CLI `hermes sessions export`，直接调 dashboard 9119 HTTP API。

## 后端
- 新 Tauri 命令 hermes_session_export(session_id):
  · GET http://127.0.0.1:{dashboard_port}/api/sessions/{id}/messages
  · 拿原始 JSON 返回前端
  · 错误提示「请先启动 Dashboard」（dashboard server 必须运行）

## 前端
- tauri-api.js: hermesSessionExport wrapper
- sessions.js: 详情面板「打开会话 / Pin / 导出 / 删除」并列布局
  · 点导出 → Blob + URL.createObjectURL + a.download 浏览器下载 hermes-session-{id}.json
  · toast 成功/失败
- dev-api.js: Web 模式 handler 同步调 dashboard 端口

## i18n
- sessionsExport / sessionsExportSuccess / sessionsExportFailed × 3 语言
 2026-05-14 04:54:25 +08:00
晴天
832bb9a6ef feat(hermes): Batch 1 §A + §B + P1-3 lazy_deps 优化 - 占位修 + 中文硬编码清 + 自定义 venv 适配 
## §A channels.js 占位路由处理
- /h/channels 当前是 487 字节 placeholder
- 已确认 sidebar 没挂入口（getNavItems 不含 channels）
- 路由表保留但加注释表明这是 reserved，完整实现见 Batch 3

## §B config.js i18n 化（清理 5 处硬编码）
- "重新加载" / "保存配置" / "saving…" / "loading…" / "raw yaml editor"
- "配置已保存，建议重启 Hermes Gateway 生效" toast
- 抽 7 个新键到 locales/modules/engine.js（3 语言）：
  · hermesConfigEyebrow / hermesConfigReload / hermesConfigSave
  · hermesConfigSaveSuccess / hermesConfigStatusSaving
  · hermesConfigStatusLoading / hermesConfigStatusReady

## P1-3 lazy_deps 校对稿优化（commit b852ebb 的补丁）
hermes_venv_python() 增加 HERMES_PYTHON 环境变量优先级：
1. HERMES_PYTHON env var（适配 brew / uv tool / 容器等自定义 venv）
2. ~/.hermes-venv/{bin/python | Scripts/python.exe}（默认）

allow_lazy_installs 守门：经核实内核 tools.lazy_deps.ensure 内部已检查
security.allow_lazy_installs，禁用时抛 FeatureUnavailable，Rust 端已捕捉
并友好返回错误（无需额外代码）。

## 累计
- 3 个修改文件（hermes/index.js + config.js + engine.js + hermes.rs）
- 7 个新 i18n 键 × 3 语言
- cargo check ✓ + npm build ✓
 2026-05-14 04:51:16 +08:00
晴天
efade55f61 feat(hermes): Batch 1 §C+§D+§C-bis - Approval Flow + Stop 真中断 + 3 类新事件 
校对稿（hermes-source-verified）基于真实 Hermes 源码确认了关键事实：
- 真实 SSE 事件 9 类（设计稿推测的 6 个根本不存在）
- 真实 abort 端点：POST /v1/runs/{run_id}/stop（用 run_id 不是 session_id）
- Approval Flow 是 Hermes 重要原生特性，ClawPanel 0% 接入 → 跑代码工具就崩

本 PR 一次解决 3 个必修硬伤：

## 修复 1: Stop 假停（§D）
- 新 Tauri 命令 hermes_run_stop(run_id) → POST /v1/runs/{run_id}/stop
- chat-store: state 新增 currentRunId，来自 hermes-run-started 事件
- stopStreaming() 改为：先调 hermes_run_stop(currentRunId) 通知后端，再 abort 本地 SSE
- 之前 stopStreaming 只 abort 本地 SSE，后端继续跑完 → 是「假停」

## 修复 2: Approval Flow 接入（§C-bis 新增 — 设计稿原本没写）
- 新 Tauri 命令 hermes_run_approval(run_id, choice) → POST /v1/runs/{run_id}/approval
- choice 枚举校验：once / session / always / deny
- chat-store: state.pendingApproval 存待批准信息（tool, args, choices, run_id）
- chat.js: 新增 renderApprovalPanel() 渲染琥珀色气泡 + 4 按钮 + JSON args 预览
- store.respondApproval(choice) 暴露给 UI（乐观清状态 + 失败回滚）
- 用户跑代码工具（terminal/code_execution）时会触发，没接入就会卡死

## 修复 3: SSE 事件白名单补 3 类（§C 校对版）
- normalize_hermes_stream_event 白名单增加：
  · approval.request   → emit hermes-run-approval-request
  · approval.responded → emit hermes-run-approval-responded
  · run.cancelled      → emit hermes-run-cancelled（终态，返回 Ok(true)）
- chat-store 新监听 u5..u9（5 个新事件）：
  · hermes-run-started      → 存 currentRunId
  · approval-request        → 设 pendingApproval
  · approval-responded      → 清 pendingApproval
  · cancelled               → 标记 (stopped) + cleanup
  · reasoning               → 标记 hasReasoning（设计稿推测的 reasoning.delta 不存在）
- handleStreamEvent（Web 模式）同步加 4 个新分支

## chat.js UI
- renderApprovalPanel：琥珀色边框 + 🔐 emoji + 工具名 + JSON args 预览 + 4 选项按钮
- "deny" 用 btn-secondary（灰色），其他 btn-primary（蓝色）
- 按钮点击 → store.respondApproval(choice) → 后端 POST + 等服务端 approval.responded 作权威清理
- streaming 中显示 aborting 文案当 state.aborting=true

## CSS (.hm-chat-approval*)
- 琥珀色边框 + 半透明背景（明/暗主题各自适配）
- args 单独 monospace 代码块、max-height: 180px 防过长
- 响应式：max-width: 720px，按钮 flex-wrap

## i18n
- engine.chatAborting / chatApprovalTitle / chatApprovalHint
- chatApprovalOnce / chatApprovalSession / chatApprovalAlways / chatApprovalDeny
- chatApprovalFailed
- 3 语言（zh-CN/en/zh-TW），其它语言走 fallback

## 设计稿对照（保留可信细节，砍掉推测）
- ✅ 留：approval.request / approval.responded / run.cancelled / reasoning.available（4 类真实事件）
- ❌ 砍：reasoning.delta / thinking.delta / compression.* / abort.* / usage.updated / run.queued（6 类不存在的事件，hermes-web-ui 内部合成）
- ✅ 修：abort 端点路径 /v1/runs/{run_id}/stop（用 run_id）

## 累计
- Rust: 1 个 helper（read_hermes_api_key） + 2 个新命令 + emit_hermes_stream_event 加 3 分支
- 前端: chat-store 新 4 个 state 字段 + 5 个监听器 + 4 个 handleStreamEvent 分支 + respondApproval API
- chat.js: renderApprovalPanel + 按钮绑定 + aborting 文案
- i18n: +8 个键 × 3 语言
- cargo check ✓ + npm build ✓
 2026-05-14 04:48:14 +08:00
晴天
c00b2dbf64 feat(openclaw): P1-6 config.schema RPC 写入校验 - 防小白改坏配置 
OpenClaw 内核 config.set/patch 写入时已经会校验，但用户要等点保存才看到错误。
本 PR 把校验提前到前端，让用户改完字段立刻看到红字提示。

## 新增工具 src/lib/config-schema.js
- getFieldSchema(path) — 调内核 config.schema.lookup，带 5 分钟缓存
- validateField(path, value) — 拿 schema 后做基础约束校验
- validateFieldSync(schema, value, path) — 已有 schema 时同步校验
- clearSchemaCache(path?) — 清缓存（极少需要）

## 校验维度（不引入 ajv，保持 vanilla JS 体积）
- required — 必填空值检查
- type — string / number / integer / boolean / array / object / null
        （含「数字字符串当数字看」的容错）
- enum — 枚举白名单
- minimum / maximum — 数值范围
- pattern — 字符串正则

## 友好错误文案（i18n）
- common.error.schemaRequired / schemaType / schemaEnum / schemaMin / schemaMax / schemaPattern
- 6 个键 × 11 语言全覆盖
- 替换 schema 给的英文 path 后用户看到的是：
  「Gateway 端口不能小于 1024」「gateway.port 应该是「integer」类型」

## 集成示范：gateway.js
- saveConfig 开头先 validateField('gateway.port', port)
- 失败 → toast 红字 + focus 回 port 输入框 + early return
- 通过 → 走原流程
- 内核无该 schema 时降级放行（不阻断保存）

## 设计哲学
- 内核仍是最终守门人（config.set/patch 会再校验）
- 本模块的价值是「立即反馈」+「未来动态 UI 渲染」基础
- 容错优先：schema.lookup 失败时静默放行，不影响老内核兼容性

## 累计
- 1 新文件（config-schema.js）
- 2 修改（gateway.js / common.js）
- 6 个新 i18n 键 × 11 语言
- 后续可在 memory/dreaming/security/cron 等页面同样接入
 2026-05-14 04:30:23 +08:00
晴天
e717a7a098 feat(openclaw): P1-0 push.web.* 推送通知 - ClawPanel 关掉也能弹系统通知 
OpenClaw 内核已实现 4 个 push.web.* RPC（vapidPublicKey / subscribe / unsubscribe / test），
但 ClawPanel 完全没接。这次打通整条链路：浏览器 → Service Worker → 内核 → 系统通知中心。

## 收益（用户视角）
- ClawPanel 浏览器标签/桌面应用关掉后，Agent / Cron / 渠道消息仍能弹到
  Windows / macOS / iOS / Android 系统通知中心
- 锁屏可见，可离线接收（推送服务由浏览器厂商分发）
- 是下一版主推卖点

## 实施（无需新增 Tauri 命令）
- wsClient.request 直接走 WebSocket 调内核 4 个 RPC

## 前端封装 src/lib/push-web.js
- isPushSupported() / pushPermission() / requestPushPermission()
- ensureServiceWorker() 注册 /push-sw.js（幂等）
- subscribePush() 完整流程：权限 → SW → push.web.vapidPublicKey → PushManager.subscribe → push.web.subscribe 上报内核
- unsubscribePush() 本地取消 + 通知内核清理
- sendTestPush(title, body) 调 push.web.test 广播测试
- getCurrentSubscription() / isLocallySubscribed() 状态查询
- urlBase64ToUint8Array / arrayBufferToBase64Url 工具函数
  （VAPID 公钥 base64url ↔ 二进制，订阅 keys 编码）

## Service Worker public/push-sw.js
- skipWaiting + clients.claim 立即激活
- push 事件：解析 JSON payload → showNotification（含 icon / badge / tag / requireInteraction）
- notificationclick：优先聚焦已打开标签 + postMessage 跳转 url；
  没有窗口就 openWindow 新开
- 所有路径容错（payload 解析失败 fallback 到默认文案）

## UI 页面 src/pages/notifications.js
- 状态行：通知权限 + 订阅状态（彩色徽章）
- 端点摘要（订阅成功后展示截断的 endpoint，方便用户确认）
- 三个动作按钮（互斥）：启用 / 取消订阅 / 发测试通知
- 测试通知会显示「已投递到 N 个订阅」提示
- 不支持环境（Tauri 1.x 桌面壳或老浏览器）显示友好的「Push not supported here」空状态
- 全程走 humanizeError 友好错误提示

## i18n src/locales/modules/notifications.js
- 26 个键 × 11 语言全覆盖
- 含权限徽章 / 操作按钮 / 流程提示 / 不支持环境说明

## 入口
- OpenClaw 引擎「配置」section 新增「推送通知」入口
- sidebar.notifications i18n（短词「推送通知 / Push」）
- 路由 /notifications 注册到 OpenClaw 引擎
- Hermes 引擎暂不注册（push.web.* 是 OpenClaw 内核的 RPC）

## CSS
- 加 .push-status-row / .push-status-item / .push-status-label / .push-status-value
- 复用现有 .lazy-deps-badge.{ok,warn,unknown} 样式

## 待跟进
- iOS Safari 16.4+ 需用户先把 ClawPanel 添加到主屏才能收 push（已知限制，文档跟进）
- 真实流量（不只是 push.web.test）需 OpenClaw 内核侧把通知事件主动 send 出来；
  本 PR 把订阅渠道彻底打通，后续内核怎么用现成订阅发送是另一题
- 累计变动：4 新文件 + 4 修改
 2026-05-14 04:27:33 +08:00
晴天
b852ebb6ee feat(hermes): P1-3 lazy_deps 预处理 - 加 IM 渠道不再「首启 Gateway 卡 30 秒后崩」 
Hermes 内核 tools/lazy_deps.py 维护了一个 allowlist：每个 feature（如 platform.telegram /
tts.elevenlabs / search.exa）对应一组 PyPI 包。原本只有 Gateway 启动 platform 模块时
才会调 ensure() 装包，导致首次启动卡 30 秒甚至超时崩溃。

本 PR 把 lazy_deps 暴露给 ClawPanel UI，让用户能主动预装。

## 后端三个新 Tauri 命令
- hermes_lazy_deps_features() — 列所有 LAZY_DEPS allowlist feature（17 个）
- hermes_lazy_deps_status(features) — 批量查每个 feature 是否已装好
- hermes_lazy_deps_ensure(feature) — 主动调内核 tools.lazy_deps.ensure 装

实现方式：
- 找到 ~/.hermes-venv 的 python 路径（unix: bin/python，windows: Scripts/python.exe）
- 用 tokio::process::Command spawn `python -c "<embedded script>"` 跑临时 Python 脚本
- 脚本走 from tools.lazy_deps import ensure / feature_missing / LAZY_DEPS
- 把结果以 JSON dump 给 stdout，Rust 端解析最后一行
- enhanced_path() 注入 PATH 兼容 macOS Tauri 启动后 PATH 不全
- serde_json::to_string 把字符串和列表序列化为 Python 合法字面量（防注入）

已注册到 lib.rs，前端 wrapper 在 tauri-api.js（features 走 10min 缓存）。

## 前端
- 新页面 src/engines/hermes/pages/lazy-deps.js
- 分类 grid（消息渠道 / TTS / STT / 搜索 / 模型商 / 记忆 / 图像 / 其他），每类有 emoji
- 卡片式：feature 名（友好显示）+ specs 元信息 + 状态徽章（已装✓ / 未装warn / 未知）+ 装/重装按钮
- 装/重装按钮 await ensure，期间「安装中…」disabled，完成后刷新整张表
- 失败走 humanizeError 统一提示
- 17 个 feature 都有友好显示名 i18n（platform.telegram → Telegram，platform.dingtalk → 钉钉 等）
- 完整 11 语言 i18n（hermesLazyDeps 模块），其它语言 fallback 到 en

## sidebar
- Hermes 引擎「管理」section 新增「可选依赖管理」入口
- 路由 /h/lazy-deps

## CSS
- 加 .lazy-deps-grid / .lazy-deps-card / .lazy-deps-badge.{ok,warn,unknown}
- 复用现有 .empty-state / .empty-compact 风格

## Web 模式
- dev-api.js 加三个同名 handler：
  - features 返回内置常见 platform 列表
  - status 全标 unknown（无法 spawn python）
  - ensure 直接 reject，提示走桌面端

## 累计变动
- 2 新文件（lazy-deps.js page + hermesLazyDeps.js i18n）
- 7 修改（dev-api / hermes.rs / lib.rs / hermes/index.js / tauri-api.js / locales/index.js / components.css）
- 11 语言 × ~17 个新 i18n 键
- cargo check ✓ + npm build ✓
 2026-05-14 04:18:33 +08:00
晴天
7eababad4a feat(ux): toast 智能行动按钮 + 拓展 ⓘ 到 gateway/agents + sidebar 加术语表入口 
延续上一轮小白 UX 改造的尾声三连：

## 1. toast 智能行动按钮（U2 收尾）
- humanizeError 输出新增 action 字段：{ label, route?, handler?, kind }
- 自动按错误 kind 给默认按钮：
  · gatewayDown → [去启动 Gateway] → /services
  · cmdMissing / permission → [打开设置] → /settings
  · auth → [检查 API Key] → /models
  · network / timeout / rateLimit / generic → 不给（重试由用户控制）
- toast 结构化分支渲染 .toast-action-btn 按钮，点击后用 navigate(route) 或调 handler，并自动关闭 toast
- common.js 加 errorAction.* 三个按钮文案 i18n（11 语言）

## 2. ⓘ 拓展到 gateway / agents
- gateway.js: token label 后加 ⓘ（apikey 术语），renderConfig 末尾 attachTermTooltips
- agents.js: addAgent 弹窗 workspace 字段 label 加 ⓘ，setTimeout 扫 document.body 绑定
- term-tooltip.js 精简表新增 4 个术语：workspace / provider / baseurl + scope（已有）

## 3. sidebar 加术语表入口
- 在两个引擎（OpenClaw + Hermes）的最后一个 section 加「术语」条目
- sidebar.js i18n 新增 glossary 键（11 语言）
- 之前只能从 dashboard quick-actions 进入，现在 sidebar 永久可达

## 4. 顺手 bug 修复
- gateway.js 文件末尾历史残留的多余 `}` (line 348) syntax 错误，删除
- 与之前 hermes/cron.js 同类问题，本次改 ⓘ 时被 node --check 暴露

## 累计变动
- 10 个文件修改
- 7 个新 i18n 键（11 语言）
- Build OK
 2026-05-14 03:47:25 +08:00
晴天
e710db6ffb feat(ux): 小白 UX 全面改造 - 错误友好度 + 致命操作强确认 + 空状态 + 新手引导 + 术语表 
面向小白用户的产品定位重塑，从七大 UX 痛点逐一改造：

## U1 错误友好度（59 处改造）
- 新工具 src/lib/humanize-error.js：自动把后端原始错误（fetch failed、ENETUNREACH、ENOENT 等）
  映射成「主行 + hint 行动建议 + 折叠技术详情」三段式结构化对象
- toast 组件升级支持 { message, hint, raw } 结构化入参，向后完全兼容
- 14 个 page 文件中所有 toast(t('xxx.failed') + ': ' + e, 'error') 替换为 toast(humanizeError(e, t(...)), 'error')
- common.js 加 error.* / errorHint.* 共 13 个新 i18n 键（11 语言）：
  网络/Gateway 未启动/命令缺失/权限/超时/限流/未找到/鉴权/服务繁忙/通用

## U2 致命操作强确认（14 处改造）
- showConfirm 升级支持结构化对象 { message, impact[], title, confirmText, cancelText, variant }
- 加 .modal-impact-list 红边样式（让小白看清楚删了会丢什么）
- 14 处致命操作改造，每处显示影响列表 + 红色「删除/移除/重置」按钮 + 灰色「保留」取消：
  · agents.js 删除 Agent（动态显示 N 个绑定影响）
  · channels.js 移除平台（动态算 N 个 binding）+ 移除 Agent binding
  · memory.js 删除记忆文件
  · services.js 卸载 Gateway（3 段影响）+ 删除备份
  · models.js 批量删模型
  · chat.js 删除会话 + 重置会话
  · dreaming.js 重置梦境日记 + 清空 grounded 短期记忆
  · agent-detail.js 解除渠道绑定
  · cron.js 删除任务（OpenClaw + Hermes 两端）
- skills.js 原生 confirm() 改 showConfirm
- hermes-cron.js 原生 confirm() 改 showConfirm，顺手修末尾多余 `}` 的 syntax 残留

## U3-C 空状态 emoji+CTA（5 页面）
- 通用 .empty-state 组件（大 emoji + 标题 + 副本 + CTA 按钮 + 紧凑变体）
- agents.js: 🤖 + 「+ 新建 Agent」CTA
- memory.js: 🧠 + 「+ 新建记忆文件」CTA（紧凑版）
- cron.js: ⏰ + 「+ 新建任务」CTA
- skills.js: 🛠️ + 「技能商店」CTA（点击切 Tab）
- channels.js: 💬 + 紧凑提示
- CTA 巧妙复用页面顶部已有按钮的 click，零重复逻辑

## U3-B Dashboard 新手任务卡片
- 蓝紫渐变卡片，4 步任务自动检测：启动 Gateway / 添加模型 / 创建 Agent / 第一次聊天
- 已完成：✓ 徽章 + 删除线 + 60% 透明
- 未完成：编号徽章 + 蓝色 CTA 按钮跳对应页面
- 全部完成 → 庆祝条「🎉 全部搞定！」+ 关闭按钮
- localStorage 标记，用户主动关闭后永久隐藏
- 14 个新 i18n 键，文案小白化（Gateway 是「发动机」/ Agent 是「分身」/ 模型给 AI 装「大脑」）

## U3-A 术语表页（/glossary）
- 25 个核心术语 × 4 大分类（核心 8 / 模型 6 / 接入 5 / 进阶 6）
- 搜索框实时过滤 + Tab 切换分类 + 卡片网格布局
- 每条术语：「比喻 + 一句话」描述（避免循环引用）+ 「打开页面 →」CTA 直达配置
- 3 语言（zh-CN / en / zh-TW）完整翻译，其他 8 语言 fallback
- 双引擎（OpenClaw + Hermes）共用路由
- dashboard quick-actions 加「📖 面板术语」入口

## U3-D 术语 ⓘ tooltip
- 通用 src/lib/term-tooltip.js helper：termHelpHtml(id) + attachTermTooltips(root)
- 8 个高频术语精简表（OAuth / Webhook / Bot Token / API Key / Token / Context Window / Binding / Scope）
- channels.js 字段 label 智能匹配关键词自动追加 ⓘ（覆盖 8 个渠道全部敏感字段）
- models.js 添加/编辑 provider 的 API Key label 也加 ⓘ
- 点 ⓘ → 弹小型 modal 含解释 + 「打开术语表 →」CTA
- attachTermTooltips 内部去重，可安全多次调用

## 累计交付
- 4 个新文件（humanize-error.js / term-tooltip.js / glossary.js page / glossary.js i18n）
- 6 个升级文件（toast / modal / components.css / dashboard / channels / models）
- 14 个 page 错误 toast 友好化（59 处）
- 14 处致命操作强确认
- 5 处空状态升级 + Dashboard 新手卡片 + 术语表 + ⓘ tooltip
- 109 个新 i18n 键（11 语言）
- Build 全程通过
 2026-05-14 03:38:47 +08:00
晴天
7d4a423df0 feat(hermes-install): diagnose network failures and add optional Git mirror (#273) 
- Detect git/network failure patterns (failed to connect, could not resolve host,
  unable to access, etc.) in install/update output and append a clear hint
  pointing users to the proxy or mirror settings instead of leaving them with
  raw multi-line git stderr.
- Add optional 'Hermes Install Mirror' setting (panelConfig.gitMirror): when set,
  install/upgrade injects GIT_CONFIG_COUNT/KEY_0/VALUE_0 to rewrite
  https://github.com/ via the mirror prefix at process scope only — the user's
  global ~/.gitconfig is never touched.
- Surface the new mirror field in Settings (works for both engines), with
  zh-CN/en/zh-TW copy and a hint explaining how it interacts with the install
  flow.
 2026-05-14 01:46:55 +08:00
晴天
e9cd2c6059 feat(hermes-chat): show readiness banner when Hermes is missing or Gateway is down (#256) 
- Surface a top-of-input warning banner on the chat page when:
  * Hermes Agent is not installed -> red 'go to dashboard' banner;
  * Gateway is not running -> amber banner with the same dashboard link.
- Disable the send button (with a contextual tooltip) so users no longer
  hit cryptic backend errors when their environment is not ready.
- Force-refresh the cached check_hermes status on chat mount so a freshly
  started Gateway is reflected immediately instead of waiting 30s.
- Add zh-CN/en/zh-TW copy + matching error/warn styling that reuses the
  existing Hermes color tokens.
 2026-05-14 01:37:59 +08:00
晴天
31dcf64426 fix(ws): friendlier error when Gateway kernel does not support v3 handshake (#272) 
- Detect 'device signature invalid' / 'protocol mismatch' on WebSocket close (code 1008)
- Detect DEVICE_AUTH_SIGNATURE_INVALID/PROTOCOL_VERSION_MISMATCH on connect failure after auto-pair
- Replace cryptic English reason with kernel.tooOldForProtocol message (zh-CN + en)
- Suggest upgrading Gateway kernel to recommended version (2026.5.x)
- Stop auto-reconnect loop in these unrecoverable cases
 2026-05-14 01:16:33 +08:00
晴天
81c42dbfe2 chore: release v0.15.1 2026-05-10 21:30:36 +08:00
晴天
328624cf03 chore: release v0.15.0 
发布 0.15.0：
- 新增内核版本兼容层、特性门控、低版本阻断和升级提示
- 新增 PATH 中 OpenClaw CLI 冲突检测、隔离与恢复
- 修复 Hermes Gateway loopback 自动拉起与 /v1/runs 诊断
- 修复 standalone 一键安装包在 About/仪表盘显示未知版本
- 同步 OpenClaw 2026.5.6 推荐版本和热更新 minAppVersion
- 补齐本地 JS/Rust 测试与发布前检查说明

验证：
- npm run build
- node --test tests/*.test.js
- node --check src/scripts JS 文件
- cargo fmt --all -- --check
- cargo check
- cargo clippy --all-targets -- -D warnings
- cargo test
 2026-05-08 04:39:36 +08:00
晴天
9ee99ead24 chore: release v0.14.0 
集中发版：

新功能（10）
- 心甜Claw 引擎入口（第 3 个引擎模式）
- Hermes 22 个 Provider 注册表 + 安装/仪表盘动态加载
- Hermes .env 高级编辑（拒绝触碰托管 Provider 密钥）
- Hermes 会话与用量分析增强
- Hermes Dashboard 自动拉起 + Windows POSIX-only 兼容模态
- Hermes Skills 工具集面板
- 官网 Hermes Agent 黑金特色区 + 图文指南
- Boot Manifest 启动页（双语 + 错峰动画）
- 官网 Markdown 阅读器图片 lightbox
- Hermes Memory 概览卡

改进（9）
- Hermes 仪表盘/扩展页全面本地化
- 记忆编辑大尺寸模态
- 日志下载 Web/桌面分流
- 侧边栏导航补全
- 模型备选管理 UI（PR #232）
- 模型加载错误 UX 重做（错误卡 + 详情 + 重试）
- .page 布局 clamp + .page-narrow
- Memory 单列断点提早到 1100px
- Web 模式跳过前端热更新检查

修复（12）
- Gateway 启动 platforms.api_server.enabled 自修复（含 7 unit test）
- Memory 页 overview 卡穿模（旧 flex 列约束 → 自然块流）
- Skills 页 hero/toolsets 被压缩（flex-shrink:0）
- Web 模式 Skills ReferenceError（补 _readHermesDisabledSkills）
- 日志/记忆下载行为分流
- src/pages/models.js 5 处 typo
- 删除 56 行 .hm-memory-* 死代码 + line-clamp 标准属性
- Dependabot rustls-webpki / postcss / rand
 2026-04-25 23:47:22 +08:00
晴天
8a314ff64e Merge PR #232 fallback model UI optimization 2026-04-25 11:49:35 +08:00
晴天
3ed59fcb2b feat(hermes): align dashboard APIs and add xintian engine 2026-04-25 10:31:32 +08:00
晴天
11cd6218dc feat(diagnose): detect and inform about @homebridge/ciao cmd popup bug (#250) 
* feat(diagnose): detect and inform about @homebridge/ciao cmd popup bug

On Windows, OpenClaw's transitive dependency @homebridge/ciao (<=1.3.6)
calls child_process.exec('arp -a ...') every 15-30 seconds without
passing windowsHide:true, causing a cmd.exe popup to flash.

This is an upstream library bug:
- Issue: homebridge/ciao#64
- PR:    homebridge/ciao#65 (open, not merged)

ClawPanel deliberately chooses 'detect and inform' rather than silently
patching the user's node_modules. We respect the user's control over
their own machine.

Changes:
- src-tauri/src/commands/diagnose.rs: new check_ciao_windowshide_bug
  command; scans openclaw's @homebridge/ciao/lib/NetworkManager.js and
  reports whether the buggy exec pattern is present
- src-tauri/src/lib.rs: register the new command
- scripts/dev-api.js: Web-mode stub (returns affected:false since the
  bug does not manifest off-Windows)
- src/lib/tauri-api.js: add api.checkCiaoWindowsHideBug
- src/lib/ciao-bug-warning.js: new module with toast + modal flow,
  version-scoped dismiss (localStorage)
- src/locales/modules/ciaoBug.js: translations in 5 primary languages
- src/locales/index.js: register the ciaoBug module
- src/main.js: call checker 3s after splash hides

Non-Windows users see nothing; Windows users see a single warning toast
(version-dismissible) linking to three fix paths: wait for upstream,
apply patch-package, or edit NetworkManager.js manually.

* fix(diagnose): gate helper with cfg(windows), drop unneeded return

CI failures on Linux + macOS:
- openclaw_module_root was dead code when target_os != windows
  since the only caller is the #[cfg(target_os = "windows")] block
  inside check_ciao_windowshide_bug
- Explicit `return CiaoCheckResult {...};` in the non-Windows branch
  triggered clippy::needless_return

Fix:
- Add #[cfg(target_os = "windows")] to openclaw_module_root so it
  is not compiled on other platforms
- Convert the non-Windows early exit to a tail expression
 2026-04-24 19:36:20 +08:00
晴天
5235853373 fix(gateway): debounce restart with single-flight queue (#248) 
Root cause for #243 / #244 / #240: model edits trigger
api.restartGateway() with only 300ms debounce. Fast consecutive
edits stack up restart calls, creating zombie Gateway processes,
failed restarts, and CPU fan spikes.

Layer A (frontend):
- New src/lib/gateway-restart-queue.js: 3s debounce + single-flight
  lock + reschedule on in-flight request
- Refactor src/pages/models.js doAutoSave: write config immediately,
  schedule restart via queue with 'Apply now' toast button
- Subscribe to queue state for unified success/failure toast
- Add i18n: models.configQueued, models.applyNow

Layer B (backend):
- src-tauri/src/commands/config.rs: wrap restart_gateway /
  reload_gateway with tokio::sync::Mutex + 2s cooldown
- Cargo.toml: add tokio 'sync' feature
- scripts/dev-api.js: same guard for Web mode (inflight promise
  reuse + 2s cooldown)

Effects:
- 10 rapid edits within 3s -> 1 restart (was 10+ with races)
- Backend serializes concurrent restart calls, no zombie spawns
- User sees single 'Apply now' toast instead of restart storm

Refs #243 #244 #240
 2026-04-24 19:35:39 +08:00
friendfish
f61cb65b4a refactor(models): address PR #232 review comments 
- i18n: Extract hardcoded Chinese strings to translation keys
- fix(url): Restore full-width punctuation in URL regex
- chore: Remove linux-schema.json (build artifact)
- chore: Add linux-schema.json to .gitignore
- refactor: Unify save strategy to use autoSave consistently
- style: Add trailing newline to en.json

Closes review items 1-6 from PR #232
 2026-04-21 01:00:19 +08:00
晴天
1ef9ca8ede fix(models): 获取模型列表 404 改为友好提示 + 助手侧走后端绕 CORS 
场景：部分服务商（如某些厂商的 Anthropic 兼容接口）不提供 /models 列表接口，
之前会直接显示 HTTP 404 Not Found / Failed to fetch 等技术错误，用户体验差。

- Rust list_remote_models：识别 404/405/501 作为"不支持自动获取"场景，
  返回带 [NOT_SUPPORTED] 前缀的友好错误，而非裸 HTTP 状态码
- 模型配置页「获取列表」：识别 [NOT_SUPPORTED] 后弹出引导对话框，
  点击「模型」按钮直接进入手动添加流程
- 助手设置页「获取列表」：改为走 Rust 后端 api.listRemoteModels，
  原先直接用前端 fetch 会被 WebView CORS 拦截（provider 不返回 CORS 头），
  改走后端既绕开 CORS 又能获得一致的友好提示
- Web 模式 dev-api.js 同步 404 识别逻辑，保证桌面 / Web 行为一致
- 补齐 models.fetchNotSupported / assistant.fetchNotSupported 多语言文案
 2026-04-20 16:01:24 +08:00
晴天
f69360744f fix(assistant): 修复测试 Response Body 为 (empty) + 优化结果展示 
## 用户反馈

截图显示测试结果详情里 "Response Body: (empty)"，但对话实际可用。
用户："有一个比较严重的bug...具体返回参数看不到...我感觉我们的功能不完整"

## 根因分析

1. **Accept-Encoding 未限制**：reqwest 只启用了 gzip feature（未启用 brotli），
   但 provider 经 CDN/反代可能返回 Content-Encoding: br，导致 resp.text() 解码失败。
2. **错误被静默吞**：`resp.text().await.unwrap_or_default()` 在解码失败时返回 ""，
   前端展示为 (empty) 但没有任何错误提示，用户无法诊断。
3. **展示设计：reply 被截断 + 藏在折叠面板**：成功时模型回复只显示前 80 字符的
   预览，完整内容要展开 "查看完整请求/响应参数" 才能看到（还被 JSON 混在一起）。

## 修复

### Rust test_model_verbose

三个分支（OpenAI / Anthropic / Gemini）都显式加 `Accept-Encoding: identity`
头，禁止响应压缩。测试请求的响应体很小（几百字节），不压缩的性能损失可忽略。

`resp.text().await` 失败时不再 unwrap_or_default 静默吞，而是返回带 error 的
JSON：`"读取响应体失败: {e} (可能是压缩编码未支持或非 UTF-8 响应)"`

### dev-api.js test_model_verbose（Web 模式）

三个分支的 headers 都加 `'Accept-Encoding': 'identity'`，和 Rust 行为一致。

### 前端 buildTestResult 重写

- **顶部显眼展示模型回复**（边框高亮 + 完整内容 + max-height:180px 加 scroll，
  不再截断为 80 字预览）：
  ```
  ✓ 连接成功 (300ms, Chat Completions)

  ╔═════════════════════════════╗
  ║ MODEL REPLY                 ║   ← 完整回复全文
  ║ 你好！我是 QC-A04...         ║
  ╚═════════════════════════════╝
  ```
- **空 respBody + 非空 reply 时给明确诊断**："响应主体未能读取（可能是压缩
  编码异常），但已从响应流中提取到回复内容"
- **固定 prompt 脚注**：`📌 本次测试使用预设 prompt "你好，请用一句话回复"
  + max_tokens=200` —— 让用户明白这是固定诊断请求，不是真实对话。
- **详情面板的空 body 展示优化**：不再显示 "(empty)" 字面量（可能被误解为
  服务器真的返回了空字符串），改为带颜色和 italic 的 "(响应体为空)" 提示。

### i18n 新增 5 个翻译键

- testModelReply：Model Reply
- testFixedPrompt：本次测试使用预设 prompt...
- testRespBodyEmpty：响应主体未能读取...但已从流中提取回复
- testShowDetails：查看完整请求/响应参数（原来硬编码中文）
- testRespBodyEmptyDetail：(响应体为空) [原来是硬编码 "(empty)"]

均覆盖 zh-CN / en / zh-TW / ja / ko / vi。

## 验证

- npm run build 通过（assistant chunk gzip 49.43 KB）
- cargo check 通过
- 下一步：用户实测后确认 Response Body 正常显示再发 v0.13.4

## 相关

- Roadmap v0.14.0：把测试功能升级成迷你 Playground（自定义 prompt / 多轮
  对话 / 流式显示 / max_tokens 滑块）
 2026-04-20 14:12:40 +08:00
晴天
b00c457c2b refactor(assistant): 备用模型 UI 重设计 - 厂商预设快捷添加 + 极简列表 
## 用户反馈

"晴辰助手的备用模型配置，很复杂，很麻烦" —— 旧 UI 每个备用要填
6 个字段（label / baseUrl / apiKey / model / apiType / enabled），
每张卡 3 行 6 输入框 ~200px 高，添加流程比配主模型还复杂。

## 重设计原则

备用模型本质是"主模型挂了用啥兜底"，应该是**选一个**而不是**重新配一个**。
复用 PROVIDER_PRESETS 里已有的 16 个厂商预设，一键预填 baseUrl / apiType。

## 新 UI 结构

```
┌─ 备用模型 (已启用 2 个) ────────────────────── [▼] ─┐
│ 主模型失败时按顺序切换到备用（401/403 除外）         │
│                                                      │
│ 📌 主模型（当前）  gpt-4o-mini     gpt.qt.cool      │  ← 只读
│ ⋮⋮ #2 [晴辰云] claude-haiku · api.anthropic   编辑 × │  ← 紧凑一行
│ ⋮⋮ #3 qwen3-30b · localhost:8000               编辑 × │
│                                                      │
│ 选择服务商快速添加：                                 │
│ [★晴辰云][OpenAI][Anthropic][DeepSeek][Google][Ollama]│
│ [📋 从主模型复制] [+ 自定义/自建] [更多服务商…]      │
└──────────────────────────────────────────────────────┘
```

## 关键变化

| 维度              | 旧                           | 新                                    |
|-------------------|------------------------------|---------------------------------------|
| 每行高度          | ~200px 卡片                  | ~36px 紧凑，点编辑才展开              |
| 添加方式          | 空白卡 6 字段填              | 点厂商 → 只填 apiKey + 选 model       |
| label 字段        | 用户手填                     | 去掉，自动用 model 显示               |
| enabled 开关      | 显式               | 去掉（删除即停用）+ 迁移旧禁用条目    |
| 主模型可见        | 无                           | 列表顶部显示完整调用链 (📌 主模型行) |
| 排序              | 隐式按数组顺序               | 显式 HTML5 drag-drop 拖拽手柄        |
| baseUrl/apiType   | 始终暴露                     | 折叠到"高级选项"（选 preset 后不用碰）|
| 快捷"从主模型复制"| 无                           | 有（解决"备用和主只想换个模型"场景）  |

## 实现细节

- 复用 `src/lib/model-presets.js` 的 `PROVIDER_PRESETS` 16 个厂商
- 主按钮区展示 6 个最常用（qtcool / openai / anthropic / deepseek
  / google / ollama），其余点"更多服务商…"展开
- 点厂商 → push draft 对象（含临时字段 `_editing`/`_brandLabel`），
  默认展开编辑态，autofocus 到 apiKey
- 保存时 .map 只挑 5 个字段（自动 strip 临时字段 + 不再写 enabled）
- 迁移：保存时过滤 `enabled === false` 的老条目，用户下次看到的
  都是启用状态（避免 UI 不暴露 enabled 导致的"隐形禁用"困惑）
- 主模型只读行实时跟随表单 `#ast-baseurl` / `#ast-model` 变化
- 每行折叠态的 model / hostname 在编辑态输入时实时更新（不重渲染
  避免输入框失焦）
- HTML5 drag-drop 拖拽排序（dragstart/dragover/drop），无第三方库

## i18n

新增 10 个翻译 key（至少覆盖 zh-CN / en / zh-TW / ja / ko / vi）：
- fallbackPrimaryRow / fallbackPickProviderHint
- fallbackAddCopyPrimary / fallbackAddCustom / fallbackMoreProviders
- fallbackEditAdvanced / fallbackHideAdvanced / fallbackShowAdvanced
- fallbackUnnamedModel / fallbackPickProviderTitle

## 验证

- npm run build 通过
- assistant chunk 156.24KB → 162.02KB（gzip +1.5KB），合理
- 向后兼容：已存的 fallbackModels 数据（含 label/enabled 字段）
  可正常读取和显示，保存时会"隐式迁移"（去掉 enabled 字段，禁用
  条目被清理）

## 相关

- #Compat-3 系列（备用模型 failover）
- 用户反馈："很复杂，很麻烦，整体重新设计下！"
 2026-04-20 13:31:16 +08:00
friendfish
74793d81a4 chore: complete en translations for fallback-ui-optimization 2026-04-20 09:25:48 +08:00
晴天
dfb81066b4 feat(assistant): 备用模型组 failover + 测试按钮走 Rust 后端（修 status 0） 
解决用户反馈的两个问题：晴辰助手设置里"测试"按钮在某些 provider
（如 gpt.qt.cool）上显示 Response Status: 0、Body 空，以及只能配
一个模型、挂了就没法用。

## 1. 测试按钮 status 0 根因 & 修复

**根因**：Tauri 桌面端以前走 webview 的 `fetch()` 直打外部 API，
受 Chromium 网络栈限制 —— 某些 provider 的 HTTP/2 分块编码、TLS
握手、CORS 预检、或特殊响应头会被静默拒绝并抛 TypeError: Failed
to fetch，前端 catch 后把 `respStatus` 写死 0、`respBody` 空。这
不是 provider 的问题，也不是 key 的问题，是 Chromium net stack 的
兼容性问题。

**修复**：新增 Rust 命令 `test_model_verbose`（基于已有的 reqwest
HTTP 客户端），返回结构化 JSON
  `{success, status, reqUrl, reqBody, respBody, reply, error,
   elapsedMs, usedApi}`。

  前端测试按钮无论 Tauri/Web 模式，一律调 `api.testModelVerbose()`：
  - Tauri → `invoke('test_model_verbose')` → 走原生 reqwest
  - Web → `fetch('/__api/test_model_verbose')` → 走 dev-api.js 服务端
    fetch

  这样绕过了 webview net stack 所有兼容性陷阱，拿到的永远是真实
  HTTP status（含 401/429/5xx）和原始 body，debug 面板展示完整信息。

  相比旧的 `test_model` 命令，`test_model_verbose` 不会因 400/422/429
  就吞错误返回 "连接正常"，而是如实回传，便于用户排查。

## 2. 备用模型组 failover（参考 OpenClaw）

**新增配置**：`_config.fallbackModels: Array<{label, baseUrl, apiKey,
model, apiType, enabled}>`，存在 localStorage 里。

**callAI 改造**：
- 旧的 `callAI` 改名为 `_callAIOnce`，保持不变
- 新增 `callAIWithSlot(slot, messages, onChunk)`：临时把 slot 注入
  到 `_config`，调 `_callAIOnce`，finally 恢复（单线程安全，因为
  `_isStreaming` 防并发）
- 新的 `callAI`：`buildActiveSlots()` 收集主模型 + 启用且配置完整
  的 fallback，按序尝试
  - 成功 → return
  - `AbortError`（用户中止）→ 直抛，不 failover
  - 鉴权错误 401/403/`unauthorized`/`invalid api key` → 直抛，不
    failover（切也白切）
  - 其他可重试错误（网络/超时/5xx/429/400 请求错/模型不存在）→ 在
    聊天里插入 `⚠ 模型「X」失败，切换到备用「Y」` 引用块，继续下
    一个 slot
  - 全部 slot 都失败 → 抛最后一个错误，触发既有 retry bar + circuit
    breaker 流程

**UI**：设置面板 API 标签页，在晴辰云 promo 卡片下方新增一个默认
折叠的 `<details>` 区块"备用模型组"：
- 顶部 summary 显示启用数量 + 折叠箭头
- 每张卡片：label / baseUrl / apiType / apiKey / model（紧凑 2 列
  栅格）+ enabled 开关 + 删除按钮
- 顶部 "添加备用模型" 按钮：默认继承主模型的 apiType，减少配置项
- 编辑态用 fallbackDrafts（深拷贝），保存按钮才过滤空卡片写回
  `_config.fallbackModels`
- 单个 input 变化时只同步 drafts + 更新计数，不重渲染列表（保持
  输入框焦点）

**文件改动**：
- `src-tauri/src/commands/config.rs`：+175 行 `test_model_verbose`
- `src-tauri/src/lib.rs`：注册新命令
- `src/lib/tauri-api.js`：+1 行 `testModelVerbose` 封装
- `scripts/dev-api.js`：+75 行 Web 模式 test_model_verbose handler
- `src/pages/assistant.js`：
  - `loadConfig`: 新增 `fallbackModels = []` 默认值
  - `callAI` 重构为 failover loop（+80 行）
  - 测试按钮：移除 90 行的 webview fetch 双分支，统一调 verbose
    API（净减 ~60 行）
  - `showSettings`: 新增备用模型 UI + 事件绑定（+85 行）
  - 保存按钮：收集 fallbackDrafts 写回 _config
- `src/locales/modules/assistant.js`：11 语言翻译（slotPrimary /
  failoverNotice / fallbackModelsTitle / fallbackModelsDesc /
  fallbackEnabledSuffix / fallbackEmpty / fallbackAdd /
  fallbackRemove / fallbackEnabled / placeholders）

## 验证

- `npm run build` 通过（assistant chunk 149.85 → 153.98 kB）
- `cargo fmt --check` 通过
- `cargo clippy --all-targets -- -D warnings` 通过
- 向后兼容：旧用户的 `localStorage` 无 `fallbackModels` 字段，
  loadConfig 会初始化空数组，既有行为不变

Refs: 模型兼容性优化 + 多模型 failover 需求
 2026-04-20 03:43:43 +08:00
晴天
58f5525445 fix(assistant): 连续错误自动熔断，避免无限重试循环 (#226) 
在路径拦截 + sanitize 的基础上再加一道保险：用户粘贴的不只是
markdown 本地图片、而是其他 API 不接受的内容时（如意外内容格式、
鉴权失败、quota 耗尽），单纯清洗无法解决，用户反复点"重试"会陷
入同样的错误循环。

熔断机制：
- 2 分钟滑动窗口内，同一错误指纹累计 ≥3 次触发熔断
- 错误指纹归一化：去掉数字（时间戳/请求 ID）、URL、多余空白，
  只对比核心语义
- 熔断状态下重试按钮禁用 + 警告色样式，hint 文案改为"请先检查
  API 配置或网络"，点击后 toast 提示而非触发重试
- 自动恢复：修改配置（saveConfig）或新建会话（createSession）时
  调用 resetCircuit() 清空失败历史

UI 共用：抽出 createRetryBar(session, circuitOpen) 供 sendMessageDirect
和 retryAIResponse 两处复用，消除原本重复的 30 行错误处理代码。
新增 .ast-retry-bar-circuit CSS 变体（warning 色 + 禁用态）。

翻译键（11 语言）：
- retryCircuitHint — 熔断状态下的重试栏 hint
- retryCircuitBlocked — 点击已禁用重试按钮时的 toast

Refs: #226
 2026-04-20 03:25:40 +08:00
晴天
3a4566d26a fix(assistant): 拦截本地文件路径粘贴/拖拽，清洗消息中的本地路径引用 (#226) 
用户将 C:\...\image.png 等本地路径粘贴到晴辰助手输入框，消息发送到
OpenAI 兼容 API 时触发 "Only base64, http or https URLs are supported"
错误；由于历史上下文包含坏消息，后续对话会继续报错形成循环。

三处修复：
1. paste 事件：如果剪贴板是纯文本且为本地路径（Windows/Unix/file://），
   阻止默认粘贴并 toast 提示用户
2. drop 事件：若拖入的是路径文本（无 files），同样拦截并提示
3. buildMessageContent：调用 sanitizeUserTextForApi，把
   ![alt](C:\...) 这类 markdown 图片替换为占位文本 "[本地文件（已忽略）]"，
   让已经输入路径的老会话也能自愈，不再循环报错

路径识别支持：
- Windows 绝对路径（C:\... / D:/...）
- macOS/Linux 常见路径前缀（/Users /home /mnt /media /opt /tmp /var /root）
- file:// URL

翻译覆盖 11 种语言（zh-CN/zh-TW/en/ja/ko/vi/es/pt/ru/fr/de）。

Refs: #226
 2026-04-20 03:07:24 +08:00
晴天
97e2fb507b fix(sidebar): 增强引擎切换器视觉发现性 (#228, #235) 
用户反馈"翻遍界面"找不到引擎切换入口，原切换器样式与 sidebar 其他
元素区分度低，容易被当作静态装饰忽略。

改进：
- 切换器上方新增 "ENGINE" section 标签，明确告诉用户这是引擎选择
- 按钮背景改为 accent 色调混合，提示可交互
- 图标使用 accent 色，尺寸从 14px 增大到 16px
- chevron 透明度 0.4 → 0.75，尺寸 12px → 14px
- 打开下拉时 chevron 旋转 180°（aria-expanded 驱动）
- 按钮加 title tooltip 和 aria-haspopup / aria-expanded（可访问性）
- 字体从 xs 增到 sm，字体权重 500
- :active 时轻微下沉，给出点击反馈

翻译覆盖 11 种语言。折叠侧边栏时仍然隐藏切换器（保持原行为）。
 2026-04-20 03:07:10 +08:00
friendfish
540cd405ab feat: optimize model management UI with waterfall fallback editor 2026-04-18 13:35:26 +08:00
晴天
36eaa64bf4 chore(release): v0.13.3 
- 修复 #212 AI 消息气泡空白
- 修复 #215 HTTPS 下 WebSocket Mixed Content
- 修复 #219 多实例版本检测错误
- 修复引擎切换后仪表盘无限加载
- 修复热更新假更新循环（macOS/Linux）
- CI release 构建前自动同步版本号
 2026-04-16 13:55:26 +08:00
晴天
55e8365cab chore: release v0.13.2 2026-04-13 15:10:20 +08:00
晴天
c02cb8e659 feat(setup): add local/custom install mode for Hermes Agent 
安装步骤新增"本地"和"自定义"两种模式切换：
- 本地模式：原有一键安装流程（uv tool install）
- 自定义模式：输入已有 Hermes Gateway URL，测试连接后保存并跳到配置步骤
  适用于已在其他机器安装或手动安装的用户
- URL 格式校验 + 连接失败错误提示
- 新增 10 个 i18n 键
 2026-04-13 11:01:47 +08:00
晴天
b676db6a46 feat(setup): simplify Hermes install — remove extras, add inline logs 
1. 移除可选组件（extras）选择 UI，只安装核心包，提高安装成功率
2. 安装过程中内嵌显示实时日志 + 进度条 + 百分比
3. 安装前显示安装说明（uv 管理器、核心包、扩展后装提示）
4. 进度条样式优化：渐变色、更粗、更圆润
5. 日志面板优化：等宽字体、空状态提示、min-height
6. 新增 4 个 i18n 键（installDescSimple/installInfoUv/installInfoCore/installInfoExtrasLater）
 2026-04-13 10:43:58 +08:00
晴天
3fc73b485b feat(about): Hermes config/upgrade/uninstall use modal dialogs with logs 
配置按钮: 弹出模态框显示当前 Hermes 配置（Provider/URL/Key/Model），
  带"前往配置向导"按钮跳转 setup 页面
升级按钮: 确认模态框 → 进度条+实时日志（监听 hermes-install-log 事件）
卸载按钮: 两步确认（是否卸载 → 是否清除配置） → 进度条+日志
所有操作完成后自动刷新 Hermes 卡片数据
新增 6 个 i18n 键
 2026-04-13 10:35:37 +08:00
晴天
d8d671a221 fix(setup): make Hermes wizard phases clickable, stop auto-redirect 
1. 已完成的步骤指示器可点击返回（检测/安装/配置/启动）
2. 已安装+Gateway 运行时不再自动跳转仪表盘，停在"完成"步骤
3. 用户从 About 页点"配置"进入向导后可自由浏览每个步骤
 2026-04-13 10:29:24 +08:00
晴天
6971bd32e8 feat(about): add Hermes Agent upgrade/uninstall/config buttons 
Hermes 卡片已安装状态下新增三个操作按钮：
- 配置: 跳转到 Hermes 设置页
- 升级: 调用 updateHermes() 重新安装最新版
- 卸载: 调用 uninstallHermes()，支持选择是否清除配置
新增 12 个 i18n 键 (zh/en/繁/ja/ko)
 2026-04-13 10:24:03 +08:00
晴天
c88a652bc5 chore: v0.13.1 release prep — fix fake update, cleanup hot update, version bump 
1. main.js: import package.json → __APP_VERSION__ (统一版本来源)
2. dev-api.js: check_panel_update 实现 GitHub/Gitee API 查询
   (与 Rust 端逻辑一致，Web 模式可正常检测新版本)
3. dev-api.js: 移除 check_hermes 中未使用的 enhanced 变量
4. i18n: 清理 14 个废弃的热更新相关翻译键
5. 版本号升级: 0.13.0 → 0.13.1
   (package.json, Cargo.toml, tauri.conf.json)
 2026-04-13 10:20:36 +08:00
晴天
2b6f80091a fix: fake update detection, Hermes web mode commands, cleanup hot update 
1. 假更新检测: checkNewVersion 对比 Tauri 二进制版本与前端版本，
   若前端版本 > 二进制版本（热更新导致），提示用户下载完整安装包
2. 版本统一: sidebar 和 about 页面均使用 __APP_VERSION__
3. 更新机制: checkHotUpdate → checkNewVersion，改用 GitHub Releases API，
   移除 check_frontend_update / download / rollback / get_update_status 死代码
4. Hermes Web 模式: dev-api.js 实现全部 15 个 Hermes 命令处理器
   (check_python, check_hermes, install_hermes, configure_hermes,
    hermes_gateway_action, hermes_health_check, hermes_api_proxy,
    hermes_agent_run, hermes_read_config, hermes_fetch_models,
    hermes_update_model, hermes_detect_environments, hermes_set_gateway_url,
    update_hermes, uninstall_hermes)
5. i18n: 新增 versionMismatch, hotUpdateDeprecated, downloadFullInstaller
 2026-04-13 09:50:36 +08:00
晴天
5575566806 feat: Hermes Agent 多引擎架构核心代码 
- 新增 src/engines/hermes/ 完整引擎（仪表盘/服务管理/模型配置/Agent管理/对话）
- 新增 src/lib/engine-manager.js 引擎管理器（切换/检测/状态）
- 新增 src-tauri/src/commands/hermes.rs 后端命令（Gateway控制/配置读写/Agent Run SSE）
- sidebar 引擎切换器 UI
- i18n 新增 engine 模块（中/英/繁体）
- 多安装清理工具（gateway-ownership.js）
- 晴辰助手文件访问开关
- Hermes 对话工具调用可视化、SSE 流式输出
- Cargo.lock / dev-api.js 同步更新
 2026-04-13 04:09:09 +08:00
晴天
271dc93b08 feat: OpenClaw 4.9 全面适配 (v0.12.0) 
- 推荐内核统一升级至 2026.4.9 / 2026.4.9-zh.2
- standalone 安装兼容 edition 格式 latest.json + openclaw-zh- 文件名前缀
- standalone 三级降级: R2 CDN → GitHub Releases → npm
- pre_install_cleanup 所有命令加 10s 超时保护（修复安装卡死）
- npm uninstall 加 30s 超时保护
- wmic 全部迁移到 PowerShell（兼容 Windows 11）
- standalone 下载增加文字进度显示
 2026-04-11 04:42:36 +08:00
晴天
70d768be17 feat: new pages + dashboard enhancements + backend improvements 
New pages:
- Plugin Hub: grid cards, search, install/toggle/enable plugins
- Route Map: SVG visualization of channels→agents bindings with legends
- Diagnose: gateway connectivity diagnosis with step-by-step checks

Dashboard enhancements:
- WebSocket status indicator (connected/handshaking/reconnecting/disconnected)
- Connected channels overview with platform icons
- Colored log level badges (ERROR/WARN/INFO/DEBUG) with timestamps
- Channels data loading in dashboard secondary fetch

Splash screen:
- Multi-stage boot detection (JS not loaded vs boot slow vs timeout)
- 15s: WebView2/resource load failure
- 20s: "initializing..." hint with elapsed counter
- 90s: true timeout error

Backend (Rust):
- diagnose.rs: gateway connectivity diagnosis command
- messaging.rs: plugin management commands
- service.rs: improvements
- lib.rs: register new commands

Frontend libs:
- feature-gates.js: feature flag system
- ws-client.js: reconnect state tracking
- tauri-api.js: new API bindings
- model-presets.js: provider fixes
- Remove gateway-guardian-policy.js (unused)

Dev API (scripts/dev-api.js):
- list_all_plugins, toggle_plugin, install_plugin handlers
- probe_gateway_port, diagnose_gateway_connection handlers

i18n: dashboard, sidebar, diagnose, extensions, routeMap locale modules
CSS: plugin-hub cards, route-map SVG styles
 2026-04-11 00:44:06 +08:00