版本对照:左侧保留服务器原有 v1.7,右侧为当前中职修订稿。两栏可独立滚动。
旧版 v1.7原稿

第14章 我和 AI 一起做小作品:信号卡智能提醒器

本章导读

第13章中,我们已经让第3章搭建好的本地智能体进入现实任务:在 VS Code 插件中提出需求,让智能体检查摄像头、生成程序,并完成三色卡识别反馈。那一章的重点是让 AI 第一次通过程序接触物理世界。

到了本章,我们把这个最小任务继续向前推进一步:不只是让摄像头能识别颜色,而是和 AI 智能体一起做出一个能演示、能说明、能复盘的小作品。

本章作品叫作信号卡智能提醒器。它的基本规则很简单:

绿色卡片:状态正常,可以继续。
黄色卡片:不确定,需要人工确认。
红色卡片:需要帮助,请暂停并关注。
画面太暗或没有检测到卡片:请调整光线或重新拍摄。

这个作品不复杂,但它已经包含物理 AI 小作品最重要的结构:现实输入要能被采集,判断规则要能说清,反馈结果要能复核,运行过程要能留下证据。也就是说,本章不是再做一次颜色识别,而是把第13章的最小闭环整理成一个能演示、能测试、能复盘、能验收的小作品。

本章仍然延续前面的人机协同方式。不是完全从零写代码,也不能把任务完全交给 AI。使用者的角色是小作品负责人:要说清楚想做什么,检查智能体给出的方案,确认程序是否安全,运行并记录结果,最后能向他人讲清楚这个作品为什么能用、哪里可能出错、哪些地方必须人工确认。

《礼记·学记》说:独学而无友,则孤陋而寡闻。 一个 AI 小作品不是做完就结束。让别人看得懂、跑得起、能复核、能提出改进意见,作品才真正进入协作。

学习目标

  • 知识目标:
    1. 能说明物理 AI 小作品的基本链路:感知、判断、反馈、复核。
    2. 能理解智能体为什么要通过程序、权限和运行环境访问摄像头,不能绕过用户确认直接操作设备。
    3. 能说明三色卡识别为什么适合作为物理 AI 入门作品。
  • 能力目标:
    1. 能在 VS Code 插件中用清楚的提示词向智能体说明作品需求。
    2. 能让智能体生成或修改一个简单的信号卡识别程序。
    3. 能完成一次摄像头取图或样例图片输入 → 颜色判断 → 文字反馈 → 人工复核的最小闭环。
    4. 能整理一份作品证据包,包含提示词、运行结果、测试记录和复盘说明。
  • 素养目标:
    1. 建立 AI 可以帮助开发,但最终结果必须由人检查的责任意识。
    2. 在使用摄像头时尊重他人隐私,不随意拍摄、保存或传播他人图像。
    3. 理解物理 AI 作品应从低风险任务做起,不能让 AI 直接控制危险设备。

先修要求与环境清单

  • 已完成第3章本地智能体环境和第13章摄像头识别任务。
  • 软件环境:VS Code、VS Code 中的 AI 协同插件、课程统一配置的本地智能体或本地大模型服务、课程预置 Python 环境。
  • 材料准备:红色、黄色、绿色卡片;没有卡片时可使用红、黄、绿三种普通物品。
  • 兜底资源:电脑没有摄像头时,使用课程提供的样例图片完成同样流程。
  • 项目目录建议:
ch14_signal_card_project/
├── signal_card_demo.py
├── samples/
│   ├── red_card.png
│   ├── yellow_card.png
│   ├── green_card.png
│   ├── no_card.png
│   └── dark_scene.png
├── logs/
│   └── run_log.md
├── evidence/
│   └── evidence_pack.md
└── README.md

本章所有文件只放在 ch14_signal_card_project/ 中,不访问其他目录。

