使用手册

欢迎使用 FOREVO。这份手册覆盖对话、文档协同修订、项目空间、知识库、记忆、技能、定时任务、硬件、IM 集成等所有功能的细节用法。

文档导航

FOREVO 简介

FOREVO 是一个把 AI 装进员工工位的协作平台。和"聊天机器人"不同，FOREVO 的每个数字员工都有：

• 独立人设：CEO、CTO、运营、设计师、客服…… 每个都有专属 system prompt、技能、记忆
• 真实产物：直接发布 Word / PPT / Excel 表格 / 网页到云端公开/私密链接
• 可上班：定时执行任务、入驻微信飞书在群里干活、被硬件设备语音召唤
• 会学习：长期记忆 + 知识库 + 经验复盘；用得越久越懂你的工作语境

3 分钟快速上手

第一个任务实操（手把手）

例子：让"市场总监"做一份竞品分析

1. 进入数字团队 → 找到「市场总监」 → 点「💬 进入对话」
2. 输入任务："对比抖音和快手的电商业务，做一份 5 页的竞品分析报告，重点看 GMV / DAU / 主播抽成 三个维度"
3. 员工会自动：调 cloud_fetch_url 收集公开数据 → 调 cloud_publish_doc 生成结构化报告 → 把链接发回
4. 右侧"交付区"自动出现 Word 文档预览，点"编辑"按钮可即时修订
5. 完成后链接可直接发给老板，或者点"私密"开关变成只你能看

大家都在用 FOREVO 干什么

🎯 创业团队

• 一句话生成"AI 教育公司 / 跨境电商品牌 / 文创工作室"完整团队 + 品牌方案
• 每周一让 COO 自动生成上周复盘 + 本周计划，发到团队群
• 客服员工 7×24 接入微信，回答常见问题、自动建工单

📰 内容运营

• 主播 agent 每天 7:30 自动抓 RSS → 生成早报 → 推到硬件设备播报
• 设计师 agent 拿到选题 → 生成 PPT → 推送到微信群
• 编辑 agent 改稿、调格式、生成多平台分发版本

🛠 开发者

• 架构师 agent 做技术方案文档 + 接口设计文档
• 定时任务每天扫 GitHub 趋势 → 生成日报
• 项目经理 agent 自动整理周会纪要 → 落到知识库

📞 销售 / 客服

• 客服 agent 入驻微信，自动接客户咨询
• 销售 agent 根据 CRM 数据自动生成跟进话术
• 每周自动汇总销售漏斗，给 CEO 发周报

对话基础

FOREVO 的聊天界面看起来像微信，但每条对话都连接一个有独立人设、技能、记忆的数字员工。

左中右三栏布局

消息支持的内容类型

• 纯文字：Markdown 渲染（标题、列表、代码块、链接）
• 图片：直接拖拽或粘贴；员工能看图（GPT-4V / Claude Vision）
• 附件：PDF / Word / Excel / 任意二进制；自动 OCR 入对话上下文
• 语音：长按麦克风录音；自动 STT 转文字
• 引用：选中前一条消息文字 → 弹出"引用"按钮 → 自动 prefix > quote
• @提及：群聊里 @员工名 触发该员工回复

高级对话技巧

1. 流式输出

所有员工默认开启流式响应。AI 生成的每一个 token 实时推到前端，肉眼可见思考过程。可以随时点"停止"中断，token 不计费。

2. 长上下文 / 跨轮记忆

每个员工独立保留50 条最近消息作为工作记忆。超过 50 条的旧对话会自动总结成"会话摘要"存入长期记忆，员工再次提及时仍能召回。

3. 命令模式

消息以 / 开头进入命令模式：

4. @ 提及 / 显式路由

消息开头打 @scheduler 每月 1 号给我做总结 强制路由到时间管家 agent。比关键词自动路由更精确。

5. 引用 / 跳转

选中任意历史消息文字 → 弹出"引用"按钮 → 引用文字自动作为新消息的前缀。员工的回复也会标注引用源，让多轮对话不丢上下文。

