Appearance
快速上手
目标：5 分钟内跑通「第一个 Agent → 第一次对话 → 第一个 Todo → 看到记忆」。 假设已按 安装 启动。
1. 第一个 Agent
启动后默认有 agent 1（管理者 / manager）在工作。新建 Agent 看 用户手册·Agent 列表与新建：
- 在左侧 AgentRail 点 + 新建；
- 填名称、选一个角色（或留空让系统基于你给它生成画像）；
- 保存后它会出现在聊天列表，可单独对它发起对话。
2. 第一次对话
在输入栏（见 输入栏）直接打字，回车发送：
- 说 「帮我安排一下今天的日程」 —— 它会调用 Todo/Schedule 工具；
- 说 「把刚才的话记住」 —— 触发记忆写入；
- 说 「读一下今天的
USER.md」 —— 触发记忆检索。
每条消息按下一次，Agent 会走路 规划 → 工具调用 → 回答 的管线；遇到需审批的操作（写文件/高权限）会弹出 隐私审批卡片，确认后才继续。
3. 第一个 Todo / 日程
点击顶部 待办/日程 图标（见 待办/日程/定时任务），或直接用对话创建：
> 每天早上 9 点帮我把今日天气同步到周会它会自动拆成 Todo + Schedule，并可配置成定时重复。在待办/日程页能看到状态流转（待办→进行中→已完成）。CLI 里则对应 todos create --title "买牛奶" --deadline 2026-07-05T18:00 与 todos complete <id>（见 CLI 手册）。
4. 查看记忆
- 对话页右下/侧栏的 记忆入口：查看当前 agent 的
dialogue_*对话树与长期记忆； - 管理者可在设置/汇报页看到所有 agent 的记忆规模；
- 在对话里说 「回顾一下上个月我关注的 X」 会触发 RAG 检索，返回你曾经记录的内容。
5. 试试更进阶的东西
装好了就想玩起来？下一步：
常见踩坑
| 现象 | 原因 / 处理 |
|---|---|
| 对话一直转圈 | 检查 .env 的 BASE_URL/API_KEY；没有模型返回就换 DEFAULT_MODEL |
| 工具调用被审批卡住 | 这是隐私设计的正常行为；在审批卡片点允许即可，或用 FAMILIARS_APPROVAL_DISABLED=1 关掉（不推荐） |
| 记忆写入要很久 | 首次需下 bge-m3 模型，放行后正常 |
| 看不到数字人 | 需本地 GPU 与 GPT-SoVITS 模型，属高级功能，见 数字人 |
下一步：界面导览 →