桌面客户端
下载、安装与首次打开；后台运行与开机启动；用链接打开文档；代理；自动更新；导出诊断信息。
下载
打开 下载页，按你的系统选安装包。macOS 分 Apple 芯片与 Intel 两种；Linux 有 AppImage（自动更新）与 .deb（不自动更新，有新版时提示）。两种都会出现在应用菜单里、能直接点开 vizchat:// 链接——AppImage 在第一次运行后。
首次打开
当前版本没有做操作系统的开发者签名，第一次打开时系统会拦一下，放行一次即可，之后正常启动。
| 系统 | 怎么放行 |
|---|---|
| macOS | 第一次打开时提示「未打开」：点「完成」（不要点「移到废纸篓」）→ 打开「系统设置 → 隐私与安全性」，在底部点「仍要打开」并确认 → 再打开一次，点「打开」。macOS 15 起「右键 → 打开」已不再能绕过这一步 |
| Windows | SmartScreen 提示时点「更多信息」→「仍要运行」 |
| Linux（AppImage） | chmod +x VizChat-*.AppImage 后运行。Ubuntu 22.04 起默认没有 libfuse2，先装上——22.04 用 sudo apt install libfuse2，24.04 起用 sudo apt install libfuse2t64（或运行时加 --appimage-extract-and-run） |
| Linux（.deb） | sudo apt install ./VizChat-*.deb |
界面语言与浅色 / 深色外观在「设置 → 外观」里改：按 Cmd / Ctrl + ,，或从 macOS 的应用菜单、Windows / Linux 的「文件」菜单点「设置…」。
更新
- Windows 与 AppImage：在后台自动下载新版本，下载好后会通知你，点「重启以安装」即可；不重启的话下次退出时自动安装。
- macOS 与 .deb：发现新版本时会通知你并打开下载页，下载后覆盖安装即可。
也可以随时在菜单里点「检查更新…」（macOS 在应用菜单里，Windows / Linux 在「帮助」里）。
如果你的版本旧到服务端已不再支持，本地同步会暂停并提示你更新；更新到最新版本后自动恢复。
后台运行与开机启动
关掉窗口不等于退出：本地文件夹仍在后台同步。
| 系统 | 关掉最后一个窗口后 | 怎么重新打开 / 完全退出 |
|---|---|---|
| macOS | 继续在后台运行 | 点程序坞里的图标或菜单栏图标打开；应用菜单里选「退出」，或右键菜单栏图标选「退出」 |
| Windows | 继续在后台运行，图标留在通知区域（第一次会提示一次） | 单击通知区域的图标打开；右键它选「退出」 |
| Linux | 直接退出 | 重新启动 VizChat |
想让它开机就开始同步，勾选「开机时启动」：macOS 在应用菜单里，Windows / Linux 在「文件」菜单里，菜单栏 / 通知区域图标的菜单里也有。macOS 首次开启时，可能要到「系统设置 → 通用 → 登录项」里允许一次。开机自动启动时，macOS 与 Windows 不弹窗口、只在后台同步，需要时再点图标打开；Linux 会照常打开窗口。
右键菜单栏 / 通知区域的图标（Linux 上直接点它），能看到一行带彩色圆点的同步状态（绿点「已同步 · 2 分钟前」，同步中是蓝点；有文件夹出错时是红点并直接显示是哪一个，点它打开那个文件夹）和最近同步的本地文件夹：点文件夹名在窗口里打开它，「在访达中显示」（Windows 上是资源管理器）打开它的本地目录。
Linux 上的菜单栏图标取决于桌面环境：GNOME 默认不显示，需要装 AppIndicator 扩展。
用链接打开文档
形如 vizchat://board/<工作区 ID>/<文档 ID> 的链接会打开 VizChat 并直接定位到那份文档（比如 Claude Code 里给出的链接）。没登录时只会把窗口拉到前台。链接里只有位置，不含任何登录信息。Linux 上用 AppImage 的话，要先运行过一次，链接才能点开（每次运行它都会把自己登记到应用菜单与链接处理；挪了文件位置，再运行一次即可）。
公司代理
如果你的网络经过需要用户名和密码的代理，VizChat 会弹出一个小窗口请你输入；同一次运行里只问一次，退出后不会保存。网站自己要求的密码，VizChat 不会代填。
遇到问题时
在「帮助 → 导出诊断信息…」里导出一个压缩包，在 VizChat 网页右上角菜单的「反馈」里描述问题，并把压缩包发到 contact@vizchat.ai。它包含版本信息、最近几次运行的日志与本地同步的冲突记录；凭证、签名下载地址与你的用户目录名都已遮掉，不包含任何文件内容。