TuriX第一个实战任务：从切换深色模式到GitHub点星，5个桌面自动化案例逐行解析执行日志-北京尧图网络

TuriX第一个实战任务从切换深色模式到GitHub点星5个桌面自动化案例逐行解析执行日志【免费下载链接】TuriX-CUAThis is the official website for TuriX Computer-use-Agent项目地址: https://gitcode.com/gh_mirrors/tu/TuriX-CUATuriX 是一个完全开源的桌面自动化 AgentCUAComputer-Use Agent用一句话描述任务它就能像人一样点击、输入、跨应用操作你的 Mac 或 Windows 电脑。本文用 5 个真实任务——从切换系统深色模式到 GitHub 仓库点星——逐行解析 TuriX 的执行日志带你看完每一步它在想什么、点了哪里、结果如何新手跟着做就能跑通自己的第一个桌面自动化任务。一、准备工作3 条命令装好 TuriX 桌面自动化TuriX 的启动非常直接克隆仓库、建环境、装依赖。git clone https://gitcode.com/gh_mirrors/tu/TuriX-CUA cd TuriX-CUA conda create -n turix_env python3.12 conda activate turix_env pip install -r requirements.txt随后在 examples/config.json 中配置两个东西agent.task用自然语言写清楚任务质量直接影响成功率brain_llm/actor_llm/planner_llm/memory_llm四个模型角色可指向官方端点或本地 Ollama。然后执行python examples/main.pyTuriX 就开始动手了。Windows 用户请先切换到multi-agent-windows分支详见 README.zh-CN.md 的快速开始章节。二、看懂架构Brain、Actor、Planner、Memory 的分工TuriX 采用多模型分工架构理解了它执行日志就看得懂了角色职责对应配置Planner高层任务拆解并挑选匹配的 Skillplanner_llmBrain看截图、评估上一步成败、生成本步目标brain_llmActor把目标翻译成具体 UI 动作点击、输入、按键actor_llmMemory压缩历史记忆防止上下文爆炸memory_llm动作最终由 src/controller/service.py 中的 Controller 执行到系统 UI 上整个循环截图 → 评估 → 目标 → 动作的编排逻辑在 src/agent/service.py 中任务入口是 examples/main.py。三、案例1切换深色模式——逐行解析你的第一份执行日志这是官方示例任务也是最适合新手的Hello World{ agent: { task: open system settings, switch to Dark Mode } }运行后终端和.turix_tmp/logging.log中会出现这样一条日志链我们逐行拆解 Step 1 Goal to achieve this step: 打开系统设置 ️ Action: click点击系统设置图标 ✅ Eval: Success Step 2 Goal to achieve this step: 进入外观面板并切换到 Dark Mode ️ Action: click选择 Dark 单选按钮 ✅ Task completed successfully日志标记含义你在日志里该关注什么 Step N第 N 步开始步数持续递增说明 Agent 在正常推进 Goal to achieve this stepBrain 为本步生成的目标目标是否贴合原任务跑偏时看这里️ ActionActor 执行的具体动作点错了位置对照截图排查✅ Eval: Success / Failed对上一步的成败评估连续 Failed 会触发重试超过max_failures会停✅ Task completed successfully任务闭环出现在 src/agent/service.py 对应日志处同时每个角色都会落盘独立的对话日志方便事后复盘日志文件内容.turix_tmp/logging.log主日志含上面全部标记.turix_tmp/brain_llm_interactions.log_brain_N.txtBrain 每步的分析目标推理.turix_tmp/actor_llm_interactions.log_actor_N.txtActor 每步的动作决策.turix_tmp/planner_llm_interactions.log_planner_N.txtPlanner 的任务拆解四、案例2GitHub 搜索并点星——Skills 技能手册登场官方示例任务见 examples/config.jsonopen Chrome, go to github, and search for turix-cua in the github webpage. Enter the TuriX-CUA repository, and star it.这个任务之所以稳定是因为开启了Skills仓库内置的 skills/github-web-actions.md 就是一份点星操作手册核心规则包括始终新开标签页再导航用站内搜索定位仓库需要登录时先向用户确认再继续点星前先确认 Star 按钮状态Star vs Starred避免重复点。在配置中启用规划与技能即可Planner 只会按name/description选技能Brain 则拿着技能全文指导每一步{ agent: { use_plan: true, use_skills: true, skills_dir: skills, skills_max_chars: 4000 } }日志中的典型推进节奏Step 1 开浏览器并新标签页 → Step 2 站内搜索 TuriX-CUA 并进入仓库 → Step 3 检查 Star 按钮状态后点击 → 评估 Starred 生效任务完成。你也可以仿照这个格式在skills/目录里给自己常做的操作写一份 Markdown 手册。五、案例3-5跨应用长流程与跨系统案例3查 iPhone 价格 → 建 Pages 文档 → 发给联系人这是一个跨 3 个应用的复合任务浏览器查价、Pages 写文档、消息应用发送。执行日志里每步的 Goal都会自动收敛到当前子目标Brain 靠 Memory 记住价格是多少无需人工提示。案例4Numbers 柱状图插入 PowerPoint 并回复老板难度最高的办公流读取 Discord 里老板发来的 Numbers 文件、生成柱状图、插到 PowerPoint 的正确位置、再回复老板。长任务建议开启use_plan让 Planner 先拆解并适当调大max_steps默认 100。案例5Windows 上 YouTube 搜索视频并点赞TuriX 并非只支持 Mac切到multi-agent-windows分支后同一套 Brain/Actor 架构即可驱动 Windows 桌面Linux 支持在multi-agent-linux分支。六、进阶玩法MCP 让其他 AI 助手远程指挥 TuriXTuriX 是 MCP 就绪的Claude 等支持 MCP 的 Agent 可以调用它完成搜索 AI 新闻 → 写入 Pages 文档 → 发送给联系人这类闭环任务。类似地搜索机票酒店叫 Uber这类多平台预订任务也是 TuriX 桌面自动化能力的典型场景。七、日志排查速查表与常见问题问题排查 / 解决卡在 Step 1检查.turix_tmp/是否生成首次启动加载 4 个模型需 1-2 分钟无日志输出看 examples/config.json 中logging_level任务中断想接着跑固定agent_id并设resume: true需src/agent/temp_files/agent_id/memory.jsonl已存在Agent 跑飞了按CmdShift2force_stop_hotkey立即强制停止截图/点击无权限macOS 授予辅助功能屏幕录制权限Safari 需开启远程自动化想通过脚本下发任务使用 OpenCLaw_TuriX_skill/scripts/run_turix.sh说明见 OpenCLaw_TuriX_skill/SKILL.md新手建议第一个任务从深色模式这种单应用、可验证的场景开始跑通后再叠加 Skills 和跨应用长流程每次任务结束花 1 分钟翻一下brain_llm_interactions.log_brain_*.txt里的analysis字段你会清楚地知道 TuriX 每一步为什么这么点——这正是桌面自动化从玄学变可控的关键。【免费下载链接】TuriX-CUAThis is the official website for TuriX Computer-use-Agent项目地址: https://gitcode.com/gh_mirrors/tu/TuriX-CUA创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

