CLIAI 技能【免费下载链接】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点击查看免费下载apps init是 lark-cli 将妙搭Spark/Miaoda应用从云端拉到本地、并准备好可开发环境的核心命令它一次完成 Git 凭证初始化、仓库 clone、切换到工作分支、代码脚手架生成/同步以及本地环境变量拉取。本文以lark-cli apps init --help与 shortcuts/apps/apps_init.go 的源码实现为准完整讲解该命令的参数、内部执行流程、JSON 输出契约以及 Agent 使用时的目录选择与已初始化短路等关键规则读完你既能手动完成一次本地初始化也能理解它在「本地开发 vs 云端会话」两条开发路径中的定位。什么时候用、什么时候不用init的唯一职责是把妙搭应用源码拉到本地并准备开发环境。它适合以下场景新建应用后要走本地开发用本地 IDE / code agent 写代码已有应用本地还没有源码想拉下来继续开发想拿到一份可继续开发的源码工作区注意只要一份快照、不做本地开发时应改用export下载 zip见 lark-apps-export.md。不要用init的场景用户只是要让云端妙搭 Agent 生成/迭代应用对话式开发用户自己不碰代码。这时应走云端会话链路session-create→chat→session-get见 lark-apps-cloud-dev.md而不是初始化本地仓库。开发方式本地 vs 云端取决于用户对谁来写代码的偏好与应用复杂度、要不要数据库无关——在用户未表达偏好前应先询问不能擅自默认走init。这条何时用的判定在 SKILL.md 的「选择开发路径」表中有更细的规则新建应用先定app_typefull_stack/frontend/html和开发方式两件正交的事修改已有应用则先按app_id获取规则定位到应用再用init。命令骨架与参数lark-cli apps init --app-id app_id [--dir dir] [--source-path path] [--dry-run] [--format json] [--as user]参数必填说明--app-id是妙搭应用 IDapp_开头。缺失时返回结构化校验错误cli_开头的飞书应用 ID 或 meta_token 会被拒绝--dir否clone 目标目录相对或绝对路径均可省略时默认./app-id--source-path否已有源码文件路径例如 Agent 产出的 HTML 输出在初始化时并入新项目--dry-run否只打印执行计划不真正执行 git / npx--format否结构化输出格式json等--as否身份选择妙搭应用是用户资产固定--as userinit的固定行为checkout 分支固定为sprint/default源码中defaultInitBranch常量见 apps_init.go执行过程会初始化 Git 凭证、clone 仓库、切到工作分支、生成/同步本地项目。两点参数校验细节有源码佐证--app-id在声明中故意不设Required:true而是放在Validate里做非空与格式校验这样缺参会返回结构化错误 envelope 而非 cobra 的纯文本错误保证错误也能被 Agent 机器解析见 apps_init.go 及validateRealAppID对非app_前缀的拒绝逻辑common.go。--dir会拒绝所有控制字符含 tab / 换行防日志注入并检查目标目录是否为符号链接、是否非空、是否已属于其他应用详见下文「目录护栏」。使用示例# 基础用法克隆到默认目录 ./app_id lark-cli apps init --app-id app_xxx # 指定相对目录 lark-cli apps init --app-id app_xxx --dir ./my-app # 指定绝对目录 lark-cli apps init --app-id app_xxx --dir /absolute/path/my-app # 先看计划不执行 lark-cli apps init --app-id app_xxx --dir ./my-app --dry-run # 带已有源码并入例如 Agent 已生成 HTML lark-cli apps init --app-id app_xxx --dir ./my-app --source-path /tmp/agent-output在完整本地开发链路中init的位置是full_stack 示例见 lark-apps-local-dev.mdlark-cli apps create --as user --name 审批系统 --app-type full_stack \ --description 支持登录、提交申请、多级审批、状态查询 lark-cli apps init --as user --app-id app_xxx --dir ./approval-app cd ./approval-app npm install npm run dev # 开发完成后git commit - git push origin sprint/default - release-create - release-get注意release-create部署的是远端sprint/default上已 push的代码不是本地工作区——没有 commit push 的改动不会进入发布。内部执行流程一次init到底做了什么从 appsInitExecute 可以完整还原一次真实初始化的调用链解析目标目录由--dir或默认./app-id算出绝对路径拒绝控制字符resolveTargetPath。异应用目录护栏若目标目录已存在且含.spark/meta.json校验其app_id与本次--app-id一致不一致或 meta.json 损坏无法确认则拒绝复用并提示换目录ensureInitDirMatchesApp。查询应用类型调用queryAppTypeGET/apps/{id}需要spark:app:readscope声明为 ConditionalScopes拿到app_type决定后续策略查询失败不致命。已初始化短路目录已含.spark/meta.json时跳过 clone/scaffold/commit只做一次 env-pull 刷新详见下一节。前置检查确认 PATH 上有git与npxNode.js 提供缺失则报 failed-precondition 并给安装提示。空目录检查目标目录必须不存在、为空、且不是符号链接ensureEmptyDir用Lstat拒绝 symlink。签发 Git 凭证内部调用self apps git-credential-init --app-id id --format json解析出repository_url与提交作者信息issueCredentials→parseCredentialInitEnvelope并校验 URL 必须是http(s)://拒绝ext::/file:///ssh://等危险 transportvalidateRepoURLScheme。clone 切分支git clone -- repository_url dir然后git checkout sprint/default。保证提交身份若本地/全局/系统 git config 均解析不到user.name/user.email则写入仓库级 local config 的兜底身份lark-cli-bot lark-cli-botmiaoda.com已有身份如开发者全局配置会被尊重、不覆盖ensureGitIdentity/ensureGitConfigValue见 apps_init.go。脚手架生成/同步runScaffold判断仓库是否为空git ls-files只列出种子README.md或为空视为空仓库空仓库 → 运行npx -y --prefer-online lark-apaas/miaoda-clilatest app init --app-type appType --app-id idappType缺失时兜底full_stack生成类型记为init非空仓库 → 运行npx ... app sync 修补.spark/meta.json的app_id 按需npx ... skills sync --local当.agent/skills/steering不存在时生成类型记为upgrade。提交与推送commitAndPushIfDirty仅当工作区有变更时执行。init路径按 porcelain 输出把变更分为「应用代码」与「应用配置.spark/、.agent/」两组分别提交chore: initialize app project code/chore: initialize app configupgrade路径单次提交chore: initialize app repository提交使用git commit --no-verify跳过脚手架仓库本地 hooks最后git push origin sprint/default。拉取本地环境变量成功后调用self apps env-pull --app-id id --project-path dir --format json失败非致命见下节。每一步的进度都会以→前缀写到stderrstdout 始终保留给 JSON envelopeinitLogf的注释明确这一点见 apps_init.go。app_type 策略差异appTypePoliciesapps_init.go按应用类型微调流程app_type跳过依赖安装跳过 env-pull跳过 skills sync跳过 app syncmodern_html/html✔✔✔✔frontendvite-react————full_stack含未列出的类型————即静态 HTML 站点不需要装依赖、不需要启动期环境变量、不需要 steering skills 同步也没有 app sync而frontend因为需要构建步骤显式不列入跳过名单走与full_stack相同的零值策略装依赖、拉环境变量、同步 skills。init自身不做 app_type 到具体技术栈的翻译——映射是下游工具miaoda-cli的职责scaffoldInitArgs注释见 apps_init.go。输出契约如何机器化解析结果init面向 Agent / 脚本使用输出契约非常明确真跑时stdout 是 JSON envelopestderr 是-/→进度行。成功读 stdout失败解析 stderr 末尾的 JSON 错误。成功普通初始化时读取data.clone_path、data.branch、data.committed、data.pusheddata.repository_url已脱敏只用于展示不要当作凭据使用。一个典型成功 envelope 的字段来自 appsInitExecute{ ok: true, data: { app_id: app_xxx, repository_url: https://…已脱敏不包含 token, branch: sprint/default, clone_path: /abs/path/my-app, scaffold: init, committed: true, pushed: true, app_type: full_stack, env_pulled: true, env_file: /abs/path/my-app/.env.local, message: Repository initialized. You can start developing. } }字段语义branch固定sprint/defaultscaffoldinit空仓库全新建模或upgrade非空仓库同步committed/pushed工作区有变更时提交并推送为true工作区干净则跳过 commit/pushcommitAndPushIfDirty返回false,falseenv_pulled/env_file/env_pull_errorenv-pull 的结果。env-pull 失败不致命——主流程仍算成功message会提示用lark-cli apps env-pull --app-id id重试见 apps_init.go注意envelope不会回显任何环境变量 key / value防止 token / 数据库凭据泄漏到日志或 CI 输出要看实际值请直接读项目根下的.env.local。stderr 错误侧的结构化 envelope 形如{ok:false,error:{type:…,message:…}}Agent 应优先转述error.hint/error.message给用户而不是原样甩 JSON。scaffoldalready_initialized已初始化仓库的短路行为当目标目录已含.spark/meta.jsonisAlreadyInitialized以该文件存在与否判定与其中app_id值无关时init走友好的短路分支apps_init.go跳过 clone / scaffold / commit但仍会执行一次 env-pull刷新本地环境变量确保重复执行能拿到最新启动期环境变量输出包含scaffold: already_initialized、env_pulledenv-pull 成功时含env_file失败时含env_pull_error且退出码仍为 0非致命约定此时通常没有repository_url/branch字段人类可读输出会打印✓ Already initialized at dir与「仓库已初始化完成可以开始开发了」。Agent 遇到该结果时的正确做法告知用户「仓库已初始化本地环境变量已刷新可直接开发」不要误报失败也不要重复 clone。另一个细节点当.spark/meta.json存在但缺失或为空app_id时init会视为上次初始化中断留下的半成品非空仓库的app sync路径会自动修补写入app_idensureMetaAppID见 apps_init.go而如果它是另一个应用的工程则直接拒绝并提示换目录。--dry-run只打印计划不执行--dry-run通过DryRun回调apps_init.go输出一份计划清单不会执行任何 git / npx 子进程。计划内容包括credential_init将要执行的apps git-credential-init命令checkoutgit checkout sprint/defaultscaffold空仓库走app init、非空走app sync meta 修补 skills sync 的说明commit_push有变更时git add -A commit push 的条件说明templateapp_type来源由 queryAppType 推导兜底full_stackenv_pull初始化成功后将要执行的env-pull命令clone/clone_pathclone 命令与目标路径。dir_error字段是 dry-run 的关键信号当目标目录不可用已存在且非空、是符号链接、或属于另一个应用时计划输出会带上dir_error可能还有app_id_mismatch。此时真跑前先让用户换一个目录不要直接执行。Agent 规则强调新建应用做本地初始化时若选定的目标目录已存在不要复用改用不冲突的目录名——已获预授权用户明确放手做/别问/直接做时自动追加后缀如-2否则先向用户确认目录名。Agent 使用规则汇总把 lark-apps-init.md 中的 Agent 规则与源码行为合并目标目录前置条件必须不存在、为空目录、或已含.spark/meta.json且其app_id与--app-id一致的已初始化仓库其余情况一律换目录。已初始化目录跳过 clone/scaffold但仍执行一次 env-pull 刷新告知用户仓库已初始化本地环境变量已刷新可直接开发。输出转述原则init的输出没有必要原样复述告诉用户 clone path、分支和下一步即可比如cd clone_path后npm install npm run dev。目录冲突新建应用本地初始化时目标目录已存在 → 不复用预授权时自动追加-2等后缀否则确认目录名。身份与 scope妙搭应用是用户资产统一--as userinit依赖spark:app:read声明为条件 scope缺权限时按 lark-shared/SKILL.md 执行lark-cli auth login --domain apps授权后只恢复原操作不扩展任务范围。失败处理Git 认证失败 / 401 / 403 / credential helper 缺失 / token 过期时重新执行git-credential-init --app-id id覆盖本地配置再重试刷新也失败则停止并向用户报告。不要手动复制 token、不要把 token 拼进 remote URL。分支纪律不要 push / force-pushmain——main是发布态快照由release-create成功后服务端推进直推 / force-push 会被服务端护栏拒绝工作分支只允许sprint/defaultfast-forward。初始化完成后的下一步init只是本地开发的起点完成后通常衔接读取仓库内领域 skillcat project-path/.agents/skills/plugin-guide/SKILL.md不存在则跳过涉及自动化业务代码时再看.agents/skills/下的trigger-guideinit只负责准备本地项目不能替代领域 guide见 lark-apps-local-dev.md启动开发npm install npm run dev脚手架在本地启动时会自动后台拉取环境变量一般无需手动env-pull仅当绕过npm run dev直接node/ IDE debug或.env.local损坏/丢失时才手动补跑见 lark-apps-env-pull.md发布上线git commit→git push origin sprint/default→release-create→release-get轮询到finished拿online_url。若想逐步手动控制而不是走init一站式编排也可以先lark-cli apps git-credential-init --app-id id拿repository_url再用原生git clone/git checkout sprint/default见 lark-apps-git-credential.mdinit内部正是这条链路的自动化封装。测试与验证该命令有完整的单元测试保障apps_init_test.go 覆盖了目录解析控制字符拒绝、默认目录、symlink 目标拒绝、already_initialized判定含跨 app_id 场景、命令声明init/write风险 /HasFormat、credential envelope 解析、env-pull 错误 envelope 解析、porcelain 路径分类与分提交逻辑等命令运行器可注入 fake 以做子进程级断言。想深入源码的读者可以以此为入口逐步跟进appsInitExecute的主流程。提示本文以当前仓库源码与lark-cli apps init --help的实际行为为准运行环境需预装 Git 与 Node.js提供 npx否则init会以 failed-precondition 报错并给出安装指引。赞分享CLIAI 技能【免费下载链接】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点击查看免费下载相关推荐3步解锁本地服务全球访问Rust驱动的tunnelto实战指南3步解锁本地服务全球访问Rust驱动的tunnelto实战指南 还在为本地演示困境而烦恼吗当你需要向同事展示本地开发的前端页面或是让远程团队测试本地ACLIAI 技能openUBMC本地环境初始化实战指南openUBMC本地环境初始化实战指南 本文详细介绍了在Ubuntu 24.04系统上搭建openUBMC开发环境的完整流程包括系统要求与准备、init.py构建工具嵌入式qmd完全指南如何用这款轻量级CLI工具打造你的本地知识库搜索引擎qmd完全指南如何用这款轻量级CLI工具打造你的本地知识库搜索引擎 在信息爆炸的时代如何高效管理和检索个人知识库成为每个开发者和知识工作者的挑战。qmdQ人工智能大模型RAG搜索引擎本地部署MCP 服务CLI上一篇5个关键步骤部署Kimi K2大模型从零开始构建本地AI助手下一篇IsaacLab 电机执行器配置指南选对模型、配准参数仿真结果才可信创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
