aria-code 0.52.0__py3-none-any.whl

aria_code/apps/cli/prompts/ui.py

@@ -0,0 +1,436 @@
+"""
+ui.py — Aria UI Skill System Prompt
+Bloomberg-quality HTML generation for financial dashboards, reports, and data views.
+"""
+
+UI_SYSTEM_PROMPT = """\
+You are Aria UI, a specialist in generating professional, production-grade HTML interfaces for any product domain.
+Choose the visual language that fits the product, target users, information hierarchy, and existing brand. Use
+finance-terminal patterns only for explicitly financial products; do not impose them on consumer, SaaS, developer,
+commerce, education, health, or other interfaces.
+
+## CORE PHILOSOPHY
+Information density over aesthetics. Every pixel earns its place.
+The user reads data, not art. Clarity beats beauty.
+
+## ABSOLUTE OUTPUT RULES
+1. Output ONLY a single complete HTML file. No explanation, no markdown fences.
+2. ALL data must be real — fetched via Python (yfinance / akshare) and embedded as JavaScript variables.
+   NEVER hardcode placeholder prices like "150.00" or "N/A" for fields you could compute.
+3. The HTML must be fully self-contained: no external fetch calls at runtime, no CDN dependencies.
+   Google Fonts (@import) is the ONLY allowed external resource.
+4. Always save to os.path.expanduser('~/Documents/Aria Code/generated/<descriptive_name>.html').
+5. After write_file, open in browser: run_command: open ~/Documents/Aria Code/generated/<name>.html (macOS) or start <name>.html (Windows).
+
+## DESIGN SYSTEM — BLOOMBERG STYLE
+
+### Typography
+- Body / labels: 'IBM Plex Sans', system-ui, sans-serif
+- Numbers / prices / codes: 'IBM Plex Mono', 'Courier New', monospace
+- Load via: @import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;600&family=IBM+Plex+Sans:wght@400;600;700&display=swap');
+- All prices, percentages, and quantities: font-family: var(--font-mono); font-variant-numeric: tabular-nums;
+- Section headers: font-size: 10px; font-weight: 700; text-transform: uppercase; letter-spacing: 0.12em;
+- NO emojis anywhere — use text indicators instead:
+  - Up trend:   [+] or ▲ or colored text
+  - Down trend: [-] or ▼ or colored text
+  - Active:     [ON]  Inactive: [OFF]
+  - Warning:    [!]   OK: [OK]
+
+### Color System — CSS Variables (MUST use these exact names)
+```css
+:root {
+  /* Dark mode (default) */
+  --bg-primary:    #000000;
+  --bg-secondary:  #111111;
+  --bg-tertiary:   #1A1A1A;
+  --bg-hover:      #222222;
+  --border:        #2A2A2A;
+  --border-strong: #444444;
+  --text-primary:  #E8E9EA;
+  --text-secondary:#A0A0A0;
+  --text-muted:    #606060;
+  --accent:        #F5A623;   /* Bloomberg orange */
+  --accent-dim:    #7A5010;
+  --positive:      #00CC66;
+  --positive-dim:  #004422;
+  --negative:      #FF3B3B;
+  --negative-dim:  #440000;
+  --neutral:       #4A9EFF;
+  --warning:       #FFB800;
+}
+@media (prefers-color-scheme: light) {
+  :root {
+    --bg-primary:    #FFFFFF;
+    --bg-secondary:  #F4F4F4;
+    --bg-tertiary:   #EAEAEA;
+    --bg-hover:      #E0E0E0;
+    --border:        #CCCCCC;
+    --border-strong: #999999;
+    --text-primary:  #111111;
+    --text-secondary:#444444;
+    --text-muted:    #888888;
+    --accent:        #B8520A;
+    --accent-dim:    #FAE0C8;
+    --positive:      #006B2E;
+    --positive-dim:  #D4F0E0;
+    --negative:      #B30000;
+    --negative-dim:  #FFE0E0;
+    --neutral:       #0057B7;
+    --warning:       #8B6000;
+  }
+}
+```
+
+### Layout Rules
+- border-radius: 0 everywhere — flat, terminal aesthetic
+- Base spacing unit: 4px. Use 4, 8, 12, 16, 20, 24, 32px — never odd values
+- Max content width: 1440px, centered
+- Grid: use CSS Grid with explicit columns, never flexbox for multi-column layouts
+- Body padding: 16px on sides, 12px top
+- Section gap: 20px
+- Card padding: 12px
+- Table row height: 28px (compact), 36px (comfortable)
+
+### Component Patterns
+
+**Section Header:**
+```html
+<div class="section-header">SECTION TITLE</div>
+```
+```css
+.section-header {
+  font-size: 10px; font-weight: 700; text-transform: uppercase;
+  letter-spacing: 0.12em; color: var(--text-muted);
+  border-bottom: 1px solid var(--border);
+  padding-bottom: 6px; margin-bottom: 10px;
+}
+```
+
+**Quote Tile (compact, for index grids):**
+```html
+<div class="qt">
+  <div class="qt-sym">SPX</div>
+  <div class="qt-name">S&P 500</div>
+  <div class="qt-price">5,847.23</div>
+  <div class="qt-change up">+0.84%</div>
+</div>
+```
+```css
+.qt { background: var(--bg-secondary); border: 1px solid var(--border); padding: 10px 12px; display: flex; flex-direction: column; gap: 2px; }
+.qt-sym   { font-family: var(--font-mono); font-size: 11px; color: var(--accent); font-weight: 600; }
+.qt-name  { font-size: 10px; color: var(--text-muted); }
+.qt-price { font-family: var(--font-mono); font-size: 20px; font-weight: 600; color: var(--text-primary); letter-spacing: -0.01em; }
+.qt-change { font-family: var(--font-mono); font-size: 12px; font-weight: 600; }
+.up   { color: var(--positive); }
+.down { color: var(--negative); }
+.flat { color: var(--text-muted); }
+```
+
+**Data Table (dense, financial):**
+```html
+<table class="data-table">
+  <thead><tr><th>SYMBOL</th><th class="r">PRICE</th><th class="r">CHG%</th></tr></thead>
+  <tbody>
+    <tr><td class="sym">AAPL</td><td class="num">185.42</td><td class="num up">+1.23%</td></tr>
+  </tbody>
+</table>
+```
+```css
+.data-table { width: 100%; border-collapse: collapse; font-size: 12px; }
+.data-table th { background: var(--bg-tertiary); color: var(--text-muted); font-size: 10px;
+  font-weight: 700; text-transform: uppercase; letter-spacing: 0.08em;
+  padding: 6px 10px; text-align: left; border-bottom: 1px solid var(--border-strong);
+  white-space: nowrap; }
+.data-table th.r, .data-table td.r { text-align: right; }
+.data-table td { padding: 5px 10px; border-bottom: 1px solid var(--border); vertical-align: middle; }
+.data-table tr:hover td { background: var(--bg-hover); }
+.data-table tr:last-child td { border-bottom: none; }
+.sym  { font-family: var(--font-mono); font-weight: 600; color: var(--accent); font-size: 12px; }
+.num  { font-family: var(--font-mono); text-align: right; }
+```
+
+**Metric Card (KPI summary):**
+```html
+<div class="metric">
+  <div class="metric-label">TOTAL PNL</div>
+  <div class="metric-val up">+¥12,480</div>
+  <div class="metric-sub">unrealized</div>
+</div>
+```
+```css
+.metric { background: var(--bg-secondary); border: 1px solid var(--border); padding: 14px 16px; }
+.metric-label { font-size: 10px; font-weight: 700; text-transform: uppercase;
+  letter-spacing: 0.1em; color: var(--text-muted); margin-bottom: 6px; }
+.metric-val   { font-family: var(--font-mono); font-size: 24px; font-weight: 600;
+  color: var(--text-primary); letter-spacing: -0.02em; }
+.metric-sub   { font-size: 10px; color: var(--text-muted); margin-top: 4px; }
+```
+
+**Status Badge (no emoji):**
+```html
+<span class="badge badge-on">ACTIVE</span>
+<span class="badge badge-off">STOPPED</span>
+<span class="badge badge-warn">WARNING</span>
+```
+```css
+.badge { font-family: var(--font-mono); font-size: 9px; font-weight: 700;
+  padding: 2px 6px; letter-spacing: 0.08em; border: 1px solid; }
+.badge-on   { color: var(--positive); border-color: var(--positive); background: var(--positive-dim); }
+.badge-off  { color: var(--text-muted); border-color: var(--border); background: transparent; }
+.badge-warn { color: var(--warning); border-color: var(--warning); background: transparent; }
+```
+
+**Top Bar / Header:**
+```html
+<header class="topbar">
+  <div class="topbar-brand">ARIA <span>TERMINAL</span></div>
+  <div class="topbar-meta">Generated 2026-06-17 10:45  ·  Data: yfinance + Local DB</div>
+</header>
+```
+```css
+.topbar { display: flex; align-items: baseline; justify-content: space-between;
+  border-bottom: 2px solid var(--accent); padding: 10px 0 8px; margin-bottom: 20px; }
+.topbar-brand { font-family: var(--font-mono); font-size: 18px; font-weight: 700;
+  color: var(--accent); letter-spacing: 0.04em; }
+.topbar-brand span { color: var(--text-secondary); font-weight: 400; margin-left: 4px; }
+.topbar-meta { font-size: 10px; color: var(--text-muted); letter-spacing: 0.04em; }
+```
+
+**Change Indicator with direction marker:**
+```html
+<span class="chg up">+1.84%</span>
+<span class="chg down">-2.31%</span>
+```
+Always prepend sign: positive gets "+", negative already has "-", zero shows "0.00%".
+
+### FORBIDDEN patterns
+- NO emojis (no , no , no , no  — anywhere)
+- NO rounded corners (border-radius: 0 always)
+- NO gradient backgrounds
+- NO box shadows
+- NO animations except: cursor blink on live data indicators (optional)
+- NO external JS libraries (no Chart.js, no D3, no jQuery)
+- NO placeholder data that you did not fetch
+- NO inline styles for colors — use CSS variables only
+
+## WORKFLOW
+
+When user requests a UI artifact (dashboard, report, heatmap, etc.):
+
+1. **Plan data requirements**: what symbols / metrics are needed
+2. **write_file**: write complete Python script to ~/Documents/Aria Code/generated/aria_ui_<name>_generator.py
+   - Script fetches ALL data, embeds as JS constants, renders full HTML
+   - Script saves to ~/Documents/Aria Code/generated/aria_<name>_<YYYYMMDD>.html
+3. **run_command**: python3 ~/Documents/Aria Code/generated/aria_ui_<name>_generator.py
+4. **run_command**: open ~/Documents/Aria Code/generated/aria_<name>_<date>.html
+
+The generator script structure:
+```python
+import os, json
+from datetime import datetime
+import yfinance as yf  # or akshare for A-share
+
+# --- Fetch data ---
+# ... fetch all required data ...
+
+# --- Render HTML ---
+now = datetime.now().strftime("%Y-%m-%d %H:%M")
+data_json = json.dumps(data, ensure_ascii=False)
+
+html = f\\'\\'\\'<!DOCTYPE html>
+<html lang="zh"><head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width,initial-scale=1.0">
+<title>ARIA TERMINAL — {title}</title>
+<style>
+@import url(\\'https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;600&family=IBM+Plex+Sans:wght@400;600;700&display=swap\\');
+/* ... full Bloomberg design system CSS ... */
+</style>
+</head><body>
+<!-- Bloomberg-style layout with all data embedded -->
+</body></html>\\'\\'\\'
+
+out = os.path.expanduser(f\\'~/Documents/Aria Code/generated/aria_{name}_{datetime.now().strftime("%Y%m%d")}.html\\')
+with open(out, \\'w\\', encoding=\\'utf-8\\') as f: f.write(html)
+print(f\\'Saved: {out}\\')
+```
+
+## WHAT TO GENERATE FOR COMMON REQUESTS
+
+- "行情看板 / market dashboard" → quote tiles grid (4x4), top movers table, volume leaders, sector heatmap (text-based color cells)
+- "持仓报告 / portfolio report" → positions table, P&L summary metrics, allocation bar (ASCII-style), trade history
+- "策略回测报告 / backtest report" → equity curve (SVG path), drawdown chart (SVG), trade log table, metrics card grid
+- "因子分析 / factor analysis" → factor table, z-score heatmap (color cells), quintile return bar chart (SVG bars)
+- "晨报 / morning brief" → compact layout, indices strip, overnight changes, key events calendar table
+- "股票分析 / stock analysis" → header with key metrics, price + volume SVG chart, technical indicators table, company fundamentals
+
+For SVG charts: generate them inline, no external SVG libraries.
+Use <path> for line charts, <rect> for bar charts, <text> for labels.
+Scale data to viewport coordinates mathematically (min-max normalization).
+"""
+
+UI_STYLE_GUIDE = {
+    "fonts": {
+        "sans": "'IBM Plex Sans', system-ui, sans-serif",
+        "mono": "'IBM Plex Mono', 'Courier New', monospace",
+    },
+    "colors": {
+        "dark": {
+            "bg_primary":   "#000000",
+            "bg_secondary": "#111111",
+            "bg_tertiary":  "#1A1A1A",
+            "accent":       "#F5A623",
+            "positive":     "#00CC66",
+            "negative":     "#FF3B3B",
+            "text":         "#E8E9EA",
+            "muted":        "#606060",
+            "border":       "#2A2A2A",
+        },
+        "light": {
+            "bg_primary":   "#FFFFFF",
+            "bg_secondary": "#F4F4F4",
+            "bg_tertiary":  "#EAEAEA",
+            "accent":       "#B8520A",
+            "positive":     "#006B2E",
+            "negative":     "#B30000",
+            "text":         "#111111",
+            "muted":        "#888888",
+            "border":       "#CCCCCC",
+        },
+    },
+    "principles": [
+        "No emojis — use [+]/[-]/[!]/[ON]/[OFF] text indicators",
+        "No border-radius — flat terminal aesthetic",
+        "No gradients or shadows",
+        "IBM Plex Mono for all numbers and prices",
+        "Tabular-nums for all numeric columns",
+        "prefers-color-scheme for auto dark/light",
+        "All data embedded at generation time — zero runtime API calls",
+    ],
+}
+
+
+def get_ui_css_base() -> str:
+    """Return the complete Bloomberg-style CSS base as a string for embedding in generated HTML."""
+    return """
+@import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;600&family=IBM+Plex+Sans:wght@400;600;700&display=swap');
+
+:root {
+  --bg-primary:    #000000;
+  --bg-secondary:  #111111;
+  --bg-tertiary:   #1A1A1A;
+  --bg-hover:      #222222;
+  --border:        #2A2A2A;
+  --border-strong: #444444;
+  --text-primary:  #E8E9EA;
+  --text-secondary:#A0A0A0;
+  --text-muted:    #606060;
+  --accent:        #F5A623;
+  --accent-dim:    #7A5010;
+  --positive:      #00CC66;
+  --positive-dim:  #003318;
+  --negative:      #FF3B3B;
+  --negative-dim:  #3D0000;
+  --neutral:       #4A9EFF;
+  --warning:       #FFB800;
+  --font-sans: 'IBM Plex Sans', system-ui, sans-serif;
+  --font-mono: 'IBM Plex Mono', 'Courier New', monospace;
+}
+@media (prefers-color-scheme: light) {
+  :root {
+    --bg-primary:    #FFFFFF;
+    --bg-secondary:  #F4F4F4;
+    --bg-tertiary:   #EAEAEA;
+    --bg-hover:      #E0E0E0;
+    --border:        #CCCCCC;
+    --border-strong: #999999;
+    --text-primary:  #111111;
+    --text-secondary:#444444;
+    --text-muted:    #888888;
+    --accent:        #B8520A;
+    --accent-dim:    #FAE0C8;
+    --positive:      #006B2E;
+    --positive-dim:  #D4F0E0;
+    --negative:      #B30000;
+    --negative-dim:  #FFE0E0;
+    --neutral:       #0057B7;
+    --warning:       #8B6000;
+  }
+}
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+html { font-size: 13px; }
+body {
+  font-family: var(--font-sans);
+  background: var(--bg-primary);
+  color: var(--text-primary);
+  padding: 12px 16px 32px;
+  max-width: 1440px;
+  margin: 0 auto;
+  line-height: 1.4;
+}
+/* ── Top bar ── */
+.topbar { display: flex; align-items: baseline; justify-content: space-between;
+  border-bottom: 2px solid var(--accent); padding-bottom: 8px; margin-bottom: 20px; }
+.topbar-brand { font-family: var(--font-mono); font-size: 16px; font-weight: 700;
+  color: var(--accent); letter-spacing: 0.06em; }
+.topbar-brand span { color: var(--text-secondary); font-weight: 400; }
+.topbar-meta { font-size: 10px; color: var(--text-muted); letter-spacing: 0.04em; font-family: var(--font-mono); }
+/* ── Section header ── */
+.sh { font-size: 10px; font-weight: 700; text-transform: uppercase; letter-spacing: 0.12em;
+  color: var(--text-muted); border-bottom: 1px solid var(--border);
+  padding-bottom: 5px; margin-bottom: 10px; }
+/* ── Layout ── */
+.section { margin-bottom: 20px; }
+.grid { display: grid; gap: 1px; background: var(--border); border: 1px solid var(--border); }
+.g2 { grid-template-columns: 1fr 1fr; }
+.g3 { grid-template-columns: repeat(3, 1fr); }
+.g4 { grid-template-columns: repeat(4, 1fr); }
+.g5 { grid-template-columns: repeat(5, 1fr); }
+.g6 { grid-template-columns: repeat(6, 1fr); }
+.gcol2 { grid-template-columns: 2fr 1fr; }
+.gcol3 { grid-template-columns: 3fr 1fr; }
+/* ── Quote tile ── */
+.qt { background: var(--bg-secondary); padding: 10px 12px;
+  display: flex; flex-direction: column; gap: 2px; }
+.qt-sym   { font-family: var(--font-mono); font-size: 11px; color: var(--accent); font-weight: 600; }
+.qt-name  { font-size: 10px; color: var(--text-muted); }
+.qt-price { font-family: var(--font-mono); font-size: 20px; font-weight: 600;
+  color: var(--text-primary); letter-spacing: -0.01em; font-variant-numeric: tabular-nums; }
+.qt-chg   { font-family: var(--font-mono); font-size: 12px; font-weight: 600; }
+.up   { color: var(--positive); }
+.down { color: var(--negative); }
+.flat { color: var(--text-muted); }
+/* ── Metric card ── */
+.metric { background: var(--bg-secondary); padding: 14px 16px; }
+.metric-label { font-size: 10px; font-weight: 700; text-transform: uppercase;
+  letter-spacing: 0.1em; color: var(--text-muted); margin-bottom: 6px; }
+.metric-val { font-family: var(--font-mono); font-size: 22px; font-weight: 600;
+  color: var(--text-primary); letter-spacing: -0.02em; font-variant-numeric: tabular-nums; }
+.metric-sub { font-size: 10px; color: var(--text-muted); margin-top: 3px; font-family: var(--font-mono); }
+/* ── Data table ── */
+.data-table { width: 100%; border-collapse: collapse; font-size: 12px; }
+.data-table th { background: var(--bg-tertiary); color: var(--text-muted); font-size: 10px;
+  font-weight: 700; text-transform: uppercase; letter-spacing: 0.08em;
+  padding: 6px 10px; text-align: left; border-bottom: 1px solid var(--border-strong);
+  white-space: nowrap; font-family: var(--font-sans); }
+.data-table td { padding: 5px 10px; border-bottom: 1px solid var(--border); vertical-align: middle; }
+.data-table tr:hover td { background: var(--bg-hover); }
+.data-table tr:last-child td { border-bottom: none; }
+.r { text-align: right; }
+.sym { font-family: var(--font-mono); font-weight: 600; color: var(--accent); font-size: 12px; }
+.num { font-family: var(--font-mono); text-align: right; font-variant-numeric: tabular-nums; }
+.dim { color: var(--text-muted); font-size: 11px; }
+/* ── Badge ── */
+.badge { font-family: var(--font-mono); font-size: 9px; font-weight: 700;
+  padding: 1px 5px; letter-spacing: 0.06em; border: 1px solid; }
+.badge-on   { color: var(--positive); border-color: var(--positive); background: var(--positive-dim); }
+.badge-off  { color: var(--text-muted); border-color: var(--border); background: transparent; }
+.badge-warn { color: var(--warning); border-color: var(--warning); background: transparent; }
+/* ── Card ── */
+.card { background: var(--bg-secondary); border: 1px solid var(--border); padding: 14px; }
+/* ── Divider ── */
+hr { border: none; border-top: 1px solid var(--border); margin: 16px 0; }
+/* ── Responsive ── */
+@media (max-width: 960px) { .g4,.g5,.g6 { grid-template-columns: repeat(2, 1fr); } }
+@media (max-width: 600px) { .g2,.g3,.g4 { grid-template-columns: 1fr; } }
+"""

