yawan-workbench/用户使用手册.html

<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>私域Agent · 用户使用手册</title>
<style>
:root {
  --page: #f7f8fa; --bg: #ffffff; --panel: #f6f6f6;
  --border: #e3e7f1; --ink-1: #18181a; --ink-2: #3f4148; --ink-3: #8b8e98;
  --jade: #1f6b52; --jade-soft: rgba(31,107,82,.08); --gold: #c4a962;
  --warn: #c98a1b; --down: #d5484d;
}
* { box-sizing: border-box; }
body { margin: 0; background: var(--page); color: var(--ink-2); font-family: Inter, "Noto Sans SC", "PingFang SC", "Microsoft YaHei UI", system-ui, sans-serif; font-size: 14px; line-height: 1.85; }
.wrap { max-width: 960px; margin: 0 auto; padding: 40px 24px 80px; }

/* 封面 */
.cover { text-align: center; padding: 56px 20px 44px; background: var(--bg); border: 1px solid var(--border); border-radius: 24px; margin-bottom: 28px; }
.cover .logo { width: 56px; height: 56px; margin: 0 auto 18px; display: grid; place-items: center; border-radius: 14px; background: linear-gradient(135deg, #1f6b52, #2e8b6a); color: #fff8e7; font-size: 26px; font-weight: 700; border: .5px solid var(--gold); }
.cover h1 { margin: 0 0 6px; color: var(--ink-1); font-size: 30px; font-weight: 650; letter-spacing: -.01em; }
.cover p { margin: 0; color: var(--ink-3); font-size: 14px; }
.cover .meta { margin-top: 16px; display: inline-flex; gap: 8px; flex-wrap: wrap; justify-content: center; }
.cover .meta span { padding: 3px 12px; border-radius: 999px; background: var(--panel); color: var(--ink-3); font-size: 11.5px; }

/* 章节 */
h2.sec { margin: 44px 0 6px; color: var(--ink-1); font-size: 21px; font-weight: 650; display: flex; align-items: center; gap: 10px; }
h2.sec .no { flex: 0 0 30px; width: 30px; height: 30px; display: grid; place-items: center; border-radius: 9px; background: var(--jade); color: #fff; font-size: 14px; font-weight: 700; }
.sec-sub { margin: 0 0 14px 40px; color: var(--ink-3); font-size: 12.5px; }

.card { background: var(--bg); border: 1px solid var(--border); border-radius: 14px; padding: 20px 22px; margin: 14px 0; }
.card h3 { margin: 0 0 8px; color: var(--ink-1); font-size: 15px; font-weight: 600; }
.card p { margin: 6px 0; }

/* 步骤 */
.steps { counter-reset: step; margin: 10px 0; padding: 0; list-style: none; }
.steps li { counter-increment: step; position: relative; padding: 0 0 14px 44px; }
.steps li::before { content: counter(step); position: absolute; left: 0; top: 2px; width: 26px; height: 26px; display: grid; place-items: center; border-radius: 50%; background: var(--jade-soft); color: var(--jade); font-size: 13px; font-weight: 700; }
.steps li::after { content: ""; position: absolute; left: 13px; top: 32px; bottom: 2px; width: 1px; background: var(--border); }
.steps li:last-child::after { display: none; }
.steps b { color: var(--ink-1); }

/* 提示条 */
.tip, .warn, .danger { display: flex; gap: 10px; align-items: flex-start; padding: 12px 16px; border-radius: 10px; margin: 12px 0; font-size: 13px; }
.tip { background: var(--jade-soft); border: 1px solid rgba(31,107,82,.18); }
.warn { background: rgba(201,138,27,.08); border: 1px solid rgba(201,138,27,.25); }
.danger { background: rgba(213,72,77,.07); border: 1px solid rgba(213,72,77,.25); }
.tip::before { content: "💡"; }
.warn::before { content: "⚠️"; }
.danger::before { content: "🚫"; }

/* 表格 */
table { width: 100%; border-collapse: collapse; margin: 12px 0; background: var(--bg); border: 1px solid var(--border); border-radius: 12px; overflow: hidden; font-size: 13px; }
th { background: var(--panel); color: var(--ink-1); font-weight: 600; text-align: left; padding: 10px 14px; border-bottom: 1px solid var(--border); }
td { padding: 10px 14px; border-bottom: 1px solid var(--border); vertical-align: top; }
tr:last-child td { border-bottom: 0; }
td b { color: var(--ink-1); }
code { padding: 1px 7px; border-radius: 6px; background: var(--panel); color: var(--jade); font-size: 12.5px; font-family: "SF Mono", Menlo, Consolas, monospace; }
kbd { padding: 2px 7px; border-radius: 6px; background: var(--ink-1); color: #fff; font-size: 11.5px; font-family: inherit; }

/* 流程图 */
.flow { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; margin: 14px 0; }
.flow .node { padding: 8px 16px; border-radius: 10px; background: var(--bg); border: 1px solid var(--border); font-size: 13px; font-weight: 600; color: var(--ink-1); }
.flow .node.hot { background: var(--jade); border-color: var(--jade); color: #fff; }
.flow .arr { color: var(--ink-3); }

/* FAQ */
details { background: var(--bg); border: 1px solid var(--border); border-radius: 12px; padding: 0; margin: 10px 0; overflow: hidden; }
summary { cursor: pointer; padding: 14px 18px; font-weight: 600; color: var(--ink-1); list-style: none; display: flex; align-items: center; gap: 10px; }
summary::before { content: "?"; flex: 0 0 22px; width: 22px; height: 22px; display: grid; place-items: center; border-radius: 50%; background: var(--jade-soft); color: var(--jade); font-size: 13px; font-weight: 700; }
details[open] summary { border-bottom: 1px solid var(--border); }
details .ans { padding: 14px 18px 16px 50px; }

.toc { background: var(--bg); border: 1px solid var(--border); border-radius: 14px; padding: 18px 22px; }
.toc b { color: var(--ink-1); }
.toc ol { margin: 8px 0 0; padding-left: 22px; }
.toc li { margin: 3px 0; }
.toc a { color: var(--jade); text-decoration: none; }
.toc a:hover { text-decoration: underline; }
@media print { body { background: #fff; } .cover { border: none; } }
</style>
</head>
<body>
<div class="wrap">

<div class="cover">
  <div class="logo">私</div>
  <h1>私域Agent · 用户使用手册</h1>
  <p>导图进，成稿出。多智能体协作的内容生产中枢。</p>
  <div class="meta"><span>适用版本 v0.1</span><span>2026 年 8 月</span><span>阅读时间约 10 分钟</span></div>
</div>

<div class="toc">
  <b>目录</b>
  <ol>
    <li><a href="#s1">第一次使用：登录</a></li>
    <li><a href="#s2">核心流程：从一段导图到一份成稿</a></li>
    <li><a href="#s3">任务看板：生成、审查、暂停与删除</a></li>
    <li><a href="#s4">知识库：导入、分类、编辑与迁移</a></li>
    <li><a href="#s5">Agent 画布与全局总监</a></li>
    <li><a href="#s6">Agent / 技能库 / 提示模板</a></li>
    <li><a href="#s7">模型管理与点数</a></li>
    <li><a href="#s8">用量账单 / 运营看板 / 日志与记忆</a></li>
    <li><a href="#s9">访问控制：成员与权限</a></li>
    <li><a href="#s10">常见问题 FAQ</a></li>
  </ol>
</div>

<!-- ============ 1 登录 ============ -->
<h2 class="sec" id="s1"><span class="no">1</span>第一次使用：登录</h2>
<p class="sec-sub">拿到账号后，两分钟内进入工作台。</p>
<div class="card">
  <ol class="steps">
    <li><b>打开系统地址</b>（管理员提供），页面右侧是登录表单。</li>
    <li><b>输入用户名和密码</b> → 点「登录」。密码连续输错 5 次会锁定 15 分钟，这是防暴力破解保护。</li>
    <li><b>进入总览页</b>。左侧导航栏是你能用的全部功能；没有权限的菜单不会出现。</li>
  </ol>
  <div class="warn">登录状态 12 小时有效，超时后系统会提示重新登录，正在生成的任务<b>不会因此中断</b>。</div>
</div>

<!-- ============ 2 核心流程 ============ -->
<h2 class="sec" id="s2"><span class="no">2</span>核心流程：从一段导图到一份成稿</h2>
<p class="sec-sub">整个系统就为这一条流水线服务，看懂它就学会了 80%。</p>
<div class="flow">
  <span class="node">① 新建任务<br><small>贴导图 / 传文件</small></span><span class="arr">→</span>
  <span class="node">② AI 拆解<br><small>导图变内容段</small></span><span class="arr">→</span>
  <span class="node hot">③ 开始生成<br><small>Agent 流水线</small></span><span class="arr">→</span>
  <span class="node">④ 审查<br><small>通过 / 打回</small></span><span class="arr">→</span>
  <span class="node">⑤ 合稿交付<br><small>下载成稿</small></span>
</div>
<div class="card">
  <ol class="steps">
    <li><b>新建任务</b>：进「任务看板」→ 点「＋ 新建任务」。唯一必填的是<b>任务目标</b>；导图可以粘贴文字、上传图片（自动 OCR）或导入 txt/md 文档。<b>验收标准</b>留空系统会自动生成，也可以点「✦ AI 建议验收标准」再手动修改。</li>
    <li><b>拆解</b>：点「创建并拆解」，AI 把导图编译成一个个内容段（每段有主题、时间区间、负责的 Agent）。拆解是幂等的，重复点击不会产生两套段落。</li>
    <li><b>生成</b>：点「▶ 开始生成」。各 Agent 按画布流程依次生产每一段，全程自动质检；画布设置了「全局总监」时，每段完成后总监还会审核是否跑偏。</li>
    <li><b>审查</b>：生成完的段落转「人工审查」。你逐段看，<b>通过</b>或<b>打回</b>（打回时写意见，Agent 会按你的意见重新生成，并自动沉淀记忆建议）。</li>
    <li><b>交付</b>：全部段落通过后自动合稿，任务看板里可预览全文并下载。</li>
  </ol>
  <div class="tip">点「开始生成」前系统会<b>自动做点数预检</b>：预估本次成本并与余额比对（含 20% 缓冲），余额不够会直接告知差额，不会让你跑到一半失败。</div>
</div>

<!-- ============ 3 任务看板 ============ -->
<h2 class="sec" id="s3"><span class="no">3</span>任务看板：生成、审查、暂停与删除</h2>
<p class="sec-sub">这里是日常主战场。</p>
<div class="card">
  <h3>生成中你能做的事</h3>
  <table>
    <tr><th style="width:130px">操作</th><th>说明</th></tr>
    <tr><td><b>⏸ 暂停</b></td><td>当前这段<b>做完后</b>停下（不浪费已花的点数），已完成段落保留。</td></tr>
    <tr><td><b>▶ 继续</b></td><td>从暂停处恢复，只跑剩余段落。</td></tr>
    <tr><td><b>■ 停止</b></td><td>终止本次运行，已生成内容保留在各自段落里。</td></tr>
  </table>
  <h3 style="margin-top:16px">关于失败与重试</h3>
  <p>单段失败（如网络超时）会自动重试，<b>不会</b>影响其他段。点数不足、Key 失效这类"不会自愈"的错误会触发<b>熔断</b>：整个任务立即停止并明确告知原因——点数类会提示「请联系管理员增加点数」，限流类会建议「更换其他模型」。</p>
  <h3 style="margin-top:16px">删除任务</h3>
  <p>任务卡片上的「删除任务」按钮可删除任务及其全部段落记录（运行中/暂停中的任务需先停止）。删除需二次确认，成稿文件保留在服务器供审计。</p>
</div>

<!-- ============ 4 知识库 ============ -->
<h2 class="sec" id="s4"><span class="no">4</span>知识库：导入、分类、编辑与迁移</h2>
<p class="sec-sub">Agent 写稿的"素材库"。检索是语义级的，不依赖关键词完全匹配。</p>
<div class="card">
  <ol class="steps">
    <li><b>建库</b>：知识库页 → 新建知识库。你建的库默认<b>只有你自己和管理员可见</b>。</li>
    <li><b>导入</b>：选中新库 → 「📤 上传到当前分类」，支持 docx / srt / md / txt / json / jsonl，单文件 ≤ 50MB。</li>
    <li><b>分类</b>：可在库内建<b>多级分类树</b>（一级/二级/任意层级）；「✦ AI 自动分类」会让 AI 预分类，你点「确认 AI 分类」生效。</li>
    <li><b>文件级管理</b>：每个已导入文件支持 <b>✏️ 在线编辑</b>（txt/md，保存自动重建索引）、<b>移到其他知识库</b>、<b>删除</b>（向量索引同步清理）。</li>
    <li><b>挂给 Agent</b>：到「Agent 管理」编辑某个 Agent 的「挂接知识库」，它生产时只从挂接的库里检索素材。</li>
  </ol>
  <div class="tip">「Agent 已消费知识」列表里的<b>锁定</b>片段：同一 Agent 不会重复使用同一段素材（避免成稿重复）；点「重新开放」可让它再次可用。</div>
</div>

<!-- ============ 5 画布 ============ -->
<h2 class="sec" id="s5"><span class="no">5</span>Agent 画布与全局总监</h2>
<p class="sec-sub">画布决定"谁先写、谁后写、谁质检、谁兜底"。</p>
<div class="card">
  <ol class="steps">
    <li><b>编排</b>：从左侧 Agent 列表点击添加节点，拖动连线建立上下游（上游写完 → 下游开工）。节点可停用（跳过不执行）。</li>
    <li><b>保存</b>：任务创建时会冻结画布快照，之后改画布<b>不影响</b>已建任务。</li>
    <li><b>全局总监（防跑偏）</b>：工具栏选择一个 Agent 作为总监，三档模式任选——
      <table>
        <tr><th style="width:170px">模式</th><th>行为</th></tr>
        <tr><td><b>疑似跑偏才审</b>（默认）</td><td>质检发现问题或重做过一轮才送审，省点数。</td></tr>
        <tr><td><b>每段必审</b></td><td>每段生成完总监都过目，重要交付用。</td></tr>
        <tr><td><b>仅记录不拦截</b></td><td>总监意见只记录，不自动重做。</td></tr>
      </table>
      总监判定跑偏后会给出「原因 + 拉回指导」，该段<b>自动带指导重做一次</b>；重做仍跑偏则转人工，不会无限烧点数。</li>
  </ol>
</div>

<!-- ============ 6 Agent/技能/模板 ============ -->
<h2 class="sec" id="s6"><span class="no">6</span>Agent / 技能库 / 提示模板</h2>
<p class="sec-sub">三件套决定每段内容的生产方式。</p>
<div class="card">
  <ul>
    <li><b>Agent 管理</b>：每个 Agent 可配 挂接知识库、绑定技能、提示模板、模型、写作规则、工具权限。内置 15 个 Agent 覆盖拆解/生产/质检/组合全流程，全部<b>可删除</b>（被引用时会拦截提醒）。</li>
    <li><b>技能库</b>：可复用的写作方法（如"钩子设计"）。Agent 绑定后生成时自动注入。</li>
    <li><b>提示模板</b>：角色提示 + 任务模板 + 约束 + 输出结构，创建任务时冻结快照。</li>
  </ul>
  <div class="tip">三者创建时都有「<b>✦ AI 帮我创建</b>」入口：用大白话描述需求（像跟同事交代），AI 产出结构化草稿并自动做<b>冲突检测</b>（口语↔书面、要求自相矛盾、跨资源冲突等），确认后入库。</div>
</div>

<!-- ============ 7 模型与点数 ============ -->
<h2 class="sec" id="s7"><span class="no">7</span>模型管理与点数</h2>
<p class="sec-sub">模型是"发动机"，点数是"油钱"。</p>
<div class="card">
  <h3>模型管理</h3>
  <p>每个 Provider（如 DeepSeek）配 API Key（存 macOS 钥匙串，不落库）+ 模型列表。可用「测试连通」验证；可指定全局默认模型。遇到「限流」提示时，来这里<b>切换其他模型</b>即可。</p>
  <h3 style="margin-top:14px">点数规则</h3>
  <table>
    <tr><th>项目</th><th>规则</th></tr>
    <tr><td><b>折算</b></td><td>10 点数 = 1 Token，按实际用量扣。</td></tr>
    <tr><td><b>余额</b></td><td>余额本身不设上限；低于 10 点数暂停 AI 调用。</td></tr>
    <tr><td><b>发放</b></td><td>管理员在「用量与账单 → 用户点数」发放，支持三档快捷按钮：<b>一档 1千万 / 二档 1亿 / 三档 10亿</b>，也可手动输入任意数额。</td></tr>
    <tr><td><b>预检</b></td><td>启动生成前自动预估成本，余额需覆盖预估 + 20% 缓冲，不足时明确告知差额。</td></tr>
  </table>
</div>

<!-- ============ 8 数据面板 ============ -->
<h2 class="sec" id="s8"><span class="no">8</span>用量账单 / 运营看板 / 日志与记忆</h2>
<div class="card">
  <ul>
    <li><b>用量与账单</b>：看自己的 Token 用量与费用明细；管理员额外可看用户归属汇总和点数发放。</li>
    <li><b>运营看板</b>：管理员视角=全组织队列/任务/告警/备份；<b>普通用户只看到自己的任务与用量</b>（数据隔离在服务端强制）。</li>
    <li><b>日志与通知</b>：运行追踪（Trace）与系统通知。通知支持<b>「✓ 全部已读」</b>一键清零。普通用户只能看到自己发起的运行。</li>
    <li><b>记忆库</b>：打回意见会自动生成「待确认记忆」→ 你确认后沉淀为长期记忆，后续生成自动引用（相当于教 Agent 记住你的偏好）。</li>
  </ul>
</div>

<!-- ============ 9 访问控制 ============ -->
<h2 class="sec" id="s9"><span class="no">9</span>访问控制：成员与权限</h2>
<div class="card">
  <h3>添加成员</h3>
  <ol class="steps">
    <li>用户名 ≥ 3 个字符（字母/数字/._-，不支持中文）；初始密码 ≥ 10 个字符。表单下方有实时提示，两项都 ✓ 时「添加成员」按钮才会亮。</li>
    <li>选角色：只读 / 审查 / 编辑 / 管理员，或自定义角色。</li>
  </ol>
  <h3 style="margin-top:14px">权限体系</h3>
  <p>16 项细分权限分 4 组（内容生产 / 资产与知识 / 数据与洞察 / 系统管理），在「角色权限矩阵」逐项勾选。<b>保存后立即生效</b>；编辑期间页面轮询不会覆盖你未保存的勾选。</p>
  <div class="tip">资源可见性：用户自建的知识库/技能/模板/任务默认<b>私有</b>（仅本人+管理员）；需要共享时在资源授权里给指定成员授权，或「发布全局」对全组织可见。</div>
</div>

<!-- ============ 10 FAQ ============ -->
<h2 class="sec" id="s10"><span class="no">10</span>常见问题 FAQ</h2>
<details><summary>点「开始生成」提示"点数不足"怎么办？</summary><div class="ans">提示里会写明<b>预估需要多少、你还差多少</b>。联系管理员在「用量与账单」按档位发放点数后重试即可。</div></details>
<details><summary>生成中报"模型服务商限流（429）"？</summary><div class="ans">系统已自动放慢重试并尝试切换备用 Provider。若持续失败，到「模型管理」<b>更换其他模型</b>再重新运行失败段。</div></details>
<details><summary>拆解失败 / 一直提示"任务还没有内容段"？</summary><div class="ans">拆解依赖 AI 调用。先到「模型管理」点「测试连通」确认当前模型可用（API Key 失效或服务商地域限制都会导致失败），修正后回到任务页重新点拆解。导图<b>不需要上传文件</b>，粘贴文字大纲即可。</div></details>
<details><summary>为什么我看不到某个知识库 / 任务？</summary><div class="ans">资源默认私有，只有创建者和管理员可见。需要协作请让管理员在「访问控制 → 资源授权」给你授权，或将资源发布为全局。</div></details>
<details><summary>密码忘了 / 账号被锁？</summary><div class="ans">联系管理员在「访问控制」重置密码（≥10 位）。连续输错 5 次锁 15 分钟，等待即可自动解锁。</div></details>
<details><summary>段落打回后 Agent 会按我的意见改吗？</summary><div class="ans">会。打回时填写的意见会<b>直接注入下一轮生成</b>；同时系统自动生成「记忆建议」，你在记忆库确认后，这类偏好以后所有任务都生效。</div></details>
<details><summary>同一个错误反复出现，Agent 会不会一直烧点数？</summary><div class="ans">不会。点数/密钥类错误触发<b>熔断</b>停止整个任务；每次运行还有 240 轮模型调用总预算，总监重做也最多 1 次，多重防线防失控。</div></details>
<details><summary>数据安全吗？</summary><div class="ans">API Key 存 macOS 钥匙串；密码加盐哈希；登录有防爆破锁定；每 6 小时自动备份且保留 14 份，管理员可一键「恢复演练」验证备份可用。</div></details>

<div class="card" style="margin-top:36px; text-align:center; color:var(--ink-3); font-size:12px;">
  私域Agent · 内容生产中枢 —— 遇到本手册未覆盖的问题，联系管理员或截图报错信息反馈。
</div>

</div>
</body>
</html>