Web 工作台：把系统装进浏览器

命令行适合「每天自动跑」，但不适合「我现在就想看看茅台」。Web 工作台把同一套能力装进浏览器：手动分析、实时进度、历史报告、回测、持仓、告警、选股、配置与 Token 用量，都在一个界面里。

页面地图：12 个路由，各管一件事

工作台布局示意，非实际截图

手动分析一次，发生什么

POST /api/v1/analysis/analyze          # 单股/批量分析
GET  /api/v1/analysis/tasks            # 任务列表
GET  /api/v1/analysis/tasks/{id}/flow  # 四段式运行诊断
GET  /api/v1/analysis/status/{id}      # 状态
GET  /api/v1/history                   # 历史分页
GET  /api/v1/history/{id}/markdown     # 完整 Markdown
GET  /api/v1/history/{id}/share-image  # 分享海报

前端：React 19 + Vite + Tailwind

前端是一个典型的现代 SPA：React 19、React Router 7、Vite 7、TypeScript、Tailwind 4、Zustand、axios、Recharts。状态管理很克制，只有少数几个 store：分析任务、Agent 会话、股票池。没有 Redux，也没有 React Query。

• API 层：axios 同源请求，带 Cookie；响应统一从 snake_case 转 camelCase；401 自动跳登录。
• 主题：默认深色，首屏脚本恢复上次选择，避免闪烁。
• 国际化：自研 key 字典（中文/英文），不是 i18next；切换时同步 <html lang>。
• 构建：npm run build 输出到仓库根 static/，由 FastAPI 托管；npm run dev 可独立开发。

cd apps/dsa-web
npm ci
npm run dev        # 本地开发
npm run build      # 产出到 ../../static
npm run lint
npm run test       # Vitest（CI 默认不跑）
npm run test:smoke # Playwright

后端：FastAPI + SSE + 静态托管

api/app.py 创建 FastAPI 应用，挂载 /api/v1、认证中间件、静态资源与 SPA fallback。lifespan 启动时会恢复 Web 内配置的定时任务、预热股票索引；关闭时停止调度。

API：15 组、约 131 个端点

所有路由挂在 /api/v1。它不是「内部接口随便开」，而是有认证、错误封装、分页与限流的正式 API，也可以被 Bot、桌面端与外部集成复用。

认证：默认关闭，公网必须打开

DSA 是单管理员模型：ADMIN_AUTH_ENABLED=true 后，首次访问会引导设置密码。密码用 PBKDF2-SHA256（10 万次迭代 + 随机盐）存哈希；会话是 HttpOnly + SameSite=Lax 的 dsa_session Cookie，默认 24 小时；失败登录 5 次/300 秒限流；登出会轮换密钥，使所有旧会话失效。

认证中间件只保护 /api/v1/*，放行登录、状态、健康检查与文档。未登录返回 401 JSON，前端据此跳转登录页。

持仓、告警、选股与用量

桌面端：把 Web 装进一个窗口

apps/dsa-desktop 用 Electron 封装 Web 与后端，打包成可双击安装的客户端，适合不想开浏览器的用户。桌面端复用同一套 API，分享海报可以由本地 Chromium 截图生成。具体打包流程见 docs/desktop-package.md。

常见问题

源码与文档锚点