需提供结构化项目上下文：一、生成过滤后的文件树快照；二、提取核心模块接口契约；三、用约束性提示指令要求AI静态分析依赖关系；四、分片上传并交叉验证；五、注入领域规则指导重构。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望借助ChatGPT对一个完整项目进行深度代码重构，尤其是需要AI理解模块间依赖关系并据此提出安全、可维护的重构方案，则必须向AI提供清晰、结构化的项目上下文。以下是实现该目标的具体操作路径：
一、生成标准化的项目文件结构快照
AI无法直接读取本地文件系统，因此需人工将项目目录结构转化为文本形式，使其具备可解析性。该结构需保留层级关系与关键文件类型标识，以便AI识别入口点、核心模块与配置边界。
1、打开终端或命令行工具，进入项目根目录。
2、在Linux/macOS系统中执行：find . -type f -not -path "./node_modules/*" -not -path "./venv/*" -not -path "./.git/*" | sort > project_tree.txt。
3、在Windows PowerShell中执行：Get-ChildItem -Recurse -File | Where-Object {$_.FullName -notmatch "node_modules|venv|\.git"} | ForEach-Object {$_.FullName} | Sort-Object | Out-File -Encoding UTF8 project_tree.txt。
4、用文本编辑器打开project_tree.txt，删除无关路径（如日志、构建产物），仅保留源码、配置、测试三类路径。
二、提取关键模块声明与接口契约
仅靠目录结构不足以推断依赖逻辑，AI还需掌握各模块的导出项、导入项及调用约定。需手动摘录核心文件的接口定义片段，形成“契约摘要”，避免AI误判隐式耦合。
1、定位主入口文件（如main.py、index.js、src/main.ts），复制其顶层import/require语句及export/default export内容。
2、对每个被高频引用的模块（如utils、services、models），摘录其文件顶部的类型声明、函数签名或class定义首行（例如interface User {...}、export function fetchOrder(...) {...}）。
3、将所有摘录内容合并为独立文本块，标注来源文件路径，格式为：[src/utils/apiClient.ts] export const request = (config: RequestConfig) => {...}。
三、构造带约束的AI提示指令
向ChatGPT提交信息时，需明确限定分析维度与输出格式，防止其泛化解释或虚构未见逻辑。指令须强制AI以静态分析视角工作，禁用运行时假设。
1、在提示开头声明：你是一名资深静态代码分析工程师，仅依据我提供的文件结构和接口契约进行模块依赖图谱推导，不假设任何未显式声明的调用关系或动态导入行为。。
2、要求AI分步输出：第一步：列出所有显式import/require路径，映射到project_tree.txt中的实际文件；第二步：对每个模块，标注其被哪些其他模块直接导入；第三步：识别循环依赖路径（A→B→A）、跨层调用（如UI组件直接调用DAO）和高扇出模块（单模块导出被≥5处引用）。。
3、禁止AI生成代码修改建议，仅输出依赖关系表格与风险节点标记。
四、分片上传并交叉验证依赖结论
超大项目结构文本易触发模型截断或注意力稀释，需按功能域切分并分别提交，再比对各域结论一致性，排除因上下文丢失导致的误判。
1、按project_tree.txt中的目录前缀划分切片，例如：src/api/、src/components/、src/store/ 各为一片。
2、对每片单独执行步骤三的提示指令，获取该域内的局部依赖子图。
3、汇总所有子图，检查跨域引用是否闭合——例如src/api/中import的src/utils/auth应能在src/utils/切片结论中查到对应导出项，否则标记为缺失契约声明。
五、注入领域规则约束重构方向
在获得准确依赖图谱后，需人工注入业务规则，指导AI生成符合架构约束的重构动作。AI不可自主决定分层策略，所有重构指令必须基于预设规则集展开。
1、明确定义分层规范，例如：“所有src/pages/下的React组件不得直接import src/services/，必须通过src/hooks/中的自定义Hook间接调用”。
2、向AI提供该规范，并附加依赖图谱中标记的违规边（如pages/Dashboard.tsx → services/orderApi.ts），指令其：仅生成符合该规范的替换方案，包括新增Hook文件路径、新Hook的useQuery调用封装、原组件中import语句与函数调用的逐行替换对照表。。
3、要求AI对每个替换动作标注影响范围：修改文件数、需同步更新的测试文件、是否涉及API响应结构变更。
