第13章样板:三色卡反馈终端

这是“物理输入 + 规则模型 + AI协同开发”的完整原型。第一次运行不需要摄像头、网络或第三方Python库。

5分钟运行

在本目录打开终端:

python scripts/setup.py
python app/main.py --sample
python scripts/verify.py

预期看到红、黄、绿、无卡、暗光和两色冲突六个样例分别进入 STOP、CHECK、PASS、UNKNOWN、FALLBACK 和 CHECK,并生成 logs/run_log.md。

先理解,再让Qwen Code修改

  1. 阅读 PARAMETER_CARD.md,确认这是人工阈值规则模型,不是训练模型。
  2. 查看 config/rule_model.json 和 app/main.py 的输入、证据、阈值、状态和反馈。
  3. 在Qwen Code中输入自己的需求,但先要求它只列修改文件、最小补丁、测试和风险,不立即执行。
  4. B档三选一:新增蓝色、修改一个最低颜色占比、调整ROI。
  5. 查看差异后再批准执行,并重新运行全部六个样例和测试。
  6. 在 ai_collaboration_log.md 写清学生自己的判断。

摄像头拓展

只有教师确认依赖和隐私边界后才运行:

python app/main.py --camera

程序只读取一帧,不主动保存或上传。画面中不得出现人脸、证件、屏幕信息或他人隐私。摄像头不可用不是失败,返回样例模式继续完成核心任务。

验收