使用tree和pydeps生成精简结构与依赖文本,合并为code_context.md并添加用途说明;以Mermaid图谱Prompt驱动Kimi输出带调用类型标签的graph TD依赖图,通过mermaid.live验证流向与闭环,支持行号级追问。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要快速理清一个几十万行的Python项目里模块之间的调用链、第三方包依赖路径和潜在的循环引用,但传统静态分析工具输出冗长、可视化弱、难以交互追问。
准备可被Kimi解析的代码切片
进入项目根目录,用tree -L 3 -I "__pycache__|venv|.git|.mypy_cache" > structure.txt生成精简目录树,保留三层深度并排除常见缓存目录。
对核心模块执行pydeps --max-bacon=2 --max-cluster-size=1 --show-cycles src/,导出带层级缩进的依赖文本,该命令能暴露跨包调用但不展开标准库——这是后续图谱提示词的关键输入源。
把structure.txt和pydeps_output.txt合并为code_context.md,顶部加一行说明:“以下为项目结构与模块级依赖关系快照,非完整代码,仅用于构建依赖图谱。”【Kimi对无上下文标记的纯代码块容易误判语法结构,必须显式声明用途】
构造图谱导向型Prompt
方法一:节点-边双段式指令
第一段定义节点规则:“将每个.py文件视为独立节点,命名格式为‘包名.模块名’(如src.utils.helpers → utils.helpers);忽略__init__.py和测试文件(test_*.py或*_test.py)。”
第二段定义边规则:“仅当A模块中出现import B或from B import X且B在当前项目内时,生成有向边A→B;若B是第三方包(如requests、numpy),则标记为外部依赖节点,不展开其内部结构。”
方法二:角色+约束混合提示
设定Kimi为“Python架构图谱工程师”,要求它:“输出严格遵循Mermaid语法的graph TD图,每条边必须附带调用类型标签(import/from/importlib.import_module),禁止添加任何解释性文字或Markdown代码块包裹符。”
监控Kimi K2.5 API使用量和配额。通过Kimi控制台实现:(1)查看剩余使用百分比和重置计时器;(2)根据可用配额自主决策任务优先级;(3)密集操作前监控速率限制;(4)记录使用模式以支持资源规划。适用于配额约束下的自主智能体。
方法三:反例驱动校验提示
在Prompt末尾追加三行禁止项:“× 不得将同一模块拆分为多个节点 × 不得为os/sys等内置模块创建节点 × 不得将相对导入(from .. import)错误解析为绝对路径节点”——这能显著降低Kimi幻觉生成率。
执行图谱生成与轻量验证
将code_context.md全文粘贴至Kimi对话框,紧接插入构造好的图谱Prompt(推荐使用方法二),点击发送。
等待响应后,立即检查首行是否为graph TD,若出现graph LR或flowchart TB需手动替换——【Mermaid渲染器对方向关键词敏感,LR/TB会导致布局错乱无法识别依赖流向】
复制返回的Mermaid代码,在https://mermaid.live/中粘贴预览,重点验证三点:src.api.v1.routes是否指向src.services.user;requests是否标记为external;是否存在src.models → src.schemas → src.models闭环。
发现闭环时,在Kimi中追加追问:“请将src.models → src.schemas → src.models路径中的每条边标注具体调用语句位置(文件:行号),仅返回带行号的边列表。”










