[Feature]: 没有构建桌面安装包吗？mac版，怎么就看不到安装包？

[niubg]

Which destkop app does this feature request relate to?

• Select a project 👇
• Agent-TARS (cli, server, agent, tool etc.)
• UI-TARS Desktop

What problem does this feature solve?

能给个构建后的mac版桌面安装包吗？

What does the proposed features look like?

桌面版

[anaivebird]

下面是假设你是在 macOS（Intel 或 Apple Silicon）上的步骤 — 如果你的是其他系统，少许不同。

✅ 前提条件 & 准备

• UI-TARS-desktop 是一个基于 Electron + pnpm workspace 的项目。 ([DeepWiki]1)
• 推荐使用 Node.js + pnpm（建议版本 pnpm 9+）。 ([CSDN博客]2)
• 如果你是 macOS，还可能需要正确处理“系统权限”（Accessibility、屏幕录制等），因为 UI-TARS 需要模拟鼠标键盘 / 截图等操作。 ([CSDN博客]3)

---

⚙️ 从源码运行／开发版启动

如果你只是想“跑起来看看 / 开发 /调试”，可以这样：

git clone https://github.com/bytedance/UI-TARS-desktop.git
cd UI-TARS-desktop
pnpm install
pnpm run dev:ui-tars   # 启动 UI-TARS desktop 的开发版

• pnpm install 会安装所有依赖（workspace 的 packages）。

