License 管理
1. 概述
License 管理页面用于管理 CueMate 系统的授权许可证，包括查看 License 信息、上传 License 文件、导入预置题库以及管理系统版本。有效的 License 是使用 CueMate 订阅功能的前提条件，并且在有效期内，可以持续更新使用所有的订阅功能。
核心功能：
- 查看当前 License 信息和状态
- 上传和激活 License.key 文件
- 导入预置面试题库（需有效 License）
- 管理系统版本和更新
- License 过期提醒和续费管理
订阅方案
CueMate 提供三种灵活的订阅方案，满足不同用户的需求：
| 方案 | 时长 | 价格 | 适用场景 |
|---|---|---|---|
| 月度订阅 | 1 个月 | ¥59 | 短期面试准备、试用体验 |
| 年度订阅 | 1 年 | ¥199 | 长期面试训练、求职季备战 |
| 永久授权 | 永久 (100年) | ¥399 | 一次购买、终身使用 |
TIP
推荐选择：
- 如果您正在准备近期面试，建议选择 月度订阅
- 如果您计划长期提升面试技能，建议选择 年度订阅（相当于每月 ¥16.6）
- 如果您希望一劳永逸，建议选择 永久授权（最具性价比）
订阅权益：
- 所有订阅方案均包含完整功能
- 订阅期内可免费更新到最新版本
- 专享预置题库（持续更新）
- 优先技术支持服务
购买方式：
- 邮箱联系：nuneatonhydroplane@gmail.com
- 支付完成后将收到 License.key 文件
2. 进入 License 管理
2.1 打开 License 管理页面
点击顶部下拉列表菜单中的「License 管理」，进入 License 管理页面。
3. 访问 License 管理（无 License 状态）
首次访问或 License 失效时，页面会显示提示信息，要求上传有效的 License 文件。
3.1 无 License 时的限制
WARNING
无 License 时的限制：
- 无法使用预置题库功能
- 无法导入系统预置题目
- 当下以及未来的订阅功能受限
解决方法：
- 联系 CueMate 团队获取 License.key 文件
- 按照后续步骤上传 License 文件
- 激活后即可使用完整功能
4. 上传 License 文件
上传 License.key 文件以激活系统功能：
4.1 上传步骤
1. 获取 License 文件
联系销售团队获取 License.key 文件：
- 销售邮箱：nuneatonhydroplane@gmail.com
- 在线咨询：联系客服
- 提供必要的组织信息和授权数量
2. 选择文件上传
操作步骤：
- 点击「上传 License.key 文件」区域
- 选择本地的 .key 文件
- 等待上传完成
- 系统自动验证并激活
3. 上传要求
NOTE
文件格式要求：
- 文件扩展名：.key
- 文件类型：License 密钥文件
- 来源：官方授权渠道
4. 上传状态
上传过程中显示：
- 上传中：显示加载动画和"上传中..."提示
- 上传成功：显示成功消息，自动刷新 License 信息
- 上传失败：显示错误提示，检查文件有效性
4.2 常见上传问题
问题 1：提示"只支持上传 .key 文件"
原因：选择的文件格式不正确
解决方法：
- 确认文件扩展名为 .key
- 不要修改文件名和扩展名
- 确保文件来自官方渠道
问题 2：上传后提示 License 无效
原因：License 文件损坏或过期
解决方法：
- 检查 License 文件是否完整
- 确认 License 是否在有效期内
- 联系销售重新获取 License
问题 3：上传后功能仍然受限
原因：浏览器缓存未刷新
解决方法：
- 刷新页面（F5 或 Ctrl+R）
- 清除浏览器缓存
- 重新登录系统
5. 查看 License 信息
上传 License 成功后，可以查看详细的授权信息：
5.1 License 状态
状态指示器：
- 绿色圆点：授权有效
- 黄色圆点：即将过期（30天内）
- 红色圆点：已过期
状态说明：
- 授权有效：License 正常，可使用所有功能
- 即将过期：License 将在 30 天内过期，建议及时续费
- 已过期：License 已失效，需要重新上传有效 License
5.2 License 详细信息
基本信息（左列）：
| 字段 | 说明 | 示例 |
|---|---|---|
| 授权名称 | 组织名称 | CueMate Corporation |
| 版本类型 | License 版本 | Enterprise |
| 产品类型 | 授权产品类型 | CueMate-Enterprise |
授权信息（右列）：
| 字段 | 说明 | 示例 |
|---|---|---|
| 授权数量 | 可用授权席位数 | 1 个授权 |
| 过期时间 | License 到期日期 | 2027-01-01 00:00:00 |
| 激活时间 | License 首次激活时间 | 2026-01-01 10:30:00 |
5.3 License 版本
授权版本信息：
- 显示当前 License 的版本号
- 位于状态指示器右侧
- 格式：授权版本：vX.X.X
6. License 过期警告
当 License 即将过期（30天内）时，页面会显示醒目的警告提示：
6.1 警告内容
提示信息：
- 警告标题：「License 即将过期」
- 警告内容：提醒用户在过期前及时续费或更新 License
- 视觉样式：黄橙色渐变背景，警告图标
警告触发条件：
- License 过期时间 <= 当前时间 + 30 天
- 例如：2026-12-31 过期，2027-11-31 开始显示警告
6.2 续费建议
及时续费的好处：
- 避免功能中断
- 保持业务连续性
- 防止数据访问受限
续费流程：
- 联系销售团队
- 提供当前 License 信息
- 支付续费费用
- 获取新的 License.key 文件
- 上传新 License 文件替换旧文件
7. 导入预置题库
有效 License 激活后，可以导入系统预置的面试题库：
7.1 导入功能
显示条件：
- License 状态为有效（active）
- License 未过期或即将过期
导入区域：
- 标题：「导入预置题库」
- 描述：支持 CSV 或 JSON 格式文件导入预置面试题库
- 按钮：「导入题库」
7.2 导入步骤
1. 准备题库文件
支持两种文件格式：
CSV 格式示例：
问题,答案,标签名称
"什么是微服务？","微服务是一种将单一应用程序拆分为一组小型服务的架构风格...","架构设计"
"Redis 的使用场景","Redis 作为高性能的内存数据库，常见使用场景包括...","Redis"
"解释一下 React Hooks","React Hooks 是 React 16.8 引入的特性...","前端开发"JSON 格式示例：
[
{
"question": "什么是微服务？",
"answer": "微服务是一种将单一应用程序拆分为一组小型服务的架构风格...",
"tag_name": "架构设计"
},
{
"question": "Redis 的使用场景",
"answer": "Redis 作为高性能的内存数据库，常见使用场景包括...",
"tag_name": "Redis"
},
{
"question": "解释一下 React Hooks",
"answer": "React Hooks 是 React 16.8 引入的特性...",
"tag_name": "前端开发"
}
]2. 打开导入弹框
操作：
- 点击「导入题库」按钮
- 从右侧弹出导入题库侧拉弹框
- 查看格式说明和示例
3. 选择文件上传
在导入弹框中：
- 点击「选择文件导入」按钮
- 选择本地的 .csv 或 .json 文件
- 系统自动解析并导入
- 等待导入完成
4. 设置导入选项
可选配置：
- 覆盖已存在的题目：勾选后会覆盖相同问题的题目，默认不覆盖
7.3 导入结果
成功消息示例：
批量导入完成！新增 150 个，跳过 20 个字段说明：
- 新增数量：本次导入的新题目数量
- 跳过数量：数据库中已有的重复题目数量（未覆盖）
7.4 导入注意事项
文件格式要求：
- 支持 .csv 和 .json 两种格式
- CSV 第一行为表头（问题,答案,标签名称）
- JSON 必须是对象数组格式
- 文件大小限制：最大 10MB
- 单次最多导入 1000 个题目
字段要求：
- question（问题）：必填，字符串类型，最长 500 字符
- answer（答案）：必填，字符串类型，最长 5000 字符
- tag_name（标签名称）：可选，字符串类型，如"前端开发"、"Redis"、"架构设计"等
- 系统会自动根据标签名称查找或创建对应标签
- 相同名称的标签会自动复用
- 标签为空时题目不关联任何标签
重复处理：
- 系统基于问题文本进行去重
- 默认跳过已存在的题目
- 勾选「覆盖已存在的题目」可强制覆盖
导入后操作：
- 前往「预置题库」页面查看导入结果
- 可以继续导入其他题库文件
- 导入的题目可同步到面试押题
8. 版本管理
版本管理功能用于查看系统版本历史、更新日志以及执行版本更新操作。
8.1 打开版本管理
版本管理按钮位置：
- 页面右上角「版本管理」按钮
- 图标：版本管理图标
- 待更新徽章：显示可更新版本数量（红色数字）
按钮说明：
- 无更新时：仅显示按钮文字和图标
- 有更新时：右上角显示红色数字徽章，提示可更新版本数量
8.2 版本列表
点击「版本管理」按钮后，从右侧弹出版本历史抽屉：
抽屉头部信息：
- 标题：「版本历史」
- 版本总数：共 X 个版本
- 当前版本号：右上角显示「当前版本 vX.X.X」
列表结构：
- 版本号（如 v0.1.1、v0.1.0）
- 产品名称（CueMate）
- 发布日期（YYYY/MM/DD 格式）
- 更新数量标签（如「11 个新功能」绿色标签）
- 最新版本标识（红色「最新版本」标签）
- 查看详情链接（「点击查看详情 →」蓝色链接）
版本排序规则：
- 最新版本排在顶部
- 按版本号降序排列
- 最新可更新版本会标注红色「最新版本」标签
列表操作：
- 点击版本项或「点击查看详情」：查看该版本详情
- 滚动查看：支持滚动浏览历史版本
- 底部「关闭」按钮：关闭版本历史抽屉
8.3 查看版本详情
点击版本列表中的某个版本，进入版本详情页面：
详情页面内容：
1. 版本基本信息
- 版本号：如 v0.2.0
- 发布时间：精确到秒
- 版本状态：当前版本 / 历史版本 / 最新版本
2. 更新日志（Markdown 格式）
- 新增功能列表
- 功能改进说明
- Bug 修复记录
- 已知问题说明
- 升级注意事项
3. 操作按钮
- 返回按钮：返回版本列表
- 更新到此版本：执行版本更新（见 7.4）
8.4 版本更新操作
在版本详情页面底部，点击「更新到此版本」按钮开始更新：
8.4.1 确认更新弹框
点击「更新到此版本」按钮后，弹出确认更新弹框：
弹框标题：
- 显示「确认更新到 vX.X.X」
版本信息：
| 信息项 | 说明 |
|---|---|
| 当前版本 | 显示用户当前安装的版本号（如 v0.1.0） |
| 目标版本 | 显示即将更新到的版本号（蓝色高亮，如 v0.1.1） |
| 更新包大小 | 约 200MB |
| Docker 镜像 | 约 2GB |
注意事项提示（橙色警告框）：
- 更新过程约需 5-10 分钟
- 更新时可继续使用,完成后会自动重启
- 请确保网络连接稳定
- 更新前已自动备份数据
主要更新内容预览：
- 显示该版本的主要更新内容列表（带序号）
- 每条更新内容格式：「序号. feat(模块): 功能描述」
- 如有更多内容，底部显示「等共 X 项更新...」
操作按钮：
- 「取消」：关闭弹框，取消更新
- 「确认更新」：开始执行更新
8.4.2 更新进度弹框
点击「确认更新」后，显示更新进度弹框：
弹框标题：
- 显示「正在更新到 vX.X.X」
进度信息：
- 总进度：显示百分比进度条（0-100%）和百分比数字
- 当前操作：蓝色提示框显示正在执行的详细操作（如「正在拉取镜像 cuemate-rag-service (3/6)」）
更新步骤：
| 步骤 | 说明 | 状态显示 |
|---|---|---|
| 下载更新包 | 从服务器下载更新文件 | 已完成 |
| 解压更新包 | 解压下载的更新文件 | 已完成 |
| 拉取 Docker 镜像 | 更新后端服务镜像 | 进行中... |
| 替换应用文件 | 更新应用程序文件 | 待执行 |
| 准备重启 | 准备重启应用完成更新 | 待执行 |
每个步骤会显示状态图标：
- 灰色空心圆圈：待执行
- 蓝色加载动画：进行中
- 绿色勾选图标：已完成
实时日志：
- 底部显示「实时日志」区域
- 黑色背景的日志查看器，显示更新过程的详细日志
- 支持滚动查看完整日志
底部提示：
- 黄色警告条：「请勿关闭此窗口,更新过程中可以继续使用应用」
8.4.3 更新完成
更新准备完成后，显示重启倒计时：
- 倒计时 3 秒后自动重启应用
- 重启后将使用新版本
8.4.4 更新失败
如果更新过程中出现错误：
弹框标题：
- 显示「更新失败」
错误信息：
- 红色 X 图标表示更新失败
- 标题：「更新过程中发生错误」
- 粉色错误提示框：显示具体错误原因（如「拉取 Docker 镜像失败: 拉取镜像 cuemate-web-api 失败」）
实时日志：
- 显示「实时日志」区域
- 黑色背景的日志查看器，显示错误详情和完整日志
- 可帮助排查具体失败原因
操作按钮：
- 右下角「重试」按钮：可重新尝试更新
- 右上角 X 按钮：关闭弹框
9. 最佳实践
9.1 License 管理
建议：
- 定期检查 License 过期时间
- 提前 30 天联系续费
- 保存 License.key 文件备份
- 记录 License 详细信息
操作：
- 每月登录查看 License 状态
- 设置日历提醒（过期前 30 天）
- 将 License.key 文件保存在安全位置
- 截图保存 License 信息页面
9.2 题库导入
建议：
- 使用 CSV 或 JSON 格式准备题库文件
- 导入前备份数据库
- 分批导入大量题目（单次不超过 1000 个）
- 导入后验证数据完整性
操作：
- 准备符合格式要求的 CSV 或 JSON 文件
- 先导入小批量（10-20 个）测试
- 确认无误后导入全部
- 在预置题库页面检查导入结果
- 使用覆盖选项前务必确认
9.3 版本更新
建议：
- 定期检查版本更新
- 阅读更新日志了解新功能
- 更新前备份重要数据
- 在测试环境先验证
操作：
- 每周查看版本管理页面
- 关注待更新徽章提示
- 查看版本详情了解变更
- 等待稳定版本后更新
9.4 权限管理
建议：
- 根据实际使用人数购买授权
- 合理分配授权席位
- 定期审查账号使用情况
- 及时回收离职人员授权
操作：
- 统计实际用户数量
- 预留 10-20% 弹性席位
- 每季度审查账号列表
- 删除不活跃账号
10. 常见问题
10.1 上传之后仍无权限
问题：上传 License 后仍然提示无权限？
可能原因：
- License 文件无效或已过期
- License 类型不包含该功能
- 浏览器缓存未刷新
解决方法：
- 检查 License 信息，确认状态为"授权有效"
- 确认 License 版本类型是否支持该功能
- 刷新页面或清除浏览器缓存
- 重新登录系统
10.2 License 过期后数据
问题：License 过期后数据会丢失吗？
可能原因：
- 用户担心 License 过期会导致数据丢失
解决方案：
- 数据不会丢失
- License 过期只影响功能使用
- 续费后立即恢复所有功能
- 历史数据完整保留
10.3 升级 License 类型
问题：如何升级 License 类型？
可能原因：
- 当前版本功能不满足需求
- 需要更多授权席位
解决方案：
- 联系销售团队
- 说明需要升级的目标版本
- 支付升级差价
- 获取新的 License.key 文件
- 上传新 License 覆盖旧文件
升级优惠：
- 老用户升级享受折扣
- 按剩余天数抵扣费用
- 批量采购额外优惠
10.4 多设备使用同一 License
问题：可以在多台设备上使用同一个 License 吗？
可能原因：
- 用户需要在多台设备上使用系统
解决方案：
- License 按授权数量限制
- 一个授权对应一个用户账号
- 同一账号可在多设备登录
- 但同时在线设备数受限
示例：
- 授权数量为 10 个
- 可创建 10 个用户账号
- 每个账号可在多设备使用
- 超出授权数量无法创建新账号
10.5 导入题库失败
问题：导入题库失败怎么办？
可能原因：
- 文件格式不正确（不是 CSV 或 JSON）
- 文件内容格式错误（缺少必填字段）
- 网络连接问题
- 题库文件损坏或编码错误
解决方案：
- 确认文件为 .csv 或 .json 格式
- 检查文件内容是否符合格式要求（参考第 6 节示例）
- 确保 CSV 文件使用 UTF-8 编码
- 检查网络连接是否正常
- 重新下载或生成题库文件
- 查看浏览器控制台错误信息
- 联系技术支持
10.6 License 续费
问题：License 即将过期，如何续费？
可能原因：
- License 即将到期需要续费
解决方案：
- 联系 CueMate 团队（建议提前 7 天）
- 提供当前 License 信息
- 确认续费时长和金额
- 完成支付
- 接收新的 License.key 文件
- 上传新 License（会自动延长过期时间）
续费优惠：
- 年付享受折扣
- 多年续费优惠更多
- 老客户续费专属优惠
11. 技术支持
拥有有效 License 的用户可享受完整的技术支持服务：
支持内容：
- 功能使用咨询
- 问题故障排查
- 版本更新指导
- 配置优化建议
联系方式：
- 邮箱：nuneatonhydroplane@gmail.com