这是 Studio 1.1.0 的手册，不是最新版本。 最新版本的手册
文档 1.1.0 运维手册
预览：这一页的安全提示还没有经过母语审校。
隐私和 Studio 发出的东西
Studio 在你的电脑上工作。Studio 自己发出去的，只有开始试用、激活和续期付费授权要用的东西：没有遥测，不自己查新版本，不自动上传崩溃信息。你把 AI 助手接到云服务时，你的消息和附上的内容会发给那家服务，见AI 助手和云服务。这一章列出发出去的、留在电脑上的，以及怎么删掉。以官网的隐私政策 twinwright.com/zh/privacy 为准。
Studio 发出什么
| 什么时候 | 发给谁 | 发什么 |
|---|---|---|
| 你开始试用一个付费档 | 同匠的授权服务器，走 HTTPS | 所试用的版本档、这台电脑指纹的散列、Studio 的版本 |
| 你激活付费授权 | 同匠的授权服务器，走 HTTPS | 激活码、这台电脑指纹的散列、Studio 的版本 |
| Studio 续期付费授权（见续期） | 同匠的授权服务器，走 HTTPS | 授权编号、同一个散列、Studio 的版本 |
Studio 自己发给同匠的就这些。指纹本身不离开电脑，离开的只是它的散列。离线激活的电脑什么都不发。
下面三样只在你自己设了以后才会发出去：
- 接到云服务的 AI 助手：把你的消息和附上的内容发给那家服务，见下面。
- 你经 MCP 接的 AI 客户端，比如 Claude、ChatGPT：客户端把它从孪生读到的东西发给它自己的服务，按它的条款处理。
- Studio 打开的网页，比如授权网页：由你的浏览器打开，Studio 不往里加任何东西。
AI 助手和云服务
AI 助手用你在里面选的提供方：云服务（比如 Anthropic、OpenAI、DeepSeek），用你自己的账户和 API 密钥；或者本机模型。
你给云服务发消息时，Studio 从你的电脑、用你的密钥，把这些发给那家服务：
- 你的消息，连同到这时为止的对话；
- 勾着 附上窗口现在的程序、装夹和检查结果（有变化时） 时：窗口里的机床、装夹、带行号的程序和检查发现的问题。这一项一开始就是勾着的。Studio 随第一条消息附上它们，以后只在它们变了时再附；
- 助手在 Studio 里调用工具得到的结果，比如程序的检查或仿真、机床的状态、日志里的记录；对接受图片的服务，还有结果的图。
第一条消息发往云服务之前，Studio 会提示一次要发什么。
这些都按那家服务自己的条款处理；同匠收不到其中任何东西。想少发：发送前去掉勾，或者按 新对话 重新开始。
用本机模型（LM Studio、Ollama）时，这些都留在电脑上。
在这台电脑上，审计日志记下每条消息的前 180 字节（见审计日志），API 密钥加密保存（见Studio 在电脑上留什么）。
Studio 在电脑上留什么
| 什么 | 在哪儿（Windows） | 谁能看到 |
|---|---|---|
| 设置、孪生的状态、AI 密钥 | %LOCALAPPDATA%\Twinwright\Studio | 你的 Windows 账户 |
| 程序版本 | 文档\Twinwright Studio | 你的 Windows 账户 |
| 审计日志 | 文档\Twinwright Studio\logs，设置里另指了文件夹的除外 | 你的 Windows 账户 |
| 检验报告、装夹单、诊断信息文件 | 文档\Twinwright Studio\Reports | 你的 Windows 账户 |
| 意外退出的报告 | %LOCALAPPDATA%\Twinwright\Studio\crash，30 天后删掉 | 你的 Windows 账户 |
| 授权文件（含试用） | %ProgramData%\Twinwright\licence | 这台电脑上的每个人 |
AI 密钥按你的 Windows 账户加密保存（Windows DPAPI），同一台电脑上的别的账户读不到。
审计日志
审计日志每天一个文件 audit-YYYY-MM-DD.jsonl，在日志文件夹里。它记下：
- AI 和你让机器做过的事；
- AI 面板里每条消息的前 180 字节；
- 授权核验：授权编号、档位和结果，不记持有人的名字。
密钥、令牌、密码一律记成 ***。记多少、留多久在设置里定。日志只在你的电脑上，Studio 从不上传。
Studio 意外关闭时
出事的那一刻，Studio 写一份很小的报告：在哪儿出的错、出错前的调用顺序、程序的模块表。不写内存里的内容。
下次启动时，Studio 加上版本信息和日志的最后 200 行，先清洗一遍：
- 路径和文件名换成占位；
- 名字和电子邮箱去掉；
- 不带 G 代码、AI 对话、授权码和电脑指纹。
然后问你一次：可以打开报告所在的文件夹、把报告存成文件，或者关掉提示。什么都不发出。想帮我们查原因，就自己把文件发到 hello@twinwright.com。
诊断信息
找我们帮忙时，我们可能请你给一份诊断信息。在 帮助 菜单里选“收集诊断信息”。Studio 把你勾选的几项存成一个 ZIP 文件，放进报告文件夹：
| 项目 | 默认勾选 |
|---|---|
| 版本、系统、显卡、语言和单位 | 是 |
| 设置，不含 AI 密钥 | 是 |
机床档案和控制器的 $ 设置 | 是 |
| 最近 7 天的日志和意外退出的报告，按上面的办法清洗过 | 是 |
| 授权状态：档位和到期日，不含授权码和电脑指纹 | 是 |
| 现在的程序和装夹：你的零件数据 | 否 |
发出去之前，先打开文件看一遍。什么都不会自动发出。
网络上谁在听
Studio 给 AI 客户端（MCP）和发送软件开的服务只在这台电脑上听（127.0.0.1），别的电脑连不上。
命令行参数 --bind any 会把孪生的网络端口（比如给发送软件的那个）开给你的网络；MCP 服务仍然只在本机。
⚠ 警告
影子模式下，发送软件的端口会把命令转给真机。用了 --bind any，你网络上任何能连到这个端口的人都可能让机器动起来。只在孪生上、只在你自己管的网络里用 --bind any。
我们的服务器留什么
对每份付费授权，授权服务器留下：
- 每个席位最多三台电脑的散列，以及每台第一次和最后一次出现的日期，好让你在授权网页上释放一台；
- 激活码只存散列，连我们自己也读不出来；
- 试用、激活、续期和授权变动的日志，留 90 天：电脑的散列、Studio 的版本、截到网段的 IP 地址。
每次试用，服务器留下这台电脑的散列、版本档和试用的起止日期，这样每台电脑每档只能试用一次。
和你的工作有关的东西，一样都到不了服务器。
删掉 Studio 留下的东西
- 在授权网页上释放这台电脑，让它不再占名额（见把授权换到另一台电脑）。
- 卸载 Studio。
- 删掉上面表里你不再需要的文件夹。结果：电脑上不再留有 Studio 的任何东西。
卸载只删程序，不删你的文件：项目、程序版本、日志和报告都留着，等你自己删。