最近，CLI（命令行工具）正在成為AI Agent時(shí)代的基礎(chǔ)設(shè)施。

飛書、企業(yè)微信、釘釘?shù)榷嗉抑髁鬓k公協(xié)作平臺(tái)，相繼開(kāi)源了各自的CLI工具，將消息、文檔、日程等產(chǎn)品能力封裝為命令行接口，供開(kāi)發(fā)者和AI Agent直接調(diào)用。

背后的邏輯很明確：命令行是AI編程Agent最成熟的交互方式，Agent天生適合執(zhí)行結(jié)構(gòu)化的CLI指令。

辦公場(chǎng)景的CLI化已經(jīng)走在前面。但對(duì)AI+IoT開(kāi)發(fā)者來(lái)說(shuō)，一個(gè)問(wèn)題隨之浮現(xiàn)：消息可以CLI了，文檔可以CLI了，日程可以CLI了——設(shè)備控制呢？

查看設(shè)備在線狀態(tài)、調(diào)整空調(diào)溫度、批量關(guān)閉某個(gè)房間的燈光、查詢用電數(shù)據(jù)——這些日常開(kāi)發(fā)中的高頻操作，以往只能通過(guò)編寫代碼調(diào)用API，或者打開(kāi)手機(jī)App手動(dòng)完成。

今天，涂鴉正式開(kāi)源tuya-smart-control-cli，為AI+IoT開(kāi)發(fā)者提供了一套完整的設(shè)備管理命令行工具。

一、Enduser API與CLI是什么關(guān)系？

在介紹CLI之前，有必要先厘清兩個(gè)概念。

Tuya Enduser API是涂鴉開(kāi)放給開(kāi)發(fā)者的官方接口，用于獲取設(shè)備列表、控制設(shè)備、查詢數(shù)據(jù)、發(fā)送通知等。能力完整，覆蓋3000+設(shè)備品類、200+國(guó)家和地區(qū)。使用API需要編寫代碼、處理簽名邏輯、管理Token生命周期、構(gòu)造HTTP請(qǐng)求，適合二次開(kāi)發(fā)和系統(tǒng)集成。

tuya-smart-control-cli是基于上述Enduser API封裝的命令行工具。底層調(diào)用的是同一套API能力，但開(kāi)發(fā)者無(wú)需編寫完整代碼，在終端輸入命令即可完成設(shè)備查詢、控制、通知等操作。CLI內(nèi)置了鑒權(quán)流程和參數(shù)格式化，適合快速調(diào)試、批量操作和輕量級(jí)腳本編排。

需要特別說(shuō)明：API Key等憑證仍然必須配置。CLI不會(huì)內(nèi)置密鑰，也不支持免密使用。CLI省去的是編寫代碼、處理簽名和構(gòu)造請(qǐng)求的步驟，身份驗(yàn)證和權(quán)限管理與直接調(diào)用API完全一致。

簡(jiǎn)而言之：API是底層能力，CLI是基于這套API打造的開(kāi)箱即用的命令行工具。

二、AI+IoT開(kāi)發(fā)者為什么需要CLI？

01

設(shè)備調(diào)試效率大幅提升

開(kāi)發(fā)者在硬件聯(lián)調(diào)階段需要頻繁查看設(shè)備狀態(tài)、測(cè)試指令下發(fā)。以往的流程是：編寫腳本→引入SDK →處理簽名→發(fā)起請(qǐng)求→解析返回，一輪調(diào)試往往需要十幾分鐘。

使用CLI后，一條命令即可完成：

tuyadevice detail0620068884f3eb414579

幾秒內(nèi)即可看到設(shè)備當(dāng)前的屬性狀態(tài)——開(kāi)關(guān)狀態(tài)、亮度值、工作模式等。切換到下一臺(tái)設(shè)備，只需更改device_id重新執(zhí)行。

02

批量操作無(wú)需開(kāi)發(fā)管理后臺(tái)

方案商在酒店、公寓、辦公樓等場(chǎng)景下，往往需要同時(shí)管理大量設(shè)備。CLI配合Shell腳本，可以實(shí)現(xiàn)輕量化的批量運(yùn)維：

