v1.3.2 — 修复打包版 WSL 桌面引导静默失败

v1.3.2 更新内容

本版本修复 Agent 桌面（WSL）在打包安装版上引导失败且无错误原因 的问题。

问题根因

打包版从资源管理器启动时是非管理员身份，恰好落入一条静默失败路径：UAC 提权执行的输出全部丢弃、失败只返回布尔值——面板只能显示「Debian 发行版安装失败」而拿不到任何原因。开发模式（管理员终端）不会触发该路径，因此仅打包版复现。

修复内容

• 免提权优先直装：现代 WSL 在功能启用后安装发行版不需要管理员，打包场景直接避开 UAC 弹窗被拒 / 被安全软件拦截的坑；失败再走 UAC 提权重试
• 提权输出可回收：提权 bat 的输出重定向到日志文件并随结果返回，失败原因全程透传到面板（如 [Store 提权] 用户拒绝了 UAC 提权），不再只显示四个字
• wsl.exe 绝对路径化：全模块改为 System32 绝对路径调用，消除打包环境 PATH 差异隐患
• UAC 提示：安装阶段文案明确提示「若弹出 UAC 确认窗口请点『是』」
• 退出码 3010 误判：修复 dism「成功但需重启」在提权路径被当作失败处理的潜伏 bug

附带修复：会话落盘竞态

saveConversations 的防抖 Promise 此前在磁盘写入完成前即 resolve，调用方 await 返回后立即读取可能拿到旧数据（影响退出前落盘语义）。已改为写盘完成后才 resolve。

临时解法（无需等待本版本）

管理员终端执行 wsl --install -d Debian 预装发行版，回到 App 点「一键启动」即可跳过安装流程。

---

质量基线：TypeScript 类型检查通过 · 测试 816/816 全通过
安装包：XimoAgent Setup 1.3.2.exe（附 .blockmap，支持应用内增量更新）
系统要求：Windows x64。Agent 桌面功能需启用 WSL2。

v1.3.1 — Agent 系统 + WSL 隔离桌面 + 虚拟桌面

v1.3.1 更新内容

全新能力：Agent 系统

• Agent 定义库：把可复用工作沉淀为 Agent 角色（提示词 + 工具集 + 模型档位），支持 useDesktop（在隔离桌面执行）与 autoApprove（免逐条确认）开关
• 后台实例执行：复用主链路工具调用循环无头运行，并发上限 3，使用桌面的实例进入互斥队列；结果写回会话并弹系统通知，侧边栏实时显示「运行中 / 未读完成」徽标
• 定时调度：支持固定间隔 / 每日 / 每周三种计划，应用关闭期间错过的任务启动后自动补跑
• Webhook 触发：内置 HTTP 服务接收外部事件派活，可与 CI、消息机器人等系统串联
• 对话交接 /handoff：把当前会话上下文打包交后台 Agent 继续处理
• 主动分担（AssistWatcher）：默认关闭，仅采集窗口标题与文本大纲（不截图、不落盘），判定后弹提案征求同意，fail-closed 设计 + 30 分钟提案去重

全新能力：Agent 桌面与虚拟桌面

• Agent 桌面（wsl_desktop）：在 WSL2 + Xvfb 构建的隔离 Linux 桌面中自主操作（xdotool 点击输入、import 截屏、ffmpeg 画面流），实时投射到右侧面板，可单独下达任务，与主会话互不干扰；含全自动环境引导链，默认 1280x800，桌面假死自动重启重试
• 虚拟桌面（virtual_desktop）：按 Windows 虚拟桌面分组管理窗口，Agent 在独立桌面空间工作，不打扰你当前桌面

安全与权限

• 子 Agent 同源审批：专家与后台 Agent 调用工具走与主链路同一套决策 + 弹窗确认 + 拒绝缓存；缺少确认回调时 fail-closed 拒绝，并禁止子 Agent 再派生子 Agent（防递归）
• 桌面工具分级授权：画面读取与交互类默认放行，exec / launch / set_resolution 需确认，堵住绕过终端审批的通道
• 敏感文件与内网地址防护跨平台加固（路径分隔符统一、IPv6 带方括号主机名兼容）

体验与界面

• 推理强度补全为五档：关闭 / 低 / 中 / 高 / 超高，标尺可拖动切换
• 右侧栏可收起（Ctrl+B），浏览器开启期间自动锁定展开防丢失录制现场
• 窄窗口（<1100px）自动降级布局并记住用户宽度偏好
• 设计系统 token 化，统一空态 / 错误 / 加载 / 欢迎组件

工程质量

• 测试规模 424 → 816 例全部通过；新建 functional / integration / regression / smoke / ui / fuzz 分层测试目录
• IPC 与多个大文件按职责拆分为模块目录，对外接口与行为保持不变
• 类型检查（node + web）全通过

文档

