sync: merge upstream and cron sessionMessage fixes

.github/workflows/release.yml

@@ -231,30 +231,30 @@ jobs:
 
           CHANGELOG_BODY=""
           if [ -n "$FEATS" ]; then
-            CHANGELOG_BODY="${CHANGELOG_BODY}"$'\n### ✨ 新功能\n'"${FEATS}"$'\n'
+            CHANGELOG_BODY="${CHANGELOG_BODY}"$'\n### 新功能\n'"${FEATS}"$'\n'
           fi
           if [ -n "$FIXES" ]; then
-            CHANGELOG_BODY="${CHANGELOG_BODY}"$'\n### 🐛 修复\n'"${FIXES}"$'\n'
+            CHANGELOG_BODY="${CHANGELOG_BODY}"$'\n### 修复\n'"${FIXES}"$'\n'
           fi
           if [ -n "$OTHERS" ]; then
-            CHANGELOG_BODY="${CHANGELOG_BODY}"$'\n### 📦 其他\n'"${OTHERS}"$'\n'
+            CHANGELOG_BODY="${CHANGELOG_BODY}"$'\n### 其他\n'"${OTHERS}"$'\n'
           fi
           if [ -z "$CHANGELOG_BODY" ]; then
             CHANGELOG_BODY=$'\n- 常规更新与优化\n'
           fi
 
           # ── 构建状态 ──
           if [ "$BUILD_RESULT" = "success" ]; then
-            STATUS_BADGE="✅ 全部平台构建成功"
+            STATUS_BADGE="全部平台构建成功"
           else
-            STATUS_BADGE="⚠️ 部分平台构建失败，请查看 [Actions 日志](https://github.com/${REPO}/actions)"
+            STATUS_BADGE="部分平台构建失败，请查看 [Actions 日志](https://github.com/${REPO}/actions)"
           fi
 
           # ── 写入 Release Notes ──
           {
             echo "${STATUS_BADGE}"
             echo ""
-            echo "## 📥 下载安装"
+            echo "## 下载安装"
             echo ""
             echo "根据你的操作系统选择对应安装包，点击文件名即可下载："
             echo ""
@@ -264,7 +264,7 @@ jobs:
             echo "| Apple Silicon (M1/M2/M3/M4) | [ClawPanel_${VERSION}_aarch64.dmg](${DL}/ClawPanel_${VERSION}_aarch64.dmg) |"
             echo "| Intel | [ClawPanel_${VERSION}_x64.dmg](${DL}/ClawPanel_${VERSION}_x64.dmg) |"
             echo ""
-            echo '> **⚠️ 首次打开提示"无法验证开发者"？** 在终端执行：`sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app`，或前往 **系统设置 → 隐私与安全性** 点击「仍要打开」。'
+            echo '> **首次打开提示"无法验证开发者"？** 在终端执行：`sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app`，或前往 **系统设置 → 隐私与安全性** 点击「仍要打开」。'
             echo ""
             echo "### Windows"
             echo "| 格式 | 安装包 |"
@@ -281,7 +281,7 @@ jobs:
             echo ""
             echo "---"
             echo ""
-            echo "## 🚀 首次使用"
+            echo "## 首次使用"
             echo ""
             echo "1. 安装并打开 ClawPanel"
             echo "2. 首次运行会自动检测 Node.js 环境和 OpenClaw CLI"
@@ -296,7 +296,7 @@ jobs:
             echo "${CHANGELOG_BODY}"
             echo "---"
             echo ""
-            echo "📖 [项目主页](https://github.com/${REPO}) · 💬 [反馈问题](https://github.com/${REPO}/issues) · 📣 [QQ 群](https://qt.cool/c/OpenClaw)"
+            echo "[项目主页](https://github.com/${REPO}) · [反馈问题](https://github.com/${REPO}/issues) · [QQ 群](https://qt.cool/c/OpenClaw)"
           } > release_body.md
 
           gh release edit "$TAG_NAME" --notes-file release_body.md

.gitignore

@@ -52,4 +52,9 @@ docs/promo-video.mp4
 
 # Rust 开发工具
 src-tauri/.cargo/