aria_code/apps/cli/provider_endpoints.py

@@ -0,0 +1,237 @@
+"""Provider 端点表与 API key 连通性测试 —— 从 aria_cli.py 抽出。
+
+这两块（_PROVIDER_BASE_URLS 的 28 个端点 + _test_api_key 的 178 行分支）跟
+aria_cli 的会话状态完全无关：一个是纯数据，一个是纯函数（给定 provider 与
+key，发一次 HTTP 请求判断是否有效）。放在 7278 行的主文件里只是历史原因。
+
+⚠️ 调用约束（跟 apps/cli/football_reports.py 同一套）：
+apps/cli/commands/model_cmds.py 是 mixin，它用**裸名**调用 _test_api_key，
+靠 aria_cli 的 _rebind_mixin_globals() 把方法 __globals__ 指向 aria_cli 命名
+空间才能解析。所以本模块不能只是被 import，必须由 aria_cli 用
+_rebind_module_function_globals() 绑回它自己的 globals。
+"""
+
+from __future__ import annotations
+
+from typing import Dict, Tuple
+
+__all__ = ["PROVIDER_BASE_URLS", "_PROVIDER_BASE_URLS", "_test_api_key"]
+
+
+_PROVIDER_BASE_URLS: Dict[str, str] = {
+    # ── 国际主流 ──────────────────────────────────────────────────────
+    "deepseek":    "https://api.deepseek.com",
+    "openai":      "https://api.openai.com",
+    "anthropic":   "https://api.anthropic.com",
+    "claude":      "https://api.anthropic.com",
+    "groq":        "https://api.groq.com/openai",
+    "together":    "https://api.together.xyz",
+    "google":      "https://generativelanguage.googleapis.com/v1beta/openai",
+    "gemini":      "https://generativelanguage.googleapis.com/v1beta/openai",
+    "xai":         "https://api.x.ai/v1",
+    "grok":        "https://api.x.ai/v1",
+    "mistral":     "https://api.mistral.ai/v1",
+    "cohere":      "https://api.cohere.ai/compatibility/v1",
+    "perplexity":  "https://api.perplexity.ai",
+    # ── 国内主流 ──────────────────────────────────────────────────────
+    "dashscope":   "https://dashscope.aliyuncs.com/compatible-mode",
+    "aliyun":      "https://dashscope.aliyuncs.com/compatible-mode",
+    "siliconflow": "https://api.siliconflow.cn",
+    "moonshot":    "https://api.moonshot.cn/v1",
+    "zhipu":       "https://open.bigmodel.cn/api/paas/v4",
+    "glm":         "https://open.bigmodel.cn/api/paas/v4",
+    "baidu":       "https://qianfan.baidubce.com/v2",
+    "ernie":       "https://qianfan.baidubce.com/v2",
+    "qianfan":     "https://qianfan.baidubce.com/v2",
+    "bytedance":   "https://ark.cn-beijing.volces.com/api/v3",
+    "doubao":      "https://ark.cn-beijing.volces.com/api/v3",
+    "ark":         "https://ark.cn-beijing.volces.com/api/v3",
+    "minimax":     "https://api.minimax.chat/v1",
+    "stepfun":     "https://api.stepfun.com/v1",
+    "01ai":        "https://api.lingyiwanwu.com/v1",
+    "yi":          "https://api.lingyiwanwu.com/v1",
+}
+
+
+def _test_api_key(provider: str, key: str) -> tuple:
+    """Test if an API key is valid. Returns (ok: bool, message: str)."""
+    import urllib.request as _ur
+    import urllib.error as _ue
+    import json as _json
+
+    provider = provider.lower()
+
+    try:
+        # ── Anthropic (different auth scheme) ────────────────────────────────
+        if provider in ("anthropic", "claude"):
+            req = _ur.Request(
+                "https://api.anthropic.com/v1/models",
+                headers={
+                    "x-api-key": key,
+                    "anthropic-version": "2023-06-01",
+                },
+            )
+            with _ur.urlopen(req, timeout=8) as r:
+                return True, f"✅ Anthropic  HTTP {r.status}  key 有效"
+
+        # ── ZhiPu (JWT-based, just try /v1/models) ───────────────────────────
+        if provider == "zhipu":
+            base = _PROVIDER_BASE_URLS.get("zhipu", "https://open.bigmodel.cn/api/paas/v4")
+            req = _ur.Request(
+                base.rstrip("/") + "/models",
+                headers={"Authorization": f"Bearer {key}"},
+            )
+            try:
+                with _ur.urlopen(req, timeout=8) as r:
+                    return True, f"✅ 智谱 GLM  HTTP {r.status}  key 有效"
+            except _ue.HTTPError as e:
+                if e.code in (401, 403):
+                    return False, f"❌ 智谱 GLM  HTTP {e.code}  key 无效"
+                return True, f"✅ 智谱 GLM  HTTP {e.code}  可连接"
+
+        # ── Standard OpenAI-compat LLM providers ─────────────────────────────
+        if provider in _PROVIDER_BASE_URLS:
+            base = _PROVIDER_BASE_URLS[provider].rstrip("/")
+            # Avoid double /v1 when base already ends with /v1 or /v2 etc.
+            if base.endswith(("/v1", "/v2", "/v3", "/v4", "/openai")):
+                url = base + "/models"
+            else:
+                url = base + "/v1/models"
+            req = _ur.Request(url, headers={"Authorization": f"Bearer {key}"})
+            try:
+                with _ur.urlopen(req, timeout=8) as r:
+                    return True, f"✅ {provider.capitalize()}  HTTP {r.status}  key 有效"
+            except _ue.HTTPError as e:
+                if e.code in (401, 403):
+                    return False, f"❌ {provider.capitalize()}  HTTP {e.code}  key 无效或已过期"
+                return True, f"✅ {provider.capitalize()}  HTTP {e.code}  可连接"
+
+        # ── Data services ─────────────────────────────────────────────────────
+        if provider == "finnhub":
+            url = f"https://finnhub.io/api/v1/quote?symbol=AAPL&token={key}"
+            req = _ur.Request(url, headers={"User-Agent": "aria-code/1.0"})
+            with _ur.urlopen(req, timeout=8) as r:
+                body = _json.loads(r.read())
+                if body.get("error"):
+                    return False, f"❌ Finnhub  error: {body['error']}"
+                price = body.get("c", "?")
+                return True, f"✅ Finnhub  AAPL现价 ${price}  key 有效"
+
+        if provider == "alphavantage":
+            url = f"https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=AAPL&apikey={key}"
+            req = _ur.Request(url, headers={"User-Agent": "aria-code/1.0"})
+            with _ur.urlopen(req, timeout=10) as r:
+                body = _json.loads(r.read())
+                if "Information" in body:
+                    return False, f"❌ Alpha Vantage  超出频率限制或 key 无效"
+                if "Global Quote" in body and body["Global Quote"]:
+                    price = body["Global Quote"].get("05. price", "?")
+                    return True, f"✅ Alpha Vantage  AAPL=${price}  key 有效"
+                return False, f"❌ Alpha Vantage  返回异常: {str(body)[:80]}"
+
+        if provider == "polygon":
+            url = f"https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2024-01-09/2024-01-09?adjusted=true&sort=asc&limit=1&apiKey={key}"
+            req = _ur.Request(url, headers={"User-Agent": "aria-code/1.0"})
+            try:
+                with _ur.urlopen(req, timeout=8) as r:
+                    body = _json.loads(r.read())
+                    if body.get("status") == "OK":
+                        return True, f"✅ Polygon  {body.get('resultsCount', 0)} 条数据  key 有效"
+                    return False, f"❌ Polygon  {body.get('status', 'unknown')}: {body.get('error', '')}"
+            except _ue.HTTPError as e:
+                if e.code == 403:
+                    return False, f"❌ Polygon  HTTP 403  key 无效"
+                return True, f"✅ Polygon  HTTP {e.code}  可连接"
+
+        if provider == "fmp":
+            url = f"https://financialmodelingprep.com/api/v3/quote/AAPL?apikey={key}"
+            req = _ur.Request(url, headers={"User-Agent": "aria-code/1.0"})
+            with _ur.urlopen(req, timeout=8) as r:
+                body = _json.loads(r.read())
+                if isinstance(body, list) and body:
+                    price = body[0].get("price", "?")
+                    return True, f"✅ FMP  AAPL=${price}  key 有效"
+                if isinstance(body, dict) and "Error Message" in body:
+                    return False, f"❌ FMP  {body['Error Message']}"
+                return False, f"❌ FMP  返回异常: {str(body)[:80]}"
+
+        if provider == "twelvedata":
+            url = f"https://api.twelvedata.com/api_usage?apikey={key}"
+            req = _ur.Request(url, headers={"User-Agent": "aria-code/1.0"})
+            with _ur.urlopen(req, timeout=8) as r:
+                body = _json.loads(r.read())
+                if body.get("status") == "error":
+                    return False, f"❌ TwelveData  {body.get('message', 'key 无效')}"
+                used = body.get("current_usage", {}).get("daily", {}).get("used", "?")
+                limit = body.get("current_usage", {}).get("daily", {}).get("limit", "?")
+                return True, f"✅ TwelveData  今日已用 {used}/{limit}  key 有效"
+
+        if provider == "newsapi":
+            url = f"https://newsapi.org/v2/top-headlines?country=us&pageSize=1&apiKey={key}"
+            req = _ur.Request(url, headers={"User-Agent": "aria-code/1.0"})
+            try:
+                with _ur.urlopen(req, timeout=8) as r:
+                    body = _json.loads(r.read())
+                    if body.get("status") == "ok":
+                        return True, f"✅ NewsAPI  {body.get('totalResults', 0)} 条新闻  key 有效"
+                    return False, f"❌ NewsAPI  {body.get('message', 'key 无效')}"
+            except _ue.HTTPError as e:
+                err_body = _json.loads(e.read().decode()) if e.read else {}
+                return False, f"❌ NewsAPI  HTTP {e.code}  {err_body.get('message', '')}"
+
+        if provider == "coingecko":
+            url = "https://pro-api.coingecko.com/api/v3/ping"
+            req = _ur.Request(url, headers={"x-cg-pro-api-key": key, "User-Agent": "aria-code/1.0"})
+            try:
+                with _ur.urlopen(req, timeout=8) as r:
+                    return True, f"✅ CoinGecko Pro  key 有效"
+            except _ue.HTTPError as e:
+                if e.code == 401:
+                    url2 = f"https://api.coingecko.com/api/v3/ping?x_cg_demo_api_key={key}"
+                    req2 = _ur.Request(url2, headers={"User-Agent": "aria-code/1.0"})
+                    try:
+                        with _ur.urlopen(req2, timeout=8) as r2:
+                            return True, f"✅ CoinGecko Demo  key 有效"
+                    except Exception:
+                        pass
+                return False, f"❌ CoinGecko  HTTP {e.code}  key 无效"
+
+        if provider == "tavily":
+            import urllib.parse as _up
+            data = _json.dumps({"api_key": key, "query": "test", "max_results": 1}).encode()
+            req = _ur.Request(
+                "https://api.tavily.com/search",
+                data=data,
+                headers={"Content-Type": "application/json", "User-Agent": "aria-code/1.0"},
+            )
+            try:
+                with _ur.urlopen(req, timeout=10) as r:
+                    return True, f"✅ Tavily  HTTP {r.status}  key 有效"
+            except _ue.HTTPError as e:
+                if e.code == 401:
+                    return False, f"❌ Tavily  HTTP 401  key 无效"
+                return True, f"✅ Tavily  HTTP {e.code}  可连接"
+
+        if provider == "brave":
+            req = _ur.Request(
+                "https://api.search.brave.com/res/v1/web/search?q=AAPL&count=1",
+                headers={"X-Subscription-Token": key, "User-Agent": "aria-code/1.0"},
+            )
+            try:
+                with _ur.urlopen(req, timeout=8) as r:
+                    return True, f"✅ Brave Search  HTTP {r.status}  key 有效"
+            except _ue.HTTPError as e:
+                if e.code == 401:
+                    return False, f"❌ Brave Search  HTTP 401  key 无效"
+                return True, f"✅ Brave Search  HTTP {e.code}  可连接"
+
+        return False, f"⚠ 未知 provider '{provider}'，无法测试"
+
+    except _ue.URLError as e:
+        return False, f"❌ 网络错误: {e.reason}"
+    except Exception as e:
+        return False, f"❌ 测试失败: {e}"
+
+
+# 对外的规范名；_PROVIDER_BASE_URLS 保留给既有裸名调用方。
+PROVIDER_BASE_URLS = _PROVIDER_BASE_URLS