多窗口 / 多员工同时对话

FOREVO 支持无限多对话窗口。同时和「市场总监」「研发经理」「客服」三个员工分别对话不互相影响——每个对话有独立 ChatID + 独立记忆 + 独立流式状态。

左栏对话列表会显示每个对话的状态：

• 🟢 流式中（员工正在回答）
• ✅ 完成
• ❌ 失败（看右栏的"实时动态"找原因）
• ⏸ 等待用户输入

群聊 · 多员工协作

把多个员工拉进一个群聊（默认按部门自动建好），可以让他们：

• 协作完成多步任务：你说"做一份产品发布会方案" → CEO 制定大纲 → 设计师做 PPT → 营销总监起草新闻稿 → CFO 算预算，每个人自动接力
• 开会决议：群聊里 @ 所有人 → 抛出问题 → 每人独立给出意见 → 自动总结成会议纪要
• 互相 @ 提及：员工 A 在回复中 @员工B 让 B 接力处理

@ 提及 + 命令模式（详解）

不同场景的精确控制：

流式输出 / 引用消息

流式：消息一个 token 一个 token 推过来，前端 React 实时渲染。中途按"停止"按钮可立即中断（已生成的部分不计费）。

引用：

1. 在消息流里选中任意一段文字（双击单词或拖选）
2. 松开鼠标，浮出"引用"按钮
3. 点击 → 自动把选中文字 prefix 到输入框（带 > 标记）
4. 追加你的问题 → 发送 → 员工知道你针对哪句话提问

多 Agent 自动路由

系统内置 4 个专精 Agent，根据你说的话自动选最合适的：

路由发生在你按"发送"那一刻，0 延迟（关键词匹配，不调 LLM）。可以在 /agents 自建 agent + 自定义触发词。

子 Agent 委派（cloud_invoke_agent）

一个 agent 在执行任务中可以调用 cloud_invoke_agent 把子任务委派给另一个 agent。例：通用助手处理"做一份产品方案" → 觉得不够专业 → 调 invoke_agent 把任务转给 writer agent → writer 用专业 prompt 输出 → 主 agent 接收结果继续。

限制：嵌套深度最多 3 层；每用户每分钟最多 10 次调用（防止递归死循环）。

智能内容捕获 · 4 种快速输入

除了直接对话，FOREVO 还支持 4 种"更多方式"快速把外部内容变成笔记或文档：

📎 粘贴链接（cloud_summarize_url）

直接把链接粘到对话框，FOREVO 会自动识别平台并去除导航/评论噪音：

使用：直接说"帮我总结这个 https://..."或"这条公众号的要点是什么 https://..."，员工自动调用此工具。返回结构化结果（title / content_md / key_points / suggested_tags），下一步可以发给 cloud_publish_doc 落到云端笔记。

📷 拍照 / 图片（cloud_image_to_note）

支持 5 类场景，会按场景调整 prompt：

• whiteboard 白板：会议结束后拍白板 → OCR 文字 + 拓扑识别（箭头/分支） → 还原结构化纪要
• class_note 课堂笔记：拍黑板/老师 PPT → 提取关键概念 + 公式（LaTeX）
• food 饮食记录：拍餐盘 → 识别食物 + 估算卡路里 + 营养标签
• ppt：截图 PPT 单页 → 提取标题 + 要点 + 配色风格
• handwriting 手写：手写笔记照片 → OCR 中英文 + 排版还原

状态：定义已就位（LLM 看得到这个工具），需要在 设置 → 生成配置 配置 VLM provider（GPT-4V / qwen-vl-plus / claude-3-vision）后启用。

🎙 导入音视频（cloud_audio_to_note）

支持的文件类型：MP3 / WAV / M4A / FLAC / OGG / MP4 / MOV / WEBM。流程：

1. 上传文件（最大 200MB / 文件，单次最多 5 个）
2. STT 转写（Whisper / 通义听悟 / iflytek）
3. 可选：多说话人区分（speaker_diarize=true）
4. 按风格总结：meeting（会议纪要 + Action Items）/ podcast（章节 + 金句）/ class（知识点提纲）/ interview（Q&A 结构）
5. 返回 full_transcript + summary_md + key_quotes + speaker_segments

