Q-Silicon Institutional Research AI Agent

以 Python 串起 CrewAI、LiteLLM 與可選 LangGraph，並行產出 加密 與 AI／美股 研究；經 Pydantic 與 validate_report 後輸出 Telegram HTML。客觀數字來自工具與 API 注入，而非模型臆測。可選 BigQuery、Streamlit、FastAPI 與 React PWA。授權與本 repo 根目錄 LICENSE 一致（MIT）。

連結	用途
授權	LICENSE（MIT）·CONTRIBUTING.md · CODE_OF_CONDUCT.md
待辦	TODOS.md
Terminal 總表（中段 M1–M5 + Portal 長線 + 架構看法）	docs/architecture/Terminal_Master_Plan.md
Architecture 狀態索引（已落地／repo-side scaffold／研究稿）	docs/architecture/Terminal_Master_Plan.md#0-architecture-文件狀態矩陣
Portal PWA 驗收清單（§驗收）	docs/architecture/TERMINAL_FRONTEND_PLAN.md
Portal ship checklist（API／PWA／staging signoff）	docs/PORTAL_SHIP_CHECKLIST.md
視覺化狀態／剩餘 staging backlog（§3 勾選表）	docs/architecture/visualization_plan.md
變更紀錄	CHANGELOG.md
Tech pulse（可選，併入日報 exclusion）	docs/ADR_TECH_PULSE_INTEGRATION.md · ENV_TEMPLATE.txt TECH_PULSE_*
Staging 時事 roundtable smoke	docs/STAGING_CURRENT_AFFAIRS_SMOKE.md
營運隊列 18–21 自檢（Redis／VAPID／可選 BQ）	scripts/verify_ops_queue_18_21.py · docs/OPS_QUEUE_18_21_RUNBOOK.md
Reviewer production rollout（Queue 35）	docs/REVIEWER_PRODUCTION_ROLLOUT.md
執行路線圖	docs/REPO_CONTINUATION_EXECUTION.md
開發導覽	CLAUDE.md · AGENTS.md
環境變數	ENV_TEMPLATE.txt → 複製為 .env
日報版面	docs/DAILY_BRIEF_V2.md
日報模組化（路線圖，計畫文件）	modularization_plan.md

本 README 對齊 repo 現況（持續更新；重大變更見 CHANGELOG.md）。 細節與紅線亦見 .cursorrules。

Portal 架構 Phase 2 產品切片（2026-05-14）

與 docs/architecture/Terminal_Master_Plan.md §0 Phase 2 對齊（註：此處指架構治理下的 Portal 切片，非下方 12 週 Roadmap 段落裡的「Phase 2」紙上管線里程碑）：PWA Command Bar 顯示 Crew 執行狀態（輪詢 GET /api/run-crew/status，data-testid="terminal-crew-status-hud"）；Shared Monitor 內 Workspace 支援 同源多分頁 以 localStorage 的 storage 事件與自訂事件 qsi_workspace_changed 同步 layout／panels／高度權重（data-verification-ui/src/constants/workspaceSync.js）。Portal ship readiness 另補 execution-intents、symbols、run-crew router 拆分與 docs/PORTAL_SHIP_CHECKLIST.md；18–21／35 仍須 staging operator 完成雲端 signoff 後才可關帳。Playwright：command-bar-route.spec.js（含 HUD）、workspace-cross-tab.spec.js。變更摘要見 CHANGELOG.md 2026-05-14「PWA — Portal Phase 2」。

Portal 切片 — Crypto on-chain + 翻譯短評（隊列 45 · P5-mock / P4 · 2026-05-16）

P5-mock：/dashboard 在 compute-memory 下方新增 OnchainMetricsPanel.jsx 三區：BTC 估值（MVRV-Z／Realized／Spot/Realized）、交易所淨流入（CEX／Binance／Coinbase）、永續資費（BTC／ETH）。資料源 = 本機 fixture data/onchain_metrics_mock.json；後端 GET /api/macro/onchain 與 P2-mock 同模式（fixture-missing → enabled: false；live 需 fixture + ONCHAIN_LIVE=1 雙條件）。

P4：api_routers/news.py _normalize_item 增 commentary_zh／commentary_en 兩欄 passthrough（零 LLM 呼叫；zh 預設 fallback 既有 gemini_take，en 無 fallback）。ColumnsHome.jsx Deep Brief Panel 顯示中／EN toggle（兩段皆存在時才出現），保留 source URL + published_at 並標「短評為翻譯／轉述；非原文」。

Portal 切片 — 算力／記憶體 dashboard（隊列 45 · P2-mock · 2026-05-16）

/dashboard macro indicators 下方新增 ComputeMemoryPanel.jsx 三區並列：HBM/DRAM 現貨、Hyperscaler Capex、GPU 現貨（hourly）。資料源 = 本機 fixture data/compute_memory_mock.json（範本，數值預設 null + TEMPLATE 註記，避免假數字進產線）。後端：api_routers/macro.py 之 GET /api/macro/compute-memory，fixture 缺／JSON 無效時回 enabled: false；live flag 需 fixture + COMPUTE_MEMORY_LIVE=1 雙條件 才會 true（P2-live 入接 TrendForce／CoreWeave／hyperscaler capex 前需先過 governance 表）。E2E：dashboard-compute-memory.spec.js。

Portal 切片 — Portfolio TP/SL 計算機（隊列 45 · P1 · 2026-05-16）

/portfolio 頁面 KPI 卡下方新增 PortfolioRiskPanel.jsx：輸入 帳戶總值 × 每筆風險 %（持久化於 localStorage["qsi_risk_budget_v1"]，預設 1%）+ entry／stop／target → 即時輸出 R:R、% 至 stop／target、建議股數（floor(預算 ÷ 每股風險)）、名目部位與實際風險 $。輸入 symbol 後可一鍵套用 ATR14 stop（純前端計算，重用 useAnalysisBundle 之 snapshot.price_series）或「帶入最後收盤」。算完一鍵 送入紙上 PENDING_REVIEW（重用 useCreateExecutionIntent → POST /api/execution-intents），後端零變更、不下單。E2E：portfolio-tpsl.spec.js。

This is the beginning of the README. Read the rest at the original. Read the full README ↗