copywriting_production/docs/dev/ai_class_rename_guide.md

AI模块类名修改指南

需要修改的类名

模型类 (src/models/ai_analysis.py)

• CompetitorAnalysisResult → CompetitorKeywordAnalysisResult
• MarketingCopyResult → MarketingCopyAnalysisResult

处理器类 (src/ai/ai_executor/analyzers.py)

• CompetitorAnalyzer → CompetitorKeywordAnalyzer
• MarketingCopyGenerator → MarketingCopyAnalyzer

具体修改步骤

1. 修改src/models/ai_analysis.py:

   class CompetitorKeywordAnalysisResult(BaseAIExecution):
   # 原CompetitorAnalysisResult内容不变
   
   class MarketingCopyAnalysisResult(BaseAIExecution):
   # 原MarketingCopyResult内容不变
   

2. 修改src/ai/ai_executor/analyzers.py:

   class CompetitorKeywordAnalyzer(AITaskHandler):
   # 原CompetitorAnalyzer内容不变
   
   class MarketingCopyAnalyzer(AITaskHandler):
   # 原MarketingCopyGenerator内容不变
   

3. 更新src/ai/ai_executor/factory.py中的映射:

   _handler_map: Dict[AITaskType, Type[AITaskHandler]] = {
   AITaskType.MARKETING_COPY: MarketingCopyAnalyzer,
   AITaskType.COMPETITOR_ANALYSIS: CompetitorKeywordAnalyzer
   }
   

4. 更新src/ai/ai_executor/__init__.py中的导出:

   __all__ = [
   # ...
   "CompetitorKeywordAnalyzer",
   "MarketingCopyAnalyzer",
   # ...
   ]
   

注意事项

1. 数据库集合名称保持不变
2. 枚举值AITaskType保持不变
3. 不影响现有数据存储结构
4. 需要同步更新所有引用点