# 查詢某個(gè)房間下的所有設(shè)備tuya device list --room 333
# 批量關(guān)閉房間內(nèi)所有燈光tuya device list --room 333 --json | jq -r'.[].device_id'|\ whilereadid;do tuya device control"$id"'{"switch_led":false}' done

無(wú)需單獨(dú)開(kāi)發(fā)管理系統(tǒng)，一個(gè)Shell腳本配合cron定時(shí)任務(wù)即可滿足基礎(chǔ)運(yùn)維需求。

03

為AI Agent提供設(shè)備操作入口

當(dāng)前各類AI Agent的核心交互方式就是執(zhí)行Shell命令。當(dāng)涂鴉的設(shè)備控制能力被封裝為CLI后，AI Agent便可以在終端中直接操控智能設(shè)備——與它調(diào)用git、docker等工具的方式完全一致。

04

支持JSON輸出，便于數(shù)據(jù)處理與集成

所有查詢命令均支持--json參數(shù)，輸出結(jié)構(gòu)化JSON數(shù)據(jù)，方便與jq等工具配合使用，或作為管道數(shù)據(jù)傳遞給其他程序：

# 導(dǎo)出設(shè)備列表tuyadevice list --json > devices.json
# 提取所有設(shè)備IDtuya device list --json | jq'.[].device_id'
# 篩選在線設(shè)備tuya device list --json | jq'[.[] | select(.online==true)]'

三、5分鐘完成安裝與配置

環(huán)境要求

Node.js >= 18

涂鴉API Key（中國(guó)區(qū)：tuyasmart.com｜ 海外區(qū)：tuya.ai）

安裝

gitclonehttps://github.com/tuya/tuya-smart-control-cli.gitcdtuya-smart-control-clinpm installnpmlink

執(zhí)行npm link后，tuya命令將在全局可用。

配置

# 交互式配置（推薦）tuya init
# 或通過(guò)環(huán)境變量配置exportTUYA_API_KEY="sk-AYxxxxxxxxxxxx"

運(yùn)行tuya init會(huì)引導(dǎo)開(kāi)發(fā)者輸入API Key。CLI根據(jù)Key前綴自動(dòng)識(shí)別所屬區(qū)域并匹配對(duì)應(yīng)的服務(wù)端地址，全球7個(gè)數(shù)據(jù)中心無(wú)需手動(dòng)配置：

驗(yàn)證連通性

tuyadoctor

該命令會(huì)依次檢查配置文件、API Key有效性、網(wǎng)絡(luò)連通性以及賬號(hào)下的家庭數(shù)據(jù)：

Tuya CLI Doctor─────────────── Configfile: /Users/you/.tuya-cli/config.json API Key: sk-AY****xxxx (fromconfigfile) Base URL: https://openapi.tuyacn.com (China) API connection: OK (2home(s) found)

全部顯示即表示配置完成。

四、完整命令參考

▍設(shè)備管理（核心功能）

# 列出所有設(shè)備tuyadevice list
# 按家庭或房間篩選tuyadevice list --home tuyadevice list --room
# 查看設(shè)備詳情（含當(dāng)前屬性狀態(tài)）tuyadevice detail
# 查看設(shè)備物模型（了解設(shè)備支持的操作能力）tuyadevice model
# 控制設(shè)備——單屬性tuyadevice control '{"switch_led":true}'
# 控制設(shè)備——多屬性同時(shí)設(shè)置tuyadevice control '{"switch_led":true,"bright_value":800}'
# 重命名設(shè)備tuyadevice rename "客廳主燈"

典型調(diào)試流程：device list定位設(shè)備→ device detail確認(rèn)當(dāng)前狀態(tài)→ device model查看可操作屬性→ device control下發(fā)指令。四步完成一輪調(diào)試，全程無(wú)需編寫代碼。

▍家庭與房間管理

# 列出所有家庭tuyahome list
# 列出指定家庭下的房間tuya home rooms

▍天氣查詢

# 按經(jīng)緯度查詢天氣tuyaweather39.90116.40
# 指定查詢字段tuyaweather39.90116.40--codes '["w.temp","w.humidity"]'

▍消息通知

