polar-strategy

🐻‍❄️ POLAR v5.0.0 — ETH Alpha Hunter（senpi_runtime_helpers）

舰队中毛利最高的交易者。单一资产。坚定信念。

v3 → v4 架构重写。 v3.x 是一个完整的 Agent 扫描器，会直接调用 create_position，并在 Python 中跟踪状态。v4.0 切换为标准的 senpi-trading-runtime 插件模式：生产器发出信号，运行时负责执行和状态管理。

结构上的变化：

• 新增 polar-producer.py，替代已删除的 polar-scanner.py。纯生产器——不负责执行、计数器、冷却时间或挂单保护。
• runtime.yaml 现已采用运行时原生配置：external_scanner + LLM-pass-through gate + 原生 risk.guard_rails + 使用 FEE_OPTIMIZED_LIMIT 的 DSL 预设。
• 交易链数据库会为每笔交易发出 LIFECYCLE_RUNTIME_STARTED → DECISION_EXECUTED → ACTION_RESULT → DSL_CREATED → DSL_CLOSED。已恢复逐笔交易遥测。
• v4.0 及更高版本在结构上不可能出现旧版扫描器模式中的 set_cooldown / load_tc Python 状态崩溃（冷却时间由运行时管理）。

v3.0.6 中保留的内容：

• ETH 单一资产策略（不进行多资产轮换）
• Hyperfeed SM 门槛：pct≥5%、traders≥30、cc_15m≥0.3（15 分钟速度加速）
• 结构性门槛：4h 趋势 != NEUTRAL、4h 与 SM 方向一致、1h 与 4h 一致、15m 动量方向一致、RSI 位于 26-74 区间
• 多因素评分（最高约 17 分）：基础技术指标（3+2+1+1）+ SM 集中度（1-3）+ SM 速度（1-2）+ SM 加速（1）+ 交易者深度（1）+ 资金费率一致性（-1/0/+2）+ OI 速度（-1/0/+1/+2）+ BTC 相关性（1）+ RSI 空间（1）+ 4h 动量加分（1）+ 行情耗尽惩罚（-1/-2）
• MIN_SCORE = 14（可通过配置覆盖）
• 按信心等级设置杠杆：标准 5x / 高信心 7x / Apex 10x
• DSL 预设原样保留：禁用所有时间止损，Phase 1 max_loss 25% / retrace 8 / 3 次越界，Phase 2 考虑杠杆的阶梯（8/25、15/50、25/65、35/80、50/85）

保留 v3.0.4/3.0.5/3.0.6 v1-DSL 修复：

• dead_weight_cut：已禁用（单一资产没有轮换成本）
• hard_timeout：已禁用（v1 DSL 在 Phase 2 中错误触发；修复 2026-04-23 的错误平仓问题）
• weak_peak_cut：已禁用（完成禁用所有基于时间的止损）
• 现在所有退出都完全基于价格走势

---

⛔ 硬性规则（舰队补丁）

RULE FP-002：用户对话中的 Claude 会话不得交易

硬性规则，不是启发式规则。 回复用户消息时（Telegram 提醒、状态查询、“告诉我你的交易情况”等），Claude Code 会话绝不得调用以下任何工具：

• create_position
• close_position
• edit_position
• ratchet_stop_add / ratchet_stop_edit / ratchet_stop_delete
• cancel_order
• strategy_close / strategy_close_positions

这些工具仅供生产器守护进程（polar-producer.py）和 DSL ratchet 引擎使用。守护进程是唯一的入场途径。DSL 是唯一的出场途径。用户对话会话为只读。

如果用户询问“我该不该做这笔交易？”或“有什么快触发了吗？”，请读取当前状态并作答——切勿执行交易。如果确有信号，生产器会在下一个周期触发。

RULE FP-001：低流动性时段保持静默

生产器默认在 UTC 00:00-04:00 期间跳过信号发出。Apex 设置（评分 >= quietHours.apexBypassScore，默认值为 17）可绕过限制——高信心 ETH 设置可以在任何时段触发；常规评分为 14/15 的入场信号会等到 UTC 04:00。

