From 60994da07722559e87142bc27b566fb5ce7c4843 Mon Sep 17 00:00:00 2001 From: Chengyu Date: Tue, 30 Jun 2026 21:44:45 -0400 Subject: [PATCH] =?UTF-8?q?feat:=20bilingual=20(=E4=B8=AD=E6=96=87/English?= =?UTF-8?q?)=20dashboard,=20Chinese=20by=20default?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Dashboard artifact gains an EN/中文 toggle, defaulting to 中文; UI chrome and the strategy/rationale prose both localize. - Opportunity 'thesis' and 'risks' now accept a localizedText value (a plain string or a {en, zh} object), so scan output carries both languages; build_data maps it through and the template renders the active language. - artifacts.md / orchestration.md / SKILL.md document producing bilingual prose; tests cover localizedText mapping. --- SKILL.md | 4 + assets/build_data.py | 52 +++- assets/dashboard-template.html | 470 +++++++++++++++++++++--------- reference/artifacts.md | 29 +- reference/opportunity.schema.json | 14 +- reference/orchestration.md | 14 +- tests/test_build_data.py | 36 ++- 7 files changed, 444 insertions(+), 175 deletions(-) diff --git a/SKILL.md b/SKILL.md index ceb1f69..4f9f605 100644 --- a/SKILL.md +++ b/SKILL.md @@ -149,6 +149,10 @@ dashboard" / "display my positions or markets". When in doubt, build it. The art **cannot** run `poly` or call the MCP — so you inject a data snapshot at generation time. Full procedure, `DATA` schema, and source map: [reference/artifacts.md](reference/artifacts.md). +**The dashboard is bilingual (中文/English), defaulting to Chinese** with an instant header `中/EN` toggle. +The UI translates itself; for a scan, have the strategy sub-agents write `thesis` and `risks` bilingually +(`{"en":…,"zh":…}`) so the per-market analysis toggles too. Set `run.json.lang` to change the default. + 1. **Fetch** what they asked to see: Markets → **the 50 most-traded markets in the last 24h** (pass them as the `universe` pool — `build_data.py` ranks by `volume_24h` and takes the top 50), enriched via MCP `get_order_book_depth` / `get_price_history` / `get_market_stats` for depth / OHLC candles / flow; diff --git a/assets/build_data.py b/assets/build_data.py index 88a7118..e0dfd74 100644 --- a/assets/build_data.py +++ b/assets/build_data.py @@ -15,11 +15,14 @@ proposed_action:{side,order_type,price,size_usd}, edge_estimate, confidence, liquidity_check:{...}, risks:[...], signal:{...}, gate:{decision:"auto"|"escalate"|"skip", order_id?}}, ... ], + # thesis + each risk may be a plain string OR bilingual {en, zh} (the + # dashboard toggles language); strategy_note/gate_note are emitted bilingual. "enrichment": { "": {url, category, end_date, description, volume_total, net_flow, depth, candles} }, # for the shown markets "account": {...} | null, # null/empty when no wallet is set up -> Account tab shows setup steps "generated_at": "", "wallet_label": "deposit 0x…", + "lang": "zh" | "en", # dashboard default language (-> meta.lang); defaults to "zh" "stats": {...} | null # optional override of the stats strip } @@ -44,26 +47,39 @@ # Plain-language, user-facing one-liners shown on the recommendation cards. The full specs # live in reference/strategies/*.md; these are the short "what is this play" gloss so a reader -# understands *why it's an opportunity* without opening the spec. +# understands *why it's an opportunity* without opening the spec. Bilingual {en, zh}: the +# dashboard renders one side per the active language (default Chinese). STRATEGY_NOTES = { - "momentum": "rides a strong recent price move, betting the trend keeps going", - "mean-reversion": "bets a sharp overshoot snaps back toward its recent average", - "spread-capture": "earns the gap between the buy and sell price by posting resting orders", - "smart-money": "follows large, one-directional buying that looks informed", - "risk-free-arb": "locks a guaranteed profit when YES + NO together cost less than $1", - "multi-outcome-arb": "locks a profit when a market's outcomes price below $1 in total", + "momentum": {"en": "rides a strong recent price move, betting the trend keeps going", + "zh": "顺着近期的强势价格走势,押注趋势会延续"}, + "mean-reversion": {"en": "bets a sharp overshoot snaps back toward its recent average", + "zh": "押注急涨或急跌会回归到近期均值"}, + "spread-capture": {"en": "earns the gap between the buy and sell price by posting resting orders", + "zh": "通过挂单赚取买价与卖价之间的价差"}, + "smart-money": {"en": "follows large, one-directional buying that looks informed", + "zh": "跟随看起来有信息优势的大额单边买入"}, + "risk-free-arb": {"en": "locks a guaranteed profit when YES + NO together cost less than $1", + "zh": "当 YES + NO 加起来不到 $1 时锁定无风险利润"}, + "multi-outcome-arb": {"en": "locks a profit when a market's outcomes price below $1 in total", + "zh": "当一个市场所有结果加总价格低于 $1 时锁定利润"}, } # Why the risk gate set an opportunity aside — plain-language version of decide()'s reason # codes (keys must match risk_gate.py exactly). Turns "insufficient book depth at price" into -# something a reader understands as a *risk*, not a code. +# something a reader understands as a *risk*, not a code. Bilingual {en, zh}. GATE_REASON_NOTES = { - "confidence below report floor": "the signal was too weak to act on", - "market liquidity below floor": "too little money resting in this market to trade our size safely", - "insufficient book depth at price": "not enough resting orders at the target price, so filling would push the price against us", - "order notional over per-order cap": "the proposed order is larger than the per-trade limit", - "would breach per-run total cap": "buying it would push this scan past its total budget for the run", - "order would take too much resting depth": "the order would eat too large a share of the visible order book", + "confidence below report floor": {"en": "the signal was too weak to act on", + "zh": "信号太弱,不值得出手"}, + "market liquidity below floor": {"en": "too little money resting in this market to trade our size safely", + "zh": "这个市场的盘子太小,放不下我们的下单量"}, + "insufficient book depth at price": {"en": "not enough resting orders at the target price, so filling would push the price against us", + "zh": "目标价位上的挂单不够,成交会把价格推向不利的一侧"}, + "order notional over per-order cap": {"en": "the proposed order is larger than the per-trade limit", + "zh": "拟下单金额超过了单笔上限"}, + "would breach per-run total cap": {"en": "buying it would push this scan past its total budget for the run", + "zh": "买入会让本轮扫描超出总预算"}, + "order would take too much resting depth": {"en": "the order would eat too large a share of the visible order book", + "zh": "这一单会吃掉盘口里太大比例的挂单"}, } # Skipped/WATCH cards still sit in the "low" band, but show a small non-zero meter purely for @@ -156,6 +172,8 @@ def opportunity_to_recommendation(opp, universe_by_cond, enrich): signals.append("slippage " + _s(lc["est_slippage"])) for key, val in (opp.get("signal") or {}).items(): signals.append("%s %s" % (key, val)) + # risks are agent prose — may be plain strings OR bilingual {en, zh}; pass through as-is + # (the template's tv() resolves the active language). Never stringify an object. for risk in (opp.get("risks") or []): signals.append(risk) @@ -181,7 +199,10 @@ def opportunity_to_recommendation(opp, universe_by_cond, enrich): rec["strategy_note"] = note if skipped: reason = gate.get("reason") - rec["gate_note"] = GATE_REASON_NOTES.get(reason, reason) if reason else "set aside by the risk gate" + if not reason: + rec["gate_note"] = {"en": "set aside by the risk gate", "zh": "被风控闸门搁置"} + else: # known code -> bilingual gloss; unknown code -> wrap raw string for both langs + rec["gate_note"] = GATE_REASON_NOTES.get(reason, {"en": reason, "zh": reason}) price = (opp.get("proposed_action") or {}).get("price") if price is not None: rec["target_price"] = _s(price) @@ -229,6 +250,7 @@ def build_data(payload): "generated_at": payload.get("generated_at"), "wallet_label": payload.get("wallet_label", "no wallet"), "currency": "USDC", + "lang": payload.get("lang", "zh"), # dashboard default language (zh unless overridden) "stats": payload.get("stats") or compute_stats(universe), }, "markets": markets, diff --git a/assets/dashboard-template.html b/assets/dashboard-template.html index 23a2d3f..e3467d5 100644 --- a/assets/dashboard-template.html +++ b/assets/dashboard-template.html @@ -48,6 +48,13 @@ .regen{appearance:none;cursor:pointer;font-family:var(--mono);font-size:11.5px;color:var(--dim); background:transparent;border:1px solid var(--line);border-radius:6px;padding:5px 11px} .regen:hover{border-color:var(--signal);color:var(--text)} + .lang-toggle{display:inline-flex;border:1px solid var(--line);border-radius:6px;overflow:hidden} + .lang-btn{appearance:none;cursor:pointer;background:transparent;border:0;font-family:var(--mono); + font-size:11.5px;color:var(--faint);padding:5px 10px;transition:color .12s,background .12s} + .lang-btn+.lang-btn{border-left:1px solid var(--line)} + .lang-btn:hover{color:var(--dim)} + .lang-btn[aria-pressed="true"]{color:var(--ink);background:var(--signal)} + .lang-btn:focus-visible{outline:2px solid var(--signal);outline-offset:2px} /* ---------- tabs ---------- */ nav.tabs{display:flex;gap:2px;border-bottom:1px solid var(--line);margin:0 0 26px} @@ -395,76 +402,80 @@
◆ Polymarket - Odds Terminal + Odds Terminal
- +
+ + +
+ -