支持短信、語(yǔ)音電話、郵件、App推送四種通知方式，均為發(fā)送給當(dāng)前登錄用戶：

# 短信通知tuyanotify sms"設(shè)備已關(guān)閉"
# 語(yǔ)音電話通知tuya notify voice"警告：檢測(cè)到異常溫度"
# 郵件通知tuya notify mail"設(shè)備日?qǐng)?bào)""所有設(shè)備運(yùn)行正常"
# App推送通知tuya notify push"安防提醒""客廳檢測(cè)到異常移動(dòng)"

在設(shè)備告警場(chǎng)景中，可以結(jié)合cron定時(shí)任務(wù)實(shí)現(xiàn)自動(dòng)化監(jiān)控——例如每小時(shí)檢查一次設(shè)備狀態(tài)，發(fā)現(xiàn)離線設(shè)備即自動(dòng)發(fā)送短信通知。

▍數(shù)據(jù)統(tǒng)計(jì)

# 查看可用的統(tǒng)計(jì)配置tuyastats config
# 查詢某設(shè)備的用電量數(shù)據(jù)（按小時(shí)維度）tuyastats data ele_usage SUM20250331002025033123

五、支持的控制類型

說(shuō)明：當(dāng)前CLI暫不支持門鎖操作、視頻/攝像頭訪問(wèn)、圖像處理、固件升級(jí)、設(shè)備配網(wǎng)/移除等功能。這些操作請(qǐng)通過(guò)涂鴉App或完整API實(shí)現(xiàn)。

六、常見(jiàn)問(wèn)題排查

運(yùn)行tuya doctor即可自動(dòng)檢測(cè)大部分配置問(wèn)題。常見(jiàn)錯(cuò)誤碼及處理方式：

七、適用場(chǎng)景與目標(biāo)開(kāi)發(fā)者

涂鴉生態(tài)開(kāi)發(fā)者：硬件聯(lián)調(diào)階段的設(shè)備調(diào)試效率將大幅提升——無(wú)需反復(fù)編寫測(cè)試腳本，終端命令即可完成查詢和控制。

方案商：酒店、公寓、辦公樓等商業(yè)場(chǎng)景下的設(shè)備批量管理，可以通過(guò)CLI腳本實(shí)現(xiàn)輕量化運(yùn)維，降低管理系統(tǒng)的開(kāi)發(fā)成本。

AI Agent開(kāi)發(fā)者：為Agent項(xiàng)目提供物理設(shè)備控制能力。CLI的命令行接口天然適配AI Agent的執(zhí)行方式，可以與其他CLI工具組合使用。

硬件測(cè)試工程師：設(shè)備功能的反復(fù)測(cè)試不再依賴手機(jī)App的手動(dòng)操作，終端中即可批量運(yùn)行測(cè)試用例。

回到文章開(kāi)頭的觀察：辦公協(xié)作平臺(tái)集體CLI化，本質(zhì)上是在回答同一個(gè)問(wèn)題——AI Agent時(shí)代，軟件應(yīng)該長(zhǎng)什么樣？

答案正在變得清晰：每一個(gè)軟件都需要兩種形態(tài)。GUI服務(wù)于人，CLI服務(wù)于AI。當(dāng)軟件把自身能力封裝為命令行接口的那一刻，它就從一個(gè)"需要人來(lái)操作的工具"，變成了"可以被AI Agent直接調(diào)用的能力模塊"。

這個(gè)趨勢(shì)在辦公軟件領(lǐng)域已經(jīng)發(fā)生。而AI+IoT領(lǐng)域的CLI化，意味著AI Agent的能力邊界正在從數(shù)字世界延伸到物理世界——從"幫你發(fā)消息、寫文檔"，到"幫你管理真實(shí)空間中的每一臺(tái)設(shè)備"。

tuya-smart-control-cli的開(kāi)源，是涂鴉推動(dòng)AI進(jìn)入物理世界邁出的堅(jiān)實(shí)一步。

當(dāng)這些物理設(shè)備控制的能力，以命令行的形式向AI Agent敞開(kāi)時(shí)，AI進(jìn)入物理世界的萬(wàn)千應(yīng)用爆發(fā)才剛剛開(kāi)始。