文档运维手册

你的数据和备份

Studio 把你的工作放在你的文档里，机器的状态放在它自己的文件夹里。这一章列出什么放在哪里、该备份什么，以及怎么搬到另一台电脑。

什么在哪儿

有两个文件夹放着所有属于你的东西：

Documents\Twinwright Studio：你的工作；
%LOCALAPPDATA%\Twinwright\Studio：程序自己的状态。

作业、程序和它们的版本

Documents\Twinwright Studio\programs\<program>\ 里，程序的每个版本一个文件（v0001.nc），另有一个说明文件（v0001.json），记着它是什么时候、由谁、为什么保存的。做出这个程序的 CAM 作业也按版本存在它旁边（job-v0001.json）。Studio 从不清理它们。

工具 > 设置… > 文件 可以把程序文件夹放到别处（下次启动生效）。

报告

Documents\Twinwright Studio\Reports\：检验报告（PDF 和 CSV）、装夹单（HTML）和诊断信息（ZIP）。

机器和它们的世界

每台机器在状态文件夹里有一个世界：工作台、带着切痕的工件、刀具和刀具表、工件坐标、控制器的设置、温度、运行小时数和测头的标定。你工作时，机床每次有变化后静止满两秒，Studio 就写入它一次；关闭窗口时再写一次。第一台机器的世界在 world\ 里，其他机器的在 machines\<id>\world\ 里。

设置

状态文件夹里的 settings.json 放着 工具 > 设置… 里的全部内容；window.json 放窗口的位置和大小。

审计日志

Documents\Twinwright Studio\logs\ 里每天一个文件（audit-YYYY-MM-DD.jsonl）。记录是链在一起的，所以校验日志时（工具 > 设置… > 日志 > 校验完整性），改动或缺口都会显出来。默认日志保留 180 天、最多 2 GB；工具 > 设置… > 日志 可以改。要让链保持完整，就复制整个文件夹。

备份什么

先关闭 Studio，再复制这两个文件夹：Documents\Twinwright Studio 和 %LOCALAPPDATA%\Twinwright\Studio。

有两样东西不会随复制一起搬走：

AI 服务的密钥：它们是按这台电脑上你的 Windows 账户加密的。到新电脑上重新输入；
授权：它属于电脑。到新电脑上重新激活（见授权）。

搬到另一台电脑

在旧电脑上关闭 Studio，复制这两个文件夹。
在新电脑上安装 Studio，启动一次，再关闭。
把这两个文件夹复制到新电脑上同样的位置。
你在设置里挪过程序文件夹或日志文件夹的话，检查这些文件夹是否存在。
启动 Studio，激活授权，重新输入 AI 密钥。
重新连接你的 AI 客户端（AI > 连接 AI 客户端…）。

让一台机器从头开始

恢复出厂把窗口里的机床恢复成刚来时的样子：它的世界没了（工件、刀具、工件坐标、控制器的设置、测头的标定），Studio 重新启动。

选 文件 > 恢复出厂…（技师级别及以上）。
5 秒内再选一次来确认。

只重置这一台机器。你的程序、报告、审计日志、设置和其他机器都保留。重置会记进审计日志。