ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

NOFX 社区参与完全指南:贡献流程、赏金计划与 PR 协作规范

NOFX 社区参与完全指南:贡献流程、赏金计划与 PR 协作规范 AI Agent金融科技后端前端【免费下载链接】nofxYour AI trading terminal assistant for US stocks, commodities, forex, and crypto.项目地址https://gitcode.com/gh_mirrors/nof/nofx点击查看免费下载NOFX 是一个面向美股、大宗商品、外汇与加密货币的 AI 交易终端操作系统其社区仓库以「贡献 赏金 认可」为运转主线贡献者既可以提交代码、文档与测试换取现金赏金也能通过持续贡献晋升贡献者等级、获得维护者信任。本篇指南以社区门户文档 docs/community/README.md 为核心骨架结合其下的赏金任务文档、PR 管理公告以及仓库真实源码完整梳理从「找到任务、认领赏金、提交 PR、通过检查到获得回报」的每一步读完即可上手参与。社区概览这是一个什么样的贡献体系NOFX 的社区文档将参与路径拆解为四层结构分别解决「在哪里参与、怎么获得回报、如何被认可、有哪些边界」四个问题贡献流程从阅读 贡献指南、行为准则 与 安全策略 开始再通过 GitHub Issues关注good first issue标签或赏金任务挑选工作项赏金计划Bounty Program为交易所集成、AI 模型适配等高价值任务提供$50到$1000不等的现金奖励认可体系按贡献数量与质量分为活跃贡献者、受信贡献者、核心团队三级社区沟通渠道以 Telegram 开发者社区为主聊天阵地GitHub 承载 Issues/PR/DiscussionsTwitter 发布公告。与此同时仓库正在滚动上线一套新的 PR 管理系统通过自动化检查、Conventional Commits 提交规范与路线图对齐机制让代码审查更快、更透明。下文将逐一展开。新的 PR 管理系统公告、时间线与对你的影响社区首页顶部公告「New PR Management System Coming Soon」详细说明见 MIGRATION_ANNOUNCEMENT.md中文版见 MIGRATION_ANNOUNCEMENT.zh-CN.md。这套系统引入五项机制与 项目路线图 对齐的清晰贡献指南自动化检查测试、lint、安全扫描更细化的标签体系便于组织与排优先级预检查带来的更快审核周转透明的流程预期。4 周渐进式时间线第 1-2 周存量 PR 审核期 第 3 周 软启动检查仅作建议不阻塞合并 第 4 周 完全启动检查为合并的必需条件对存量 PR 的影响新规则不会阻塞已打开的 PR它们仍按当前宽松标准审核维护者会在 1-2 周内反馈。你可能需要做的是如果存在冲突基于最新dev分支 rebase1 周内回应审核评论若 2 周无响应PR 可能被关闭——之后随时可以更新并重新打开。公告还描述了一个可选的PR 健康检查工具./scripts/pr-check.sh声称能分析 PR、给出改进建议与健康评分只读不改动。需要说明的是在当前仓库快照的scripts/目录中仅包含optimize/下的 Python 优化脚本尚未见到该脚本文件实际使用请以主仓库dev分支为准即使没有该脚本也可以完全依靠下文「本地自检清单」一节中的 Go/前端命令完成等效检查。对新 PR 的要求第 3 周软启动自动化检查运行但不阻塞是学习期第 4 周完全启动所有检查必须通过才能合并PR 标题须遵循 Conventional Commits 格式须填写 PR 模板须与路线图优先级对齐。PR 标题格式Conventional Commitstype(scope): description 示例 feat(exchange): add OKX futures support fix(trader): resolve position tracking bug docs(readme): update installation instructions perf(ai): optimize prompt generation支持的类型包括feat新功能、fixBug 修复、docs文档、refactor重构、perf性能、test测试、chore构建/配置、security安全改进。什么是一个「好 PR」公告给出了正反示例好的 PR 标题清晰描述功能如feat(exchange): add OKX exchange integration、说明做了什么与为什么、关联 Issue 编号、包含测试细节、保持小且聚焦应避免标题含糊如update code、体量过大如单 PR 改动 2500 文件、或偏离路线图的功能如把属于 Phase 3 的股票交易提前提交。对正在做赏金任务的贡献者公告承诺**优先审核24-48 小时**与额外支持前提是引用赏金 Issue 编号、满足全部验收标准、附带演示视频/截图。若 PR 检查失败常见修法为测试失败 →go test ./...lint 错误 →go fmt与npm run lint合并冲突 → 基于最新devrebase。如何开始贡献四步入门社区首页给出了最直接的入门顺序先读三份文档贡献指南完整贡献工作流、行为准则社区标准、安全策略漏洞报告渠道找到要做的任务浏览 GitHub Issues优先查找good first issue标签或直接查看下文赏金任务加入社区Telegram 开发者社区、Twitternofx_official、GitHub Discussions本地验证后再提交按下文「本地自检清单」执行。值得补充的是贡献指南 本身将贡献划分为 Bug 报告、功能建议、PR 提交、文档与测试等类别并强调「高优先级贡献 与路线图对齐」——即安全增强、AI 模型集成、交易所集成、行情数据 API、UI/UX 改进、性能优化与 Bug 修复。这与 路线图 的 Phase 1 优先级一一对应。赏金计划详解从认领到收款奖励阶梯类别奖励范围示例 大型功能$500-1000交易所集成、核心架构 中型功能$200-500WebSocket 支持、新 AI 模型 小型功能$50-200Bug 修复、UI 改进、文档认领赏金的 6 个快速步骤找到带有[BOUNTY]标签的 Issue在评论区提出你的方案等待维护者批准开始开发提交带演示的 PR合并后收款。完整的发布与认领流程见 bounty-guide.md其中还包含维护者如何发布任务创建 Issue 或使用gh issue createCLI、如何设置悬赏金额GitHub 说明、Gitcoin、Bountysource、IssueHunt 等托管平台、如何推广Twitter/Telegram/Reddit/Discord/技术博客以及 Issue 管理最佳实践24 小时回复、定期更新进度、设置里程碑、及时评审 PR。注意事项强调明确这是开源贡献而非雇佣关系、贡献者同意 AGPL-3.0 许可、使用资金托管、必须有测试覆盖与文档更新、不破坏现有功能。当前悬赏任务任务奖励难度状态Hyperliquid 集成待定开放讨论困难 开放Aster DEX 集成待定开放讨论中等✅ 已完成对照 路线图 中的交易所集成一节可见Hyperliquid 与 Aster 目前均标记为「✅ Supported」说明这两条集成路径已具备参考实现新贡献者可在此基础上做增强如 testnet 支持、高级订单类型、跨链支持。赏金任务的技术拆解以交易所集成为例两份悬赏任务文档给出了极其具体的实现规格它们是理解 NOFX 插件式架构的最佳入口。需要实现的核心功能清单API 集成账户管理余额、仓位、保证金、行情数据K 线、盘口、成交、订单执行市价/限价、仓位管理开/平/改、WebSocket 实时数据流适配器层创建trader/exchange_perpetual.go适配器实现与现有客户端兼容的统一接口配置支持在 trader 配置中新增交易所类型与 API 密钥字段风控适配仓位限制、杠杆规则、强平价计算、资金费率接入测试与文档API 包装层单元测试、testnet 集成测试、README 设置指南、排障文档。任务中要求的统一接口 vs 仓库真实接口悬赏文档给出了一个理想的ExchangeClient接口草图GetAccount、GetPositions、GetKlines、CreateOrder、SetLeverage、GetLiquidationPrice等。而当前仓库中实际落地的是 trader/types/interface.go 中定义的统一Trader接口覆盖面更广包括GetBalance()/GetPositions()账户与仓位查询OpenLong/OpenShort/CloseLong/CloseShort多空开平仓SetLeverage/SetMarginMode杠杆与保证金模式全仓/逐仓SetStopLoss/SetTakeProfit/CancelStopLossOrders/CancelTakeProfitOrders止盈止损管理GetClosedPnL获取已平仓 PnL 记录用于外部平仓后的精确对账GetOrderStatus/GetOpenOrders订单状态查询另有GridTrader扩展接口限价单、订单簿用于网格交易场景。这份接口正是「多交易所 AI 交易终端」架构的承重墙上层 trader/auto_trader.go 的自动交易逻辑与 kernel/engine.go 的决策引擎只面向接口编程底层各交易所按统一契约实现。从仓库结构看trader/下已按交易所分目录实现binance/、hyperliquid/、aster/、okx/、bybit/、gate/、kucoin/、bitget/、indodax/、lighter/每个目录内再拆分为trader.go、trader_account.go、trader_orders.go、trader_positions.go、order_sync.go等文件——这正是悬赏任务「File Structure」规划的现实形态。悬赏文档中提到的参考实现trader/binance_futures.go在仓库中已演进为trader/binance/目录trader/binance/futures.go 可视为同等参考。配置示例来自悬赏任务文档{ traders: [ { id: hyperliquid_trader, name: Hyperliquid AI Trader, exchange: hyperliquid, hyperliquid_api_key: xxx, hyperliquid_secret_key: xxx, ai_model: deepseek, initial_balance: 1000.0 } ] }注意悬赏文档中的 JSON 为任务设计阶段的示意结构。仓库实际的配置解析实现在 config/config.go新增交易所时需同步扩展该模块的配置结构。验收标准与加分项最低要求能连接 testnet/mainnet、实时拉取账户余额与仓位、市价单成功、正确平仓、PnL 计算准确、不破坏现有 Binance 集成。加分项WebSocket 实时数据流、限价单与止损止盈、多交易所竞争模式如 Binance vs Hyperliquid、性能对比面板。重要注意事项先在 testnet 验证不要用真实资金保持向后兼容遵循现有代码风格API 密钥安全处理、严禁硬编码凭据。集成 AI 相关功能时可参考 custom-api 接入指南 与 mcp/client.go社区文档中提到的决策引擎decision/engine.go在当前仓库中对应 kernel/engine.go。贡献者认可体系三级晋升与权益等级条件 活跃贡献者提交高质量的 PR⭐ 受信贡献者3 个已合并 PR被授予审核权限 核心团队顶级贡献者由维护者邀请权益名字出现在 README 与发布说明中直接参与维护者讨论Issue 优先支持受邀参加私有路线图规划。当前「Hall of Fame」名人堂仍开放等待首批贡献者。贡献类型与对应奖励代码贡献可做方向新交易所集成、AI 模型适配器、Bug 修复与改进、性能优化。要求代码可编译运行、遵循代码风格、尽量附带基础测试、必要时更新文档。文档贡献可做方向教程写作、翻译中文、Русский、Українська、FAQ 更新、视频指南。奖励完整指南 $50-200、文档署名、贡献者徽章。测试与 QA 贡献可做方向带复现步骤的 Bug 报告、安全漏洞报告走 安全策略、testnet 验证、性能测试。奖励关键 Bug 发现 $50-500、安全漏洞最高 $1000、安全名人堂提名。社区沟通渠道与核心团队平台用途Telegram实时聊天、答疑开发者社区GitHubIssues、PR、DiscussionsTwitter公告与更新nofx_official核心团队TinkleWeb3Tinkle、TintinTintinx2021。联系分流技术问题 → Telegram 或 GitHub Issues商业合作 → Twitter 私信核心团队安全报告 → SECURITY.md。防冒充提示官方账号清单与已知冒充账号如 Twitter 上的nofx_ai为非官方见 OFFICIAL_ACCOUNTS.md。该文档还披露了项目运营实体 Cryonic Holdings LimitedBVI公司编号 2193977与官方联系邮箱声称是 NoFx 但未列于该页的账号均属未经授权——参与前请先核验。社区活动与节奏每周开发进度更新Telegram每月AMA向维护者提问每季度路线图讨论。想组织活动联系 Telegram 核心团队、在 GitHub Discussions 提议、或发推并 nofx_official。学习资源贡献前该读什么理解 NOFX 架构社区文档列出的架构文档部分标记为「coming soon」但当前仓库中已有现成的可读资料系统架构文档含中英版本、策略模块设计、Agent 记忆与规划以及 API 参考 与 入门指南。推荐阅读路径贡献前贡献指南 行为准则做交易所集成Hyperliquid 悬赏、Aster 悬赏参考代码trader/binance/与 统一接口做 AI 功能Custom API 指南、mcp/client.goMCP 客户端、kernel/engine.go决策引擎。本地自检清单提交前先跑一遍PR 管理系统要求提交前完成本地验证详见 MIGRATION_ANNOUNCEMENT.md# 后端Go go test ./... go fmt ./... go vet ./... # 前端web/ 目录React TypeScript Vite cd web npm run lint npm run type-check npm run build这组命令与仓库实际工程配置一致Go 模块见 go.mod前端脚本定义见 web/package.json。存量 PR 的迁移清单rebase、格式化、修复后强推git push -f详见 HOW_TO_MIGRATE_YOUR_PR.md维护者向存量 PR 留言时可套用的模板含中英双语与批量脚本见 PR_COMMENT_TEMPLATE.md审核标准可参考 PR_REVIEW_GUIDE.md。社区准则价值观与红线价值观尊重、透明、质量、协作。不可接受行为骚扰或歧视、垃圾信息或自我营销、分享恶意代码、违反 行为准则。违规处置阶梯警告 → 临时封禁 → 严重时永久封禁。快速索引想提交代码→ 贡献指南想认领赏金→ 赏金指南发现安全问题→ 安全策略有疑问→ Telegram 开发者社区核验官方账号→ 官方账号与防冒充声明回到文档首页→ docs/README.md社区文档中的社区统计如贡献者 21、Star 数等以主仓库实时页面为准。总体而言NOFX 社区为贡献者提供了「明确的回报赏金、清晰的晋升路径三级认可、透明的流程新 PR 管理系统与完备的技术脚手架统一 Trader 接口 各交易所参考实现」四件套任何水平——从good first issue到核心架构——都能找到合适的切入点。赞分享AI Agent金融科技后端前端【免费下载链接】nofxYour AI trading terminal assistant for US stocks, commodities, forex, and crypto.项目地址https://gitcode.com/gh_mirrors/nof/nofx点击查看免费下载相关推荐History.js社区贡献指南PR流程与规范History.js社区贡献指南PR流程与规范 为什么参与History.js贡献 你是否在开发单页应用 SPA 时遇到浏览器历史管理难题作为前端开发者你前端Anoma社区贡献指南代码规范与PR流程Anoma社区贡献指南代码规范与PR流程 Anoma是一个用Rust实现的区块链协议参考实现专注于隐私保护和去中心化应用。作为开源项目Anoma拥有完善的区块链后端隐私计算从零参与开源docling贡献全指南与社区协作规范从零参与开源docling贡献全指南与社区协作规范 加入开源社区是提升技能、拓展人脉的绝佳方式而docling作为一款专注于文档处理的工具正为生成式AI应AI 应用计算机视觉OCR创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表