更新日志

新增

• 设备「更多」菜单新增「应用投屏」，可将指定应用投屏到独立虚拟屏，手机物理分辨率不受影响，手机可同时正常使用
• 应用投屏支持同时投屏多个应用，每个应用一个独立窗口，可在弹窗中查看并单独停止某个应用投屏
• 应用投屏支持选择虚拟屏分辨率（默认跟随手机，可选 540x960 / 720x1280 / 1080x1920 / 自定义）与像素密度，并记住上次选择的应用与分辨率
• 设备「更多」菜单新增「恢复手机分辨率」，一键检测并重置被其他工具通过 wm size/density 修改过的手机分辨率
• 应用投屏关闭时自动结束被投屏应用，避免应用残留在手机侧
• 投屏自定义参数支持全局参数与单机参数叠加生效，全局参数先应用，单机参数追加在后并可覆盖全局

优化

• 重新设计启动页，改为极简浅色风格，居中展示品牌 Logo、名称与标语，底部新增品牌色加载进度条
• 应用投屏与应用管理的应用列表改为「图标 + 名称」网格展示，图标按包名自动获取，失败时回退内置图标
• 左侧主导航选中项改为品牌浅色底块 + 深色文字，暗色主题同步适配
• 提升浅色主题下辅助说明文字与输入框占位符的对比度，达到 WCAG AA 可读性标准
• 禁用态按钮由过淡文字改为浅灰底 + 中灰字，禁用状态清晰可读
• 统一各弹窗宽度为「固定上限 + 95vw 兜底」，小窗口下不再溢出
• 任务卡片图标、设备分组悬停等点缀色由蓝色统一为品牌色，链接颜色同步统一

修复

• 「关于」页面协议声明由 AGPL-3.0 更正为 Apache-2.0
• 停止投屏（含主投屏、应用投屏、设备管理进程）时进程可能不退出导致投屏窗口残留，SIGINT 无效时自动强制结束进程
• 投屏自定义参数中含多个参数（如 --crop 720:1280:0:0）时整串被当成单个参数导致不生效，现按空格/引号正确拆分
• 内置大模型额度不足时，部分错误码（insufficient_quota）未提示能量不足、未自动跳转充值页
• 应用投屏在部分机型（如红米 Turbo 3 / 澎湃系统）上读不到应用列表，现自动改用 adb 获取可投屏应用并展示失败原因
• 暗色主题下主按钮白字对比度不足，改为深色文字

运行记录与无线设备管理增强，投屏诊断上线

• 新增：运行记录弹窗支持删除单条记录和清空当前任务所有记录，任务列表页头部新增「清空所有记录」按钮，方便管理隐私数据

• 新增：无线设备「设备设置」支持修改连接 IP 和端口，保存后自动更新连接并迁移原设备配置，避免重复设备

• 新增：数据目录支持 LINKANDROID_DATA_ROOT 环境变量覆盖，正式安装版可由 macOS Info.plist 注入，实现正式数据与开发测试隔离

• 新增：任务脚本新增 la.findOrNull() / la.findOrNone() API（未找到元素返回 None）及 la.ElementNotFoundError 异常导出，使用手册同步更新

• 新增：task run 支持 --device 参数、/api/task/run 支持可选 deviceId；无在线设备时返回明确错误提示

• 新增：任务「运行设置」支持保存目标设备配置（多设备/所有设备），定时、手动、CLI/API 执行均按配置执行

• 新增：设备页批量操作新增「批量连接」，可一键批量连接断开的网络设备

• 新增：设备页「更多」菜单新增「投屏诊断」入口，自动检查 adb/scrcpy/端口/设备列表等，帮助定位投屏失败原因

• 优化：无线设备设置中的端口变化提示支持多语言

• 优化：二维码无线配对支持按设备名称匹配连接服务，并在关闭或重新生成二维码时取消旧扫描任务

• 优化：client.json 数据目录字段统一改为 dataRoot，userData/appData 均指向数据根目录（Go CLI 同步支持）

• 优化：AI 生成任务代码约束强化，点击操作优先使用 tapText/tapId/tapDesc/tapExists，禁止链式 .click()

• 优化：任务目标设备解析优先级统一为「显式指定 > 任务绑定 > 自动发现」，编辑/复制时自动恢复已保存的运行设置

• 优化：设备页全部下拉菜单项增加图标，菜单可读性更佳

• 优化：启动日志新增版本号与构建时间（LaunchInfo 输出 version 与 buildId），便于确认运行的版本是否包含最新修复