可通过 polar-config.json 中的 quietHours.{startUtc,endUtc,apexBypassScore} 配置。将 startUtc == endUtc 设为禁用。

---

⛔ Agent 关键规则

RULE 1：安装路径为 /data/workspace/skills/polar-strategy/

RULE 2：扫描器不会退出持仓——仅限 DSL。

RULE 3：最多 1 个持仓

RULE 4：每次会话启动时都要验证运行时

RULE 5：绝不修改参数

RULE 6：每天最多 4 次入场

RULE 7：入场间隔冷却 240 分钟（v2.4 — 狙击手节奏）

RULE 8：盈利后同方向冷却 120 分钟

规则 9：MIN_SCORE = 10（v2.4 — v2.3 中为 8）

规则 10：15m 速度必须超过 MIN_SM_ACCEL_PCT=0.3%（v2.4 硬性门槛）

---

工作原理

Polar 每 3 分钟扫描一次 ETH。它根据 SM 共识、多时间框架贡献速度（15m、1h、4h）、价格一致性、资金费率和交易者深度进行评分。

v2.3 的关键行为：

• 行情衰竭：如果 ETH 在入场方向上的 4h 价格变化 ≥4%，扣 2 分。如果 ≥2.5%，扣 1 分。这与 4H 确认评分形成矛盾。
• 同方向锁定：盈利退出后，60 分钟内不会再次进入同一方向。避免以更差的价格追逐同一波行情。
• 跨午夜冷却：时间戳会在 UTC 日期切换时保留。

评分（最高约 18 分）

信号	分数	说明
SM 共识	1-3	主导比例 ≥15% = +3
交易者深度	0-1	交易者 ≥100 人 = +1
4H 一致性	-1 至 +2	确认方向
行情衰竭	-2 至 0	v2.3 对已有行情幅度 ≥2.5% 进行惩罚
1H 动量	0-1	确认方向
15m 速度	-1 至 +4	极端飙升 = +4
1h 加速度	0-2	强劲加速 = +2
4H 重大变化	0-1	贡献变化 ≥5%
加速模式	0-1	15m > 1h = 正在加速
资金费率一致性	0-1	资金费率有利于你的方向
美国时段	0-1	13-21 UTC

最低分数：8。 杠杆：8→7x、9→10x、10→15x、11+→20x。

---

运行时设置

sed -i 's/${WALLET_ADDRESS}/<WALLET>/' /data/workspace/skills/polar-strategy/runtime.yaml
sed -i 's/${TELEGRAM_CHAT_ID}/<CHAT_ID>/' /data/workspace/skills/polar-strategy/runtime.yaml
openclaw senpi runtime create --path /data/workspace/skills/polar-strategy/runtime.yaml
openclaw senpi runtime list
openclaw senpi status

---

引导门槛

每次会话启动时，都要检查 config/bootstrap-complete.json。如果文件缺失：

1. 阅读 senpi-trading-runtime 技能
2. 验证 Senpi MCP
3. 在 runtime.yaml 中设置钱包和 telegram
4. 安装运行时
5. 验证：openclaw senpi runtime list 和 openclaw senpi status
6. 启动生产者守护进程（长期运行的进程；内部通过 producer_daemon 每 3 分钟运行一次）
7. 写入 config/bootstrap-complete.json
8. 发送："🐻‍❄️ POLAR v2.3 已上线。正在寻找 ETH 交易机会。保持静默 = 没有把握。"

---

风险

规则	值
最大持仓数	1
每日最大入场次数	4
杠杆	7-20x（按把握程度调整，ETH 上限为 20x）
常规冷却时间	120 分钟
同方向冷却时间	盈利后 60 分钟
最低分数	8
保证金	50%

---

文件

文件	用途
scripts/polar-scanner.py	ETH 评分与入场执行
scripts/polar_config.py	配置助手（MCP、状态、持仓）
config/polar-config.json	钱包、策略 ID
runtime.yaml	DSL 插件的运行时 YAML

---

许可证

MIT — 由 Senpi 构建（https://senpi.ai）。

---

技能署名

创建策略时，在调用中包含 skill_name 和 skill_version。详情请参阅 references/skill-attribution.md。