binance-square

Files (95)

• AUTHORIZATION_RECEIPT.md
• GRILL_DECISIONS.md
• OPTIMIZATION_VERIFICATION.md
• PRE_OPTIMIZATION_AUDIT.md
• PROVENANCE.md
• SKILL.md
• V4_IMPLEMENTATION_PLAN.md
• 001_v4.sql · migrations/
• 002_contract_freeze.sql · migrations/
• 003_production_cutoff.sql · migrations/
• 004_smart_money_leaderboards.sql · migrations/
• 005_run_namespace_and_lineage.sql · migrations/
• 006_identity_mapping_v2.sql · migrations/
• 007_profile_fetch_outcomes.sql · migrations/
• 008_post_discovery_observations.sql · migrations/
• __init__.py · scanner/
• authors.py · scanner/
• binance_news.py · scanner/
• contracts.py · scanner/
• derivation.py · scanner/
• discovery.py · scanner/
• indicators.py · scanner/
• market.py · scanner/
• opportunities.py · scanner/
• pipeline.py · scanner/
• profile_pipeline.py · scanner/
• reports.py · scanner/
• retention.py · scanner/
• runner.py · scanner/
• scoring.py · scanner/
• setups.py · scanner/
• smart_money.py · scanner/
• square.py · scanner/
• storage.py · scanner/
• tracking.py · scanner/
• binance_price_check.py · scripts/
• binance_scraper.py · scripts/
• binance_state_commit.py · scripts/
• build_identity_mapping_catalog.py · scripts/
• cleanup_retention.py · scripts/
• collect_identity_mapping.py · scripts/
• collect_smart_money.py · scripts/
• collect_square_v4.py · scripts/
• discover_authors.py · scripts/
• render_clean.py · scripts/
• render_latest_telegram.py · scripts/
• repair_latest.py · scripts/
• review_identity_mapping.py · scripts/
• run_production_cycle.py · scripts/
• run_radar.py · scripts/
• run_shadow_cycle.py · scripts/
• scan_swing_opportunities.py · scripts/
• __init__.py · tests/
• leaderboard_seed_profiles.json · tests/fixtures/discovery/
• leaderboards_empty.json · tests/fixtures/discovery/
• profile_contents_public.json · tests/fixtures/discovery/
• v3_snapshot_01.json · tests/fixtures/history/
• v3_snapshot_02.json · tests/fixtures/history/
• v3_snapshot_03.json · tests/fixtures/history/
• feed_cards_live.json · tests/fixtures/m1b/
• …and 35 more

SKILL.md (first lines)

# 币安广场合约投机雷达 v5.0（Shadow）

> 当前可真实运行的是只读影子报告：不发 Telegram、不创建定时任务、不下单。

## 必读合同

执行前完整读取：

1. `GRILL_DECISIONS.md`：用户确认的产品、作者、行情、评分、追踪与留存规则。
2. `V4_IMPLEMENTATION_PLAN.md`：里程碑、证据门和已知阻塞。

不得把设计目标描述成已经上线的能力。最终结论必须来自当次生成的 JSON/Markdown 和测试结果。

## 当前已实现

- v5.0 对候选分层做了探索性放宽：`TOP >= 55`、`WATCH >= 40`；缺少 Entry/SL/TP 时按字段完整度部分计分，不再仅因缺字段进入评分硬过滤，但执行就绪状态保持 `UNAVAILABLE`，不能成为可执行 TOP。TP1 RR `1.2` 与主要目标 RR `1.5` 是评分线；主要目标低于 `1.5` 仍硬过滤。
- v5.0 增加 `--scheduled-retry` 入口和最多两次相互独立的 Feed 捕获；重试不得跨次拼接帖子或复用旧快照冒充本轮成功。
- Telegram renderer 改为面向用户的简洁摘要；完整 JSON/Markdown、manifest 与 SQLite 仍是唯一审计事实源，精简消息不能替代证据文件。

