这是 Studio 1.0.2 的手册，不是最新版本。最新版本的手册

常见问题

事情没有照你想的那样走时怎么办。每一节说你看到什么、通常是什么意思、完整的答案在哪一章。都对不上的话，收集诊断信息写信给我们（最后一节）。

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 天的报告在启动时删除。见隐私。

求助

帮助 > 收集诊断信息… 把支持需要的东西放进一个 ZIP 文件，存在“文档”文件夹的 Twinwright Studio\Reports 里：版本、设置（密钥写成 ***）、机床档案、控制器的设置、最近 7 天的审计日志、崩溃报告和授权的状态。现在的程序和装夹 不勾就不放进去。路径、文件名和电脑的用户名都去掉了。

发出去之前先打开看一看；Studio 自己什么也不发。写信的地址在 帮助 > 关于。