核心模块智能识别

前置要求：请先阅读 docs/01-项目扫描报告.md 和 docs/02-项目架构文档.md，基于前两步的分析结果进行全面的模块识别。

核心目标：智能识别项目中的所有重要模块，确保识别的正确性和完整性。

第一步：项目类型确认和识别策略

1. 项目特征确认

请基于前两步分析结果确认项目特征：

• 项目类型：[基于架构文档确认具体类型]
• 架构模式：[基于架构文档确认架构特点]
• 代码组织方式：[基于扫描报告确认目录结构特点]

2. 智能识别策略选择

请根据项目类型自动选择合适的模块识别策略：

通用识别原则：

• 包含独立功能的代码组织单元
• 具有明确职责边界的功能集合
• 被其他部分引用或依赖的代码模块
• 具有独立配置或资源的功能单元

项目类型特定识别重点：

• 桌面应用：界面模块、核心逻辑模块、数据处理模块、系统交互模块
• 前端应用：页面/组件模块、状态管理模块、工具模块、服务模块
• 移动应用：界面模块、业务模块、数据模块、平台适配模块
• 后端服务：接口模块、业务模块、数据访问模块、工具模块
• 库/框架项目：核心功能模块、扩展模块、工具模块、示例模块

第二步：全面模块扫描和识别

3. 系统化模块扫描

请通过多种方式系统扫描识别所有模块：

3.1 基于目录结构识别

• 主要目录扫描：识别所有一级和重要二级目录
• 命名规律分析：分析目录命名规律，推断模块划分逻辑
• 功能目录识别：识别明显的功能性目录组织

3.2 基于代码依赖识别

• 导入依赖分析：分析import/include/require等依赖关系
• 调用关系分析：识别代码间的调用和引用关系
• 入口文件识别：找到各功能模块的主要入口文件

3.3 基于功能特征识别

• 相似功能聚合：将功能相关的代码文件归类为模块
• 独立功能识别：识别具有独立功能的代码组织
• 配置文件关联：通过配置文件识别相关的功能模块

4. 模块清单生成

请按以下格式列出所有识别到的模块：

模块列表（简化格式）：

[序号]. [模块名称]

• 模块标识：[准确的模块名称]
• 主要目录/文件：[2-3个关键路径]
• 模块类型：[核心功能/基础支撑/工具辅助/配置管理]
• 主要职责：[1-2句话概括核心功能]
• 重要程度：[高/中/低]

第三步：模块完整性和正确性验证

5. 多轮验证确保完整性

请通过多种方式验证模块识别的完整性：

5.1 功能覆盖验证

• 核心功能检查：项目的所有核心功能是否都有对应的模块？
• 架构组件检查：架构文档中提到的组件是否都被识别为模块？
• 目录覆盖检查：重要的代码目录是否都归属到了相应模块？
• 配置文件检查：重要的配置文件是否都关联到了相应模块？

5.2 代码文件覆盖验证

• 主要代码文件：所有重要的代码文件是否都归属到了模块？
• 入口文件检查：所有入口文件是否都被正确识别和归类？
• 工具脚本检查：构建脚本、工具脚本是否被识别为相应模块？
• 资源文件检查：重要的资源文件是否被关联到相应模块？

5.3 依赖关系验证

• 导入依赖检查：通过代码导入关系验证模块识别的正确性
• 调用关系检查：通过函数/方法调用关系验证模块边界
• 数据流检查：通过数据流向验证模块间的关系
• 配置依赖检查：通过配置文件验证模块间的依赖关系

6. 模块正确性验证

请验证每个识别模块的正确性：

6.1 模块边界验证

• 职责单一性：每个模块是否有明确且单一的职责？
• 边界清晰性：模块间的边界是否清晰，无重叠？
• 内聚性检查：模块内部的代码是否高度相关？
• 耦合性检查：模块间的耦合是否合理？

6.2 命名和分类验证

• 命名准确性：模块名称是否准确反映其功能？
• 分类合理性：模块类型分类是否合理？
• 重要程度评估：模块重要程度评估是否准确？
• 文件路径验证：所有文件路径是否真实存在？

7. 模块关系图和总结

7.1 模块依赖关系图

graph TD
    %% 请根据实际识别的模块绘制依赖关系
    %% 使用真实的模块名称
    %% 重点展示主要的依赖关系

7.2 模块分层总结

请根据项目实际情况进行分层总结：

• [第一层级]：[列出该层级的模块]
• [第二层级]：[列出该层级的模块]
• [第三层级]：[列出该层级的模块]
• [其他层级]：[根据实际情况添加]

7.3 模块统计总结

• 模块总数：[识别的模块总数量]
• 核心模块数：[重要程度为”高”的模块数量]
• 覆盖的代码文件数：[被归类到模块的代码文件总数]
• 覆盖的目录数：[被归类到模块的目录总数]

8. 识别质量评估

请对模块识别结果进行质量评估：

8.1 完整性评估

• 功能完整性：[评估是否覆盖了所有重要功能，给出百分比]
• 代码完整性：[评估代码文件的覆盖程度，给出百分比]
• 架构完整性：[评估与架构文档的一致性程度]

8.2 准确性评估

• 模块边界准确性：[评估模块划分的准确程度]
• 命名准确性：[评估模块命名的准确程度]
• 分类准确性：[评估模块分类的准确程度]

8.3 问题识别

• 遗漏的模块：[可能遗漏的重要模块，标注”[需要确认]”]
• 边界模糊的模块：[职责边界不清晰的模块]
• 分类有疑问的模块：[分类可能不准确的模块]

输出要求

• 格式：使用Markdown格式
• 保存路径：docs/03-核心模块识别.md
• 重点内容：完整的模块清单、依赖关系图、质量评估
• 不确定标注：不确定信息标注”[需要确认]”
• 来源标注：引用前两步分析结果标注”[来源：扫描报告/架构文档]”

重要提示：对于大型项目，请采用分批处理策略，确保每个模块都得到准确识别。

最终验证清单

完成识别后，请确认：

• 基于前两步分析结果进行了模块识别
• 根据项目类型选择了合适的识别策略
• 识别了所有重要的功能模块
• 所有文件路径真实存在
• 模块边界清晰且无重叠
• 依赖关系图能正确渲染
• 完整性和准确性得到验证
• 为第四步提供了完整的模块清单