前言¶
在觀遠 BI 上做日常運維，要麼點頁面，要麼調開放 API 自己拼請求。點頁面慢且難留痕，拼 API 要記每個端點、參數和鑑權方式。如果這些操作（查 ETL、改數據集、構建儀表板、編排工作流）能統一從一個命令行入口發出，腳本化和重複執行都會省事。
觀遠 CLI 官方套件就是這個入口。它由觀遠數據發佈，在 SkillHub 上的座標是 @org-v7o6v577/guandata-cli-suite，當前版本 1.0.3，來源標記爲 enterprise，分類是 data-analysis。它是一系列 CLI 組件的統一入口，按操作對象拆成不同組件，而不是一個什麼都做的命令。
這是什麼¶
一句話定位：觀遠 BI 平臺的命令行工具套件入口，把 ETL、數據集、頁面、卡片、指標、血緣、表單填報、SuperApp 模板、數據源管理、工作流編排這些操作統一到 CLI 上。
出品方是觀遠數據，這一點在 SkillHub 頁面上明確標註。套件面向的是需要在 BI 平臺上批量或重複操作的開發者和運維人員，尤其是希望把操作寫進腳本、定時任務或 CI 流程的場景。
核心功能¶
下面這些能力來自套件的官方簡介，是它聲稱覆蓋的操作範圍：
1、查詢與分析：ETL、數據集、頁面、卡片、指標，以及血緣關係。
2、表單填報：讀寫表單填報數據，不只是查，還包括寫回。
3、SuperApp 模板：創建模板。
4、數據源與數據集管理：增刪改查數據源和數據集。
5、ETL 開發：創建和修改 ETL。
6、可視化構建：構建圖表或儀表板。
7、指標管理：創建和編輯指標。
8、工作流與數據流：查詢和編排工作流、數據流。
一句話歸納：從取數到建 ETL、建圖表、建指標、編排流程，這一整條鏈路上的主要寫操作它都覆蓋。
組件劃分¶
這個套件不是一個單一命令，而是按操作類型拆成六個組件。做任務時按對象選組件：
guancli：通用命令入口guands：數據源與數據集相關操作guanetl：ETL 相關操作guanvis：圖表、頁面、卡片相關操作guanmetric：指標相關操作guanwf：工作流、數據流相關操作
選錯組件的表現通常是命令不存在或參數不匹配。實際操作前先確認任務落在哪個組件上。
安裝與啓用¶
套件標籤裏有一條關鍵信息：requires_api_key=false，即使用這套 Skill 本身不需要額外配置 API Key。實際連接觀遠 BI 平臺時的鑑權方式，資料裏沒有說明，需要以各組件自身文檔爲準。
安裝方式：套件簡介明確寫的是，如果組件尚未安裝，引導通過 @guandata/guanskill 安裝正式套件。也就是說安裝入口不是直接從當前套件的地址拉取，而是走 @guandata/guanskill 這個包。
具體的安裝命令、依賴的 CLI 運行時版本、配置文件路徑，在已獲取的資料中沒有給出。這一點要如實說明：不要憑經驗補一條 npm 或 pip 命令，裝之前以官方頁面爲準。
在支持通用 SKILL.md 格式的 Agent 環境（Cursor、Codex CLI、Claude Code 等）中啓用時，把套件路徑加入 Skill 搜索目錄即可被識別。不同環境對目錄位置和加載時機的處理不一樣，需要按各自文檔配置。
典型用法¶
已獲取的資料只給出能力範圍，沒有提供可複製的命令行示例。下面按簡介中的能力列表描述典型調用方向，具體命令需要安裝後用 --help 或組件文檔確認：
- 需要查某個數據集的結構和字段時，走
guands，而不是翻頁面。 - 需要改一條 ETL 的邏輯時，走
guanetl。 - 需要在腳本里批量生成儀表板或圖表時，走
guanvis。 - 需要建指標或改指標口徑時，走
guanmetric。 - 需要編排工作流、數據流，或查詢當前編排狀態時，走
guanwf。 - 不確定某項操作該用哪個組件時，先走
guancli看可用命令。
這裏的判斷標準是：先確定操作對象（數據集、ETL、圖表、指標、工作流），再選組件，不要一律用通用入口。
適用場景與注意¶
適合的場景：
1、需要在觀遠 BI 上批量創建或修改數據集、ETL、儀表板，人工點頁面效率低。
2、需要把 BI 平臺操作寫進腳本或定時任務，要求操作可留痕、可重放。
3、需要查詢血緣、指標口徑、工作流狀態等元信息，用於排查或審計。
4、需要讀寫表單填報數據，尤其是批量寫入場景。
需要注意的限制：
1、當前 SkillHub 頁面顯示下載 1057、安裝 0，說明安裝量還很低，遇到問題基本要靠自己讀組件文檔。
2、套件本身不要求 API Key，但連接觀遠 BI 平臺大概率需要平臺側憑證，這部分配置資料裏沒寫。
3、組件粒度較細，跨組件的任務（比如改完 ETL 再更新依賴它的儀表板）需要自己串起來執行，套件不保證有跨組件編排能力。
4、版本更新由發佈方控制，安裝後建議確認版本號與平臺側兼容。
結尾¶
這個套件的價值在於把觀遠 BI 的操作面收斂到六個按領域劃分的 CLI 組件上，讓重複性的建數、建圖、建指標、編排工作可以腳本化。它不替代平臺功能，只是換了操作入口。官方地址：https://api.skillhub.cn/org-v7o6v577/guandata-cli-suite ，SkillHub 頁面：https://www.skillhub.cn/skills/org-v7o6v577/guandata-cli-suite 。
