v0.4.1 Release Notes
Highlights
- New version update notification: after backend connection, PyPI is checked asynchronously — Terminal shows a toast, Web/Desktop shows a notification
- Desktop packaging improvements: icon now correctly embedded, fonts (Inter / JetBrains Mono) bundled, no more missing glyphs
- Code block highlighting fixed for light theme, diff colors now font-only (red/green)
- Connection overlay fixed to light theme with higher z-index, eliminating first-frame theme flash
New Features
- Version update notification — backend checks PyPI for newer releases after connecting; Terminal displays via toast, Web/Desktop via notification component. Version detection unified to use the source
__version__, fixing stale results under editable installs
- Bundled fonts — Inter and JetBrains Mono are now embedded in the frontend, rendering correctly on systems without these fonts installed
Important Fixes
- Desktop icon —
build_icons.py now synthesizes the multi-resolution .ico from PNG sources; previously a stale icon was copied into the executable
- Light theme code blocks — syntax highlighting switched to the light theme palette; pale blue tokens no longer invisible on light backgrounds
- Diff display — addition/deletion now use font color only (green/red), removing the full-line background blocks
- Theme flash on startup — connecting overlay fixed to light theme with
z-60, covering the custom title bar; no more brief wrong-theme flash
- Spell check disabled — Electron no longer underlines technical terms like
exe with red squiggles
- Channel status flickering fixed — settings channel tab no longer alternates between "Initializing..." and "Running"; a read-loop race in the daemon IPC caused ~50% of status pings to go unanswered
- Portable dir name — Windows portable extraction directory renamed from
win-unpacked to illusion-agent
Refactoring
- Version detection unified:
_get_current_version() and /version now use __version__ (synced with pyproject.toml) instead of importlib.metadata
Documentation
- README desktop download links use
releases/latest and <version> placeholders, no longer hardcoded per release
CI/CD
- Restored tag trigger for
publish.yml
- Fixed 5 hanging tests on CI Ubuntu
Installation
# pip install
pip install --upgrade illusion-agent
# Desktop (portable, no Python/Node.js needed)
# Windows: IllusionAgent-<version>-win-x64.zip
# macOS: IllusionAgent-<version>-arm64.dmg
# Linux: IllusionAgent-<version>.AppImage
# https://github.com/YunTaiHua/illusion-agent/releases/latest
v0.4.1 发布说明
重点更新
- 新增版本更新提醒:后端连接完成后异步检查 PyPI 新版本——terminal 端用 toast 展示,web/桌面端用通知组件展示
- 桌面版打包改进:图标正确嵌入、字体(Inter / JetBrains Mono)随包分发,不再出现字形缺失
- 代码块高亮修复浅色主题可读性,diff 改为仅字体着色(红/绿)
- 连接遮罩层固定浅色并提升层级,消除首帧主题闪烁
新功能
- 版本更新提醒 — 后端连接后异步检查 PyPI 新版本;terminal 端通过 toast 显示,web/桌面端通过通知组件显示。版本检测统一改用源码
__version__,修复可编辑安装下检测滞后
- 内置字体 — Inter 与 JetBrains Mono 随前端打包分发,未安装这些字体的系统也能正确渲染
重要修复
- 桌面版图标 —
build_icons.py 改为从多分辨率 PNG 合成 .ico;此前旧图标被复制进可执行文件
- 浅色主题代码块 — 语法高亮切换为浅色配色,淡蓝 token 在浅色背景上不再不可见
- diff 显示 — 新增/删除行仅保留字体颜色(绿/红),去掉整行背景色块
- 启动主题闪烁 — 连接遮罩层固定浅色并提升层级(覆盖自定义标题栏),不再短暂显示错误主题
- 禁用拼写检查 — Electron 不再对
exe 等技术词汇标红色波浪线
- 渠道状态闪烁修复 — 设置页渠道 tab 不再交替显示"正在初始化中..."/"运行中";守护进程 IPC 读循环竞态导致约 50% 状态查询无响应
- 便携版目录名 — Windows 便携版解压目录由
win-unpacked 改为 illusion-agent
重构
- 版本检测统一:
_get_current_version() 与 /version 改用 __version__(与 pyproject.toml 同步),替代 importlib.metadata
文档
- README 桌面版下载链接改用
releases/latest 与 <version> 占位符,不再随版本硬编码
CI/CD
- 恢复
publish.yml 的 tag 触发
- 修复 CI Ubuntu 上 5 个测试挂死问题
安装
# pip 安装
pip install --upgrade illusion-agent
# 桌面版(便携,无需 Python/Node.js)
# Windows: IllusionAgent-<版本>-win-x64.zip
# macOS: IllusionAgent-<版本>-arm64.dmg
# Linux: IllusionAgent-<版本>.AppImage
# https://github.com/YunTaiHua/illusion-agent/releases/latest