安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install yinghuo-grid
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 yinghuo-grid。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

YingHuo Grid v1.0 是一个命令行策略工作流，用于管理围绕手动开立锚点仓位的加密货币永续期货仓位。系统会识别并跟踪该锚点，但不会自动开立或调整它；系统会围绕锚点执行已配置的基于 ATR 的网格加仓、减仓、止盈或止损操作。
YingHuo Grid 专为多头和空头仓位设计，结合了动态网格间距、设有上限的马丁格尔式加仓、LIFO 单格止盈、分阶段账户级退出、趋势过滤和回撤保护。Openclaw Skills 用户可以部署它来持续管理仓位，也可以使用内含的趋势过滤回测脚本比较策略表现。自动交易存在重大风险；连接实盘账户前，请检查并测试配置。

应用场景

手动开立锚点仓位后，管理加密货币永续期货仓位。
使用 ATR 随波动率变化动态调整网格间距。
自动执行已配置的加仓和减仓，同时限制马丁格尔式敞口。
在单边市场行情中使用趋势过滤器暂停新增仓位。
应用分阶段总盈利和总亏损控制，包括账户级浮动亏损暂停机制。
检查与交易所同步的仓位，并逐笔查看操作日志。
部署前使用内含的回测脚本比较趋势过滤器的表现。

工作原理

安装 ccxt 依赖项，并使用示例参数文件配置策略。
在交易所手动开立锚点仓位；YingHuo Grid 的设计是识别该仓位，而不是创建或自动修改锚点。
使用 add 命令登记锚点，指定交易对、方向、数量、入场价格和锚点类型。
运行 status 或 sync，同步并检查交易所中的仓位。
启动 watch，定期扫描仓位、计算基于 ATR 的网格间距、检查已配置条件，并提交符合条件的自动订单。
随着价格变动，策略会应用已配置的加仓、LIFO 单格止盈、分阶段总退出、趋势暂停和账户级亏损保护。
在 .manual_grid_journal.jsonl 中查看记录的仓位操作；使用 journal 检查条目，也可按交易对筛选。

配置指南

安装依赖项，根据示例创建本地参数文件，然后检查与交易所同步的状态并登记手动开立的锚点。运行前，请用适当的实际参数和凭据替换示例配置。请先仔细检查策略设置；技能说明未提供交易所凭据的设置详情。
pip install ccxt
cp strategy_params.example.json strategy_params.json

检查状态并同步交易所仓位

python3 scripts/manual_grid_atr.py status

登记手动开立的锚点仓位

python3 scripts/manual_grid_atr.py add BTC/USDT long 0.003 84277.5 fixed

每 60 秒扫描一次，并管理符合条件的已配置操作

python3 scripts/manual_grid_atr.py watch 60
可用命令包括 status、add、remove、unignore、atrmult 、trendfilter on|off、sync、journal [SYM]、run 和 watch [SECONDS]。策略规则和参数详情请参阅 references/strategy.md。

数据架构

配置：strategy_params.example.json 是示例配置；将其复制为 strategy_params.json 并填写必需参数。
锚点登记：add 命令接受交易对、方向（long 或 short）、数量、入场价格和锚点类型，如 BTC/USDT long 0.003 84277.5 fixed 所示。
仓位状态：status 工作流会自动同步交易所仓位；也可以使用 sync 命令。
操作日志：.manual_grid_journal.jsonl 以 JSON Lines 格式记录每项操作。使用 journal 或 journal [SYM] 查看已记录的活动。
文档与研究：references/strategy.md 介绍规则和参数；references/performance.md 包含回测和实盘表现数据；scripts/grid_trend_filter_backtest.py 用于评估趋势过滤器的替代方案。
所提供的技能说明未指定完整的配置架构或各项日志字段；详情请参阅上述策略文档。

高级特性

响应波动率的间距：
基于 ATR 的网格间隔会随市场波动率调整；可使用
atrmult
调整各交易对的间距。
设有上限的马丁格尔式加仓：
逐步加仓旨在降低平均入场成本，同时通过已配置的上限限制敞口。
LIFO 网格退出：
单格反弹时按照后进先出顺序减仓，以锁定网格级利润。
分层风险控制：
分阶段总止盈和止损规则辅以账户级浮动亏损暂停机制。
趋势感知行为：
趋势过滤器可在单边市场暂停加仓，并可按交易对切换；系统还说明会自动移动参考基线，以避免追逐单边行情。
多空对称：
同一套规则支持多头和空头仓位，并根据方向反转逻辑。
持续扫描：
watch [SECONDS]
会反复检查仓位，并触发符合条件的已配置操作。
回测支持：
scripts/grid_trend_filter_backtest.py
会比较趋势期间暂停加仓与继续加仓的效果，包括回撤和收益表现。

name: yinghuo-grid description: 萤火网格1.0（YingHuo Grid v1.0）——加密货币永续合约的「手工锚仓 + 马丁加仓 + ATR 间距」网格交易系统，全自动闭环执行（自动扫描接管持仓、马丁加仓、单格止盈、两档总止盈止损、趋势过滤器、仓位流水记录）。用于部署、运维或回测一套网格量化交易策略时使用。

萤火网格1.0 (YingHuo Grid v1.0)

针对手工锚仓的永续合约网格系统。锚仓由用户手动开（系统只识别、永不自动动），系统负责在锚仓基础上做 ATR 动态网格的全自动加仓/减仓/止盈止损。

核心规则
环节 规则
网格间距 基于 ATR 动态计算，跟随波动
马丁加仓 递增加仓摊薄成本，封顶控敞口
单格止盈 反弹减仓锁利（LIFO）
总止盈 分批止盈，利润落袋
总止损 分批止损兜底，防深套
趋势过滤 单边行情自动暂停加仓
账户熔断 总浮亏超标全局暂停
防踏空 单边行情自动跟随上移基准
仓位流水 每次操作自动落 .manual_grid_journal.jsonl

多空镜像：做多与做空同一套规则、方向相反。

快速开始

# 依赖
pip install ccxt

# 配置参数（复制示例配置，填入真实参数；付费订阅版提供回测调优参数）
cp strategy_params.example.json strategy_params.json

# 查看状态（自动从交易所同步持仓）
python3 scripts/manual_grid_atr.py status

# 登记锚仓
python3 scripts/manual_grid_atr.py add BTC/USDT long 0.003 84277.5 fixed

# 常驻自动扫描（每 60s，接管持仓 + 检查触发 + 自动下单）
python3 scripts/manual_grid_atr.py watch 60

常用命令：status / add / remove / unignore / atrmult / trendfilter on|off / sync / journal [SYM] / run / watch [秒]。

详细文档
策略规则与参数详解：见 references/strategy.md
回测与实盘绩效数据：见 references/performance.md
趋势过滤器回测：scripts/grid_trend_filter_backtest.py（对比「趋势时停加仓」vs「一直加仓」的回撤与收益）
YH8.5 双引擎信号系统
简体中文转繁体中文文章同步