nojava
3.2 KiB
3.2 KiB
文章标签自动推荐功能需求文档
1. 功能概述
根据文章内容，自动推荐 3-5 个合适的标签或分类，减少手动维护的麻烦。博主可一键确认添加推荐标签。
2. 业务背景
- 当前标签需要手动维护，增加博主工作量
- 手动维护的标签不够准确或全面
- 希望通过 AI 能力简化标签选择流程
3. 功能需求
3.1 标签推荐
- 当博主在编辑器中撰写或编辑文章时，提供标签推荐入口
- 点击推荐按钮后，系统自动分析文章内容
- 调用大语言模型，分析文章主题和内容
- 生成 3-5 个合适的标签词
- 推荐结果以标签卡片形式展示
- 博主可选择全部采纳或部分采纳
- 采纳的标签自动添加到文章的标签列表中
3.2 AI 调用
- 调用模型时使用提示词：
"这篇文章适合哪些标签？只返回标签词，用逗号分隔。" - 传递文章标题和正文内容给模型
- 模型返回结果后，前端解析并展示
- 如模型调用失败，提示用户手动添加标签
3.3 前端展示
- 推荐按钮：位于文章编辑页标签区域，文字为"智能推荐"或图标形式
- 加载状态：推荐过程中显示加载动画
- 推荐结果：展示 3-5 个标签按钮
- 交互：点击标签按钮可取消选中，已选中的标签高亮显示
- 确认按钮："确认添加"将选中的标签添加到文章
4. 交互流程
1. 博主进入文章编辑页面
2. 博主在标签区域点击"智能推荐"按钮
3. 系统显示加载状态
4. 系统调用 AI 模型分析文章内容
5. 前端展示推荐标签列表（3-5个）
6. 博主勾选想要添加的标签
7. 博主点击"确认添加"
8. 选中的标签添加到文章标签列表
5. 接口设计
5.1 推荐标签接口
- 请求路径：
/api/article/recommend-tags - 请求方法：
POST - 请求参数：
{ "title": "文章标题", "content": "文章正文内容" } - 返回参数：
{ "success": true, "data": { "tags": ["标签1", "标签2", "标签3", "标签4", "标签5"] } }
6. 技术实现
- 后端：复用现有的 AI 服务调用能力
- 模型：使用配置项
dashscope.model（环境变量DASHSCOPE_MODEL），不使用 AI 助手模型管理表ai_assistant_model；助手后台对模型的启用 / 禁用 不影响 本功能（与《AI助手模型管理功能需求》约定 D-10 一致） - 前端：在文章编辑页面添加推荐按钮和交互
与 AI 文章润色、文章摘要 共用 DashScope API Key 与 callModel 调用链；与 AI 助手 对话的模型选择、会话绑定 无耦合。全站统一后台配模见助手模型需求范围外说明，非本期内容。
7. 非功能需求
- 推荐响应时间应在 5 秒内完成
- 如果模型服务不可用，应给出友好提示
- 推荐结果应基于文章实际内容，确保标签相关性
8. 验收标准
- 在文章编辑页面能看到"智能推荐"按钮
- 点击推荐按钮后，3-5 秒内显示推荐结果
- 推荐结果以标签形式展示，可勾选
- 确认添加后，标签成功添加到文章
- 模型服务异常时，有友好提示