diff --git a/CHANGELOG.md b/CHANGELOG.md index 54be957..69b7356 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,70 @@ ## [未发布] +## [0.17.0] - 2026-05-28 + +### 新功能 (Features) + +#### Hermes Agent 配置面板完整覆盖 + +以前 Hermes 的 `~/.hermes/config.yaml` 只有少数项能在面板里改，剩下都得手动编 YAML。这一版把 50+ 个配置项全部做成可视化表单，按主题聚合： + +- **会话与运行时** — Session Runtime / Streaming / Memory / Compression / Tool Loop Guardrails / Channel Display / Quick Commands / Worktree Session / Prompt Caching / Logging / Cron Output / Memory Flush 等表单 +- **模型管理** — Base Model / Model Aliases / Token Limits / Model Catalog / Auxiliary Model / Delegation Override / Provider Routing / Provider Timeout / OpenRouter Cache / Agent Quality +- **终端与沙箱** — Sandbox Image / SSH / Docker Env Forwarding / Docker Advanced / Cloud Runtime / Shell Environment / Env Passthrough / Execution Limits / Terminal Execution / Shell Hooks +- **看板（Kanban）** — Dispatch Config / Dispatcher / Concurrency / Worker Log / Profile Routing 五块运维参数全可视化 +- **安全 / 隐私 / 审批** — Approval Safety / Checkpoint Rollback / Agent Runtime Guard / Tirith Security / Privacy Redaction / Input-Output Safety / Human Delay / Unauthorized DM Policy / Global Toolset Disable / Skills Security +- **Display / Skin / TUI** — TUI / Analytics / Skin / Defaults / Output / Run / Reliability / Tool Prefix 一整套显示策略 +- **工具集 / 浏览器 / 语音** — Browser Advanced / Browser Camofox / Browser Tool / TTS Voice / STT / Web Tool Backend / X Search / LSP Diagnostic / Context Engine / Platform Toolsets / MCP Servers / Skills / Bundled Plugin Channels + +每个面板都走 `_config_read` + `_config_save` 命令对，保留原 YAML 注释与未托管字段，写入前自动备份。 + +#### Hermes 维护与升级控制 + +- **Update Backup** — 升级前自动备份 `~/.hermes/config.yaml`，并展示备份历史可一键回滚 +- **Session Store Maintenance** — 浏览会话存储统计、压缩与清理 +- **Curator Maintenance** — 调度 curator 维护任务 + +#### Hermes 消息渠道矩阵扩充 + +新接入或恢复 **14 个渠道** 的可视化配置： + +- iMessage、WhatsApp、Telegram（runtime options）、Discord（plugin runtime + guild 白名单 + app id）、Signal、Microsoft Teams +- LINE、Mattermost、Synology Chat、Google Chat、Zalo、DingTalk（钉钉） +- Tlon、IRC、Nostr、Twitch、Nextcloud Talk、ClickClack + +同时新增**统一渠道配置编辑器**、`channel_config_read/save` 命令对、Gateway runtime 状态、多账户保存、SecretRef 保护、跨渠道通用 diagnostics。 + +### 改进 (Improvements) + +- **Node.js 版本检测优先命中 nvm 管理版** — 修复用户装了 nvm 但 PATH 里还有系统 Node 时，被系统 Node 抢先识别的问题（[#295](https://github.com/qingchencloud/clawpanel/pull/295)） +- **agent models 与 merged openclaw.json 同步** — 写入 agent 配置后从合并后的配置读回 models，避免落盘与界面不一致（[#297](https://github.com/qingchencloud/clawpanel/pull/297)） +- **Dashboard 抑制过时加载** — 防止快速切换 Profile / 刷新时被取消的旧加载请求覆盖最新状态（[#301](https://github.com/qingchencloud/clawpanel/pull/301)） +- **Hermes Dashboard 触摸目标更大** — 移动端 / 触屏点击体验改进 +- **Hermes Chat 健康横幅稳定化** — 不再因瞬时网络抖动反复闪烁 +- **CI 触发条件扩展** — PR 从 `ready_for_review` 状态进入时也跑工作流 + +### 修复 (Fixes) + +- **关键：上游 hermes-agent 0.14.0 漏装兼容兜底** — 上游 wheel 漏装了 `hermes_cli/dashboard_auth/` 子包（6 个文件）和 `hermes_cli/web_dist/` SPA 资源，导致 `hermes dashboard` 启动直接崩，进而让 ClawPanel 的 Profile / 多 Gateway 看板 / OAuth / Channels / Sessions 详情等所有依赖 9119 的页面集体报「请求被目标计算机拒绝」。本版在 `install_hermes` / `update_hermes` / `hermes_dashboard_start` 三处注入幂等的 pass-through stub，loopback 模式下安全；若上游补回真实文件，stub 自动让位 +- **关键：Hermes 升级路径补齐 runtime extras** — `update_hermes` 与 `install_hermes` 现在统一附加 `--with croniter --with httpx --with openai --with aiohttp --with websockets`，避免升级后 Gateway 启动 platform 模块时报 `No module named ...` +- **关键：`hermes_venv_python` 感知 `uv tool install` 路径** — 早期只查 `HERMES_PYTHON` 与 `~/.hermes-venv`，但 ClawPanel 默认走 `uv tool install`，导致「可选依赖管理」「多 Gateway 看板」等页面对 99% 用户都误报「Hermes venv 未找到」。现在按优先级 `HERMES_PYTHON` → `~/.hermes-venv` → `/hermes-agent/{Scripts,bin}/python` fallback +- **群聊气泡显示 run_xxx 而非真实回复** — `hermes_agent_run` 返回的是 run_id 字符串而非结果对象，原代码把 run_id 当回复内容渲染。现在监听 `hermes-run-{started,delta,done,error,cancelled}` 事件，从 `payload.output` 取最终输出，按 run_id 过滤事件保证多 Profile 串行调度 race-safe +- **Hermes 原始配置保存校验** — 直接编辑 raw YAML 时校验 schema，避免写入非法配置导致 Gateway 启动失败 +- **Hermes MCP Sampling 配置校验** — 防止非法 sampling 字段写入 config.yaml +- **渠道配置稳健性** — 多账户保存 / SecretRef 凭据保护 / Discord guild allowlist 暴露 / Discord application id 保留 / 默认账户选择稳定化 / 凭据字段校验 / OpenClaw 渠道策略归一化 +- **Hermes 渠道密钥与运行时 env 对齐** — 避免面板存的 `${env:KEY}` 与 Gateway 进程实际读到的环境变量不一致 +- **Web 端 OpenClaw 路径冲突扫描兼容** — Web 模式下 PATH CLI 冲突扫描接口对齐桌面端 + +### 测试与验证 (Testing) + +- **回归** — `npm run build`、`cargo fmt --check`、`cargo check`、`cargo clippy --all-targets -- -D warnings` 全绿；Python 端在用户 uv-tool venv 实测 `from tools.lazy_deps import LAZY_DEPS` 返回 25 个 feature +- **关键路径手测** — 桌面端 Hermes 安装/升级、Gateway 启停、Profile / Channels / Dashboard / 可选依赖管理 / 群聊页面端到端通过 + +### 热更新兼容性 (Compatibility) + +本版本 `src-tauri/src/lib.rs` 注册了 40+ 对新 Tauri 命令（各 `hermes_*_config_read/save`、渠道 / 维护命令），因此 `docs/update/latest.json` 的 `minAppVersion` 提升到 **0.17.0**：低于此版本的桌面端不会通过热更新拉到新前端，避免命令缺失导致页面崩溃。 + ## [0.16.5] - 2026-05-22 ### 修复 (Fixes) diff --git a/docs/index.html b/docs/index.html index 9f1637a..17b93c4 100644 --- a/docs/index.html +++ b/docs/index.html @@ -34,7 +34,7 @@ "description": "支持 OpenClaw 和 Hermes Agent 双引擎的多 AI Agent 可视化管理面板，基于 Tauri v2 的跨平台桌面应用。内置晴辰助手支持工具调用，晴辰云 AI 接口一键接入。支持仪表盘监控、多模型配置、Hermes Agent 对话、消息渠道管理、内置 QQ 机器人、实时 AI 聊天、记忆管理、Agent 管理、网关配置、内网穿透等功能。支持 11 种语言。", "url": "https://claw.qt.cool/", "downloadUrl": "https://github.com/qingchencloud/clawpanel/releases/latest", - "softwareVersion": "0.16.5", + "softwareVersion": "0.17.0", "author": { "@type": "Organization", "name": "晴辰云 QingchenCloud", @@ -1225,7 +1225,7 @@
-
v0.16.5 最新版
+
v0.17.0 最新版

