meijiali/hot_comment_radar
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update feature summary analysis status

Browse Source
This commit is contained in:
meijiali
2026-07-01 20:37:25 +08:00
parent 7eea937f28
commit dfcfb68667
1 changed files with 10 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/FeatureSummary.md
+10 -11
View File
@@ -70,16 +70,14 @@ MVP 核心流程：
- 任务最终状态规则： - 任务最终状态规则：
- 没有任何内容条目成功完成抓取和分析时，任务失败； - 没有任何内容条目成功完成抓取和分析时，任务失败；
- 至少 1 条内容条目成功完成抓取和分析时，任务可标记成功，并展示失败内容条目数或错误摘要。 - 至少 1 条内容条目成功完成抓取和分析时，任务可标记成功，并展示失败内容条目数或错误摘要。
- AI 分析质量不扩展任务状态模型，使用独立字段记录： - AI 分析质量不扩展任务状态模型，使用成功率字段记录：
- `analysis_success_rate`：任务内成功生成情绪分类和方向标签的评论占比； - `analysis_success_rate`：任务内成功生成情绪分类和方向标签的评论占比；
- `analysis_status`：AI 分析质量状态，可取值为正常、分析不足； - 当 `analysis_success_rate < 80%` 时，任务状态仍按内容条目处理结果标记成功或失败，但页面须展示 AI 分析成功率不足提示。
- 当 `analysis_success_rate < 80%` 时，任务状态仍可按内容条目处理结果标记成功，但 `analysis_status` 标记为分析不足。
- 任务数据模型须包含： - 任务数据模型须包含：
- `total_items_count`：任务内计划或实际纳入处理的内容条目总数； - `total_items_count`：任务内计划或实际纳入处理的内容条目总数；
- `processed_items_count`：已完成抓取与分析处理的内容条目数； - `processed_items_count`：已完成抓取与分析处理的内容条目数；
- `successful_items_count`：成功完成抓取与分析的内容条目数。 - `successful_items_count`：成功完成抓取与分析的内容条目数。
- `analysis_success_rate`； - `analysis_success_rate`。
- `analysis_status`。
核心验收： 核心验收：
@@ -212,7 +210,8 @@ fetch_creator_hot_spot_billboard
- 已获取内容条目数； - 已获取内容条目数；
- `total_items_count`； - `total_items_count`；
- `processed_items_count`； - `processed_items_count`；
- `successful_items_count`。 - `successful_items_count`；
- `analysis_success_rate`。
- 热点数据： - 热点数据：
- 平台； - 平台；
- 任务 ID； - 任务 ID；
@@ -272,7 +271,7 @@ fetch_creator_hot_spot_billboard
- 后端须对 LLM 输出做 JSON Schema 校验； - 后端须对 LLM 输出做 JSON Schema 校验；
- 解析失败时触发重试，最多 N 次，N 由 DevelopmentPlan 结合所选 AI 服务确认，建议 3 次； - 解析失败时触发重试，最多 N 次，N 由 DevelopmentPlan 结合所选 AI 服务确认，建议 3 次；
- AI 返回无法解析或缺失必填字段时，单条评论标记为未知、空标签或分析失败，不阻塞其他评论。 - AI 返回无法解析或缺失必填字段时，单条评论标记为未知、空标签或分析失败，不阻塞其他评论。
- 任务完成后统计 `analysis_success_rate`；低于 80% 时写入 `analysis_status = 分析不足`，但不改变任务成功 / 失败状态。 - 任务完成后统计 `analysis_success_rate`；低于 80% 时页面展示 AI 分析成功率不足提示，但不改变任务成功 / 失败状态。
核心验收： 核心验收：
@@ -365,7 +364,7 @@ fetch_creator_hot_spot_billboard
- 刷新任务列表按钮； - 刷新任务列表按钮；
- 任务创建时间； - 任务创建时间；
- 任务状态； - 任务状态；
- AI 分析状态或分析成功率； - AI 分析成功率或成功率不足提示；
- 成功 X / 共 Y 条内容条目； - 成功 X / 共 Y 条内容条目；
- 任务基础信息； - 任务基础信息；
- 错误原因； - 错误原因；
@@ -374,7 +373,7 @@ fetch_creator_hot_spot_billboard
- 平台； - 平台；
- 抓取时间或任务标识； - 抓取时间或任务标识；
- 任务状态和错误原因； - 任务状态和错误原因；
- AI 分析状态或分析成功率； - AI 分析成功率或成功率不足提示；
- 成功 X / 共 Y 条内容条目； - 成功 X / 共 Y 条内容条目；
- 热点排名； - 热点排名；
- 热点标题或摘要； - 热点标题或摘要；
@@ -482,7 +481,7 @@ fetch_creator_hot_spot_billboard
- 尝试继续处理剩余热点或内容条目； - 尝试继续处理剩余热点或内容条目；
- AI 单条解析失败时，该评论标记为未知或分析失败； - AI 单条解析失败时，该评论标记为未知或分析失败；
- 用户输入非法抓取规模配置值时，前端提示具体字段错误并阻止提交； - 用户输入非法抓取规模配置值时，前端提示具体字段错误并阻止提交；
- 不新增“部分成功”或“部分失败”任务状态；当 AI 结构化成功率不足但仍有可查看结果时，统一使用 `analysis_status` 标记分析不足。 - 不新增“部分成功”或“部分失败”任务状态；当 AI 结构化成功率不足但仍有可查看结果时，页面展示 AI 分析成功率不足提示。
核心验收： 核心验收：
@@ -604,7 +603,7 @@ MVP 完成时至少需要满足：
3. 系统可获取默认 Top 5 热点。 3. 系统可获取默认 Top 5 热点。
4. 系统可为每个热点拆分默认最多 5 条内容条目。 4. 系统可为每个热点拆分默认最多 5 条内容条目。
5. 系统可为每条内容条目抓取默认最多 50 条一级评论。 5. 系统可为每条内容条目抓取默认最多 50 条一级评论。
6. 任务内至少 80% 的评论成功生成情绪分类和方向标签，视为该验收项通过；低于此比例时任务状态仍遵循成功 / 失败规则，但 `analysis_status` 须标记为分析不足，并在页面展示提示。 6. 任务内至少 80% 的评论成功生成情绪分类和方向标签，视为该验收项通过；低于此比例时任务状态仍遵循成功 / 失败规则，但页面须展示 AI 分析成功率不足提示。
7. 系统可生成热点级汇总报告。 7. 系统可生成热点级汇总报告。
8. 系统可生成内容条目级分析报告。 8. 系统可生成内容条目级分析报告。
9. 页面可查看任务列表、热点列表、热点级报告、内容条目详情和评论明细。 9. 页面可查看任务列表、热点列表、热点级报告、内容条目详情和评论明细。