前言¶

要在 Cursor、Codex 或 Claude Code 裏讓 Agent 操作飛書文檔、日程或羣聊，通常要先在本機裝好官方命令行工具 lark-cli（npm 包 @larksuite/cli），再完成應用創建與 OAuth 授權。手工查 Node 版本、處理 npm 權限、對照開放平臺文檔逐步點選，步驟多且容易在某一步卡住。

下面介紹 SkillHub 社區 Skill「飛書CLI一鍵安裝助手」（@user_af28adda/feishu-cli-installer）。它把環境檢測、CLI 安裝、相關 Skills 安裝、配置初始化、授權引導與結果校驗寫成可執行的 Python 腳本，由 Agent 按 SKILL.md 驅動，減少重複手工操作。標籤 requires_api_key=false，不依賴額外 API Key 配置。

這是什麼¶

一句話定位：面向 AI Agent 的飛書 / Lark CLI（lark-cli）一鍵安裝與配置引導 Skill。

維護與來源：社區發佈（community），座標 @user_af28adda/feishu-cli-installer，當前版本 1.0.0，分類爲 dev-programming。SkillHub 頁面統計（以抓取資料爲準）：評分 100000，下載 8060，安裝 214。

解決的問題：把「裝 CLI → 裝配套 Skills → 初始化配置 → 用戶授權 → 驗證」串成固定流程；支持記錄進度、失敗斷點續裝，並在環境不滿足時給出可執行的修復建議（如 Node 版本、npm 權限、鏡像源）。

核心功能¶

依據 Skill 包內 SKILL.md 與 scripts/ 實現，已覈實能力如下。

1. 智能環境檢測（scripts/environment_checker.py）
   檢查 Node.js（文檔要求 16.0+）、npm/yarn、網絡與系統權限，並輸出問題說明。

2. 一鍵自動安裝（scripts/one_click_installer.py）
   串聯安裝 lark-cli（npm install -g @larksuite/cli 或 yarn global add @larksuite/cli）、安裝相關 Skills、初始化應用配置、授權引導與安裝驗證。

3. 斷點續裝
   使用工作目錄下的 .lark_cli_install_progress.json 記錄步驟；已完成步驟可跳過，失敗可從斷點繼續。

4. 錯誤處理與分步入口
   除一鍵腳本外，可按步驟單獨調用 lark_installer.py、skills_installer.py、config_initializer.py、auth_guide.py、installation_validator.py。常見故障在 references/common_issues.md、references/troubleshooting.md 中有說明。

安裝成功後的校驗命令（Skill 文檔約定）：

lark-cli help
lark-cli auth status
lark-cli config list

安裝與啓用¶

1. 安裝 SkillHub CLI（若尚未安裝）¶

command -v skillhub && skillhub --version

未安裝時執行：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

僅 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

說明見 SkillHub 安裝文檔。

2. 將 Skill 裝進當前 Agent 的 skills 目錄¶

安裝時必須使用 --dir 指向當前客戶端的 skills 目錄，否則默認落在 ./skills/ 且 Agent 可能無法加載。官方文檔給出的常見路徑：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下 .agents/skills/

安裝命令（需帶 namespace）：

skillhub install feishu-cli-installer --namespace user_af28adda --dir ~/.cursor/skills/

也可把下面提示詞交給 Agent，讓其按 SkillHub 安裝說明執行：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_af28adda/feishu-cli-installer`。

安裝完成後，按所用客戶端要求重啓或刷新 Agent，使 Skill 生效。

典型用法¶

在 Skill 目錄下一鍵安裝 lark-cli¶

進入已安裝的 Skill 目錄（路徑因 --dir 而異，示例爲 Cursor 全局目錄）：

cd ~/.cursor/skills/@user_af28adda/feishu-cli-installer
python scripts/one_click_installer.py

文檔描述的流程分爲五步：環境檢測 → 安裝 lark-cli → 安裝 Skills → 初始化配置（含 App ID / App Secret）→ 瀏覽器 OAuth 授權 → 運行 installation_validator 校驗。

分步執行（需要精細控制時）¶

python scripts/environment_checker.py
python scripts/lark_installer.py
python scripts/skills_installer.py
python scripts/config_initializer.py
python scripts/auth_guide.py
python scripts/installation_validator.py

授權失敗或令牌過期時，Skill 文檔建議重新執行：

lark-cli auth login

與 Agent 對話¶

Skill 安裝並跑通 CLI 後，可按 SKILL.md 中的示例向 Agent 發起飛書相關任務，例如創建雲文檔、查看日程、搜索羣聊等（具體能力取決於已安裝的飛書 CLI 子 Skill 與當前登錄態）。

適用場景與注意¶

適合誰

• 第一次在本地爲 Agent 配置飛書 / Lark CLI 的開發者。
• 安裝中斷、需要斷點續裝或排查 Node/npm/網絡問題的環境。
• 希望用固定腳本而不是零散複製命令的團隊。

限制與注意

• 依賴 Node.js 16+ 與全局 npm/yarn；Linux 上權限不足時需按文檔調整 npm 前綴或使用 sudo 安裝全局包。
• 配置與授權會涉及飛書開放平臺應用信息，請在可信環境操作，勿將 App Secret 提交到公開倉庫。
• Skill 通過 SkillHub 安裝時需使用 --namespace user_af28adda；僅寫完整 slug 而不帶 namespace 時，CLI 可能無法從索引解析並下載。
• 社區 Skill，行爲以包內 SKILL.md 與腳本爲準；飛書 CLI 本身以 larksuite/cli 與飛書開放平臺文檔爲最終依據。

結尾¶

「飛書CLI一鍵安裝助手」把 lark-cli 從環境檢查到授權驗證收斂成 Agent 可執行的腳本流程，適合作爲飛書自動化 Skills 鏈路的安裝前置步驟。官方入口：

• SkillHub API：https://api.skillhub.cn/user_af28adda/feishu-cli-installer
• SkillHub 頁面：https://www.skillhub.cn/skills/user_af28adda/feishu-cli-installer