知识准备:先认识这些词

  1. 物理 AI 小作品
    • 一句话说明:让 AI 通过摄像头、图片、声音或传感器接收现实信息,并给出低风险反馈的小型作品。
    • 本章例子:信号卡智能提醒器。
  2. 最小可运行作品
    • 一句话说明:功能不多,但能从输入到输出完整跑一遍的作品。
    • 关键点:先跑通,再改进;先低风险,再扩展。
  3. 信号卡
    • 一句话说明:用颜色表达状态的卡片。
    • 本章规则:绿色代表正常,黄色代表待确认,红色代表需要关注。
  4. 反馈
    • 一句话说明:系统把判断结果告诉人的方式。
    • 本章反馈:屏幕文字、颜色状态、运行日志。
  5. 日志
    • 一句话说明:记录程序每次运行结果的文件。
    • 价值:以后复盘时能知道当时输入是什么、系统判断是什么、人工是否同意。
  6. 作品证据包
    • 一句话说明:证明作品是怎样做出来、怎样测试过、哪里有边界的一组材料。
    • 包含内容:需求说明、提示词、运行截图或日志、测试表、失败案例、展示说明。
  7. 展示说明
    • 一句话说明:向展示对象说明作品目标、运行过程、测试结果和安全边界的短文稿。
    • 关键点:不要只说作品成功,也要说明什么时候会失败。

14.1 问题与现象:为什么最后要做一个能演示的小作品

14.1.1 只会说,不等于会做

学完前面章节,你已经知道很多 AI 概念:提示词、幻觉、RAG、视觉识别、工具调用、智能体、物理 AI。但如果这些知识都只停留在回答题目里,学习就还差最后一步。

学习 AI 不能只看概念,还要动手。动手不是为了炫技,而是为了让你知道:

  • 需求说不清,AI 会做偏;
  • 摄像头不可用,程序跑不起来;
  • 光线不对,识别会错;
  • 智能体生成的代码能运行,也不代表作品合格;
  • 没有记录,就无法证明自己真的测试过。

所以,最后一章必须做一个能演示的小作品。

14.1.2 为什么选择信号卡

信号卡有三个优点:

相关内容见表14-1。

表14-1 优点与说明记录表

优点 说明
低风险 只识别颜色,不识别人脸、身份、表情
易复核 红、黄、绿是否识别正确,一眼能看出来
可迁移 可迁移到设备状态提示、实训步骤提示、活动通行提示等场景

这个作品的目标不是替代管理者,也不是自动判断人的表现,而是演示一个低风险的物理 AI 闭环。

14.1.3 本章最终要交付什么

本章最后不是只交一个程序,而是交一个作品包:

相关内容见表14-2。

表14-2 材料与作用记录表

材料 作用
作品方案卡 说明作品要解决什么问题
智能体协同记录 记录你如何指挥 AI 完成任务
运行日志 证明程序实际运行过
测试表 说明红、黄、绿和失败情况都测试过
复核记录 说明你是否同意 AI 或程序判断
展示说明 用 3~5 分钟讲清作品

【思考 1】 为什么本章不能只提交程序能运行的截图?

思考提示:截图只能证明某一次运行成功,不能证明作品需求清楚、测试充分、安全边界明确,也不能说明失败时怎么办。


14.2 原理与分析:一个小作品怎样才算完整

相关结构如图14-1所示。

图14-1 AI 小作品七层结构:从需求到展示的完整证据链

14.2.1 物理 AI 小作品的六类证据

一个作品不是因为“程序跑了一次”就合格,而是要能拿出六类证据:

相关内容见表14-3。

表14-3 证据类型与作用记录表

证据类型 说明
功能证据 摄像头或样例图片能输入,程序能判断红、黄、绿并给出反馈
运行证据 日志能说明程序什么时候运行、输入是什么、输出是什么
测试证据 不只测成功样例,也测无卡片、暗光、摄像头不可用等情况
复核证据 人对程序输出进行判断,记录是否同意、哪里不可信
安全证据 说明不拍人脸、不上传图片、不控制危险设备
展示证据 能用简短语言讲清作品目标、方法、结果和边界

少了任何一类证据,作品都不完整。

14.2.2 人和智能体怎样分工

相关内容见表14-4。

表14-4 环节与智能体可以做记录表

环节 智能体可以做 你必须做
需求整理 把想法整理成方案 判断方案是否过大、是否安全
程序生成 创建代码、样例、日志模板 确认路径、权限和动作边界
运行测试 帮助执行程序、解释报错 观察实际结果,填写测试表
改进建议 提出修改办法 决定是否采纳,防止功能扩大
展示说明 帮助生成草稿 修改成自己的表达,说明真实结果

这就是人机协同。AI 可以加快开发,但不能替代你的判断。

14.2.3 作品不是越复杂越好

一个入门作品,最重要的是稳定、清楚、可解释。

不建议本章加入:

  • 人脸识别;
  • 情绪识别;
  • 自动评分;
  • 自动拍照保存他人画面;
  • 控制门锁、电机或电源;
  • 上传视频到网络平台。

