User Manual · v1.0.4

SpectrAI User Manual

Covers account, sessions, multi-agent collaboration, provider setup, remote control, settings and troubleshooting. This manual is for the desktop app (Windows / macOS) only; Web, mobile, mini-program, and the website are not covered here.

The manual is currently available in Chinese only. An English version is coming soon.
CH11

Chapter 11 · SpectrAI Desktop v1.0.4Plans & Modes

SpectrAI 操作手册 v1.0.4 · 桌面端 · 第 11 章

面向想搞清楚「我该买哪档、买了能干什么」的用户。数字以客户端套餐页与源码 PLAN_LIMITS 为准;**价格以客户端实时标价 / 官网 #pricing 为准,本文不写具体金额。**

---

30 秒结论

你是谁选哪档为什么
日常问代码、小改动、先试用Free保底普通会话,够用、零门槛
个人主力:并行改代码、定时轻量巡检、手机/飞书/企微盯进度Promission + supervisor + Telegram/飞书/企微 + 定时/Teams
要工作流/原型、24h 自动化、多机远程、质量护栏Ultra流程菜单 + 原型 + 配额/闭环跃迁
多人组织、成员配额Team协作管理 + 更大组织配额
私有化 / 无限Enterprise部署与无限额度场景

付费的核心体验差,不在聊天气泡长什么样,而在:你能用哪些会话模式,以及自动化 / 远程 / 评估闭环能走多远。

  • Free:单人日常 AI 编程助手
  • Pro:专业个人 AI 工作台
  • Ultra:24h 自动化中枢

---

五种工作模式(这是付费的核心体验差)

新建会话 / Butler 助手里可选的模式(源码合同 butlerAssistantP1Contract,共 5 种):

模式人话你能完成什么
normal 普通会话一个 AI 跟你对话问答、单文件小改、解释代码、探索想法
mission 引导式任务先把目标聊清楚,再组队推进端到端功能交付:澄清目标 → 确认阶段 → 规划/组队
supervisor 监督模式AI 当项目经理,拆活并派子 Agent多模块并行重构、前后端+测试一起改
prototype 原型设计做界面/交互原型的专用会话UI/UX 稿与流程探索;权限可自动通过,但只读工具硬禁用,避免把设计当工程硬改仓库
workflow_builder 工作流构建器用自然语言搭可复用流水线把「定时巡检 / 发版检查 / 多步 DAG」落成 wf_* 维护的工作流

旧文档里的「自主任务」≈ 现网 mission(引导式任务),不是第三种独立模式名。

---

套餐对照总表

维度FreeProUltra
一句话单人日常助手专业个人工作台24h 自动化中枢
会话模式仅 normalnormal + mission + supervisor五种全开(含 prototype / workflow_builder)
菜单基础工作区+ Teams / 定时等+ 流程菜单 + 设计(原型)
远程无 Bot / 无 RelayTelegram + 飞书 + 企微 + Relay 2 台全通道远程 + Relay 8 台
定时通知—App + Telegram + 飞书 + 企微App + Telegram + 飞书 + 企微
自动化配额无定时 / 无 Hooks任务 8 · 并发 2 · Hooks 8任务 30 · 并发 6 · Hooks 30
评估闭环—任务评估基础+ Reviewer + Provider 评分档案
目标护栏—Goal Anchor 基础+ 漂移检测
并发会话 / 工作区20 / 250 / 10100 / 30
历史 / 附件3 天 / 2MB30 天 / 20MB90 天 / 50MB
Prompt 优化基础 3 轮Advanced 10 轮Advanced 30 轮
支持社区标准优先技术支持

Team / Enterprise:在 Ultra 能力之上叠加组织配额与私有化(并发会话 200/∞、工作区 100/∞、成员 50/∞ 等,以客户端为准)。

---

模式 × 套餐

模式FreeProUltra+
normal 普通会话✅✅✅
supervisor 监督模式❌✅✅
mission 引导式任务❌✅✅
prototype 原型设计❌❌✅
workflow_builder 工作流构建器❌❌✅

Free 只保底对话;Pro 解锁 mission + supervisor,以及 Telegram/飞书/企微远程;prototype / workflow_builder 与流程菜单、设计工作区仅 Ultra。 Ultra 还拼自动化并发、更高配额与评估/漂移闭环。

---

Pro 把你变成「专业个人工作台」

你能完成的事(再对应产品名):

场景结果能力说明
多个 AI 并行改同一目标Agent Teams去中心化协作与并行评审
夜里自动跑检查,早上看结果定时任务 + Event Hooks轻量:任务 8 / 并发 2 / hooks 8
大目标自动拆步骤再执行自主规划LLM 分解任务并推进
离开工位仍能盯会话Telegram / 飞书 / 企微远程Pro 起可用的全通道远程
公网安全连回本机会话Cloud Relay最多 2 台机器
大任务不跑偏Goal Anchor 基础 + 任务评估基础目标锚定与质量状态展示
提示词写得更稳Prompt Optimizer Advanced最多 10 轮
接自建/第三方 OpenAI 兼容端点OpenAI 兼容 API自定义 API
换机少配一遍设置设置同步账号维度云端同步

配额速查(Pro):并发会话 50 · 工作区 10 · 历史 30 天 · 附件 20MB · 优化 10 轮 · Relay 2 · 通知 App+Telegram+飞书+企微。

适合谁:个人全职/重度使用者,需要 Supervisor 并行、定时轻量巡检、手机 Telegram 或飞书/企微盯进度。 不适合谁:需要流程菜单/原型设计、要 6 路并发定时、要多机 Relay 与 Reviewer 质量闭环——请直接看 Ultra。

