Hive Bounty Program 完全指南：从赏金机制到自动化积分管线的开源协作体系

人工智能AI Agent多智能体MCP 服务工具调用浏览器控制【免费下载链接】hiveMulti-Agent Harness for Production AI项目地址https://gitcode.com/gh_mirrors/hive48/hive点击查看免费下载导读本文基于 Hive 开源仓库 docs/bounty-program/README.md 展开系统拆解 HiveMulti-Agent Harness for Production AI围绕 GitHub Issues、Discord 与 Lurkr 搭建的一整套社区赏金Bounty协作体系包括 8 类赏金标签与积分规则、3 级贡献者身份阶梯、从 PR 合并到 XP 自动入账的 GitHub Actions 流水线、以及55-Tool Blitz批量动员计划。读完本文你既能以贡献者身份快速上手赚取 XP 与 Discord 角色也能以维护者视角理解整条自动化积分管线的源码实现与运营治理细节。一、为什么要参与激励设计的四个层次Bounty Program 的激励并非单一的积分堆叠而是围绕产品署名、社区地位、每周竞赛、现金通道四个层次设计产品中留名当某个工具从 unverified未验证被提升为 verified已验证后贡献者的 GitHub 用户名会写入该工具 README 的Contributed by字段。每一个调用该集成的 Agent 都会携带这份署名——在生产代码库中获得永久信用。可见的身份标识Discord 中的层级角色是挣来的而非买来的。持有 Core Contributor 徽章的人在#integrations-help频道回答问题时会获得更高的可信度。每周竞赛每周一机器人自动发布排行榜前三名获得奖牌 emoji最佳工作会在公告中被点名。通向付费的路径只有 Core Contributor 才能解锁真实货币报酬而该身份要求跨测试、文档、代码的持续高质量贡献稀缺性正是其价值所在。二、完整工作流从认领到 XP 到账官方主流程见 README 的 How It Works 一节分为六步从 GitHub Issues 面板挑选一个带bounty:*标签的 issue在 issue 下评论认领等待维护者指派完成工作并提交 PR或测试报告维护者审核并合并通过 Lurkr 自动获得 Discord XP达到特定等级解锁角色最高层级解锁付费赏金。contributor-guide.md 补充了两条关键前置动作与治理约束必须先绑定身份在 Discord 中运行/link-github your-github-username机器人给出验证码后将其放入一个公开 gist再运行/verify完成绑定。未绑定时 Lurkr 无法向 Discord 账户推送 XPGitHub 侧仍会记录信用。三条硬性规则认领后 7 天内无 PR 则赏金重新开放同时最多持有 3 个活跃认领PR 必须通过 CI 并遵循模板。难度选择建议新手从bounty:docs或difficulty:easy起步评论Id like to work on this后等待维护者指派。三、等级体系TiersXP 驱动的身份阶梯等级达成方式奖励Agent Builder约 500 XPLurkr 5 级Discord 角色、赏金面板访问权Open Source Contributor约 2,000 XPLurkr 15 级Discord 角色、名字进入 CONTRIBUTORS.md 与工具 READMECore Contributor维护者批准按赏金获得现金报酬、私有#bounty-payouts频道Lurkr 自动分配前两个角色Core Contributor 则需要跨多种赏金类型的持续优质贡献并有维护者担保。注意XP 始终发放与预算无关——正如 game-master-manual.md 所言Money is a bonus layer金钱是叠加的奖励层。四、赏金类型Bounty Types与积分定价赏金分为两大类别积分定价由 scripts/bounty-tracker.ts 中的POINTS常量表硬编码与文档完全一致。4.1 集成类赏金Integration Bounties聚焦工具生态的测试、文档与集成建设类型标签积分工作内容测试工具bounty:test20用真实 API key 测试提交带日志的报告编写文档bounty:docs20按 工具 README 模板 编写 README代码贡献bounty:code30添加健康检查、修复 bug 或改进集成全新集成bounty:new-tool75从零构建完整集成4.2 标准赏金Standard Bounties面向框架、文档、测试与基础设施的通用贡献规模标签积分范围小型bounty:small10错别字、坏链、报错信息改进、复现确认 bug中型bounty:medium30Bug 修复、新增/改进单元测试、指南、CLI UX 改进大型bounty:large75新功能、带基准的性能优化、架构文档极限bounty:extreme150重大子系统、安全审计、跨切面重构、新核心能力4.3 各规模典型示例Small10 分修复文档错别字或坏链改进报错信息使其包含可操作的指引为模块补充类型注解附环境信息复现并确认 bug修复 lint 或 CI 告警。Medium30 分带回归测试修复非关键 bug为常见工作流撰写 how-to 指南显著提升核心模块测试覆盖改进 CLI 帮助文本、参数校验或 UX为模块增加结构化日志或可观测性。Large75 分端到端实现用户可见新功能带 before/after 基准的性能优化新增 CLI 命令或子命令为子系统撰写完整架构文档新增凭证适配器类型。Extreme150 分设计并实现重大子系统如插件系统、缓存层对核心模块做安全审计并附发现与修复核心架构大重构须维护者预先批准构建完整示例应用或参考实现为 Agent 工作流构建端到端测试框架。五、标签体系机器可读的赏金协议标签既是 GitHub 的筛选器也是积分计算的输入。整合 README 的 Labels 一节与 scripts/setup-bounty-labels.sh 的脚本实现可得到完整的 11 个标签定义集成类标签标签颜色含义bounty:test#1D76DB蓝用真实 API key 测试工具bounty:docs#FBCA04黄编写或改进文档bounty:code#D93F0B橙健康检查、bug 修复或改进bounty:new-tool#6F42C1紫从零构建新集成标准类标签标签颜色含义bounty:small#C2E0C6绿快速修复——错别字、链接、报错信息bounty:medium#0E8A16绿Bug 修复、测试、指南、CLI 改进bounty:large#B60205红新功能、性能工作、架构文档bounty:extreme#000000黑重大子系统、安全审计、核心重构难度标签标签颜色含义difficulty:easy#BFD4F2适合首次贡献difficulty:medium#D4C5F9需要一定熟悉度difficulty:hard#F9D0C4需要显著投入或专业经验在源码层面setup-bounty-labels.sh通过gh label create为仓库批量创建上述标签每个标签的描述字段直接写入积分如--description Bounty: test a tool with real API key (20 pts)保证人可读、机器可算。所有标签的积分汇总后形成POINTS表而bounty-tracker.ts的extractBounty()第 202-226 行只认bounty:前缀标签并在POINTS中查不到时返回null跳过——这保证了未知标签不会被误计分。六、质量门禁Quality Gates为保证产出质量文档明确了硬性门槛PR 必须由维护者合并禁止自行合并测试报告必须遵循 Agent 测试报告模板附带日志或会话 IDREADME必须遵循 工具 README 模板先认领后动手——评论 issue 并等待指派禁止自我 review、将一次变更拆成多个 PR、未经验证的纯 AI 提交。各类型赏金还有更细的验收标准详见 game-master-manual.md 的 Quality Gates 小节bounty:docs遵循模板安装步骤准确API key 获取链接可用函数名与真实代码一致不得未经核实使用 AI 生成内容。bounty:test报告遵循模板含日志、会话 ID 或截图必须用真实 API key 而非 mock如实报告失败。bounty:codeCI 通过健康检查类需跑uv run pytest tools/tests/test_credential_registry.py修复直指根因而非症状bug 修复必须附带新测试。bounty:new-tool完整实现工具 凭证规格 测试 READMEmake check make test通过注册在_register_unverified()而非 verified。bounty:large实现前须在 issue 中讨论设计性能工作附 before/after 基准架构文档由第二位维护者复核。bounty:extreme开工前须经维护者预批准设计提案完整测试覆盖至少两位维护者 review。七、Discord 频道设计与排行榜7.1 频道规划#integrations-announcements — 赏金、排行榜、工具晋升公告仅机器人 管理员可发 #integrations-help — 提问、测试协调、成果展示 #bounty-payouts — 美元金额与支付跟踪仅 Core Contributors7.2 排行榜机制每周排行榜自动发布到#integrations-announcements前三名获得奖牌 emoji。随时可在 Discord 用/rank查询自己的名次。XP 有两个来源GitHub 赏金PR 合并时自动推送与#integrations-help频道内的 Discord 活跃度Lurkr 原生消息 XP可按频道配置。排行榜的生成逻辑在bounty-tracker.ts的buildLeaderboard()第 401-424 行中按 GitHub 用户名聚合积分与赏金数formatLeaderboard()第 282-306 行输出前十名并自动附前三名奖牌若无数据则输出 No bounty completions this period.。八、自动化流水线源码剖析PR 合并即发奖8.1 端到端链路README 中给出了完整的数据流带 bounty:* 标签的 PR 合并 → GitHub Action 运行 bounty-tracker.ts → 依据标签计算积分 → 通过 MongoDBhive.contributors解析 GitHub → Discord ID → 向 Lurkr API 推送 XP → 向 #integrations-announcements 发布通知8.2 触发工作流bounty-completed.yml.github/workflows/bounty-completed.yml 监听pull_request_target的closed事件并带workflow_dispatch手动补偿入口pr_number输入用于补发漏掉的赏金。任务执行条件严格限定为PR 确实被合并pull_request.merged true且标签列表包含bounty:contains(join(labels.*.name, ,), bounty:)。任务内部安装 Bun 后运行bun run scripts/bounty-tracker.ts notify通过 GitHub Secrets 注入DISCORD_BOUNTY_WEBHOOK_URL、BOT_API_URL、BOT_API_KEY、LURKR_API_KEY、LURKR_GUILD_ID等敏感配置。8.3 积分与通知bounty-tracker.ts 的两种模式bounty-tracker.ts是这条管线的核心以notify与leaderboard两种模式运行第 430-511 行notify 模式由 bounty-completed.yml 调用读取PR_NUMBER→ 经 GitHub API 获取 PR → 校验merged_at非空 →extractBounty()提取赏金信息 →awardLurkrXP()先推送 XP → 再向 Discord Webhook 发送格式化通知。leaderboard 模式由 weekly-leaderboard.yml 调用读取SINCE_DATE→ 通过 GitHub Search API 拉取该时段内所有带bounty:标签的已合并 PR多个label:...限定符用空格 OR 拼接第 130-150 行→ 聚合生成排行榜 → 发布到 Webhook。8.4 Lurkr API 集成细节awardLurkrXP()第 371-395 行展示了两个重要设计容错降级缺少LURKR_API_KEY/LURKR_GUILD_ID或贡献者未绑定 Discord ID 时直接跳过 XP 推送并打印日志绝不阻断 Discord 通知Lurkr failure should not prevent the Discord notification from being sent。API 调用方式向https://api.lurkr.gg/v2/levels/{guildId}/users/{userId}发送PATCH请求请求头带X-API-Key载荷为{ xp: { increment: xp } }——对应 README 中所列的PATCH /levels/{guild}/users/{user}。成功后可获得最新等级与 XP 总量用于拼进通知文案。8.5 身份绑定Identity Linking贡献者通过 Discord 中的/link-github命令绑定 GitHub ↔ Discord 身份机器人通过公开 gist 验证所有权随后把映射关系存入 MongoDB 的hive.contributors集合。未绑定时赏金仍会被追踪GitHub 侧信用保留但 Lurkr 无法推送 XP通知中也会附带提示use /link-github in Discord to get pinged!见formatBountyNotification()第 253-280 行。8.6 各环节职责矩阵关注点处理方方式赏金积分计算GitHub Actionsbounty-completed.yml读取 PR 标签向 Discord 推送 XPGitHub Actions → Lurkr APIPATCH /levels/{guild}/users/{user}Discord 活跃 XPLurkr 机器人原生消息 XP可按频道配置排行榜Lurkr 机器人 GitHub ActionsDiscord/leaderboard 每周 webhook 发布Agent Builder 角色Lurkr 机器人5 级自动分配OSS Contributor 角色Lurkr 机器人15 级自动分配Core Contributor 角色维护者手动涉及金钱身份绑定Discord 机器人 → MongoDB/link-github命令 gist 验证九、启动计划55-Tool Blitz 双周冲刺README 描述了为期两周、将全部 55 个未验证工具推向已测试、已文档化、已健康检查状态的动员方案Day 1集中发布41 个bounty:docsissue——缺 README 的工具difficulty:easy各 20 分40 个bounty:codeissue——缺健康检查的工具difficulty:medium各 30 分55 个bounty:testissue——每个未验证工具一个difficulty:medium各 20 分。Week 1-2所有赏金类型并行开放贡献者自行选择。每日进度更新发布在#integrations-announcements第 14 天收官并公布最终排行榜与致谢。这份清单与 promotion-checklist.md 中的缺口统计一一对应约 41 个工具缺 README、约 40 个缺health_check_endpoint与 HealthChecker 类、55 个工具无社区测试报告。从源码侧看健康检查体系是真实存在的各工具目录如 credentials/airtable.py、credentials/apify.py的 CredentialSpec 中设置了health_check_endpoint由HEALTH_CHECKERS字典登记并由uv run pytest tools/tests/test_credential_registry.py验证注册完整性。十、维护者视角Game Master 运营手册game-master-manual.md 定义了维护者Game Master的完整职责认领处理difficulty:easy立即指派difficulty:medium/hard先考察其是否完成过更简单的赏金7 天无 PR 则取消指派并重新开放。PR 审核核对 PR 与赏金 issue 匹配审核质量门禁创建赏金的维护者不能审核自己的赏金须由另一位维护者批准合并前打上正确的bounty:*标签这是触发自动发奖的开关合并后关闭关联 issue。拒绝策略给出具体建设性反馈请求变更而非直接关闭 PR7 天无响应则关闭 PR 并取消赏金。Never merge low-quality work just to be nice.10.1 Core Contributor 晋升标准晋升条件活跃4 周以上且跨3 种以上赏金类型贡献、PR 质量一贯优秀、至少一位维护者背书。反向条件仅做简单赏金、活跃不足 4 周、有刷分迹象者不晋升。若 Core Contributor 连续 8 周不活跃先私聊沟通无响应再移除角色。10.2 美元价值参考Core Contributor 的报酬在#bounty-payouts公布原文给出参考区间集成类bounty:test$10–30bounty:docs$10–20bounty:code$20–50bounty:new-tool$50–150。标准类bounty:small$5–15bounty:medium$20–50bounty:large$50–150bounty:extreme$150–500。支付流程PR 合并 → 核验质量 → 在#bounty-payouts记账 → 处理付款。10.3 反作弊策略模式应对将一个变更拆成多个 PR拒绝额外 PR 并警告未经验证的 AI 生成拒绝并说明原因大量认领、极少完成7 天后取消指派惩罚梯度首次警告 → 二次两周冷却 → 三次永久移除。十一、工具从 unverified 到 verified晋升清单promotion-checklist.md 给出了正式晋升标准一个工具必须满足全部必需项维护者才会将其从_register_unverified()迁移到_register_verified()两函数均位于 tools/src/aden_tools/tools/init.py。必需项摘要代码质量register_tools遵循标准签名模式所有工具返回{error: ...}字典而非抛异常凭证缺失时优雅降级并附可操作的help消息调用 API 前完成参数校验无硬编码密钥。凭证规格CredentialSpec 存在于tools/src/aden_tools/credentials/{category}.pyenv_var唯一不冲突tools列表覆盖全部注册函数help_url指向获取 API key 的页面credential_id/credential_key就位并合并进CREDENTIAL_SPECS。健康检查health_check_endpoint已设置HealthChecker 类实现在credentials/health_check.py注册进HEALTH_CHECKERS正确处理 200有效、401无效/过期、429限流但有效uv run pytest tools/tests/test_credential_registry.py -v通过。文档README 遵循模板含安装指引、工具函数表、每个函数至少一个用法示例、API 参考链接。测试tools/tests/tools/test_{tool_name}.py中存在单元测试mock 外部 API不发起真实调用覆盖 happy path 与错误分支make check make test通过。社区测试至少 1 名社区成员用真实 API key 测试过按模板提交 Agent 测试报告在真实 Agent 工作流中可用无阻塞问题。晋升流程贡献者提交勾选全部必需项的 PR → PR 描述附 README、健康检查、测试报告链接 → 维护者逐项核验 → 迁移注册位置 → 给 PR 打上bounty:code标签触发 XP 与 Discord 通知→ 公告自动发布。十二、运维落地30 分钟搭建指南要点setup-guide.md 给出了从零到运行的完整步骤预计 30 分钟关键环节如下创建 GitHub 标签2 分钟运行./scripts/setup-bounty-labels.sh一次创建全部 11 个标签4 集成 4 标准 3 难度。创建 Discord 频道3 分钟#integrations-announcements全员可读、仅机器人管理员可发、#integrations-help、私密#bounty-payouts仅 Core Contributor。创建 Discord 角色2 分钟Core Contributor金色#F1C40F可提及、Open Source Contributor紫色#9B59B6、Agent Builder绿色#2ECC71。顺序即层级。安装配置 Lurkr10 分钟邀请机器人 →/config toggle option:Leveling System开启等级系统 → 在 Dashboard 设置 XP 区间 min 15 / max 25、冷却 60 秒 → 将#integrations-help设为等级频道并配 2x 倍率不要把公告/支付频道设为等级频道→ 用/config set在 5 级挂 Agent Builder、15 级挂 OSS Contributor 角色奖励Core Contributor 绝不自动分配→ 生成Read/Write权限的 API key。创建 Discord Webhook2 分钟命名Bounty Tracker指向#integrations-announcements。添加 GitHub Secrets3 分钟DISCORD_BOUNTY_WEBHOOK_URL、LURKR_API_KEY、LURKR_GUILD_ID开启开发者模式右键服务器名复制 ID、BOT_API_URL、BOT_API_KEY。测试管线5 分钟本地运行bun run scripts/bounty-tracker.ts leaderboard需设置GITHUB_TOKEN、GITHUB_REPOSITORY_OWNER、GITHUB_REPOSITORY_NAME再创建一个带bounty:docs标签的测试 PR 并合并验证 Discord 通知出现。播种 55-Tool Blitz启动日一次性发布全部赏金文档 41 / 健康检查 40 / 测试 55。常见故障排查无 Discord 消息 → 检查DISCORD_BOUNTY_WEBHOOK_URL与 Action 日志Lurkr XP 未到账 → 确认 API key 为 Read/Write、贡献者已/link-github、查看日志中Lurkr XP push failed角色未分配 → 检查 Lurkr Dashboard 的角色奖励配置并确保 Lurkr 机器人角色在服务器层级中位于其要分配的角色之上。十三、仓库内配套资源导航赏金计划主文档 — 本文的骨架来源贡献者指南 — 上手实操 FAQ运维手册Game Master Manual — 维护者运营与反作弊搭建指南Setup Guide — 管理员从零配置晋升清单Promotion Checklist — unverified → verified 标准工具 README 模板 — 文档类赏金必填Agent 测试报告模板 — 测试类赏金必填构建工具指南 — 新集成开发规范积分与通知实现 — 积分表、Lurkr API 调用、通知格式化标签初始化脚本 — 11 个标签的一键创建PR 合并触发工作流 — 合并即发奖的自动化入口重复 issue 自动关闭脚本 — 赏金面板的配套治理工具结语Hive 的 Bounty Program 是一套标签即协议、合并即发奖的高度自动化协作体系GitHub 标签承载积分语义bounty-tracker.ts完成从 PR 到 XP 的全部换算与推送Lurkr 负责角色阶梯MongoDB 维护跨平台身份映射而 55-Tool Blitz 则展示了如何把激励设计与产品目标补齐工具生态的文档、健康检查与真实测试绑定。对贡献者而言它是通往产品署名、社区地位与现金报酬的清晰路径对维护者而言它提供了可复用、可审计、带反作弊机制的社区运营模板。赞分享人工智能AI Agent多智能体MCP 服务工具调用浏览器控制【免费下载链接】hiveMulti-Agent Harness for Production AI项目地址https://gitcode.com/gh_mirrors/hive48/hive点击查看免费下载相关推荐Cataclysm-DDA 的 Issues 协作规范从 Bug 报告、赏金机制到自动化标签工作流Cataclysm DDA 的 Issues 协作规范从 Bug 报告、赏金机制到自动化标签工作流 导读 Cataclysm: Dark Days Ahead游戏开发ImageScraper终极指南高性能多线程图片抓取工具快速上手ImageScraper终极指南高性能多线程图片抓取工具快速上手 ImageScraper是一款高性能、易于使用的多线程命令行工具能够从指定网页快速下载图片开发工具向量内存缩到 1/25faiss 1.11.0 新增 RaBitQ 量化让大库检索跑进单机向量内存缩到 1/25faiss 1.11.0 新增 RaBitQ 量化让大库检索跑进单机 跑向量检索服务的人都知道内存是最硬的瓶颈1000 万条 512机器学习搜索引擎向量数据库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考