docs: 同步操作说明/架构/路线图（归档操作、图表基座、数据库目标硬约束）

- USAGE 新增 §6.3.1「归档的日常操作」：查看 / 筛选（回写 URL）/ 导出完整 JSON /
  以此参数再跑 / 删除（写明「删除即失去结果，结果只存归档一份」）/
  历史归档用 restore_experiment_from_job 按原 id 重建；并说明归档完整度如何标注
- USAGE/README 更正技术栈与图表基座：TradingView Lightweight Charts 4.2.3 为唯一
  图表基座（ECharts 已从 package.json、pnpm-lock.yaml、node_modules、文档与
  架构图标注中全部清除），并记录实测证据（个股页图表根节点为
  div.tv-lightweight-charts，页面 canvas 无一来自其它图表库）
- ARCHITECTURE 更正「当前数据库」（原写 SQLite/未来 MySQL）：现为本机 MariaDB 10.11，
  §6 补目标库硬约束；USAGE 补服务器身份与实测连接证据
- AGENT.md 新增 §0.1：数据库目标只允许本机 MariaDB，禁止 192.168.1.10，
  由 config.py::assert_db_target_allowed 硬拦截（命中直接抛错，不静默降级）
- DEV_PLAN_DIVIDEND_BACKTEST 记录三轮实施与验证、归档恢复边界（§12.5）、已知限制
- DEV_PLAN v2/v3 标注为历史记录（避免把当时的远端库地址当现状照抄）；
  ROADMAP 更正 M3 图表选型

AGENT.md

@@ -40,6 +40,17 @@ wget -e use_proxy=yes -e http_proxy=http://192.168.1.160:3128 <url>
 - 代理 IP 属于局域网配置，不写入 `.env` / `config.yaml` / 任何提交进 Git 的文件。
 - 直接下载成功时不要多此一举走代理。
 
+### 0.1 数据库目标：只允许本机 MariaDB（硬约束）
+
+- 数据库一律指向**本机 MariaDB 10.11**（`127.0.0.1:3306/qlib`）。
+- **禁止把 `192.168.1.10` 作为数据库目标**（该地址在本文档中仅作外网代理白名单/SSH 提及，
+  不是数据库目标）。远端旧库只作为历史数据来源，已不再写入。
+- 该约束不是「靠自觉」：`app/core/config.py::assert_db_target_allowed` 在 `get_settings()`
+  解析出 URL 后立刻校验，命中禁用主机**直接抛错**（应用起不来），不允许「起得来但连错库」。
+  禁用列表默认 `192.168.1.10`，可用环境变量 `QLIB_FORBIDDEN_DB_HOSTS` 覆盖（空串＝不限制）。
+- 理由：连错库属于最危险的静默错误 —— 不报错、界面正常，回测/归档/策略却写到了另一台机器上。
+- 新增脚本/文档/示例配置时，DB 主机一律写 `127.0.0.1`，禁止出现远端库地址作为**默认值**。
+
 ---
 
 # 1. 项目定位