co2-tank-monitor

name	co2-tank-monitor
description	物联网监控模拟系统用于预测二氧化碳气罐的消耗情况，从而避免细胞培养设施在周末出现气体供应中断的情况。该系统能够实时监测气瓶的压力，计算气体消耗速率，并在需要及时更换气瓶时发出预警。
allowed-tools	["Read","Write","Bash","Edit"]
license	MIT
metadata	{"skill-author":"AIPOCH"}

二氧化碳气瓶监控系统

该系统用于监控二氧化碳气瓶的压力，并预测气瓶的耗尽时间，以防止细胞培养箱中的气体供应中断，尤其是在实验室无人值守的周末期间。系统提供自动警报和消耗量跟踪功能，以帮助实验室人员更有效地管理气瓶。

主要功能：

• 基于压力的耗尽预测：根据当前压力和消耗速率计算气瓶的剩余使用时间
• 周末风险检测：识别在周末无人员值守时是否会发生气体耗尽
• 支持多种气瓶规格：兼容10升和40升两种常见规格的气瓶
• 自动警报系统：生成包含建议的警报报告
• 模拟模式：使用随机数据测试监控场景，以便培训员工

---

使用场景

✅ 适用场景：

• 监控需要持续供气的细胞培养箱
• 设置自动每日检查（例如，通过cron作业）
• 规划气瓶更换计划，以避免服务中断
• 培训新员工了解气体监控流程（使用模拟模式）
• 管理具有不同消耗速率的多个培养箱
• 在假期前进行评估，确保假期期间有足够的气体供应
• 制定气体监控的标准操作程序（SOP）

❌ 不适用场景：

• 监控用于低温储存的液氮气瓶（请使用freezer-sample-locator或专用液氮监控系统）
• 监控用于非二氧化碳应用的压缩空气或氮气气瓶（请调整参数并确认兼容性）
• 需要实时物联网（IoT）传感器集成（请使用实际的传感器API）
• 气瓶使用基于重量的测量方式（请相应地调整计算逻辑）
• 需要紧急气体泄漏检测（请使用带有警报的气体检测系统）
• 管理具有自动切换功能的大型气瓶储存系统（这些系统已内置监控功能）

相关技能：

• 上游技能：equipment-maintenance-log、lab-inventory-tracker
• 下游技能：eln-template-creator、lab-budget-forecaster

---

与其他技能的集成

上游技能：

• equipment-maintenance-log：记录影响消耗速率的二氧化碳培养箱维护历史
• lab-inventory-tracker：监控气瓶库存和更换计划
• equipment-maintenance-log：记录压力表的校准日期

下游技能：

• eln-template-creator：生成包含气体监控检查表的实验模板
• lab-budget-forecaster：根据消耗趋势预测二氧化碳气体成本
• waste-disposal-guide：协调空气瓶的处置和更换

---

核心功能

1. 基于压力的耗尽预测

根据当前压力读数和历史消耗模式计算气瓶的剩余使用寿命。

---

参数：

参数	类型	是否必需	描述	默认值
pressure	float	是	当前气瓶压力（单位：MPa）	8.0
daily_consumption	float	是	平均每日消耗速率（MPa/天）	1.5
capacity	int	否	气瓶容量（升）	40

计算方法：

---

最佳实践：

• ✅ 根据历史数据校准消耗速率（监测1-2周）
• ✅ 考虑使用量的变化（实验高峰期消耗量较高，周末较低）
• ✅ 在固定时间（例如每天上午9点）读取压力值，以获得准确的趋势
• ✅ 根据季节变化调整消耗速率（培养箱的使用量可能有所不同）

常见问题及解决方法：

**问题：消耗量估计不准确

• 症状：预测的耗尽日期总是偏差几天
• 解决方法：监测2-4周的实际消耗量；调整daily_consumption参数

**问题：压力波动导致误报

• 症状：由于温度变化导致压力读数不稳定
• 解决方法：每天在相同时间读取压力值；让气瓶在使用后达到稳定状态

2. 周末耗尽风险检测

识别在周末实验室无人员值守时是否会发生气瓶耗尽。

---

周末风险场景：

场景	风险等级	需要采取的措施
周六/周日耗尽	🔴 高风险	立即更换气瓶或安排周末值班人员
周一早上耗尽	🟡 中等风险	在周五下午更换气瓶
周五晚上耗尽	🟡 中等风险	密切监控；如可能则更换气瓶
周中耗尽	🟢 低风险	安排常规更换计划

