安装和卸载

怎么安装同匠 Studio，怎么静默地在很多台电脑上同时安装，什么文件放在哪儿，以及怎么卸载。

Linux 见在 Linux 上。

安装

运行 TwinwrightStudio-<version>-setup.exe。
阅读许可协议，单击 我接受。
保持默认的文件夹（%LOCALAPPDATA%\Programs\Twinwright Studio），或另选一个。
在最后一页，选择是否启动 Studio，以及是否在桌面上放一个快捷方式。

安装程序有英文和中文两种界面，跟随系统的语言。

只给你装，还是给这台电脑上的每个人装

安装程序为运行它的那个人安装 Studio。它不需要管理员权限，开始菜单里的项和桌面快捷方式属于那个人。电脑上每个要用 Studio 的人，各自安装一次。

授权属于电脑，不属于个人：电脑上的每个用户共用它（见授权文件夹）。

Studio 不改文件关联，不改 PATH，不改防火墙设置，也不安装服务。

静默安装

TwinwrightStudio-<version>-setup.exe /S [/DESKTOP] [/D=<folder>]

/S 不显示安装页面，也不启动 Studio。
/DESKTOP 加上桌面快捷方式。
/D= 指定文件夹。它必须是最后一个参数，不加引号，即使文件夹名里有空格。

要静默卸载 Studio：在程序的文件夹里运行 uninstall.exe /S。

什么放在哪儿

什么	在哪儿
程序	`%LOCALAPPDATA%\Programs\Twinwright Studio`
你的工作：程序、版本、报告、审计日志	`Documents\Twinwright Studio`
程序自己的状态：设置、机器、AI 密钥	`%LOCALAPPDATA%\Twinwright\Studio`
授权	`%ProgramData%\Twinwright\licence`

程序的文件夹

里面有 TwinwrightStudio.exe、手册（manual\）、README.txt、THIRD-PARTY-NOTICES.txt 和 uninstall.exe。更新时这个文件夹不变，所以你连过的 AI 客户端照常能用。

你的文档

Documents\Twinwright Studio（Windows 给你的“文档”文件夹，改到别处也一样）：

programs\：每个程序的各个版本，和 CAM 作业的各个版本；
Reports\：检验报告、装夹单和诊断信息文件；
logs\：审计日志。

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

程序自己的状态

%LOCALAPPDATA%\Twinwright\Studio：设置、窗口的位置、每台机器的“世界”（它的工件、刀具、偏置和控制器设置）、AI 服务的密钥（按你的 Windows 账户加密），以及意外退出的报告（保留 30 天）。

授权文件夹

%ProgramData%\Twinwright\licence 放着授权文件（含试用），电脑上的每个用户都用它。Studio 在第一次激活或试用时建这个文件夹。Studio 写不进去的话，管理员可以把文件夹建好，并让用户能往里写。

特殊的配置里，这些环境变量可以挪动文件夹：

变量	挪动什么
`TWINWRIGHT_STATE_DIR`	程序自己的状态
`TWINWRIGHT_WORKDIR`	存放程序版本的文件夹
`TWINWRIGHT_LOGDIR`	审计日志
`TWINWRIGHT_LICENCE_DIR`	授权文件夹

更新到新版本

关闭 Studio，再运行新版本的安装程序。它装进同一个文件夹；你的工作、设置、机器和授权都保持原样。Studio 自己不检查更新（见更新 Studio）。

如果还有一份 Studio 在后台运行（可能是 AI 客户端启动的），安装程序会把旧的程序文件挪到一边，在下一次更新或卸载时删掉它。

卸载

在 Windows 里用 设置 > 应用 > 同匠 Studio > 卸载，或者在程序的文件夹里运行 uninstall.exe。

卸载后留下什么

卸载会删掉程序、它的快捷方式和它在应用里的条目。下面这些会留下：

你的工作，在 Documents\Twinwright Studio 里；
程序自己的状态，在 %LOCALAPPDATA%\Twinwright\Studio 里；
授权文件夹；
你连过的 AI 客户端的设置里的 twinwright 条目。

要全部清除，请手动删掉它们。删掉授权文件夹不会把试用还给你：授权服务器给每台电脑每档只发一次试用。

在 Linux 上

安装

Linux 版 Studio 是一个文件，一个 AppImage。系统里什么也不装。

核对文件：sha256sum TwinwrightStudio-<version>-x86_64.AppImage 的结果要和下载页上的 SHA-256 一致。

把它放到能一直放着的地方，名字里不带版本号，这样更新以后你连接的 AI 客户端照样能用；再加上可执行权限：

 mkdir -p ~/Applications
 mv TwinwrightStudio-<version>-x86_64.AppImage ~/Applications/TwinwrightStudio.AppImage
 chmod +x ~/Applications/TwinwrightStudio.AppImage

启动：~/Applications/TwinwrightStudio.AppImage，或者在文件管理器里双击它。

AppImage 需要 FUSE 2。如果因为缺它启动不了，就装上（Ubuntu 24.04 及以后：sudo apt install libfuse2t64），或者改用 .tar.gz：解压到任何地方，启动文件夹里的 TwinwrightStudio。

Linux 上什么文件放在哪儿

什么	在哪儿
程序，连同手册	那个 AppImage，你放在哪儿就在哪儿
你的工作：程序、版本、报告、审计日志	`~/Documents/Twinwright Studio`
程序自己的状态：设置、机床	`~/.local/state/twinwright/studio`（设了 `$XDG_STATE_HOME` 时在它下面）
AI 服务的密钥	桌面的密钥环；没有密钥环时，是状态文件夹里一个只有你能读的文件
授权	`/etc/twinwright/licence`，或 `~/.local/share/Twinwright/licence`

你的账户能建或者能写授权文件夹时，它属于这台电脑，每个用户共用。否则 Studio 把授权放在 ~/.local/share/Twinwright/licence（设了 $XDG_DATA_HOME 时在它下面）：只给你用，而且仍然只在这台电脑上有效。要让这台电脑的所有用户共用一份授权，用 sudo install -d -m 1777 /etc/twinwright/licence 建一次这个文件夹。

Linux 上的试用和激活

试用、激活和续期和 Windows 一样联网进行，用的是系统自己的 libcurl。没有 libcurl 或者没有网时，离线激活（见授权）。

在 Linux 上更新和卸载

更新：退出 Studio，用新的 AppImage 替换旧的，名字不变（见上面第 2 步）。卸载：删掉那个 AppImage。两种做法都会留下你的文档、状态文件夹、授权文件夹、密钥环里的密钥，以及你连接过的 AI 客户端设置里的 twinwright 一项；要全部清掉，手动删除这些。