如果你想扩展,可以先扩展低风险功能,例如:

  • 增加未识别提示;
  • 增加运行日志;
  • 增加样例图片模式;
  • 改进展示说明;
  • 记录一次失败案例。

14.2.4 失败案例为什么重要

作品展示时,很多人只想展示成功。但真实工程中,失败案例同样重要。

本章至少记录一种失败情况。失败记录不是扣分项,而是说明你知道作品边界:

相关内容见表14-5。

表14-5 失败情况与可能原因记录表

失败情况 可能原因 改进方向
红色识别成黄色 光线偏暗或背景干扰 换背景、调阈值
没有识别出卡片 卡片太远或太小 靠近摄像头
摄像头打不开 权限、占用或硬件问题 使用样例图片兜底
三种颜色同时出现 输入不符合规则 提示一次只举一张卡

一个会说明失败边界的作品,比只展示成功的作品更可信。


AI 协同实践:完成信号卡智能提醒器

第 1 步:让智能体确认作品目标

在 VS Code 插件中输入:

请帮我完成第14章信号卡智能提醒器作品。
注意:第13章已经完成颜色识别基础,本章重点是把作品整理成可演示、可测试、可复盘、可验收的作品包。

作品目标:
1. 使用第13章的摄像头识别基础;
2. 识别红、黄、绿三种信号卡;
3. 红色输出需要帮助,请暂停并关注;
4. 黄色输出需要人工确认;
5. 绿色输出状态正常,可以继续;
6. 摄像头不可用时使用 samples 中的样例图片;
7. 对无卡片和暗光情况给出提示;
8. 生成运行日志和作品证据包。

限制:
1. 不拍摄人脸;
2. 不上传图片;
3. 不控制外部设备;
4. 所有文件只放在 ch14_signal_card_project 文件夹中;
5. 程序不主动保存摄像头画面,只保存运行结果和人工复核记录。

请先不要创建文件。
请先列出项目文件结构、每个文件作用、运行命令和安全风险,等待我确认。

第 2 步:检查智能体给出的方案

智能体的方案至少应包含:

相关内容见表14-6。

表14-6 文件或目录与作用记录表

文件或目录 作用
signal_card_demo.py 主程序
samples/ 摄像头不可用时的样例图片
logs/run_log.md 运行日志
evidence/evidence_pack.md 作品证据包
README.md 运行方法和安全说明

如果智能体没有说明安全风险、没有说明样例图片兜底,或者准备把文件放到其他目录,请要求它修改方案。

第 3 步:生成并运行最小作品

确认后输入:

我确认项目结构。
请创建信号卡智能提醒器的最小版本。
要求:
1. 优先使用摄像头;
2. 摄像头不可用时自动提示使用样例图片;
3. 识别红、黄、绿三种信号卡;
4. 输出对应文字反馈;
5. 每次运行写入 logs/run_log.md;
6. 对无卡片和暗光情况给出提示;
7. 自动生成 evidence/evidence_pack.md 模板;
8. 运行后告诉我如何测试。

第 4 步:完成三色测试

按下面表格测试:

相关内容见表14-7。

表14-7 测试项与预期结果记录表

测试项 预期结果 实际结果 是否通过
绿色卡 状态正常,可以继续
黄色卡 需要人工确认
红色卡 需要帮助,请暂停并关注
无卡片 未识别或请重新拍摄
暗光环境 请调整光线

如果摄像头不可用,请使用样例图片完成同样测试。

第 5 步:让智能体帮助生成作品证据包

测试完成后输入:

请根据本次运行结果,帮我整理 evidence/evidence_pack.md。

要求包含:
1. 作品名称;
2. 作品目标;
3. 感知、判断、反馈、复核四个环节;
4. 测试结果表;
5. 至少一个失败案例;
6. 安全边界;
7. 还可以改进的地方。

请用读者能读懂的语言,不要夸大作品能力。

第 6 步:准备 3 分钟展示说明

让智能体生成展示草稿:

请帮我写一份 3 分钟作品展示说明。
要求:
1. 先说明作品解决什么问题;
2. 再说明作品怎样运行;
3. 说明 AI 智能体帮了哪些忙;
4. 说明我自己做了哪些确认和复核;
5. 说明作品不能做什么;
6. 语言自然,适合作品展示。

