私
私域Agent · 用户使用手册
导图进，成稿出。多智能体协作的内容生产中枢。
适用版本 v0.12026 年 8 月阅读时间约 10 分钟
1第一次使用：登录
拿到账号后，两分钟内进入工作台。
- 打开系统地址（管理员提供），页面右侧是登录表单。
- 输入用户名和密码 → 点「登录」。密码连续输错 5 次会锁定 15 分钟，这是防暴力破解保护。
- 进入总览页。左侧导航栏是你能用的全部功能；没有权限的菜单不会出现。
登录状态 12 小时有效，超时后系统会提示重新登录，正在生成的任务不会因此中断。
2核心流程：从一段导图到一份成稿
整个系统就为这一条流水线服务，看懂它就学会了 80%。
① 新建任务
贴导图 / 传文件→
② AI 拆解
导图变内容段→
③ 开始生成
Agent 流水线→
④ 审查
通过 / 打回→
⑤ 合稿交付
下载成稿
- 新建任务：进「任务看板」→ 点「＋ 新建任务」。唯一必填的是任务目标；导图可以粘贴文字、上传图片（自动 OCR）或导入 txt/md 文档。验收标准留空系统会自动生成，也可以点「✦ AI 建议验收标准」再手动修改。
- 拆解：点「创建并拆解」，AI 把导图编译成一个个内容段（每段有主题、时间区间、负责的 Agent）。拆解是幂等的，重复点击不会产生两套段落。
- 生成：点「▶ 开始生成」。各 Agent 按画布流程依次生产每一段，全程自动质检；画布设置了「全局总监」时，每段完成后总监还会审核是否跑偏。
- 审查：生成完的段落转「人工审查」。你逐段看，通过或打回（打回时写意见，Agent 会按你的意见重新生成，并自动沉淀记忆建议）。
- 交付：全部段落通过后自动合稿，任务看板里可预览全文并下载。
点「开始生成」前系统会自动做点数预检：预估本次成本并与余额比对（含 20% 缓冲），余额不够会直接告知差额，不会让你跑到一半失败。
3任务看板：生成、审查、暂停与删除
这里是日常主战场。
生成中你能做的事
| 操作 | 说明 |
|---|
| ⏸ 暂停 | 当前这段做完后停下（不浪费已花的点数），已完成段落保留。 |
| ▶ 继续 | 从暂停处恢复，只跑剩余段落。 |
| ■ 停止 | 终止本次运行，已生成内容保留在各自段落里。 |
关于失败与重试
单段失败（如网络超时）会自动重试，不会影响其他段。点数不足、Key 失效这类"不会自愈"的错误会触发熔断：整个任务立即停止并明确告知原因——点数类会提示「请联系管理员增加点数」，限流类会建议「更换其他模型」。
删除任务
任务卡片上的「删除任务」按钮可删除任务及其全部段落记录（运行中/暂停中的任务需先停止）。删除需二次确认，成稿文件保留在服务器供审计。
4知识库：导入、分类、编辑与迁移
Agent 写稿的"素材库"。检索是语义级的，不依赖关键词完全匹配。
- 建库：知识库页 → 新建知识库。你建的库默认只有你自己和管理员可见。
- 导入：选中新库 → 「📤 上传到当前分类」，支持 docx / srt / md / txt / json / jsonl，单文件 ≤ 50MB。
- 分类：可在库内建多级分类树（一级/二级/任意层级）；「✦ AI 自动分类」会让 AI 预分类，你点「确认 AI 分类」生效。
- 文件级管理：每个已导入文件支持 ✏️ 在线编辑（txt/md，保存自动重建索引）、移到其他知识库、删除（向量索引同步清理）。
- 挂给 Agent：到「Agent 管理」编辑某个 Agent 的「挂接知识库」，它生产时只从挂接的库里检索素材。
「Agent 已消费知识」列表里的锁定片段：同一 Agent 不会重复使用同一段素材（避免成稿重复）；点「重新开放」可让它再次可用。
5Agent 画布与全局总监
画布决定"谁先写、谁后写、谁质检、谁兜底"。
- 编排：从左侧 Agent 列表点击添加节点，拖动连线建立上下游（上游写完 → 下游开工）。节点可停用（跳过不执行）。
- 保存：任务创建时会冻结画布快照，之后改画布不影响已建任务。
- 全局总监（防跑偏）：工具栏选择一个 Agent 作为总监，三档模式任选——
| 模式 | 行为 |
|---|
| 疑似跑偏才审（默认） | 质检发现问题或重做过一轮才送审，省点数。 |
| 每段必审 | 每段生成完总监都过目，重要交付用。 |
| 仅记录不拦截 | 总监意见只记录，不自动重做。 |
总监判定跑偏后会给出「原因 + 拉回指导」，该段自动带指导重做一次；重做仍跑偏则转人工，不会无限烧点数。
6Agent / 技能库 / 提示模板
三件套决定每段内容的生产方式。
- Agent 管理：每个 Agent 可配 挂接知识库、绑定技能、提示模板、模型、写作规则、工具权限。内置 15 个 Agent 覆盖拆解/生产/质检/组合全流程，全部可删除（被引用时会拦截提醒）。
- 技能库：可复用的写作方法（如"钩子设计"）。Agent 绑定后生成时自动注入。
- 提示模板：角色提示 + 任务模板 + 约束 + 输出结构，创建任务时冻结快照。
三者创建时都有「✦ AI 帮我创建」入口：用大白话描述需求（像跟同事交代），AI 产出结构化草稿并自动做冲突检测（口语↔书面、要求自相矛盾、跨资源冲突等），确认后入库。
7模型管理与点数
模型是"发动机"，点数是"油钱"。
模型管理
每个 Provider（如 DeepSeek）配 API Key（存 macOS 钥匙串，不落库）+ 模型列表。可用「测试连通」验证；可指定全局默认模型。遇到「限流」提示时，来这里切换其他模型即可。
点数规则
| 项目 | 规则 |
|---|
| 折算 | 10 点数 = 1 Token，按实际用量扣。 |
| 余额 | 余额本身不设上限；低于 10 点数暂停 AI 调用。 |
| 发放 | 管理员在「用量与账单 → 用户点数」发放，支持三档快捷按钮：一档 1千万 / 二档 1亿 / 三档 10亿，也可手动输入任意数额。 |
| 预检 | 启动生成前自动预估成本，余额需覆盖预估 + 20% 缓冲，不足时明确告知差额。 |
8用量账单 / 运营看板 / 日志与记忆
- 用量与账单：看自己的 Token 用量与费用明细；管理员额外可看用户归属汇总和点数发放。
- 运营看板：管理员视角=全组织队列/任务/告警/备份；普通用户只看到自己的任务与用量（数据隔离在服务端强制）。
- 日志与通知：运行追踪（Trace）与系统通知。通知支持「✓ 全部已读」一键清零。普通用户只能看到自己发起的运行。
- 记忆库：打回意见会自动生成「待确认记忆」→ 你确认后沉淀为长期记忆，后续生成自动引用（相当于教 Agent 记住你的偏好）。
9访问控制：成员与权限
添加成员
- 用户名 ≥ 3 个字符（字母/数字/._-，不支持中文）；初始密码 ≥ 10 个字符。表单下方有实时提示，两项都 ✓ 时「添加成员」按钮才会亮。
- 选角色：只读 / 审查 / 编辑 / 管理员，或自定义角色。
权限体系
16 项细分权限分 4 组（内容生产 / 资产与知识 / 数据与洞察 / 系统管理），在「角色权限矩阵」逐项勾选。保存后立即生效；编辑期间页面轮询不会覆盖你未保存的勾选。
资源可见性：用户自建的知识库/技能/模板/任务默认私有（仅本人+管理员）；需要共享时在资源授权里给指定成员授权，或「发布全局」对全组织可见。
10常见问题 FAQ
点「开始生成」提示"点数不足"怎么办？
提示里会写明预估需要多少、你还差多少。联系管理员在「用量与账单」按档位发放点数后重试即可。
生成中报"模型服务商限流（429）"？
系统已自动放慢重试并尝试切换备用 Provider。若持续失败，到「模型管理」更换其他模型再重新运行失败段。
拆解失败 / 一直提示"任务还没有内容段"？
拆解依赖 AI 调用。先到「模型管理」点「测试连通」确认当前模型可用（API Key 失效或服务商地域限制都会导致失败），修正后回到任务页重新点拆解。导图不需要上传文件，粘贴文字大纲即可。
为什么我看不到某个知识库 / 任务？
资源默认私有，只有创建者和管理员可见。需要协作请让管理员在「访问控制 → 资源授权」给你授权，或将资源发布为全局。
密码忘了 / 账号被锁？
联系管理员在「访问控制」重置密码（≥10 位）。连续输错 5 次锁 15 分钟，等待即可自动解锁。
段落打回后 Agent 会按我的意见改吗？
会。打回时填写的意见会直接注入下一轮生成；同时系统自动生成「记忆建议」，你在记忆库确认后，这类偏好以后所有任务都生效。
同一个错误反复出现，Agent 会不会一直烧点数？
不会。点数/密钥类错误触发熔断停止整个任务；每次运行还有 240 轮模型调用总预算，总监重做也最多 1 次，多重防线防失控。
数据安全吗？
API Key 存 macOS 钥匙串；密码加盐哈希；登录有防爆破锁定；每 6 小时自动备份且保留 14 份，管理员可一键「恢复演练」验证备份可用。
私域Agent · 内容生产中枢 —— 遇到本手册未覆盖的问题，联系管理员或截图报错信息反馈。