连接器客户端

connector/README.md

@@ -5,12 +5,16 @@
 ## 使用方法
 
 1. 正常安装、激活 Spine。
-2. 使用 `release/connector/` 中的独立版时，macOS 双击 `启动Spine连接器.command`；Windows 双击 `启动Spine连接器.bat`。独立版已内置运行环境，不需要安装 Node.js。
+2. 使用 `release/connector/` 中的桌面版时，macOS 打开“Spine粒子连接器.app”，Windows 打开“Spine粒子连接器.exe”。应用打开后会自动启动连接器，不需要安装 Node.js。
 3. 打开 Spine粒子编辑器网页。导出区域显示“连接器可用 · Spine 已就绪”后，点击“导出 .spine 包”。
 4. 服务器网站首次连接时，状态栏会显示“授权当前网站”。点击后会打开本机确认页，核对显示的完整网站来源（协议、域名和端口）后点击“允许此网站”。授权一次后，连接器会在本机保存允许列表；回到网页后最多等待 3 秒或点击“刷新”。
 
 本地开发地址 `127.0.0.1:5173` 和 `localhost:5173` 默认允许，不需要授权。
 
+桌面窗口提供 Spine.com 路径输入框、系统文件选择器、“保存路径”“恢复自动检测”“启动连接”和“断开连接”。默认安装位置检测不到时，可手动指定命令行程序：Windows 选择 `Spine.com`；macOS 选择 `Spine.app/Contents/MacOS/Spine`。关闭桌面应用会停止它启动的连接器。
+
+项目根目录原有 `.command` 和 `.bat` 脚本仍然保留，可继续启动 Node 脚本版连接器。桌面版与脚本版使用同一个端口，不能同时运行。
+
 授权按完整来源区分：`https://editor.example.com`、`http://editor.example.com` 与 `https://editor.example.com:8443` 是三个不同的授权项。生产环境建议始终使用 HTTPS 与固定域名。
 
 网页下载的是 ZIP 压缩包，内部包含 `.spine` 工程和 JSON 引用的图片目录。浏览器不能直接下载文件夹，因此使用 ZIP 保留完整目录结构；默认结构为：
@@ -56,7 +60,7 @@ npm run connector
 
 健康检查地址：`http://127.0.0.1:27843/v1/health`。
 
-## 生成不依赖 Node.js 的独立版
+## 生成不依赖 Node.js 的桌面版
 
 在目标操作系统上从项目根目录执行：
 
@@ -64,6 +68,6 @@ npm run connector
 npm run build:connector
 ```
 
-会生成 `release/connector/<系统-架构>/` 以及同目录下的 ZIP 分发包。把整个文件夹或 ZIP 交给用户即可，里面包含独立可执行文件和不依赖 Node.js 的启停脚本。构建必须在对应系统上完成：例如 Apple Silicon、Intel Mac、Windows 分别构建各自的版本；Node SEA 不支持把当前 Mac 可执行文件直接交叉打成 Windows `.exe`。
+macOS 会生成 `release/connector/macos-<架构>/Spine粒子连接器.app`；Windows 会生成 `release/connector/windows-<架构>/Spine粒子连接器.exe`。桌面程序由 C++17 编写，运行时不依赖 Node.js。默认使用 macOS 的 Apple Clang；Windows 应在 Visual Studio Developer Command Prompt 中执行，默认使用 MSVC，也可通过 `CXX` 指定 MinGW g++。
 
-构建后的 macOS 程序会进行临时本机签名。若要对外正式发布，仍建议使用 Apple Developer ID 重新签名并公证。
+面向其他 Mac 正式分发时，建议使用 Apple Developer ID 对 `.app` 签名并公证，避免 Gatekeeper 提示。