注意:展示稿必须由你修改。不能原样照读 AI 生成的内容。


验证与证据:作品证据是否合格

作品证据包清单

相关内容见表14-8。

表14-8 证据与是否完成记录表

证据 是否完成
作品方案卡
智能体提示词记录
文件结构截图或清单
运行日志
三色与异常测试表
失败案例记录
人工复核记录
展示说明

作品验收标准

相关内容见表14-9。

表14-9 标准与合格表现记录表

标准 合格表现
能运行 摄像头或样例图片模式至少一种能跑通
有反馈 红、黄、绿能输出不同提示
有记录 日志和测试表完整
有复核 你能说明哪些结果可信,哪些要人工确认
有边界 明确不拍人脸、不上传图片、不控制危险设备

自测题

  1. 这个作品中的感知环节是什么?
  2. 为什么摄像头不可用时还要设计样例图片兜底?
  3. 如果红色卡识别错误,可能有哪些原因?
  4. 为什么展示时要说明作品不能做什么?

伦理、安全与边界

不把摄像头对准他人

本作品只识别信号卡,不识别人。摄像头画面中如果出现他人、证件、聊天窗口、成绩单等隐私内容,应立即停止。

不上传未经允许的图片

本章默认不上传摄像头画面。即使以后使用云端视觉模型,也必须先确认图片不含隐私,并获得授权。

不做危险动作

本章只做屏幕文字反馈。可以选做低风险灯光或声音提示,但不能控制门锁、电源、车辆、电机或机械臂。

不夸大作品能力

课程原型不是成熟产品。展示时不能说它能准确判断所有现实情况,只能说它能在当前测试样例中识别三种颜色卡,并在异常情况下提示人工确认。


总结与思考

本章核心判断

  1. 最小物理 AI 小作品不追求复杂,而追求闭环完整。
  2. 本章作品包含感知、判断、反馈、日志、复核和展示。
  3. 智能体能帮助开发,但你必须确认路径、运行结果和安全边界。
  4. 失败案例不是扣分项,而是作品可信度的一部分。
  5. 作品展示要说明能力,也要说明限制。

基础题

  1. 信号卡智能提醒器为什么属于物理 AI 小作品?
  2. 这个作品中,AI 智能体主要帮你做了哪些事情?
  3. 为什么不能把程序能运行等同于作品合格?

迁移题

请把信号卡作品迁移到一个专业场景中,例如汽修实训、餐饮后厨、护理耗材整理、电商仓库分拣。写出红、黄、绿分别代表什么。

风险题

如果有人建议把信号卡作品改成识别学习者是否专注,你会如何回应?请从隐私、误判、责任和使用边界四个角度回答。

本章交付物

完成本章后,你应提交以下材料:

  1. 作品方案卡 1 份;
  2. 智能体提示词记录 1 份;
  3. 运行日志 1 份;
  4. 三色与异常测试表 1 份;
  5. 失败案例记录 1 条;
  6. 人工复核记录 1 份;
  7. 3 分钟展示说明 1 份。
当前中职版(2026-07-20)修订稿

第14章 我和 AI 一起做小作品:信号卡智能提醒器

(建议4课时)

章首语

学期将尽,实训室的窗台上多了一排纸卡:绿色的写着”进度正常”,黄色的写着”需要帮助”,红色的写着”设备异常”。这是各小组的信号卡——举起一张,向老师报告一种状态。只是老师一个人,六个小组,常常顾此失彼。

班会上有人提议:让我们的班级 AI 助手来当这个”值班员”,行不行?摄像头认出举起的卡,判断是什么信号,播报相应的提醒,再记进值班日志——话音未落,同学们已经在掰着指头数了:看图,学过;判断与循环,学过;立规矩、定标准,也学过。

零件齐了,图纸有了,规矩懂了。这一章,我们把它们集成为一件可演示、可测试、可说明边界的课程原型。不积跬步,无以至千里——十三章的跬步,在此处会合。

结课作品不是“把几个功能接起来能运行一次”,而是一次小型系统集成。小组要说明部件怎样连接、数据怎样流动、失败时怎样降级、版本怎样恢复,并用代表性样例完成验收。作品仍是教学原型,不把课堂结果夸大为可直接部署的产品。

字里行光 不积跬步,无以至千里;不积小流,无以成江海。——《荀子·劝学》

