💻 桌面端指南
Tauri 2 原生桌面客户端 · 内嵌完整 YouCoder 引擎
1. 安装
前往 下载页 获取对应平台的安装包：
| 平台 | 安装包 |
|---|
| macOS (Apple Silicon) | YouCoder_*.aarch64.dmg |
| macOS (Intel) | YouCoder_*.x86_64.dmg |
| Windows | YouCoder_*.msi |
| Linux (Debian/Ubuntu) | YouCoder_*.deb |
| Linux (其他发行版) | YouCoder_*.AppImage |
macOS：打开 .dmg，将 YouCoder 拖入「应用程序」即可（首次打开右键 → 打开，绕过 Gatekeeper 提示）。Windows：双击 .msi 一路下一步。Linux：sudo dpkg -i YouCoder_*.deb 或为 .AppImage 添加可执行权限后运行。
说明：桌面端是独立应用，无需先安装 TUI 或命令行工具——引擎已内嵌在应用中。
2. 首次启动
- 从应用程序列表启动 YouCoder。
- 应用自动拉起内置引擎（sidecar）并打开主窗口，无需额外配置。
- 如提示需要登录，使用官网账号登录以启用多设备同步、远程访问等功能。
- 进入设置面板，配置你的 API Key（或使用环境变量 / 已有
~/.youcoder/config.toml）。
启动后在菜单栏可看到状态图标；退出应用时 sidecar 会自动停止。
3. 界面与功能
桌面端提供完整的图形化 AI 编程工作区：
| 区域 | 功能 |
|---|
| 聊天区 | 流式对话、@ 文件引用、多轮上下文、消息复制/重试 |
| 文件树 | 浏览项目文件，点击在编辑器中打开 |
| 编辑器 | 内置代码编辑器，可查看 AI 修改的文件 |
| 会话管理 | 历史会话列表，随时切换/继续 |
| Agents / Skills / MCP | 图形化管理子代理、技能与 MCP 服务器 |
| 设置 | 模型、API Key、代理、外观、执行安全策略等 |
工具授权：AI 需要执行命令或写文件时，聊天区会弹出授权条，点击 Approve / Reject 决定。授权状态会实时同步到其他设备。
4. 多端同步与远程访问
- 多端同步：同一账号下，TUI / 桌面 / VSCode / 手机端的会话、消息与授权状态实时同步。
- 手机远程：在桌面端登录后，可通过 WebSocket 隧道在手机浏览器访问你的工作区（详见 TUI 手册第 10 节）。
5. 配置
桌面端配置与 TUI 完全一致（同一引擎、同一份 ~/.youcoder/config.toml）。推荐在图形化「设置」面板中操作：
- 模型：选择供应商与模型（DeepSeek / Anthropic / OpenAI / Gemini / 智谱等）。
- API Key：面板中填入，或沿用环境变量 / 配置文件。
- 代理：HTTP 代理地址（
proxy_url）。
- 执行安全：
exec_shell 的 security / ask 策略。
6. 故障排查
| 问题 | 解决方案 |
|---|
| 应用无法启动 | 确认安装包与系统架构匹配（Apple Silicon / Intel）；删除 ~/Library/Application Support/youcoder 后重试 |
| 提示引擎未运行 | 完全退出应用后重新启动；查看 ~/Library/Logs/youcoder/（macOS） |
| 连接不上模型 | 检查 API Key 与网络；确认模型名正确；检查代理设置 |
| macOS 首次打开被拦截 | 右键应用 → 打开；或 系统设置 → 隐私与安全性 → 仍要打开 |
💻 Desktop Guide
A Tauri 2 native desktop client · full YouCoder engine embedded
1. Installation
Get the installer for your platform from the download page:
| Platform | Installer |
|---|
| macOS (Apple Silicon) | YouCoder_*.aarch64.dmg |
| macOS (Intel) | YouCoder_*.x86_64.dmg |
| Windows | YouCoder_*.msi |
| Linux (Debian/Ubuntu) | YouCoder_*.deb |
| Linux (other) | YouCoder_*.AppImage |
macOS: open the .dmg and drag YouCoder into Applications (right-click → Open on first launch to bypass Gatekeeper). Windows: run the .msi and click through. Linux: sudo dpkg -i YouCoder_*.deb, or make the .AppImage executable and run it.
Note: The desktop app is self-contained — no need to install the TUI or CLI first; the engine is embedded.
2. First Launch
- Launch YouCoder from your applications.
- The app automatically starts its embedded engine (sidecar) and opens the main window — no extra setup.
- If prompted, sign in with your account to enable multi-device sync and remote access.
- Open Settings to configure your API key (env vars or an existing
~/.youcoder/config.toml also work).
A status icon appears in the menu bar; the sidecar stops automatically when you quit.
3. UI & Features
The desktop app offers a full graphical AI coding workspace:
| Area | Function |
|---|
| Chat | Streaming chat, @ file references, multi-turn context, copy/retry |
| File tree | Browse project files; click to open in the editor |
| Editor | Built-in code editor to review AI-modified files |
| Sessions | History list — switch or continue any session |
| Agents / Skills / MCP | Graphical management of sub-agents, skills and MCP servers |
| Settings | Model, API key, proxy, appearance, execution policy, etc. |
Tool approval: when the AI needs to run a command or write files, an approval bar appears in the chat — click Approve / Reject. Approval state syncs to your other devices in real time.
4. Multi-device Sync & Remote Access
- Multi-device sync: sessions, messages and approvals stay in sync across TUI / desktop / VS Code / mobile under the same account.
- Mobile remote: after login, access your workspace from a mobile browser over a WebSocket tunnel (see TUI manual §10).
5. Configuration
The desktop app shares the exact same config as the TUI (same engine, same ~/.youcoder/config.toml). The graphical Settings panel is the recommended way:
- Model: pick a provider and model (DeepSeek / Anthropic / OpenAI / Gemini / Zhipu, etc.).
- API key: fill it in the panel, or rely on env vars / the config file.
- Proxy: HTTP proxy address (
proxy_url).
- Execution policy:
security / ask for exec_shell.
6. Troubleshooting
| Issue | Solution |
|---|
| App won't launch | Verify the installer matches your CPU arch (Apple Silicon / Intel); delete ~/Library/Application Support/youcoder and retry |
| "Engine not running" | Quit fully and relaunch; check ~/Library/Logs/youcoder/ (macOS) |
| Can't reach the model | Check the API key and network; verify the model name; check proxy settings |
| macOS blocks first launch | Right-click the app → Open; or System Settings → Privacy & Security → Open Anyway |