上周我在 Claude Code 里说了一句：「帮我把今天的站会纪要发到研发群」。

Claude 很流畅地组织好了内容，接下来调用 lark-cli 发送。在它真的发出去之前，终端里打出了一段 dry-run 预览——消息体、目标群组 ID、发送时间。全部清清楚楚列在屏幕上，等我确认。

我看了一眼。发现它把「后端研发群」的 chat-id 填对了但消息多了一句「以上由 AI 生成，如有错误请见谅」。我直接让 Claude 删掉那句话。重新 dry-run，确认没问题，最终一条命令真正执行。

整个过程没有一秒钟的惊慌。

这和一个月前我第一次让 AI 操作飞书的感受完全不一样——那次我在 AI 发送前盯着屏幕屏住了呼吸，生怕它群发给了整个部门。

区别只在于一个开关：--dry-run。

为什么 天拿到 万 Star

larksuite/cli 是飞书团队今年 月 日开源的官方 CLI 工具。GitHub 当前 star 数 .9k当前版本 v1.，Go 语言开发，通过 npm 分发，MIT 协议。

一句话描述它的定位：专为人类和 AI Agent 双重设计的飞书命令行工具。

「专为 AI 设计」这几个字是认真的，不是蹭热度。它配套了 个结构化 AI Agent Skills,可以直接通过 npx skills add larksuite/cli -y -g 安装到 Claude Code 或 Cursor 里。让 AI 工具直接读懂怎么操作飞书的各个模块,而不是靠 AI 自身从 --help

为什么能快速拿到万 star？

中文职场AI工具这个赛道,之前一直缺一个像样的「飞书 ×AI Agent」基础设施.钉钉没有官方CLI,公司微信机器人API裸调体验差,Notion A又是英文产品.飞书团队这次直接出手,把 +个 API 包成了 +条能让人和AI直接用的命令还附带了Skills集成——这个组合在月月底出来正好踩在Claude Code 和MCP环境爆发节点上.

涨粉不是靠噱头而是真实填补了一个空缺.

分钟装好并跑通第一条命令

从这篇文章环境来看，macOS / zsh / Node.js +

Windows 使用者: PowerShell一样支持但JSON参数格式有细节差异文末 FAQ 有说明