TuriX第一个实战任务：从切换深色模式到GitHub点星，5个桌面自动化案例逐行解析执行日志

相关推荐

u-center调试GPS模块：波特率、报文频率与双UART配置实战指南

Notepad++ 7.3.2 免安装版：老系统兼容的便携编辑器配置与避坑指南

华为ensp静态路由配置详解：从原理到实战排障

更多资讯

需求交付 15 天压到 7 天之后，研发效能度量平台该盯哪 3 个指标？

Claude Code插件实战：从Skills安装到配置排错全攻略

小学生冬季校服定制厂家直供，轻便保暖安全无异味，新兰仔服饰支持加急交货

MPlayer Next 5：命令行播放器现代化改造实战记录

TypeScript 实战：从零搭建 AI Agent 的 RAG 知识获取管道

海思数字IC秋招笔试通关指南：AXI协议、跨时钟域与手撕代码全攻略

今日更新

开源模型端侧落地实战：量化、推理加速与Agent上下文管理

AI Evals实战指南：从零搭建LLM应用评估体系与CI/CD集成

Java采购管理系统实战：从数据库设计到事务一致性

本周精选

如何彻底离线使用 Laya-CoreML：Hugging Face 下载、缓存机制与 local_files_only 详解

基于1Panel 部署MySQL MCP 服务：TaoToken 统一 Key 接入与 config.toml 配置实战

崇州园区营销网站建设避坑指南：5大注意事项保备案安全

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？