这是 Studio 1.0.2 的手册，不是最新版本。 最新版本的手册
文档 1.0.2 用户手册
预览：这一页的安全提示还没有经过母语审校。
连真机
_草稿（第 14 轮）：正文在写，各节还会补。_
用真机的两种做法
- 用你自己的发送软件（bCNC、gSender 或 Universal G-code Sender）经 USB 口开 MC-1。见发送软件。
- 让孪生在旁边跑影子模式（预览）：你的发送软件连 Studio 而不连机床，Studio 把每一行转给机床，在孪生里跑同样的行，并比较两边。
用 Studio 自己把程序发给真机，1.0 里没有。
影子模式（预览）
说明
1.0 里的影子模式是预览，从命令行启动。它只用第二个孪生顶替机床测过，还没接过真机。窗口里还没有地方选串口、连接、看比对结果，以后的版本加。
启动影子模式
要先有：MC-1 开着、用 USB 接到这台电脑；装好你的发送软件。
- 找到机床的端口。Windows 上：设备管理器 > 端口（COM 和 LPT），例如 COM5。
- 在命令提示符里带着这个端口启动 Studio：
TwinwrightStudio.exe --shadow COM5
结果：Studio 打开这个端口，孪生跟着机床走。
- 在你的发送软件里，连 Studio 的发送端口
localhost:2323，不连机床。结果：你的发送软件发的行经 Studio 到机床，孪生跑同样的行。
Studio 的发送端口只对本机开放。要从别的电脑连，再加 --bind any。
孪生比什么
- 应答，逐行：每一行的
ok或错误，以及报警的先后。 - 路径：机床报的位置对孪生的路径，孪生领先或落后多少。
- 设置：机床连上之后、你的发送软件连上之前比一次。所以等 Studio 连上机床，再连你的发送软件。
- 控制器：和设置一起比一次。两边是不是同一种固件；两边都是同匠自研内核时，再比它的版本和机床板子上有什么：主轴、编码器、手轮、轴、测头、连接方式。孪生没有建模板子的辅助口和 SD 卡：比对会列出它们，但不算不同。
- 程序各段的用时。
守护
启动 Studio 时再加 --shadow-guard，孪生会在你的发送软件发的每一行到机床之前先检查它。孪生预计会撞时，就把这一行拦下，让机床进给保持。窗口里在 诊断 下面显示守护的状态。
什么到不了机床
影子模式下，到得了机床的只有你的发送软件发的行，和孪生自己的、不改变任何东西的问话（设置和状态）。
- 窗口里的操作只作用在孪生上；会让机床动或启动的，在孪生跟着机床时一律拒绝。测头面板是锁着的。
- AI 客户端只能读：它看得到机床的状态，什么都不改。
- 接在 Studio 上的外接手轮只作用在孪生上。
⚠ 警告
影子模式下，窗口里的停止和急停停不了机床。要停机床，用它自己的急停，或你的发送软件的停止。
发送软件
和同匠自研内核一起测过的发送软件，以及怎么设：发送软件。
不一样的时候
出现不同，说明孪生的档案或设置不是这台机床的，或者机床做了模型没有的事。先查设置：比对会列出不同的那几项。