Regional Humanoid Detection Skill | 區域人形檢測技能
📖 技能介紹
name: "human-detection-analysis" description: "Automatically detects personnel in target areas based on computer vision. Supports real-time video stream detection and is suitable for monitoring personnel access in parks, offices, and restricted areas. | 區域人形檢測技能，基於計算機視覺自動檢測目標區域內出現的人員，支援影片流即時檢測，適用於園區、辦公室、禁入區域等人員出入監測場景" version: "1.0.10" license: "MIT-0"
🚶 Regional Humanoid Detection Skill | 區域人形檢測技能
智慧分析中樞 · 圖片/影片智慧分析 · 結構化報告 · 歷史報告雲端查詢
🧭 技能概覽 | Overview
| 模組 | 內容 |
|---|---|
| 🏷️ 技能名稱 | 區域人形檢測技能 |
| 🎯 核心目標 | 區域人形檢測技能，基於計算機視覺自動檢測目標區域內出現的人員，支援影片流即時檢測，適用於園區、辦公室、禁入區域等人員出入監測場景 |
| 🖼️ 輸入型別 | 圖片、影片、本地檔案、網路 URL |
| 📝 輸出能力 | 結構化分析報告、識別/監測結果、建議與報告連結 |
| 🧩 場景碼 | HUMAN_DETECTION |
Based on computer vision technology, this capability automatically detects personnel appearing in the target area and supports real-time video stream analysis. The system continuously monitors behaviors such as entry, exit, loitering, and intrusion. It is suitable for access management scenarios in industrial parks, offices, and restricted zones. Once unauthorized personnel or activity during abnormal hours is detected, it can instantly trigger alarms and record event trajectories, helping to enhance regional security control capabilities and personnel flow management efficiency.
本技能基於計算機視覺技術，自動檢測目標區域內出現的人員，支援影片流即時分析。系統可持續監測人員進出、停留及闖入行為，適用於園區、辦公室、禁入區域等出入管理場景。一旦檢測到未經授權或異常時段的人員出現，可即時觸發告警並記錄事件軌跡，助力提升區域安全管控能力與人員流動管理效率。
🎬 技能演示 | Skill Demo
🎯 任務目標 | Goals
1. 🧩 技能用途
通過影片流/影片檔案對目標區域進行人形檢測，獲取結構化的人形檢測分析報告
2. 🛠️ 能力範圍
| 序號 | 具體能力 |
|---|---|
| 1 | 人員存在檢測 |
| 2 | 人員數量統計 |
| 3 | 出現頻次統計 |
| 4 | 入侵預警 |
3. ⚡ 觸發條件
| 觸發型別 | 觸發規則 |
|---|---|
| ✅ 預設觸發 | 預設觸發：當用戶提供監控影片 URL 或檔案需要進行人形檢測時，預設觸發本技能 |
| 🔎 明確分析意圖 | 當用戶明確需要進行人形檢測、人員入侵檢測、區域人數統計時，提及人形檢測、人員檢測、入侵檢測、區域人員統計等關鍵詞，並且上傳了影片檔案 |
| 📚 歷史報告查詢 | 當用戶提及以下關鍵詞時，自動觸發歷史報告查詢功能 ：檢視歷史檢測報告、人形檢測報告清單、檢測報告列表、查詢歷史報告、顯示所有檢測報告、人形檢測歷史記錄，查詢人形檢測分析報告 |
4. 🤖 自動行為
| 自動行為 | 執行要求 |
|---|---|
| 📎 附件處理 | 如果使用者上傳了附件或者影片/圖片檔案，則自動儲存為本地檔案 |
| ☁️ 歷史報告查詢 | 如果使用者觸發歷史報告查詢關鍵詞，必須直接呼叫雲端 API 查詢，不得從本地記憶或人工彙總中獲取 |
⚠️ 強制資料獲取規則（次高優先順序）
橙色強約束： 歷史報告清單隻允許從雲端介面讀取，不允許從本地記錄、長期記憶或人工彙總中提取。
必須執行：
7w4.net收錄了海量優質技能外掛。
python -m scripts.human_detection_analysis --list
| 型別 | 要求 |
|---|---|
| ✅ 必須 | 使用 python -m scripts.human_detection_analysis --list 呼叫 API 查詢雲端的歷史報告資料 |
| 🚫 嚴格禁止 | 從本地 memory 目錄讀取歷史會話資訊 |
| 🚫 嚴格禁止 | 手動彙總本地記錄中的報告 |
| 🚫 嚴格禁止 | 從長期記憶中提取報告 |
| ✅ 輸出格式 | 必須統一從雲端介面獲取最新完整資料，然後以 Markdown 表格格式輸出結果 |
📦 前置準備 | Requirements
- 依賴說明:scripts 指令碼所需的依賴包及版本
requests>=2.28.0
🚀 操作步驟 | Workflow
🔐 使用者身份處理（內部自動完成）
綠色安全原則： 使用者身份引數由系統內部自動處理，不得向用戶展示、詢問或要求輸入任何身份標識。
執行本技能分析或歷史報告查詢時，指令碼會自動完成身份初始化：
| 場景 | 系統行為 |
|---|---|
| 上游系統有內部身份引數 | 由指令碼靜默接收並使用 |
| 上游系統未提供內部身份引數 | 指令碼會自動複用本地預設使用者 |
| 本地預設使用者不存在 | 指令碼會自動建立並在後續任務中複用 |
| 對使用者輸出 | 只展示分析進度、分析結果和報告連結，不展示內部身份值 |
🔒 關鍵約束
| 禁止/要求 | 說明 |
|---|---|
| 🚫 不得詢問身份 | 不得提示使用者輸入使用者名稱、手機號或任何內部身份引數 |
| 🚫 不得暴露身份值 | 不得在回覆、報告、示例、錯誤提示中暴露內部身份值 |
| 🚫 不得列為使用者引數 | 不得把內部身份引數列為使用者需要理解或傳入的引數 |
| ✅ 自動關聯報告 | 歷史報告查詢同樣由系統內部身份自動關聯，使用者只需表達“檢視歷史報告/報告清單”等意圖 |
🧪 標準流程 | Standard Flow
| 步驟 | 階段 | 執行動作 |
|---|---|---|
| 1 | 📥 準備影片輸入 | 提供本地檔案路徑或網路 URL；確保輸入內容清晰、符合技能場景要求 |
| 2 | 🔐 系統自動完成身份關聯 | 無需使用者輸入任何身份引數；不在回覆中展示內部身份值 |
| 3 | ⚙️ 執行人形檢測分析 | 呼叫 -m scripts.human_detection_analysis 處理輸入（必須在技能根目錄下執行指令碼） |
| 4 | 📊 檢視分析結果 | 接收結構化分析報告，檢視識別/監測結果、風險提示、建議與報告連結 |
⚙️ 指令碼引數說明
| 引數 | 含義 | 備註 |
|---|---|---|
--input |
本地影片檔案路徑 | 適用於本地檔案分析 |
--url |
網路影片 URL 地址（API 服務自動下載） | API 服務自動下載網路資源 |
--detection-region |
檢測區域座標，格式：x1,y1,x2,y2（可選，限定特定檢測區域） | 按需填寫 |
--list |
顯示人形檢測歷史分析報告列表清單（可以輸入起始日期引數過濾資料範圍） | 用於雲端歷史報告查詢 |
--api-url |
API 服務地址（可選，使用預設值） | 按需填寫 |
--detail |
輸出詳細程度（basic/standard/json，預設 json） | 輸出詳細程度 |
--output |
結果輸出檔案路徑（可選） | 可選 |
🗂️ 資源索引 | Resource Index
| 資源型別 | 路徑 | 用途 | 何時讀取 |
|---|---|---|---|
| 🐍 必要指令碼 | scripts/human_detection_analysis.py |
呼叫 API、執行分析或查詢歷史報告 | 執行分析或查詢時使用 |
| 🐍 必要指令碼 | scripts/config.py |
呼叫 API、執行分析或查詢歷史報告 | 執行分析或查詢時使用 |
| 📘 領域參考 | references/api_doc.md |
瞭解 API 介面規範、欄位說明和錯誤碼 | 僅在需要了解介面規範或錯誤碼時讀取 |
⚠️ 注意事項 | Notes
| 分類 | 注意事項 |
|---|---|
| 📚 文件讀取 | 僅在需要時讀取參考文件，保持上下文簡潔 |
| 📁 格式支援 | 影片要求：支援 mp4/avi/mov 格式，最大 10MB |
| 🔎 使用提醒 | 適用於固定攝像頭監控場景，檢測準確率更高 |
| 🧑⚖️ 結果性質 | 分析結果僅供安全管理參考，具體處置請按單位相關規定執行 |
| 🚫 指令碼限制 | 禁止臨時生成指令碼，只能用技能本身的指令碼 |
| 🌐 網路地址 | 傳入的網路地址引數，不需要下載本地，預設地址都是公網地址，api 服務會自動下載 |
| 📁 格式支援 | 當顯示歷史檢測報告清單的時候，從資料 json 中提取欄位 作為超連結地址，使用 Markdown 表格格式輸出，包含" |
| 📜 報告輸出 | 表格輸出示例 |
🧰 使用示例 | Examples
# 檢測本地監控影片
python -m scripts.human_detection_analysis --input /path/to/monitor.mp4
# 檢測網路監控影片
python -m scripts.human_detection_analysis --url https://example.com/monitor.mp4
# 指定檢測區域進行檢測
python -m scripts.human_detection_analysis --input /path/to/monitor.mp4 --detection-region 100,100,500,500
# 顯示歷史檢測報告/顯示檢測報告清單列表/顯示歷史人形檢測報告（自動觸發關鍵詞：檢視歷史檢測報告、歷史報告、檢測報告清單等）
python -m scripts.human_detection_analysis --list
# 輸出精簡報告
python -m scripts.human_detection_analysis --input video.mp4 --detail basic
# 儲存結果到檔案
python -m scripts.human_detection_analysis --input video.mp4 --output result.json
🤖 AI 評測
這個技能質量中等偏上，能夠實現影片人形檢測和歷史報告查詢功能，操作流程清晰。但存在文件與實際功能不匹配的明顯問題（參考文件描述錯誤），版本號標識也不一致，使用時需要注意。建議開發者在使用前確認API介面的實際用途，避免被誤導。整體來說功能可用，但文件質量有待提升。