- 标准入口默认容量 200；Profile 是专业作者帖主通道，Feed 与经过人工/模型提取的参数信号 URL 作有界补充，按 canonical `post_id` 去重且保留全部来源 observation。
- Feed 使用 `square-feed-coverage/v1`：必须从顶部开始，并记录滚动几何、两相懒加载触发、停止原因和覆盖状态。当前 scope 固定为 `BINANCE_SQUARE_DISCOVER_DOM`，`global_denominator_known=false` 且 `pagination_api_exhaustion_verified=false`；即使达到声明下限并稳定穷尽 DOM 而标 `BOUNDED_COMPLETE`，也只代表该次 DOM surface，不代表内部 feed API 或整个平台。容量、滚动预算、错误或未验证旧快照分别标 `CAPPED/PARTIAL/BLOCKED/LEGACY_UNVERIFIED`。
- Feed 每次成功观察都写不可变快照和 `binance_raw_posts.json` observed latest。`capture_attempt_no`、`capture_attempt_limit` 与表示稳定物理底部事实的 `surface_exhausted` 是 `square-feed-coverage/v1` 的向后兼容可选诊断扩展，旧 v1 证据不会被静默升级。只有严格满足 `BOUNDED_COMPLETE + EXHAUSTED + minimum_target_met + unique>=preferred_minimum` 的 Discover DOM 捕获才推进独立 `binance_raw_posts_eligible.json`。PARTIAL 证据必须保存但不得覆盖既有 eligible 指针；抓取锁忙以非零状态失败，不能复用旧 latest 冒充本轮成功。
- Feed 文本在 CDP 入站时执行 Unicode scalar 规范化：合法 emoji 代理对保持原义，孤立 UTF-16 surrogate 仅替换为 `U+FFFD` 并计入 `malformed_unicode_replacements`。最终 JSON 写入层再次递归兜底；写入失败必须清除临时文件，单个异常字符不得拖垮整批帖子。
- 生产 wrapper 默认最多执行两次相互独立的 Feed 捕获（`--capture-attempt-limit 1` 可回滚为单次），首次 eligible 立即停止；两次都未 eligible 时只选择最新一次合法捕获进入 radar，不跨次拼接帖子，也不读取旧 eligible。`PARTIAL` 与达到 200 条硬上限的 `CAPPED` 都只作带原始覆盖标签的不完整 Feed 补充，`CAPPED` 不得冒充穷尽。每次 observed latest 都必须刷新、与当次 immutable snapshot 逐字节一致并通过 v1 合同；只有 eligible 捕获才额外要求 eligible pointer 逐字节一致。Feed 是 Profile 主通道的补充，合法不完整捕获不再阻断 Profile，但下游仍必须如实保留覆盖状态；malformed、未刷新、错误或指针不一致继续失败关闭。
- 逐帖请求币安公开详情接口，使用稳定 `post_id`、`author_id`、权威正文与精确发布时间。
- Profile + Feed 双通道已接入真实只读 pipeline：Profile 计划只认稳定 `squareUid`，通过匿名公共 GET 从 `timeOffset=-1` 分页；逐条用 `firstReleaseTime` 执行严格24小时窗口，并以可验证 cursor 水位、空页或无 next 作为终止证明。置顶旧帖不会造成提前停止，cursor 停滞/上升、锚点不匹配、schema 漂移、请求失败或页预算耗尽均失败关闭为 `PARTIAL`。
- 历史 fixture 保留 30D `PNL/ROI/VOLUME/WIN_RATE` 四榜解析合同；当前真实 Smart Money 接入只支持官方 Web UI 已观测的 `PNL/ROI`，每榜必须恰好30个唯一排名与 `topTraderId` 才可标记 `COMPLETE`。
- Smart Money 公共只读 API 已接入标准 pipeline：`--smart-money` 在线采集，`--smart-money-fixture` 注入带完整性校验的证据；排行、交易员详情与 Square 身份映射分别计数，不能相互代替。
- 单次生产影子入口 `scripts/run_production_cycle.py` 会按上述独立捕获规则刷新 Feed，再以前台、顺序、`--no-send` 方式运行 Smart Money、官方新闻与雷达；Feed 快照超过10分钟或来自未来时失败关闭。离线测试只验证选择与失败关闭合同，尚无真实双捕获稳定性回执。
- 生产 wrapper 为每个长时间子进程每30秒输出一次可刷新的 `[HEARTBEAT]`，避免调度器把正常静默分析误判为无输出挂死；父进程异常退出时会终止并回收子进程。`run_radar.py` 将 `SIGTERM` 转成可审计异常，使已创建的 attempt 进入 `FAILED`，而不是永久遗留 `RUNNING`。
- `scripts/render_latest_telegram.py --report <committed-report.json>` 只读取已提交报告并复用标准 `render_telegram` 合同输出精简文本；它本身不发送。账号、目标、调度与实际发送仍属于安装环境的外部配置，不随公共 Skill 发布。
- 生产入口默认不再消费旧版可变 `data/signal_check_input.json`；只有显式传入 `--signals-json` 才把它作为有manifest的补充来源。真实 pipeline 在任何 Profile、Smart Money 或帖子详情网络请求之前获取一次 Futures catalog 并完成 Binance server-time 校验，后续行情复用同一 catalog。
- 官方 Binance 公告可用 `--official-news` 纳入严格前24小时来源覆盖；列表缺发布时间时必须回源详情，响应 envelope、文章 code、新到旧排序和窗口穷尽性均受合同约束，限流或解析失败会留下 `FAILED` 来源状态而不是伪造空新闻。
- Smart Money fixture 导入不只校验可重签的 payload hash，还会重新验证固定语义：`30D`、`DESC`、恰好 `PNL+ROI`、每页10行×3页，以及两个 `onlyShow*` filter 均为 `false`；任一不符即拒绝。
- `topTraderId → squareUid` 身份映射 v2 必须来自同一匿名 Binance 响应，并绑定 raw bytes、request manifest、实际 SHA-256 和 `/data/topTraderId`、`/data/squareUid` JSON Pointer。采集器只能生成 `PROPOSED`；只有经独立、显式 review 生成的不可变 `APPROVED` artifact 才能进入活动投影，且支持事件化撤销。
- 显式映射证据或经哈希固定的多映射 catalog 可通过 `--smart-money-square-mapping-evidence` 接入同一 pipeline；报告把 Smart Money 映射/Profile 与独立 seed Profile 分开记分母，seed 覆盖不得冒充60人榜单覆盖。
- 严格最近 24 小时窗口：`[decision_at - 24h, decision_at)`。
- 旧 signal 文件只提供作者原始 Entry/SL/TP 等参数；时间与作者必须回源重验，标记为 `AUTHOR_LEGACY_EXTRACTED`。
- `DERIVATION_POLICY_V1`：作者参数有效时保留 `AUTHOR`；缺参数或入场已错过时，只有完整 Futures 四周期证据、结构、0.4 ATR 止损、RR 1.5/2.0 与禁追价门全部通过，才生成显著标记的 `SYSTEM_REDERIVED`；否则 `REJECTED`。
- 作者原始计划会从发布时间回放到决策时点；期间先触发 SL/TP 即拒绝，同根 K 线同时覆盖 SL/TP 时保守按止损优先。作者止损还必须通过发布前结构和最小 0.4 ATR 距离门。
- 布林带收缩但尚未放量突破时降为 WATCH；只有方向一致且量能确认的突破才允许继续参与 TOP 判定。
- 共识按 symbol/direction、稳定作者ID与内容哈希建立；候选自身、同作者多帖和复制内容簇不增加共识分。
- 未验证作者不冒充 Tier A，作者可信度为 0 分。
- 精确验证 `TRADING / PERPETUAL / USDT` 合约。
- 每次真实运行保存完整 Futures 合约目录证据，不只保存本轮涉及的币种。
- Futures 公共行情：现价、标记价、指数价、资金费率、持仓量、24h量、15m/1h/4h/1d 已收盘 K 线。
- Futures 暂时不可用时，只允许 Spot Proxy 补价格和 OHLC；不得用 Spot 量冒充合约量。
- 指标：BB20、%B、BandWidth、ATR14、Futures volume ratio、多周期趋势。
- 固定 100 分评分、硬门槛、TOP3/WATCH5、同币多空冲突降级。
- 手续费、滑点、资金费率和深度模型默认未配置；只有完整注入成本参数且成本调整后主要目标 RR `>=2` 才可标记执行就绪，不能把名义 RR 报成净 RR。
- 本地不可变 raw/market/report JSON、Markdown、单一 `latest` 目录指针原子替换、SQLite logical run/attempt/manifest。
- 生产 logical run 仍由固定 UTC 四小时 slot 唯一标识；首次 attempt 的 `decision_at` 取 attempt-start UTC，并必须由 Binance server time 在30秒偏差内验证、且位于 slot 后 0–10 分钟。验证失败则 `market_catalog/FAILED`，禁止用本机时钟降级成功。SQLite `production_run_cutoff` 每轮只写一次；唯一一次 +10 分钟 retry 必须精确复用，不能改写 cutoff。帖子资格与已闭合 K 线以它为 cutoff；标量行情是随后抓取的实时验证值，必须单独显示 `captured_at`。
- `job_namespace + production_job_id + scheduled_for_utc` 共同隔离 production/canary 身份，避免不同账本生成相同逻辑运行或 attempt 标识。
- logical run 与 `RUNNING` attempt 在任何输入文件、catalog 或帖子详情采集之前落库；FETCH/分析/报告失败均终结为带阶段的 `FAILED`，retry只能从一个已审计的 FAILED attempt1 分配 attempt2。
- 生产跨轮去重只读取更早且 `SUCCEEDED` 的同 job 时槽；FAILED/RUNNING 不污染基线。回放默认明确显示 `NOT_COMPUTED`。
- v4.1 增量数据合同与追踪持久化继续保留：signal family/revision、PENDING/触发/结果、MFE/MAE/R；当前轮失败后查询自动排除其状态。
- UTC 六时槽、一次 +10 分钟重试、静默恢复与二次失败分类告警已有纯 shadow runner；重试成功仍生成该轮唯一的常规 `HELD/NO_SEND` 报告 intent，但不生成恢复告警；不安装任务、不发送。
- 报告分别记录广场抓取开始/完成、行情最新和报告生成时间；K线请求冻结 `endTime=decision_time_ms-1`，跨周期边界仍保持点时一致。
- 报告固定对账 Feed、Profile、Smart Money、官方新闻、行情目录五类来源；每类都显示 `COMPLETE/PARTIAL/FAILED/NOT_ATTEMPTED`、provenance、采集时间和证据清单，不能用一个来源替代另一个来源的完成度。
- Profile报告必须同时携带Smart Money与seed cohort分母；planned、五类终态、逐作者outcome、稳定身份、顶层状态与source coverage必须对账且唯一。覆盖率分子仅为`COMPLETE+EMPTY`，任何`PARTIAL`都不算完成；全EMPTY表示已穷尽无帖，归一为`COMPLETE`。