学习目标

  1. 能说明信号卡智能提醒器的功能构成与各章知识的对应关系;
  2. 能与小组协作完成搭建、试运行与验收全过程;
  3. 能用自然语言指令让 AI 生成作品展示页,并完成验证与修改;
  4. 能为作品撰写说明卡,写清它能做什么与不能做什么;
  5. 在展示与互评中完成”会用—会核—会管”的自我盘点。

14.1 作品构思与分工

它是什么。信号卡智能提醒器:摄像头识别小组举起的信号卡,判断其含义,播报相应提醒,并记入值班日志的桌面小系统。一句话——让 AI 替老师”看见”每一次举卡。

它由哪些学过的零件构成。动手之前,先把图纸看明白:

功能环节 用到的本领 出处
认出信号卡 图像识别及其误差意识 第9、13章
判断与播报的连续运行 “判断—执行—观察”循环 第11章
播报词与判断规则的编写 指令四要素 第6章
各信号的处置说明 知识库 第8章
播报与记录的动作 工具调用与沙盒 第10章
步数上限、暂停点、日志 三条运行规则 第11章
试运行的合格尺子 验收标准 第12章
拍摄范围与知情同意 物理边界 第13章

怎样分工。以小组为单位,设四个角色:搭建员负责环境与配置,规则员负责指令、规矩与边界,测试员负责试运行与验收记分,讲解员负责说明卡与展示。角色各有侧重,四人全程共商——岗位上真实的协作,正是如此。

【想一想】① 对照上表自查:哪一章的本领你最有把握?哪一章需要回头翻一翻?把后者写进小组的准备清单。

先确定系统架构和验收边界

构思时要画出四层结构:输入层由摄像头或样例图提供信号,判断层识别卡片并处理连续状态,工具层完成播报与日志,展示层读取经过整理的结果。每层都写明输入、输出和失败方式。这样能够避免“识别错了”时不知道问题来自画面、模型、规则还是工具。

小组还要列出不在本项目范围内的功能:不识别人脸,不判断学生表现,不自动上报真实系统,不控制门锁和电源,不保存原始视频。范围写清后,分工才有依据。搭建员负责环境和连接,规则员负责状态与边界,测试员负责样例和记录,讲解员负责证据整理;关键决定由全组共同确认。

【图14-1 信号卡提醒器四层架构:输入—判断—工具—展示(SVG图位)】

验收标准应在搭建前确定。除识别结果,还要检查时延、未确定处理、暂停点、日志完整性和镜头范围。课堂测试用于判断本版本是否达到约定目标,不能据此宣称适合真实生产环境。若样例或环境改变,应重新验收。

14.2 搭建:从图纸到实物

打开本章实训页(labs/ch14),向导将按五步引导搭建。此处写明每一步的要领与检查点。

第1步 备场。完成环境三步验证;连接摄像头;在拍摄区张贴明示标识——第13章的规矩,从第一分钟起就生效。

第2步 制卡。制作三张信号卡:底色分明,图案简洁,字样醒目。制卡即是在为”眼睛”减负:卡与卡的差别越鲜明,误报越少。

第3步 立规。在实训页配置三样东西:其一,判断规则与播报词——用四要素写清,播报措辞遵守第13章的分寸(不指名、不定性、留余地);其二,各信号的处置说明入知识库(如”红色·设备异常:立即停用设备,等待教师处理”);其三,三条运行规则——循环上限、日志开启,并把”红色信号的上报动作”设为暂停点:设备异常须经教师确认后才记入正式报告。

第4步 试运行。按测试表运行三种卡、无卡、两卡并举、弱光、侧角度、摄像头断开和服务不可用等样例。测试员逐条比较预期、日志与实况,分别统计识别错误、未确定和流程中断。

第5步 验收。依第12章预先确定的样例和指标,分别检查识别、时延、未确定处理、暂停点、日志和镜头范围。不达标时只修改一项主要因素,保存新版本并重新运行全部固定样例,确认原来通过的功能没有退步。

【做一做】 试运行开始前,小组互查一项:三条运行规则是否全部生效?请规则员当众演示”红色信号暂停点”被触发的过程。

【想一想】② 如果为了”识别更灵敏”而取消红色信号的暂停点,可能发生什么?值得吗?

集成测试要从部件走到整机

搭建按“部件测试—连接测试—整机测试”进行。先验证摄像头、样例模式、识别、播报和日志各自可用;再逐段连接,确认识别结果能正确触发对应播报和记录;最后运行完整场景。若一开始就整机运行,故障出现时很难定位。

