雷驼维护后台功能操作手册

版本：v1.0 适用角色：系统管理员 访问方式：浏览器登录后台（默认路径 /admin）

1. 概述

雷驼维护后台 为雷驼（Dathor）软件提供系统管理能力。管理员通过浏览器登录后台，可完成以下六大模块的运维操作：

模块	核心能力
概览	系统全局状态实时监控（成本趋势、模型用量、数据库连接池）
应用配置	团队收藏、侧边栏入口、AI 菜单、站点图标自定义
AI 配置	用量统计、智能体管理、AI 能力、团队 Skill、Agent 工具、平台运行资源、语音识别、模型服务
审计日志	会话审计、配置审计、密码审计（只读，不可删除）
组织管理	组织架构树维护、成员账号管理（支持批量导入）
系统安全	维护任务执行、授权许可证书管理

2. 登录与界面总览

2.1 登录

在浏览器中访问后台地址（如 https://your-domain/admin）
输入管理员用户名和密码
点击登录

登录页面

首次登录后请立即修改密码。

2.2 界面布局

登录成功后进入主界面，包含三个核心区域：

界面总览

左侧导航栏：分 6 组共 20 个功能入口，支持折叠为图标模式
顶部导航栏：显示当前所在模块的面包屑路径，提供全局刷新按钮
底部用户区：显示当前登录用户信息，支持头像上传、显示名编辑、密码修改、语言切换和退出登录

2.3 侧边栏告警提示

以下菜单项会在特定条件下显示告警圆点：

菜单项	告警条件
授权许可	授权证书无效或用户配额超限
模型服务	生产环境下 Provider 密钥未配置

3. 概览 — 仪表盘

菜单路径：概览 → 仪表盘

3.1 功能说明

仪表盘是登录后台后的默认首页，提供系统整体运行状态的实时快照，帮助管理员快速掌握健康度与成本趋势。

仪表盘

3.2 监控面板

仪表盘包含以下监控面板：

面板	说明
用户总数	系统总用户数
请求次数	近 7 天 AI 请求总数
总词元	近 7 天词元消耗总量
估算成本	近 7 天预估费用
授权许可	授权状态（客户、到期、启用账号数）
成本趋势	14 天成本趋势图，按日展示预估费用和请求量
模型用量排行	近 7 天按费用排序的 Top 5 模型
PostgreSQL 连接池	数据库连接池实时状态（每 10 秒自动刷新）

3.3 操作步骤

登录后台后自动进入仪表盘
点击右上角刷新按钮可手动刷新最新数据
连接池面板每 10 秒自动采样更新，无需手动操作
成本趋势和模型用量排行随系统使用数据自动更新

4. 应用配置

应用配置模块用于自定义雷驼客户端的外观和快捷入口，配置修改保存后客户端会在 1-2 分钟内生效。

4.1 团队收藏

菜单路径：应用配置 → 团队收藏

功能说明

配置团队级别的快捷收藏内容，同步到团队成员雷驼客户端的收藏列表，方便团队共享常用资源（如内部系统链接、常用文档等）。

团队收藏

操作步骤

左侧菜单点击 应用配置 → 团队收藏
页面展示团队收藏列表，包含标题、URL、图标、状态、可见范围等信息
点击右上角 新增收藏 按钮，弹出新增对话框

新增团队收藏

填写以下信息：
- 标题：收藏名称
- URL：收藏链接地址（如 https://example.com）
- 描述（可选）：收藏说明
- 网站图标：选择显示图标
- 状态：启用/停用
- 可见范围：选择全员可见或指定部门
点击创建保存
支持对已有收藏进行编辑或删除（操作列）
支持拖拽调整顺序，调整后点击 保存排序 保存

4.2 侧边栏入口

菜单路径：应用配置 → 侧边栏入口

功能说明

自定义雷驼客户端左侧侧边栏的菜单项，可添加外部系统链接或内部功能入口。支持拖拽排序。

侧边栏入口

操作步骤

左侧菜单点击 应用配置 → 侧边栏入口
查看当前已配置的侧边栏入口列表
点击右上角 新增导航 按钮，弹出新增对话框
配置以下信息：
- 入口名称：显示在侧边栏的文本
- 图标：从预设图标库中选择
- 目标链接 URL：点击后跳转的地址
- 打开方式：当前窗口 / 新窗口
支持拖拽调整入口顺序，调整后点击 保存排序 保存
保存后客户端侧边栏即时生效

4.3 AI 菜单