## 尚未生产化

- 源项目观测到官方 Web UI 提供 `PNL/ROI`，实现要求两榜均完整 TOP30 才能达到 `2/2 COMPLETE`。`VOLUME/WIN_RATE` 仍只是历史/扩展合同，不得宣称为当前 Smart Money UI 能力；安装者必须用当次证据重新确认。
- Smart Money 排行身份是 `topTraderId`，Square 作者主键是 `squareUid`，两者不相等且不得推断映射。榜单详情覆盖不能替代显式身份映射；没有映射就不能抓取对应 Square 内容、增加作者分或授予 Tier A。
- ROI 榜可能包含“小额本金、高倍收益率”的账户；ROI排名和详情字段只作候选发现证据，不能绕过公开实盘时长、Square内容质量、至少20条已触发信号及60天前向绩效门直接晋级 Tier A。
- 9个 Profile 身份/实盘上下文种子已固化，但最新内容抽样均未通过“同帖完整 Entry + SL + TP”质量门；作者分仍为0，尚无合格 Tier A 信号源。
- 源项目历史 canary 曾验证默认容量、窗口排除和DQ分账路径；该动态回执不随 Skill 发布，旧快照也不能替代M1b人工准确率审计。
- 没有真实 60 天绩效历史；作者表现分不能宣称已验证。
- Square Profile 内容主通道已有默认匿名真实抓取器。没有活动映射时，Smart Money cohort 必须显示 `0/60 mapping` 并保持零请求；独立 seed cohort 仍可按自身已验证 `squareUid` 抓取，但必须单独显示分母。运行环境中的动态映射、seed 和帖子证据不随发布包分发，因此干净安装默认仍是未映射状态。
- 交易成本模型保持既有状态，本轮明确不接入手续费或滑点参数；不得把名义 RR 报告成净 RR。
- 作者60天/长期表现的数据结构和追踪合同存在，但尚未把真实60天 point-in-time 聚合接入生产评分。
- Telegram 只有渲染与 `HELD/NO_SEND` intent，没有发送；没有安装每4小时调度。
- 不具备、也不允许真实下单。