---

Ultra 把你升级成「24h 自动化中枢」

相对 Pro 的硬差异(升级惊喜,不是口号):

你得到的结果Ultra 能力
把重复流程固化成一键跑工作流编排(流程菜单 · DAG)+ workflow_builder 会话
做界面/交互原型原型设计模式 + 设计工作区
更多巡检、更多并发不排队定时 30 / 并发 6 / hooks 30
笔记本 + 台式 + 服务器都可远程Relay 8 台
交付有人「审」而不只是状态灯评估 Reviewer 模式 + Provider 评分档案
长任务跑偏会报警Goal Anchor 漂移检测
卡住时优先响应优先技术支持
更大桌面工作面并发会话 100 · 工作区 30 · 历史 90 天 · 附件 50MB · 优化 30 轮

一句话:Pro 让你「一个人也能像小团队」;Ultra 让你「人不在机房,系统仍在值守,且质量有护栏」。

---

功能词典(人话)

名词人话定义
Goal Anchor给当前大任务钉一个「完成定义」;AI 和子任务都围着这个锚点干活,交付物可对照查看。
漂移检测Ultra:发现执行内容逐渐偏离锚点目标时自动提示,避免「越做越偏」。
Event Hooks某事件发生(如任务结束、某步完成)时自动触发后续动作,像轻量 webhook/编排。
Cloud Relay公网中继:不在同一局域网也能安全连回装了 SpectrAI 的机器上的会话。
Reviewer 模式Ultra:独立评审 Agent/池,对交付做质量把关,而不只是 UI 上的评估状态展示。
Provider 评分档案Ultra:按不同 AI Provider 沉淀质量与选用偏好,后续派活更聪明。
workflow_builder用自然语言创建/改工作流;真正落库走 wf_* 工具,避免手写乱改流程表。
supervisor监督模式:主会话拆子任务并派发多个子 Agent 并行。
mission引导式任务:先澄清目标与阶段,确认后再规划/组队(旧称「自主任务」常指它)。
prototype原型设计会话:偏 UI/UX;自动过权限,但硬禁用只读工具以外的危险工程操作路径。
自主规划引擎把大目标拆成可执行步骤并推进(与 mission 的「先确认再组队」互补)。
Agent Teams多 AI 按角色协作,而不是一个窗口串行聊到底。

---

三天使用故事

Free:问代码、小改动

你在普通会话里问「这段报错怎么修」,贴一段 stack,AI 给补丁思路;改完一个文件就收工。不需要并行子 Agent,也不需要定时任务。够用、干净。

Pro:Supervisor 并行 + 飞书/企微/Telegram 盯进度 + 轻量定时

上午开 supervisor:「前端拆状态、后端改 API、补测试」——三个子 Agent 并行。你出门开会,用 Telegram 或飞书/企微远程看进度。晚上挂一个定时任务(配额内)做依赖/lint 巡检,结果推 App / Telegram / 飞书 / 企微。

Ultra:工作流/原型 + 高并发定时 + Reviewer + 漂移护栏 + 多机 Relay

用 workflow_builder 把「发版前检查」固化成流程,在流程菜单里一键跑;需要 UI 探索时开 prototype 与设计工作区。笔记本、台式、一台小服务器都绑在 Relay 上(最多 8)。夜里多条定时(并发 6)巡检多个仓库;早上 Reviewer 把关合并质量,长任务有 漂移检测 防止跑偏。人不值守,中枢在跑。

---

常见误区

误区实际情况
「Ultra 就是多几个会话模式」Pro 有 mission/supervisor;prototype / workflow_builder 仅 Ultra,并拼更高配额与评估/漂移闭环
「Free 也能当 24h 值守」Free 无定时任务 / Hooks / 远程 Bot / Relay,不适合值守
「Pro 含工作流/原型」不含。 流程菜单、设计工作区与对应会话模式均需 Ultra
「飞书/企微是 Ultra 专属」不是。 Pro 起即可用 Telegram / 飞书 / 企微远程与通知
「买了就能无限开会话」限制的是并发运行中的会话:Free 20 / Pro 50 / Ultra 100(Team 200 / Enterprise 无限),不是历史会话总数;以客户端为准
「聊天室/在线会议是卖点」不是。 主菜单不以聊天室/会议作为订阅卖点;远程看的是会话与任务进度
「旧文三种模式才是全部」现网 5 种:normal / mission / supervisor / prototype / workflow_builder
「价格就按某篇文章」以客户端实时标价与官网为准

不适合谁(预期管理)

  • Free:不适合多 Agent 并行工程、定时自动化、飞书/企微协作、多机远程。
  • Pro:不适合工作流/原型设计、高并发定时农场、强质量 Reviewer 闭环。
  • Ultra:若只需偶尔问答,可能「杀鸡用牛刀」——Free/Pro 更划算。

---

如何升级

  1. 桌面端:设置 → 账号/套餐,或头像菜单 → 升级方案
  2. 主路径:客户端升级页打开链动小铺买官方兑换码,回客户端兑换激活(官网不接扫码支付;能力对比见官网 PROTECTED0)
  3. 兑换成功后若档位未变:头像菜单 → 刷新套餐状态;仍异常走 反馈页
  4. 新用户完成邮箱验证后获赠短期 Pro 与体验额度(欢迎礼,以服务端配置为准)

相关阅读:

---

*文档数字对齐 src/shared/authTypes.ts 的 PLAN_LIMITS 与 src/shared/edition.ts 的 PRO_FEATURES / ULTRA_FEATURES;模式定义对齐 butlerAssistantP1Contract.ts。*