• pnpm run dev:ui-tars 会启动 Electron 应用，弹出 UI-TARS Desktop 界面。 ([Lathezero's Blog]4)

• 如果你想同时热重载主进程（main process + renderer）时，也可以用：

  pnpm run dev:w

  用于开发调试。 ([Lathezero's Blog]4)

注意：macOS 下首次运行时，可能系统会弹权限申请对话框 — 要允许 “Accessibility”（辅助功能）和 “屏幕录制 / 屏幕截图捕捉” 权限。 ([CSDN博客]3)

---

📦 构建 / 打包成 macOS 应用（.app / .dmg / .pkg）

如果你想把它做成一个可分发 / 安装的 macOS 应用包，而不是仅仅开发运行，可以：

1. 安装依赖 + 构建：

pnpm install
pnpm run build    # 或者通过 workspace / turbo 脚本

2. 然后针对 macOS 构建 package / installer，有两种目标：

• mac x64（Intel Mac）
• mac arm64（Apple Silicon Mac） ([CSDN博客]2)

对应命令一般是：

pnpm run publish:mac-x64   # 如果是 Intel Mac
# or
pnpm run publish:mac-arm64  # 如果是 Apple Silicon

构建后，会输出 .app / .dmg / .pkg（或者适用于 macOS 的安装包 /磁盘镜像 /安装器）到 out/ 或 out/make/ 目录中。 ([DeepWiki]1)

之后你就可以把 .app 拖到 /Applications，按 macOS 常规方式安装／运行。

---

✅ 如果只是想快速使用（不构建）

其实项目也提供了“发布版 / Release / 已打包好”的下载。根据官方 quick-start 文档，你可以直接下载 release 版本，不用自己 build／compile。 ([GitHub]5)

然后：

• 把 .app 拖到 /Applications
• 在 System Settings → Privacy & Security → 给 UI-TARS 授予 Accessibility + Screen Recording 权限
• 打开应用，就可以使用了。 ([GitHub]5)

---

ℹ️ 常见问题 & 注意事项

• 如果构建失败／依赖问题，可尝试删除 node_modules 后重装。 ([CSDN博客]6)
• 必须保证 Node + pnpm 版本符合要求。 ([CSDN博客]2)
• macOS 的系统权限（Accessibility, Screen Recording）必须授予，否者 UI 自动化操作可能失败。 ([CSDN博客]3)
• 如果你只想试用 / 使用而不折腾 build，建议直接使用官方 release 版本。这样更省事也更稳定。 ([GitHub]5)

---

✅ 总结 — 推荐流程（macOS）

• 如果你 只是想运行／开发：pnpm install → pnpm run dev:ui-tars
• 如果你 想打包成 macOS 应用：pnpm install → pnpm run build → pnpm run publish:mac-x64/arm64 → 得到 .app/.dmg → 拖到 /Applications & 授权权限
• 如果你 只想直接使用：建议从 Release 下载已经打包好的 .app，省去构建过程

[chenrui333]

logged a more general issue, #1767

right now you use brew to install 0.2.4 release.

[harrett]

pnpm run build
 ERR_PNPM_NO_SCRIPT  Missing script: build

Command "build" not found.

pnpm run publish:mac-arm64
 ERR_PNPM_NO_SCRIPT  Missing script: publish:mac-arm64

Command "publish:mac-arm64" not found. Did you mean "pnpm run publish:packages"?

看起来pnpm命令更新了？版本：pnpm --version
10.27.0

[harrett]

当运行pnpm run dev:ui-tars # 启动 UI-TARS desktop 的开发版后，测试后：

ui-tars-desktop:dev: 19:58:57.638 (main) › [GUIAgent] guiAgentErrorParser: Error: 400 The parameter max_tokens specified in the request are not valid: integer above maximum value, expected a value <= 16384, but got 65535 instead. Request id: 021767527937501ae767af4c69fa8400a91dada77a1314dab7930
ui-tars-desktop:dev: at APIError2.generate (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:66969:14)
ui-tars-desktop:dev: at OpenAI2.makeStatusError (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:72542:23)
ui-tars-desktop:dev: at OpenAI2.makeRequest (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:72675:24)
ui-tars-desktop:dev: at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
ui-tars-desktop:dev: at async UITarsModel.invokeModelProvider (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:73359:20)
ui-tars-desktop:dev: at async UITarsModel.invoke (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:73381:20)
ui-tars-desktop:dev: at async async_retry.retries._retry_model (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:73595:28)
ui-tars-desktop:dev: at async GUIAgent.run (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:73593:85)
ui-tars-desktop:dev: at async runAgent (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:158974:3)
ui-tars-desktop:dev: at async Object.handle (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:159019:5)
ui-tars-desktop:dev: 20:00:29.644 (main) › [UITarsModel] invoke: screenContext={"width":1440,"height":900}, scaleFactor=1, uiTarsVersion=1.5, useResponsesApi=false
ui-tars-desktop:dev: 20:00:29.922 (main) › [UITarsModel] error Error: Request was aborted.
ui-tars-desktop:dev: at OpenAI2.makeRequest (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:72612:13)
ui-tars-desktop:dev: at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
ui-tars-desktop:dev: at async UITarsModel.invokeModelProvider (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:73359:20)
ui-tars-desktop:dev: at async UITarsModel.invoke (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:73381:20)
ui-tars-desktop:dev: at async async_retry.retries._retry_model (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:73595:28)
ui-tars-desktop:dev: at async GUIAgent.run (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:73593:85)
ui-tars-desktop:dev: at async runAgent (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:158974:3)
ui-tars-desktop:dev: at async Object.handle (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:159019:5)
ui-tars-desktop:dev: at async WebContents. (node:electron/js2c/browser_init:2:87023)
ui-tars-desktop:dev: 20:00:29.923 (main) › [UITarsModel cost]: 12ms
ui-tars-desktop:dev: 20:00:29.924 (main) › [GUIAgent] Catch error Error: Request was aborted.
ui-tars-desktop:dev: at OpenAI2.makeRequest (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:72612:13)
ui-tars-desktop:dev: at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
ui-tars-desktop:dev: at async UITarsModel.invokeModelProvider (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:73359:20)
ui-tars-desktop:dev: at async UITarsModel.invoke (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:73381:20)
ui-tars-desktop:dev: at async async_retry.retries._retry_model (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:73595:28)
ui-tars-desktop:dev: at async GUIAgent.run (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:73593:85)
ui-tars-desktop:dev: at async runAgent (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:158974:3)
ui-tars-desktop:dev: at async Object.handle (/Users//workspace/UI-TARS-desktop/apps/ui-tars/dist/main/main.js:159019:5)
ui-tars-desktop:dev: at async WebContents. (node:electron/js2c/browser_init:2:87023)

[harrett]

不玩了

~/workspace/UI-TARS-desktop-0.3.0/apps/ui-tars  pnpm run build

ui-tars-desktop@0.2.4 build /Users//workspace/UI-TARS-desktop-0.3.0/apps/ui-tars
npm run clean && npm run typecheck && cross-env NODE_ENV=production electron-vite build && electron-forge make --enable-logging

npm warn Unknown env config "shamefully-hoist". This will stop working in the next major version of npm.
npm warn Unknown env config "node-linker". This will stop working in the next major version of npm.
npm warn Unknown env config "store-dir". This will stop working in the next major version of npm.

ui-tars-desktop@0.2.4 clean
rimraf dist out

npm warn Unknown env config "shamefully-hoist". This will stop working in the next major version of npm.
npm warn Unknown env config "node-linker". This will stop working in the next major version of npm.
npm warn Unknown env config "store-dir". This will stop working in the next major version of npm.

ui-tars-desktop@0.2.4 typecheck
npm run typecheck:node && npm run typecheck:web

npm warn Unknown env config "shamefully-hoist". This will stop working in the next major version of npm.
npm warn Unknown env config "node-linker". This will stop working in the next major version of npm.
npm warn Unknown env config "store-dir". This will stop working in the next major version of npm.

ui-tars-desktop@0.2.4 typecheck:node
tsc --noEmit -p tsconfig.node.json --pretty --composite false

npm warn Unknown env config "shamefully-hoist". This will stop working in the next major version of npm.
npm warn Unknown env config "node-linker". This will stop working in the next major version of npm.
npm warn Unknown env config "store-dir". This will stop working in the next major version of npm.

ui-tars-desktop@0.2.4 typecheck:web
tsc --noEmit -p tsconfig.web.json --pretty --composite false

vite v6.2.2 building SSR bundle for production...
✓ 0 modules transformed.
✓ 0 bundles compiled into bytecode.
✗ Build failed in 42ms
error during build:
[vite:bytecode] Cannot read properties of undefined (reading 'replace')
file: /Users//workspace/UI-TARS-desktop-0.3.0/apps/ui-tars/src/main/main.ts
at escapeRegExpString (file:///Users//workspace/UI-TARS-desktop-0.3.0/node_modules/electron-vite/dist/index.mjs:151:14)
at file:///Users//workspace/UI-TARS-desktop-0.3.0/node_modules/electron-vite/dist/index.mjs:191:36
at Array.forEach ()
at Object.transform (file:///Users//workspace/UI-TARS-desktop-0.3.0/node_modules/electron-vite/dist/index.mjs:190:30)
at Object.handler (file:///Users//workspace/UI-TARS-desktop-0.3.0/node_modules/vite/dist/node/chunks/dep-B0fRCRkQ.js:51750:15)
at file:///Users//workspace/UI-TARS-desktop-0.3.0/node_modules/rollup/dist/es/shared/node-entry.js:21844:40
at process.processTicksAndRejections (node:internal/process/task_queues:103:5)
 ELIFECYCLE  Command failed with exit code 1.