feat(hub): add symbol archive with permanent 5m klines

Add /archive page, hub_symbol_archive.db, trade overlay, 4h background sync, and instance /api/hub/trades/archive. Document in hub-symbol-archive-kline.md with cross-links.

Co-authored-by: Cursor <cursoragent@cursor.com>

manual_trading_hub/使用说明.md

@@ -1,6 +1,6 @@
 # 多账户交易中控 — 使用说明
 
-本文档说明 **manual_trading_hub** 的架构、启动方式、界面操作与故障排查。中控聚合四所 **持仓/条件单/余额/关键位/趋势计划监控 + 撤单/紧急全平**，并提供 **行情区 K 线**；**人工下单、关键位、策略交易（趋势回调 / 顺势加仓）、交易复盘** 均在各实例网页操作（点监控卡片 **「实例」**）。行情区细则见 **[行情区说明.md](./行情区说明.md)**。
+本文档说明 **manual_trading_hub** 的架构、启动方式、界面操作与故障排查。中控聚合四所 **持仓/条件单/余额/关键位/趋势计划监控 + 撤单/紧急全平**，并提供 **行情区 K 线** 与 **币种档案（永久 K 线复盘）**；**人工下单、关键位、策略交易（趋势回调 / 顺势加仓）、交易复盘** 均在各实例网页操作（点监控卡片 **「实例」**）。行情区细则见 **[行情区说明.md](./行情区说明.md)**；币种档案见 **[docs/hub-symbol-archive-kline.md](../docs/hub-symbol-archive-kline.md)**。
 
 ---
 
@@ -10,6 +10,7 @@
 浏览器
   ├─ /monitor   监控区（持仓、关键位、趋势计划、全平）
   ├─ /market    行情区（K 线、技术指标、持仓价格线）
+  ├─ /archive   币种档案（交易时间线 + 永久 5m K 线）
   ├─ /ai        AI 教练（四户今日总结 + 聊天）
   └─ /settings  系统设置（hub_settings.json）
 
@@ -127,6 +128,7 @@ pm2 save
 
 - 监控区：`http://127.0.0.1:5100/monitor`  
 - 行情区：`http://127.0.0.1:5100/market`  
+- 币种档案：`http://127.0.0.1:5100/archive`  
 - 系统设置：`http://127.0.0.1:5100/settings`  
 
 验收：
@@ -178,6 +180,19 @@ Chrome **桌面快捷方式**图标来自站点 `favicon` / `manifest`（已配
 
 数据经中控 → 各实例 `GET /api/hub/ohlcv`（`hub_ohlcv_lib`）。升级 hub 与四实例 Flask 后请 **强刷浏览器**；异常 K 线可点 **强制刷新**。
 
+### 4.2.1 币种档案 `/archive`
+
+| 功能 | 说明 |
+|------|------|
+| **列表** | 一所一币一行；数据来自四所 `trade_records`（`GET /api/hub/trades/archive`） |
+| **筛选** | 交易所、有盈利单、有亏损单、犯病/情绪标签（中控 overlay，不上传图片） |
+| **明细** | 交易时间线；可编辑备注与犯病/情绪标签 |
+| **K 线** | 独立库 `data/hub_symbol_archive.db`；仅存 **5m** 真源，**15m/1h/4h** 聚合；默认 Tab **15m** |
+| **建档** | 最早开仓向前 **30 天** 5m 种子；之后每 **4h** 增量（Hub 后台 + 可点「同步」） |
+| **视窗** | **持仓过程**（锚平仓）/ **进场决策**（锚开仓）；支持时间输入跳转 |
+
+与行情区 `hub_kline.db`（15 天滚动）**分离**，建档起 **只增不删**。细则见 **[docs/hub-symbol-archive-kline.md](../docs/hub-symbol-archive-kline.md)**。
+
 ### 4.3 AI 教练 `/ai`
 
 | 功能 | 说明 |
@@ -303,6 +318,12 @@ PM2：仓库 `ecosystem.config.cjs` 默认只有四 agent；第五户需自行 `
 | GET | `/api/ping` | 版本与健康检查（**免登录**） |
 | GET | `/api/chart/meta` | 行情区：交易所、周期、limit |
 | GET | `/api/chart/ohlcv` | 行情区 K 线（`exchange_key`、`symbol`、`timeframe`、可选 `refresh=1`） |
+| GET | `/api/archive/meta` | 币种档案：周期、同步间隔 |
+| GET | `/api/archive/list` | 币种列表（筛选 query） |
+| GET | `/api/archive/detail` | 单币种交易时间线 |
+| GET | `/api/archive/ohlcv` | 档案 K 线视窗 |
+| PATCH | `/api/archive/trade/{exchange_key}/{trade_id}` | 犯病/情绪标签与备注 |
+| POST | `/api/archive/sync` | 立即同步四所交易与 K 线 |
 
 已移除的 `/api/trade/*` 若被旧缓存页面请求，返回 **410** 并提示前往各实例网页。
 
@@ -313,6 +334,7 @@ PM2：仓库 `ecosystem.config.cjs` 默认只有四 agent；第五户需自行 `
 | `/api/hub/ping` | 连通与能力 |
 | `/api/hub/monitor` | 关键位、机器人单、趋势计划 |
 | `/api/hub/ohlcv` | 行情区 OHLCV（ccxt 拉取，供中控聚合缓存） |
+| `/api/hub/trades/archive` | 币种档案：近 N 天已平仓（`days` / `limit`） |
 
 ---
 
@@ -334,6 +356,10 @@ PM2：仓库 `ecosystem.config.cjs` 默认只有四 agent；第五户需自行 `
 | `HUB_SESSION_DAYS` | `7` | 登录保持天数 |
 | `HUB_KLINE_RETENTION_DAYS` | `15` | 行情区 K 线库保留天数 |
 | `HUB_KLINE_DB_PATH` | `data/hub_kline.db` | K 线 SQLite 路径 |
+| `HUB_ARCHIVE_DB_PATH` | `data/hub_symbol_archive.db` | 币种档案永久 K 线库 |
+| `HUB_ARCHIVE_SYNC_INTERVAL_SEC` | `14400` | 档案 K 线后台同步间隔（秒） |
+| `HUB_ARCHIVE_TRADE_DAYS` | `365` | 同步交易记录回看天数 |
+| `HUB_ARCHIVE_TRADE_LIMIT` | `2000` | 单所同步交易条数上限 |
 
 ### 子代理 agent.py
 
@@ -443,6 +469,7 @@ pm2 save && pm2 startup
 |------|------|
 | [使用说明.md](./使用说明.md) | 本文 |
 | [行情区说明.md](./行情区说明.md) | K 线周期、缓存、快捷键、API |
+| [docs/hub-symbol-archive-kline.md](../docs/hub-symbol-archive-kline.md) | 币种档案、永久 5m、建档与同步 |
 | [部署文档.md](./部署文档.md) | Ubuntu / PM2 / 反代 |
 | [常见问题.md](./常见问题.md) | 故障实录与排障 |
 | [README.md](./README.md) | 速览 |