SKILL: OptimizerClaw — TLH Strategy Engine (OKX Edition)

TLH 规划可用的 ATK 能力清单

以下能力是 TLH 方案规划阶段可考虑的 ATK 能力族。它们不等于当前执行链路已经全部调用，但会作为规划候选集合供 Pro 模型选择：

TLH 规划可用的 ATK 模块清单

TLH 方案规划阶段可以把 ATK 视为以下模块集合：

说明：当前实现中，TLH 默认主链路优先使用已落地的 ATK 能力；上表用于扩展规划空间，便于 Pro 在需要时组合更广的能力集。

执行流程

Step 1: 亏损仓位扫描

从 ScannerClaw 的 tax_dataset 中识别当前持仓中未实现亏损 > 阈值的仓位。 按亏损金额降序排列，输出候选列表。

Step 2: 替代标的筛选

对每个亏损仓位：

• okx-dex-token trending → 同赛道 Token 热度排名
• okx-dex-token detail → 流动性/持有人分布评估
• okx-security token-scan → 合约安全审计（过滤 rug pull）
• 输出安全替代标的推荐列表

Step 2.5: 多方案排序

在替代标的列表之上，再输出按辖区约束排序的候选方案：

• 现货替代保持敞口
• 衍生品对冲保持敞口
• TLH 后收益部署

排序原则：先满足辖区合规，再尽量保持市场敞口，最后比较收益增强空间。

Step 3: 执行时机判断

• okx-dex-signal → smart money / whale 信号分析
• 判断当前是否适合执行（避开大幅波动期）

Step 4: Wash Sale / Superficial Loss 检查

• 日本：无 wash sale rule（可立即回购同资产）
• 澳洲：same asset repurchase 需注意 ATO 实质重于形式原则
• 加拿大：30 天 superficial loss rule → 必须等 30 天或用替代标的

Step 5: 用户确认 + 执行（需用户明确同意）

⛔ 禁止自动执行交易。必须展示行动计划 → 等待用户确认 → 再通过 OKX Spot API 下单。

Step 6: Jumpstart / On-chain Earn Hook（可选）

省下的税金 → 推荐质押进 OKX Jumpstart 或 On-chain Earn。

"🦞 税局没拿走的钱，让 OKX 帮您生钱。"

Command Index

# 扫描 TLH 机会（一次性分析）
python {baseDir}/optimizer.py --dataset <tax_dataset.json> --jurisdiction japan

# JSON 输出
python {baseDir}/optimizer.py --dataset <tax_dataset.json> --jurisdiction australia --json

# TLH 执行 — Dry Run（默认，仅模拟，不下单）
python {baseDir}/optimizer.py --mode execute --dataset <tax_dataset.json> --jurisdiction japan --json

# TLH 执行 — 实际下单（通过 OKX Spot API）
python {baseDir}/optimizer.py --mode execute --dataset <tax_dataset.json> --jurisdiction japan --confirm --json

# TLH 执行 — Demo trading 下单（安全测试）
python {baseDir}/optimizer.py --mode execute --dataset <tax_dataset.json> --jurisdiction japan --confirm --testnet --json

# 指定执行标的（从 analyze 输出中筛选）
python {baseDir}/optimizer.py --mode execute --dataset <tax_dataset.json> --jurisdiction japan --actions '["ETH","AVAX"]' --confirm --json

# ---- Continuous Mode (v1.1) ----

# TLH 监控模式（cron 每小时触发）
python {baseDir}/optimizer.py --mode monitor --config <monitor_config.json> --jurisdiction japan

Continuous Mode — TLH 监控（v1.1）

监控模式（--mode monitor）

由 cron job veritax-monitor 每小时触发，双层模型架构：

Flash 层（0.33x，每小时运行）：

1. monitor_check() — 读取 monitor_config.json 中的 positions_watch
2. 获取实时现货余额 + 行情价格（via ATK CLI）
3. 计算未实现盈亏，与 loss_threshold_pct 阈值比较
4. 未触发 → stdout 输出 [Monitor] no_trigger → 结束
5. 触发 → stdout 输出 [Monitor] TRIGGERED asset=X loss_pct=Y

Pro 层（1x，仅触发时调用）： 6. tlh_decision() — 验证持续性 → wash sale 检查 → 替代标的审计 → 税务节省估算 7. 返回 action=recommend_sell 或 action=skip（含原因） 8. 若推荐执行 → execute_tlh() 写入 monitor_config + TG 通知

monitor_config.json 结构

{
  "positions_watch": [
    { "asset": "ETH", "cost_basis_usd": 3200, "qty": 1.5,
      "loss_threshold_pct": -10, "sector": "L1" }
  ],
  "executed_tlh": [],
  "wash_sale_cooldowns": {}
}