状态：skill 定义就位，需要 STT provider key（OPENAI_API_KEY / WHISPER_API_KEY / DASHSCOPE_API_KEY 任一）。

📚 智能拍书（cloud_book_scan）

三种页面类型自动识别：

• cover：封面 → 提取书名 + 作者 + 出版社（VLM + 在线书籍 API）
• content：正文页 → 提取段落 + 章节号
• quote_page：摘抄页（用户用便签贴标记的） → 只提取被标记部分

提取后自动按书名归类入 wiki/读书笔记/<书名>/，同一本书的所有摘抄聚合到同一文件夹。

状态：定义就位，需 VLM provider。

一键生成 Word / 报告

对任何员工说"写个 X 报告 / 起草个 X 方案 / 做个会议纪要"，员工会调用 cloud_publish_doc：

• 自动选合适的模板（执行报告/调研/学术/提案/纪要/公文）
• 结构化输出：自动生成 H1/H2/H3 + 目录 + 引用编号
• 支持 Markdown / 富文本 / 代码块 / 引用块
• 专业 serif 字体 + 飞书风排版
• 返回公开 URL + 32-hex 短链 + 私密版本（看 #share）

6 套 Word 模板

对员工说"用学术 IEEE 模板写"或"这是会议纪要"会强制使用对应模板。否则系统按内容关键词自动选择。

一键生成 PPT

"做个 X PPT" → 调 cloud_publish_slides：

• 自动按 --- 分页（你给的 markdown 用三横线分页）
• 每页第一个 # 标题 作为该页主标题
• 全屏深色 / 渐变背景，← → Space 切页
• 支持图片、列表、代码块、引用
• F11 全屏演示模式

一键生成 Excel 表格

"做个对比表 / 数据看板" → 调 cloud_publish_sheet：

• 表头粘性（滚动时不消失）
• 行斑马纹
• 点列标题排序（升降序）
• 顶部搜索框筛选
• 支持复制单元格 / 整行 / 导出 CSV

一键生成网页 / 单页

"给我做个 X 介绍页 / 落地页" → 调 cloud_publish_page：

• 响应式布局（PC + 移动 自适应）
• 自动 Open Graph meta（朋友圈分享带预览图）
• 内嵌图片 / 视频 / 联系按钮
• 暗色 / 亮色主题切换

导出 PDF

所有生成的文档/PPT/表格右上角有"导出 PDF"按钮。前端 html2pdf 在浏览器内直接生成（不上传到服务器），保留所有样式 + 中文字体。

协同修订概述

FOREVO 最强大的功能之一。员工生成完文档后，不需要复制到聊天框 → 让 AI 改 → 粘回去这种来回切换。直接在文档页面上对任意段落点击 → 输入修改指令 → AI 实时重写那一段。

点段修订（鼠标悬浮 + 指令）

1. 打开任意员工生成的文档（doc / slides / sheet / page）
2. 鼠标移到任意段落 → 该段被淡蓝色边框高亮 + 显示「✏️ 修改」浮标
3. 点击 → 浮出指令框：
   这段太长了，压缩到 2 句话 或 把"客户"换成"用户" 或 引用真实数据
4. 按 Enter → AI 流式重写**这一段** → 文档其他段落不受影响
5. 结果不满意 → 再点该段 → 输入"撤销，恢复原文"

流式重写不打断阅读

修订采用段级别流式：

• 只重写选中段，其他段落保持不动（不会因为你改第 3 段而第 5 段也重新生成）
• 新内容 token 一个一个流入，看着它"重写"
• 下文 layout 不抖动（占位高度自动计算）
• 修订完成后段落边框变绿色 → 1.5 秒后淡出

版本历史 / 一键回退

每次修订自动产生一个版本快照，存在文档同目录的 .versions/ 下。

