文档 用户手册
常见问题
事情没有照你想的那样走时怎么办。每一节说你看到什么、通常是什么意思、完整的答案在哪一章。都对不上的话，收集诊断信息写信给我们（最后一节）。
Studio 打不开
- Studio 要 64 位的 Windows 10 或 11；别的版本上安装包会停下。见系统要求。
- 窗口打开了，三维视图却一直是空的，或者说它用不了：工具 > 设置… > 文件，勾选 软件渲染（显卡出问题时用；下次启动生效），再启动一次 Studio。更新显卡驱动往往能解决根本原因。见三维视图起不来时。
- Studio 在启动时关掉了的话，下次启动会提出那份报告（见Studio 意外关闭）。
机床报警了
报警时，机器栏上的状态变红。栏上写着是哪个报警、什么意思，下一步： 后面是现在该做的事和做这件事的按键；不止一步时，全部步骤 列出回到工作的路。点这个键，或用 机器 > 做下一步：每做完一步，Studio 都重新算一遍。
- 探测移动什么也没碰到，就以 ALARM:5 停下：照步骤做（复位、解锁），再看循环原以为那个面在哪里。
- 移动超出机床行程时会停在软限位：看程序列表里标红的那一行，和运行时用的工件零点。
- 报警之后位置可能不再可信（位置 下面会有一行说明）：切削之前重新回零。
每种情况的步骤：报警和怎么办。所有报警、原因和怎么解除：报警。
程序的某一行回了错误
error: 加一个号，意思是控制器拒绝了那一行：它没有执行，机床也没有为它动。消息里有号码和它的意思。
- 程序 > 检查程序 让整个程序过一遍控制器的检查模式，机床不动，并列出它拒绝的头几行：“第 5 行：error:22（…）”。改好这些行，再查一遍。
- 最常见的原因：控制器不认的代码；缺了字（圆弧没有圆心或半径，切削移动之前没有
F）；同一行里有不能放在一起的两个代码。
所有错误和原因：错误。
程序检查发现问题
编辑器在你打字时、载入时和运行之后检查程序。每条发现写在它那一行下面，带规则号和类别：错误、警告或提示。
- 错误 是控制器会拒绝的行，或者装夹承受不了的移动；运行之前先改。
- 警告 是能运行、但未必是你想要的行：在工件顶面以下快移；启动主轴没给
S；换刀之后还没到起点上方就往下走。 - 检查里的预览部分要机床已上电、已回零、没有程序在运行；在那之前它会等着。
规则和怎么改：程序检查。在孪生里运行还会查什么：孪生查什么。
探测循环开不了
测头卡上有一项检查是红的，或者缺了什么，开始探测… 就是灰的；按键下面那一行会说缺什么（给出 X 和 Y、给出环规直径、等正在进行的调用结束）。
- 主轴上没有测头：在 准备 的 对刀 一步选测头，点 换刀。
- 主轴在转：先停（主轴停，F11）。
- 毛坯上方没有横移的空间：那一行给出 Z 在顶时测头尖的高度、装夹的顶面和差多少。换短一点的测头，或者把毛坯夹低一点：用压板或双面胶代替平口钳。
- 孪生在跟随一台真机：到真机上用它自己的控制来探测。
- 循环什么也没碰到时以 ALARM:5 停下（见机床报警了）。
见循环停下时。
授权和激活
帮助 > 授权… 显示现在用的版本、授权的状态和到期时间。
- 在线激活：照收到的样子输入激活码；读得通时 激活 才能点。服务器的回答显示在它下面。回答是授权已在太多电脑上、已到期、已暂停、未付款或已退款时，打开授权网页 会打开官网上的授权页：在那里释放电脑、续期或管理订阅。
- 没有网络：同一个对话框里有离线的步骤。Studio 给出请求码；在一台能上网的电脑上，到授权网页为它取授权文件，再回来导入。
- 订阅没有续上时，还能照常用 14 天（授权显示 宽限中）。之后，或者授权到期时，Studio 回到学习版；项目和程序不受影响。
AI 助手不回答
- 输入框下面那一行说助手正在做什么（等服务回答、孪生在执行一个工具）。
- 查 提供方、地址 和 模型；云服务还要查密钥保存了没有（保存密钥）。
- 本地模型要它的服务器在运行（LM Studio 的服务器、Ollama），并且选好了模型（列出模型）。
- 回答可能要一会儿；停止 可以结束它。
- 第一次给云服务发消息时会先等你：Studio 列出这次要发给它的东西，你同意以后才发（每个云服务只问一次）。改用本机模型… 能让一切都留在这台电脑上。见隐私。
- AI 想改动窗口里的机器时，窗口底部会有一条栏问你。60 秒内没有回答，就当拒绝。
见AI 助手。
Studio 意外关闭
下次启动时，Studio 问你怎么处理那份记录了经过的报告：打开它所在的文件夹，或另存为文件。什么也不发出。报告里不含程序、文件和文件夹的名字、密钥、激活码和人名；超过 30 天的报告在启动时删除。见隐私。
求助
帮助 > 报告问题… 把出的问题、不知道怎么用的地方或者建议发给同匠的支持。写清楚你做了什么、期望什么、实际看到什么；想让回复也发到邮箱就填上邮箱。自动带上、对话框里写明的（看全文… 能看完整的）：版本和构建号、版本档位、系统和它的语言、屏幕，还有审计日志最后 50 条的摘要——做了什么、结果如何，不带程序内容，你的用户文件夹写成 ~。附上诊断包 和 附上窗口截图 打开时都不勾，不勾就不发。按 发送 之后对话框里写工单号（例如 TW-1042）。没连上网时报告存成一个文件 problem-<时刻>.zip，在“文档”文件夹的 Twinwright Studio\Reports 里：能上网时在对话框里再发一次，或者在官网支持页上传。存成文件… 只存不发。
AI 客户端可以替你起草（report_draft）：打开的是同一个对话框，带着它写的话，还有一行写明是哪个客户端起草的。你看一遍，哪里都能改；只有你能发，诊断包和截图也只有你能勾。
帮助 > 我的问题 列出从这台电脑发出的报告：工单号、状态（已收到、处理中、已回复、已解决）、最后一次变动的时间；有没读的回复时前面一个点。选中一个看来回的对话；补充一句… 往同一个工单里再写（附上诊断包… 把诊断包一起附上）。回复在客户中心的“我的工单”里也看得到。有没解决的报告时，Studio 每 30 分钟问一次有没有新回复，帮助菜单上写有几条新的；设置 > 常规 > 每 30 分钟看一次我的问题有没有新回复 可以关掉。发什么、存多久：见 隐私。
帮助 > 收集诊断信息… 把支持需要的东西放进一个 ZIP 文件，存在“文档”文件夹的 Twinwright Studio\Reports 里：版本、设置（密钥写成 ***）、机床档案、控制器的设置、最近 7 天的审计日志、崩溃报告和授权的状态。现在的程序和装夹 不勾就不放进去。路径、文件名和电脑的用户名都去掉了。
发出去之前先打开看一看；这个文件不会自己发出去（报告只在你勾了 附上诊断包 时才带上它）。写信的地址在 帮助 > 关于。