SuperAPI AI 工具集

fork-fleet

部署与运维

查看项目

更新于 10-15 10:06

技能介绍

用途

Fork Fleet 是面向仓库分叉群体的分歧监控技能,回答两个流行度/活跃度类技能无法回答的问题:

  • 代码分歧:哪些活跃分叉正在构建真实工作(独特提交、新增或修改的技能),值得回收到上游?
  • 配置分歧:已配置的分叉群体在哪些地方系统性地与上游的启用、变量、模型、调度默认值不一致,从而让维护者可以翻转一个分叉群体已经“投票”过的默认值?

该技能按周运行,无变化时不发送通知。

主要能力

代码分歧分支

  • 对每个活跃分叉执行一次跨仓库比较调用,返回领先/落后提交数、独特提交与变更文件。
  • 按实质加权评分:新增技能文件权重最高,其次是修改技能、独特提交、新内容、工作流/配置变更、自定义调度与星标数。
  • 将分叉标记为 PROMOTE(含至少 1 个新技能文件)、REVIEW(至少 3 个独特提交或至少 1 个修改技能)或 NOTE。
  • 对 PROMOTE 候选(上限 5 个)深度读取其独特技能的 SKILL.md,生成 1–2 句功能描述。
  • 计算周环比变化:新分叉、转为活跃、转为停滞、新技能落地、已归档/删除。
  • 输出结论行,优先级为:新上游候选、活跃群体、群体萌动、维持现状、休眠。

配置分歧分支

  • 快照上游默认值:每个技能的启用状态、模型、变量、调度,以及技能目录集合与标签。
  • 对每个活跃分叉执行一次递归 git-tree 调用枚举文件,并在存在时获取其 aeon.yml。
  • 提取每个技能的启用、模型、变量、调度配置,缺失键视为继承上游默认值。
  • 检测分叉独有技能(上游不存在的技能目录)。
  • 将分叉分层为 CONFIGURED(至少 1 个分歧信号)、TEMPLATE(可读但无分歧,排除出分歧计算)、UNREADABLE。
  • 当 CONFIGURED 分叉少于 2 个时,配置分支无法产生有意义的分歧计算,输出模板群体状态。
  • 聚合四个维度的分歧:启用分歧(含方向 ENABLE_UPWARD / DISABLE_DOWNWARD)、变量分歧、模型分歧、调度分歧。
  • 将分歧技能分类为 DEFAULT_FLIP_ENABLE、DEFAULT_FLIP_DISABLE 等桶,并给出建议。

使用方式

通过变量选择器控制运行范围,令牌以空格分隔、顺序无关、全部可选:

  • scope(code | config | both,默认 both)——运行哪个分歧维度。
  • repo=owner/name——覆盖被扫描分叉的父仓库(否则自动解析)。
  • fork=owner/name——深入单个分叉(强制代码范围;配置计算需要分叉群体)。

空值表示对自动解析的父仓库运行两个维度。示例:``(两者,全部分叉)· code · config · config repo=octo/aeon · fork=alice/aeon。

运行流程包括:引导并加载状态、解析范围选择器、解析父/目标仓库、列出并分类分叉,然后按范围分派到代码分支或配置分支。

适用场景

  • 维护一个被大量分叉的开源仓库,希望发现分叉中值得回收到上游的真实工作。
  • 运营一个分叉群体,希望了解各分叉在配置默认值上的系统性分歧,以判断是否调整上游默认值。
  • 需要按周获得结论优先、可操作的分歧报告,而非逐分叉的原始数据。

限制

  • 配置分歧计算需要至少 2 个已配置分叉,单分叉配置分歧无意义。
  • 每次运行活跃分叉深度处理上限为 50 个,超出按推送时间降序截断。
  • 跨仓库比较返回的变更文件上限为 300 个。
  • 对 PROMOTE 候选的深度读取上限为 5 个。
  • 遇到 404、429、5xx 等错误时按规则重试或标记为不可读/API 失败。
  • 无变化时不发送通知。
  • 具体收费、价格、平台支持等信息暂未提供。