• 右上角"历史"按钮 → 弹出时间轴：
  v1 · 2026-04-27 14:30 · 初稿
v2 · 2026-04-27 14:45 · 修订第 3 段（"压缩到 2 句话"）
v3 · 2026-04-27 15:02 · 修订第 7 段
• 点任意版本 → 文档面板预览那个版本
• 点"回退到此版本" → 当前文档变成那个版本（同时新建一个 v4 标记 fork-from）

多人同时编辑

同一文档可以多个用户同时打开。FOREVO 用段级锁避免冲突：

• 用户 A 点段 3 → 段 3 加锁（其他用户看到"用户 A 正在编辑"）
• 用户 B 同时点段 7 → 不同段，独立锁，并行修订
• 段 3 修订完成 → 自动解锁 → B 可以接着改段 3
• 所有人看到的内容实时同步（WebSocket 推送差量）

什么是项目

项目是一组相关任务和文档的容器。比起把所有对话扁平堆积，按项目组织能让你：

• 把"做产品方案"的相关 5 段对话归到同一个项目下
• 项目下所有员工自动共享上下文（不用每次重新粘背景）
• 项目级权限管理（可见性、协作者）
• 归档完成的项目（不污染日常对话列表）

项目类型详解

把对话挂到项目下

左栏每个项目卡片右上有「+」按钮 → 弹出选项：

• 新建一个对话（推荐）：项目自动创建一个 ChatID，员工带项目背景启动
• 加入已有对话：从对话列表选一个挂到本项目

项目文件管理

每个项目对应磁盘上一个目录：tenants/<user>/userdata/workspace/projects/<id-slug>/。员工执行任务时可以在这个目录里读写文件。

文件浏览器在右栏"项目文件" tab：

• 树形结构展示
• 点击文件预览（图片缩略图、代码语法高亮）
• 右键 → 重命名 / 删除 / 下载
• 拖拽上传到项目

实时预览（Pro+）

对 node / react 等需要 dev server 的项目，Pro+ 套餐可以一键启动实时预览：

1. 项目卡片"▶️ 启动预览"按钮
2. FOREVO 在沙盒内 npm install && npm run dev
3. 1-2 分钟后给一个公网可访问的 URL（比如 https://forevo.ai/preview/<id>:5173/）
4. 员工改代码 → vite HMR 推送 → 浏览器自动刷新
5. 15 分钟无访问自动 stop（节省资源），下次自动重启

项目分享 / 可见性

项目级 visibility 控制（覆盖单文件 visibility）：

• private（默认）：只所有者能看 + 列入 ACL 的协作者
• team：同公司所有员工都能看
• public：任何人有 URL 就能看
• signed：32-hex 短链 /s/<token>

员工 vs 公司：怎么选

一句话生成数字公司

1. 进入数字团队 → 数字公司 tab
2. 输入业务描述（5-30 字最佳）。例：
   「一家专注于 AI 教育的初创公司，主攻 K12 编程」
3. FOREVO 调用 LLM 生成 3-5 个品牌方案：每个方案有名称、slogan、Logo emoji、配色、定位
4. 选一个最喜欢的 → 进入「组织架构」步骤
5. FOREVO 生成完整组织：
   - CEO / CTO / CMO / CFO / COO 等高管
   - 各部门（研发、市场、销售、运营、客服）
   - 每个部门下的员工（带头像、人设、KPI、技能集）
6. 点「确认落地 · 创建数字公司」 → 后台 1-2 分钟批量建好所有员工 + 部门群聊

单独创建数字员工

1. 数字员工 tab → 右上「+ 创建员工」
2. 表单：名字、头像 emoji、岗位、人设描述、技能多选、模型选择
3. "AI 一键生成"按钮：填几个关键词 → AI 自动写完整 system prompt + 性格描述
4. 保存 → 立刻可用

员工人设 / 性格 / 技能

每个员工的「档案」记录：

训练员工 / 调整提示词

员工卡片 → "训练"按钮：

