Python 实现 AI 绘画用户评价自动分类与报告生成

report_generator.py (报告生成模块)

负责汇总分析结果并生成包含改进建议的 Markdown 报告。

# report_generator.py
from collections import Counter
from review_analyzer import ReviewAnalyzer
from config import REPORT_OUTPUT_PATH

class ReportGenerator:
    def __init__(self):
        self.analyzer = ReviewAnalyzer()

    def generate_report(self):
        """
        生成并保存评价分析报告。
        """
        print("\n--- 开始进行评价分析 ---")
        analysis_results = self.analyzer.analyze_all_reviews()
        if not analysis_results:
            print("[FAIL] 没有可分析的数据，报告生成中止。")
            return

        # 1. 统计情绪分布
        labels = [res['sentiment_label'] for res in analysis_results]
        label_counts = Counter(labels)
        total_reviews = len(analysis_results)
        satisfied_percentage = (label_counts.get('Satisfied', 0) / total_reviews) * 100
        unsatisfied_percentage = (label_counts.get('Unsatisfied', 0) / total_reviews) * 100
        neutral_percentage = (label_counts.get('Neutral', 0) / total_reviews) * 100

        # 2. 提取代表性评论
        top_satisfied = sorted([res for res in analysis_results if res['sentiment_label'] == 'Satisfied'],
                               key=lambda x: x['polarity_score'], reverse=True)[:3]
        top_unsatisfied = sorted([res for res in analysis_results if res['sentiment_label'] == 'Unsatisfied'],
                                 key=lambda x: x['polarity_score'])[:3]

        # 3. 生成改进建议 (核心商业洞察)
        suggestions = []
        if unsatisfied_percentage > 30:
            suggestions.append("- **紧急行动**：负面情绪占比超过 30%，表明产品存在严重的用户体验问题。应立即组织跨部门会议，深入分析负面评论的具体内容，优先解决高频出现的 Bug 和功能缺陷。")
        elif unsatisfied_percentage > 15:
            suggestions.append("- **重点关注**：负面情绪值得警惕。建议对用户抱怨最多的几个方面进行专项调研，并考虑推出针对性的小版本更新进行修复和优化。")
        if satisfied_percentage > 70:
            suggestions.append("- **乘胜追击**：正面反馈极高，说明产品核心价值得到广泛认可。可考虑加大市场宣传力度，或在现有好评基础上，挖掘用户喜爱的深层原因，并尝试应用到新功能的开发中。")
        if neutral_percentage > 40:
            suggestions.append("- **激活沉默用户**：大量中性评价意味着用户对产品印象平平。可以尝试发起社区活动、征集创意、或与活跃用户建立更紧密的联系，引导他们提供更深入的反馈，并提升他们对产品的参与度。")

        # 4. 构建 Markdown 报告内容
        report_content = f"# AI 绘画产品用户评价分析报告\n\n"
        report_content += f"**分析时间**: 自动生成\n"
        report_content += f"**数据来源**: `{self.analyzer.FEEDBACK_FILE_PATH}`\n"
        report_content += f"**总评价数**: {total_reviews}\n\n"
        report_content += "## 1. 情绪分布概览\n\n"
        report_content += f"- **满意**: {label_counts.get('Satisfied', 0)} 条 ({satisfied_percentage:.2f}%)\n"
        report_content += f"- **不满意**: {label_counts.get('Unsatisfied', 0)} 条 ({unsatisfied_percentage:.2f}%)\n"
        report_content += f"- **中性**: {label_counts.get('Neutral', 0)} 条 ({neutral_percentage:.2f}%)\n\n"
        report_content += "## 2. 洞察与建议\n\n"
        if not suggestions:
            report_content += "> 用户反馈整体健康，情绪分布较为均衡，暂无明显问题。\n\n"
        else:
            for suggestion in suggestions:
                report_content += f"> {suggestion}\n"
        report_content += "\n"
        report_content += "## 3. 代表性评论\n\n"
        report_content += "### 👍 Top 满意评论\n\n"
        if top_satisfied:
            for comment in top_satisfied:
                report_content += f"- `{comment['polarity_score']:.2f}` **{comment['original_text']}**\n"
        else:
            report_content += "无显著满意评论。\n"
        report_content += "\n"
        report_content += "### 👎 Top 不满意评论\n\n"
        if top_unsatisfied:
            for comment in top_unsatisfied:
                report_content += f"- `{comment['polarity_score']:.2f}` **{comment['original_text']}**\n"
        else:
            report_content += "无显著不满意评论。\n"
        report_content += "\n"

        # 5. 保存报告
        with open(REPORT_OUTPUT_PATH, 'w', encoding='utf-8') as f:
            f.write(report_content)
        print(f"[SUCCESS] 报告已成功生成：{REPORT_OUTPUT_PATH}")