测试集覆盖三种卡片、无卡片、两卡同时出现、弱光、侧角度、摄像头断开和模型服务不可用。每条样例写明预期:正常识别、显示未确定、暂停等待或转入样例模式。系统不得在输入不清时强行选择一种颜色,也不得把服务故障说成“作品运行正常”。

【图14-2 集成测试阶梯:部件—连接—整机—异常—回归(SVG图位)】

修改卡片、接受界线、播报规则或知识库后,应重新运行固定测试。新版若解决一个问题却引入更多退步,应恢复上一版,再分析原因。作品文件、配置、测试记录和说明卡使用同一版本号,避免展示页介绍的是新版、现场运行的却是旧版。

四课时实施建议与工程证据

第1课时完成需求、架构、范围和分工评审;第2课时完成部件测试与连接测试;第3课时运行正常和异常测试、修订后做回归;第4课时生成安全展示页、完成异机检查、展示与互评。每课时都要产生一份阶段记录,下一课时从上次版本和未解决问题继续。

测试结果不得只写“15轮错误不超过2轮”这类脱离条件的门槛。应按样例类型分别报告结果,并说明目标来自本组任务约定。至少保留一次失败、一次修订和一次回归比较。最终把原型文件、架构图、测试表、说明卡、展示页和版本记录装入同一个《作品证据包》。

14.3 AI 辅助创作:做一个作品展示页

作品做成后,还要让别人看得懂。本章实训页提供固定的离线展示模板。我们用自然语言请模型帮助起草作品名称、功能说明、测试摘要和边界说明,再由小组逐项核验,把确认后的内容填入模板。模型不直接生成或执行任意网页程序。

展示页至少包含六项内容:作品目标与成员分工、四层架构图、三种信号含义、测试结果与失败案例、三条运行规则、已知局限与人工智能生成合成内容标识。照片只使用作品和道具,不出现未经授权的人员画面;测试数据只展示汇总,不公开原始日志中的敏感字段。

模板提供“内容检查、离线检查、安全检查”三个按钮。内容检查发现缺项时返回修改;离线检查确认页面不依赖公网;安全检查列出外部链接、脚本和个人信息风险。三项都通过后,导出只读展示包,并与作品版本号保持一致。

【旁注】(楷体) 自然语言可以帮助我们更快形成页面草稿,但页面结构、事实内容和安全边界仍由人决定。把可自动生成的部分与必须人工确认的部分分开,作品才便于检查和维护。

【想一想】③ 为什么本章不让模型直接生成并运行任意网页程序,而采用固定模板填充内容?这样会少一些什么,又会多得到什么?

展示页本身也要通过安全检查

固定模板把内容和程序分开:模型只帮助生成文字草稿和配色建议,系统把审核后的文字填入预设位置。成员、图片和测试数据都由小组选择;外部链接默认禁用。这样既保留自然语言辅助创作,又不把任意程序执行权交给模型。

展示页检查分为内容、功能和安全三组。内容检查事实、成员、版本和边界;功能检查导航、图片、表格和离线打开;安全检查是否含外网请求、未知脚本、个人信息和未授权素材。三组都通过,才能作为作品证据包的一部分。

【图14-3 安全展示页生成链:内容草稿—人工核验—固定模板填充—离线检查—导出(SVG图位)】

展示页不是作品运行界面,也不应直接控制摄像头和工具。它只读取已经整理的测试摘要和经过授权的图片。真实日志如果含设备路径或个人信息,应先删除或替换后再展示。页面底部标明“课程原型、测试条件、已知局限和人工智能辅助生成说明”。

14.4 展示与互评

展示会。每组八分钟:讲解员介绍作品与规矩(两分钟);现场演示三种信号各一次,含一次暂停点触发(四分钟);投影展示页并答问(两分钟)。

互评。观摩组按三问记分,每问附一句依据:作品完成度如何——识别可靠吗,播报得体吗?规矩立得如何——三条规则齐吗,边界守住了吗?表达清楚吗——展示页与讲解,让外行看懂了吗?

自我盘点。展示结束后,独立完成一份百字小结,围绕三句话作答:这学期,我用 AI 做成了什么(会用);我识破过它的哪些差错(会核);我为它立过哪些规矩(会管)。这份小结,与作品一同构成你本学期的答卷。


展示要能回答工程问题