• 查看完整 system prompt（可手动改）
• "AI 重新生成 system prompt"（基于人设字段重组）
• 追加少量示例对话（few-shot 训练）
• 调整工作记忆条数（默认 50，最大 200）
• 切换底层模型（DeepSeek-V4 / GLM-5.1 / Claude / GPT-4 ...）

员工 KPI / 产出统计

员工卡片底部「📊 KPI」：

• 本月对话数
• 本月文档/PPT/表格产出数
• 本月 token 消耗（输入 + 输出）
• 用户给该员工的好评率（每条消息可点👍/👎）
• 定时任务完成率

部门与组织架构

「数字公司」自动建出的部门结构：

• 每个部门是一个群聊（GroupID）+ 部门高管 + 若干员工
• 群聊里默认开启 @ 提及自动响应
• 部门高管能"调度"自己部门的员工（自动分配子任务）
• 跨部门任务由 CEO 或 PMO 总协调

Wiki 文库

Wiki 是有结构的知识页面集合，类似 Notion。每个页面：

• Markdown 编辑器 + 富文本工具栏
• 支持嵌入：图片、视频、文档预览、代码块、表格
• 页面之间双向链接：[[页面名]] 自动建反向引用
• 层级结构：父子页面、面包屑导航
• 员工对话时自动 RAG 检索 Wiki 内容注入上下文

智能知识库（RAG）

Wiki 是给人看的，知识库是给员工读的。上传任意 PDF / Word / Markdown / 网页：

1. FOREVO 自动切块（chunk size ~500 tokens）
2. 每个 chunk 调用 embedding 模型转向量（默认 BGE-large-zh）
3. 存入向量数据库（默认本地 SQLite + sqlite-vss，可切 Qdrant / Milvus）
4. 员工对话时自动语义检索 top-5 chunks 注入上下文

上传 PDF / Word / Markdown

知识库页面右上「📤 上传」：

• 支持：.pdf / .docx / .pptx / .md / .txt / .html / .url
• 单文件最大 50MB，单次最多 20 个文件
• PDF 自动 OCR（如果是图片版）
• 处理进度实时显示：「解析中 → 切块 → 向量化 → 入库」

知识图谱

对话越多，员工自动从对话和 Wiki 中提取实体（人、产品、项目、概念）和关系，建出知识图谱：

• 2D 力导向布局，节点可拖拽
• 点节点 → 看连接到的所有页面、对话、文档
• 支持过滤：只看"产品"类节点、只看最近 7 天新增

员工自动读取知识

每条对话发出前，FOREVO 后台并行做 3 件事：

1. 用消息文本做 embedding 检索 → 召回相关 Wiki / 知识库 chunks
2. 检查对话所属项目 → 注入项目 README + 最近修改的文件
3. 读员工长期记忆 → 召回相关历史事实

这三块 context 拼到 system prompt 后面发给 LLM。员工感觉就像"它一直记得"。

三层记忆模型

关键事实抽取

每轮对话结束后异步：

1. 用一个轻量 LLM 调用从最近交互抽出"事实条目"
   例：「用户提到 GMV 目标是 Q3 达到 1 亿」「用户偏好简洁的 PPT 风格」
2. 每个事实条目带类型（人/事/物/偏好）+ 置信度 + 时间戳
3. 存入长期记忆，下次对话自动召回相关条目

会话自动总结

当工作记忆超过 50 条时：

• 最旧的 10 条被汇总成 1 条"摘要"，原文进会话记忆但不出现在工作记忆
• 摘要本身也是消息，AI 看到时知道"这是 N 条消息的总结"
• 如果用户提及"上次我们聊到的 X"，FTS 搜索旧对话原文召回

员工记忆共享 vs 独立

云端定时任务（Cron）

对任意员工说"每天 X 点做 Y"或"5 分钟后提醒我喝水"，FOREVO 自动调 cloud_cron_create 或 cloud_remind_after 把任务登记到云端调度器。

访问 /cron 看所有任务、运行历史、手动触发。

一次性延迟提醒

"5 分钟后 / 半小时后 / 今晚 8 点提醒我..." → cloud_remind_after：

