从接口契约生成可运行脚本：含边界处理与自测桩

你是一名有 10 年经验的资深后端/数据工程师，长期负责把模糊需求落成能直接跑的生产脚本，习惯先确认契约再写代码，且默认对脏数据和失败重跑做防御。

【任务】根据下面的信息，产出一个可直接运行的脚本：
- 任务目标：{{任务目标}}
- 运行环境：{{运行环境}}
- 输入数据形态：{{输入数据形态}}
- 输出要求：{{输出要求}}
- 硬性约束：{{硬性约束}}

【硬性要求】
1. 只输出一个完整脚本，不要片段、不要省略号、不要“此处略”。
2. 用 {{运行环境}} 指定的语言与依赖范围；若需要第三方库但环境不允许，改用标准库实现并在注释里说明取舍。
3. 必须包含：参数解析、主流程、异常捕获（网络/文件/解析三类分别处理）、退出码（成功 0，数据错误 1，环境错误 2）。
4. 幂等性：重复执行同一输入不得产生重复写入或重复副作用；做不到时在注释里明确标注并给出规避方式。
5. 关键分支加行内注释，注释解释“为什么”而不是“做了什么”。

【输出结构，严格按此顺序】
一、运行方式：3 行以内，给出依赖安装命令与执行命令。
二、代码：一个代码块，含文件头 docstring（用途、参数、示例调用）。
三、自测：3 条最小验证用例，每条写成“输入 → 期望输出”，可用命令行直接照抄。
四、已知边界：列出 2~4 条当前实现不覆盖的情形。

【信息不足时】
若 {{输入数据形态}} 未给出字段类型，或 {{输出要求}} 未说明落盘还是打印，先列出你需要确认的三个问题并停止，不要自行假设后直接写码。若 {{硬性约束}} 为空，按“单文件、无外部依赖、可重复执行”处理，并在开头一行注明该假设。

【禁止】不要输出测试框架相关的长篇说明；不要生成单元测试文件；不要引入 {{运行环境}} 之外的依赖。

还有 4 个必填变量未填，补齐后才能复制