讲解顺序按照“需求—架构—测试—结果—边界—改进”。现场演示只使用预先核验的道具与场地,不临时扩大拍摄范围。若识别失败,按故障流程切换样例模式,并把失败如实作为演示内容;一次失败不会使作品失去价值,掩盖失败才会破坏证据。

互评要引用作品证据。评价“识别较稳定”时,应指出哪些测试记录支持;评价“安全边界清楚”时,应指出暂停点、无存储设置或说明卡位置。不能只写“很好”“很智能”。被评价组把意见分为立即修正、后续计划和不采纳三类,并说明决定理由。

作品结束后进行交付检查:文件能在另一台符合条件的计算机离线打开,模型或样例模式标识清楚,版本一致,测试记录可读,个人信息已经清理,上一稳定版本能够恢复。完成这些检查,才算把课堂作品交给了下一个使用者。

工程案例:一次集成故障的完整复盘

某小组部件测试均通过,整机演示时却出现“绿色卡被正确识别,播报内容却是黄色提示”。日志显示识别层输出正确,工具层收到的颜色字段也正确,问题最终定位到知识库中两条处置说明的编号互换。若只反复调整摄像头,故障不会消失;分层架构和日志帮助小组找到真正原因。

修正知识库后,小组没有只重测绿色卡,而是运行全部固定样例。回归中发现红色暂停点失效,于是恢复上一稳定版本,比较两次配置差异,再重新合并修改。最终证据包保留了故障现象、定位过程、修改内容、回归结果和恢复记录。失败案例因此成为作品可信度的一部分。

展示时,讲解员不说“作品能够管理实训室”,而说“这是在给定道具、光线和课程环境中测试的辅助提醒原型”。一句条件说明划清了课堂证据与真实产品之间的距离。观摩组根据架构图和测试表提问,评价也必须指出具体证据。

安全与责任

本章红线 作品交到他人手中之前,把它能做什么、不能做什么,白纸黑字写清楚。

《作品说明卡》上的”不能”,与”能”同样珍贵:它可能认错卡,弱光下会漏报,红色信号须经教师确认。写下局限不是示弱,而是负责——用的人知道边界,才不会被边界所伤。将来无论交付一件产品、一个方案还是一次维修,这张说明卡的精神都请随身携带:如实相告,是手艺人最后的工序。

本章小结

这一章没有新知识,只有一次会合。摄像头是它的眼,循环是它的步,指令是它的言语,规矩是它的分寸,验收是它的成人礼——十三章的跬步,走成了窗台上一台真正有人使用的小机器。我们还初尝了用白话造网页的新方式,也再次确认了那条不变的纪律:生成之后,必须验证。回望开学第一周,AI 还只是屏幕里一个能说会道的陌生对话框;如今,你会用它成事,会核它的差错,会为它立规执尺。千里之行始于足下——这本书到此收束,而你与智能机器同行的路,才刚刚启程。

习题

基础题

  1. 对照14.1的对应表,任选四个功能环节,说明各自用到了哪一章的本领。
  2. 本作品的暂停点设在何处?为什么设在那里?
  3. 展示页生成后为什么必须逐项验证?可能出现哪类问题?

应用题

  1. 为你的作品写一份《作品说明卡》草稿:三条”能”,三条”不能”。
  2. 观摩他组作品后,用互评三问写一份五十字左右的评语,每问附一句依据。

拓展题(选做)

  1. 为信号卡提醒器设想一项”下学期升级”:新增什么功能?需要补什么规矩?用一段话写出你的方案。

本章交付物

交付物 要求
《作品证据包》 含课程原型、架构图、测试与回归记录、安全展示页、《作品说明卡》和版本记录,文件可离线复核
自评勾选单 逐条自查勾选,组内成员分别签名

《作品说明卡》

项目 内容
作品名称、版本与小组成员
它能做什么(三条)
它不能做什么(三条)
运行规则与人工暂停点
测试条件与失败案例
使用前的注意事项

自评勾选单

《作品证据包》目录与复核顺序

证据包按固定顺序整理:01需求与范围,02系统架构与分工,03作品文件及版本,04正常和异常测试,05失败—修改—回归记录,06作品说明卡,07安全展示页,08自评与互评。每个文件使用统一的作品编号和版本号,目录页注明运行所需环境与样例模式。

交付前进行异机复核。另一组在未参与搭建的计算机上,依据说明打开展示页和课程原型,运行一条正常样例与一条故障样例。原小组不能代替操作,只能观察说明是否足够。若对方无法判断运行模式、找不到材料或版本不一致,证据包退回修改。

