琴剑·工作搭子 的管理后台分为三种角色，权限逐级递增：能看到哪些 Tab、能执行哪些操作，完全由角色决定。
/admin.html登录后看到的 Tab 因角色而异：
| Tab | 知识库管理员 | 普通管理员 | 超级管理员 |
|---|---|---|---|
| 账户管理 | — | ✅（默认进入） | ✅（默认进入） |
| 知识库 | ✅（默认进入） | ✅ | ✅ |
| 额度管理 | — | ✅ | ✅ |
| 组织洞察 | — | — | ✅ |
| 记忆 | — | ✅ | ✅ |
| 模型 | — | — | ✅ |
| 系统设置 | — | — | ✅ |
| 操作日志 | ✅ | ✅ | ✅ |
提示：后台界面始终是深色主题，不跟随聊天页的主题设置。
知识库是 AI 在用户开启「知识库检索」时检索的内容来源。用户提问后，系统会自动从知识库中召回相关片段塞进上下文，让 AI 基于内部资料回答。
.pdf .docx .md .txt上传后系统会自动：解析文本 → 切分片段 → 计算向量 → 入库。一篇 PDF 几秒到几十秒不等，期间不要关页面。
每张文档卡上的按钮：
顶部「重新生成向量索引」按钮。在以下情况需要点：
local 切换到 openai（或反过来）注意：会对所有文档重新切分 + 向量化，文档多时可能要几分钟。openai 后端会消耗 embedding token，注意费用。
记录所有"会改变系统状态"的关键操作，用于审计和排查。
settings_updatequota 相关动作role_change、user_delete、settings_update账户管理 Tab 把"部门、职位、用户"三件事放在一起，因为它们紧密关联：用户挂在部门下，担任某个职位，职位上的「管理层」标记是 ACL 权限的关键开关。
顶部「+ 新增账户」可手动创建账号；用户列表里每行的操作：
| 按钮 / 控件 | 作用 | 谁能用 |
|---|---|---|
| 角色下拉 | 修改用户角色（用户 / 知识库管理员 / 管理员 / 超级管理员） | 👑 Super |
| 显示名 | 修改用户显示名（聊天页面、统计中展示） | Admin+ |
| 部门 / 职位 | 调整归属和职位 | Admin+ |
| 管理层 | 临时把某用户标记为"管理层"（覆盖职位设置） | Admin+ |
| 停用 | 禁止登录但保留数据 | Admin+ |
| 删除 | 彻底删除账号及其全部数据 不可恢复 | Admin+ |
| 查看 | 进入用户「数据概览」，可看其所有对话和 AI 调用统计 | Admin+ |
点用户行的「查看」进入。能看到：
两个 tab 都内置了多套分析视角，用法和"组织洞察"完全一致：
每个 tab 顶部都有"分析视角 / 蒸馏视角"下拉，点「📝 查看/编辑」可临时改提示词；点「⚙ 管理模板」可建/改/删自己的模板。详细操作和编写原则参考第 11.4 节"提示词模板"。
占位符：这两个 scene 的提示词支持 {{user_name}} 占位符，系统会自动替换为目标用户的姓名。
隐私提醒：这里能看到员工聊天原文。请确保查看行为符合公司合规和隐私政策。所有查看操作会记入审计日志。
"ACL（Access Control List）权限"出现在两个地方：模型授权和知识库文档授权。规则相同，理解一次就够。
| 模式 | 含义 | 典型用法 |
|---|---|---|
| 全员可用 | 不设任何规则 = 默认所有人都可访问 | 通用模型、公开知识库 |
| 按部门 | 勾选部门，只有该部门成员可访问 | 「财务知识库」只给财务部 |
| 按用户 | 勾选具体用户，只这几个人可访问 | 试验性模型只让 IT 部分员工测 |
| 仅管理层 | 所有"管理层职位"的成员可访问 | 高级模型、敏感人事文档 |
同一个目标可以设置多条规则，满足任意一条即可访问。例如：
判定一个用户是不是"管理层"，先看用户级覆盖，再看职位：
ACL 管的是「某个具体资源（模型/文档）谁能看」，而权限点管的是「某个功能/接口谁能用」——比如能不能进「销售分析」tab、能不能处理风险预警、能不能配合规规则。两套机制并存、叠加生效。
权限点在「权限管理」Tab（仅超级管理员）配置，三层优先级：
套用模板：可一键把预设的权限组合套给某部门/某人（模式：replace 整体覆盖 / merge 并入）。内置模板有「知识库管理员」「销售组长」「销售只读」「额度审批员」等。
给每个用户/部门设置日/周/月的费用上限，防止预算失控。
当用户提交申请时，所有管理员账户在登录后台时会收到提示。流程：
提示：批准 = 永久调整该用户对应周期的上限。如果只想临时放行一次，用"快速调整"。
位置：「系统设置」Tab 的底部（普通管理员看不到该 Tab，但有专门的公告子区域可见 — 见下）。
当前限制：公告管理界面挂在「系统设置」Tab 下，目前只有超级管理员能直接看到这块区域。如果需要让普通管理员也能维护公告，请联系超级管理员调整。
这里管理"用户在聊天页能选哪些模型"。每个模型代表一个接入点：可以是 OpenAI 兼容接口（GPT、GLM、MiniMax、DeepSeek 等）、Anthropic 接口（Claude）、本地 Claude CLI，或一个图像生成模型。
| 字段 | 含义 |
|---|---|
| 启用 | 关掉后用户选择列表里不显示 |
| 排序 | 数字越小越靠前 |
| code | 系统内部唯一 ID，建好后不要改（会断开历史对话与模型的关联） |
| 显示名 | 用户在下拉框里看到的名字 |
| 类型 | chat（聊天对话）或 image（图像生成）。选 image 后，用户给该模型发的文字会被当作绘图描述，返回一张图片 |
| upstream_model | 真实发给 API 的模型 ID，比如 gpt-4o-2024-11-20 |
| wire_api | 协议：chat_completions（最常见）/ anthropic / claude_cli |
| 独立 Key | 该模型用单独的 API Key，否则用系统设置的全局 Key |
| 授权 | 该模型的 ACL；空 = 全员可用 |
glm-5）+ 显示名（如 "GLM-5"）+ upstream_model（中转站要求的模型 ID）chat_completions；官方 Claude API 选 anthropicJSON 格式，例如 {"X-Custom-Header": "value"}。中转站如果需要特殊鉴权头在这里加。99% 的场景留空即可。
要让用户能"用文字生成图片"，新增模型时把类型选 image即可，其余字段填法和聊天模型一致：
gpt-image、gemini-image）chat_completions（系统会自动调该接口对应的图像生成端点 /images/generations）uploads/ 下，并以图片形式插入对话api.ofox.ai 一类的境外中转站，见部署文档）生图失败排查：若用户反映"图出不来"，多为：① 描述触发了图像服务商的安全审查（涉黄/涉暴/名人肖像等）——这是服务商拒绝，不是系统 bug；② 上游超时——系统已为图像请求放宽到 600 秒；③ Key/Base URL/代理不通。前端会把上游英文报错翻译成中文提示给用户。
| 设置项 | 说明 |
|---|---|
| 全局 API Key | 所有模型在「独立 Key」留空时都用这个 Key |
| 全局 Base URL | 中转站地址，如 https://api.edgefn.net/v1。注意以 /v1 结尾 |
| 设置项 | 默认 | 说明 |
|---|---|---|
| 博查搜索 API Key | — | bochaai.com 申请。多源聚合 + 网页正文摘要。留空会降级到抓取 Bing HTML（质量差很多） |
| 联网正文抓取数量 | 5 | 搜索后系统会真的去爬前 N 个网页的正文喂给模型。范围 1-10。N 越大答案越全但越费 token |
| 每篇正文最大字符数 | 2500 | 每篇网页正文的截断长度。范围 500-8000 |
调参建议：省钱模式 N=3 / 1500 字；默认 N=5 / 2500 字；深度研究 N=8 / 4000 字。改完点保存即时生效，不用重启服务。
| 设置项 | 说明 |
|---|---|
| 向量后端 | local（本地哈希，免费但精度低）/ openai（调中转站 embedding API，精度高但要花钱） |
| 向量模型 | 仅 openai 后端使用，如 text-embedding-3-small |
| 本地向量维度 | 仅 local 后端使用，建议 256-1024 |
切换后端后，去知识库 Tab 点「重新生成向量索引」，否则新旧向量混在一起检索不准。
{name} 占位用户姓名，系统会自动替换{name}，今天又是元气满满的一天！这几项控制全站的"跨对话记忆"是否开启、以及抽取节奏。详细的审核操作在第 12 节。
| 设置项 | 默认 | 说明 |
|---|---|---|
| 记忆抽取模型 | 空（=不启用） | 选一个便宜的小模型。留空则整个记忆功能关闭——不会自动沉淀个人/公司记忆。系统会在对话沉淀时用它在后台提炼记忆，不影响用户聊天 |
| 记忆抽取触发条数 | 6 | 对话每新增满 N 条消息，触发一次后台抽取。调大=更省（抽取频率低），调小=更灵敏 |
| 个人记忆上限 | 50 | 每个用户最多保留多少条个人记忆，超出自动删最旧 |
启用建议：挑一个上下文够用、单价低的模型作"记忆抽取模型"即可（抽取是轻量任务）。开启后用户无感，记忆会慢慢积累；用户也能在「🧠 我的记忆」里自助增删。
详见第 8 节。
「组织洞察」给最高管理者一份跨用户、跨部门的 AI 使用情况分析报告，揭示团队主要在用 AI 解决什么问题、有哪些工作模式可推广、有哪些知识值得沉淀。可按日/周/月/年或自定义时段生成，支持邮件/飞书/企业微信推送。
每份报告由 AI 自动生成，固定包含以下章节：
报告不必每次都覆盖全员——你可以聚焦到特定部门或个人，让 AI 只分析他们的对话数据。这对"给部门主管做单部门画像""专项审计某些骨干员工"等场景特别有用。
| 选择方式 | 系统识别为 | 分析数据 |
|---|---|---|
| 什么都不勾 | 全员 | 整个公司所有有对话记录的人 |
| 只勾选部门 | 按部门 | 勾中部门 + 其所有子部门的成员 |
| 只勾选用户 | 按用户 | 勾中的具体用户 |
| 部门和用户都勾 | 混合 | 两者并集（去重） |
"自动调度"区域同样有"分析范围"字段。配置后系统会按时间为同一个范围自动生成报告。如果你需要给不同部门定时各发一份不同范围的报告，目前需要分多次手动生成（多调度规则未来再做）。
不同管理者关心的角度不同——HR 想看培训缺口，财务想看成本效率，部门主管想看本部门画像。系统支持多套提示词模板，每生成一份报告都可以选用不同模板，得到完全不同视角的分析。
| 模板 | 视角 | 适合谁看 |
|---|---|---|
| 通用组织洞察（默认） | 全方位的团队分析 | CEO / 总经理 |
| 部门画像 | 聚焦单一部门的工作模式 | 部门主管 |
| 知识沉淀报告 | 挖掘可入库的知识资产 | 知识库管理员 / 培训负责人 |
| 成本与效率审计 | 关注 ROI 与成本优化 | 财务 / 运营 |
点「⚙ 管理模板」打开管理弹窗，可以：
除了 4 个内置，你可以为这些场景各建一个模板：
## 标题），AI 会照着结构输出在历史报告的详情弹窗顶部状态栏会显示「模板：xxx」，方便你回看时知道这份报告是用什么视角生成的。
支持三种渠道并行推送，每个渠道独立"启用/停用"开关。配置后建议先点「测试发送」验证。
| 字段 | 填什么 |
|---|---|
| SMTP Host | 如 smtp.qiye.aliyun.com / smtp.exmail.qq.com / smtp.gmail.com |
| Port | SSL 一般 465，TLS 一般 587 |
| Secure | 465 端口选"是"，587 选"否"（用 STARTTLS） |
| 用户名 | 登录邮箱地址 |
| 密码 / 授权码 | 多数邮箱要的不是登录密码，而是独立生成的"授权码"（在邮箱网页设置里"客户端授权码"或"应用专用密码"） |
| 发件人显示 | 可选，如 "组织洞察" <report@company.com> |
| 收件人 | 多个用逗号分隔，如 boss@x.com, hr@x.com |
https://open.feishu.cn/open-apis/bot/v2/hook/xxx）https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx）用于在推送中拼接"点这里查看报告"的链接。例如填 https://chat.qjkj.xyz，推送的链接会变成 https://chat.qjkj.xyz/admin.html#org-insight-123。本地用可以留空，链接会变成相对路径。
配置好后，系统会按时间自动触发报告生成 + 推送。每个频率独立开关：
| 类型 | 覆盖时段 | 默认触发时间 |
|---|---|---|
| 每日报告 | 昨日 0:00 - 23:59 | 每天 07:05 |
| 每周报告 | 上周一 - 上周日 | 每周一 08:05 |
| 每月报告 | 上月 1 号 - 月末 | 每月 1 号 09:05 |
| 每年报告 | 去年 1/1 - 12/31 | 每年 1/1 10:05 |
建议起步配置：先只开"每周报告"试用一两周，看推送内容是否符合预期，再决定要不要日报/月报。
自动（系统调度生成）、手动、已推 email,feishu（已推送过的渠道）org_reports 表中，仅超级管理员可访问「记忆」让 AI"越用越懂用户"。系统会在用户对话沉淀时，由后台小模型自动提炼出值得长期记住的信息，分两类落地：
Tab 上半部分是「待审核公司记忆」列表，每条是系统从某段对话里抽出的候选知识。逐条处理：
下半部分「已生效公司记忆」列出所有已通过的条目，可随时编辑（改内容/分类/可见范围）或删除（仅超管）。发现某条记忆过时或写错，在这里改掉即可，改完立刻影响后续对话注入。
Tab 顶部的「记忆分类管理」区维护抽取时给记忆打的分类标签，个人 / 公司各一套：
「销售分析」是基于销售与客户微信聊天记录的数据智能分析平台，是本系统体量最大的业务模块。它把每天的聊天记录导入解析，跑三级 AI 分析（客户级 → 个人日报 → 团队日报），衍生出风险预警、合规稽查、辅导闭环、销冠挖掘、周报月报。数据自动同步、自动分析，管理者主要做看数据 + 处理预警 + 指派辅导 + 配规则。
权限完全按角色 + 数据 scope 单独设定，不是简单按角色一刀切：
| 角色 / 权限 | 能看到的数据范围 | 典型操作 |
|---|---|---|
一线销售（salesperson / scope.sales_self） | 只看自己的客户、日报、风险 | 看本人日报、打卡辅导任务、申请调休 |
销售组长（sales_manager） | 本部门及子部门 | 处理风险/合规、指派辅导、批调休、看团队日报 |
主管 / 运营部（scope.sales_all） | 全部部门 | 配置规则、Prompt、班次、销冠库、周报月报 |
| 超级管理员 | 绕过一切 | 全部 |
sales.view.* / sales.handle.* / sales.config.* 权限点。分析的前提是聊天记录进系统。有三种路径：
chat_sync_db_config（远端库连接信息）和 chat_sync_schedule（同步时间）。.md 文件（可批量、可带文件夹）上传到「数据导入」页。文件名/文件夹名里带销售姓名会自动匹配。sales_inbox 目录，分析时会自动扫描摄取。如果导入的文件解析出了销售微信号、但还没绑定到系统账号（新人没建档、或换了微信号），会进「待认领」列表。在「成员管理 / 工作微信号映射」里把微信号绑到对应账号，绑完后历史数据会自动回填归属，再跑一次分析即可。
正常情况数据同步后自动分析。需要手动重跑时：
系统会自动检测某销售某维度连续 3 天低于满分 60%，生成 pending 待指派辅导任务。完整闭环：
「AI 建议动作」按钮会根据该销售近 14 天的扣分原因和客户原话，自动生成一条 1~2 周可验收的辅导建议，可作参考。「取样板」会取对口维度的销冠案例给组员学。
三个来源，都在分析流水线里自动产生：
处理方式：单条或批量标记「已处理」，整批盖同一个处理类别（误报/已沟通/…）+ 备注。处理类别是误报率统计的数据地基，请认真选，别都填"其他"。
稽查销售自身行为是否越线（区别于风险的"客户侧"）。双源：
四个领域：廉洁/资金红线（integrity）、服务态度（service）、话术合规（sales_pitch）、信息安全（info_security）。廉洁红线命中会一票否决（日报封顶到地板分）。处理风险预警同理——标记已处理会联动重算受影响日报的扣分（纯本地秒算，不耗 token）。
规则可在后台编辑（替代写死常量），每条规则配：关键词、排除词（白名单）、命中说话方（只看销售说的/客户说的/都看）、匹配模式（任一词/同现）、级别、是否一票否决、是否只观察不扣分。改规则前先「回测」——用草稿规则在最近 N 天消息上试跑（不写库），看命中数和样本，验证不误报再保存。
从高分已成交对话里自动提取销冠的"真原话话术卡"，沉淀成可复用的案例库。每天 10:30 自动只提昨天，也可手动全量补提。
可按时段生成周报/月报（按部门或全公司），AI 汇总：总览、关键成就、主要问题、趋势分析、下阶段重点、辅导落地统计。周报月报会聚合区间内所有个人日报 + 辅导任务完成情况。
销售分析用的 AI Prompt 模板可在后台编辑（客户分析、个人日报、团队日报、周报、销冠提取、风险 review 等）。后台手改过的模板不会被自动升级覆盖——系统升级时只更新没改过的。改之前建议先看懂现有模板的 {{变量}} 占位和 {{__SPLIT__}} 缓存拆分标记。
sales_dept_push_config 表已建但未启用）。销售侧的"通知"靠站内通知（分析完成、辅导指派/逾期、调休审批等）。如需自动推送报表，需另行开发。「售后分析」是对标销售分析新建的客服会话数据智能分析平台，基于企业微信客服会话记录。它把每天的客服接待会话导入解析成一个个会话档案，跑三级 AI 分析（会话级 → 个人日报 → 团队日报），衍生出问题帕累托、服务质检、风险预警、客户情绪、VOC 客户声音、知识库沉淀、周报月报。数据自动同步、自动分析，管理者主要做看数据 + 处理预警/质检 + 配规则。
| 角色 / 权限 | 能看到的数据范围 | 典型操作 |
|---|---|---|
一线客服（cs_agent / scope.cs_self） | 只看自己的会话与日报 | 看本人会话抽查、本人日报评分 |
售后组长（cs_manager） | 本部门及子部门 | 处理风险/质检、看团队日报、管排班请假 |
主管 / 运营部（scope.cs_all） | 全部部门 | 配质检规则、Prompt、知识库、周报月报 |
| 超级管理员 | 绕过一切 | 全部 |
cs.view.* / cs.handle.* / cs.config.* 权限点。看不到「进入后台」入口：只要有任一售后 tab 权限点即放行入口（详见 2. 进入后台）。cs_sync_db_config 连接信息 + cs_sync_schedule 同步时间）。导入解析出客服接待人姓名、但还没绑定到系统账号（新人没建档、或企业微信改了名），会进「待认领」。在「配置 → 接待人映射」里把接待人绑到对应账号，绑完历史数据自动回填归属，再跑一次分析即可。
正常情况数据同步后自动分析。需要手动重跑时，操作与销售一致：预览工作量 → 开始分析（进度条实时显示：扫描 → 会话级 → 个人日报 → 团队日报）→ 默认增量、勾「强制重算」才全量。关掉页面不影响，分析是后台任务、跑完站内通知推送，可中途取消（已完成部分保留）。
一屏看清今天售后状态：
会话列表 + 详情（对话回放 + AI 结论），支持每列筛选、分组折叠、表头排序、每页条数。可按客服、问题类型、情绪、是否风险等筛。点开单条看完整对话回放和该会话的 AI 分析（问题分类、情绪迁移、是否解决、满意度、风险、VOC）。
问题帕累托图 + 各分类解决率 + 趋势。累计占比达 80% 的问题类型即「解决 80% 售后工作量」的关键少数（表格高亮），是排产品改进/知识库建设优先级的依据。KPI 含问题总次数、关键少数类数、平均解决率、最低解决率问题。
稽查客服自身行为是否越线。双源：规则层（关键词秒筛，零 token，如推诿/违规承诺/态度红线）+ AI 层（分析会话时判定态度/话术问题）。廉洁类红线命中一票否决（日报封顶地板分）。处理质检预警会联动重算受影响日报扣分（纯本地秒算，不耗 token）。
规则可在后台编辑：关键词、排除词、命中说话方、匹配模式、级别、是否一票否决、是否只观察不扣分。改规则前先回测——用草稿规则在最近 N 天会话上试跑（不写库），验证不误报再保存。
AI 在分析中自动产生的客户侧风险（高流失/投诉/舆情倾向）。处理方式：标记「已处理」并选处理类别（误报/已沟通/…）+ 备注。处理类别是误报率统计的地基，请认真选。
从会话里 AI 提炼的客户原声：TOP 需求、痛点、吐槽、表扬、建议。是把一线客服会话转成产品/运营决策输入的通道。
沉淀 FAQ / 标准话术 / 优秀·失败案例。AI 提取（从优秀会话自动提炼）+ 人工上传两条路径。给客服培训、给新人参考。
可按时段生成周报/月报（按部门或全公司），AI 汇总总览、关键问题、趋势、下阶段重点。Prompt 模板（👑 超管）：会话分析、个人日报、团队日报、周报、知识提取 5 个种子 key 可编辑，手改过的不被升级覆盖，注意 {{变量}} 与 {{__SPLIT__}} 缓存拆分标记。
cs_dept_push_config 表已建但未启用）。通知靠站内通知。如需自动推送，需另行开发。联网搜索是全局生效的，调整一处所有用户都受影响：
不用。所有设置项保存后即时生效。
需要服务器命令行权限。详见部署文档 DEPLOY.md 第 8 节"故障排查"。
不能。角色是单选。需要 KB 管理权限的就直接设为「普通管理员」或更高 — 高级别自动包含低级别能力。
不在。删除用户会级联删除其所有对话、附件、配置。这是不可逆操作。需要保留就用「停用」。
员工不会主动收到通知。但报告本质上基于他们的提问聚合而成，合规上属于"对工作行为的分析"，建议：
tail -f server.log | grep org-insight 能看到触发记录image；境外中转站确认代理是否可用