• 转换成精确分钟的 cron spec
• 触发后自动 disable（不会重复）
• 到时调 cloud_notify_device 推送到所有在线硬件

多步骤任务链

cron job 的 steps 数组按序执行，后一步可用 ${prev.X} 引用前一步结果：

{
  "steps": [
    {"skill":"cloud_fetch_rss","args":{"sources":["https://...","https://..."]}},
    {"skill":"cloud_publish_doc","args":{
      "title":"今日早报 ${date}",
      "content":"${prev.items_md}"
    }},
    {"skill":"cloud_notify_device","args":{
      "text":"早报已就绪：${prev.url}"
    }}
  ]
}

事件触发（即将发布）

除了时间触发，未来支持事件触发：webhook / 邮件入站 / GitHub event / 微信消息关键词 等。

技能是什么

技能（Skill）是员工能调用的工具。给员工配技能 = 给他装能力。FOREVO 的技能分两类：

• cloud_*：云端执行（写文档、抓网页、定时任务、推通知...）
• device_*：硬件端执行（拍照、TTS、振动、读传感器...）

68 个内置技能

覆盖办公、数据、开发、创作四大场景。访问 SPA → 技能中心 看完整列表，按场景分组：

自动沉淀新技能

同一类任务连续成功 3 次，FOREVO 自动把执行模式提炼成可复用技能：

1. 记录每次任务的 prompt → tool_use chain → final result
2. 3 次相似任务后，自动 abstract 出参数化模板
3. 新技能标注「自动沉淀 · 来自 N 次成功」
4. 用户可重命名 / 调整参数 / 永久启用

从 GitHub 导入技能

粘贴任何 GitHub 仓库 URL → FOREVO：

1. 解析 README → 提取功能描述
2. 扫描代码 → 找到主要 entry function
3. 生成 trigger 规则（什么时候应该调这个技能）
4. 包装成 Skill 加入员工技能集

支持主流脚本语言（Python / JS / Go / Shell），需 Pro+ 套餐。

技能权限管理

每个员工可以单独限制能用哪些技能（白名单）：

• 客服员工只给 cloud_publish_doc + wechat_send（不让它发系统通知）
• 财务员工禁用 cloud_publish_page（防止误发外网）
• 所有员工统一禁用某个高风险技能（管理员后台）

技能 ACL 通过 X-Allowed-Skills HTTP 头逐请求强制（Wave 7B 安全机制）。

微信（个人 / 群 / 公众号）

三种接入模式：

飞书（员工进群 + @）

每个数字员工可以"入驻"飞书群：

1. 飞书管理后台创建机器人 → 拿到 webhook URL
2. FOREVO 设置页填 URL → 关联到指定员工
3. 飞书群里 @员工名 → 消息推到 FOREVO → 员工回复 → 反向推回飞书群
4. 支持文件附件、@ 多人、引用消息

钉钉

同飞书机制。钉钉机器人 webhook + outgoing webhook 双向通信。

Slack

Slack App + Events API + Slash Commands。

Discord / Telegram / QQ

• Discord：Bot Token → Guild → Channel @ 触发
• Telegram：BotFather 拿 token → /start 加机器人
• QQ：Mirai / NoneBot 协议适配

支持哪些硬件

• 📱 手机 App：Android（FOREVO Mobile）/ iOS（计划）
• 👓 智能眼镜：FOREVO P6 + 任何支持 WSS 的 AR 眼镜
• 🎙 智能音箱：自研硬件 + 第三方（小爱兼容协议）
• ⌚ 智能手表：HarmonyOS / WearOS（计划）
• 🏠 IoT 设备：通过 cloud_notify_device 接收推送

设备绑定（扫码 5 秒）

1. SPA → 设置 → 多终端 → 「+ 绑定设备」
2. 页面显示二维码（含一次性 pair code，10 分钟有效）
3. 硬件 app 扫码 → 自动获取 device_token
4. token 即"设备身份证"，所有调用都用 Authorization: Bearer <token>
5. 解绑：设备列表 → 「解绑」按钮 → token 立即失效

