你是一名有5年python工程经验的后端开发工程师，为某银行风控系统编写生产级工具函数。请实现一个从excel文件读取用户行为日志并过滤异常ip段的函数。禁止生成无注释函数；禁止使用英文注释；禁止将注释写在代码行末尾（必须独立成行）。输出仅含以下3部分，严格按此顺序：①【函数定义】含完整def语句与类型提示；②【docstring】采用google风格，含args/returns/raises三段；③【行内注释】每逻辑块首行加#说明目的，如“# 校验ip是否在黑名单缓存中”。该函数每日凌晨2点由airflow调度执行，输入文件来自sftp服务器，ip黑名单缓存已预加载至redis。示例注释写法：# 过滤掉归属地为东南亚高风险国家的ip，依据2026年q2反诈白名单v3.1。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让海螺AI生成的代码自带清晰、准确、符合项目规范的中文注释，而不是每次都要手动补全或反复追问修改，就得用格式化提示词把注释要求“焊死”在第一次请求里。
首行锚定身份+任务，锁定注释生成意图
在输入框最开头写：“你是一名有5年Python工程经验的后端开发工程师，为某银行风控系统编写生产级工具函数。”
这句必须放在第一行，不能换行也不能加空格。【身份错位会导致模型忽略注释要求——比如写成‘你懂点编程’，它会默认只输出裸代码】
紧接着第二行写明交付物：“请实现一个从Excel文件读取用户行为日志并过滤异常IP段的函数。”
分三层嵌入注释硬约束
第三行开始用分号分隔三类不可妥协的限制：
禁止生成无注释函数；禁止使用英文注释；禁止将注释写在代码行末尾（必须独立成行）。
第四行起用符号框定格式结构：
输出仅含以下3部分，严格按此顺序：①【函数定义】含完整def语句与类型提示；②【Docstring】采用Google风格，含Args/Returns/Raises三段；③【行内注释】每逻辑块首行加#说明目的，如“# 校验IP是否在黑名单缓存中”。
注入真实业务语境提升注释准确性
方法一：在需求末尾追加一句具体场景描述
“该函数每日凌晨2点由Airflow调度执行，输入文件来自SFTP服务器，IP黑名单缓存已预加载至Redis。”
这句话会让模型自动在注释中体现调度时机、数据源和依赖服务，避免泛泛而谈。
方法二：插入对比样例强制对齐风格
“示例注释写法：# 过滤掉归属地为东南亚高风险国家的IP，依据2026年Q2反诈白名单V3.1”
海螺AI会模仿这个粒度，在后续注释中精准引用版本号、时间范围和政策依据。
验证与修复缩进/括号错误时同步保留注释
第一步：若生成代码出现缩进塌陷或括号不匹配，不要删掉原有注释重来。
第二步：复制整段带注释的错误代码，新开对话，首行输入：
“请仅修复以下Python代码的缩进与括号配对问题，不改动任何逻辑、变量名及注释内容：”
第三步：粘贴原始代码，发送。
这一步很关键，【必须用‘仅修复’而非‘优化’或‘重写’，否则模型会抹掉全部注释并重生成裸代码】