main.py (主程序入口)

# main.py
from report_generator import ReportGenerator

def main():
    print("=" * 50)
    print("Welcome to Review Analyzer")
    print("=" * 50)
    analyzer = ReportGenerator()
    analyzer.generate_report()

if __name__ == "__main__":
    main()

4. README.md 与使用说明

创建一个名为 README.md 的文件在项目根目录。

# AI 绘画用户评价分析器

## 🚀 简介
一款专为 AI 绘画产品团队设计的自动化用户反馈分析工具。它能够批量读取用户评价，精准识别情绪倾向，并自动生成包含可操作改进建议的分析报告。

## 🛠️ 安装与环境配置

1. **克隆仓库**
   ```bash
   git clone <repository_url>
   cd ArtCriticScope

2. 创建虚拟环境 (推荐)

   python -m venv venv
   source venv/bin/activate # On Windows: venv\Scripts\activate
   

3. 安装依赖

   pip install -r requirements.txt
   

   requirements.txt 内容:

   textblob
   nltk
   

4. 下载 NLTK 数据包 首次运行时，程序会自动下载所需的 NLTK 数据包。

🏃 如何使用

1. 准备评价数据: 在项目根目录下创建一个名为 user_reviews.txt 的文本文件。
2. 输入评价: 将用户的评价逐行写入该文件。例如：

   这个模型画的风景太美了，光影处理简直是神来之笔！
   生成速度太慢了，而且经常断线，非常失望。
   还行吧，能出图，但跟我的描述总感觉差了点意思。
   

3. 运行程序:

   python main.py
   

4. 查看报告: 程序会在根目录生成一个 review_analysis_report.md 文件，用 Markdown 阅读器打开即可查看详细分析和建议。

### 核心知识点卡片

#### 1. Natural Language Processing (NLP) - 自然语言处理

- **是什么**：是人工智能的一个分支，旨在让计算机能够理解、解释和生成人类语言。
- **本项目中的应用**：情绪分析是 NLP 最经典的应用之一。我们使用 TextBlob 这个高级库，它内部封装了复杂的 NLP 模型，让我们能够用几行代码就实现文本情绪的判断。

#### 2. Data-Driven Decision Making (数据驱动决策)

- **是什么**：一种基于事实、数据和量化分析来制定商业决策的方法，而不是凭直觉或经验。
- **本项目中的应用**：本工具将主观的、零散的用户评价，转化为了客观的、可量化的统计数据（百分比、排名）和具体的商业建议。

#### 3. Closed-Loop Feedback System (闭环反馈系统)

- **是什么**：一个将用户反馈作为输入，通过分析处理后转化为产品或服务的改进措施，并最终回馈给用户，形成一个持续改进的动态循环。
- **本项目中的应用**：本项目是这个闭环系统的前半部分——自动化分析和洞察生成。它为后半部分的'采取行动'提供了坚实的基础。

#### 4. Minimum Viable Product (MVP) - 最小可行产品

- **是什么**：指一个新产品或新功能在尽可能短的时间内，以最低的成本开发出来的、能够满足早期用户核心需求的最精简版本。
- **本项目中的应用**：ArtCriticScope 本身就是一个 MVP。它聚焦于最核心的价值主张——'快速分析评价并提供改进建议'。

### 总结

该项目展示了如何利用现有的 Python 生态系统（如 TextBlob 和 NLTK）快速搭建一个功能强大的分析工具。它不仅仅是一个技术 Demo，更是一个具有明确市场定位的、可实际使用的产品，帮助团队更好地理解用户，锻炼开发者从用户需求出发、构建有价值产品的核心能力。