SuperAPI AI 工具集

fcode-release

通用与其它

查看项目

更新于 10-16 08:37

技能介绍

用途:把 Factorial Code 应用的代码从 dev-… 工作区提升到 prod-… 工作区,使用 CLI remotes 完成。输入为两个工作区 slug(dev-… 源、prod-… 目标)。此流程只更新 prod 的当前(未版本化)代码;发布工作区版本与移动 stable 别名属于另一个平台发布步骤,除非被明确要求,不应在此流程中运行 settings:versions:* 或移动 stable。

主要能力与用法:每次发布都需以 fcode-code-validation 作为门禁。基本步骤:收集两个 slug;确保 dev 工作区有最新的 ✅ APP_VALIDATION_REPORT.md(缺失或过期则先运行 fcode-code-validation,出现 ❌ 时列出 Blockers 并拒绝,只有用户显式覆盖才继续);然后执行 fcode clone --skipSkillsSetup dev-xxx、cd dev-xxx、fcode remote:add prod-xxx、fcode pull(强制,用于获取 prod 当前元数据)、fcode add(注册 prod 尚无的资源);用 fcode status 向用户汇总推送将在 prod-xxx 中改变的进程、模块、变量、设置,等待显式确认后执行 fcode push;最后报告结果并提醒平台发布是单独步骤。

限制与注意事项:推送 prod 需要写权限,只有操作员和该应用 Factorial 团队管理员可推送到 prod-… 工作区;若刚请求发布后访问被拒,运行 fcode login 重试。推送前必须有 ✅ 验证,存在 Blockers 时拒绝推送,只有用户显式说“push anyway despite the Blockers”才继续并记录门禁被覆盖。最终 fcode push 前必须确认,因为 prod 代码服务线上安装。绝不使用 --force;若 fcode pull 或 fcode push 报告本地与 prod 分叉,应停止、展示分叉内容并询问用户。remote:add 之后的 fcode pull 是强制的,否则会用过期设置覆盖 prod。两个 slug 是编码令牌(dev-…/prod-…),不是应用 UUID,需核对前缀,避免克隆目标与推送目标颠倒。fcode clone 失败通常意味着令牌输错或缺权限,不要盲目重试。若本地已存在 dev-xxx/,不要静默复用,应询问是从全新克隆发布(推荐)还是用现有副本,并先对其 fcode pull。