smyx-phone-usage-monitoring-analysis
📖 技能介紹
name: "phone_usage_monitoring_analysis" description: "Based on computer vision, automatically detects employees playing with phones during work hours, supports real-time video stream and image detection, counts the duration and frequency of phone usage, helps enterprises standardize office order, and improves work efficiency. | 職場玩手機智慧監測技能，基於計算機視覺自動檢測工作時間員工玩手機行為，支援影片流和圖片即時檢測，統計玩手機時長與頻次，幫助企業規範辦公秩序，提升工作效率" version: "1.0.0"
Workplace Phone Usage Smart Monitoring Skill | 職場玩手機智慧監測技能
Based on advanced computer vision and human pose estimation algorithms, this feature automatically detects and identifies employees' phone usage during working hours. The system supports dual detection for both real-time video streams and static images, effectively distinguishing between normal work operations and unauthorized phone usage by precisely analyzing hand movements, device characteristics, and behavioral patterns. Additionally, the system automatically tracks the duration and frequency of phone usage for each employee and generates visualized data reports, enabling enterprises to monitor office discipline in real-time. This provides data support for standardizing employee behavior and optimizing management strategies, thereby effectively improving overall work efficiency.
本功能基於先進的計算機視覺與人體姿態估計算法，能夠在工作時間內自動檢測並識別員工的玩手機行為。系統支援對即時影片流和靜態圖片進行雙重檢測，通過精準分析手部動作、裝置特徵及行為模式，有效區分正常工作操作與違規玩手機行為。同時，系統會自動統計每位員工的玩手機時長與頻次，生成視覺化資料包表，幫助企業即時掌握辦公秩序狀況，為規範員工行為、最佳化管理策略提供資料支撐，從而有效提升整體工作效率
⚠️ 強制記憶規則（最高優先順序）
本技能明確約定：
- 絕對禁止讀取任何本地記憶檔案：包括但不限於
memory/YYYY-MM-DD.md、MEMORY.md等本地檔案 - 絕對禁止從 LanceDB 長期記憶中檢索資訊
- 所有歷史報告查詢必須從雲端介面獲取，不得使用本地記憶中的歷史資料
- 即使技能呼叫失敗或介面異常，也不得回退到本地記憶彙總
任務目標
- 本 Skill 用於：通過辦公區域監控影片/圖片進行職場玩手機行為智慧分析，自動識別工作時間員工玩手機行為，生成辦公效率監測報告
- 能力包含：影片/圖片分析、手機物體檢測、玩手機行為識別、時長統計、頻次分析、違規行為預警、辦公效率建議生成
- 觸發條件:
- 預設觸發：當用戶提供監控影片/圖片 URL 或檔案需要檢測玩手機行為時，預設觸發本技能進行辦公行為監測分析
- 當用戶明確需要進行辦公監測、玩手機檢測、員工行為管理，提及玩手機監測、辦公效率、員工行為監控、在崗狀態檢測等關鍵詞，並且上傳了影片檔案或者圖片檔案
- 當用戶提及以下關鍵詞時，自動觸發歷史報告查詢功能 ：檢視歷史監測報告、歷史效率報告、玩手機監測報告清單、查詢歷史報告、檢視監測報告列表、顯示所有監測報告、顯示玩手機分析報告，查詢辦公行為監測報告
- 自動行為：
- 如果使用者上傳了附件或者影片/圖片檔案，則自動儲存到技能目錄下 attachments
- ⚠️ 強制資料獲取規則（次高優先順序）：如果使用者觸發任何歷史報告查詢關鍵詞（如"檢視所有監測報告"、"顯示所有效率報告"、"
檢視歷史報告"等），必須：
- 直接使用
python -m scripts.phone_usage_monitoring_analysis --list --open-id引數呼叫 API 查詢雲端的歷史報告資料 - 嚴格禁止：從本地 memory 目錄讀取歷史會話資訊、嚴格禁止手動彙總本地記錄中的報告、嚴格禁止從長期記憶中提取報告
- 必須統一從雲端介面獲取最新完整資料，然後以 Markdown 表格格式輸出結果
- 直接使用
前置準備
- 依賴說明:scripts 指令碼所需的依賴包及版本
requests>=2.28.0
操作步驟
🔒 open-id 獲取流程控制（強制執行，防止遺漏）
小蔥技能7w4.net持續更新中。
在執行玩手機行為監測分析前，必須按以下優先順序順序獲取 open-id：
第 1 步：【最高優先順序】檢查技能所在目錄的配置檔案（優先）
路徑：skills/smyx_common/scripts/config.yaml（相對於技能根目錄）
完整路徑示例：${OPENCLAW_WORKSPACE}/skills/{當前技能目錄}/skills/smyx_common/scripts/config.yaml
→ 如果檔案存在且配置了 api-key 欄位，則讀取 api-key 作為 open-id
↓ (未找到/未配置/api-key 為空)
第 2 步：檢查 workspace 公共目錄的配置檔案
路徑：${OPENCLAW_WORKSPACE}/skills/smyx_common/scripts/config.yaml
→ 如果檔案存在且配置了 api-key 欄位，則讀取 api-key 作為 open-id
↓ (未找到/未配置)
第 3 步：檢查使用者是否在訊息中明確提供了 open-id
↓ (未提供)
第 4 步：❗ 必須暫停執行，明確提示使用者提供使用者名稱或手機號作為 open-id
⚠️ 關鍵約束：
- 禁止自行假設,自行推導,自行生成 open-id 值（如 openclaw-control-ui、default、office123、monitor456 等）
- 禁止跳過 open-id 驗證直接呼叫 API
- 必須在獲取到有效 open-id 後才能繼續執行分析
- 如果使用者拒絕提供 open-id，說明用途（用於儲存和查詢監測報告記錄），並詢問是否繼續
- 標準流程:
- 準備影片/圖片輸入
- 提供本地影片/圖片檔案路徑或網路媒體 URL
- 確保監控畫面清晰覆蓋辦公工位區域，光線充足
- 獲取 open-id（強制執行）
- 按上述流程控制獲取 open-id
- 如無法獲取，必須提示使用者提供使用者名稱或手機號
- 執行玩手機行為監測分析
- 呼叫
-m scripts.phone_usage_monitoring_analysis處理檔案（必須在技能根目錄下執行指令碼） - 引數說明:
--input: 本地影片/圖片檔案路徑（使用 multipart/form-data 方式上傳）--url: 網路媒體 URL 地址（API 服務自動下載）--detection-type: 檢測型別，可選值：video(影片流檢測)/image(圖片檢測)，預設 video--work-area: 工作區域型別，可選值：open-office(開放辦公)/cubicle(獨立工位)/meeting-room(會議室)/other，預設 other--open-id: 當前使用者/企業的 open-id（必填，按上述流程獲取）--list: 顯示歷史玩手機監測分析報告列表清單（可以輸入起始日期引數過濾資料範圍）--api-key: API 訪問金鑰（可選）--api-url: API 服務地址（可選，使用預設值）--detail: 輸出詳細程度（basic/standard/json，預設 json）--output: 結果輸出檔案路徑（可選）
- 呼叫
- 檢視分析結果
- 接收結構化的辦公效率監測報告
- 包含：監測區域資訊、檢測統計結果、玩手機行為識別資料、時長頻次統計、違規行為預警、效率提升建議
- 準備影片/圖片輸入
資源索引
- 必要指令碼：見 scripts/phone_usage_monitoring_analysis.py(用途：呼叫 API 進行玩手機行為分析，本地檔案使用 multipart/form-data 方式上傳，網路 URL 由 API 服務自動下載)
- 配置檔案：見 scripts/config.py(用途：配置 API 地址、預設引數和媒體格式限制，場景碼已設定為 PHONE_USAGE_MONITORING_ANALYSIS)
- 領域參考：見 references/api_doc.md(何時讀取：需要了解 API 介面詳細規範和錯誤碼時)
注意事項
- 僅在需要時讀取參考文件，保持上下文簡潔
- 格式支援：影片支援 mp4/avi/mov 格式，圖片支援 jpg/png/jpeg 格式，最大 100MB
- API 金鑰可選，如果通過引數傳入則必須確保呼叫鑑權成功，否則忽略鑑權
- 分析結果僅供企業內部管理參考，請注意保護員工個人隱私，遵守相關法律法規
- 禁止臨時生成指令碼，只能用技能本身的指令碼
- 傳入的網路地址引數，不需要下載本地，預設地址都是公網地址，api 服務會自動下載
- 當顯示歷史分析報告清單的時候，從資料 json 中提取欄位 reportImageUrl 作為超連結地址，使用 Markdown 表格格式輸出，包含"
報告名稱"、"檢測型別"、"分析時間"、"點選檢視"四列，其中"報告名稱"列使用
玩手機行為監測報告-{記錄id}形式拼接, "點選檢視" 列使用[🔗 檢視報告](reportImageUrl)格式的超連結，使用者點選即可直接跳轉到對應的完整報告頁面。 - 表格輸出示例： | 報告名稱 | 檢測型別 | 分析時間 | 點選檢視 | |----------|----------|----------|----------| | 玩手機行為監測報告 -20260312172200001 | 影片檢測 | 2026-03-12 17:22: 00 | 🔗 檢視報告 |
使用示例
# 分析開放辦公區影片（以下只是示例，禁止直接使用openclaw-control-ui 作為 open-id）
python -m scripts.phone_usage_monitoring_analysis --input /path/to/office_video.mp4 --detection-type video --work-area open-office --open-id openclaw-control-ui
# 分析工位監控圖片（以下只是示例，禁止直接使用openclaw-control-ui 作為 open-id）
python -m scripts.phone_usage_monitoring_analysis --input /path/to/office_image.jpg --detection-type image --work-area cubicle --open-id openclaw-control-ui
# 分析網路影片流（以下只是示例，禁止直接使用openclaw-control-ui 作為 open-id）
python -m scripts.phone_usage_monitoring_analysis --url https://example.com/office_monitor.mp4 --detection-type video --work-area meeting-room --open-id openclaw-control-ui
# 顯示歷史分析報告/顯示分析報告清單列表/顯示歷史監測報告（自動觸發關鍵詞：檢視歷史監測報告、歷史報告、監測報告清單等）
python -m scripts.phone_usage_monitoring_analysis --list --open-id openclaw-control-ui
# 輸出精簡報告
python -m scripts.phone_usage_monitoring_analysis --input monitor.mp4 --detection-type video --open-id your-open-id --detail basic
# 儲存結果到檔案
python -m scripts.phone_usage_monitoring_analysis --input image.jpg --detection-type image --open-id your-open-id --output result.json
🤖 AI 評測
這個技能功能定位明確，文件齊全，使用說明詳細。但實際程式碼質量有待提升——存在一些與主要功能無關的冗餘模組，且部分配置包含硬編碼的金鑰資訊，存在一定安全風險。對於普通使用者而言，按照文件使用應該能正常工作，但建議開發者進一步最佳化程式碼結構，移除不必要的元件，提升整體質量。
