安装指南
下载
前往 GitHub Releases 最新版 下载对应平台的安装包：
| 平台 | 文件 |
|---|---|
| macOS (Apple Silicon) | CyberCode_x.x.x_macos_arm64_aarch64.dmg |
| macOS (Intel) | CyberCode_x.x.x_macos_x64_x64.dmg |
| Linux (x64) | CyberCode_x.x.x_linux_x64_amd64.deb |
| Windows (x64) | CyberCode_x.x.x_windows_x64_x64-setup.exe |
不确定 Mac 是哪种架构？点屏幕左上角 → 关于本机，"芯片"那栏 Apple M 开头选 arm64，Intel 开头选 x64。
macOS 安装
- 双击
.dmg文件，将应用拖入Applications文件夹 - 首次打开如果提示 "已损坏，无法打开"，在终端执行：
bash
xattr -cr /Applications/CyberCode.app由于应用暂未进行 Apple 开发者签名，macOS 会阻止首次运行，执行上述命令移除隔离属性后即可正常使用。
Linux 安装
Debian / Ubuntu (.deb)：
bash
sudo dpkg -i CyberCode_x.x.x_linux_x64_amd64.deb
sudo apt-get install -f # 自动补缺失依赖通用 (.AppImage)：
bash
chmod +x CyberCode_x.x.x_linux_x64.AppImage
./CyberCode_x.x.x_linux_x64.AppImage系统依赖：需要
libwebkit2gtk-4.1和libayatana-appindicator3。Ubuntu 22.04+ 直接运行 .deb 会自动装。
Windows 安装
- 双击
.exe安装程序，按向导完成安装 - 首次运行如果 SmartScreen 弹出警告，点击 「更多信息」 → 「仍要运行」
应用暂未进行 Windows 代码签名，仅首次运行需要此操作。
Web UI 模式
如果桌面端安装遇到问题，可以直接通过浏览器使用 Web UI。在项目根目录下分别启动服务端和前端：
bash
# 1. 启动服务端（在项目根目录）
SERVER_PORT=3456 bun run src/server/index.ts
# 2. 启动前端（在 desktop 目录）
cd desktop
bun run dev --host 127.0.0.1 --port 2024启动后浏览器访问 http://127.0.0.1:2024 即可。
常见问题
Q: macOS 提示"来自身份不明的开发者"？
右键点击应用 → 选择「打开」→ 在弹窗中点击「打开」，仅需操作一次。
Q: Windows 提示缺少 WebView2？
从 Microsoft 官方 下载安装 WebView2 运行时。
Q: Linux AppImage 闪退？
部分发行版需要先安装 libfuse2：sudo apt install libfuse2