[{"data":1,"prerenderedAt":678},["ShallowReactive",2],{"enterprise-manual-\u002Fmanuals\u002Fcua\u002Foverview":3,"enterprise-manual-navigation":435,"enterprise-manual-release-navigation":602,"release-search-metadata-zh-CN":628,"manual-search-metadata-zh-CN":636},{"id":4,"title":5,"body":6,"description":419,"editions":420,"extension":422,"locale":423,"meta":424,"navigation":425,"order":426,"path":427,"product":428,"section":429,"seo":430,"status":431,"stem":432,"updatedAt":433,"__hash__":434},"manualsZh\u002Fmanuals\u002Fcua\u002Foverview.md","CUA 模式",{"type":7,"value":8,"toc":403},"minimark",[9,13,18,21,37,93,96,99,102,119,122,139,142,145,152,155,166,169,173,176,181,184,199,205,208,211,228,234,237,243,246,249,252,255,258,266,269,272,275,281,284,287,290,298,301,304,307,310,313,316,394],[10,11,12],"p",{},"CUA（计算机使用代理）通过屏幕理解当前界面，并执行打开应用、点击、滚动、输入、按键和等待等动作。它重点补足没有稳定 API（应用程序接口）、无法直接接入工具，或必须通过桌面客户端界面完成的“最后一段”操作。",[14,15,17],"h2",{"id":16},"cua-补足什么","CUA 补足什么",[10,19,20],{},"有稳定 API 时优先使用 API；任务只发生在浏览器页面中时，可以优先使用 Playwright（浏览器自动化工具）等网页自动化方式。以下情况更适合 CUA：",[22,23,24,28,31,34],"ul",{},[25,26,27],"li",{},"目标是飞书、企业微信、钉钉等已经登录的桌面通信软件，而不是浏览器页面；",[25,29,30],{},"需要操作系统文件选择器、桌面弹窗或其他原生界面；",[25,32,33],{},"任务需要在文件管理器、办公软件、浏览器和通信软件之间切换；",[25,35,36],{},"系统没有开放接口，或者现有接口无法完成上传、发送等界面步骤。",[38,39,40,56],"table",{},[41,42,43],"thead",{},[44,45,46,50,53],"tr",{},[47,48,49],"th",{},"方式",[47,51,52],{},"更适合",[47,54,55],{},"主要限制",[57,58,59,71,82],"tbody",{},[44,60,61,65,68],{},[62,63,64],"td",{},"API（应用程序接口）",[62,66,67],{},"稳定、结构化、可批量调用的系统能力",[62,69,70],{},"目标系统必须开放并授权对应接口",[44,72,73,76,79],{},[62,74,75],{},"Playwright（浏览器自动化工具）",[62,77,78],{},"浏览器网页中的表单、点击和页面流程",[62,80,81],{},"不能直接操作桌面客户端及其原生窗口",[44,83,84,87,90],{},[62,85,86],{},"CUA（计算机使用代理）",[62,88,89],{},"桌面应用、跨应用流程和无接口界面",[62,91,92],{},"依赖可见界面，稳定性受窗口、权限和界面变化影响",[10,94,95],{},"CUA 不会绕过应用限制，也不代替用户完成登录、验证码、账号选择或第三方授权。目标客户端版本、当前登录状态、系统权限和企业策略都会影响实际可用性。",[14,97,98],{"id":98},"什么时候使用",[10,100,101],{},"适合：",[22,103,104,107,110,113,116],{},[25,105,106],{},"打开指定应用并导航到某个页面；",[25,108,109],{},"在已登录的通信软件中定位联系人或群聊，填写消息并上传指定文件；",[25,111,112],{},"从多个界面收集非敏感信息；",[25,114,115],{},"执行规则清晰、可观察、可中止的重复流程；",[25,117,118],{},"在内部系统中完成只读查询或准备待提交内容。",[10,120,121],{},"以下任务不要交给 CUA 完全自动执行：",[22,123,124,127,130,133,136],{},[25,125,126],{},"付款、转账、采购下单；",[25,128,129],{},"删除、发布、群发和最终提交；",[25,131,132],{},"处理验证码、系统口令或私钥；",[25,134,135],{},"依赖像素位置且界面频繁变化的大规模无人值守流程；",[25,137,138],{},"不允许自动化操作的系统。",[14,140,141],{"id":141},"在通信软件中发送消息和文件",[10,143,144],{},"CUA 可以像用户一样打开已登录的通信软件、进入指定会话、填写消息、调用文件选择器并上传文件。这类桌面交付通常没有可直接调用的 API，Playwright 也无法直接控制桌面客户端，因此是 CUA 的重点场景。",[10,146,147],{},[148,149],"img",{"alt":150,"src":151},"CUA 在飞书桌面客户端中上传并发送文件","\u002Fdocs\u002Fmanuals\u002Fcua\u002Fsend-file-to-feishu-20260729.png",[10,153,154],{},"任务中应明确联系人、消息内容、文件名、允许发送的范围和异常处理方式：",[156,157,163],"pre",{"className":158,"code":160,"language":161,"meta":162},[159],"language-text","打开已经登录的飞书客户端，进入“青川”的聊天窗口。\n上传项目目录中的“AI技术前沿洞察.pptx”，核对联系人和文件名后发送。\n不要进入其他会话，不要上传目录中的其他文件。\n如果出现登录、账号选择、权限请求或联系人重名，暂停让我处理。\n","text","",[164,165,160],"code",{"__ignoreMap":162},[10,167,168],{},"发送给外部联系人、群聊或包含敏感信息时，应把最终发送设置为人工确认点。发送完成后回到真实会话中检查消息、文件名和发送状态，不要只依据 CUA 的完成提示。",[14,170,172],{"id":171},"与-work-配合完成复杂任务","与 Work 配合完成复杂任务",[10,174,175],{},"Work（办公模式）适合检索、分析、整理材料和生成文件；CUA 适合把结果送入只能通过桌面界面操作的应用。组合后可以完成“研究 → 生成 → 打开通信软件 → 发送结果”的完整流程。",[177,178,180],"h3",{"id":179},"先允许-work-使用-computeruse","先允许 Work 使用 ComputerUse",[10,182,183],{},"Work 默认不一定能够调用图形界面。开始组合任务前：",[185,186,187,190,193,196],"ol",{},[25,188,189],{},"打开“设置 → 控制执行”。",[25,191,192],{},"找到“工具访问（Work 和 Code 模式）”。",[25,194,195],{},"开启“允许 ComputerUse（GUI 自动化）”。",[25,197,198],{},"确认操作系统已经授予 TuriX 辅助功能和屏幕录制权限。",[10,200,201],{},[148,202],{"alt":203,"src":204},"在控制执行设置中开启允许 ComputerUse","\u002Fdocs\u002Fmanuals\u002Fcua\u002Fenable-computer-use-20260729.png",[10,206,207],{},"这个开关只是让 Work 和 Code 能够调用图形界面工具，不会替代系统授权，也不会自动完成登录、验证码或第三方授权。权限级别仍决定执行工具前是否需要用户确认。",[177,209,210],{"id":210},"组合任务怎么执行",[185,212,213,216,219,222,225],{},[25,214,215],{},"Work 使用网络检索、文件和 Skill（技能）完成资料收集与整理。",[25,217,218],{},"Work 先在回答或项目目录中生成待发送的消息、文档、表格或演示文稿。",[25,220,221],{},"Work 调用 ComputerUse，打开已经登录的通信软件。",[25,223,224],{},"CUA 能力定位指定联系人，填写消息或上传 Work 刚生成的文件。",[25,226,227],{},"用户核对收件人、内容和附件；任务发送后检查真实会话状态。",[10,229,230],{},[148,231],{"alt":232,"src":233},"Work 检索 AI 热点并通过飞书发送结果","\u002Fdocs\u002Fmanuals\u002Fcua\u002Fwork-research-send-message-20260729.png",[10,235,236],{},"可以在 Work 中直接描述完整目标：",[156,238,241],{"className":239,"code":240,"language":161,"meta":162},[159],"检索今天最值得关注的 5 条 AI 行业动态，逐条核对来源并整理成适合即时消息阅读的摘要。\n整理完成后，打开已经登录的飞书客户端，把摘要发送给“青川”。\n发送前核对联系人和最终内容；遇到登录、授权、联系人重名或发送失败时暂停。\n",[164,242,240],{"__ignoreMap":162},[10,244,245],{},"如果未开启“允许 ComputerUse（GUI 自动化）”，Work 只能完成检索、整理和文件生成，无法继续操作桌面通信软件。此时可以开启设置后重试，或切换到独立 CUA 任务并明确提供结果文件路径。",[14,247,248],{"id":248},"开始任务",[10,250,251],{},"点击顶部“CUA”，左侧“新建会话”会变为新 CUA 任务。历史记录按当前 CUA 提供方显示；输入区不显示办公模板、Skill（技能）和上下文圆环。",[10,253,254],{},"开始前先打开目标应用或说明从哪个应用开始，关闭无关的敏感窗口，并保持窗口大小、显示器位置和系统缩放稳定。执行时不要同时争夺鼠标和键盘。",[10,256,257],{},"模式按钮用于选择：",[22,259,260,263],{},[25,261,262],{},"快速模式：单模型代理，速度快、成本较低，适合简单稳定流程。",[25,264,265],{},"通用模式：大脑与执行者双模型架构，分析更全面，但速度更慢、成本更高。",[10,267,268],{},"企业版本也可能配置本地 CUA 与云端 SaaS（软件即服务）CUA，具体入口以客户端和管理员策略为准。首次启动本地 CUA 可能需要 1—2 分钟预热。",[14,270,271],{"id":271},"任务怎么写",[10,273,274],{},"任务至少说明目标应用、起始页面、成功标准、允许动作、禁止动作、人工确认点和异常处理方式。",[156,276,279],{"className":277,"code":278,"language":161,"meta":162},[159],"打开浏览器，进入公司内部系统的“我的待办”。\n整理今天到期事项的标题、负责人和截止时间，返回表格。\n只读，不要修改、提交或删除记录。\n遇到登录、验证码、授权、弹窗或页面结构与描述不一致时暂停让我处理。\n",[164,280,278],{"__ignoreMap":162},[14,282,283],{"id":283},"监督和人工介入",[10,285,286],{},"中央时间线显示工作时长、执行模式、模型和每一步动作。点击“查看截图”可以核对该步骤看到的页面；截图可能包含敏感信息，下载后按企业资料要求保存。",[10,288,289],{},"出现连续等待、登录、验证码、Windows 安全页面或用户指定的停止点时，任务会暂停：",[22,291,292,295],{},[25,293,294],{},"继续：用户处理完当前页面后恢复执行；",[25,296,297],{},"结束任务：停止当前任务，不自动撤销已经完成的动作。",[10,299,300],{},"CUA 不绑定 Work\u002FCode 的本地工作目录，因此不显示同样的待办、更改和文件栏。请通过时间线、最终页面和真实系统状态验收结果，不要只看文字总结。提交类流程应停在最终确认页，由用户本人确认。",[14,302,303],{"id":303},"权限与安全",[10,305,306],{},"macOS（苹果桌面操作系统）通常需要辅助功能和屏幕录制权限；Windows（微软桌面操作系统）可能受到安全桌面限制。权限调整后可能需要重启 TuriX 或目标应用。",[10,308,309],{},"登录、验证码、选择账号、第三方授权、面向外部或群聊的发送、发布、支付、删除、覆盖、同意协议和最终提交都应设置为人工介入点。内部低风险发送也应在任务中限定联系人、内容和附件。多显示器场景还要确认目标窗口所在屏幕，执行中不要移动窗口或改变缩放比例。",[10,311,312],{},"“设置 → 控制执行 → 工具访问（Work 和 Code 模式）→ 允许 ComputerUse（GUI 自动化）”控制 Work 和 Code 能否调用图形界面自动化；CUA 专用模式还受系统权限、企业策略和当前 CUA 提供方限制。",[14,314,315],{"id":315},"常见问题",[38,317,318,328],{},[41,319,320],{},[44,321,322,325],{},[47,323,324],{},"现象",[47,326,327],{},"检查与处理",[57,329,330,338,346,354,362,370,378,386],{},[44,331,332,335],{},[62,333,334],{},"首次启动长时间无动作",[62,336,337],{},"等待 1—2 分钟预热；确认网络、模型服务与客户端版本",[44,339,340,343],{},[62,341,342],{},"看不到或点不到界面",[62,344,345],{},"授予屏幕录制或辅助功能权限；让窗口可见且无遮挡",[44,347,348,351],{},[62,349,350],{},"点击位置偏移",[62,352,353],{},"恢复系统缩放，固定窗口大小，确认目标显示器",[44,355,356,359],{},[62,357,358],{},"无法输入",[62,360,361],{},"手动聚焦目标控件后继续，并检查辅助功能权限",[44,363,364,367],{},[62,365,366],{},"连续等待",[62,368,369],{},"检查弹窗、加载状态或登录步骤，再选择继续或结束",[44,371,372,375],{},[62,373,374],{},"Windows 安全页面拦截",[62,376,377],{},"用户手动处理安全弹窗，再继续",[44,379,380,383],{},[62,381,382],{},"操作了错误窗口",[62,384,385],{},"立即停止，核对是否产生写入，再从明确起点重开任务",[44,387,388,391],{},[62,389,390],{},"Work\u002FCode 无法调用界面",[62,392,393],{},"打开“设置 → 控制执行 → 工具访问（Work 和 Code 模式）→ 允许 ComputerUse（GUI 自动化）”",[10,395,396,397,402],{},"仍无法解决时，记录客户端版本、操作系统、显示器数量、复现步骤和出错页面，按",[398,399,401],"a",{"href":400},"\u002Fdocs\u002Fsettings\u002Foverview","设置使用指南","中的诊断要求提交。截图前遮盖账号、客户数据和凭据。",{"title":162,"searchDepth":404,"depth":404,"links":405},2,[406,407,408,409,414,415,416,417,418],{"id":16,"depth":404,"text":17},{"id":98,"depth":404,"text":98},{"id":141,"depth":404,"text":141},{"id":171,"depth":404,"text":172,"children":410},[411,413],{"id":179,"depth":412,"text":180},3,{"id":210,"depth":412,"text":210},{"id":248,"depth":404,"text":248},{"id":271,"depth":404,"text":271},{"id":283,"depth":404,"text":283},{"id":303,"depth":404,"text":303},{"id":315,"depth":404,"text":315},"使用 CUA 补足接口和浏览器自动化无法覆盖的桌面流程，并与 Work 配合完成跨应用任务。",[421],"enterprise","md","zh-CN",{},true,"270","\u002Fmanuals\u002Fcua\u002Foverview","desktop","cua",{"title":5,"description":419},"published","manuals\u002Fcua\u002Foverview","2026-07-29T00:00:00.000Z","szjlJzfYePpT10L5uHW4rH1cRk1bIQP9p3TIoBWqfek",[436,441,445,450,454,458,462,466,470,474,479,483,484,488,493,498,502,507,512,516,520,525,529,533,537,540,544,548,552,556,560,564,569,573,577,581,585,589,592,595,599],{"path":437,"title":438,"section":439,"order":440},"\u002Fmanuals\u002Fgetting-started\u002Fintroduction","简介","getting-started","0",{"path":442,"title":443,"section":439,"order":444},"\u002Fmanuals\u002Fgetting-started\u002Foverview","产品概览","10",{"path":446,"title":447,"section":448,"order":449},"\u002Fmanuals\u002Fwork\u002Fpresentations-pdf","实践一：调研 AI 技术趋势并生成分享 PPT","work","130",{"path":451,"title":452,"section":448,"order":453},"\u002Fmanuals\u002Fwork\u002Fprompt-recipes","实践二：批量读取发票并整理明细","140",{"path":455,"title":456,"section":448,"order":457},"\u002Fmanuals\u002Fwork\u002Fresearch","实践三：检索资料并输出研究报告","150",{"path":459,"title":460,"section":448,"order":461},"\u002Fmanuals\u002Fwork\u002Fdocuments","实践四：总结长文档与多份材料","160",{"path":463,"title":464,"section":448,"order":465},"\u002Fmanuals\u002Fwork\u002Fspreadsheets","实践五：清洗表格并完成数据统计","170",{"path":467,"title":468,"section":164,"order":469},"\u002Fmanuals\u002Fcode\u002Foverview","代码模式","180",{"path":471,"title":472,"section":439,"order":473},"\u002Fmanuals\u002Fgetting-started\u002Finstall-sign-in","安装与登录","20",{"path":475,"title":476,"section":477,"order":478},"\u002Fmanuals\u002Fchat\u002Foverview","聊天模式","chat","240",{"path":480,"title":481,"section":439,"order":482},"\u002Fmanuals\u002Fgetting-started\u002Fupgrade","升级与版本确认","25",{"path":427,"title":5,"section":429,"order":426},{"path":485,"title":486,"section":439,"order":487},"\u002Fmanuals\u002Fgetting-started\u002Finterface","认识 TuriX 主界面","30",{"path":489,"title":490,"section":491,"order":492},"\u002Fmanuals\u002Ftemplates\u002Foverview","模板","templates","320",{"path":494,"title":495,"section":496,"order":497},"\u002Fmanuals\u002Fskills\u002Foverview","Skill","skills","380",{"path":499,"title":500,"section":439,"order":501},"\u002Fmanuals\u002Fgetting-started\u002Fchoose-mode","如何选择模式","40",{"path":503,"title":504,"section":505,"order":506},"\u002Fmanuals\u002Fmcp\u002Foverview","MCP","mcp","420",{"path":508,"title":509,"section":510,"order":511},"\u002Fmanuals\u002Fsettings\u002Foverview","设置项","settings","460",{"path":513,"title":514,"section":439,"order":515},"\u002Fmanuals","快速开始","5",{"path":517,"title":518,"section":439,"order":519},"\u002Fmanuals\u002Fgetting-started\u002Ffirst-task","完成第一个任务","50",{"path":521,"title":522,"section":523,"order":524},"\u002Fmanuals\u002Fadministration\u002Foverview","企业后台","administration","550",{"path":526,"title":527,"section":528,"order":524},"\u002Fmanuals\u002Freference\u002Fglossary","术语","reference",{"path":530,"title":531,"section":523,"order":532},"\u002Fmanuals\u002Fadministration\u002Fmembers-departments","组织架构","560",{"path":534,"title":535,"section":523,"order":536},"\u002Fmanuals\u002Fadministration\u002Fdata-statistics","数据统计","570",{"path":538,"title":539,"section":523,"order":536},"\u002Fmanuals\u002Fadministration\u002Fmodels-quota-audit","模型、额度、审计与关键事件",{"path":541,"title":542,"section":523,"order":543},"\u002Fmanuals\u002Fadministration\u002Ftemplate-management","模板管理","580",{"path":545,"title":546,"section":439,"order":547},"\u002Fmanuals\u002Fgetting-started\u002Fsessions-projects-context","会话、项目与上下文","60",{"path":549,"title":550,"section":528,"order":551},"\u002Fmanuals\u002Freference\u002Fpermission-matrix","权限与风险对照表","600",{"path":553,"title":554,"section":528,"order":555},"\u002Fmanuals\u002Freference\u002Ffaq","常见问题与快速处理","610",{"path":557,"title":558,"section":528,"order":559},"\u002Fmanuals\u002Freference\u002Ftroubleshooting","常见问题排除指南","620",{"path":561,"title":562,"section":439,"order":563},"\u002Fmanuals\u002Fgetting-started\u002Fresults","结果查看","70",{"path":565,"title":566,"section":567,"order":568},"\u002Fmanuals\u002Fpersonal\u002Fpricing","定价详情","personal","700",{"path":570,"title":571,"section":567,"order":572},"\u002Fmanuals\u002Fpersonal\u002Fcredits","积分说明","710",{"path":574,"title":575,"section":567,"order":576},"\u002Fmanuals\u002Fpersonal\u002Fplan-management","套餐管理","720",{"path":578,"title":579,"section":567,"order":580},"\u002Fmanuals\u002Fpersonal\u002Finvoices","发票开具","740",{"path":582,"title":583,"section":448,"order":584},"\u002Fmanuals\u002Fwork\u002Foverview","办公模式","80",{"path":586,"title":587,"section":421,"order":588},"\u002Fmanuals\u002Fenterprise\u002Fpricing","企业版介绍","800",{"path":590,"title":571,"section":421,"order":591},"\u002Fmanuals\u002Fenterprise\u002Fcredits","810",{"path":593,"title":575,"section":421,"order":594},"\u002Fmanuals\u002Fenterprise\u002Fplan-management","820",{"path":596,"title":597,"section":421,"order":598},"\u002Fmanuals\u002Fenterprise\u002Fcredit-usage","积分查看","830",{"path":600,"title":579,"section":421,"order":601},"\u002Fmanuals\u002Fenterprise\u002Finvoices","840",[603,607,609,613,617,621,625],{"path":604,"edition":421,"version":605,"publishedAt":606},"\u002Frelease-notes\u002Fenterprise\u002Fdesktop\u002Fv3.10.0","3.10.0","2026-07-31T00:00:00+08:00",{"path":608,"edition":567,"version":605,"publishedAt":606},"\u002Frelease-notes\u002Fpersonal\u002Fdesktop\u002Fv3.10.0",{"path":610,"edition":421,"version":611,"publishedAt":612},"\u002Frelease-notes\u002Fenterprise\u002Fdesktop\u002Fv3.9.1","3.9.1","2026-07-23T00:54:48+08:00",{"path":614,"edition":421,"version":615,"publishedAt":616},"\u002Frelease-notes\u002Fenterprise\u002Fdesktop\u002Fv3.9.0","3.9.0","2026-07-20T11:28:34.689Z",{"path":618,"edition":567,"version":619,"publishedAt":620},"\u002Frelease-notes\u002Fpersonal\u002Fdesktop\u002Fv3.8.1","3.8.1","2026-07-17T01:43:13.288Z",{"path":622,"edition":421,"version":623,"publishedAt":624},"\u002Frelease-notes\u002Fenterprise\u002Fdesktop\u002Fv3.8.0","3.8.0","2026-07-09T15:42:18.149Z",{"path":626,"edition":567,"version":623,"publishedAt":627},"\u002Frelease-notes\u002Fpersonal\u002Fdesktop\u002Fv3.8.0","2026-07-09T15:22:18.013Z",[629,630,631,632,633,634,635],{"path":604,"edition":421},{"path":622,"edition":421},{"path":614,"edition":421},{"path":610,"edition":421},{"path":608,"edition":567},{"path":626,"edition":567},{"path":618,"edition":567},[637,638,639,640,641,642,643,644,645,646,647,648,649,650,651,652,653,654,655,656,657,658,659,660,661,662,663,664,665,666,667,668,669,670,671,672,673,674,675,676,677],{"path":534},{"path":530},{"path":538},{"path":521},{"path":541},{"path":475},{"path":467},{"path":427},{"path":596},{"path":590},{"path":600},{"path":593},{"path":586},{"path":499},{"path":517},{"path":471},{"path":485},{"path":437},{"path":442},{"path":561},{"path":545},{"path":480},{"path":513},{"path":503},{"path":570},{"path":578},{"path":574},{"path":565},{"path":553},{"path":526},{"path":549},{"path":557},{"path":508},{"path":494},{"path":489},{"path":459},{"path":582},{"path":446},{"path":451},{"path":455},{"path":463},1785494093909]