一个面向中国市场的主题研究与交易仪表盘，聚焦 硅基文明消费股：AI 基础设施为了存在、扩张和迭代所持续消耗的算力、互连、散热、电力、IDC、存储、半导体设备与材料等供给链。

静态快照站点：https://scs.maxlv.net

“硅基文明消费”不是指人类购买 AI 产品，而是假设人工智能形成基于硅的文明后，它们自身为了运行和扩张所需要消费的东西。系统做多这些“喂养”硅基文明的卖铲人：

• 算力芯片、AI 服务器、云计算与 IDC 数据中心
• 光模块、高速互连、高速 PCB、HBM/存储
• 液冷散热、电力、绿电与核电
• 半导体设备、材料、晶圆代工与相关制造链

• 主题股票池：按子主题维护 A 股标的，数据源为 web/data/universe.json。
• 实时行情与目标价：从本地 Python sidecar 拉取现价、估值、分析师目标价和上涨空间。
• DeepSeek 策略信号：支持实时信号页和 TypeScript 回测引擎。
• 前端加载体验：从 pyserver 拉取行情时显示进度条；行情/分析师缓存集中在 pyserver SQLite，前端不写浏览器缓存。
• 静态快照：生成 docs/ 下的 GitHub Pages 静态页面，包含社交卡片、站点图标和自定义域名。

flowchart LR
  web["Next.js 15 App Router<br/>web/<br/><br/>自选股 / 信号 / 回测 UI<br/>API routes 与 TypeScript 回测<br/>DeepSeek 策略与缓存"]
  py["FastAPI sidecar<br/>pyserver/<br/><br/>Tushare Pro + AkShare<br/>SQLite 市场数据缓存<br/>批量行情 / 分析师接口"]
  docs["GitHub Pages snapshot<br/>docs/<br/><br/>https://scs.maxlv.net<br/>社交卡片 / 图标 / CNAME"]

  web -- HTTP --> py
  web --> docs

pyserver 当前数据源策略：

• /klines：A 股优先 Tushare pro_bar，港股使用 AkShare 港股历史行情。
• /fundamental：A 股优先 AkShare 东方财富快照，失败后回退 Tushare daily_basic。
• /analyst 与 /analysts：优先 AkShare 研报/盈利预测，失败后回退 Tushare report_rc。
• /spot 与 /spot/batch：A 股优先 AkShare 东方财富快照，港股使用 AkShare 港股历史行情，失败后回退 Tushare 日线。

cd pyserver
cp env.example .env
# 在 .env 中设置 TUSHARE_TOKEN
uv sync
uv run uvicorn main:app --port 8001 --reload

cd web
npm install
cp env.example.txt .env.local
# 在 .env.local 中设置 DEEPSEEK_API_KEY、DEEPSEEK_BASE_URL、PYSERVER_URL
npm run dev

打开 http://localhost:3000。

web/.env.local 示例：

DEEPSEEK_API_KEY=sk-...
DEEPSEEK_MODEL=deepseek-v4-pro
DEEPSEEK_MODEL_BACKTEST=deepseek-v4-flash
DEEPSEEK_BASE_URL=https://api.deepseek.com
PYSERVER_URL=http://localhost:8001

静态站点发布自 docs/，GitHub Pages 自定义域名为 scs.maxlv.net，域名配置保存在 docs/CNAME。

生成快照：

cd web
npx tsx scripts/snapshot.ts

如果只想快速刷新股票池静态页，可以跳过信号和回测：

cd web
SNAPSHOT_SKIP_SIGNALS=1 SNAPSHOT_SKIP_BACKTEST=1 npx tsx scripts/snapshot.ts

本地预览：

python3 -m http.server 8765 --directory docs

silicon-civilization-stock-trade/
├── docs/                      # GitHub Pages 静态快照、图标、社交卡片、CNAME
├── pyserver/                  # FastAPI + Tushare Pro/AkShare sidecar
│   ├── main.py
│   ├── env.example
│   ├── pyproject.toml
│   └── uv.lock
└── web/                       # Next.js 15 App Router
    ├── app/
    │   ├── page.tsx
    │   ├── signals/page.tsx
    │   ├── backtest/page.tsx
    │   └── api/
    │       ├── analyst/batch/route.ts
    │       ├── spot/batch/route.ts
    │       └── backtest/route.ts
    ├── data/universe.json     # 可编辑股票池
    ├── lib/
    │   ├── universe.ts
    │   ├── pyserver.ts
    │   ├── deepseek.ts
    │   ├── backtest.ts
    │   └── cache.ts
    └── test/

不要在同一个工作区里同时运行 npm run dev 和 npm run build，否则 .next 产物可能互相干扰。需要构建前先停止 dev server。

停止本地服务：

lsof -ti:3000,8001 | xargs kill

• 不要提交 .env、.env.local、cache.db、.cache/、.next/、node_modules/ 或任何 API key。
• TUSHARE_TOKEN 仅放在 pyserver/.env。
• DEEPSEEK_API_KEY、DEEPSEEK_BASE_URL、PYSERVER_URL 仅放在 web/.env.local。
• 对外文档和默认配置不要写入私有服务器地址、真实 token 或临时调试 URL。

本仓库要求线性历史。处理冲突时使用 rebase 或 cherry-pick，推送已重写分支时使用 --force-with-lease；不要引入 merge commit。