最终成果:用虚构计价单位演练预算预留、重复请求和拒绝超额任务。
这是一门可离线完成的Python实践课,使用标准库,不需要模型密钥。例子均为教学虚构,不是现实业务数据或真实效果证据。
1. 先看成果
输入示例:
{
"budget": 10,
"requests": [
{
"key": "a",
"cost": 3
}
]
}
预期输出:
{
"remaining": 7,
"results": [
{
"key": "a",
"status": "approved"
}
]
}
2. 准备与首次运行
准备Python 3.10或更高版本。完整解压项目包,在包含verify.py的文件夹打开终端。Windows可用py -3代替python,macOS/Linux可用python3。
python --version
python verify.py
起始代码尚未实现,首次看到7项FAIL和NotImplementedError属于正常起点;语法或导入错误会给中文说明且不生成报告。先提交这份失败报告也可以。
3. 输入输出契约
budget是0到1000000的真正整数(教学虚构点数,不是货币);requests为最多100个对象。key为非空字符串最多80字符,cost为0到1000000整数,不能为bool。按顺序处理:已批准key与原cost相同则duplicate,不同则conflict;新key且cost<=remaining则approved并扣减;否则blocked且不登记key。输出remaining与results,每项含key、status。这是本地预留模拟,不调用模型、不扣真实费用。
solve(payload)接收一个JSON对象并返回上述JSON结果。任何契约规定的结构或类型错误都应抛ValueError,不返回貌似成功的部分结果。
4. 三段实现与分层提示
1. 预算必须明确
校验整数点数,零成本和零预算都合法。
关注用例:normal、zero、free
-
第1层:True能否当作1点?
-
第2层:类型须恰好是int,并限制范围。
-
第3层:先验证整份输入,再初始化remaining。
2. 执行前预留
按顺序比较可用预算。
关注用例:blocked、sequential
-
第1层:先执行再发现不够预算来得及吗?
-
第2层:cost不超过remaining才批准并扣减。
-
第3层:被拦截的请求不登记成功key,后面仍可处理。
3. 重试不重复预留
区分重复请求与key内容冲突。
关注用例:duplicate、conflict
-
第1层:相同key能代表两种成本吗?
-
第2层:已批准key绑定cost;重复不扣点,冲突不覆盖。
-
第3层:在比较剩余额度之前先查询批准记录。
先写下自己的预期,再展开一层提示并修改。verify.py默认展示字段差异,仍卡住可加--explain查看诊断。
5. 用本地网页检查自己的输入
python run.py
打开终端显示的本地地址(默认http://127.0.0.1:8870),修改输入并运行,保存输出。端口已占用可运行python run.py --port 8871;不需要停止其他程序。
参考演示可运行python run.py --reference,参考输出不表示你自己的实现通过。
6. 组合挑战与评分
python verify.py --suite challenge --report challenge-report.json
4项挑战各25分,输入、错误类型及所有输出字段符合约定才得该项分数。完整用例与评分依据在project.json的learning.cases中。只表示这组输出符合约定,不证明独立能力。
-
被拦截后改变成本:未批准key不被锁死。
-
空任务:空任务保留预算。
-
零点任务重复:零成本也必须幂等。
-
布尔值不能当成本:True属于int子类,须严格排除并抛ValueError。
7. 自主扩展与提交
增加取消预留或有限重试策略,用虚构点数保存失败轨迹;解释多进程并发下还需要什么事务保护。
至少自建一个测试,先写预期,再运行并保存实际结果。在项目页上传报告,填写两道解释题,展开自主扩展记录,填写需求、JSON输入/预期/实际及修订说明。扩展内容不自动算分,申请人工评价后由人核对。
-
解释题:为什么重复请求检查要先于余额检查?
-
解释题:自建取消或重试案例,解释本地模拟与真实计费的区别。
报告默认私有;申请后管理员才可看该次报告、项目链接、复盘与扩展证据,可撤回共享。服务器复核报告输出,不执行上传代码、不访问作品链接。修订时保留失败与新报告,不覆盖旧记录。
8. 局限与后续
本项目训练上述确定性规则,不调用模型,不代表完整业务系统。如需以后接入模型,先保留基线,单独明确成本与调用授权、构造错误输出并人工核对,不把本站参考结果当作模型效果。