GithubBackup/clawpanel
1
0
Fork 0
mirror of https://github.com/qingchencloud/clawpanel.git synced 2026-05-29 20:30:00 +08:00
Code Issues Packages Projects Releases Wiki Activity
546 Commits 16 Branches 69 Tags
d245d2e320a2fd8130054de7e06fa9cf1cce604d
Commit Graph

71 Commits

Author SHA1 Message Date
晴天
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
晴天
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
晴天
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
晴天
eccf91ed1e feat(hermes): add channel configuration editor 2026-05-23 01:51:08 +08:00
晴天
e1eda2db55 feat(models): import external client configs 
Add a model client import flow that scans local Codex, Claude Code, Gemini CLI, and common environment variable configurations without reading or copying OAuth tokens.

The new backend command returns safe import candidates with provider metadata, model IDs, and API key environment-variable references. Tauri and Web/dev-api both implement the scanner, and Web mode keeps the scan local even when a remote instance is active.

The Models page now offers an import wizard that lets users select importable candidates, adds providers without overwriting existing keys, preserves secrets as ${ENV_VAR} references, and leaves OAuth-only Codex entries as guidance rather than direct OpenClaw imports.

## Verification
- node --check src/pages/models.js
- node --check src/lib/tauri-api.js
- node --check src/locales/modules/models.js
- node --check scripts/dev-api.js
- cargo fmt --check
- cargo check
- npm run build
 2026-05-15 23:18:50 +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
晴天
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
晴天
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
晴天
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
晴天
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
晴天
c4bf769eab feat(hermes): P1-4 hermes_read_config_full 全字段解析 - 解锁 14+ Gateway 高价值配置 
之前 hermes_read_config 只读 5 字段（model/base_url/provider/api_key/config_exists），
为「快速面板」服务。Hermes Gateway 实际有 14+ 个顶层配置项，ClawPanel 完全没读到。

本次新增 hermes_read_config_full 命令，作为高级配置编辑器的数据源。

## 后端实现
- 加 serde_yaml 0.9 依赖
- 新命令 hermes_read_config_full：
  · 用 serde_yaml 完整解析 config.yaml
  · 转 JSON 返回 { exists, raw, config, highlights }
  · highlights 字段单独抽出 14 个高价值顶层字段：
    streaming / stt_enabled / quick_commands / reset_triggers /
    default_reset_policy / unauthorized_dm_behavior /
    session_store_max_age_days / always_log_local /
    group_sessions_per_user / thread_sessions_per_user /
    platforms / dashboard / memory / skills
  · 已注册到 lib.rs

## 前端
- tauri-api.js 加 hermesReadConfigFull wrapper

## Web 模式
- dev-api.js 加 hermes_read_config_full handler（Web 模式不强制 yaml 解析，
  返回 raw + null highlights，前端按需 fallback）

## 后续
- 实际「高级配置编辑器」UI 后续单独开 — 本次仅打通数据通道
- 与轻量版 hermes_read_config 互补共存，model 配置页继续用轻量版
 2026-05-14 03:56:17 +08:00
晴天
1d6843c4fb feat(hermes): expose '/v1/capabilities' as the 'hermes_capabilities' Tauri command 
Hermes 已在 v2026.5.x 暴露 GET /v1/capabilities 给外部 UI 用作机器可读的能力描述，让前端能动态适配可用 endpoint / feature 而无需用版本号硬匹配。ClawPanel 之前完全没利用这层抽象，本 commit 加一条 Tauri 命令 + Web handler + 前端 wrapper，为后续 chat/runs/approval 等动态降级（老版 Gateway 没有的能力优雅隐藏 UI）打底。
 2026-05-14 02:31:35 +08:00
晴天
c3d25aab62 chore: release v0.15.3 2026-05-13 16:53:47 +08:00
晴天
33e0487574 fix: 退出时直接调用 taskkill.exe，避免关机阶段 cmd.exe 初始化失败导致 0xc0000142 2026-05-13 16:00:07 +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
晴天
3ed59fcb2b feat(hermes): align dashboard APIs and add xintian engine 2026-04-25 10:31:32 +08:00
晴天
31936b4779 feat(hermes): add .env editor page for unmanaged env vars (Step 4) 
Users may need to configure custom environment variables for Hermes
(e.g. `TAVILY_API_KEY` for the tavily skill, `HTTP_PROXY`, SKILL_*
settings). Previously the only way to set these was to hand-edit
~/.hermes/.env, which risks clobbering the provider keys that
ClawPanel writes through configure_hermes.