最佳实践：

• ✅ 为标准工作周设置alert_days为2天（例如，周三发出警报，周五更换气瓶）
• ✅ 为剩余时间少于4天的气瓶安排周五更换
• ✅ 为高风险实验安排周末值班人员
• ✅ 考虑节假日安排，确保假期期间有足够的气体供应
• ✅ 制定气体监控的标准操作程序（SOP）

---

多种气瓶规格支持

支持实验室中常用的不同规格的二氧化碳气瓶。

---

气瓶规格：

容量	通常用途	最大压力	使用时间（@1.5 MPa/天）
10L	小型培养箱，备用	~15 MPa	~10天
40L	主要培养箱，高使用量	~15 MPa	~40天

最佳实践：

• ✅ 为主要培养箱使用40升气瓶，以减少更换频率
• ✅ 为关键实验保留10升气瓶作为备用
• ✅ 在监控日志中记录气瓶容量，以确保预测准确
• ✅ 尽可能在每个设施中统一使用同一规格的气瓶，以便简化库存管理

---

自动警报系统

生成带有颜色编码的状态报告，并根据紧急程度提供具体建议。

---

状态等级：

代码	图标	状态	条件	措施
0	🟢	正常	距离警报天数超过2天	无需行动
1	🟡	警告	距离警报天数在2天内	密切监控
2	🔴	危险	距离警报天数等于或少于2天，或周末耗尽	立即更换

自动化返回代码：

返回代码	含义	自动化操作
0	正常	继续常规监控
1	警告	发送电子邮件通知
2	危险	发送紧急警报；通知值班人员

最佳实践：

• ✅ 使用返回代码与警报系统集成，实现自动化通知 |
• ✅ 根据实验室的具体流程定制建议 |
• ✅ 根据状态升级响应措施（电子邮件警告，短信/电话通知） |
• ✅ 记录所有状态变化，以便进行趋势分析和审计追踪 |

---

常见问题及解决方法：

**问题：频繁的警告导致警报疲劳

• 症状：过多的警告通知导致重要警报被忽略
• 解决方法：调整alert_days阈值；批量发送每日报告，而不是立即发送警报 |
• **问题：未能检测到周末的耗尽事件
• 症状：周末的耗尽事件未被发现（跨越多天）
• 解决方法：确保will_deplete_on_weekend()逻辑能够覆盖多天的周末时段

---

模拟模式（用于培训）

生成随机的气瓶数据，以便在不影响实际监控系统的情况下培训员工。

---

培训应用：

应用场景	模拟参数	学习目标
新员工培训	各种随机场景	识别不同的警报等级
周末风险意识	强制模拟周末耗尽场景	理解关键的时间节点
消耗量计算	不同的压力/消耗组合	练习手动计算
紧急响应	低压力场景（<3 MPa）	学习紧急处理程序

---

自动化调度集成

与cron作业或任务调度器集成，实现自动化的每日监控。

---

完整工作流程示例

---

Python API使用方法：

---

预期输出文件：**

---

常见模式

模式1：每日早晨的监控例程

场景：实验室技术人员每天上午9点检查所有二氧化碳气瓶。

---

工作流程：

1. 每天上午9点读取所有气瓶的压力值
2. 为每个气瓶运行监控脚本
3. 记录状态代码和任何警报
4. 如果有任何气瓶的状态等级≥1，通知实验室经理
5. 为处于警告等级的气瓶安排更换
6. 对于处于危险等级的气瓶，立即启动更换程序

输出示例：

---

模式2：假期前的周末评估

场景：在为期3天的假期（例如阵亡将士纪念日）之前，确保有足够的气体供应。

---

工作流程：

1. 在假期前的周五运行评估，设置延长的alert_days（4天）
2. 检查所有气瓶的周末风险
3. 对于在假期期间可能耗尽的气瓶：
   • 优先安排立即更换
   • 考虑紧急情况下的周末配送
   • 将关键培养物转移到备用培养箱
4. 在假期交接记录中记录气体状态
5. 设置气体供应商的紧急联系信息

---

新员工培训模式

场景：使用模拟模式培训新技术人员了解二氧化碳监控。

---

工作流程：

