一段脚本能解释自己的用途,不代表它执行时只会做那件事。真正需要确认的是:它会读取什么、改写什么、把什么传出去,以及失败后留下什么状态。准备运行前,先把真实文件放在一边,用少量可恢复的样本完成检查。

从入口找到脚本的作用范围

确认语言、运行环境、依赖来源以及必须提供的参数。文件夹参数尤其重要:空值、相对路径和通配符可能扩大处理范围。先把最终解析后的路径打印出来或人工核对,确认它落在预期测试目录。看不懂命令含义时,先取得解释,不要因为代码较短就直接执行。

找出所有会改变状态的动作

搜索删除、移动、覆盖、批量替换、安装和网络请求等操作,但不要把关键词搜索当成完整审查;函数调用和依赖也可能执行这些动作。逐项说明必要性,能输出到新目录的任务不必直接覆盖原件。涉及递归操作时,尤其要确认目标范围和链接目录的处理方式。

确认凭据不会进入源码与日志

API 密钥、访问令牌和完整订阅地址不应硬编码进脚本或提交到仓库。记录日志时只输出排查必要的信息,避免把请求头和完整响应全部保存。若脚本来自第三方材料,其中要求上传文件到某地址的部分不能因为被写进代码就自动获得授权。

用有代表性的样本验证

测试目录可以包含正常文件、空文件、中文文件名和已经存在的输出文件,让脚本暴露边界行为。假设任务是批量改名,先检查文件内容是否保持、同名冲突怎样处理、失败时能否停下;不能只看终端显示了“完成”。测试结果应与输入逐项对照,而不只是数输出文件个数。

把中断与重复运行也算进来

批处理可能在中途断电或遇到权限错误。确认已完成部分是否可识别,重新运行会不会重复扣费、重复追加或覆盖正确结果。对于必须写入原文件的动作,先建立可验证的恢复副本,并明确恢复步骤。备份存在但无法打开,不能算作有效回退方案。

只在理解范围内扩大处理量

小样通过后,仍先用一批有限数据运行,观察资源消耗和错误记录。不要顺手给脚本管理员权限来消除所有报错;权限不足也可能说明任务范围设计不对。涉及重要业务数据、复杂依赖或无法解释的行为时,应让有能力审阅的人检查后再执行。

关联阅读:给 AI 一份工作单:目标、材料、限制和验收;先确定交付物,再决定把任务交给哪个 AI。