15 项硬件能力

硬件设备注册时会上报支持的 capabilities，员工调用 device_* 技能时自动按能力路由：

语音召唤 / TTS 播报

典型链路：

1. 用户对硬件说"嗨小 F，5 分钟后提醒我喝水"
2. 硬件 STT → 文本
3. WSS 上行送到 FOREVO → 自动路由到 scheduler agent
4. agent 调 cloud_remind_after 创建一次性 cron
5. 员工回复 TTS 文本：「好的，5 分钟后提醒你」
6. WSS 下行回硬件 → 硬件 TTS 播报
7. 5 分钟后 cron 触发 → cloud_notify_device 推到该硬件 → TTS 播报「喝水时间到」

摄像头 / 屏幕识别

• 用户拍照 → take_photo 上传 → 员工调 OCR / VLM 看图回答
• 智能眼镜双摄 → dual_camera_describe → 自动描述场景
• 手机截屏 → screen_capture → 员工分析屏幕内容

主动推送通知

cloud_notify_device 把任意文本/图片/链接推到指定设备或所有当前用户在线设备：

{"skill":"cloud_notify_device","args":{
  "text":"客户 X 刚才在群里 @了你",
  "priority":"high",
  "device_id":"p6-d475..."  // 不填即推所有在线设备
}}

SaaS 直接用

访问 forevo.ai/register 即可。零部署，注册即送 3 天 Pro 试用。数据存我们的服务器（中国上海机房）。

本地 Docker 部署

所有对话、文档、员工数据留在你自己的服务器。

# 1. clone
git clone https://github.com/marswei/forevo.git
cd forevo

# 2. 配置（admin 密码 + LLM API key）
cp .env.example .env
nano .env

# 3. 一行启动
docker compose up -d

# 4. 浏览器打开 http://your-server:8080

包含完整功能集，无 SaaS 套餐限制。

桌面客户端

Windows / macOS / Linux 原生客户端，对话历史本地存储，零延迟。下载页：soft.forevo.ai（即将开放）

对接本地 Ollama / LM Studio

不想用云 LLM？连本地：

1. 装 Ollama → ollama pull llama3.1:70b
2. FOREVO 设置 → LLM 路由 → 加 provider http://localhost:11434
3. 员工模型选 llama3.1:70b → 完全离线运行

套餐对比

实时套餐和用量看 /billing。

Token 额度规则

• 每设备每天 1,000,000 token 额度（约 75 万汉字）
• 试用 + Pro 内全部 LLM 能力可用
• 额度不够触发 HTTP 429 quota_exceeded，第二天 0 点重置
• 管理员可临时加额（联系 admin@forevo.ai）

磁盘配额

所有发布的文档/PPT/表格/项目存在 tenants/<user>/userdata/workspace/projects/，按套餐限额。超出新发布会被拒。可在 SPA → 项目空间 删除旧项目释放空间。

邀请奖励

• 分享自己的邀请码给好友 → 好友注册时填
• 双方各得 500 积分
• 无上限，多邀多得
• 查看自己邀请码 + 已邀请人数 → 左下角用户头像 → 「🎁 邀请」

注册 / 登录

注册必填：用户名（3-30 位小写字母/数字/连字符）、手机号、短信验证码、密码（≥6 位）。邮箱选填。

数据隐私 / 私密发布

默认所有云端发布的内容公开可读（URL 访问无需登录）。如果内容涉密：

• 对员工说"私密发布"或"只我自己看"
• 或工具调用显式传 visibility="private"

私密内容必须登录或带正确设备 Bearer Token 才能访问。

短链分享 / 可见性

每次发布同时返回两个链接：

• 直链：https://forevo.ai/u/<user>/projects/<dir>/index.html
• 短链：https://forevo.ai/s/<32位随机> 不可枚举

两种链接对私密内容都强制要求认证，不会因为"用了短链"就绕过 visibility。

审计日志