菜单路径：应用配置 → AI 菜单

功能说明

配置 AI 对话中的快捷菜单和预设指令，帮助用户快速发起常见任务的 AI 对话。菜单项可关联特定智能体，设置可见范围。

操作步骤

左侧菜单点击 应用配置 → AI 菜单
查看当前已配置的 AI 菜单模板列表
点击新增按钮添加新菜单项

填写菜单名称、触发指令和关联的智能体
设置菜单项的可见范围和排序
保存后用户在 AI 对话界面即可看到配置的快捷菜单

4.4 站点图标

菜单路径：应用配置 → 站点图标

功能说明

自定义雷驼后台及客户端的品牌图标（Favicon）。支持按域名配置不同图标。

站点图标

操作步骤

左侧菜单点击 应用配置 → 站点图标
查看当前已配置的站点图标列表
点击右上角 上传网站图标 按钮，弹出上传对话框
配置以下信息：
- Domain：应用该图标的域名
- Icon URL：图标文件地址
上传后系统显示预览效果
点击保存生效
如需恢复默认，删除对应的图标覆盖配置即可

5. AI 配置

AI 配置模块是维护后台的核心功能区，涵盖模型服务、智能体、能力管理、用量统计等 AI 相关运维能力。

5.1 用量统计

菜单路径：AI 配置 → 用量统计

功能说明

查看团队使用 AI 服务的详细统计数据，包括调用次数、词元消耗和费用估算。支持按模型、按部门、按用户维度分析。

用量统计

操作步骤

左侧菜单点击 AI 配置 → 用量统计
页面默认展示当月的用量概览
通过顶部筛选器设置：
- 时间范围：点击日期选择器自定义起止时间
- 模型筛选：选择全部模型或特定模型
- 状态筛选：选择全部、成功或失败
点击刷新更新数据，点击重置重置筛选条件
查看以下统计面板：
- 请求数 / 成功 / 失败 / 平均耗时：请求总量、成功数、失败数、平均耗时
- 预估成本：预估总费用
- 词元组成：词元组成（输入词元 / 输出词元 / 缓存读取 / 缓存写入）
- 成本趋势：成本趋势图
- 模型词元分布：模型词元分布
- 用户排行 / 部门排行 / 模型排行：用户、部门、模型排行
- 最近调用：最近调用记录，点击查看完整日志

5.2 智能体

菜单路径：AI 配置 → 智能体

功能说明

创建和管理 AI 智能体（Agent）。每个智能体是一个具备特定角色设定、知识库和工具能力的 AI 实体。

智能体

操作步骤

左侧菜单点击 AI 配置 → 智能体
页面左侧展示智能体列表，右侧为选中智能体的编辑面板
点击右上角 + 按钮创建新智能体，弹出新增对话框
配置以下信息：
- Agent ID：唯一标识（如 default-chat）
- 名称：显示名称（如「默认助手」）
- 描述：功能描述
- 绑定模型：选择绑定的 AI 模型（如 deepseek-v4-flash）
- 思考档位：推理级别（跟随模型默认 / 低 / 中 / 高）
- 系统提示词：定义智能体的角色和行为准则
通过右上角开关控制智能体的 启用/停用
点击保存保存配置，点击删除删除智能体

智能体状态说明

状态	说明
已保存	配置完整，已保存
默认智能体	标记为默认智能体
启用	已启用，用户可使用

5.3 AI 能力

菜单路径：AI 配置 → AI 能力

功能说明

管理平台开放的 AI 能力模块，包括 Agent 记忆策略、文档摘要、AI 写作等。每个能力代表一种 AI 可执行的功能类型。

AI 能力

操作步骤

左侧菜单点击 AI 配置 → AI 能力
可配置的能力包括：

智能体画像记忆

开启 启用画像记忆 开关启用记忆功能
设置 自动激活置信度（如 0.75）
控制智能体是否自动检索和激活用户画像记忆

文档摘要

开启 启用文档摘要 开关启用文档摘要功能
选择 摘要模型，建议选择低成本模型
智能体在需要理解长文档时会自动调用此能力

AI 辅助写作

选择模型（写作模型），默认使用系统默认模型
生成的内容应由人工审核后再发布

修改完成后点击 保存记忆和摘要 配置
点击刷新刷新模型列表

5.4 团队 Skill

菜单路径：AI 配置 → 团队 Skill

功能说明

管理团队自定义的技能（Skill）定义，是可复用的 AI 指令模板或功能插件。Skill 可被智能体调用以执行特定任务。

