name: dataease-resource-skill description: 通過自然語言查詢 DataEase 組織、切換組織、列出儀表板或資料大屏，並把指定資源匯出為截圖或 PDF。

目標

根據使用者的自然語言請求，呼叫 DataEase 介面完成以下工作：

• 查詢組織列表
• 切換組織
• 查詢指定組織下的儀表板或大屏列表
• 匯出指定儀表板或大屏的截圖或 PDF

輸入

使用者可能會這樣表達需求：

• 查詢當前可用組織

  小蔥技能7w4.net有更新，你可以訪問看下。

• 切換到華東組織
• 檢視這個組織下有哪些看板
• 列出華東組織的大屏
• 匯出“銷售總覽”看板
• 截一下“門店運營監控”大屏
• 匯出華東經營分析為 pdf
• 截銷售總覽，解析度 1920*1080，等 5 秒再匯出

使用者輸入中可能包含：

• 組織 ID
• 組織名稱
• 資源名稱
• 業務型別：dashboard 或 dataV
• 輸出格式：jpeg 或 pdf
• 解析度，例如 1920*1080
• 額外等待時間

輸出

輸出內容應包括：

1. 實際執行的動作
2. 匹配到的組織或資源
3. 命中的資源 ID
4. 實際使用的匯出引數
5. 生成檔案本身；如果執行環境不能直接附帶檔案，則至少返回絕對儲存路徑
6. 如果無法準確匹配，則說明原因並返回候選項

執行規則

組織相關

• 只有使用者明確要求“查組織”時，才呼叫組織樹介面
• 只有使用者明確要求“切組織”或已經指明目標組織時，才呼叫切換組織介面
• 如果使用者只說“查詢某組織下的資源”，優先確認是否已給出 orgId
• 如果只給了組織名稱，沒有唯一命中的組織，不要猜測，應返回候選組織

資源相關

• 如果使用者明確提到“大屏”“資料大屏”“駕駛艙”，則使用 dataV
• 其他情況預設使用 dashboard
• 查詢資源時優先列出葉子節點
• 如果使用者只是想“看看有哪些資源”，返回資源列表
• 如果使用者要求“匯出”或“檢視”某個資源，先匹配資源，再執行本地預覽頁截圖流程
• 當存在多個相似候選時，不要直接猜測，應返回候選列表並說明歧義

匯出預設值

• busiType=dashboard
• pixel=1920*1080
• extWaitTime=0
• resultFormat=0，表示 JPEG
• 如果使用者明確要求 PDF，則使用 resultFormat=1

名稱匹配規則

在匹配組織名稱或資源名稱前，需要做標準化處理：

• 去掉前後空格
• 英文統一轉小寫
• 忽略中英文引號差異
• 忽略常見標點差異
• 資源優先匹配葉子節點
• 如果存在別名對映，先用別名對映轉換，再做匹配

鑑權與安全

• 不要把 access key、secret key 等敏感憑證硬編碼到 skill 檔案中
• 不要要求使用者在提問裡攜帶 base_url、access key、secret key、username、password
• 本技能通過以下配置讀取環境：
• DATAEASE_BASE_URL
• DATAEASE_ACCESS_KEY
• DATAEASE_SECRET_KEY
• DATAEASE_USERNAME
• DATAEASE_PASSWORD
• DATAEASE_LOGIN_ORIGIN
• 指令碼會自動讀取倉庫根目錄 .env
• 如果提供了 username 和 password，指令碼會先呼叫 dekey 和 /login/localLogin 獲取 x-de-token
• 如果提供了 accessKey 和 secretKey，指令碼會自動生成：
• signature
• x-de-ask-token
• 如果已切換組織，則後續查詢資源或匯出時使用切組織返回的 x-de-token
• 如果使用者已提供現成的 x-de-token，指令碼可直接複用

失敗處理

• 如果組織樹介面呼叫失敗，明確說明組織列表載入失敗
• 如果切換組織失敗，返回 HTTP 狀態和響應內容
• 如果資源樹介面呼叫失敗，明確說明資源列表載入失敗
• 如果沒有找到合適資源，返回最接近的候選名稱
• 如果本地瀏覽器啟動失敗、預覽頁載入失敗或截圖失敗，明確返回錯誤原因
• 只有在檔案實際寫入成功後，才能宣告匯出成功
• 匯出成功後必須返回 saved_file

使用檔案

• 使用 scripts/capture_dashboard.py 執行 API 呼叫和檔案儲存
• 使用 scripts/browser_capture.mjs 開啟預覽頁並完成本地截圖
• 使用 references/api.md 檢視介面說明和鑑權接入方式
• 如需維護資源別名，編輯 references/resource_aliases.json

推薦命令

• 查詢組織：
• python3 scripts/capture_dashboard.py list-orgs
• 切換組織：
• python3 scripts/capture_dashboard.py switch-org --org-id 1225813472202330112
• 查詢指定組織下的看板：
• python3 scripts/capture_dashboard.py list-resources --org-id 1225813472202330112 --busi-type dashboard
• 查詢指定組織下的大屏：
• python3 scripts/capture_dashboard.py list-resources --org-id 1225813472202330112 --busi-type dataV
• 匯出看板截圖：
• python3 scripts/capture_dashboard.py capture --org-id 1225813472202330112 --resource-name 銷售總覽 --busi-type dashboard
• 匯出大屏 PDF：
• python3 scripts/capture_dashboard.py capture --org-id 1225813472202330112 --resource-name 門店運營監控 --busi-type dataV --result-format 1

這個 Skill 質量中上，功能比較實用，能完成組織切換、查詢看板和匯出截圖等常見需求。文件寫得清楚詳細，配置方式靈活，兩種登入方式也考慮周全。不過依賴本地瀏覽器環境，安裝配置稍顯麻煩，而且程式碼缺乏測試保障，長期維護可能存在風險。總體來說功能夠用，但環境準備和穩定性還有提升空間。