必须提供requirements.txt、config.py(或config.json)、主程序入口文件三类核心文件,否则混元将基于通用知识生成不可运行的伪代码;建议补充readme.md片段、报错日志原文、目标函数调用示例以提升准确性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在使用腾讯混元大模型辅助编程时,若需获得高质量、可直接运行的Python代码(如数据库同步脚本、格式转换工具、API调用封装等),必须向模型明确提供当前项目的结构化上下文,否则模型将基于通用知识猜测文件路径、配置格式和依赖关系,极易生成无法落地的伪代码。
必须提供的核心项目文件清单
这三类文件是混元理解项目真实约束的最低门槛,缺一不可:
① 【requirements.txt】 —— 模型据此判断是否需引入pymysql、openpyxl、ffmpeg-python等特定库,避免推荐已弃用或不兼容的包;若缺失,混元可能默认使用sqlite3而非你实际部署的MySQL。
② 【config.py 或 config.json】 —— 提供数据库地址、API密钥占位符、路径常量等。没有它,混元会硬编码localhost:3306或写死/test/output/,导致代码在你环境里直接报ConnectionRefusedError。
③ 主程序入口文件(如main.py、app.py或task_runner.py)—— 模型需要观察现有代码风格(是否用click?是否继承BaseCommand?是否采用async/await?),否则生成的函数签名可能与你已有的CLI参数解析逻辑冲突。
强烈建议补充的辅助文件
这些文件不强制,但提供后能显著降低调试轮次:
方法一:提供当前目录下的README.md片段(尤其是“快速开始”章节)—— 混元能识别出你用的是Docker启动还是python -m venv方式,从而决定是否在生成代码中加入os.environ.get("ENV", "dev")这类环境判断。
方法二:粘贴报错日志原文(含Traceback)—— 比如出现ModuleNotFoundError: No module named 'PIL',混元会立刻定位到缺失pillow,并在requirements.txt建议行末追加pillow>=10.0.0,而不是笼统说“安装图像库”。
方法三:给出目标函数的调用示例(如process_video(input_path="test.mp4", quality="high"))—— 这比单纯说“写个视频处理函数”精准十倍,混元会严格对齐参数名、默认值和返回类型注解。
绝对禁止提供的内容
不要上传包含真实密钥的.env文件全文——混元虽不存储数据,但提示词中暴露AK/SK会导致你后续所有对话都隐含泄露风险。正确做法是替换为占位符:【DB_PASSWORD=your_actual_password_here】,并额外说明“该密码由运维组通过KMS注入,代码中不可硬编码”。
不要提供未完成的半截代码(如只有def upload_file(开头而无缩进体)—— 混元会误判为你希望延续此函数,强行补全逻辑,结果覆盖你原本想重写的模块。