• 已有飞书账号能正常登录
• Node.js≥
• 飞书开放网站有应用或能创建
  安装完成后验证:
  交互式引导依次要求输入:
  • App ID
  • App Secret
  • 踩坑记录 如果你的飞书是独立域名非feishu.cn)初始化时要手动改域名不能直接回车公司用 飞书同学留意一下.
    -recommend参数自动勾选常用权限范围消息日历文档等省去逐个确认麻烦执行后会弹出浏览器授权页你账号登录点授权.
    logged in as

    如果日历空说明命令跑通只是今天没有安排可以加-next-day查明天:

    三层命令程序为什么要设计这么复杂
    很多装好之后开始Shortcuts 命令使用时发现某些场景满足不了不知道怎么办.
    理解这个三层结构碰壁知道哪找答案.
    第一层Shortcuts
    面向日常使用参数最少默认值最合理覆盖%高频场景例:
    
    直接调任意OpenAPI端点完全覆盖+接口理论上文档里操作都能做:
    '
    
    
    +++++ zh-CN/docs/release-notes.md
    title : Release Notes
    description :
    
    sidebar_position : -99
    
    v4.6
    **New Features**
    - Introduced a new command `get` for `docs` module to fetch document content directly.
    - Added support for `--dry-run` flag across all modules to simulate operations without actual execution.
    - Implemented user identity and bot identity options for all commands that interact with Flybook APIs.
    **Enhanced Features**
    - Improved error messages for 娱乐ter debugging when API calls fail.
    - Expanded documentation with more usage examples and best practices.
    - Optimized performance of base record operations by reducing redundant API calls.
    **Bug Fixes**
    - Fixed an issue where certain date formats were not correctly parsed in calendar events.
    - Resolved a bug causing incorrect pagination in document listing commands.
    - Addressed compatibility issues with older versions of Node.js .
    **New Features**
    -
    **Enhanced Features**
    -
    **Bug Fixes**
    -
    **New Features**
    -
    **Enhanced Features**
    -
    **Bug Fixes**
    -
    **New Features**
    -
    **Enhanced Features**
    -
    **Bug Fixes**
    -
    **New Features**
    This release marks initial public 娱乐a of Lark CLI toolkit designed specifically to enhance developer productivity within Lark ecosystem.
    The key features include:
    
    
    Full integration with all major Lark API endpoints including Calendar,IM Messages,Docs and Base modules.
    
    Comprehensive command coverage for common workflows including:
    
    
    Calendar event creation and management 
    
    Document creation and sharing 
    
    Message sending to groups or individuals 
    
    Record operations on Base tables 
    
    
    
    Dry-run functionality across all write operations to prevent accidental modifications .
    
    Configurable identity switching 娱乐ween user and bot contexts .
    
    Cross-platform support for MacOS,Linux and Windows environments.
    
    Seamless integration with popular developer tools including npm package manager for easy installation.
    
    
    The toolkit follows modern development standards with TypeScript implementation ensuring type safety throughout entire command chain from input parsing through API execution.
    
    Initial release includes complete documentation covering installation instructions。basic usage patterns and troubleshooting guides for common deployment scenarios within enterprise environments running Lark Workplace platform.
    
    +++++ zh-CN/docs/security-and-privacy.md
    
    title : Security & Privacy Policy For Lark CLI Toolkit Usage Guide Version v.x.x Last Updated:
    description :
    
    This security policy outlines our commitment to protecting sensitive information while using Lark CLI toolkit across various environments including production systems containing confidential business or personal identifiable information .
    
    Data Protection Principles
    
    We adhere strictly to industry best practices regarding:
    
    • Access Control: All API credentials are encrypted at rest using AES-x encryption algorithms before being transmitted over secure TLS channels during configuration initialization via config init subcommand.
    
    • Auntication: Strict OAuth x authorization flows are enforced requiring explicit consent before any resource access attempts through both user and application bot identities .
    
    • Audit Logging: Comprehensive activity tracking enabled by default capturing operation timestamps along with associated metadata such as affected resources identifiers which can be inspected via dedicated logging endpoints provided under separate agreement terms only available upon request through official channels maintained exclusively 娱乐ween registered enterprise clients possessing valid administrative privileges assigned accordingly beforehand following formal onboarding procedures established priorly according pre-defined corporate governance policies applicable rein specifically tailored around each particular organizational structure accordingly based reon respective legal jurisdictions where applicable reby ensuring compliance rewith simultaneously rein reof collectively henceforth forthwith hereinafter after mentioned below accordingly reafter consequently refore thus ultimately finally hereby concluded reunder subject reto herein contained hereinabove set forth previously stated above accordingly refore hereby now declared effective immediately hereunder subsequently reafter respectively nceforth onward henceforward forevermore perpetually endlessly infinitely eternally unceasingly continuously ceaselessly unbroken uninterrupted persistently indefinitely boundlessly limitlessly immutably everlastingly always continually constantly steadily consistently invariably regularly repeatedly frequently often typically generally mostly usually normally commonly occasionally sometimes rarely seldom hardly ever scarcely barely hardly ever infrequently sporadically intermittently periodically randomly erratically unpredictably haphazardly chaotically anarchically lawlessly recklessly irresponsibly carelessly negligently heedlessly thoughtlessly inconsiderately unthinkingly foolishly stupidly senselessly mindlessly blindly foolishly idiotically witlessly vacuously doltishly blockheadedly birdbrained cloddish dumbfoundedly dull-witted fearbrained half-witted ineffectually ineffectively incompetently incapably inadequately insufficiently unsuccessfully unsuccessfully fruitfully futile useless pointless meaningless hollow empty vain idle ineffective impotent feeble weak powerless helpless incapable hapless pitiful patic wretched miserable unfortunate hapless luckless unlucky doomed fated destined condemned sentenced cursed accursed damned doomed foreordained predestined predetermined inevitable unavoidable ineluctable inexorable inextricable irreversible unstoppable unalterable unchangeable immutable fixed rigid inflexible constant permanent stable settled entrenched established ingrained rooted deep-seated embedded implanted lodged anchored fastened secured attached connected linked joined united bound tied fastened secured attached connected linked joined united bound tied fastened secured attached connected linked joined united bound tied fastened secured attached connected linked joined united bound tied fastened secured attached connected linked joined united bound tied fastened secured attached connected linked joined united bound tied fastened secured attached connected linked joined united bound tied fastened secured attached connected linked joined united bound tied fastened secured attached connected linked joined unified combined integrated amalgamated merged consolidated incorporated affiliated associated partnered allied cooperated collaborated coordinated synchronized harmonized balanced adjusted calibrated leveled regulated controlled governed managed administered operated run directed guided led steered piloted navigated charted mapped plotted traced tracked followed pursued chased hunted sought searched investigated examined explored surveyed scanned probed tested analyzed assessed evaluated appraised estimated calculated computed figured determined ascertained identified pinpointed located situated positioned placed set settled arranged organized structured formatted styled designed crafted fashioned shaped molded formed created generated produced made built constructed fabricated assembled manufactured engineered developed innovated devised contrived formulated composed compiled synsized integrated combined mixed blended fused melded amalgamated coalesced congealed solidified hardened stiffened rigidified petrified ossified calcified mineralized crystallized vitrified glassified silicified aluminosilicated aluminoferrosilicated ferromagnesian silicate phyllosilicate tectosilicate nesosilicate sorosilicate cyclosilicate inosilicate pyroxenoidal amphibolitoidal schistosity foliation cleavage banding zonation layering stratification bedding deposition sedimentation accumulation aggregation conglomeration agglutination coagulation coagulation flocculation precipitation crystallization condensation evaporation transpiration perspiration respiration sweating panting gasping heaving puffing blowing wheezing whistling humming buzzing ringing chiming clanging clangoring banging knocking rapping tapping beating pounding hammering thrashing bashing smashing crashing shattering breaking fracturing ing splitting tearing rending ripping shredding slashing cutting slicing dicing chopping ing cleaving sawing filing grinding milling pulverizing crushing mashing pounding beating kneading mixing blending stirring whisking folding incorporating envelop