This patch adds a dedicated editor UI backed by three new Tauri
commands that refuse to touch managed keys.

Backend (src-tauri/src/commands/hermes.rs):
- `hermes_env_read_unmanaged` — returns every KEY=VALUE pair whose key
  is NOT in `hermes_providers::all_managed_env_keys()` (so provider
  API keys, base URLs, `GATEWAY_ALLOW_ALL_USERS`, `API_SERVER_KEY`
  stay hidden). Preserves file order, dedups.
- `hermes_env_set(key, value)` — validates key against `^[A-Z0-9_]+$`,
  refuses managed keys, updates first occurrence or appends,
  preserves comments/blanks.
- `hermes_env_delete(key)` — refuses managed keys, removes first
  matching line, preserves other structure.

All three commands registered in `src-tauri/src/lib.rs`.

Frontend:
- New page `src/engines/hermes/pages/env-editor.js`:
  - Header with "back to dashboard" link and warning banner listing
    which keys are managed by ClawPanel.
  - Table with Key / Value / Actions columns.
  - Inline edit mode per row (save / cancel).
  - "Add variable" button for new entries.
  - Value column masks long secrets (`sk-a…xyz9`) so glances don't
    leak credentials.
  - Toast feedback on save / delete / validation errors.
  - Inline Chinese copy (TODO: wire up i18n when the locales module
    lands).
- Route registered at `/h/env` in `src/engines/hermes/index.js`.
- Dashboard "Model config" section now has a subtle link
  ".env 高级编辑 →" pointing to the new page.

API wiring:
- `src/lib/tauri-api.js`: added `hermesEnvReadUnmanaged`,
  `hermesEnvSet`, `hermesEnvDelete`.
- `scripts/dev-api.js`: mirrors the three commands in Web mode with
  a duplicated managed-key list (keep in sync with Rust's
  `hermes_providers::all_managed_env_keys` as new providers land).

Verified: cargo fmt / cargo clippy -D warnings / cargo test / npm run
build all green. Dashboard chunk unchanged (24.30 kB); new env-editor
chunk is ~7 kB gzip.
 2026-04-24 20:50:29 +08:00
晴天
17759fc1e6 feat(hermes): add 22-provider registry + rewrite core commands (Step 1) 
Introduce an authoritative Hermes provider registry in Rust, mirroring
upstream `hermes-agent` data (PROVIDER_REGISTRY + _PROVIDER_MODELS), and
refactor the four critical Hermes commands to be provider-aware.

Closes the G1/G2/G3 blockers identified in the v3 integration design.

New module `src-tauri/src/commands/hermes_providers.rs`:
- Static catalog of 22 providers: 17 api_key (incl. DeepSeek, Gemini,
  xAI, GLM/Z.AI, Kimi, MiniMax int'l + CN, Alibaba DashScope, Xiaomi,
  Copilot PAT, HuggingFace, OpenRouter, Vercel AI Gateway, OpenCode
  Zen/Go, Kilocode), 3 OAuth (Nous, OpenAI Codex, Qwen OAuth), 1
  external_process (Copilot ACP), and `custom` placeholder.
- Each entry carries id, display name, auth_type, base_url, env var
  priority list, transport, probe strategy, known models, aggregator
  flag, and CLI auth hint.
- Helpers: `get_provider`, `primary_api_key_env`, `primary_base_url_env`,
  `all_managed_env_keys`, `infer_provider_from_env_keys`,
  `find_provider_by_model`.
- New Tauri command `hermes_list_providers` (cached client-side).
- 5 unit tests covering registry integrity and lookup semantics.

Refactored `src-tauri/src/commands/hermes.rs`:
- `configure_hermes`: writes `model.provider` in config.yaml and routes
  API keys through the registry's `api_key_env_vars`. Skips key write
  for OAuth providers (Hermes CLI manages auth.json itself). Clears
  all managed keys on provider switch to avoid stale credentials.