最后检查四项边界:没有未经授权的人像和素材,没有真实账号或业务数据,没有外网依赖与未知脚本,没有把课堂原型表述成已可部署产品。组内成员分别在自评单签名,表示自己能够说明作品中至少一个技术环节、一个失败案例和一项安全边界。

证据包质量自检

质量自检采用“能打开、能复现、能解释、能停下”四问。能打开,是文件完整且离线可用;能复现,是另一组按说明运行固定样例;能解释,是架构、测试和版本相互对应;能停下,是异常、暂停和回退路径真实有效。四问任一未通过,证据包退回修改。

自检问题 证据文件 复核结果
能打开 环境说明、展示页
能复现 固定样例、测试记录
能解释 架构图、日志、说明卡
能停下 异常测试、暂停与回退

小组在目录页注明测试日期、课堂环境和已知局限。若更换模型、规则或页面,版本号随之更新并重做固定测试。证据包不是静态纪念册,而是一份能够说明作品在什么条件下如何运行的交付记录。

展示结束后保留互评原文和处理决定。没有采纳的意见也要说明理由,防止为了得到“全通过”而删除不同看法。

岗位迁移:为自己的专业改写作品需求

保持输入、判断、工具、展示四层架构不变,只改低风险任务。电商方向可把三色卡解释为备货正常、需要补货、等待人工;数媒方向可解释为拍摄就绪、需要协助、设备异常;汽修、护理或物流方向可用于教学工位状态、训练物品准备或货位演示。红色状态只触发暂停和提示,不直接作业务决定。

改写需求后,重新列出不在范围内的功能。不得加入人脸识别、情绪判断、真实评分、自动上报、设备控制和原始视频保存。若专业场景需要这些能力,说明它们超出本课程原型,不能通过一句新指令加入。范围变化还要反映到架构图、测试集、说明卡和展示页。

每个方向至少准备正常、无卡、两卡、弱光、输入中断和暂停取消样例。验收结论分别说明识别、时延、未确定、日志和边界,不用一个总分代替。修改处置说明后运行全部固定样例,确认其他颜色与暂停点没有退步。

专业改写作为证据包的“迁移说明”保存。它说明哪些结构可复用、哪些规则随岗位改变、哪些功能需要更高层级审批与技术条件。能把作品迁移而不扩大风险,才真正体现“会用、会核、会管”。

贯穿项目:班级 AI 助手 v1.0

本章项目阶段是“集成交付”。汇总前十三章的环境、材料、规则、工具、测试和版本记录,完成可复核、可回退的结课作品。这一版不是另起一个无关作业,而是在上一版项目档案上增加一项可验证能力;新增、保留和取消的内容都要写入版本记录。

同时把本章最值得保留的一次失败写入《失败样例册》。记录项目版本、输入条件、预期与实际、错误起点、修改动作和回归结果;暂时无法定位时写“证据不足”,不得为了完整而虚构原因。

从作品证据包到职业作品集

作品交付还需要一份自述文件(README)。它应说明作品解决什么问题、怎样启动、需要什么环境、怎样运行固定样例、当前版本通过了哪些测试、有哪些已知局限,以及哪些内容使用了人工智能辅助。另一组只看这份说明也能完成基本复核,才说明交付文字真正有效。

公开可见不等于允许任意复制。分享代码、图片、数据或模型前,要确认自己拥有相应权利,并按学校和平台要求选择许可方式;来源不明的素材不进入发布包。有条件的小组可在校内版本平台使用“问题单—修改分支—同伴复核—合并记录”的协作流程,没有平台时也可用编号问题单和修改记录完成同样的责任链。

《作品证据包》同时可以成为职业作品集。展示时不只放成功画面,还要保留一个失败样例、一次修复、一次回归和一项明确边界,让别人看见你怎样解决问题。为作品写一份九十天计划:第一个月让他人复现,第二个月修正最重要的失败,第三个月完成一次合规发布或校内展示。

走完整条项目线,需要四种机器不能替你承担的能力:提问力帮助定义真正的问题,审美力帮助判断作品是否清楚得体,共情力帮助理解使用者的处境,判断力帮助在证据、风险和责任之间作出决定。技术可以扩展行动范围,这四种能力决定行动为了谁、做到什么程度、由谁负责。