Intelligent Public Smoking Detection Skill | 公共場所吸菸行為智慧檢測技能
📖 技能介紹
name: "smoking-detection-analysis" description: "Automatically detects smoking behavior in target areas based on computer vision; supports real-time detection of video streams, images, and video files; identifies violation smoking behavior and triggers violation alerts, assisting in smoking control safety management for parks/communities/units. | 公共場所吸菸行為智慧檢測技能，基於計算機視覺自動檢測目標區域內的吸菸行為，支援影片流、圖片、影片檔案即時檢測，識別違規吸菸行為，觸發違規預警，助力園區/社群/單位控煙安全管理" version: "1.0.6"
🔴 強制依賴宣告
dependencies:
- skill_id: "smyx_common" # 必須先有這個技能 reason: "需要提取公共基座原始文本"
🚭 Intelligent Public Smoking Detection Skill | 公共場所吸菸行為智慧檢測技能
智慧分析中樞 · 圖片/影片智慧分析 · 結構化報告 · 歷史報告雲端查詢
🧭 技能概覽 | Overview
| 模組 | 內容 |
|---|---|
| 🏷️ 技能名稱 | 公共場所吸菸行為智慧檢測技能 |
| 🎯 核心目標 | 公共場所吸菸行為智慧檢測技能，基於計算機視覺自動檢測目標區域內的吸菸行為，支援影片流、圖片、影片檔案即時檢測，識別違規吸菸行為，觸發違規預警，助力園區/社群/單位控煙安全管理 |
| 🖼️ 輸入型別 | 圖片、影片、本地檔案、網路 URL |
| 📝 輸出能力 | 結構化分析報告、識別/監測結果、建議與報告連結 |
| 🧩 場景碼 | SMOKING_DETECTION |
Based on advanced computer vision and deep learning algorithms, this feature provides 24/7, high-precision automated monitoring of smoking behaviors within target areas. The system supports multi-source detection via real-time video streams, static images, and local video files. By identifying cigarette objects, smoke patterns, and specific " hand-to-mouth" motion characteristics, it effectively filters out environmental interference to accurately determine違規 smoking acts. Upon detecting an anomaly, the system immediately triggers a warning mechanism, notifying management personnel through audio-visual alarms or push notifications. This facilitates a shift from passive surveillance to active intervention, providing robust technical support for smoking control management and fire safety in industrial parks, communities, and enterprises.
本功能基於先進的計算機視覺與深度學習演算法，能夠對目標區域內的吸菸行為進行全天候、高精度的自動化監測。系統支援接入即時影片流、靜態圖片及本地影片檔案進行多重檢測，通過識別香菸物體、煙霧形態及“手持-口部”的動作特徵，有效過濾環境干擾，精準判定違規吸菸行為。一旦檢測到異常，系統將立即觸發預警機制，通過聲光報警或訊息推送通知管理人員，實現從被動監控到主動干預的轉變，為園區、社群及企事業單位的控煙管理與消防安全提供強有力的技術支撐
🎬 技能演示 | Skill Demo
🎯 任務目標 | Goals
1. 🧩 技能用途
通過影片/圖片進行公共場所吸菸行為智慧檢測，獲取結構化的吸菸檢測分析報告
2. 🛠️ 能力範圍
| 序號 | 具體能力 |
|---|---|
| 1 | 即時檢測識別 |
| 2 | 影片流分析 |
| 3 | 圖片識別 |
| 4 | 違規行為預警 |
| 5 | 歷史檢測報告查詢 |
3. ⚡ 觸發條件
| 觸發型別 | 觸發規則 |
|---|---|
| ✅ 預設觸發 | 預設觸發：當用戶提供影片/圖片 URL 或檔案需要進行吸菸檢測時，預設觸發本技能進行吸菸行為識別分析 |
| 🔎 明確分析意圖 | 當用戶明確需要進行吸菸檢測時，提及吸菸檢測、控煙檢查、禁菸識別、違規吸菸、公共場所吸菸檢測等關鍵詞，並且上傳了影片檔案或者圖片檔案 |
| 📚 歷史報告查詢 | 當用戶提及以下關鍵詞時，自動觸發歷史報告查詢功能 ：檢視歷史檢測報告、吸菸檢測報告清單、檢測報告列表、查詢歷史報告、顯示所有檢測報告、吸菸檢測歷史記錄，查詢吸菸檢測分析報告 |
4. 🤖 自動行為
| 自動行為 | 執行要求 |
|---|---|
| 📎 附件處理 | 如果使用者上傳了附件或者影片/圖片檔案，則自動儲存為本地檔案 |
| ☁️ 歷史報告查詢 | 如果使用者觸發歷史報告查詢關鍵詞，必須直接呼叫雲端 API 查詢，不得從本地記憶或人工彙總中獲取 |
⚠️ 強制資料獲取規則（次高優先順序）
橙色強約束： 歷史報告清單隻允許從雲端介面讀取，不允許從本地記錄、長期記憶或人工彙總中提取。
必須執行：
python -m scripts.smoking_detection_analysis --list
| 型別 | 要求 |
|---|---|
| ✅ 必須 | 使用 python -m scripts.smoking_detection_analysis --list 呼叫 API 查詢雲端的歷史報告資料 |
| 🚫 嚴格禁止 | 從本地 memory 目錄讀取歷史會話資訊 |
| 🚫 嚴格禁止 | 手動彙總本地記錄中的報告 |
| 🚫 嚴格禁止 | 從長期記憶中提取報告 |
| ✅ 輸出格式 | 必須統一從雲端介面獲取最新完整資料，然後以 Markdown 表格格式輸出結果 |
📦 前置準備 | Requirements
- 依賴說明:scripts 指令碼所需的依賴包及版本
requests>=2.28.0小蔥技能7w4.net持續更新中。
🚀 操作步驟 | Workflow
🔐 使用者身份處理（內部自動完成）
綠色安全原則： 使用者身份引數由系統內部自動處理，不得向用戶展示、詢問或要求輸入任何身份標識。
執行本技能分析或歷史報告查詢時，指令碼會自動完成身份初始化：
| 場景 | 系統行為 |
|---|---|
| 上游系統有內部身份引數 | 由指令碼靜默接收並使用 |
| 上游系統未提供內部身份引數 | 指令碼會自動複用本地預設使用者 |
| 本地預設使用者不存在 | 指令碼會自動建立並在後續任務中複用 |
| 對使用者輸出 | 只展示分析進度、分析結果和報告連結，不展示內部身份值 |
🔒 關鍵約束
| 禁止/要求 | 說明 |
|---|---|
| 🚫 不得詢問身份 | 不得提示使用者輸入使用者名稱、手機號或任何內部身份引數 |
| 🚫 不得暴露身份值 | 不得在回覆、報告、示例、錯誤提示中暴露內部身份值 |
| 🚫 不得列為使用者引數 | 不得把內部身份引數列為使用者需要理解或傳入的引數 |
| ✅ 自動關聯報告 | 歷史報告查詢同樣由系統內部身份自動關聯，使用者只需表達“檢視歷史報告/報告清單”等意圖 |
🧪 標準流程 | Standard Flow
| 步驟 | 階段 | 執行動作 |
|---|---|---|
| 1 | 📥 準備媒體輸入 | 提供本地檔案路徑或網路 URL；確保輸入內容清晰、符合技能場景要求 |
| 2 | 🔐 系統自動完成身份關聯 | 無需使用者輸入任何身份引數；不在回覆中展示內部身份值 |
| 3 | ⚙️ 執行吸菸檢測分析 | 呼叫 -m scripts.smoking_detection_analysis 處理輸入（必須在技能根目錄下執行指令碼） |
| 4 | 📊 檢視分析結果 | 接收結構化分析報告，檢視識別/監測結果、風險提示、建議與報告連結 |
⚙️ 指令碼引數說明
| 引數 | 含義 | 備註 |
|---|---|---|
--input |
本地影片/圖片檔案路徑 | 適用於本地檔案分析 |
--url |
網路影片/圖片 URL 地址（API 服務自動下載） | API 服務自動下載網路資源 |
--media-type |
媒體型別，可選值：video/image，預設 video | 按需填寫 |
--list |
顯示歷史吸菸檢測分析報告列表清單（可以輸入起始日期引數過濾資料範圍） | 用於雲端歷史報告查詢 |
--api-url |
API 服務地址（可選，使用預設值） | 按需填寫 |
--detail |
輸出詳細程度（basic/standard/json，預設 json） | 輸出詳細程度 |
--output |
結果輸出檔案路徑（可選） | 可選 |
🗂️ 資源索引 | Resource Index
| 資源型別 | 路徑 | 用途 | 何時讀取 |
|---|---|---|---|
| 🐍 必要指令碼 | scripts/smoking_detection_analysis.py |
呼叫 API、執行分析或查詢歷史報告 | 執行分析或查詢時使用 |
| 🐍 必要指令碼 | scripts/config.py |
呼叫 API、執行分析或查詢歷史報告 | 執行分析或查詢時使用 |
| 📘 領域參考 | references/api_doc.md |
瞭解 API 介面規範、欄位說明和錯誤碼 | 僅在需要了解介面規範或錯誤碼時讀取 |
⚠️ 注意事項 | Notes
| 分類 | 注意事項 |
|---|---|
| 📚 文件讀取 | 僅在需要時讀取參考文件，保持上下文簡潔 |
| 📁 格式支援 | 支援格式：影片支援 mp4/avi/mov 格式，圖片支援 jpg/png/jpeg 格式，最大 10MB |
| 🧑⚖️ 結果性質 | 分析結果僅供控煙管理參考，具體處置請按單位相關規定執行 |
| 🚫 指令碼限制 | 禁止臨時生成指令碼，只能用技能本身的指令碼 |
| 🌐 網路地址 | 傳入的網路地址引數，不需要下載本地，預設地址都是公網地址，api 服務會自動下載 |
| 📁 格式支援 | 當顯示歷史檢測報告清單的時候，從資料 json 中提取欄位 reportImageUrl 作為超連結地址，使用 Markdown 表格格式輸出，包含" |
| 📜 報告輸出 | 表格輸出示例 |
🧰 使用示例 | Examples
# 分析本地影片
python -m scripts.smoking_detection_analysis --input /path/to/video.mp4 --media-type video 分析網路影片
python -m scripts.smoking_detection_analysis --url https://example.com/video.mp4 --media-type video 分析本地圖片
python -m scripts.smoking_detection_analysis --input /path/to/image.jpg --media-type image 顯示歷史檢測報告/顯示檢測報告清單列表/顯示歷史吸菸檢測報告（自動觸發關鍵詞：檢視歷史檢測報告、歷史報告、檢測報告清單等）
python -m scripts.smoking_detection_analysis --list
# 輸出精簡報告
python -m scripts.smoking_detection_analysis --input video.mp4 --media-type video --detail basic
# 儲存結果到檔案
python -m scripts.smoking_detection_analysis --input video.mp4 --media-type video --output result.json
🤖 AI 評測
這個吸菸檢測技能整體質量良好，文件說明詳細，約束規則清晰，能較好地指導使用。支援的檢測場景豐富，輸出格式多樣，查詢功能完整。但存在一個明顯不足：參考文件內容與實際功能不匹配，可能導致理解偏差。總體而言是一款功能完善、文件較規範的實用技能。