下载安装

选择你的操作系统，一键下载安装

@@ -1235,11 +1235,11 @@

macOS

支持 Apple Silicon 和 Intel 芯片

- + Apple Silicon (M1/M2/M3/M4) .dmg - + Intel 芯片 .dmg @@ -1257,15 +1257,15 @@

Windows

支持 Windows 10 及以上版本

- + 安装程序 .exe - + 完整包（含 WebView2） .exe - + MSI 安装包 .msi @@ -1276,11 +1276,11 @@

Linux

支持主流 Linux 发行版

- + 通用版 .AppImage - + Debian / Ubuntu .deb diff --git a/docs/update/latest.json b/docs/update/latest.json index 4de3ec0..0a95cf3 100644 --- a/docs/update/latest.json +++ b/docs/update/latest.json @@ -1,6 +1,6 @@ { "version": "0.16.5", - "minAppVersion": "0.15.3", + "minAppVersion": "0.17.0", "hash": "sha256:1913611f9f84e7f8c28dfc6d10c0de5078ce99e6d894c4c8bb9210676d69c5e2", "url": "https://github.com/qingchencloud/clawpanel/releases/download/v0.16.5/web-0.16.5.zip", "size": 2599816, diff --git a/package-lock.json b/package-lock.json index 70a4fb8..d3c0c9d 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "clawpanel", - "version": "0.16.5", + "version": "0.17.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "clawpanel", - "version": "0.16.5", + "version": "0.17.0", "license": "AGPL-3.0", "dependencies": { "@tauri-apps/api": "^2.5.0", diff --git a/package.json b/package.json index 980a9cf..9385d7b 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "clawpanel", - "version": "0.16.5", + "version": "0.17.0", "private": true, "description": "ClawPanel - OpenClaw 可视化管理面板，基于 Tauri v2 的跨平台桌面应用", "type": "module", diff --git a/src-tauri/Cargo.lock b/src-tauri/Cargo.lock index 7754bc2..cfea890 100644 --- a/src-tauri/Cargo.lock +++ b/src-tauri/Cargo.lock @@ -366,7 +366,7 @@ dependencies = [ [[package]] name = "clawpanel" -version = "0.16.5" +version = "0.17.0" dependencies = [ "base64 0.22.1", "chrono", diff --git a/src-tauri/Cargo.toml b/src-tauri/Cargo.toml index 6600b75..cedd622 100644 --- a/src-tauri/Cargo.toml +++ b/src-tauri/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "clawpanel" -version = "0.16.5" +version = "0.17.0" edition = "2021" description = "ClawPanel - OpenClaw 可视化管理面板" authors = ["qingchencloud"] diff --git a/src-tauri/tauri.conf.json b/src-tauri/tauri.conf.json index eabe220..958815e 100644 --- a/src-tauri/tauri.conf.json +++ b/src-tauri/tauri.conf.json @@ -1,7 +1,7 @@ { "$schema": "https://raw.githubusercontent.com/tauri-apps/tauri/dev/crates/tauri-config-schema/schema.json", "productName": "ClawPanel", - "version": "0.16.5", + "version": "0.17.0", "identifier": "ai.openclaw.clawpanel", "build": { "frontendDist": "../dist",