Chapter 0 · SpectrAI Desktop v1.0.4Quick Start
SpectrAI 操作手册 v1.0.4 · 桌面端 · 第 0 章
概述
3 步让 SpectrAI 跑起第一个 AI 会话：下载安装 → 登录并领用内置 Provider → 新建第一个会话。本章面向首次使用 SpectrAI 的新用户，预期耗时 5 分钟。读完本章你将能在桌面端完成一次完整对话；想深入了解多 Agent 协同、Provider 自接 API、远程控制等能力，按章末「下一步去哪」继续。
前置条件
| 项 | 要求 |
|---|---|
| 操作系统 | Windows 10 及以上（x64）或 macOS 11 Big Sur 及以上（Intel x64 / Apple Silicon） |
| 内存 | 建议 8 GB 及以上 |
| 磁盘空间 | 安装包约 200 MB，加上 AI 会话产生的数据，建议预留 2 GB 以上 |
| 网络 | 需稳定连接互联网；登录与内置 Provider 调用都依赖 claudeops.wbdao.cn 域名 |
| 账号 | 邮箱，或 GitHub / Google 账号任一 |
💡 提示本章只覆盖"开箱即用"路径，不要求你提前准备 Claude / OpenAI 等第三方 API Key。系统赠送的「内置 Provider」额度足以完成本章演示。第三方 Provider 接入见 第 8 章 Provider 与 API。
操作步骤：下载与安装
- 用浏览器访问官方下载页 https://claudeops.wbdao.cn/download.php。
- 按操作系统选择安装包：
- Windows：点击「Windows 安装包」下载
SpectrAI-Setup.exe。 - macOS Apple Silicon（M1/M2/M3 等）：点击「macOS arm64」下载
SpectrAI-arm64-mac.dmg。 - macOS Intel x64：点击「macOS x64」下载
SpectrAI-x64-mac.dmg。
- Windows：点击「Windows 安装包」下载
- 运行安装包：
- Windows：双击
.exe，按 NSIS 向导提示选择安装目录，等待安装完成；首次启动允许 Windows Defender 或杀软放行。 - macOS：双击
.dmg挂载，把SpectrAI.app拖到Applications；若首次启动提示「应用已损坏」，参见 第 10 章 FAQ 与故障排查 中的 macOS Gatekeeper 解锁说明。
- Windows：双击
- 安装完成后启动 SpectrAI：
- Windows：开始菜单找到「SpectrAI」并启动，或双击桌面图标。
- macOS：在 Launchpad 或
Applications中点击 SpectrAI 启动。
- 首次启动进入初始化向导：
- 选择界面语言（默认随系统）。
- 选择界面主题（浅色 / 深色 / 跟随系统）。
- 阅读并同意服务条款与隐私协议。
- 初始化完成后进入主控制台。左侧是会话列表（暂为空），中央是欢迎页，左侧活动栏靠下是账号头像。
⚠️ 注意开发模式（
npm run dev）与已安装的生产版本数据完全隔离，普通用户不会触达。如果你既装了生产版又跑了源码，会话数据不会互相污染。
操作步骤：登录并开通内置 Provider
- 在左侧活动栏靠下位置点击账号头像（默认显示为「未登录」头像）。
- 在弹出的登录面板中任选一种方式：
- 邮箱 + 密码：输入邮箱与密码，点击「登录」；未注册可点右下角「去注册」，用邮箱验证码完成注册。
- GitHub / Google：点击面板下方的「GitHub」或「Google」按钮，在浏览器完成授权后自动跳回；新用户首次授权直接建号。
- 登录成功后头像右下角出现绿色在线指示点，并显示当前订阅档位（默认 Free）。
- 自动进入「订阅与额度」页面查看 SpectrAI 团队赠送的内置 Provider 初始额度。订阅与额度页截图待补素材
- 内置 Provider 已默认启用，无需任何配置即可在新建会话时选用。
💡 提示内置 Provider 是 SpectrAI 团队提供的 OpenAI API 兼容服务，登录即可使用，适合快速体验。完整的额度规则、续费与发票流程见 第 1 章 账号与激活。
⚠️ 注意登录态保存在 Electron 的
userData目录下；切换账号或清除浏览器数据不影响 SpectrAI。如需注销，点击左侧活动栏的账号头像，在菜单中点击「退出登录」。
操作步骤：新建第一个会话
- 在主界面按 Ctrl/Cmd+N，或点击标签条右侧的「+」按钮，打开一个挂起的「新会话」标签页，中央展示新建会话首屏（Hero）。
- 选择工作目录：点击首屏的项目 / 目录选择区，在弹层中「浏览」或「管理」选择一个本地项目目录，也可从「最近使用」的目录里快速选取；本次演示可选任意目录或列表置顶的「空目录」选项。AI 后续读写文件、执行命令都局限在这里。
- 选择 Provider：默认已选内置 SpectrAI（零配置）；首次使用推荐保持此项。可在同一处选择具体模型。
- 确认会话模式为 Normal 模式（普通会话）（模式入口在主选择区）。其余 3 种模式见 第 3 章 AI 会话基础，本章不展开。
- 首屏底栏可见「目录权限」chip（控制 AI 可操作的目录范围，默认沿用上次选择，可在会话内热切换）；Worktree 隔离等其余选项保持默认即可。首次演示建议不开启「自动接受权限请求」，手动审批更稳妥。
- 在首屏输入框直接输入首条指令并发送，即完成会话创建并进入会话主界面（也可先「完整配置…」再创建）。
- 在底部输入框敲入你的问题或指令，按 Enter 发送。
- 等待 AI 输出：
- 上方对话区会以结构化消息气泡渲染 AI 回答。
- 工具调用（如读文件、执行命令、搜索）以内联工具卡片展示。
- 右上角显示「AI 正在思考…」与已用 Token 实时更新。
- 在 AI 输出的气泡上悬停或右键可看到 3 个常用操作：
- 复制：复制气泡全文到剪贴板。
- 引用：把该段作为下一条 prompt 的引用上下文。
- 收藏：把这条回答标记为收藏，方便后续在会话搜索中检索。
- 想继续追问，在底部输入框输入下一条 prompt 即可，会话上下文会自动续接。
💡 提示粘贴图片用 Ctrl/Cmd+V，SpectrAI 会自动把剪贴板里的图片附加到对话；不支持图像理解的 Provider 会给出警告。
❌ 不要在「工作目录」里选系统盘根目录（
C:\或/），AI 拿到根目录权限后操作风险极大。建议每个会话用一个独立项目目录。
详细配置
本章不涉及独立设置项，新建会话对话框的所有字段、默认值与依赖关系详见 第 9 章 设置与快捷键 与 第 3 章 AI 会话基础。
常见问题
启动后看不到任何窗口怎么办？
Windows 端偶发出现窗口被推到屏幕外的情况：右键任务栏 SpectrAI 图标，选择「最大化」即可恢复显示。macOS 端先点 Dock 图标激活，再按 Cmd+Tab 切回前台。仍不可见时退出并重新启动。
登录时一直卡在「正在加载」？
检查网络是否能访问 https://claudeops.wbdao.cn/。如使用了系统代理，确认 SpectrAI 已读取代理（设置 → 网络与代理）；公司网络可能拦截 WebSocket，换个网络重试。详细排查见 第 10 章 FAQ 与故障排查。
内置 Provider 额度耗尽后还能继续用吗？
可以。两条路径：升级订阅档位（第 1 章 账号与激活），或自接第三方 Provider（第 8 章 Provider 与 API）。两种方式并行不冲突。
新建会话时找不到「SpectrAI」这个 Provider？
确认左侧活动栏的账号头像已显示登录状态、且订阅页显示内置 Provider 已启用。如果仍未出现，进入「设置 → AI Provider」，检查 SpectrAI 卡片是否被禁用；如已被禁用，点击「启用」并刷新。
相关章节
- 第 1 章 账号与激活 — 登录方式、订阅档位、额度查询的完整流程
- 第 3 章 AI 会话基础 — 4 种会话模式、对话气泡的全部交互
- 第 4 章 多 Agent 协同 — 想让 AI 自动分工时下一步去这里
- 第 7 章 远程控制 — 想在手机上看会话进度时下一步去这里
- 第 8 章 Provider 与 API — 想接入自己的 Claude / OpenAI / Gemini API 时下一步去这里
- 第 9 章 设置与快捷键 — 想改默认快捷键或调整设置项时下一步去这里
- 第 10 章 FAQ 与故障排查 — 安装或登录遇到问题时的兜底排查