ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

Gekko 获取帮助与问题排查指南:社区求助、Bug 上报与技术讨论的完整路径

Gekko 获取帮助与问题排查指南:社区求助、Bug 上报与技术讨论的完整路径 金融科技后端【免费下载链接】gekkoA bitcoin trading bot written in node - https://gekko.wizb.it/项目地址https://gitcode.com/gh_mirrors/ge/gekko点击查看免费下载Gekko 是一个用 Node.js 编写、面向主流比特币交易所的开源技术分析TA交易与回测平台支持回测、纸面交易与自动交易机器人三种运行模式。本文面向所有使用者在安装、配置、开发插件与策略过程中遇到问题时应该走哪条求助路径从官方在线社区、功能性功能请求到 100% 技术性的 Bug 上报并给出结合当前仓库源码的自查方法帮你把问题描述得又快又准、让维护者能直接复现。先搞清楚你遇到的问题属于哪一类Gekko 的维护者在 getting_help.md 中把求助诉求划分为三大类不同类型走不同渠道选错渠道既浪费自己时间也会拖慢维护者的响应安装 / 使用类问题安装报错、在服务器或嵌入式设备上部署失败、不懂 Gekko 怎么用 —— 去在线社区。功能类诉求希望新增交易所、新增插件、增加一般性功能 —— 去在线社区讨论或按 CONTRIBUTING.md 的规范提交功能请求。明确的技术 Bug / 纯代码架构讨论已经能确认是缺陷或者讨论必须 100% 围绕代码与架构 —— 去官方 Bug 追踪器。判断标准很简单这个问题是否只能靠看代码才能解决。如果是就走技术通道否则先在社区里问往往几分钟就能得到答案。求助前必做的三步自查能省一半等待时间在把问题抛给任何人之前先利用仓库自带的诊断能力自查很多问题其实在这三步就能解决1. 检查版本是否满足要求Gekko 对运行环境有硬性要求。当前仓库的 package.json 中engines.node声明为8.11.2而 core/util.js 的getRequiredNodeVersion()与recentNode()会在启动时用 semver 检查本地 Node 版本。版本过老时Gekko 会直接拒绝启动并提示ERROR: Your local version of Node.js is too old. You have vX.Y.Z and you need atleast 8.11.2这层检查由 core/util.js 在解析命令行参数后立即执行。如果你看到这个错误升级 Node 到 LTS 版本即可无需提问。2. 开启 debug 日志Gekko 内置轻量级日志器 core/log.js其行为受配置文件中的debug与silent两个开关控制debug true时log.debug()才会输出带(DEBUG):前缀silent true时 debug/info/warn 全部静默。默认示例配置 config/general.toml 中debug true是打开的。排查问题时先确认日志开关状态并把完整报错输出而非摘要保存下来——这通常是社区回复的第一个问题你的 debug 日志是什么3. 记录版本与启动命令求助时务必附带 Gekko 与 Node 的精确版本。仓库提供了一条捷径core/util.js 的logVersion()会输出Gekko version: v0.6.8 Nodejs version: vX.Y.Z同时说明你的启动方式node gekko --ui、带-c config.js的命令行模式等以及运行环境本机 / VPS / Docker / 树莓派。在线社区安装与使用问题的第一站如果你遇到的是安装、配置或理解层面的问题在线社区永远是第一站。项目维护者在 getting_help.md 中明确了社区适合处理的事项解决安装问题安装报错、在服务器或嵌入式设备如树莓派上搭建 Gekko功能请求与变更建议请求接入新交易所、编写新插件、提出一般性新功能澄清 Gekko 的能力边界Gekko 到底能做什么、工作机制是什么。社区的具体载体是两个官方渠道项目的在线论坛webforum和Discord 频道。其中论坛适合非实时、可归档的长篇求助比如贴出一整段安装日志Discord 适合快速问答与实时讨论。结合仓库安装类问题最常见的求助场景及对应文档如下求助场景先读仓库文档关键要点通用安装失败installing_gekko.md需要 Node.js≥8.11.2、git用git clone ... -b stable拉取稳定版Windows 安装问题installing_gekko_on_windows.mdWindows 用户请先看专门的 Windows 指南Docker 部署问题installing_gekko_using_docker.md仓库自带 Dockerfile 与 docker-compose.yml服务器无头运行configuring_gekko_on_a_server.md服务器场景需按专门文档配置依赖安装报错installing_gekko.md需要分别在仓库根目录与exchange/目录各执行一次npm install --onlyproduction特别注意一个反复出现的经典坑文档 installing_gekko.md 中明确警告不要对 NPM 的 vulnerability 警告执行npm audit --force否则 Gekko 会被破坏。如果你在社区提问前已经跑过该命令一定要在问题里说明因为它会改变问题性质。另外Gekko 依赖的安装分两层仓库根目录的依赖package.json以及独立的exchange/Gekko Broker依赖exchange/package.json。只装一层会导致启动时报模块缺失——这是社区里出现率极高的求助类型先确认两层依赖都已安装再提问。理解 Gekko 工作原理提问前先建立心智模型社区求助中很大一部分是Gekko 是怎么工作的。与其直接提问不如先读架构文档建立模型很多疑问会自行消解。仓库中 architecture.md 给出了核心抽象每个 Gekko 实例由两个核心组件构成一个市场Market与一个 GekkoStream市场实现 Node.js 的 Readable Stream 接口最终输出candleK 线数据GekkoStream 实现 Writable Stream 接口二者通过 Node Stream API 管道连接市场有三种BudFox实时市场从交易所拉取实时数据、backtest从数据库读取历史 K 线并尽可能快地喂给策略、importer从交易所抓取历史数据写入数据库GekkoStream 本质是一组插件的集合最基础的事件是candle插件可以广播自有事件供其他插件订阅——例如tradingAdvisor运行策略并广播advice事件paperTrader模拟交易与trader真实下单订阅该事件执行动作。对应地docs/commandline/plugins.md 列出了内置插件及config.js中的配置段tradingAdvisor、trader、adviceLogger、paperTrader、mailer、ircbot、campfire、redisBeacon等config/plugins/ 目录下提供了每个插件的 TOML 示例配置。在论坛或 Discord 提问为什么我的 Gekko 不做任何交易之前请先确认你理解这条事件链市场产生 candle → tradingAdvisor 运行策略 → 策略给出 advice → paperTrader/trader 执行。链上任一环断掉比如只开了 tradingAdvisor 没开 trader都会表现为不交易而这通常是配置问题而非 Bug。写自己的策略或插件卡住了先把开发文档读透开发类求助写插件、写策略在社区中占比很高但其中很大一部分答案已经在开发文档里。求助前务必先读策略开发creating_a_strategy.md 定义了策略的完整生命周期init启动时初始化并注册指标→update每个新 candle 触发→logdebug 开启时触发→checkwarmup 完成后触发可调用this.advice()输出交易建议→end回测结束时触发实盘不执行。仓库内 strategies/ 目录有大量可直接参考的示例实现如 MACD.js、RSI.js、CCI.js指标接入原生指标与 TA-lib、Tulip 指标core/tulind.js的用法以及 talib_indicators.md、tulip_indicators.md 中列出的全部可用指标插件开发add_a_plugin.md 与 plugins.md接入新交易所add_an_exchange.md。开发排错时一个常用手段是打开策略的 debug 输出——策略里的log()函数只有在debug标志开启时才会被调用UI 模式下始终关闭见 creating_a_strategy.md配合log.debug()观察每个 candle 上指标的计算结果能快速定位是指标没算出来还是判定逻辑写错。如果读完文档仍解决不了社区提问时请贴出最小可复现代码你的策略文件、对应配置段比如config.tradingAdvisor.strategy与candleSize、historySize以及日志输出。经验法则能让别人直接node gekko --config yourconfig.js复现的问题通常几小时内就有答案描述含糊的问题往往无人响应。功能请求新交易所、新插件、新功能怎么提Gekko 是社区驱动的开源项目任何功能都能被讨论和贡献。按照 getting_help.md功能类诉求新增交易所、新增插件、一般性新功能先在在线社区讨论——这是维护者明确指定的第一站先聊清楚需求本身避免直接涌入 Bug 追踪器。如果社区讨论确认了需求合理性再按 CONTRIBUTING.md 的规范提交正式请求标题以[request]开头后接简短描述例如[request] Export data to CSV每次只提一个请求内容清晰简洁附上必要的 mock-up 或示意图以说明想法先想想这个功能你自己能不能实现若能直接看贡献代码部分欢迎提交 Pull Request。想自己动手实现时仓库也给了明确入口加交易所看 add_an_exchange.md做市场响应功能优先做成插件看 plugins.md写策略看 creating_a_strategy.md改前端 UI 看 gekko_ui.mdGekko 的 Web 界面基于 Vue.js前端代码在 web/vue/。技术讨论与 Bug 上报保持 100% 技术性的纪律社区是讨论新功能的默认去处但当你发现了一个明确的 Bug或者希望**让讨论完全保持技术性即完全围绕代码与架构**时应该使用 Bug 追踪器。维护者在 getting_help.md 中特别强调尽量把所有非技术讨论挡在 Bug 追踪器之外让追踪器保持可管理性。换句话说这个功能什么时候有 —— 社区不是 issue这段代码在core/markets/backtest.js里这样写回测时会不会导致 X 情况 —— Bug 追踪器。上报 Bug 前按 CONTRIBUTING.md 的要求先在已开放的 issue 中搜索看是否已被上报已存在在对应 issue 下补充相关评论与你的复现信息即可不必新开不存在按下述规范新开。一个合格的 Bug issue 长什么样CONTRIBUTING.md 要求明确回答四个问题缺一不可Action taken你做了什么操作Expected result你期望发生什么Actual result实际发生了什么意外结果Your setup你的完整环境——所有相关技术事实、错误消息、日志等。同时遵守两条纪律一个 issue 只报一个 Bug表述尽量清晰简洁。结合前面的自查三步一份高质量 issue 大致是Action: ran node gekko --config config.js on Ubuntu 18.04 with Node v10.x Expected: Gekko starts and begins watching Poloniex USDT-BTC Actual: exits immediately with Cannot find module xxx after npm install Setup: gekko v0.6.8, npm install --onlyproduction in both root and exchange/, debugtrue in config/general.toml, full log attached below把core/util.js的logVersion()输出、完整日志而非截断的最后几行、你的配置片段都放进来。复现信息越完整维护者越可能直接定位信息缺失的 issue 会被要求补料来回成本很高。把求助变成贡献从提问者到参与者Gekko 是一个完全开放的项目很多求助场景的终点其实是你自己改。当你在社区或追踪器里把问题聊透后CONTRIBUTING.md 给出了进阶路径想修 Bug 或实现功能可以挑选带有open-for-pulls标签的开放 issue 作为起点除热修复hotfix外的所有 Pull Request 请提交到develop分支并保持现有代码风格仓库的 test/ 目录提供了成熟的测试范式mocha chai proxyquire sinon覆盖 指标、交易所封装、触发器等新代码配套测试是仓库一贯风格。最后提醒一句社区礼仪底线提问前先读文档、先搜索、先自查。Gekko 的文档体系相当完整docs/ 下涵盖安装、命令行、功能、扩展、内部架构、策略开发等主题90% 的入门级问题在文档中已有答案把精力留给那些真正只有维护者或资深社区成员才能回答的问题社区才会持续保持高质量——这正是维护者坚持技术讨论只走技术渠道的初衷。赞分享金融科技后端【免费下载链接】gekkoA bitcoin trading bot written in node - https://gekko.wizb.it/项目地址https://gitcode.com/gh_mirrors/ge/gekko点击查看免费下载相关推荐混元4B基准测试表现在MMLU、GSM8K等权威评测中的卓越成绩混元4B基准测试表现在MMLU、GSM8K等权威评测中的卓越成绩 混元4B预训练模型在多项权威基准测试中表现卓越在MMLU基准测试中取得74.01分的优异成移动开发教育Wand-Enhancer 完整指南本地解锁 Wand 高级功能并接入手机远程控制Wand Enhancer 完整指南本地解锁 Wand 高级功能并接入手机远程控制 Wand Enhancer 是一个完全开源的本地增强补丁工具。它通过修改桌面应用前端dlite-v1-355m-openmind性能深度评测与GPT-2系列模型的全面对比分析dlite v1 355m openmind性能深度评测与GPT 2系列模型的全面对比分析 在当今人工智能快速发展的时代轻量级语言模型正成为研究者和开发者关上一篇OHIF ToolGroupService 深入解析工具组管理、API 与工具绑定机制下一篇Sunshine游戏串流终极指南5步打造你的私人云游戏平台创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表