Lark CLI Apps 命令 E2E 测试覆盖深度解析：25 个命令、100% 覆盖背后的 dry-run / Live / Local 测试体系

Lark CLI Apps 命令 E2E 测试覆盖深度解析25 个命令、100% 覆盖背后的 dry-run / Live / Local 测试体系【免费下载链接】cliThe official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200 commands and 20 AI Agent Skills.项目地址: https://gitcode.com/gh_mirrors/cli414/cli本篇技术指南围绕 Lark/飞书官方 CLIlarksuite/cli中apps服务域的端到端E2E测试覆盖文档展开系统梳理该域 25 个叶命令的三种测试形态dry-run 请求形状校验、fixture 门控的 live 工作流、纯本地 E2E、每个命令的参数契约与验证要点以及测试刻意留白的取舍逻辑。读完本文你将掌握如何读懂这份覆盖率报告、如何按图索骥定位shortcuts/apps与tests/cli_e2e/apps中任一命令的测试实现并理解 dry-run 与 live 测试各自的边界与价值。一、覆盖报告概览分母、分子与三种测试形态覆盖文档位于仓库根目录的 tests/cli_e2e/apps/coverage.md它回答的不是测了多少行代码而是每一个对外命令的请求契约与关键行为是否被端到端钉死。其核心指标如下指标数值含义覆盖分母25 个叶命令来自选定的 apps E2E 覆盖集合而非 shortcuts/apps 下全部 88 个快捷命令选定命令覆盖率100%25/25集合内每个命令至少有一个测试用例API dry-run 覆盖率100%23/2323 个有 API 后端的命令全部具备 dry-run 请求形状测试本地 E2E 覆盖率100%2/22 个纯本地命令git-credential-list、git-credential-remove有本地测试Live 覆盖率fixture 门控文件上传、角色工作流等需要真实租户资源的用例默认 CI 跳过从源码结构看shortcuts/apps 下共有 88 个快捷命令文件而覆盖集合刻意收敛到 25 个与应用管理核心链路强相关的命令create/update/list/access-scope/html-publish/file-/git-credential-/role-/member-/export其余如 automation、db、observability、openapi-key 等子域不在本报告范围内。三种测试形态的分工是理解这份报告的关键dry-run 测试让命令以--dry-run模式运行验证它将要发出的请求方法、URL、参数、body是否符合 API 契约同时验证参数校验Validate 阶段的拒绝路径。它不需要真实后端。live 测试通过环境变量注入的 fixture真实 app id、role id 等访问飞书 BOE 环境执行真实的创建/读取/清理工作流。默认 CI 跳过需显式开启。本地 E2E 测试针对不产生网络请求的纯本地命令读写本地存储、keychain、git config在隔离配置目录下验证本地行为。测试基础设施细节参见 tests/cli_e2e/apps/helpers_test.gosetAppsDryRunEnv通过LARKSUITE_CLI_CONFIG_DIR指向临时目录、注入桩凭证使 dry-run 在触达真实 keychain 之前短路由于 apps 快捷命令是 UAT-only测试统一以DefaultAs: user交给测试框架。二、dry-run 测试的方法论请求形状 Validate 拒绝路径dry-run 是这套测试体系的绝对主力23/23 API 命令全覆盖。它的核心断言对象是 dry-run 输出的 JSON 信封中的api.0字段例如 apps_create_dryrun_test.go 中assert.Equal(t, POST, clie2e.DryRunGet(result.Stdout, api.0.method).String()) assert.Equal(t, /open-apis/spark/v1/apps, clie2e.DryRunGet(result.Stdout, api.0.url).String()) assert.Equal(t, Demo, clie2e.DryRunGet(result.Stdout, api.0.body.name).String()) assert.False(t, clie2e.DryRunGet(result.Stdout, api.0.body.description).Exists()) // 未提供时可选字段保持省略一个值得注意的约定错误信封的读取顺序是stdout 优先、stderr 兜底validateErrorMessagehelper 的注释明确说明了这一点——仓库中 markdown/drive_search 等命令把 JSON 信封输出到 stdoutexit 0而 apps 域目前输出到 stderrexit 2helper 同时读取两个流以屏蔽 runner 内部路由变化。2.1create严格小写枚举与必填校验lark-cli apps create的实现位于 shortcuts/apps/apps_create.go其 Flags 定义参数必填说明--name是应用显示名Validate 阶段还会拒绝纯空白字符串--name is required--app-type是严格小写枚举html/frontend/full_stack--description否应用描述空值省略--icon-url否图标 URL省略时服务端使用默认图标--app-type是大小写敏感的严格枚举——CLI 不做大小写归一化遗留的大写HTML会被拒绝exit 2消息含invalid value与HTML。源码注释明确说明遗留大写值的兼容是服务端职责客户端不感知。测试覆盖了 happy path--app-type html、全字段、缺 name、空 name、缺 app-type、非法 app-type、遗留大写共 7 个分支。dry-run 请求形状为POST /open-apis/spark/v1/appsbody 为{name, app_type, description?, icon_url?, source_agent?}——source_agent由envvars.AgentName()注入用于标识 Agent 调用来源。2.2update部分字段 PATCH 语义apps update遵循 PATCH 语义--app-id必填且--name/--description至少提供一个。测试TestAppsUpdateDryRun验证了缺失 app-id、两者皆缺的拒绝路径以及只传一个字段时 body 只含该字段。2.3list分页、枚举过滤与直通语义apps list的实现见 shortcuts/apps/apps_list.go其参数契约参数类型/默认说明--keywordstring应用名模糊匹配--ownership枚举all我创建的 分享给我的/mine/shared--app-type枚举html/frontend/full_stack--page-sizeint默认 20分页大小--page-tokenstring上一响应返回的游标测试TestAppsListDryRun钉死的关键行为默认page_size20始终存在空--page-token被省略不发送空参数负的 page-size 直通服务端客户端不做下界校验buildAppsListParams直接rctx.Int(page-size)--keyword/--ownership/--app-type均为非空才透传非法--ownership与遗留大写--app-type在枚举层被拒绝。此外list的 Execute 实现有一个值得 Agent 使用者注意的细节它在OutFormat之前会从每个 item 中剔除icon_urlAgent 无法渲染的图片 URL与created_at与updated_at冗余使 json/table/pretty 三种输出都保持精简pretty 视图则只展示app_id、name、is_published、online_url、updated_at五列。三、访问范围与 HTML 发布枚举映射与 walker 清单3.1access-scope-setCLI 枚举 → 服务端枚举实现见 shortcuts/apps/apps_access_scope_set.go。CLI 侧的--scope取值specific/public/tenant会映射为服务端枚举Range/All/Tenant见scopeStringToServerEnumbody 中发的是服务端枚举名。参数契约参数必填/条件说明--app-id是应用 ID--scope是specific/public/tenant--targetsscopespecific时必填JSON 数组[{type:user|department|chat,id:...}]会被拆分为 body 中并行的users/departments/chats三个数组--apply-enabled仅specific允许申请访问body 生成apply_config.enabledtrue--approver依赖--apply-enabled审批人 open_id服务端仅允许一个--require-loginscopepublic时必填显式传 true/false不允许依赖默认值validateAccessScopeFlags实现了四条互斥拒绝路径TestAppsAccessScopeSetDryRun全部覆盖--scopespecific时--require-login被拒绝--approver未配--apply-enabled被拒绝--scopepublic时--targets/--apply-enabled/--approver全部被拒绝且--require-login必须显式给定--scopetenant时其余任何附加参数都被拒绝。access-scope-get则是无 body/无 query 的 GETGET .../apps/{app_id}/access-scope--app-id必填。3.2html-publish目录 walker 与信封式校验实现见 shortcuts/apps/apps_html_publish.go。--path接受单个index.html文件或包含index.html的目录dry-run 会输出 walker 清单file_count、total_size_bytes、files列表。关键设计决策隐藏文件被有意纳入打包清单design decision空目录 / 缺少index.html时dry-run 在信封的validation_error字段中报告ensureIndexHTML要求目录根下或单文件名为index.htmldry-run 仍以 exit 0 退出——这是仓库约定的advisory preview语义不阻断Validate 阶段还会做敏感文件扫描--path内含.env、.npmrc、.aws/credentials等凭据文件时直接拒绝除非显式--allow-sensitivemaxSensitiveListInError 5控制错误消息内联清单条数客户端侧还有多层大小护栏单.html文件 10MB、解压前原始总量 200MB防 decompression bomb、打包后 tar.gz 20MB对齐 OAPI 设计约束。Execute 的真实链路是三步GET pre_release获取 TOS 预签名上传 URL 与tos_path→ 客户端直接 PUT tar.gz 到 TOS →POST release-create携带tos_path触发部署。dry-run 将这三步以占位符形式呈现PUT presigned_upload_url、POST .../release-createbody{tos_path: from pre_release response}。htmlPublishableAppTypes限定只有html/modern_html类型应用可走此通道frontend/full_stack会被预检拒绝并提示改用release-create。四、文件管理三步直传与 download_url 往返4.1file-uploadpre-upload → PUT → callback 三步直传实现见 shortcuts/apps/apps_file_upload.go。单文件上限 100MB对齐 miaoda。上传链路POST /apps/{app_id}/storage/file_pre_uploadbody{file_name, file_size, content_type}→ 返回{upload_url, upload_id}客户端 PUT 文件字节到预签名 upload_url取响应ETag——注意Content-Disposition会透传原始文件名先经sanitizeUploadFileName去除 TOS 非法字符[:\/*?|,;]再做 encodeURIComponent空名兜底download_file点开头前置下划线防隐藏文件语义这是上传后文件名不变的关键POST /apps/{app_id}/storage/file_upload_callbackbody{upload_id, etag}→ 返回文件元数据。dry-run 侧两个测试分别验证绝对本地路径的接受与 basename 派生不真正上传、缺失源路径在预览前被拒绝exit 2。live 工作流TestAppsFileUploadLiveWorkflow由LARK_CLI_E2E_APPS_FILE_APP_ID门控完成真实上传、file-get读回元数据、file-delete清理三步闭环。4.2file-get/file-sign/file-downloaddownload_url 往返证明TestAppsFileDownloadURLRoundTripLive证明平台签发的download_url可以在任何接受--path的位置使用上传文件 → 读回其真实download_url而非手工构造→ 分别喂给file-get、file-sign、file-download断言三者都解析到真实path且下载字节一致。负数用例防止兼容性退化成什么都接受不存在的文件在普通 path 与 download_url 两种形态下都必须返回not_found。由于路径解析发生在服务端CLI 原样转发--path这类回归只有 live 调用才能捕获——这也是文档将其标注为 live-only 的原因。五、Git 凭证三命令一个 API 命令 两个本地命令Git 凭证域是混合形态的典型案例实现见 shortcuts/apps/git_credential.gogit-credential-initAPI 本地副作用dry-run 验证GET /open-apis/spark/v1/apps/{app_id}/git_info无 bodyquery 携带app_id元数据并列出本地副作用清单保存 PAT 到系统凭据库、写 app 作用域元数据、配置 URL 作用域的 Git credential helper、返回 commit 作者信息。真实执行时会签发短期仓库 PAT因此 live 被阻断。git-credential-list纯本地只读不带--app-id扫描 CLI 配置目录下所有 app 存储目录报告app_id、仓库 URL、状态——绝不暴露 PAT 或过期时间gitCredentialListPayload只输出三个字段。本地 E2E 在隔离配置目录下验证。git-credential-remove纯本地清理--app-id必填删除 app 作用域元数据、keychain 中的 PAT 与全局 git config 中的 helper。本地 E2E 验证隔离配置目录下的清理。此外还有一个刻意不走 shortcut JSON 信封的隐藏命令git-credential-helper get|store|eraseInstallOnApps直接挂到 cobra 父命令下因为它必须直接讲 Git 的 stdin/stdout 协议。这正是文档中本地 E2E only无 dry-run API 因为命令是本地只读/清理注释的由来。六、角色管理与协作者管理契约形状 确定性校验 高风控6.1role-*九个命令覆盖文档指出role-list、role-get、role-create、role-update、role-delete、role-member-list、role-member-add、role-member-remove、role-match-list共 9 个角色快捷命令。请求/响应字段严格遵循 API 契约name、role_id、users、departments、chats、target_user_id、roles。实现见 shortcuts/apps/apps_role.gorole-list--name精确过滤服务端分页按 100 一批扫描后本地再应用--page-size/--page-token--page-size默认 201-100--page-token是上一个响应返回的整数 offset映射到服务端参数limit/offsetrole-createPOST /roles--name必填--role-id可选[A-Za-z0-9_-]{1,64}--name的必填校验放在 Validate 以返回不要从 --description 推断角色名的命令专属提示role-updatePATCH /roles/:role_id只发变更字段role-deleteDELETE /roles/:role_id高风控确认role-match-listPOST /user_role_listbody 为target_user_id无role_id响应字段是roles。TestAppsRoleManagementDryRun_RequestShapes钉死 9 个命令的请求形状TestAppsRoleManagementValidation做确定性类型校验非法 role ID、页边界/令牌、缺更新字段、缺成员输入、--all冲突、缺--user-id。三个 fixture 门控的 live 工作流各有分工TestAppsRoleManagementLiveWorkflowLARK_CLI_E2E_APPS_ROLE_ID拒绝在选定成员已存在时运行只变更该成员、清理时只移除该成员绝不改动共享角色定义或清除无关成员TestAppsRoleLifecycleLiveWorkflow创建唯一命名的瞬态角色 → 独立读回 → 更新再读回 → 添加 fixture 成员 → 清空所有成员并证明角色仍存在 → 删除并验证目标role_id已不存在。清理在创建前就武装好只用环境提供的测试标识TestAppsRoleMatchListLiveWorkflow额外要求LARK_CLI_E2E_APPS_ROLE_MATCH_READY1复用LARK_CLI_E2E_APPS_ROLE_ID提供的同一隔离角色同样要求基线时用户不存在、清理时只移除自己添加的用户。6.2member-*六个协作者命令成员域Miaoda 协作者的类型化外部 ID 投影是其最大特点见 shortcuts/apps/apps_member_common.goCLI 输入--member-type投影为 API 字段openiduser_open_idopenchatchat_idopendepartmentiddepartment_id枚举定义memberWriteTypes [openid, openchat, opendepartmentid]memberListTypes [user, department, chat]memberRoles [view, edit, full_access]。member-list支持--roleview/edit/full_access与--member-typeuser/department/chat过滤返回全部直接协作者且无分页。member-add/member-update/member-remove均为high-risk-writeRisk 级别接受类型化外部 IDmember-update是 PATCH 仅所选协作者且--perm必填member-remove走POST /members/remove不接受原始/内部数字 ID。member-settings-get是无 body 的 GETmember-settings-set是外部访问、链接分享、协作者管理、评论四字段的部分 PATCH。围绕高风控与校验的四个测试尤其体现工程严谨性TestAppsMemberHighRiskWritesRequireYesButDryRunDoesNot四个写命令add/update/remove/settings-set的 live 执行都要求显式确认--yes但--dry-run仍可直接检视——风险确认与可检视性解耦TestAppsMemberValidationFailuresAreStructured类型化 ID 错配如openid传了 chat id、非法 settings 枚举、空 settings 更新均返回确定性校验信封TestAppsMemberUnsupportedWriteFlagsAreNotRegisteredexternal_invite与copy_download_by的读取仍保留但其不支持的 setter 旗标在真实 CLI 命令中不存在传入会被当作未知旗标拒绝BOE live 验证覆盖了 user/department/chat 三类成员、role/type 过滤、四字段组合写/读回/回滚、no-op、非法枚举与只读错误。七、export响应 Content-Type 门控的特殊成员export是唯一在 25 命令分母之外的成员文档明确标注 added outside the 25-command denominator它的测试TestAppsExportContentTypeE2E验证的是响应处理而非请求形状——因为六个用例的请求完全相同只有响应不同dry-run 无法覆盖。测试针对本地 CONNECT 终结的 HTTPS 网关archive 以application/x-zip-compressed、binary/octet-stream、application/force-download或无 Content-Type送达时字节级落盘而以application/json或application/problemjson返回的错误信封会令命令失败、不写文件并透出服务端原因。实现上采用JSON 黑名单而非 archive 白名单的门控策略见 shortcuts/apps/apps_export.go 相关逻辑与 tests/cli_e2e/apps/apps_export_content_type_test.go。八、app-id 三态辨析not_found / permission_denied 的边界守卫TestAppsFileAppIDStatesDryRun/TestAppsFileAppIDNotFoundLive/TestAppsFileNoPermissionLive三个用例把曾经只用一个错误区分的三个状态彻底拆开这是本报告中最值得细读的设计从未成为过 app id 的输入meta token、page token、裸数字 ID在Validate阶段即被拒绝exit 2带指向get的提示因此 dry-run 半边不需要后端格式合法但未分配真实应用的 app id语法上通过只能 live 判定且断言刻意取反——它绝不能返回authorization/exit 3那会把调用者引向申请一个无济于事的访问权限同一调用形状下的真实应用必须成功因此该用例不可能靠全盘拒绝蒙混过关调用者无角色的应用LARK_CLI_E2E_APPS_NO_PERMISSION_APP_ID必须持续报告permission_denied/exit 3防止过度纠正把真实的权限失败扫进not_found。九、覆盖缺口与刻意留白文档明确列出 live 覆盖的边界这些是有意为之而非疏漏通用应用创建 live E2E 未实现apps没有delete端点create-and-cleanup 工作流会泄漏租户状态文件上传与选定角色 live 工作流保持 fixture 门控各自使用专用 fixture并清理自己变更的资源Miaoda 协作者 live 覆盖目前是手动而非默认 CI 自动化其写用例需要隔离的 user/department/chat fixtureBOE 契约与清理工作流已端到端演练过user/department/chat CRUD 于 2026-08-04 验证未分页列表与 settings get/set、只读错误、组合写、读回、回滚于 2026-08-06 复核。对希望为这套覆盖体系新增用例的开发者建议遵循同样的分层先用 dry-run 钉死请求形状与 Validate 拒绝路径无需后端、可在默认 CI 运行再为会变更外部状态的命令设计创建 → 独立读回 → 变更 → 清理的 fixture 门控 live 工作流并确保清理在任何断言失败路径上都已武装。十、完整命令覆盖表下表完整继承覆盖文档的 251 命令清单供快速检索每个命令的测试用例与参数形状状态命令类型测试用例关键参数形状未覆盖原因✓apps createshortcutapps_create_dryrun_test.go::TestAppsCreateDryRun--name、--app-type必填、大小写敏感、html/frontend/full_stack、--description、--icon-urllive 阻断无 delete 清理✓apps updateshortcutapps_update_dryrun_test.go::TestAppsUpdateDryRun--app-id--name/--description至少一个live 阻断无 delete✓apps listshortcutapps_list_dryrun_test.go::TestAppsListDryRun--keyword--ownershipall/mine/shared--app-typehtml/frontend/full_stack--page-size默认 20--page-token游标live 阻断需租户 fixture✓apps access-scope-setshortcutapps_access_scope_set_dryrun_test.go::TestAppsAccessScopeSetDryRun--scopespecific/public/tenant--targetsJSON--apply-enabled --approver--require-loginlive 阻断需真实 open_ids✓apps access-scope-getshortcutapps_access_scope_get_dryrun_test.go::TestAppsAccessScopeGetDryRun--app-idlive 阻断依赖 access-scope-set 状态✓apps html-publishshortcutapps_html_publish_dryrun_test.go::TestAppsHTMLPublishDryRun--app-id、--path文件或含 index.html 的目录live 阻断真实上传有副作用无回滚 API✓apps file-uploadshortcutapps_file_upload_dryrun_test.go::TestAppsFileUploadDryRun_AcceptsAbsoluteHostPath / _RejectsMissingHostPathapps_file_upload_live_test.go::TestAppsFileUploadLiveWorkflow--app-id、--file绝对或相对本地路径live 工作流用LARK_CLI_E2E_APPS_FILE_APP_ID读回元数据并删除上传文件✓apps file-getshortcutapps_file_download_url_live_test.go::TestAppsFileDownloadURLRoundTripLive--app-id、--pathpath字段或平台签发download_url仅 livefixture 门控作为 download_url 往返的一部分覆盖✓apps file-signshortcutapps_file_download_url_live_test.go::TestAppsFileDownloadURLRoundTripLive--app-id、--path同上两种形态断言解析后的 path 与非空 signed_url仅 live签名 URL 无法从 dry-run 请求形状验证✓apps file-downloadshortcutapps_file_download_url_live_test.go::TestAppsFileDownloadURLRoundTripLive--app-id、--path同上两种形态、--output相对工作目录仅 live断言下载字节错误 body 也会 exit 0✓apps git-credential-initshortcutapps_git_credential_dryrun_test.go::TestAppsGitCredentialInitDryRun--app-iddry-runGET /open-apis/spark/v1/apps/{app_id}/git_infolive 阻断签发短期仓库 PAT✓apps git-credential-listshortcutapps_git_credential_local_test.go::TestAppsGitCredentialListLocalE2E无--app-id扫描所有本地 app 存储目录报告 app_id、仓库 URL、状态无 PAT/过期仅本地 E2E命令为本地只读✓apps git-credential-removeshortcutapps_git_credential_local_test.go::TestAppsGitCredentialRemoveLocalE2E--app-id删除本地元数据、keychain PAT 与 Git config仅本地 E2E命令为本地清理✓apps role-listshortcutapps_role_management_test.go::TestAppsRoleManagementDryRun_RequestShapes--app-id--name→name--page-size→limit--page-token→offsetlive 依赖角色能力 app fixture✓apps role-getshortcutapps_role_management_test.go::TestAppsRoleManagementDryRun_RequestShapesGET /roles/:role_id无 body/querylive 由 fixture 门控角色工作流覆盖✓apps role-createshortcutapps_role_management_test.go::TestAppsRoleManagementDryRun_RequestShapesTestAppsRoleLifecycleLiveWorkflowPOST /rolesname必填role_id可选瞬态 live 角色被独立读回✓apps role-updateshortcutapps_role_management_test.go::TestAppsRoleManagementDryRun_RequestShapesTestAppsRoleLifecycleLiveWorkflowPATCH /roles/:role_id仅变更字段瞬态 live 角色更新被独立读回✓apps role-deleteshortcutapps_role_management_test.go::TestAppsRoleManagementDryRun_RequestShapesTestAppsRoleLifecycleLiveWorkflowDELETE /roles/:role_id高风控确认live 流程验证删除后目标 role_id 不存在✓apps role-member-listshortcutapps_role_management_test.go::TestAppsRoleManagementDryRun_RequestShapesGET /member_list可选member_typeuser/department/chat无分页live 由 fixture 门控角色工作流覆盖✓apps role-member-addshortcutapps_role_management_test.go::TestAppsRoleManagementDryRun_RequestShapesPOST /member_addbodyusers/departments/chatsopen_id 数组live 由 fixture 门控角色工作流覆盖✓apps role-member-removeshortcutapps_role_management_test.go::TestAppsRoleManagementDryRun_RequestShapesTestAppsRoleManagementLiveWorkflowTestAppsRoleLifecycleLiveWorkflowPOST /member_removebody 数组或alltrue高风控确认显式移除与--all均有 fixture 门控 live 读回✓apps role-match-listshortcutapps_role_management_test.go::TestAppsRoleManagementDryRun_RequestShapesTestAppsRoleMatchListLiveWorkflowPOST /user_role_listbodytarget_user_id无role_id响应字段roles仅当LARK_CLI_E2E_APPS_ROLE_MATCH_READY1自动运行✓apps member-listshortcut../dryrun/apps_member_dryrun_test.go::TestAppsMemberDryRun--app-id可选--roleview/edit/full_access--member-typeuser/department/chat无分页BOE live 已验证✓apps member-addshortcut../dryrun/apps_member_dryrun_test.go::TestAppsMemberDryRunTestAppsMemberHighRiskWritesRequireYesButDryRunDoesNot--member-typeopenid/openchat/opendepartmentid --member-id--perm可选通知BOE live 已验证user/department/chat 隔离清理✓apps member-updateshortcut../dryrun/apps_member_dryrun_test.go::TestAppsMemberDryRunTestAppsMemberHighRiskWritesRequireYesButDryRunDoesNot类型化外部 ID 必填--permPATCH 仅所选协作者BOE live 已验证读回 清理✓apps member-removeshortcut../dryrun/apps_member_dryrun_test.go::TestAppsMemberDryRunTestAppsMemberHighRiskWritesRequireYesButDryRunDoesNot类型化外部 IDPOST /members/remove无原始/内部数字 IDBOE live 已验证absence 读回✓apps member-settings-getshortcut../dryrun/apps_member_dryrun_test.go::TestAppsMemberDryRun--app-idGET 无 bodyBOE live 已验证六项 settings 全返回✓apps member-settings-setshortcut../dryrun/apps_member_dryrun_test.go::TestAppsMemberDryRunTestAppsMemberHighRiskWritesRequireYesButDryRunDoesNotTestAppsMemberUnsupportedWriteFlagsAreNotRegistered外部访问/链接分享/协作者管理/评论的部分 PATCH不支持的--external-invite/--copy-download-by未注册BOE live 已验证组合写/读回/回滚/no-op/非法枚举/只读错误✓apps exportshortcutapps_export_content_type_test.go::TestAppsExportContentTypeE2E--app-id--output响应 Content-Type 门控JSON 黑名单而非 archive 白名单在 25 命令分母之外仅覆盖响应处理结语这份覆盖报告展示的是一种可复用的 CLI 测试分层方法论dry-run 负责把每个命令的请求契约与参数校验钉死在默认 CI 中live 工作流用 fixture 门控和严格的创建-读回-变更-清理闭环证明真实端到端行为本地 E2E 覆盖无网络的本地副作用命令。对apps域的 25 个命令而言这套体系既保证了 Agent/开发者对请求形状的确定性预期又通过刻意留白 边界守卫如 not_found 与 permission_denied 的区分、高风控写命令的确认门控、unsupported flag 不注册避免了测试对租户状态的污染与对错误语义的误判。深入阅读 tests/cli_e2e/apps 下的测试与 shortcuts/apps 下的实现是理解 Lark CLI 命令契约最直接的一手资料。【免费下载链接】cliThe official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200 commands and 20 AI Agent Skills.项目地址: https://gitcode.com/gh_mirrors/cli414/cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考