团队 Skill

操作步骤

左侧菜单点击 AI 配置 → 团队 Skill
查看已安装的 Skill 列表
点击 + 按钮创建新 Skill，弹出新增对话框
或点击导入按钮导入 SKILL.md 文件，弹出导入对话框
点击 Skill 名称查看详情、配置参数
支持 启用/停用、更新、卸载 操作

5.5 Agent 工具

菜单路径：AI 配置 → Agent 工具

功能说明

管理智能体可调用的外部工具集，如网页搜索、计算器、代码执行、API 调用等。支持从模板创建和自定义开发。

Agent 工具

操作步骤

左侧菜单点击 AI 配置 → Agent 工具
页面顶部显示工具统计（总计 / 已发布 / 操作数）
使用搜索框按名称、标识或描述搜索工具
通过 全部状态 下拉框筛选工具状态
点击右上角 新建工具 按钮，进入工具创建页面
选择工具模板（SQL 查询工具 / REST 调用工具 / 高级脚本），填写配置后点击创建
辅助编写：可使用 AI 辅助生成工具脚本源代码

5.6 平台运行资源

菜单路径：AI 配置 → 平台运行资源

功能说明

管理平台运行时的资源，包括数据源配置和出站请求防火墙规则。数据源为 Agent 工具提供数据库连接能力，防火墙规则控制 Agent 的外部网络访问。

平台运行资源

操作步骤

左侧菜单点击 AI 配置 → 平台运行资源
数据源管理：
- 查看已配置的数据源列表
- 点击添加按钮，弹出数据源配置对话框
- 配置连接信息（类型、地址、认证等）
- 支持编辑和删除数据源
出站防火墙规则：
- 切换到 出站访问 标签页
- 点击添加按钮，弹出规则配置对话框
- 配置允许访问的域名/URL 模式
- 支持编辑和删除规则

5.7 语音识别

菜单路径：AI 配置 → 语音识别

功能说明

配置语音识别服务的接入参数，包括语音转文字（STT）的供应商与模型。支持云端服务和服务器内置两种模式。

语音识别

操作步骤

左侧菜单点击 AI 配置 → 语音识别
选择引擎模式：
- 云端服务：使用云端语音识别服务
- 服务器内置：使用服务器内置模型
配置云端服务参数（以云端服务为例）：
- Base URL：API 地址（如 https://api.openai.com/v1）
- Path：接口路径（如 /audio/transcriptions）
- Model：语音识别模型（如 gpt-4o-mini-transcribe）
- API Key：认证密钥
点击 保存语音识别配置 保存语音识别配置
语音润色：
- 选择 绑定模型（润色模型）
- 编辑 系统提示词（润色提示词）
- 点击 保存润色配置 保存润色配置

5.8 模型服务

菜单路径：AI 配置 → 模型服务

功能说明

管理 AI 模型的供应商信息和模型实例，支持多供应商、多模型的接入与路由配置。支持自动发现上游模型和手动添加。

模型服务

操作步骤

左侧菜单点击 AI 配置 → 模型服务
页面分为三栏：
- 左侧：供应商列表（如 dathor、OpenAI 、Anthropic、DeepSeek 等）
- 中间：选中供应商的配置详情
- 右侧：该供应商下的模型列表
添加自定义供应商：
- 点击供应商列表上方的 + 按钮
- 配置供应商名称
- 选择接口类型（如 OpenAI Chat Completions）
- 填入 API Key（加密存储）
- 填入 Base URL（API 地址）
- 可选配置自定义 Headers（JSON 格式）
- 点击保存保存
添加模型：
- 在右侧模型列表点击 + 新增 手动添加
- 或点击 同步模型 从供应商自动同步可用模型
管理模型：
- 点击模型名称展开详情
- 通过开关启用/禁用模型
- 查看模型能力标签（Tools / Reasoning / Stream）
- 查看上下文长度、输出限制、价格信息
- 点击删除图标移除模型

模型能力标签说明

标签	说明
Tools	支持工具调用
Reasoning	支持推理能力
Stream	支持流式输出

6. 审计日志

审计日志模块提供只读的合规追溯能力，所有记录不可删除。

6.1 会话审计

菜单路径：审计日志 → 会话审计

功能说明

审计所有用户与 AI 的对话记录，用于合规审查、数据追溯和安全监控。

会话审计

操作步骤

