TinkerLab
ARTIFACT // PI5-SENSOR-LOG-GUARDIAN.SH (SHELL)

树莓派 5 传感器阈值过滤与系统日志本地 AI 诊断脚本 (pi5-sensor-log-guardian.sh)

采用“确定性阈值过滤 + 按需唤醒本地 3B 模型”混合架构,仅在温度越界或出现系统错误日志时生成中文诊断摘要。

[核心实测结论 / TL;DR]本配置包「树莓派 5 传感器阈值过滤与系统日志本地 AI 诊断脚本」(文件名:pi5-sensor-log-guardian.sh,格式:SHELL)是 Tinker AI 实测工坊配套指南《pi5-local-sensor-log-guardian》的参数化生产模板。支持在本地浏览器实时定制 告警触发温度阈值 (°C) (TEMP_THRESHOLD_C=68)、本地诊断模型 Tag (GUARDIAN_MODEL=qwen2.5:3b) 等 2 项核心变量,默认遵循 127.0.0.1 回环绑定与最小权限规范。
03 // MAKERAI 创客 / STEM· 验证日期:2026-10-23
查看全部 42 套配置附件 →
pi5-sensor-log-guardian.sh

树莓派 5 传感器阈值过滤与系统日志本地 AI 诊断脚本

采用“确定性阈值过滤 + 按需唤醒本地 3B 模型”混合架构,仅在温度越界或出现系统错误日志时生成中文诊断摘要。

查看配套实测指南 →
参数化定制变量 (Variables — 自动保存在本地浏览器)
UTF-8 编码 · 零延迟实时编译
#!/usr/bin/env bash
# Tinker AI Maker Lab — Rule-First Thermal & Log Anomaly Explainer (Guide #9)
set -euo pipefail

THRESHOLD="68"
MODEL="qwen2.5:3b"

RAW_MILLI=$(cat /sys/class/thermal/thermal_zone0/temp 2>/dev/null || echo "45000")
TEMP_C=$((RAW_MILLI / 1000))
RECENT_ERRS=$(journalctl -p err..warning -n 15 --no-pager 2>/dev/null || echo "No systemd errors.")

echo "[Rule Check] Current Temp: ${TEMP_C}°C (Threshold: ${THRESHOLD}°C)"

if [ "$TEMP_C" -ge "$THRESHOLD" ]; then
  echo "[Anomaly Triggered] Invoking local $MODEL for root-cause synthesis..."
  curl -sS http://127.0.0.1:11434/api/generate -d "{
    \"model\": \"$MODEL\",
    \"stream\": false,
    \"options\": { \"temperature\": 0.1, \"num_ctx\": 2048 },
    \"prompt\": \"Hardware alert: Pi 5 temperature reached ${TEMP_C}C. Summarize likely cause and 2 check commands from logs: \n${RECENT_ERRS}\"
  }" | python3 -c 'import sys,json; print(json.load(sys.stdin).get("response",""))'
else
  echo "[OK] Within safe thermal boundary; skipping LLM inference (0% CPU overhead)."
fi
PARAMETER SPECIFICATION // 参数化变量规范说明表

「pi5-sensor-log-guardian.sh」可定制环境变量与默认值说明

本配置模板(SHELL 格式)支持 2 项运行时参数注入,所有替换均在本地浏览器内完成。

模板占位符参数用途说明安全默认值填写示例
{{TEMP_THRESHOLD_C}}告警触发温度阈值 (°C)6868
{{GUARDIAN_MODEL}}本地诊断模型 Tagqwen2.5:3bqwen2.5:3b
PAIRED HARDWARE MANIFEST // 配套实测环境与边界记录

配套指南《创客与教学项目:树莓派本地传感器与家庭服务器日志 AI 诊断盒》验证基线

实测硬件与操作系统 (Hardware & OS)

Raspberry Pi 5 (8GB) · BME280 I2C 温湿度传感器(或无外设模式下直接读取系统 journalctl 日志)

锁定软件栈与模型版本 (Pinned Versions)
Python 3.11Ollama 0.5.7qwen2.5:3b
离线与安全边界 (100% 局域网/本机闭环运行)

无需绑定任何商业云 API Key 或信用卡,适合学生与创客零成本动手实验。

已知限制与失败边界 (Known Limits)
  • 切勿将上千行原始日志直接塞给树莓派上的 3B 模型;必须在脚本层先用规则过滤出最近 20–30 行异常摘要,将预填充耗时控制在 3 秒内。
  • 使用 I2C 传感器前必须通过 `sudo raspi-config` 开启 I2C 接口并重启,否则 `i2cdetect -y 1` 无法识别设备地址。
DEPLOYMENT CHECKLIST // 配置落地核验步骤

部署 pi5-sensor-log-guardian.sh 后的 3 步验收清单

  1. 确认已在调用本地模型前设置确定性阈值/正则过滤,避免高频无效推理。
  2. 已为本地模型 HTTP 请求设置明确的 30 秒超时保护。
  3. 已核对 3.3V 传感器接线(`i2cdetect -y 1` 可见 0x76/0x77)或开启内置温度传感器回退模式。