- `hermes_read_config`: reads `model.provider`, then reverse-looks up
  the matching API key from the registry's env var priority list.
  Falls back to inferring provider from .env when config.yaml omits
  the provider field.
- `hermes_update_model`: accepts optional `provider` param; writes
  `model.provider` line into config.yaml (adds it when missing, updates
  in place when present, removes it for `custom`).
- `hermes_fetch_models`: accepts optional `provider` param; uses
  registry's probe strategy (`PROBE_NONE` returns static catalog for
  OAuth providers instead of hitting the API).

Registration:
- `src-tauri/src/commands/mod.rs`: declare `hermes_providers` module.
- `src-tauri/src/lib.rs`: import + register `hermes_list_providers`.

Verified: cargo fmt / cargo clippy -D warnings / cargo test all green
(5 new unit tests pass).
 2026-04-24 20:40:40 +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
晴天
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
晴天
55e8365cab chore: release v0.13.2 2026-04-13 15:10:20 +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
晴天
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
晴天
ad00ffef3d chore: release v0.11.5 
feat: SkillHub skill store (SDK-based, no CLI dependency)
- Rust SDK (skillhub.rs): HTTP search, index fetch, zip download+extract
- Node.js SDK (skillhub-sdk.js): mirrors Rust SDK for Web/Docker mode
- Skills page: new "Store" tab with full index browse + client-side filter
- Remove 6 old CLI-dependent commands, add 3 SDK commands
- Migrate assistant.js skill tools from ClawHub CLI to SkillHub SDK
- Fix index decode error ({total,skills} wrapper vs bare array)
- Fix skill name display (API field 'name' vs 'display_name')
- Clean up 13 dead CSS rules from old skills hero/tips UI
 2026-04-07 03:25:26 +08:00
晴天
9ff91f74d8 feat: IME-aware chat input, message copy button, Git path scanning 
- Fix IME composition issue: Enter during Chinese/Japanese/Korean input
  method composition no longer prematurely sends messages (assistant.js)
  Uses e.isComposing + keyCode 229 guard on keydown handler
- Add one-click copy button to chat message bubbles (both chat.js and
  assistant.js), with hover-reveal animation and checkmark feedback
- Add 'copy' icon to SVG icon library (Lucide style)
- Add CSS for msg-copy-btn in chat.css and assistant.css
- Implement scan_git_paths Rust command: scans common Git installation
  locations on Windows/macOS/Linux (Program Files, Scoop, Chocolatey,
  GitHub Desktop, VS Code, MSYS2, Homebrew, Xcode CLT, etc.)
- Register scan_git_paths in lib.rs, tauri-api.js, dev-api.js
- Add scan button + results UI in settings.js Git path section
- Add i18n keys: gitScan, gitScanning, gitScanEmpty, gitScanUse
 2026-04-06 00:14:18 +08:00
晴天
42aeb8b077 fix: Gateway status discrepancy — foreign detection, claim action, banner sync 
- Services page: foreign Gateway now shows warning dot (yellow) instead of green
- Add claim_gateway command (Rust + dev-api + frontend API) to adopt foreign Gateway
- Services page: add "Claim Gateway" button for foreign Gateway instances
- Top banner: distinguish foreign Gateway (warning + claim) vs stopped (info + start)
- app-state: expose isGatewayForeign(), pass foreign flag to onGatewayChange listeners
- Services page actions now immediately sync global Gateway state (no 15s poll wait)
- Relax owner matching: cli_path missing on either side no longer triggers foreign
- Add i18n keys: foreignGatewayBanner, claimGateway, claimSuccess, claimFailed, processing
 2026-04-05 23:12:16 +08:00
晴天
aad8043196 feat(config): add config calibration repair flow 2026-04-01 22:46:36 +08:00
晴天
b427a6b000 feat: improve gateway compatibility and complete i18n cleanup 2026-04-01 15:06:25 +08:00
晴天
631fe86800 feat: 开机自启功能（tauri-plugin-autostart） 
- Cargo.toml: 添加 tauri-plugin-autostart 依赖（桌面端）
- lib.rs: 初始化 autostart 插件（MacosLauncher::LaunchAgent）
- capabilities/default.json: 添加 autostart 权限
- settings.js: 面板设置新增开机自启开关（仅 Tauri 模式显示）
- package.json: 添加 @tauri-apps/plugin-autostart 前端依赖
 2026-03-26 05:10:02 +08:00
