CLI 命令参考

非 Turbo 任务沿用相同的表达方式：根命令进入 fnos-dsh-cli，命令模块负责交互和参数分支，最后执行实际工具并汇总状态。

各命令的调度图见下。Turbo 相关任务的完整说明见 Turbo 任务。

version

版本维护的统一入口：项目与全部插件同号推进，版本计算与文件替换由 bumpp 原生档位完成（patch/minor/major，语义见版本管理）。

flowchart TD
  command["pnpm run version -- <档位>"]
  cli["fnos-dsh-cli version"]
  guard{"档位与版本形态校验<br/>（拒绝预发布段 / baseline 仅限 major）"}
  dry["bumpp 干跑求目标版本"]
  syncCheck{"插件与项目同号？"}
  confirm["确认发布计划"]
  align["对齐版本文件与基线字样"]
  bump["bumpp 替换项目版本文件"]
  plugins["插件同号写入 + 副本/文档/安装命令同步"]
  commit["git commit + 本地 Tag"]
  status{"版本维护成功？"}
  result["是：返回成功"]
  fail["否：返回非零状态"]

  command --> cli --> guard --> dry --> syncCheck
  syncCheck -->|否| fail
  syncCheck -->|是| confirm --> align --> bump --> plugins --> commit --> status
  status -->|是| result
  status -->|否| fail

项目/FPK 版本更新根 package.json、docs/package.json、packages/**/package.json、tooling/fnos-dsh-cli/package.json、应用 manifest（version 与 desc 基线字样）和文档中的版本示例；插件直接沿用项目目标版本，并同步发布清单、插件总览与安装命令。默认创建提交和 v<版本号> Tag。

不会自动 push。完整流程见版本管理。

release:notes

读取当前 Tag，判断是否为预发布，再交给 changelogithub 生成 Release 说明。

flowchart TD
  command["pnpm run release:notes"]
  cli["fnos-dsh-cli release:notes"]
  tag["读取 GITHUB_REF_NAME"]
  prerelease{"预发布 Tag？"}
  flag["补充 --prerelease"]
  changelog["执行 changelogithub"]
  github["创建或更新 GitHub Release"]
  status{"Release 成功？"}
  result["是：返回成功"]
  fail["否：返回非零状态"]

  command --> cli --> tag --> prerelease
  prerelease -->|是| flag
  prerelease -->|否| changelog
  flag --> changelog --> github --> status
  status -->|是| result
  status -->|否| fail

build:gateway

仅供 CI 或网关构建使用，不经过交互层。

flowchart TD
  command["fnos-dsh-cli build:gateway"]
  cli["命令模块 action"]
  turbo["turbo run build:app --filter=@tnnevol/fnos-gateway"]
  gateway["执行 Gateway package.json 的 build:app"]
  status{"Gateway 构建成功？"}
  result["是：返回成功"]
  fail["否：返回非零状态"]

  command --> cli --> turbo --> gateway --> status
  status -->|是| result
  status -->|否| fail

构建 fn-deepseek-harness 的 FPK 时，CLI 会先调用这个入口产出网关 bundle，再执行 fnpack build。

相关页面

• Turbo 任务
• 命令与脚本
• 版本管理
• 发布流程