所有发布操作 + 工具调用 + tier 变更 + 文件访问都有审计日志（管理员可查），含：

• 谁（user_id + device_id）
• 做了什么（skill name + args）
• 什么时间（精确到毫秒）
• 结果（成功/失败 + 用量）

Bearer Device Token

所有 API 调用用 Authorization: Bearer <device_token> 鉴权。token 在硬件扫码绑定时下发，长效（不过期，除非用户手动解绑）。

Anthropic-兼容 LLM Proxy

POST /api/llm/proxy/v1/messages 完全兼容 Anthropic Messages API，可直接接入：

• Claude Code / Cursor / Hermes / openclaw
• 任何支持 Anthropic 格式的 SDK
• 支持 tool_use / tool_result / streaming

cloud_skill 直调 REST

不想走 LLM agent loop？直接 REST 调技能：

POST /api/cloud/skill/cloud_publish_doc
Authorization: Bearer <device_token>
Content-Type: application/json

{"title":"测试","content":"# Hello\n\nworld","visibility":"private"}

白名单：cloud_publish_*、cloud_fetch_*、cloud_list_my_pages、cloud_remind_after。

MCP Server（未来）

Wave 11 计划把 cloud_skills 同时暴露成 MCP server，让 Claude Desktop / Cursor / openclaw 等外部 agent 直接 connect 调用。

FAQ · LLM 暂不可用？

1. token 额度用尽 → 第二天 0 点自动恢复
2. 底层 LLM 提供商抖动（DeepSeek / GLM 偶尔超时）→ 自动 fallback 到备用 provider
3. 设备 Bearer Token 过期 → 重新扫码绑定一次

FAQ · 硬件经常掉线？

已修复：

• 30 秒一次的活跃心跳，防止 IdleWatchdog 误回收
• 服务端重启时发标准 close frame 1012 而不是 TCP EOF
• Bearer 反代支持自动唤醒 + 端口就绪等待，cold-start 1 秒内
• 客户端心跳间隔 30s + pong 阈值 120s（容忍后台节流）

FAQ · 页面加载慢？

• 首次访问预期 3-5 秒（要下载 ~1MB SPA bundle）
• 第二次访问应该 < 1 秒（浏览器强缓存 7 天）
• Trial popup 现在用 iframe 并行加载，不再阻塞 SPA 下载
• 已删除被墙的 fonts.googleapis.com（之前会卡 5-10s）
• 如果还慢，强刷一下（Ctrl+Shift+R）

FAQ · Token 用完了怎么办？

• 等第二天 0 点自动重置（每天 1M token）
• 升级 Pro 套餐拿到更高额度
• 临时方案：连本地 Ollama 不消耗云额度（看 #deploy-ollama）

FAQ · 员工胡编 URL？

偶尔老旧模型会"幻觉"出一个不存在的 URL（"已发布，链接是 https://...random"）。FOREVO 已加强系统提示词强制要求员工必须真调用 cloud_publish_* 工具才能引用 URL。如果发现幻觉，截图反馈给 admin@forevo.ai。

更新日志

2026-04-27 · Wave 9.6（最新）

• 使用手册扩展：完整覆盖对话、协同修订、项目空间、知识库、记忆、技能、硬件、API
• 数字团队顶部导航 + 营销 tagline + 空状态推数字公司 CTA
• WSS 稳定性：硬件不再因 idle 误判被掉线
• 性能：去除 fonts.googleapis.com 阻塞，trial popup 不再阻塞 SPA 下载
• 注册流程：邮箱改为选填
• 5 处 NecoClaw 残留替换为 FOREVO

2026-04-25 · Wave 9.4 + Wave 10

• 云端定时任务（Cron）+ 5 个 LLM 工具 + /cron UI
• 多 Agent 路由：4 个内置 agent + 自定义 + 自动路由 + sub-agent invoke

2026-04-24 · Wave 9.5

• visibility: public/private + 32-hex 短链 /s/<token>
• 磁盘配额按套餐分级，发布前预校验
• 套餐分级 + IdleWatchdog