-.codex/
+.codex/docs/plans/
+docs/superpowers/plans/
+docs/*-plan.md
+docs/plan/
+docs/pr/
+docs/plans/

.learnings/ERRORS.md

@@ -0,0 +1,66 @@
+## [ERR-20260319-001] vite-build-chat-js
+
+**Logged**: 2026-03-19T03:53:00Z
+**Priority**: high
+**Status**: pending
+**Area**: frontend
+
+### Summary
+`npm run build` failed after chat history / hosted delivery hardening edits due to invalid JS syntax near the end of `src/pages/chat.js`.
+
+### Error
+```
+[vite:build-import-analysis] src/pages/chat.js (3786:0): Failed to parse source for import analysis because the content contains invalid JS syntax.
+3784: }
+3785: ssionStates.clear()
+3786: }
+```
+
+### Context
+- Operation attempted: `npm run build`
+- Branch/worktree: `C:\Users\34438\.openclaw\workspace\tools\clawpanel`
+- Related change: hosted delivery + history scroll hardening
+
+### Suggested Fix
+Inspect the trailing cleanup block in `src/pages/chat.js` and repair the truncated/garbled statement before re-running build.
+
+### Metadata
+- Reproducible: yes
+- Related Files: src/pages/chat.js
+
+---
+
+## [ERR-20260319-001] git-cherry-pick-conflict
+
+**Logged**: 2026-03-19T12:53:00+08:00
+**Priority**: medium
+**Status**: resolved
+**Area**: backend
+
+### Summary
+Selective upstream cherry-pick 8485df7 conflicted in src-tauri/src/commands/config.rs because the local branch had already refactored the same Windows standalone extraction block.
+
+### Error
+`
+CONFLICT (content): Merge conflict in src-tauri/src/commands/config.rs
+error: could not apply 8485df7... fix: resolve clippy dead_code and manual_flatten warnings
+`
+
+### Context
+- Operation attempted: git cherry-pick -x 8485df7
+- Repository: C:\Users\34438\.openclaw\workspace\tools\clawpanel
+- Resolution: keep local logic and manually adopt the upstream .flatten() simplification inside the conflicting ead_dir loop.
+
+### Suggested Fix
+When selectively syncing small upstream fixes into a heavily diverged branch, inspect the exact conflict hunk first and manually absorb the minimal behavior change instead of retrying full merge/cherry-pick blindly.
+
+### Metadata
+- Reproducible: yes
+- Related Files: src-tauri/src/commands/config.rs
+
+### Resolution
+- **Resolved**: 2026-03-19T12:54:00+08:00
+- **Commit/PR**: selective sync of upstream commit 8485df7
+- **Notes**: conflict resolved by retaining local branch behavior and applying only the clippy-friendly iteration style.
+
+---

.learnings/LEARNINGS.md

@@ -0,0 +1,29 @@
+# Learnings
+
+## [LRN-20260319-001] correction
+
+**Logged**: 2026-03-19T13:18:00+08:00
+**Priority**: high
+**Status**: resolved
+**Area**: frontend
+
+### Summary
+A claim that assistant settings access, hosted-agent toggle removal, and global select styling were already fixed was incorrect; these required direct source verification before reporting completion.
+
+### Details
+User reported three regressions still visible in the live UI: assistant settings could not be opened reliably, the hosted-agent enable toggle was still present in chat UI, and native select styling remained visually broken. The fix was to re-read the live source and patch the actual UI code instead of relying on partial earlier assumptions.
+
+### Suggested Action
+Before claiming UI fixes are complete, verify the rendered source locations that own the feature trigger, the visible markup, and the final shared CSS path used by the control.
+
+### Metadata
+- Source: conversation
+- Related Files: src/pages/assistant.js, src/pages/chat.js, src/style/reset.css
+- Tags: correction, ui, verification
+
+### Resolution
+- **Resolved**: 2026-03-19T13:19:00+08:00
+- **Commit/PR**: pending
+- **Notes**: fixed by removing hosted-agent enable toggle markup/state, strengthening assistant settings button click handling/z-index, and tightening global select styling in reset.css.
+
+---

CONTRIBUTING.md

@@ -2,7 +2,7 @@
 
 感谢你对 ClawPanel 项目的关注！本文档同时作为**贡献指南**和**项目维护手册**，涵盖开发、构建、发版、部署的完整工作流。
 
-> 🌐 **官网**: [claw.qt.cool](https://claw.qt.cool/)  |  📦 **仓库**: [github.com/qingchencloud/clawpanel](https://github.com/qingchencloud/clawpanel)
+> **官网**: [claw.qt.cool](https://claw.qt.cool/)  |  **仓库**: [github.com/qingchencloud/clawpanel](https://github.com/qingchencloud/clawpanel)
 
 ---
 
@@ -114,7 +114,7 @@ clawpanel/
 │   ├── src/
 │   │   ├── lib.rs              #   入口 + 命令注册
 │   │   ├── commands/           #   Tauri 命令（按功能模块拆分）
-│   │   │   ├── mod.rs          #     模块注册 + enhanced_path()
+│   │   │   ├── mod.rs          #     模块注册 + 环境变量构建
 │   │   │   ├── config.rs       #     配置读写 + 版本管理 + 面板配置
 │   │   │   ├── service.rs      #     Gateway 服务管理（跨平台）
 │   │   │   ├── agent.rs        #     Agent CRUD
@@ -414,9 +414,12 @@ if (isTauri) {
 }
 ```
 
-### PATH 问题
+### PATH 与环境变量
 
-Tauri 桌面应用启动时 PATH 可能不完整（macOS Finder 启动、Windows 非默认安装路径）。所有需要调用外部命令的地方必须使用 `super::enhanced_path()` 设置环境变量。
+Tauri 桌面应用启动时 PATH 可能不完整（macOS Finder 启动、Windows 非默认安装路径）。现在 ClawPanel 会在启动时构建并注入完整系统环境变量（用户 + 系统 + 进程），并在 PATH 中追加 `enhanced_path` 的补充路径。
+
+- **默认规则**：外部命令直接继承系统环境（无需手动设置 PATH）
+- **特殊情况**：如需补充 PATH，可使用 `super::enhanced_path()` 或 `apply_system_env` 辅助函数
 
 ---
 

README.md

@@ -39,7 +39,17 @@
 
 ClawPanel 是 [OpenClaw](https://github.com/1186258278/OpenClawChineseTranslation) AI Agent 框架的可视化管理面板。**内置智能 AI 助手**，帮你一键安装 OpenClaw、自动诊断配置、排查问题、修复错误。8 大工具 + 4 种模式 + 交互式问答，从新手到老手都能轻松管理。
 
-> 🌐 **官网**: [claw.qt.cool](https://claw.qt.cool/)  |  📦 **下载**: [GitHub Releases](https://github.com/qingchencloud/clawpanel/releases/latest)
+> **官网**: [claw.qt.cool](https://claw.qt.cool/)  |  **下载**: [GitHub Releases](https://github.com/qingchencloud/clawpanel/releases/latest)
+
+### 近期亮点
+
+- **v0.9.x**：聊天体验重构，消息渲染与交互稳定性显著提升。
+- **聊天虚拟滚动**：大聊天记录场景性能优化，滚动更顺、渲染负载降低。
+- **Markdown-it**：引入稳定的 Markdown 渲染与扩展能力，展示一致性提升。
+- **v0.8.0**：多 Agent 渠道能力完善，任务分发与协作更清晰。
+- **Gateway 补丁**：连接与转发链路修复，长连接更可靠。
+- **R2 通用包**：分发与复用成本降低，部署更灵活。
+- **v0.6.0**：基础能力完善与稳定性打底，为后续迭代奠基。
 
 ### ⚡ OpenClaw 独立安装包（零依赖，无需 Node.js/npm）
 
@@ -51,7 +61,7 @@ ClawPanel 是 [OpenClaw](https://github.com/1186258278/OpenClawChineseTranslatio
 
 > ClawPanel 安装 OpenClaw 时会**自动优先使用独立安装包**，无需手动操作。此方案仅供不使用 ClawPanel 的用户独立安装。
 
-### 🔥 开发板 / 嵌入式设备支持
+### 开发板 / 嵌入式设备支持
 
 ClawPanel 提供**纯 Web 版部署模式**（零 GUI 依赖），天然兼容 ARM64 开发板和嵌入式设备：
 
@@ -60,7 +70,7 @@ ClawPanel 提供**纯 Web 版部署模式**（零 GUI 依赖），天然兼容 A
 - **Armbian / Debian / Ubuntu Server** — 一键部署脚本自动检测架构
 - 无需 Rust / Tauri / 图形界面，**只要有 Node.js 18+ 就能跑**
 
-> 📖 详见 [Armbian 部署指南](docs/armbian-deploy.md) | [Web 版开发说明](#web-开发版无需-rusttauri)
+> 详见 [Armbian 部署指南](docs/armbian-deploy.md) | [Web 版开发说明](#web-开发版无需-rusttauri)
 
 ## 社区交流
 
@@ -114,7 +124,7 @@ ClawPanel 提供**纯 Web 版部署模式**（零 GUI 依赖），天然兼容 A
 
 安装方式：打开 `.dmg` 文件，**先将 ClawPanel 拖入「应用程序」文件夹**，再双击打开。
 
-> **⚠️ 首次打开提示"已损坏"或"无法验证开发者"？** 由于应用未签名，macOS 会拦截。请在终端执行以下命令解除限制：
+> **首次打开提示"已损坏"或"无法验证开发者"？** 由于应用未签名，macOS 会拦截。请在终端执行以下命令解除限制：
 >
 > ```bash
 > sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app
@@ -152,7 +162,7 @@ curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/script
 
 部署完成后访问 `http://服务器IP:1420`，功能与桌面版一致。
 
-📖 详细教程见 [Linux 部署指南](docs/linux-deploy.md)
+详细教程见 [Linux 部署指南](docs/linux-deploy.md)
 
 ### Docker 部署
 
@@ -166,16 +176,16 @@ docker run -d --name clawpanel --restart unless-stopped \
     cd /app && npm install && npm run build && npm run serve"
 ```
 
-📖 详细教程见 [Docker 部署指南](docs/docker-deploy.md)（含 Compose、自定义镜像、Nginx 反向代理等）
+详细教程见 [Docker 部署指南](docs/docker-deploy.md)（含 Compose、自定义镜像、Nginx 反向代理等）
 
 ## 功能特性
 
 <p align="center">
   <img src="docs/feature-showcase.gif" width="800" alt="功能矩阵">
 </p>
 
-- **🤖 AI 助手（全新·重磅）** — 内置独立 AI 助手，4 种操作模式 + 8 大工具 + 交互式问答，详见下方 [AI 助手亮点](#-ai-助手亮点)
-- **🖼️ 图片识别** — 粘贴截图或拖拽图片，AI 自动识别分析，支持多模态图文混排对话
+- **AI 助手（全新·重磅）** — 内置独立 AI 助手，4 种操作模式 + 8 大工具 + 交互式问答，详见下方 [AI 助手亮点](#-ai-助手亮点)
+- **图片识别** — 粘贴截图或拖拽图片，AI 自动识别分析，支持多模态图文混排对话
 - **仪表盘** — 系统概览，服务状态实时监控，快捷操作
 - **服务管理** — OpenClaw 启停控制、版本检测与一键升级、Gateway 安装/卸载、配置备份与还原
 - **模型配置** — 多服务商管理、模型增删改查、批量连通性测试、延迟检测、拖拽排序、自动保存+撤销
@@ -201,7 +211,7 @@ docker run -d --name clawpanel --restart unless-stopped \
 <p align="center">
   <img src="docs/01.png" width="800" alt="AI 助手">
 </p>
-<p align="center"><em>🤖 AI 助手 — 8 大技能卡片，一键触发配置检查、Gateway 诊断、环境检测、一键排障等常用操作</em></p>
+<p align="center"><em>AI 助手 — 8 大技能卡片，一键触发配置检查、Gateway 诊断、环境检测、一键排障等常用操作</em></p>
 
 <p align="center">
   <img src="docs/00.png" width="800" alt="仪表盘">
@@ -211,7 +221,7 @@ docker run -d --name clawpanel --restart unless-stopped \
 <p align="center">
   <img src="docs/02.png" width="800" alt="AI 助手设置 — 公益 AI 接口">
 </p>
-<p align="center"><em>⚙️ AI 设置 — 独立模型配置 + 公益 AI 接口一键接入，GPT-5 全系列免费可用</em></p>
+<p align="center"><em>AI 设置 — 独立模型配置 + 公益 AI 接口一键接入，GPT-5 全系列免费可用</em></p>
 
 <p align="center">
   <img src="docs/05.png" width="800" alt="AI 助手人设 — Agent 灵魂">
@@ -273,7 +283,7 @@ docker run -d --name clawpanel --restart unless-stopped \
 
 </details>
 
-## 🤖 AI 助手亮点
+## AI 助手亮点
 
 ClawPanel 内置的 AI 助手不只是聊天机器人——它能**直接操作你的系统**，帮你诊断、修复、甚至提交 PR。
 
@@ -283,10 +293,10 @@ ClawPanel 内置的 AI 助手不只是聊天机器人——它能**直接操作
 
 | 模式 | 图标 | 工具 | 写文件 | 确认 | 适用场景 |
 |------|------|------|--------|------|---------|
-| **聊天** | 💬 | ❌ | ❌ | — | 纯问答，不触碰系统 |
-| **规划** | 📋 | ✅ | ❌ | ✅ | 读配置/查日志，输出方案不动文件 |
-| **执行** | ⚡ | ✅ | ✅ | ✅ | 正常干活，危险操作弹确认 |
-| **无限** | ∞ | ✅ | ✅ | ❌ | 全自动，工具调用不弹窗 |
+| **聊天** | - | - | - | — | 纯问答，不触碰系统 |
+| **规划** | - | ✓ | - | ✓ | 读配置/查日志，输出方案不动文件 |
+| **执行** | - | ✓ | ✓ | ✓ | 正常干活，危险操作弹确认 |
+| **无限** | - | ✓ | ✓ | - | 全自动，工具调用不弹窗 |
 
 设置中还有**工具开关**（终端/文件），优先级高于模式——关掉终端，即使无限模式也调不了命令。
 
@@ -317,23 +327,23 @@ AI 等你回答后才会继续操作，实现真正的**人机协作**。
 
 发现 Bug？AI 不只是告诉你怎么修——它**直接帮你修**：
 
-1. 🐛 **提交 Bug 报告** — AI 自动收集系统环境、读取错误日志，按标准模板整理成 GitHub Issue，你复制粘贴就能提交
-2. 🔀 **PR 助手** — AI 分析 Bug 根因 → 定位代码 → 生成修复方案 → 通过 `run_command` 执行 git 命令完成 Fork/Branch/Commit/Push，**用户只需点确认**
+1. 提交 Bug 报告 — AI 自动收集系统环境、读取错误日志，按标准模板整理成 GitHub Issue，你复制粘贴就能提交
+2. PR 助手 — AI 分析 Bug 根因 → 定位代码 → 生成修复方案 → 通过 `run_command` 执行 git 命令完成 Fork/Branch/Commit/Push，**用户只需点确认**
 
 ### 内置技能卡片
 
 欢迎页提供一键触发的常用技能：
 
 | 技能 | 功能 |
 |------|------|
-| 🔧 检查配置 | 读取并分析 openclaw.json |
-| 🏥 诊断 Gateway | 检查进程、端口、日志 |
-| 📂 浏览目录 | 查看 .openclaw 目录结构 |
-| 💻 检查环境 | Node.js、npm 版本检测 |
-| 📋 分析日志 | 搜索 ERROR/WARN 关键词 |
-| 🔨 一键排障 | 自动检测并修复常见问题 |
-| 🐛 提交 Bug | 整理 Issue 提交到 GitHub |
-| 🔀 PR 助手 | 定位 Bug 并生成修复 PR |
+| 检查配置 | 读取并分析 openclaw.json |
+| 诊断 Gateway | 检查进程、端口、日志 |
+| 浏览目录 | 查看 .openclaw 目录结构 |
+| 检查环境 | Node.js、npm 版本检测 |
+| 分析日志 | 搜索 ERROR/WARN 关键词 |
+| 一键排障 | 自动检测并修复常见问题 |
+| 提交 Bug | 整理 Issue 提交到 GitHub |
+| PR 助手 | 定位 Bug 并生成修复 PR |
 
 ## 技术架构
 
@@ -588,7 +598,7 @@ ClawPanel 支持将 AI 接入多种即时通讯平台，在「消息渠道」页
 4. 点击「校验」确认连接，然后「保存」
 5. Gateway 会自动重载，飞书机器人即刻可用
 
-> 📖 详细教程：[飞书接入指南](docs/dingtalk-integration.md) | [钉钉接入指南](docs/dingtalk-integration.md)
+> 详细教程：[飞书接入指南](docs/dingtalk-integration.md) | [钉钉接入指南](docs/dingtalk-integration.md)
 
 ### 注意事项
 
@@ -667,7 +677,7 @@ npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.
 |------|------|------|
 | 端口 18789 被占用 | 另一个 Gateway 进程残留 | 终端执行 `pkill -f openclaw` 后重启 |
 | 配置文件损坏 | openclaw.json 格式错误 | 前往「服务管理」→「从备份恢复」 |
-| 反复崩溃 | API Key 或模型配置异常 | 用 AI 助手「🔨 一键排障」自动诊断 |
+| 反复崩溃 | API Key 或模型配置异常 | 用 AI 助手「一键排障」自动诊断 |
 | 提示 "auth mode" 错误 | 认证配置不兼容 | 在「安全设置」重置 Gateway 认证 |
 
 如果仍无法解决，查看「日志查看」页面的 Gateway 日志获取详细错误信息。