项目名称PenPal Guardian (智能文具收纳盒)一、 实际应用场景描述场景设定为一个带有重量感应和RFID识别功能的智能文具收纳盒。在这个场景中收纳盒被放置在办公桌的固定位置。盒子里预先放置了“必备三件套”一支签字笔、一支铅笔、一把尺子。系统通过底部的压力传感器阵列或称重传感器 HX711感知物体重量并通过顶部的 RFID 读卡器确认物品ID。当系统检测到“常用笔”如签字笔被拿走且超过 5 分钟未归位时就会判定为“物品丢失其实是放错地方了”并触发提醒。二、 引入痛点在快节奏的工作或学习环境中存在以下文具管理痛点1. 习惯性遗忘拿笔去签个字顺手放在隔壁工位或口袋里导致回到座位后误以为笔丢了。2. 视觉盲区收纳盒里东西多看似有笔实则被大件物品遮挡拿取时才发现是空的。3. 被动寻找只有真正要用笔写东西时才发现笔不见了打断工作流Flow。4. 非智能化传统收纳盒只是容器不具备状态感知和主动提醒能力。三、 核心逻辑讲解本系统的核心逻辑基于状态变化检测 (State Change Detection) 与超时定时器 (Timeout Timer) 的结合1. 基线校准 (Baseline Calibration)系统启动时读取收纳盒内所有物品的初始状态重量 ID建立“基准线”。2. 事件触发 (Event Trigger)当检测到“常用笔”的重量消失或 RFID 信号丢失时记录事件发生的时间戳。3. 双阶段判断 (Two-stage Check)* 阶段一瞬时笔是否在盒内是/否* 阶段二延时笔离开盒子的时间是否超过了GRACE_PERIOD宽限期如 5 分钟4. 动作执行仅当阶段二为真时才输出“寻找放回”提示避免在临时拿笔写字时误报。四、 代码模块化实现我们将代码分为三个模块config.py (物品与阈值配置)、sensors.py (传感器模拟)、main.py (主逻辑与状态机)。1. 配置文件config.py配置文件定义物品属性与系统阈值# 文具定义字典# id: 唯一标识符, name: 名称, weight_g: 重量(克), is_essential: 是否为必需品STATIONERY_DB {pen_001: {name: 黑色签字笔, weight_g: 12, is_essential: True},pencil_001: {name: HB铅笔, weight_g: 8, is_essential: False},ruler_001: {name: 20cm直尺, weight_g: 25, is_essential: False}}# 系统参数CHECK_INTERVAL_SECONDS 2 # 检测间隔 (秒)GRACE_PERIOD_SECONDS 10 # 宽限期 (秒)演示用设为10秒实际可设为300秒(5分钟)# 模拟重量误差 (克)模拟传感器噪声WEIGHT_NOISE_G 0.52. 传感器模拟模块sensors.py智能仪器课程相关传感器数据采集与模拟模拟重量传感器(HX711)和RFID读取器import randomclass VirtualStationerySensor:虚拟文具传感器类模拟智能收纳盒的感知能力def __init__(self, initial_itemsNone):# 初始状态下收纳盒里有哪几样东西self.current_items initial_items if initial_items else list(STATIONERY_DB.keys())self._base_weights {item_id: STATIONERY_DB[item_id][weight_g] for item_id in self.current_items}def scan_items(self):扫描当前盒内物品ID# 模拟RFID扫描返回当前存在的物品ID列表return list(self.current_items)def get_total_weight(self):获取总重量加入噪声模拟真实传感器total_weight sum(self._base_weights.values())noise random.uniform(-WEIGHT_NOISE_G, WEIGHT_NOISE_G)return round(total_weight noise, 2)def remove_item(self, item_id):模拟拿走物品的动作if item_id in self.current_items:self.current_items.remove(item_id)print(f[模拟动作] 拿走了: {STATIONERY_DB[item_id][name]})def add_item(self, item_id):模拟放回物品的动作if item_id not in self.current_items:self.current_items.append(item_id)print(f[模拟动作] 放回了: {STATIONERY_DB[item_id][name]})3. 主程序逻辑main.py智能文具收纳盒 - 物品缺失检测系统核心逻辑基于状态机的物品追踪import timeimport datetimefrom config import STATIONERY_DB, CHECK_INTERVAL_SECONDS, GRACE_PERIOD_SECONDSfrom sensors import VirtualStationerySensorclass PenPalMonitor:def __init__(self):self.sensor VirtualStationerySensor()self.essential_items_present {} # 记录必需品是否存在 {id: bool}self.missing_timestamp None # 记录缺失开始的时间戳self.alert_active False# 初始化必需品状态for item_id, data in STATIONERY_DB.items():if data[is_essential]:self.essential_items_present[item_id] Trueprint( 智能文具收纳盒初始化完成)self._print_current_state()def _check_essentials(self):核心检测函数检查所有必需品是否都在返回 True 如果一切正常False 如果有必需品缺失current_items_ids self.sensor.scan_items()all_present Truefor item_id, is_present in self.essential_items_present.items():# 检查该必需品ID是否在当前扫描到的列表中actual_presence item_id in current_items_idsself.essential_items_present[item_id] actual_presenceif not actual_presence:all_present Falseprint(f [检测] ❌ 缺失: {STATIONERY_DB[item_id][name]})return all_presentdef _print_current_state(self):打印当前收纳盒内状态items [STATIONERY_DB[i][name] for i in self.sensor.current_items]print(f[{datetime.datetime.now().strftime(%H:%M:%S)}] 盒内物品: {, .join(items)})def run(self):主运行循环print(\n️ 开始监控文具状态... (CtrlC 退出))try:while True:self._print_current_state()essentials_ok self._check_essentials()if not essentials_ok:# 如果有必需品缺失if self.missing_timestamp is None:# 记录第一次发现缺失的时间self.missing_timestamp time.time()print(f [计时] 开始计时宽限期 {GRACE_PERIOD_SECONDS} 秒...)elapsed_time time.time() - self.missing_timestampif elapsed_time GRACE_PERIOD_SECONDS and not self.alert_active:# 超过宽限期触发警报print(\n # * 50)print(# ⚠️ 提 示常用笔未归位请寻找并放回 ⚠️ #)print(# * 50)self.alert_active True # 防止重复报警else:# 如果必需品都齐了if self.missing_timestamp is not None:print(\n✅ 常用笔已归位警报解除。)self.missing_timestamp Noneself.alert_active Falsetime.sleep(CHECK_INTERVAL_SECONDS)except KeyboardInterrupt:print(\n程序已手动停止。)if __name__ __main__:monitor PenPalMonitor()# --- 演示逻辑 ---# 为了让演示更生动我们在后台线程模拟用户拿笔和放笔的动作import threadingdef demo_sequence():time.sleep(5) # 等待主循环开始monitor.sensor.remove_item(pen_001) # 拿走笔time.sleep(GRACE_PERIOD_SECONDS 3) # 超过宽限期monitor.sensor.add_item(pen_001) # 放回笔demo_thread threading.Thread(targetdemo_sequence, daemonTrue)demo_thread.start()monitor.run()五、 README 文件# PenPal Guardian - 智能文具收纳盒## 项目简介这是一个基于 Python 的智能文具状态监测模拟项目。针对办公桌上常用笔易丢失、难寻找的问题通过模拟多传感器融合重量RFID技术实现对“必需品”的状态追踪与超时提醒。## 核心功能* **物品识别**: 模拟 RFID 扫描区分不同文具。* **必需品标记**: 可配置哪些物品是“常用必需品”。* **智能延迟提醒**: 不是一拿走就报警而是给予宽限期Grace Period避免干扰正常书写流程。* **状态机管理**: 清晰区分“正常”、“暂离”、“报警”三种状态。## 环境依赖* Python 3.8## 使用说明1. 确保 config.py, sensors.py, main.py 在同一目录。2. 运行主程序bashpython main.py3. 程序启动后会自动进入监控状态。4. 观察控制台输出系统会模拟“拿走笔” - “等待超时” - “触发警报” - “放回笔” - “警报解除”的全过程。## 扩展建议* 接入真实的 HX711 称重模块和 RC522 RFID 模块。* 增加摄像头模块使用 OpenCV 进行物品形状识别作为冗余校验。* 增加语音合成 (TTS) 功能当警报触发时播放语音提示。六、 核心知识点卡片 (Key Takeaways)类别 知识点 说明智能仪器 多传感器融合 结合重量物理量和 RFID标识量进行更可靠的判断。嵌入式逻辑 状态机 (State Machine) 管理Normal -Missing -Alert 的状态流转。算法设计 宽限期 (Grace Period) 工程实践中常用的防抖策略忽略短暂的瞬态变化。并发处理 Threading (线程) 使用后台线程模拟外部事件不影响主监控循环。数据结构 字典 (Dictionary) 使用 Dict 存储物品属性和状态实现 O(1) 查找效率。七、 总结在这个“智能文具收纳盒”项目中我们跳出了单纯的“数值超标报警”如鱼缸水质进阶到了“状态存在性检测”。1. 工程思维的体现最关键的设计在于GRACE_PERIOD宽限期。如果没有这个设计每次拿起笔都会报警这会让用户抓狂。这体现了用户体验 (UX) 在 IoT 开发中的重要性。2. 从模拟到现实代码中sensors.py 的设计非常贴近真实硬件。例如scan_items 对应 RFID 读卡器的防冲突读取get_total_weight 对应 HX711 的模数转换与滤波。3. 模块化优势当你想把“笔”换成“眼镜”或者“遥控器”时只需要修改config.py 中的STATIONERY_DB无需改动核心逻辑。希望这个项目能启发你身边的万物皆可“智能化”而 Python 就是你实现创意的最佳工具。利用AI解决实际问题如果你觉得这个工具好用欢迎关注长安牧笛