• README 新增「界面预览」（浅色 / 深色主题、Agent 桌面三张实机截图）与「Agent 系统与定时任务」章节，同步工具域清单、权限说明与目录结构

---

安装包：XimoAgent Setup 1.3.1.exe（附 .blockmap，支持应用内增量更新）
系统要求：Windows x64。Agent 桌面功能需启用 WSL2。

v1.3.0 — 右栏架构升级 + UI 统一规范 + 模型 ID 迁移

v1.3.0 更新内容

界面架构

• 右侧栏支持收起/展开（Ctrl+B）；内嵌浏览器开启期间自动锁定展开，避免丢失录制现场
• 窄窗口自动降级：1100px 断点以下自动收起左右栏，恢复宽度后还原用户偏好
• 新增全局 MCP / Skill 面板入口（懒加载，不拖慢启动）
• 办公模式右栏重构：概览页常驻，终端/文件按需开启；后台工具收敛为单一入口
• 自动化审批等级改为单一真相源，修复"选择手动审批但确认弹窗不弹"的状态冲突

视觉规范

• 设计系统 token 化：新增强调色派生与应用体系，全站组件统一
• 统一空态 / 错误提示 / 加载指示 / 欢迎页组件，消除各面板重复实现
• 删除 4 个旧组件（CodingWelcome / DesignWelcome / ToolPanel / QuickActionCards）

模型与兼容

• DeepSeek 模型 ID 迁移：deepseek-v4-flash → deepseek-flash（原生多模态），历史配置自动归一化兜底

工程与质量

• 新增 UI 度量 / 归一化、图标提取、无障碍扫描等工程脚本
• 修复历史遗留测试失败（electron mock 缺失 safeStorage），新增 4 个渲染层测试
• 全量测试 424 例通过，TypeScript 类型检查通过

完整安装包：XimoAgent Setup 1.3.0.exe（附 blockmap 支持增量更新）

v1.2.1

v1.2.1

New

• Port changes/tasks tabs to right panel
• 3-tab layout

Refactor

• Modular component structure
• Shared types
• CursorEffects CSS fix

Cleanup

• Remove redundant UI

v1.2.0

v1.2.0 - Three-tab right panel (Files / Changes / Tasks)

v1.1.0

v1.1.0 新功能

• 本地 Whisper 离线语音输入 + TTS 播报（VoiceOrb 悬浮语音球）
• Office 文档工具 office_docs（OfficeCLI 驱动，读写 Word/Excel/PPT）
• 自定义多模型服务商支持（OpenAI 兼容 API，能力门控）
• 长任务模式：意图分析 + todo 拆解 + 多批自动续跑
• 跨会话知识自动提取入库
• MCP 会话单例化 + 工具动态注册
• 工具结果保留优先级、LLM 摘要式上下文压缩、工具调用配对保护
• 专家工作过程可视化、鼠标特效、导入技能斜杠命令
• 环境信息注入、流式稳定性加固、代码审查重构（OCR 增强）
• 主题编辑器扩展、clear-glass 透明主题
• 安装包启用 maximum 压缩（LZMA）

v1.0.9

v1.0.9 ?????? + ?????? + ???????

v1.0.8

v1.0.8 — 增强提示词功能

新增

• 增强提示词功能
• 主题编辑器增强：新增 dimension / select 输入类型，颜色支持透明色（color-alpha）
• 新增「纯透明立体玻璃」主题（clear-glass-3d）
• 新增主题包制作说明文档

修复

• 修复背景图无法正常导入

致谢: react-bits · open-design · pi-computer-use · Reasonix

v1.0.7

v1.0.7 — 工程审查修复与架构重构

安全修复

• 确认回调改用 ipcMain.once，防止事件监听器累积泄漏
• MCP 会话改为全局单例，解决第 2 条消息起 MCP 工具失效的问题

Agent 循环模块化

• 新增 Phase 0 规划轮（planning-phase）：用 ~300 token 文本目录替代 ~15000 token 完整工具 schema，复杂任务先选工具再执行
• 工具执行逻辑拆分为独立模块（tool-execution）
• 上下文窗口与前端统一为 1M tokens；compact 阶段新增 LLM 摘要压缩

架构重构

• 全项目路径别名化：@main / @shared / @renderer
• IPC 拆分为 data/system/update 三个 handler 模块
• 新增 KnowledgeStore（@orama 全文检索）、ThemePackStore、CustomDesignStore、BackgroundStore

新功能

• 知识库面板、主题包管理、主题编辑器、文件提及（@file）等功能组件

测试

• 新增 17 个测试文件（agent-loop / permission / store / computer-use / context-manager 等）

致谢: react-bits · open-design · pi-computer-use · Reasonix

v1.0.6

v1.0.6

• 工程审查后的首次迭代版本
• 版本号更新

致谢: react-bits open-design pi-computer-use Reasonix