左侧菜单点击 审计日志 → 会话审计
使用搜索框按会话/智能体关键词搜索
输入用户名筛选特定用户的会话
点击搜索执行搜索
查看会话列表，包含以下信息：
- 更新时间：最后更新时间
- 智能体：使用的智能体
- 会话：会话标题
- 用户：用户
- 总费用：总费用
- 入口：入口来源
- 客户端：客户端类型
- 创建时间：创建时间
点击会话可查看完整对话内容
支持分页浏览和每页条数调整

6.2 配置审计

菜单路径：审计日志 → 配置审计

功能说明

记录后台所有配置变更的操作历史，以时间线形式展示。

配置审计

操作步骤

左侧菜单点击 审计日志 → 配置审计
使用 实体类型 下拉框筛选变更类型（全部 / Agent / Model Config / Model Provider 等）
输入 实体 ID 精确匹配 精确匹配特定配置项
点击搜索执行搜索
查看变更记录列表，包含以下信息：
- 时间：变更时间
- 实体类型：变更对象类型（Agent / Model Config / Model Provider / Provider Secret）
- 操作：操作类型（创建 / 更新 / 同步上游）
- 实体 ID：变更对象标识
- 操作人：操作人
支持分页浏览

6.3 密码审计

菜单路径：审计日志 → 密码审计

功能说明

审计系统用户的密码安全合规情况，包括自动填充凭证的安全状态。

操作步骤

左侧菜单点击 审计日志 → 密码审计
展示所有用户的密码安全状态一览
状态列标识：合规 / 弱口令 / 长期未修改 / 即将过期
点击用户查看详情和建议操作
支持导出审计报告

7. 组织管理

7.1 组织架构

菜单路径：组织管理 → 组织架构

功能说明

管理企业或团队的组织结构树，支持多级部门结构。组织架构用于成员分组、权限分配和可见范围控制。

组织架构

操作步骤

左侧菜单点击 组织管理 → 组织架构
以树状结构展示当前组织架构
点击右上角 + 新增根节点 按钮，弹出新增对话框
填写部门名称、上级部门
对已有部门支持 编辑、移动（调整层级）、删除
拖拽可快速调整部门层级关系
删除部门前可预览影响范围（受影响用户、子部门、导航项）

7.2 成员管理

菜单路径：组织管理 → 成员管理

功能说明

管理系统用户的账号信息、角色权限和所属部门。

成员管理

操作步骤

左侧菜单点击 组织管理 → 成员管理
以列表形式展示所有成员，包含用户名、姓名、角色、部门、状态、上次登录时间
使用顶部筛选器：
- 搜索框：按用户名、姓名或 ID 搜索
- 部门筛选：选择全部部门或特定部门
- 角色筛选：选择全部角色或特定角色
- 状态筛选：选择全部状态或特定状态
点击右上角 + 新增用户 按钮添加新成员：

新增用户

填写以下信息：
- 用户 ID（可选）：留空则自动生成 GUID
- 用户名：登录用户名（唯一）
- 姓名：显示名称
- 初始密码：至少 6 位
- 角色：选择普通用户或管理员
点击创建保存
对已有成员支持：
- 编辑：修改成员信息、部门、角色
- 重置密码：为成员重置登录密码
- 启用/停用：控制账号的可用状态
支持分页浏览和每页条数调整

8. 系统安全

8.1 维护任务

菜单路径：系统安全 → 维护任务

功能说明

执行系统级的维护操作，如缓存清理、数据重建、日志归档等。每个维护任务独立调度，支持按需执行。

维护任务

操作步骤

左侧菜单点击 系统安全 → 维护任务
展示可执行的维护任务列表及上次执行时间
点击任务后的执行按钮触发操作
高风险任务弹出二次确认对话框
执行完成后显示执行结果日志

8.2 授权许可

菜单路径：系统安全 → 授权许可

功能说明

管理雷驼系统的软件授权证书。证书控制系统的可用功能和用户配额。

授权许可

操作步骤

左侧菜单点击 系统安全 → 授权许可
查看当前证书详情：
- 当前许可证状态：许可证状态（已授权 / 未授权）
- 客户：客户名称
- 许可证 ID：许可证编号
- 授权用户数：授权用户数
- 已启用账户：已启用账户数
- 到期时间：过期时间
- 绑定实例 ID：绑定实例 ID
更新证书：
- 点击 上传许可证证书 上传新的证书文件
- 系统自动验证证书有效性
- 验证通过后立即生效
绑定新证书：
- 点击 下载服务器标识 下载服务器标识文件
- 将标识文件提供给授权方
- 获取授权方签发的证书后上传即可