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

文档 1.1.0 / 运维手册

系统要求

运行同匠 Studio 的电脑要什么，三维视图对显卡要什么。

Windows

• 64 位的 Windows 10 或 Windows 11（x64）。在其他版本上，安装程序会停止。
• 不用再装别的东西：Studio 是一个程序文件，只用 Windows 自带的库。

Linux

• x86-64 上的 Linux，glibc 2.38 或更新：Ubuntu 24.04、Debian 13、Fedora 39 及以后的版本，以及基于它们的发行版。
• 有 X11 或 Wayland 的桌面。
• AppImage 需要 FUSE 2（Ubuntu 上是 libfuse2t64 包）。没有的话，用 .tar.gz。
• 联网激活和试用：要有 libcurl（Ubuntu 上是 libcurl4t64 包，桌面系统一般都有）。没有的话，Studio 用离线激活。
• AI 服务的密钥：存在桌面的密钥环里（Secret Service：GNOME 密钥环或 KWallet）。没有密钥环时，Studio 把密钥存在一个只有你能读的文件里。

显卡

三维视图用 Direct3D 11，任何有它的显卡或集成显卡都行（功能级别 10.0 或更高）。没有的话，Studio 用 Windows 的软件渲染器（WARP）来画：能用，但视图较慢（每秒最多 30 帧），而且没有刀具特写。

帮助 > 关于 在 显示 下面显示 Studio 用的是哪一种。

三维视图起不来时

没有三维视图，窗口的其余部分照样能用。如果视图一直是空的，或提示它不可用：

1. 打开 工具 > 设置… > 文件。
2. 勾选 软件渲染（显卡出问题时用；下次启动生效）。
3. 关闭 Studio，再重新启动。

更新显卡驱动常常能消除原因。

Linux

在 Linux 上，三维视图用 OpenGL 4.1 或更高版本：近十年的显卡用 Mesa 驱动都有。没有显卡驱动时，Mesa 的软件渲染器也能画，只是慢一些；想试软件渲染，就从终端启动 Studio，在程序名前面加 LIBGL_ALWAYS_SOFTWARE=1。

内存和磁盘

• 内存：8 GB 或更多。
• 磁盘：程序和它的手册约 62 MB，再加上放你的数据的空间。你的数据会越用越多：审计日志默认保留 180 天、最多 2 GB（工具 > 设置… > 日志），每个程序版本和报告都会保留（见你的数据和备份）。

屏幕和缩放

• 至少 1280 × 720；Studio 的版面按 1600 × 1000 及更大的屏幕设计。
• 任何显示缩放比例都行。Studio 跟随每块屏幕的缩放比例，把窗口移到另一块屏幕上，它会重新缩放。

连真机

在 1.0 里，连真机是预览功能，从命令行连（见连真机）：用串口（USB），波特率 115 200，或者连网络上的控制器。

Studio 这样使用网络：

• G 代码发送软件连到这台电脑上的孪生，端口 2323；
• 浏览器视图用这台电脑上的端口 8765；
• 用地址连接的 AI 客户端使用这台电脑上的端口 8766，在你把它打开时；
• 在线激活和续期连到授权服务器。

Studio 的端口只在这台电脑上监听：别的电脑连不上。

在 Linux 上，串口属于 dialout 组：把你的账户加进去一次（sudo usermod -aG dialout $USER），再重新登录。