技能包

Meegle CLI:在終端管理飛書專案的工作項與排期

適合要在終端管理 Meegle(飛書專案)工作項、排期和資料、又不想開瀏覽器的人,前提是 Node.js 不低於 16,並跑完官方安裝嚮導完成登入。

官方來源 · Meegle CLI

安裝

npx @lark-project/meegle@latest install

適合誰

如果你已經在用 Meegle(飛書專案),希望在終端管理工項、排期和資料,而不必打開瀏覽器,這個工具對得上。它是 Meegle 的命令列工具,說明頁見

https://github.com/larksuite/meegle-cli

更合適的人已經有可登入的 Meegle 空間,本機 Node.js 不低於 16(自帶 npm / npx),並且接受只走官方這一條安裝命令。安裝嚮導會:全域安裝或升級 CLI、裝上附帶的 AI Agent Skill、設定 Meegle 主機,並啟動登入。這四步都會改本機環境,適合願意在本機完成授權的人。

若你只想在網頁裡點工項、並不打算裝全域命令列或讓 agent 調專案資料,就不必走這條嚮導。官方寫明嚮導會把附帶技能裝進若干編程環境,也寫了其他 agent;不要把點名理解成排他名單,也不要另找未記載的市場安裝。第一次請做唯讀查看,而不是建立或改排期。嚮導把 CLI 與技能綁在同一次安裝裡,不能只拷技能資料夾來跳過登入。沒有 Meegle 主機位址和可登入帳號時,先準備這兩樣,再執行 npx。

3 分鐘完成第一次嘗試

只走官方這一條安裝路徑:

npx @lark-project/meegle@latest install

不要改寫成 skills add、外掛或市場指令。執行前先確認:本機 Node.js >= 16;你準備在本機全域安裝 CLI;你願意接著設定主機並完成登入。這四件事有副作用,先看嚮導將寫入的位置和要登入的主機,確認後再繼續。

裝完後重啟你要用的 agent,確認附帶技能已出現。官方沒有寫出技能的斜線命令或 CLI 子命令清單,第一次觸發以嚮導裝進去的技能名稱為準。

在已登入、技能可見的 agent 裡,做一次低風險任務:請它唯讀查看若干工作項或目前排期,先列出將呼叫的命令或技能名、是否寫入本機、會不會改 Meegle 上的欄位。你確認純讀取後,再允許它查詢。

成功訊號:終端或對話裡出現來自 Meegle 的工作項或排期資料,而不再要求打開瀏覽器。若嚮導停在登入頁,先完成主機設定和登入,不要換成未記載的安裝包名。若技能未出現,重啟 agent,並確認嚮導已走到安裝技能那一步。若它要求打開瀏覽器才能讀資料,說明登入或主機未完成,回到嚮導,而不是再裝一遍別的包。

使用案例

案例一:在終端查看工作項。官方能力是管理工項、排期和資料。第一次只做查看:指定一個你有權看的空間或視圖,讓附帶技能或 CLI 讀出工項標題與狀態。頁面沒有給出具體子命令拼寫,缺了就問已安裝的技能「唯讀列出工作項」,不要臆造 meegle xxx。任何建立、指派、關單動作都先停在計畫步驟。

案例二:查看排期與資料,仍不改瀏覽器流程。同一句話把 schedules 和 data 與 work items 並列。做法是對同一空間讀排期或欄位資料,用於核對日曆,而不是改日期。登入未完成時不要跑。官方沒有寫匯出格式或批次改期介面;沒寫到的批次更新不要做。兩條案例都建立在嚮導已經裝好 CLI、技能、主機並完成登入之後,不是第二套安裝。若對話裡出現未在說明頁出現的子命令,先對照嚮導裝入的技能說明,對不上就不要執行。

使用邊界

執行要求是 Node.js >= 16,並帶有 npm / npx。低於該版本不要強行改安裝命令。嚮導會全域安裝或升級 CLI、寫入技能、設定主機並啟動登入;你不能只「裝技能、不登入」還指望讀到空間資料。

官方安裝只有 npx @lark-project/meegle@latest install。不要發明第二條 skills add 或外掛市場路徑。介紹裡點到的環境名稱不是唯一可用名單;未點名的環境既不被保證也不被排除,以嚮導實際寫入的位置為準。

管理工項和排期會碰到寫操作。沒有確認前,只允許讀取。官方沒有列出子命令表,也沒有寫出登出、解除安裝或多主機切換的步驟;缺了這些,就停在嚮導已完成的範圍裡。不要把產品主頁或飛書專案介紹頁當成第二條安裝位址。全域升級 CLI 可能覆蓋舊版本,執行嚮導前先確認你接受升級。登入會打開授權流程,在不信任的機器上不要跑。