任何账号访问、外部发送、常驻调度或交易权限都必须由当前操作者单独、明确授权；授权不替代数据质量、量化发布和独立复核门。

## 真实只读运行

建议使用顺序生产影子入口；它保证消费的是本轮刚写入且通过一致性检查的不可变 Feed 快照：

```bash
python3 scripts/run_production_cycle.py \
  --leaderboard-seed-evidence <optional-reviewed-seed-evidence.json> \
  --smart-money-square-mapping-catalog <optional-approved-mapping-catalog.json> \
  --job-namespace production \
  --production-job-id binance-square-shadow-v4 \
  --limit 200 \
  --no-send
```

独立 Profile seed 和 Smart Money cohort 会分别显示分母；seed 不会冒充榜单映射。单份人工复核映射可改用 `--smart-money-square-mapping-evidence <mapping.json>`，但它与 catalog 参数互斥。没有证据时保持未映射，不按名称猜测。

分步诊断入口：

在 Skill 根目录执行：

```bash
python3 scripts/run_radar.py \
  --real \
  --smart-money \
  --input-snapshot data/binance_raw_posts.json \
  --signals-json data/signal_check_input.json \
  --leaderboard-seed-evidence <optional-reviewed-seed-evidence.json> \
  --smart-money-square-mapping-evidence <optional-reviewed-mapping.json> \
  --official-news \
  --limit 200 \
  --output-dir data/v4/runs \
  --database data/v4/radar.sqlite \
  --no-send
```

真实模式不传 `--clock` 时，以 attempt-start UTC 作为24小时决策时间，并立即用币安 Futures server time 做30秒内校验；校验接口不可用时该 attempt 失败。logical run 固定到所属4小时 UTC 槽；首次决策时间超过 slot 10 分钟会拒绝运行，防止迟到执行污染错误轮次。`--limit` 范围为 1–200，默认200；高质量参数信号先并入，再用 canonical `post_id` 去重。

`--smart-money` 会在同一只读影子运行中实时采集公共 `PNL/ROI` TOP30及公开交易员详情。若已有不可变证据，使用 `--smart-money-fixture <evidence.json>` 做无网络回放；fixture 模式若请求 Smart Money 却未提供 fixture，会明确失败。

### 验收边界

- 本次仓库同步快照通过当前全量离线合同测试；确切项数以当次 `unittest discover` 输出为准。测试只证明代码路径、数据约束和失败关闭行为可复现。

From aAAaqwq/AGI-Super-Team, MIT.

More from aAAaqwq/AGI-Super-Team