1. 运行模拟模式生成10个随机场景
2. 对于每个场景，让新员工手动计算剩余使用天数
3. 将新员工的计算结果与脚本输出进行比较
4. 讨论每种状态等级下的适当行动
5. 通过“危险”场景练习紧急处理程序
6. 查看过去一个月的实际监控日志
7. 在第一周由有经验的技术人员指导新员工

---

多培养箱设施管理

场景：大型设施中有6个使用不同二氧化碳气瓶的培养箱。

---

工作流程：

1. 创建一个监控仪表板，跟踪所有6个气瓶
2. 每天为每个气瓶运行监控脚本
3. 实施分阶段的更换计划，以避免所有气瓶同时需要更换
4. 跟踪消耗趋势，优化更换计划
5. 在库存中保留1-2个备用气瓶
6. 根据使用情况与气体供应商协商批量价格
7. 每月审查消耗趋势和成本优化方案

---

质量检查清单

监控设置前的准备：

• 关键：确认压力表已校准且功能正常
• 确认气瓶规格（10升或40升）与监控参数一致
• 通过1-2周的观察确定平均每日消耗速率
• 设置适当的alert_days阈值（标准工作周通常为2天）
• 配置自动调度（cron）进行每日检查
• 设置警报路径（电子邮件、短信）以应对危险等级的状态
• 创建气体供应商的紧急联系名单
• 确保关键培养箱有备用气瓶

日常监控期间：

• 在固定时间（例如每天上午9点）读取压力值
• 关键：记录实际的压力值，而不是估计值
• 注意任何异常的消耗模式（例如门开启、新实验的添加）
• 核对状态代码并理解其含义
• 检查周末的耗尽风险（特别是周四/周五）
• 记录所有读数以进行趋势分析
• 如果使用模式发生变化，更新消耗速率
• 检查气瓶和调节器是否有泄漏或损坏

警报响应：

• 关键：立即确认危险等级的警报
• 对于周末的耗尽风险，安排在周五下午5点之前更换气瓶
• 通知实验室经理需要更换的处于警告等级的气瓶
• 记录对警报的所有响应措施
• 在移除空气瓶之前，确认新气瓶已到位
• 更换后，确认培养箱的二氧化碳浓度正常
• 在库存管理系统中更新更换记录和新气瓶的信息
• 将空气瓶放回储存区以便取回

---

更换后的验证：**

关键：确认新气瓶的阀门完全打开

• 检查新气瓶的压力读数（应约为15 MPa）
• 监控培养箱的二氧化碳浓度30分钟，以确保稳定性
• 检查调节器连接处是否有气体泄漏（使用肥皂泡测试）
• 在库存管理系统中更新监控参数，包括新气瓶的起始压力
• 通知相关实验室成员气瓶的更换情况
• 根据预测的耗尽日期安排下一次更换

---

常见问题及解决方法：

监控设置问题：

• ❌ 读取时间不一致 → 每日的变化会影响趋势的准确性
  • ✅ 每天在相同时间（例如上午9点±30分钟）读取压力值
• ❌ 消耗量估计错误 → 预测的耗尽时间不准确
  • ✅ 根据实际使用情况计算2周以上的消耗量；根据季节调整
• ❌ 忽略温度影响 → 压力会随环境温度变化
  • ✅ 在读取前让气瓶达到室温
• ❌ 未考虑使用量的变化 → 周末和工作日的使用量不同
  • ✅ 分别监控不同的使用情况；使用平均值

警报和响应问题：

• ❌ 警报疲劳 → 过多的警告通知导致重要警报被忽略
  • ✅ 批量发送每日报告；仅对紧急警报立即响应
• ❌ 未能检测到周末的耗尽事件 → 周末的耗尽事件未被发现
  • ✅ 确保包含周五下午5点的检查，以检测周末的耗尽风险
• ❌ 更换延迟 → 等待时间过长，导致实际耗尽
  • ✅ 在警告等级触发时立即更换气瓶；不要等到危险等级
• ❌ 没有备用计划 → 气瓶耗尽时没有备用气瓶
  • ✅ 保持1-2个备用气瓶；知道紧急情况下的供应商联系方式

计算和数据问题：

• ❌ 气瓶容量错误 → 10升和40升的混淆导致预测错误
  • ✅ 始终核对气瓶标签；双重检查容量参数
• ❌ 压力单位混淆 → PSI和MPa或Bar的单位混淆
  • ✅ 统一使用MPa作为单位；如果压力表显示其他单位，请进行转换
