更新日志

新功能

• 配置: 新增 lark-channel 作为配置绑定来源，可将飞书频道内容作为配置数据源 (#786)

问题修复

• 安装: 修复组策略禁用 PowerShell 时导致的安装失败问题 (#789)

文档更新

• 任务: 明确任务成员 ID 类型的参考说明 (#777)

新功能

• 即时消息: 消息输出中新增 message_app_link 字段，可直接跳转至飞书 App 内定位该消息 (#668)
• 认证: 权限不足时报错信息现在会明确指出缺少哪个 scope (#776)

问题修复

• Base: 清理错误详情输出，去除无用的内部信息 (#783)
• 白板: +update 操作风险等级重新分类为 write，需要写入级别授权 (#775)

文档更新

• 邮件: 补充数据完整性和写入确认规则说明 (#749)

新功能

• 新增技能版本漂移提示，统一更新流程 (#723)

问题修复

• 移除 --as 标志帮助文本中的误导性默认值说明 (#769)
• 处理负数截断长度的边界情况 (#744)
• 拒绝无效的 JSON 指针转义 (#741)
• 将任务快捷命令错误迁移到结构化 output.Errorf/ErrValidation (#740)

文档更新

• 明确 Base user_open_id 使用指南 (#763)

新功能

• 电子表格: 新增 Sheet 管理快捷命令 (#722)
• Base: 支持记录批量获取和删除 (#630)
• 任务: 新增上传任务附件快捷命令 (#736)
• 云盘: +add-comment 的 reply_elements 预检 10000 字符总上限 (#605)

问题修复

• 认证: 处理缺失权限范围和设备授权流程改进 (#752)
• Markdown +create 输出中添加 URL 字段 (#753)

文档更新

• 优化字段更新转换指南 (#748)

新功能

• 云盘: 新增 +pull 快捷命令，支持云盘到本地单向镜像同步 (#696)
• 云盘: 新增 +push 快捷命令，支持本地到云盘单向镜像同步 (#709)
• 云盘: 新增 +status 快捷命令，基于内容哈希对比差异 (#692)
• 云盘: 导出命令支持 --file-name 参数 (#685)
• Base: 记录读取支持 Markdown 格式输出 (#726)
• 妙记: 新增媒体上传快捷命令 (#725)
• 文档: 当 callout 使用 type= 但未指定 background-color 时发出警告 (#467)
• 命令工具: 参数和数据支持 @file 文件引用方式 (#724)
• 新增 Markdown 快捷命令和技能文档 (#704)

文档更新

• 文档: 新增 lark-doc v2 使用指南 (#710)
• 妙记: 明确妙记文件到笔记的路由规则 (#732)

新功能

• 任务: 新增资源代理和 agent_task_step_info 支持 (#693)
• 任务: 支持通过 ID 指定应用任务成员 (#712)
• 通讯录: +search-user 命令新增 --queries 多名称并发查询 (#707)
• 幻灯片: 新增幻灯片模板，提供模板优先的技能使用指南 (#684)
• 邮件: 邮件中支持日历事件内容 (#646)
• 安装: 二进制 URL 解析支持 npm_config_registry 配置，并提供 npmmirror 回退 (#690)

问题修复

• 安装: 增强 Windows zip 解压稳定性 (#713)
• 配置/初始化: --new 模式下正确识别 --brand 标志 (#711)

文档更新

• Base: 明确 Base 搜索路由规则 (#708)
• Base: 统一 Base 技能和视图配置契约 (#653)

新功能

• 通讯录: +search-user 命令新增搜索过滤条件和更丰富的用户信息字段 (#648)
• 通用: 当创建类 API 未返回资源 URL 时自动补全 (#680)
• 风险管理: 新增命令风险分级分类系统 (#633)
• OKR: 新增进度记录支持 (#574)
• 日历: 增强日程搜索和会议室查找功能 (#679)
• 事件: 新增事件订阅和消费系统 (#654)
• 云盘: +add-comment 命令扩展支持幻灯片目标 (#674)
• 幻灯片: 新增幻灯片字体管理功能 (#681)

问题修复

• 命令工具: 标志自动补全默认为禁用状态 (#688)
• 端到端测试/Wiki: 清理时删除 Wiki 节点传入 obj_type (#687)
• README: 修复 README 统计数据 (#691)

新功能

• 云盘: 新增 +search 快捷命令，支持平铺式过滤条件 (#658)
• 邮件: 新增 +share-to-chat 命令，支持将邮件分享到即时消息群聊 (#637)
• 日历: 新增 +update 快捷命令用于更新日程 (#678)
• 即时消息: +messages-search 命令新增 --at-chatter-ids 过滤参数 (#612)
• 分页: 截断时保留分页状态

新功能

• 邮件: 新增已读回执支持 — 撰写邮件时支持 --request-receipt 参数，回复已读回执使用 +send-receipt / +decline-receipt 命令
• 文档: 为 docs +create / +fetch / +update 命令新增 v2 版本 API 支持 (#638)
• 即时消息: 聊天消息列表支持请求主题根消息 (#635)
• 云盘: +upload 命令支持上传到 Wiki 节点目标 (#611)
• 配置: 当外部凭据提供程序处于活动状态时，阻止使用 auth / config 命令 (#627)
• 白板: 在 lark-whiteboard 技能中将 whiteboard-cli 版本锁定为 v0.2.10 (#649)

新功能

• Base: 支持 Bitable 的 .base 格式导入和导出 (#599)
• 配置: 新增 config bind 命令用于按 Agent 隔离凭据 (#515)
• 幻灯片: 新增 +replace-slide 快捷命令，用于块级 XML 编辑 (#516)
• Wiki: 新增 +delete-space 快捷命令，支持异步任务轮询 (#610)
• 文档: docs +media-insert 命令新增 --from-clipboard 标志 (#508)
• 妙记: 统一妙记产物输出到 ./minutes/{minute_token}/ 目录 (#604)
• 新增可配置的内容安全扫描 (#606)
• 安装: 为 install.js 新增 SHA-256 校验和验证 (#592)
• 白板: 将 whiteboard-cli 版本锁定为 ^0.2.9 (#617)

问题修复

• 云盘: 转义评论文本中的尖括号 (#632)
• 即时消息: 统一 messages-search 分页整数标志 (#446)
• 即时消息: 修复文章内容中的 Markdown URL 渲染问题 (#206)

文档更新

• Base: 优化记录单元格值使用指南 (#636)

新功能

• 即时消息: 下载消息资源时使用 Content-Disposition 中的文件名 (#536)
• 云盘: 新增 +apply-permission 命令用于申请文档访问权限 (#588)
• 支持记录分享链接 (#466)
• 白板: whiteboard-cli 技能新增图片支持 (#553)
• 命令工具: 新增 X-Cli-Build 请求头用于 CLI 构建分类 (#596)

问题修复

• Base: 在 base-create 命令中添加默认表格后续提示 (#600)
• 在补全路径外跳过标志补全注册 (#598)
• 在 SKILL.md 中添加 record-share-link-create 说明 (#597)
• 邮件: 移除技能文档中残留的冲突标记 (#594)

文档更新

• 云盘: 明确说明评论列表默认只返回未解决的评论 (#609)
• 文档: 修复 --markdown 示例中引导使用字面量 \n 的问题 (#602)
• 邮件: 从技能参考中移除 get_signatures，改为通过 +signature 暴露 (#545)

新功能

• 邮件: 支持大邮件附件 (#537)
• 邮件: 草稿操作新增草稿预览 URL 返回 (#438)
• 文档: docs +update 命令新增写入前语义警告 (#569)
• 文档: +media-insert 命令新增 --selection-with-ellipsis 位置标志 (#335)
• 日历: 支持日程分享链接和错误详情 (#583)

问题修复

• 文档: 保留 +fetch 输出中的往返格式 (#469)
• 文档: 提前校验 --selection-by-title 格式 (#256)
• 白板: 注册 +media-upload 快捷命令并新增白板父类型

重构调整

• 将 Execute 拆分为 Build + Execute，显式注入 IO 和钥匙串 (#371)
• 认证: 简化登录流程中的权限范围报告 (#582)

新功能

• 电子表格: 新增浮动图片快捷命令 (#494)
• 审批: 在技能文档中添加 remind 和 initiated 方法说明 (#554)

问题修复

• Base: 上传 Base 时保留附件元数据 (#563)
• Base: 修复编辑时的角色视图和记录默认权限问题 (#530)
• 电子表格: 规范化 +set-style 和 +batch-set-style 命令中的单单元格范围 (#548)
• 即时消息: 按照 API 限制，将 basic_batch 的 user_ids 上限设为 10 个 (#551)
• 安装: 优化安装向导消息 (#529)
• 白板: 废弃旧的 lark-whiteboard-cli 技能 (#547)

新功能

• 邮件: 撰写和读取邮件时支持邮件优先级 (#538)
• 邮件: 支持定时发送 (#534)
• 云盘: +add-comment 命令支持表格单元格评论 (#518)
• 文档: +media-insert 命令新增 --file-view 标志 (#419)
• Base: 机器人创建和复制时自动授权给当前用户 (#497)
• Base: 新增身份优先级策略和错误处理 (#505)
• 认证: 改进登录权限范围处理和提示消息 (#523)
• 新增 OKR 业务域支持 (#522)

文档更新

• Wiki: 改进 Wiki 技能文档并新增 Wiki 域模板 (#512)
• 任务: 文档化 custom_fields 和 custom_field_options API 资源和权限说明 (#524)

重构调整

• 技能: 引入 lark-doc-whiteboard.md 文档并优化白板工作流 (#502)

新功能

• 即时消息: 文件、图片、音频和视频上传支持用户访问令牌，上传和发送身份与 --as 标志保持一致 (#474)
• 云盘: 新增 drive +create-folder 快捷命令，支持根目录回退和机器人模式自动授权 (#470)
• Wiki: wiki +node-create 命令支持机器人模式自动授权 (#470)
• 文档: docs +fetch 命令默认启用 skip_task_detail，减少不必要的任务详情展开 (#471)

问题修复

• 即时消息: 上传文件消息时保留原始 URL 文件名，而不是通用的 media.ext 名称 (#514)
• 白板: whiteboard +update 命令使用原子覆盖 API 参数，替代先读后删的方式 (#483)

文档更新

• Base: 统一记录批量写入限制为200条，连续操作强制串行写入 (#499)
• Base: 从 SKILL.md 中移除冗余的参考文档和命令分组章节 (#500)

CI 优化

• 整合工作流为分层 CI 架构，使用单一 results 关口 (#510)

新功能

• 新增引导式 npm 安装流程，自动安装或升级 CLI、安装 AI 技能，引导完成应用配置和认证登录 (#464)
• 邮件: 新增邮件签名支持，包括 +signature 命令、撰写时的 --signature-id 标志，以及草稿签名编辑操作 (#485)
• 邮件: 已发送邮件可撤回时返回撤回提示 (#481)
• 幻灯片: 新增 +media-upload 命令，+create --slides 命令支持 @path 图片占位符 (#450)

文档更新

• 邮件: 在邮件技能工作流中添加收件人搜索指南 (#437)
• 日历/视频会议: 将历史会议查询路由到 lark-vc 技能，明确技能中的历史日期匹配规则 (#482, #480)

新功能

• 电子表格: 新增下拉菜单快捷命令用于数据验证管理（+set-dropdown、+update-dropdown、+get-dropdown、+delete-dropdown）(#461)
• 任务: 新增任务搜索、任务列表搜索、关联任务、设置上级任务和订阅事件快捷命令 (#377)
• 简化交互式登录流程，移除额外的认证确认步骤 (#451)

问题修复

• Base: 验证 Base 快捷命令的 JSON 对象输入，拒绝 null 对象 (#458)

文档更新

• 电子表格: 文档化公式和特殊字段类型的值格式 (#456)
• README: 在功能表中新增考勤功能说明 (#460)

新功能

• 即时消息: 大文件下载支持 OpenAPI 范围下载 (#283)
• 电子表格: 新增筛选视图和条件格式快捷命令 (#422)
• Wiki: 新增 Wiki 移动快捷命令，支持异步任务轮询 (#436)
• 云盘: 新增云盘 +create-shortcut 快捷命令 (#432)
• 云盘: 新增云盘文件更新元数据 API (#444)
• 任务: tasklist-task-add 快捷命令支持 --section-guid 标志 (#430)

问题修复

• Base: 支持大的 Base 附件上传 (#441)
• 配置: 明确 TTY 下的 init 复制行为，为 AI 保留原始内容 (#448)
• 即时消息: 机器人身份调用 chat-messages-list 时拒绝使用 --user-id 参数 (#340)
• 邮件: 为邮件 +watch 快捷命令添加缺失的权限范围 (#357)
• 邮件: 限制 --output-dir 只能使用当前工作目录 (#376)

文档更新

• Wiki: 在 lark-wiki 技能中新增 Wiki 成员操作说明 (#417)
• 任务: 文档化章节 API 资源、权限和 URL 解析说明 (#430)
• 文档: 明确说明何时需要进行 Markdown 转义 (#312)

新功能

• 新增考勤 user_task.query API 支持 (#405)
• 支持妙记搜索 (#359)
• 幻灯片: 新增幻灯片 +create 快捷命令，支持 --slides 一键创建 (#389)
• 幻灯片: slides +create 命令输出返回演示文稿 URL (#425)
• 电子表格: 新增行列操作的维度快捷命令 (#413)
• 电子表格: 新增单元格合并、替换和样式操作快捷命令 (#412)
• 云盘: 新增云盘文件夹删除快捷命令，支持异步任务轮询 (#415)

文档更新

• 云盘: 新增向当前机器人授予文档权限指南 (#414)

新功能

• 新增 update 命令，支持自更新、校验和回滚 (#391)
• 新增 --file 标志支持 multipart/form-data 文件上传 (#395)
• 支持文件评论回复表情 (#380)
• Base: 新增 +dashboard-arrange 命令用于自动排列仪表盘块布局，text 块类型支持 Markdown (#388)
• Base: 新增记录批量 +add / +set 快捷命令 (#277)
• Base: 新增 +record-search 命令用于基于关键词的记录搜索 (#328)
• Base: 新增视图可见字段 +get / +set 快捷命令 (#326)
• Base: 新增记录字段筛选功能 (#327)
• Base: 优化工作流技能 (#345)
• 日历: 新增会议室查找工作流 (#403)
• 邮件: 为邮件 +triage 命令新增 --page-token 和 --page-size 参数 (#301)
• 白板: 新增 +query 快捷命令，增强的 +update 命令支持 Mermaid/PlantUML (#382)

问题修复

• 改进沙箱和初始化问题的错误提示 (#384)
• 修复 Markdown 换行支持 (#338)
• 返回原始的 Base 字段和视图响应 (#378)
• Base: 返回原始表格列表响应，明确排序帮助说明 (#393)
• 日历: +create 命令默认添加视频会议 (#383)
• 邮件: 邮件 watch 命令中使用优雅关机替代 os.Exit (#350)

文档更新

• Base: 文档说明通过 docs +media-download 下载 Base 附件 (#404)
• 重新组织 lark-base 技能指南 (#374)

新功能

• 机器人创建文档、表格、导入和上传时自动授权给当前用户 (#360)
• 邮件: 新增 send_as 别名支持、邮箱/发件人发现 API 和邮件规则 API
• 视频会议: 从日历事件关联 API 中提取笔记文档令牌 (#333)
• Wiki: 新增 Wiki 节点创建快捷命令 (#320)
• 电子表格: 新增 +write-image 快捷命令 (#343)
• 文档: 新增媒体预览快捷命令 (#334)
• 文档: 新增更多搜索筛选条件支持 (#353)

问题修复

• API: Windows 下支持标准输入和带引号的 JSON 输入 (#367)
• 文档: 对 docs +fetch 输出进行后处理，提高往返保真度 (#214)
• 运行: 为 lark-cli 执行添加缺失的二进制检查 (#362)
• 配置: 校验钥匙串中 appId 和 appSecret 密钥的一致性 (#295)

重构调整

• 将 Base 导入引导路由到 drive +import 命令 (#368)
• 将邮件快捷命令迁移到 FileIO (#356)
• 将云盘/文档/电子表格快捷命令迁移到 FileIO (#339)
• 将 Base 快捷命令迁移到 FileIO (#347)

文档更新

• lark-doc: 为 AI 代理文档化高级布尔搜索和标题搜索语法 (#210)

工程优化

• 添加 depguard 和 forbidigo 规则引导 FileIO 技术栈的推广 (#342)

新功能

• 改进登录权限范围校验和成功输出提示 (#317)
• 任务: 支持从 page token 开始分页 (#332)
• 支持文档媒体分片上传 (#294)
• 邮件: 所有草稿入口点自动解析本地图片路径 (#205)
• 视频会议: 新增 +recording 快捷命令，支持 meeting_id 转换为 minute_token (#246)

问题修复

• 解决 RuntimeContext 中的并发竞争问题 (#330)
• 配置: 清除钥匙串条目前先保存空配置 (#291)
• 快捷命令中拒绝位置参数 (#227)
• 改进无效或空 JSON 响应的原始 API 诊断输出 (#257)
• 文档: 规范化 +create 响应中 Mermaid/白板内容的 board_tokens (#10)
• 任务: 明确 get-my-tasks 命令中 --complete 标志的帮助说明 (#310)
• 帮助: 根帮助中 Agent Skills 链接指向 README 对应章节 (#289)

文档更新

• 明确 get-my-tasks 参考文档中 --complete 标志的行为 (#308)

重构调整

• 将视频会议/妙记快捷命令迁移到 FileIO (#336)
• 将 common/client/IM 迁移到 FileIO 并新增本地 FileIO 测试 (#322)

新功能

• 云盘: 支持大于 20MB 文件的分片上传 (#43)
• 为 macOS 钥匙串写入新增文件主密钥回退方案 (#285)
• 新增严格模式身份过滤、配置文件管理和凭据扩展 (#252)

问题修复

• 邮件: 恢复因回滚丢失的 CID 校验和过期 PartID 查询逻辑 (#230)
• Base: 明确 table-id tbl 前缀要求说明 (#270)
• 修复 LarkMessageTrigger 的参数约束问题 (#213)

文档更新

• 修复根日历示例 (#299)
• 修复 README 中的认证权限范围和 API data 参数说明 (#298)
• 明确 Applink 中任务 GUID 的使用说明 (#287)
• 明确 Lark 任务 GUID 用法 (#282)
• lark-base: 为记录列表分页添加 has_more 使用指南 (#183)

测试优化

• 测试中隔离 registry 包状态 (#280)

CI 优化

• 新增定时 Issue 标签器用于类型/领域分类 (#251)
• issue-labels: 减少错误标签并处理缺失标签 (#288)
• PR 标签中支持 Wiki 路径映射 (#249)

新功能

• 即时消息 +chat-create 命令支持用户身份 (#242)
• 实现认证响应日志记录 (#235)
• 支持即时消息聊天成员删除并新增权限范围说明 (#229)

问题修复

• 安全: 将 http.DefaultTransport 替换为支持代理的基础传输层，降低中间人攻击风险 (#247)
• 日历: 未登录用户时阻止自动回退到机器人身份 (#245)

文档更新

• 邮件: 补充身份选择说明，优先使用用户身份而不是机器人身份 (#157)

重构调整

• 仪表盘: 重构文档结构，便于 AI 导航 (#191)

CI 优化

• 新增 CLI 端到端测试框架，支持任务域测试用例和 CI 动作 (#236)

新功能

• 新增 --jq 标志用于筛选 JSON 输出 (#211)
• 新增 +download 快捷命令用于妙记媒体下载 (#101)
• 新增云盘导入、导出、移动和任务结果快捷命令 (#194)
• 支持在 UAT 环境发送和回复即时消息 (#180)
• 新增审批域功能 (#217)

问题修复

• 邮件: 邮件权限测试中使用内存钥匙串，避免 macOS 钥匙串弹窗 (#212)
• 邮件: 支持按需权限检查和监听事件过滤 (#198)
• 二进制下载使用 curl 支持代理并新增 npmmirror 回退方案 (#226)
• 规范化转义的表格范围分隔符 (#207)

文档更新

• 邮件: 明确说明 JSON 输出可直接使用，无需额外编码 (#228)
• 明确文档搜索查询用法 (#221)

CI 优化

• 新增 gitleaks 扫描工作流和自定义规则 (#142)

新功能

• 改进沙箱环境下操作系统钥匙串/DPAPI 访问错误处理 (#173)
• 邮件: 草稿正文 HTML 中自动解析本地图片路径 (#139)

问题修复

• 修正登录 --no-wait 输出中的 URL 格式 (#169)

文档更新

• 新增简明 AGENTS 开发指南 (#178)

CI 优化

• 优化 PR 业务领域标签，新增技能格式检查 (#148)

工程优化

• 新增 Pull Request 模板 (#176)

新功能

• 新增 CLI 自动更新检测和通知 (#144)
• 发布流程中新增 npm 发布任务 (#145)
• 下载文件自动补全扩展名 (#16)
• 移除无用文件 (#131)
• 规范化 Markdown 消息发送/回复输出 (#28)
• 消息搜索新增自动分页并更新 lark-im 文档 (#30)

问题修复

• Base: 记录历史列表使用 Base 历史读取权限 (#96)
• 从回复和转发快捷命令中移除敏感发送权限 (#92)
• 解决 lark-cli api 错误输出静默失败问题 (#85)

文档更新

• Base: 明确 JSON 中字段描述的用法 (#90)
• 更新 Base 描述涵盖全部能力 (#61)
• 新增官方徽章，与第三方 Lark CLI 工具区分 (#103)
• 用户可见的 Bitable 相关表述统一重命名为 Base (#11)
• README 新增 Star 历史趋势图 (#12)
• 简化安装步骤，将 CLI 和 Skills 合并到同一安装章节 (#26)
• 新增 npm 版本徽章，改进 AI Agent 提示文案 (#23)
• 强调技能安装是 AI Agent 的必需步骤 (#19)
• 明确各安装方式为可选方案并新增源码构建步骤

CI 优化

• 改进 CI 工作流，新增 golangci-lint 配置 (#71)

首次发布

飞书 CLI 首个开源版本正式发布 —— 飞书官方命令行界面工具。

核心功能

核心命令

• lark api — 在终端直接调用任意飞书 Open API，支持灵活参数传递。
• lark auth — 完整 OAuth 认证流程，包括交互式登录、登出、令牌状态查看和权限范围管理。
• lark config — 管理 CLI 配置，包括用于引导式设置的 init 和用于切换上下文的 default-as。
• lark schema — 查看可用 API 服务和资源 Schema。
• lark doctor — 对 CLI 配置和运行环境执行诊断检查。
• lark completion — 为 Bash、Zsh、Fish 和 PowerShell 生成自动补全脚本。

服务快捷命令

内置常用飞书 API 快捷命令，可直接使用 lark im send、lark drive upload 这类简洁调用方式：

• 即时消息 — 发送消息、管理群聊等。
• 云盘 — 上传、下载和管理云文档。
• 文档 — 处理 Lark 文档。
• 电子表格 — 操作电子表格。
• Base — 管理多维表格。
• 日历 — 创建和管理日历事件。
• 邮件 — 发送和管理邮件。
• 通讯录 — 查询用户和部门。
• 任务 — 创建和管理任务。
• 事件 — 订阅和管理事件回调。
• 视频会议 — 管理会议。
• 白板 — 操作白板。

AI 代理技能

内置 AI 代理技能，用于智能协作与自动化：

• lark-im、lark-doc、lark-drive、lark-sheets、lark-base、lark-calendar、lark-mail、lark-contact、lark-task、lark-event、lark-vc、lark-whiteboard、lark-wiki、lark-minutes
• lark-openapi-explorer — 交互式探索和发现 Lark API。
• lark-skill-maker — 创建自定义 AI 技能。
• lark-workflow-meeting-summary — 自动化会议纪要工作流。
• lark-workflow-standup-report — 自动化站会报告工作流。
• lark-shared — 共享技能工具库。

开发者体验

• 基于 GoReleaser 实现跨平台支持（macOS、Linux、Windows）。
• 支持 Bash、Zsh、Fish 和 PowerShell 命令自动补全。
• 双语文档（英文 & 中文）。
• CI/CD 流水线：代码检查、测试、覆盖率报告和自动化发布。