晴天
3687e26d5d feat: 飞书官方插件迁移 + 配对审批 + Gateway防卡死 + 微信升级修复 + 更新检测修复 
- 飞书渠道从 @openclaw/feishu 迁移到 @larksuite/openclaw-lark 官方插件
- 保存飞书配置时自动禁用旧 feishu 插件，防止新旧插件冲突
- 所有主要渠道(飞书/Telegram/Discord/Slack)启用配对审批UI
- gateway_command 增加20s超时，超时后force-kill+fresh start
- 全平台启动前端口占用检查，防止Guardian无限拉起
- Linux gateway_command 补齐 Duration 导入和 cleanup_zombie 实现
- Guardian自动守护在Tauri桌面端也启用，轮询间隔30s→15s
- 微信渠道：升级操作不再弹出扫码二维码，按钮文案区分安装/升级
- 版本更新检测：CI不再将minAppVersion写死为当前版本
- 部署脚本增强OpenClaw检测，支持已安装的官方版
- 日间/夜间模式圆形扩散切换动画(View Transitions API)
- API错误信息完整展示(429限流等)，URL自动转可点击链接
- 第三方API接入引导优化：移除内置密钥，引导式流程
- 修复全平台 Clippy 警告(strip_prefix/dead_code/unnecessary_unwrap等)
- Rust代码格式化修复(cargo fmt)
- toast组件支持HTML内容渲染
- Rust后端test_model返回详细错误信息
 2026-03-23 21:51:34 +08:00
晴天
6494cf6551 chore: release v0.9.7 2026-03-21 04:11:13 +08:00
晴天
48cffe1f42 feat: v0.9.2 — SkillHub双源技能管理、消息渠道多Agent绑定、模型配置优化、白屏安全网等 2026-03-16 04:26:30 +08:00
晴天
394813a96c feat: v0.9.1 — 面板设置页、网络代理、后台安装、模型服务商扩展、多项修复 
新功能:
- 新增独立面板设置页面（网络代理 + 代理测试 + 模型代理开关 + npm源）
- 网络代理支持：下载类操作走代理，自动绕过内网地址
- 安装/升级/卸载改为后台执行，不再阻塞界面
- 全局任务状态栏：关闭弹窗后顶部显示进度，可重新查看日志
- 安装/卸载完成后自动刷新界面状态
- 新增多个模型服务商快捷配置（硅基流动、火山引擎、阿里云百炼、智谱AI、MiniMax、NVIDIA NIM、胜算云）
- AI助手浮动按钮恢复，首次提示可拖动，实时聊天页隐藏

修复:
- 修复版本更新误判（本地版本高于远端不再误弹更新）
- 修复Windows下nvm/自定义Node路径CLI检测
- 修复npm EEXIST文件冲突（--force + 安装前自动清理）
- 修复汉化版-zh.x后缀版本比较错误
- 修复模型URL自动拼接/v1问题
- 修复切换版本后Gateway重装失败（PATH缓存刷新）
- 修复切换助手服务商时旧模型名残留

优化:
- macOS图标改用docs/logo.png统一生成
- 内置推荐版本号更新到OpenClaw 2026.3.13
- 错误诊断增强（EEXIST识别）
- 弹窗标题根据操作类型显示
- 新增版本维护文档
 2026-03-14 19:57:22 +08:00
晴天
205d349917 feat: v0.9.0 — Usage analytics, Communication config, 晴辰云 branding, multi-agent channels, 7 bug fixes 2026-03-14 07:09:50 +08:00
晴天
3e24ceaa4d v0.8.0: Ollama兼容、Git自动安装、Gitee镜像、会话重命名、消息渠道Agent绑定、仪表盘重设计、环境检测实时生效、#44修复 2026-03-12 02:17:47 +08:00
晴天
16999e66b7 style: cargo fmt (fix CI format check) 2026-03-11 03:03:47 +08:00
晴天
a2f8ed9d54 feat(channels): add messaging channels and built-in qq bot 2026-03-10 03:33:21 +08:00