NocoBase CLI 技能安装指南nb skills install命令用法与底层实现解析【免费下载链接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobasenb skills install是 NocoBase CLInb中用于全局安装 NocoBase AI coding skills的子命令它把官方维护的 AI 编码技能包安装到当前用户环境供 AI 编码助手在 NocoBase 开发场景中使用。本文以官方命令参考文档为主体结合仓库源码命令实现、技能管理器、测试用例展开帮助你完整掌握该命令的参数、执行流程、幂等行为与故障排查方法。命令概览nb skills install用于全局安装 NocoBase AI coding skills。它有一个重要特性如果技能已经安装该命令不会执行更新——更新需使用nb skills update见 更新命令。命令定位nbCLI 的skills子命令组skills 索引文档功能将 NocoBase AI coding skills 安装到全局环境源码实现commands/skills/install.ts核心逻辑lib/skills-manager.tsnb skills install [flags]参数说明参数类型默认值说明--yes,-ybooleanfalse跳过安装确认提示--jsonbooleanfalse以 JSON 格式输出结果--verbosebooleanfalse显示详细安装输出--version 版本号string无安装指定版本的nocobase/skills包源码中提供的扩展参数详见下文前三个参数来自官方命令参考文档--version参数未出现在原文档的参数表中但在 install.ts 的 flags 定义中明确存在用于精确控制安装的版本适合需要锁定版本的 CI 或复现场景。参数行为细节源码确认确认提示不带--yes时命令会通过 inquirer 弹出确认问题默认答案为true即默认同意安装见 install.ts。加载动画与输出互斥--json与--verbose都会抑制进度加载动画shouldShowLoading !flags.json !flags.verbose见 install.ts。这保证了 JSON 输出纯净、详细模式下的完整日志不被动画覆盖。幂等提示若技能已安装命令返回noop动作并提示 already installed--verbose模式下会额外提示运行nb skills update进行刷新见 install.ts。常用示例以下示例完整继承自官方文档并补充了说明# 基本安装弹出确认提示后执行安装 nb skills install # 跳过确认直接安装适合脚本与 CI nb skills install --yes # 显示详细安装输出便于排查问题 nb skills install --verbose # 以 JSON 格式输出安装结果 nb skills install --json组合用法示例# 跳过确认并以 JSON 输出适合自动化场景 nb skills install --yes --json # 安装指定版本 nb skills install --version 1.0.4安装了什么nocobase/skills包从源码可知该命令安装的是 npm 包nocobase/skills源仓库标识为nocobase/skills见 skills-manager.tsexport const NOCOBASE_SKILLS_SOURCE nocobase/skills; export const NOCOBASE_SKILLS_PACKAGE_NAME nocobase/skills;该包内含多个独立的 skill每个 skill 是一个包含SKILL.md描述文件的目录管理器通过检查SKILL.md是否存在来识别 skill见 skills-manager.ts。NocoBase 官方 skill 名称以nocobase-前缀命名例如测试用例中出现的nocobase-env-manage见 skills-install-update-command.test.ts。安装位置与状态管理全局根目录技能被安装到 CLI 的全局 home 目录下。默认路径为~/.nocobase/global路径解析逻辑见 cli-home.tsCLI 目录名固定为.nocobase并且可以通过环境变量NB_CLI_ROOT覆盖根目录位置。对应地resolveGlobalSkillsRoot()返回~/.nocobase/global见 skills-manager.ts。目录结构安装后全局目录下会形成如下结构推断自 skills-manager.ts~/.nocobase/global/ ├── skills.json # 管理状态文件安装/更新时间、版本、skill 列表 └── cache/ └── skills/ ├── node_modules/nocobase/skills/ # 缓存的技能包 ├── pack/ # npm pack 临时目录安装后清理 └── extract/ # tarball 解压临时目录安装后清理其中skills.json记录了packageName、sourcePackage、installedAt、updatedAt、installedVersion、skillNames等字段见 skills-manager.ts是后续nb skills check/nb skills update判断状态的核心依据。底层执行流程nb skills install的完整调用链如下nb skills install └─ installNocoBaseSkills() # skills-manager.ts ├─ inspectSkillsStatus() # 检查当前安装状态 ├─ 判断是否需要安装noop 短路 ├─ prepareLocalSkillsPackage() │ ├─ npm pack nocobase/skills[version] # 下载并打包超时 120s │ └─ 校验 tarball 包名/版本并解压到缓存 ├─ npx -y skills add packageDir -g -y --skill * # 全局添加超时 120s ├─ removeObsoleteManagedSkills() # 清理过期的旧 skill └─ persistManagedSkillsState() # 写入 skills.json 并复检状态关键步骤说明依据 skills-manager.ts状态检查先调用inspectSkillsStatus()检查已安装的 skill 列表、缓存中的 skill 名、npm registry 上的最新版本等。幂等短路当满足「已安装 版本匹配未指定--version或与已装版本一致 缓存 skill 无缺失 无过期 skill」时直接返回noop不执行任何安装动作。下载与校验通过npm pack获取nocobase/skills的 tarball解压后校验包名必须为nocobase/skills且若指定了目标版本实际解压版本必须与之一致否则抛错中止见 skills-manager.ts。全局注册调用npx -y skills add packageDir -g -y --skill *将包内所有 skill 注册到全局。过期清理移除已安装但不再包含在新包中的旧 skillpickObsoleteManagedSkillNames。状态持久化将安装结果写入skills.json并返回最新状态。各步骤的超时保护见 skills-manager.tsskills list15 秒、npm view3 秒、npm pack120 秒、skills add120 秒。输出格式解析默认输出安装成功或已安装时输出简短提示--verbose模式会给出更详细的说明例如Installed NocoBase AI coding skills globally.已安装时不带--verbose只提示 already installed带--verbose会追加建议NocoBase AI coding skills are already installed globally. Run nb skills update to refresh them.JSON 输出--json模式输出结构化结果字段定义见 install.ts{ ok: true, kind: skills, action: installed, globalRoot: /home/user/.nocobase/global, workspaceRoot: /home/user/.nocobase/global, installedSkillNames: [nocobase-env-manage], installedVersion: 1.0.4, installedRef: 1.0.4 }字段含义actioninstalled本次完成安装或noop已安装未做任何事globalRoot/workspaceRoot安装根目录当前实现中两者一致installedSkillNames实际安装的 skill 名称列表installedVersion/installedRef已安装的nocobase/skills版本该 JSON 结构被测试用例所验证——skills install会将version等参数正确透传给技能管理器且--json模式下不启动加载动画见 skills-install-update-command.test.ts。与相关命令的协作nb skills install属于skills命令组与以下命令配合使用详见 skills 索引文档命令用途与原文档中相关命令的对应nb skills check检查全局技能的安装状态、是否由nb管理、是否有可用更新原文档「相关命令」nb skills install全局安装本文主题—nb skills update更新已安装的技能仅更新已存在的安装未安装时会提示先 install原文档「相关命令」nb skills remove移除由nb管理的全局技能—典型使用链路nb skills check查看状态 →nb skills install --yes首次安装 →nb skills update --yes日常升级。此外nb init初始化流程也会联动 skills 同步当 npm registry 不可访问时会跳过安装并给出提示「等 registry 可访问后再运行nb skills install即可」见 zh-CN.json。skills 管理器还内置了对 npm registry 不可用错误模式如ENOTFOUND、超时、证书错误等的识别见 skills-manager.ts。常见问题与故障排查提示已安装但不更新这是设计行为。nb skills install是幂等命令已安装时返回noop。需要升级请运行nb skills update --yes。安装超时npm pack与skills add的超时均为 120 秒。网络较慢时可先用--verbose观察卡在哪一步再考虑配置 npm 镜像后重试。registry 不可达命令依赖 npm registry 下载nocobase/skills包。网络不可达或证书异常时安装会失败可从输出中的错误提示定位管理器可识别ENOTFOUND、ETIMEDOUT、ECONNREFUSED、证书过期等模式。版本校验失败使用--version指定版本时若下载到的包版本与目标不一致命令会中止并提示实际版本避免安装错误版本。自动化场景在脚本或 CI 中建议使用nb skills install --yes跳过交互确认并搭配--json输出可解析结果。【免费下载链接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考