• 优化：任务编辑界面禁用 Esc 关闭弹窗，防止输入法取消时误触导致编辑内容丢失

• 修复：任务编辑界面 Ctrl+C 无法复制代码（Electron 菜单加速器拦截了快捷键，导致 CodeMirror 内部选区无法响应），现移除菜单拦截，CodeMirror 原生复制正常工作

• 修复：二维码配对成功后错误回退到固定 5555 端口导致动态端口设备连接失败

• 修复：任务脚本 la.find() 未找到元素时不再静默返回 None 导致晦涩报错，现抛出带清晰中文提示的 ElementNotFoundError

• 修复：CLI/HTTP 远程执行任务时未注入设备环境变量导致连接失败，现自动选择 adb 在线设备（USB 优先）并注入

• 修复：投屏失败（如 adb 无法启动）此前被 scrcpy 版本 banner 静默吞掉，现 stderr 出现错误时立即弹出「投屏失败」并展示详细日志

• 修复：随动（Follow）在连接多台设备时失效——DeviceManage 启动失败被静默吞掉、多台并发抢占 adb 端口导致接收端缺失；现改为串行错峰启动、失败自动重试、设备重连自动恢复

新增

• scrcpy 升级到 4.1 版本

• 测试项目根目录统一解析工具 projectRoot()

• 投屏右侧新增息屏/亮屏按钮，支持快速控制设备屏幕状态

优化

• 测试文件统一使用 projectRoot() 替代各自独立计算根目录

• .gitignore 增加 OpenCode 临时文件忽略规则

• 更新应用图标资源（appx、tray、logo 等）

• macOS 托盘图标过大时自动缩小至 16x16

• macOS 构建时 extraResources 增加 osx/ 目录过滤规则

• spawnShell 增加 maxLogLines 参数，限制日志缓冲区大小，避免内存无限增长

• mirror 投屏日志只保留最近 200 行，避免结束后重复打印全部日志

• 投屏息屏/亮屏改用 scrcpy 控制协议实现，避免触发锁屏

• 投屏控制面板初始化时自动查询设备真实屏幕状态，确保图标与状态一致

新增

• Task 自动化任务完整体系（任务编辑器、运行器、运行时框架、聊天面板、设备预览、文档面板、XML 节点树、运行/日志弹窗）

• 大模型设置模块，支持 46+ AI 提供商和模型配置

• 设置页 CLI 工具

• 新增取消全选、脚本、大模型设置、录屏格式、Task 自动化任务等多语言键

优化

• 设备页分组设置弹窗重构，全选按钮改进（支持取消全选及实时状态），标题图标装饰，移除重复代码，内容区底部内边距

• macOS 窗口增加拖拽支持，标题栏样式改进

• 导航栏头像增加阴影和固定尺寸显示，PageNav 导航栏进一步简化

• 设备弹窗（AppManager/FileManager/Camera 等）多项交互改进

• 大模型设置面板布局修复，侧栏和内容区高度自适应

• 弹窗硬编码文本直接使用英文标签，移除 Lib 模块相关多语言键

主要功能

• 增强无线配对：全新无线调试体验，支持二维码自动配对和手动配对码输入

• mDNS服务发现：使用Bonjour自动发现设备，实现ADB无缝连接

• 投屏侧边操作栏：投屏时快捷操作栏，支持返回、首页、最近任务、音量调节、截图等操作

• 设备连接菜单：下拉菜单支持快速网络设备连接及无线调试配对

技术改进

• 核心升级：scrcpy升级至v3.3.4，提升投屏稳定性

• 路径管理：简化ADB和Scrcpy二进制路径处理，智能默认路径

• 界面优化：改进无线配对对话框、加载动画、多语言一致性

• 网络检测：自动网络接口检测，用于无线配对

修复与优化

• 修复安装路径包含中文时投屏可能失败的问题

• 在托盘配置中添加强制退出功能

• 优化启动画面布局和透明度设置

• 增强Pro版本功能引导与升级提示流程

• 完善国际化翻译更新

设备功能

• 设备投屏随动模式和置顶模式，支持多设备同步操作

• 二维码配对后自动扫描和连接设备

• 增强设备搜索和连接工作流

已知问题修复

新增：窗口顶部点击最大化

新增：Mac版本默认集成scrcpy，不再依赖外部

新增：设备搜索功能，支持按设备名称搜索

升级：升级 scrcpy 至最新版

优化：scrcpy 和 adb 二进制路径优化

优化：命令调用方式优化

优化：设备批量显示布局优化