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

AI 助手

AI 可以用和你一样的工具在孪生上干活：装夹、写程序、检查程序，并在仿真里运行它们。你可以和 Studio 自带的助手对话，也可以连接 Claude 桌面版这样的 AI 客户端。凡是会改动窗口里那台机床的，都要等你同意。AI 不属于任何安全功能。

打开 AI

新装的 Studio 里，AI 是关着的。要打开它，用下面任何一种办法：

点顶栏里 AI 的状态（AI：关），选 窗口的 AI 开关；
工具 > 设置… > AI 与 MCP：AI 开关，然后点确定；
在助手里发一条消息：这会把开关打开。

Studio 记着你离开时开关的样子，下次启动照此。AI 菜单（AI 助手…、AI 活动…、连接 AI 客户端…）从操作员级别起显示。

开关关着时，AI 客户端仍然可以在后台使用练习机，但不能用你窗口里的机床。

AI 服务和它的密钥

助手和你选的一家 AI 服务对话，用你自己的账号：

Anthropic（Claude）、OpenAI、DeepSeek、通义千问（阿里云百炼）、Kimi（月之暗面）、智谱 GLM；
LM Studio（本机） 或 Ollama（本机）：你自己电脑上的模型，不用密钥；
其他兼容 OpenAI 的接口：任何带 OpenAI 兼容接口的服务，地址由你填。

设置办法：

打开 AI > AI 助手…
选 提供方。Studio 会填上它的地址。
把你的密钥粘贴到密钥里，点 保存密钥。结果：密钥加密存在这台电脑上。在 Windows 上，只有你的 Windows 账户能读它。在 Linux 上它存进桌面的密钥环（Secret Service：GNOME 密钥环、KWallet）；没有密钥环时，用一个只有你的用户账户能读的文件里的密钥加密，密钥下面那行会写明。
点 列出模型，选一个模型。

Studio 不把密钥写进它的设置、注册表或审计日志。要删除已保存的密钥，把框清空，再点 保存密钥。

说明

发给 AI 服务的内容，会用你的账号、按那家服务的条款发到那里：你的消息；附上窗口现在的程序、装夹和检查结果 打开时，还有程序、装夹和检查结果；以及 AI 所用工具的结果。要让一切都留在你的电脑上，用本机模型。

第一次往某个云服务发消息之前，助手会说一次会发出什么。点发送接着发，或者点 改用本机模型… 换成 LM Studio，消息留在输入框里。工具 > 设置… > AI 与 MCP 列出你已同意发送的云服务；点 重新询问，助手会再问一次。

助手面板

AI > AI 助手… 在单独的一个窗口里打开助手。

在下面的框里输入。Enter 发送；Shift+Enter 换行。停止停下回答。
附上窗口现在的程序、装夹和检查结果（有变化时） 在每条消息里把你窗口里的内容交给 AI。默认是打开的。
对话里显示 AI 用的每个工具，成功了标 ✓，没成功标 ✗。
AI 做的图（工件、刀路、与零件的偏差、对比）出现在对话里。双击一张图可以放大或另存。
新对话 重新开始。关闭 Studio 时，对话不会保存。

关闭这个窗口只是把它隐藏；对话保留到你退出为止。

AI 能做和不能做的

开关打开时，AI 能：

读各台机器的状态，并回零、解锁、点动、发送几行 G 代码；
设好毛坯、刀具、工件零点和对比用的零件，探测和检验；
检查、仿真、优化、生成、编辑和载入程序，开始或重新开始一次运行；
读各次运行和它们的结果，比较它们，并为它们作图；
读审计日志和授权的状态。

属于付费档位的工具（检验、报告、排料、优化）只在那一档里能用。

AI 不能改 Studio 的设置、语言、单位、界面级别、AI 开关、Studio 问你的方式、授权和审计日志。

改动机床之前先问

AI 改动窗口的机床之前（在顶栏里 AI 的菜单中，以及 工具 > 设置… > AI 与 MCP 里）有两个选项：

每次都问我（默认）；
不问（AI 直接操作窗口）。

AI 要改动窗口里的机床时（移动机床、上电、松开急停、载入或运行程序、改装夹或刀具），机床条上方会出现一条栏。栏里写着是哪个 AI 在问、它想做什么，并在倒计时。

读这个问题。
点同意或拒绝。Enter 不算回答：用鼠标，或按 Tab 移到按键上，再按 Space。

60 s 内没有回答，就算拒绝。一次同意，两分钟内也涵盖这个动作自己的后续请求。

AI 停止机床、让机床进给保持、复位机床、按急停，或者只是读取时，Studio 从不先问。练习机和 AI 用来仿真的隐藏副本也不问。

连真机时只读

窗口里的孪生跟着一台真机时（影子模式，1.0 里是预览；见连真机），AI 只能读取和分析。它不能移动机床、改机床的装夹或工件坐标、在那里运行程序，而且不会来问：Studio 直接拒绝这些请求。练习机照常工作。

AI 活动

AI > AI 活动… 显示 AI 客户端在这台电脑上做的事：

后台机器：AI 用的练习机，你在窗口里看不到它们（“window”是你窗口里的那台机器）；
运行：最近 16 次仿真和优化；
连着的 AI 客户端：谁连着、怎么连的，以及它们最后一次调用。

在这里可以停止一次运行、看一次运行的图、关掉一台后台机器，以及停止或启动孪生机主机。孪生机主机是管着练习机的后台程序。AI 客户端一连上，它就启动；没人用满 30 分钟，它就退出。

停靠区的 AI 活动 页列出 AI 对窗口里那台机床的调用：时间、调用、机器、谁和结果。

连接别的 AI 客户端（MCP）

支持 MCP（Model Context Protocol）的 AI 客户端可以使用 Studio 的工具。

打开 AI > 连接 AI 客户端…
点你的客户端：Claude 桌面版、ChatGPT 桌面版（Codex、Work 模式）、Cursor、VS Code（GitHub Copilot） 或 LM Studio（本机的开源模型）。结果：对 Claude 桌面版和 ChatGPT 桌面版，Studio 先显示它要对客户端的设置做的改动，你点确定之后才去做；客户端原来的文件留在它旁边。其他客户端会打开各自的安装页。
完全退出这个客户端，再重新打开。
在 Studio 里打开 窗口的 AI 开关。

别的客户端，用 其他客户端：复制配置 把配置复制下来，粘贴到客户端里。客户端在后台启动 TwinwrightStudio.exe --mcp；命令和配置 显示确切的命令。

只接受网址的客户端

只接受网址的客户端，要在 AI 菜单里打开 本机网址（HTTP，给只接受网址的客户端），再用 复制本机网址（HTTP）。这个网址只在这台电脑上有效，还要带上随它一起的令牌。换一个新令牌 会让旧令牌失效。

各个工具、它们的参数和结果：MCP 工具。

记下了什么

工具 > 审计日志…（Ctrl+L）记录 AI 做的事，AI 的名字写在谁这一列里。把 谁做的 筛选成 AI，就只看 AI 的记录；双击一次调用，把它的所有记录放在一起看。

在默认的标准级别下，日志记下：

AI 开关的打开和关闭，以及 Studio 询问方式的改变；
每个问题、你的回答，以及 AI 对窗口里那台机床做的每个动作；
每次工具调用，附带参数的简短形式；
客户端连上和断开；
助手的消息：摘要里记前 180 字节，记录里最多 2000 字节。

密钥、令牌和密码一律写成 ***。