• ❌ 未同时监控多个气瓶 → 混合不同气瓶的读数
  • ✅ 为每个气瓶/培养箱对分别运行监控脚本

操作问题：

• ❌ 压力表未校准 → 不准确的读数会导致错误的预测
  • ✅ 每年或按照制造商的建议校准压力表
• ❌ 未检测到泄漏 → 消耗量高于预测
  • ✅ 定期检查泄漏；突然的消耗量增加可能表明有泄漏
• ❌ 调节器问题 → 即使有足够的气体，压力也会下降
  • ✅ 按照计划更换调节器；检查流量调节器是否有堵塞
• ❌ 无文档记录 → 无法跟踪趋势或解决问题
  • ✅ 保持详细的日志；每月进行审查以优化

---

故障排除**

**问题：预测的耗尽日期始终错误

• 症状：实际耗尽时间比预测的时间提前或推迟3-5天
• 原因：
  • 消耗速率估计错误
  • 使用模式的变化（实验数量增加/减少）
  • 温度变化影响压力读数
  • 系统中的泄漏
• **解决方法：**根据最近的实际使用情况重新计算消耗速率
  • 监测2周以上以建立准确的基准
  • 在稳定的温度条件下读取压力值
  • 使用肥皂水检查连接处是否有泄漏

**问题：频繁的误报（警报疲劳）

• 症状：收到不需要采取行动的警告或危险警报
• 原因：
  • 警报阈值过于敏感
  • 正常的波动触发警报
  • 同一气瓶收到多次警报
• **解决方法：**调整alert_days参数（从2天增加到3天）
  • 实施警报聚合（每日汇总而非立即通知）
  • 对于自动化检查使用安静模式；对于完整报告使用手动通知

**问题：未能检测到周末的耗尽事件

• 症状：尽管进行了监控，但周末仍耗尽了气瓶
• 原因：
  • 未能在周五检查周末风险
  • 耗尽事件跨越多天
  • 未考虑节假日周末
• **解决方法：**添加明确的周五下午5点的检查，以检测周末风险
  • 延长alert_days，以覆盖多天的周末时段
• **问题：无法准确读取压力表的压力值
• 症状：压力读数不一致或不清楚
• 原因：
  • 压力表指针卡住或损坏
  • 压力表表面有冷凝水或污垢
  • 视角误差导致指针读数不准确
• 解决方法：立即更换故障的压力表
• 定期清洁压力表表面
• 直接观察指针以避免视角误差
• 考虑使用数字压力传感器以提高准确性

**问题：气瓶耗尽速度比预期快

• 症状：预测的耗尽时间为10天，但实际上在6天内耗尽
• 原因：
  • 培养箱的使用量增加（实验数量增加，门开启频繁）
  • 系统中的气体泄漏
  • 调节器故障
  • 温度升高（消耗量增加）
• **解决方法：**检查所有连接处是否有泄漏
• 检查培养箱的门密封情况
• 检查调节器是否正常工作
• 更新消耗速率，以反映实际使用情况

**问题：监控脚本未自动运行

• 症状：尽管设置了cron作业，但没有每日日志或警报
• 原因：
  • cron作业配置错误
• 脚本中的路径问题
• 权限问题
• 脚本错误未记录
• **解决方法：**首先手动测试cron作业
• 在部署到生产环境之前，手动测试cron作业
• 检查cron日志：grep CRON /var/log/syslog
• 将stderr重定向到日志文件以进行调试

---

参考资料**

相关资料位于references/目录中：

• （目前该技能暂无参考文件）

外部资源：

• 细胞培养二氧化碳指南：https://www.thermofisher.com/cellculture
• 气体气瓶安全指南：https://www.osha.gov/gascylinders
• 二氧化碳培养箱最佳实践：https://www.sigmaaldrich.com/incubators

---

脚本**

脚本位于scripts/目录中：

• main.py：包含二氧化碳气瓶监控的核心逻辑，包括预测和警报功能

---

压力单位转换表

单位	MPa	PSI	Bar
MPa	1.0	145.0	10.0
PSI	0.0069	1.0	0.069
Bar	0.1	14.5	1.0

典型气瓶压力：

• 满瓶：约15 MPa（约2200 PSI）
• 工作压力：8-10 MPa
• 更换阈值：约3-5 MPa
• 空瓶：<1 MPa

---

最后更新时间：2026-02-09
技能ID：182
版本：2.0（K-Dense Standard）