Decibel 全自动网格机器人

这是一个跑在你自己电脑上的 Decibel 专用永续合约网格机器人。默认是 paper 模拟模式，不会真实下单；网页里可以自动分析趋势、自动生成区间，并一键启动网格。

风险提示：这是实验性交易软件，不构成投资建议。实盘会真实下单并可能损失全部投入资金。默认先使用 paper，不要把私钥、API Key、账户状态或日志提交到 GitHub。

功能

• Decibel BTC/USD 永续合约网格策略
• paper 模拟盘与人工启用的 live 实盘模式
• 趋势、ATR、手续费安全线和资金约束辅助生成网格
• 本地网页控制台
• 实盘优化建议需要人工确认，不自动应用

快速启动

1. 安装依赖：

   npm install

2. 启动服务：

   npm start

3. 浏览器打开：

   http://127.0.0.1:8080
   

成功标志：终端出现 Decibel 全自动网格机器人已启动，网页能看到 Decibel · paper，点击“自动填充参数”后能生成上下边界。

当前默认模式

当前 .env 默认是：

DE_MODE=paper

这表示模拟盘。未填写 DECIBEL_API_KEY 时，程序会使用合成行情，适合先熟悉流程；填写 API Key 后，paper 模式可以尝试读取 Decibel 真实行情，但仍然不会实盘下单。

实盘风险

切到实盘前必须理解这些风险：

• DE_MODE=live 后，机器人会真实挂单、补单、撤单和平仓。
• 合约交易可能亏损本金，杠杆会放大亏损。
• 私钥只能放在本机 .env，不要发给任何人，不要提交到 GitHub。
• 建议先用小资金、低杠杆、低每格数量测试。

实盘需要在 .env 填写：

DE_MODE=live
DECIBEL_API_KEY=你的 API Key
DECIBEL_PRIVATE_KEY=你的 API 钱包私钥
DECIBEL_SUBACCOUNT=你的 Trading Account 地址

常用操作

• 自动填充参数：按当前价格和趋势生成网格类型、上下边界、格数。
• 全自动启动：按表单参数启动网格。
• 停止 + 撤单 + 平仓：退出机器人并尝试平掉仓位。
• 只撤挂单：撤销挂单，但保留持仓。
• 重连：网络异常后重新连接并对账。

测试

npm test

成功标志：所有测试通过，并看到 0 failed。

安全与公开发布

• 只提交 .env.example，绝对不要提交真实 .env。
• .state*.json、.optimization.json、.accounting.json、.portfolio-review.json、日志和输出文件已加入 .gitignore。
• macOS 后台服务配置仅提供 .plist.example 模板，不包含开发者电脑的用户名或绝对路径。
• 发现安全问题时请不要在公开 Issue 中粘贴密钥或账户数据，参照 SECURITY.md 处理。

自动发布

GitHub Actions 会在每次推送和 Pull Request 时运行测试。推送形如 v1.0.0 的版本标签后，发布流程会再次运行测试，并自动创建 GitHub Release 和不含本地配置、状态、日志与依赖目录的源码压缩包。

许可证

本仓库目前尚未选择开源许可证。在添加许可证前，代码默认保留全部权利。发布者应在公开发布前明确选择是否加入 MIT、Apache-2.0 或其他许可证。