v0.4.0
Highlights
- Desktop Edition — First release of the Electron desktop shell with bundled Python 3.12 / Node 20 runtimes. Extract and run on Windows / macOS / Linux without any preinstalled environment. PATH injection lets the agent's bash tool invoke
python/nodevia the bundled runtimes.
New Features
- Desktop Shell — Frameless window with custom title bar, system tray (close-to-tray, quit via tray menu), connection overlay, and auto-created Windows desktop shortcut on first launch.
- Theme Tri-State Toggle — Web UI now supports light / dark / system theme modes, persisted to settings.json.
- First-Run Config Form — Initial login configuration form with dynamic channel enable/disable.
- Status Bar Enhancements — Improved status bar with precision optimizations and dead code cleanup.
- LSP Manual Activation — LSP tool switched to manual activation mode, fixing Windows server-missing detection.
Important Fixes
- Ruff Warnings — Fixed f-string without placeholders and overly broad exception captures.
- PendingToolBubble Alignment — Web PendingToolBubble now aligns with terminal: shows only tool name before tool_input arrives, summary no longer hides with progress section collapse.
CI/CD
- Restored Tests — Re-enabled pytest step in publish.yml (previously skipped, 1591 tests passing locally).
- Desktop Release Pipeline — release-desktop.yml triggers on v* tags, builds three-platform matrix (Windows zip / macOS dmg / Linux AppImage), uploads to GitHub Release.
Installation
pip install illusion-agent==0.4.0
Desktop edition: download from https://github.com/YunTaiHua/illusion-agent/releases/tag/v0.4.0
重点更新
- 桌面版 — 首发 Electron 桌面壳,内置 Python 3.12 / Node 20 运行时。Windows / macOS / Linux 解压即用,无需预装环境。PATH 注入让 agent 的 bash 工具能通过内置运行时调用
python/node。
新功能
- 桌面壳 — 无边框窗口 + 自定义顶部栏 + 系统托盘(关闭最小化到托盘,托盘菜单退出)+ 连接遮罩,Windows 首次启动自动创建桌面快捷方式。
- 主题三态切换 — Web 端支持浅色 / 深色 / 跟随系统三种主题模式,持久化到 settings.json。
- 首次登录配置表单 — 初始登录配置表单,支持渠道动态启停。
- 状态栏增强 — 状态栏精度优化,清理死代码。
- LSP 手动激活 — LSP 工具改为手动激活模式,修复 Windows 下服务器缺失检测问题。
重要修复
- Ruff 警告 — 修复 f-string 无占位符、捕获宽泛异常问题。
- PendingToolBubble 对齐 — Web 端 PendingToolBubble 与 terminal 对齐,tool_input 未到达时只显示工具名,summary 不随进度区折叠隐藏。
CI/CD
- 恢复测试 — 恢复 publish.yml 的 pytest 步骤(此前跳过,本地已验证 1591 测试通过)。
- 桌面版发布流水线 — release-desktop.yml 打 v* tag 触发三平台 matrix 打包(Windows zip / macOS dmg / Linux AppImage),上传到 GitHub Release。
安装
pip install illusion-agent==0.4.0
桌面版:从 https://github.com/YunTaiHua/illusion-agent/releases/tag/v0.4.0 下载