candidate-pool 2.0.0

package/db/schema.sql

@@ -0,0 +1,225 @@
+-- ===========================================================================
+-- Cloudflare D1 建表脚本（SQLite 语法）
+-- 用法：见 db/.env.example 与部署步骤；首次建库后执行本文件。
+-- 设计要点：
+--   1) pick_record 为「一次运行 × 一只票」一行，同票跨 run 自动成多行，
+--      满足「同一只股票在不同时期被收录，全部保留、可区分」的需求。
+--   2) 所有时间字段（*_at / *_date / date）统一为「北京时间字符串」，
+--      格式 YYYY-MM-DD HH:mm:ss（无 Z），由 dayjs 生成，避免 +8h 时差。
+--   3) 列注释以 SQL 行内注释（--）书写，已写入 sqlite_master 的建表原文，
+--      在 DB Browser for SQLite / DBeaver 等工具的「DDL / SQL」视图中可直接查看。
+-- ===========================================================================
+
+-- ---------------------------------------------------------------------------
+-- 股票基础档案：一票一档，长期复用。
+-- 题材 / 地域 / 主营 / 最赚钱业务由 enrich_stock_base.js 低频从东财 F10 补全。
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS stock_base (
+  code            TEXT PRIMARY KEY,                -- 股票代码（沪深京，如 sh600519 / sz000001 / bj830799）
+  name            TEXT,                            -- 股票名称（以行情接口返回为准）
+  sector          TEXT,                            -- 申万一级行业
+  concepts        TEXT,                            -- 题材概念（顿号分隔，如「锂电池、光伏、军工」）
+  region          TEXT,                            -- 地域（省份/城市）
+  main_business   TEXT,                            -- 主营业务概述
+  top_business    TEXT,                            -- 最赚钱业务（按毛利率挑选，含毛利率/营收占比）
+  updated_at      TEXT                             -- 档案最近更新时间（北京时间 YYYY-MM-DD HH:mm:ss）
+);
+
+-- ---------------------------------------------------------------------------
+-- 每日运行批次：一次初筛（一个 anchor_date）对应一行汇总。
+-- anchor_date = 数据锚定日（收盘后的 T-1）；target_date = 面向的交易日（T）。
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS run_batch (
+  id              INTEGER PRIMARY KEY AUTOINCREMENT,
+  anchor_date     TEXT UNIQUE,                     -- 锚定日（YYYY-MM-DD），唯一；初筛数据基于该日收盘
+  target_date     TEXT,                            -- 面向交易日（YYYY-MM-DD，即 T）
+  run_at          TEXT,                            -- 本批次运行时间（北京时间 YYYY-MM-DD HH:mm:ss）
+  universe_count  INTEGER,                         -- 观察池标的总数
+  r01_count       INTEGER,                         -- 触发 R01（量能验证突破）的标的数
+  r07_count       INTEGER,                         -- 触发 R07（板块内补涨滞后）的标的数
+  r05_count       INTEGER,                         -- 触发 R05（尾盘量价部分达标）的标的数
+  high_count      INTEGER,                         -- 重点（R01 四门槛全过）数量
+  secondary_count INTEGER,                         -- 次级（R01 核心项≥3 且市值/高位区达标）数量
+  conditional_count INTEGER,                       -- 条件（R01 核心项≥2 且市值/高位区达标）数量
+  excluded_count  INTEGER,                         -- 未达任何梯队的数量（仅统计，不入库）
+  kline_fail_rate REAL,                            -- K 线获取失败率（0~1，越高数据越不可靠）
+  source          TEXT,                            -- 数据来源（如 tencent-live / tencent-offline）
+  note            TEXT                             -- 备注（人工或脚本补充）
+);
+
+-- ---------------------------------------------------------------------------
+-- 入选 / 评估记录：每次运行、每只入选票一行（同票跨 run 成多行）。
+-- tier 仅表示 R01 梯队；即便 tier='excluded'，只要触发 R07/R05 也会被写入
+--   （r07_laggard / r05_partial 标记为 1），前端据此识别其入选维度。
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS pick_record (
+  id               INTEGER PRIMARY KEY AUTOINCREMENT,
+  run_id           INTEGER NOT NULL,               -- 关联 run_batch.id
+  anchor_date      TEXT NOT NULL,                  -- 锚定日（YYYY-MM-DD）
+  code             TEXT NOT NULL,                  -- 股票代码
+  name             TEXT,                           -- 股票名称（快照时刻）
+  sector           TEXT,                           -- 申万一级行业
+  tier             TEXT,                           -- 梯队：high / secondary / conditional / excluded
+  r01_ok           INTEGER,                        -- 0/1：R01 四门槛是否全过（重点）
+  r07_laggard      INTEGER,                        -- 0/1：是否触发 R07 板块内补涨滞后
+  r05_partial      INTEGER,                        -- 0/1：是否触发 R05 尾盘量价部分达标
+  core             INTEGER,                        -- R01 量价突破达成项数（0~4）
+  r01_chg          REAL,                           -- 当日涨幅 %（R01 口径）
+  price            REAL,                           -- 入选价（收盘价，元）
+  turnover         REAL,                           -- 当日换手率 %
+  vol_ratio        REAL,                           -- 量比（当日成交量 ÷ 近 5 日均量；R01 C1 口径）
+  circ_market_cap  REAL,                           -- 流通市值（元）
+  total_market_cap REAL,                           -- 总市值（元）
+  sector_pct       REAL,                           -- 所属行业当日涨幅中位数 %
+  sector_rank      INTEGER,                        -- 行业内的涨幅排名（R07 口径）
+  reason           TEXT,                           -- 入选 / 排除原因（中文说明）
+  picked_at        TEXT,                           -- 入选记录写入时间（北京时间 YYYY-MM-DD HH:mm:ss）
+  run_at           TEXT,                           -- 快照生成时刻（北京时间）；双写冲突时用于 recency guard（仅当更新值更新才覆盖）
+  UNIQUE(run_id, code)
+);
+
+-- ---------------------------------------------------------------------------
+-- 日线行情：全观察池每日一条，作为入选后 N 日表现复盘的收益底座。
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS price_daily (
+  code              TEXT NOT NULL,                 -- 股票代码
+  date              TEXT NOT NULL,                 -- 行情日期（YYYY-MM-DD，锚定日）
+  open              REAL,                          -- 开盘价（元）
+  high              REAL,                          -- 最高价（元）
+  low               REAL,                          -- 最低价（元）
+  close             REAL,                          -- 收盘价（元）
+  chg_pct           REAL,                          -- 当日涨跌幅 %
+  turnover          REAL,                          -- 换手率 %
+  circ_market_cap   REAL,                          -- 流通市值（元）
+  total_market_cap  REAL,                          -- 总市值（元）
+  run_at            TEXT,                           -- 快照生成时刻（北京时间）；双写冲突时用于 recency guard
+  PRIMARY KEY (code, date)
+);
+
+-- ---------------------------------------------------------------------------
+-- 自定义分组：用于把票按主题/策略分类观察（如「军工」「低位补涨」）。
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS watch_group (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  name        TEXT UNIQUE NOT NULL,                -- 分组名称（唯一）
+  color       TEXT,                                -- 分组颜色（十六进制，如 #4F8DFD），前端展示用
+  description TEXT,                                -- 分组说明
+  created_at  TEXT                                 -- 创建时间（北京时间 YYYY-MM-DD HH:mm:ss）
+);
+
+-- ---------------------------------------------------------------------------
+-- 票-组 关联：一只票可加入多个分组。
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS pick_group_rel (
+  code       TEXT NOT NULL,                        -- 股票代码
+  group_id   INTEGER NOT NULL,                     -- 关联 watch_group.id
+  note       TEXT,                                 -- 入组备注（如入选该组的理由）
+  created_at TEXT,                                 -- 关联创建时间（北京时间 YYYY-MM-DD HH:mm:ss）
+  PRIMARY KEY (code, group_id)
+);
+
+-- ---------------------------------------------------------------------------
+-- 评论 / 备注：可按运行（anchor_date）或纯按票记录。
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS stock_note (
+  id         INTEGER PRIMARY KEY AUTOINCREMENT,
+  code       TEXT NOT NULL,                        -- 股票代码
+  anchor_date TEXT,                                -- 关联运行锚定日（可空：通用备注，不限某次运行）
+  type       TEXT,                                 -- 类型：comment（评论）/ memo（备忘）
+  content    TEXT NOT NULL,                        -- 备注内容
+  created_at TEXT                                  -- 创建时间（北京时间 YYYY-MM-DD HH:mm:ss）
+);
+
+-- ---------------------------------------------------------------------------
+-- 尾盘选股：运行批次（一个交易日 × 一种口径一行）。
+-- mode = 'formal'（14:50 固定口径）/ 'observe'（14:30~14:50 观察口径）。
+-- runs_json / stats_json 分别存当日多次运行历史与初筛漏斗统计（JSON）。
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS tail_run (
+  trade_date      TEXT NOT NULL,                   -- 交易日（YYYY-MM-DD）
+  mode            TEXT NOT NULL,                   -- formal | observe
+  cut_at          TEXT,                            -- 截断时点 HHMM（如 1450）
+  updated_at      TEXT,                            -- 最近落库时间（北京时间）
+  run_at          TEXT,                            -- 最近一次运行时刻（runs[] 末条 at）
+  candidate_count INTEGER,                         -- 候选数
+  group_count     INTEGER,                         -- 行业组数
+  pre_pass_count  INTEGER,                         -- 初筛通过数
+  snapshot_count  INTEGER,                         -- 全市场快照数
+  runner          TEXT,                            -- local | github
+  runs_json       TEXT,                            -- 当日多次运行历史（JSON 数组）
+  stats_json      TEXT,                            -- 初筛/漏斗统计（JSON）
+  PRIMARY KEY (trade_date, mode)
+);
+
+-- ---------------------------------------------------------------------------
+-- 尾盘选股：候选记录（一个交易日 × 一种口径 × 一只票一行）。
+-- 字段对应 eod/lib/store.js 的 toRecord；六项打分存 score_json，尾盘段存 tail_*，
+-- 收盘回填的 N1~N10 表现存 fill_json（P5 脚本写入，缺失时由 worker 从 price_daily 现算）。
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS tail_pick (
+  trade_date      TEXT NOT NULL,                   -- 交易日（YYYY-MM-DD）
+  mode            TEXT NOT NULL,                   -- formal | observe
+  code            TEXT NOT NULL,                   -- 股票代码（sh/sz/bj 前缀）
+  name            TEXT,                            -- 名称
+  sector          TEXT,                            -- 行业（东财/申万）
+  board           TEXT,                            -- 板块代码（sh/sz/bj）
+  board_label     TEXT,                            -- 板块中文名
+  price           REAL,                            -- 入选价（14:50 截点价，元）
+  prev_close      REAL,                            -- 昨收
+  high            REAL,                            -- 当日最高
+  chg_pct         REAL,                            -- 当日涨幅 %
+  turnover        REAL,                            -- 换手率 %
+  vol_ratio       REAL,                            -- 量比
+  vol_ratio_est   REAL,                            -- 收盘预估量比（参考值）
+  float_cap_yi    REAL,                            -- 流通市值（亿）
+  avg_price       REAL,                            -- 均价
+  group_rank      INTEGER,                         -- 组内排名
+  best_in_group   INTEGER,                         -- 0/1：组内最佳
+  group_size      INTEGER,                         -- 同组数量
+  total           REAL,                            -- 总分（0~100）
+  sector_median_chg REAL,                          -- 行业当日涨幅中位数 %
+  sector_rank     INTEGER,                         -- 行业内涨幅排名
+  sector_total    INTEGER,                         -- 行业总数
+  tail_seg_pct    REAL,                            -- 尾盘段（14:30→14:50）涨幅 %
+  tail_up_ratio   REAL,                            -- 段内上涨分钟占比
+  tail_max_drawdown_pct REAL,                      -- 段内最大回撤 %
+  tail_price_vs_avg_pct REAL,                      -- 现价相对均价超出 %
+  tail_avg_at_cut REAL,                            -- 截点时刻均价
+  tail_p0         REAL,                            -- 段起点价
+  tail_p1         REAL,                            -- 段终点价
+  tail_bars       TEXT,                            -- 尾盘段分钟序列（JSON 数组）
+  score_json      TEXT,                            -- 六项子分（JSON）
+  fill_json       TEXT,                            -- 收盘回填：{close,n1..n10,filled_at}（JSON）
+  PRIMARY KEY (trade_date, mode, code)
+);
+
+-- ---------------------------------------------------------------------------
+-- 索引：加速按交易日 / 按口径 / 按票 的查询。
+-- ---------------------------------------------------------------------------
+CREATE INDEX IF NOT EXISTS idx_pick_code ON pick_record(code);
+CREATE INDEX IF NOT EXISTS idx_pick_date ON pick_record(anchor_date);
+CREATE INDEX IF NOT EXISTS idx_pick_tier ON pick_record(tier);
+CREATE INDEX IF NOT EXISTS idx_pick_run  ON pick_record(run_id);
+CREATE INDEX IF NOT EXISTS idx_price_code ON price_daily(code);
+CREATE INDEX IF NOT EXISTS idx_price_date ON price_daily(date);
+CREATE INDEX IF NOT EXISTS idx_note_code  ON stock_note(code);
+CREATE INDEX IF NOT EXISTS idx_group_rel_code ON pick_group_rel(code);
+CREATE INDEX IF NOT EXISTS idx_group_rel_gid ON pick_group_rel(group_id);
+
+-- 尾盘选股索引
+CREATE INDEX IF NOT EXISTS idx_tail_pick_date ON tail_pick(trade_date);
+CREATE INDEX IF NOT EXISTS idx_tail_pick_mode ON tail_pick(mode);
+CREATE INDEX IF NOT EXISTS idx_tail_pick_code ON tail_pick(code);
+
+-- ---------------------------------------------------------------------------
+-- 结构同步元信息（由 db/migrate.js 维护，业务代码不读它）。
+--   key = 'schema_hash'  → 已应用到本库的 schema.sql 指纹（用于核对两端是否同一版本）
+--   key = 'mig:<文件名>' → 已执行过的增量迁移（db/migrations/*.sql，只跑一次）
+-- 用途：跑 `npm run db:migrate` 后一眼看出「本地/线上各自同步到哪一版」，避免再出现
+-- 「代码已引用新表、库里没有」这种只在运行时才暴露的问题。
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS schema_meta (
+  key        TEXT PRIMARY KEY,
+  value      TEXT,
+  updated_at TEXT
+);

package/db/sqlite_client.js

@@ -0,0 +1,81 @@
+'use strict';
+// 本地 SQLite 客户端：使用 Node 22 内置 node:sqlite，零依赖。
+// 接口与 d1client.js 完全一致（exec / query / batch 均为 async），
+// persist.js / enrich_stock_base.js 可以「本地开发」与「Cloudflare D1」之间无缝切换。
+//
+// 用法：
+//   const { createClient } = require('./sqlite_client');
+//   const db = createClient();           // 默认 db/local.db
+//   const db = createClient('x.db');     // 指定文件
+//   await db.query('SELECT ...', [p]);   // 查询 -> 行数组
+//   await db.query('INSERT ...', [p]);   // 写入 -> []
+//   await db.batch([{sql, params}, ...]);
+//   db.close();
+
+const fs = require('fs');
+const path = require('path');
+
+// 必须在 require node:sqlite 之前抑制实验性告警（否则仍会在首次加载时打印）
+const _origEmit = process.emit;
+process.emit = function (type, ...args) {
+  if (type === 'warning' && args[0] && args[0].name === 'ExperimentalWarning' &&
+      /SQLite/i.test(args[0].message || '')) return false;
+  return _origEmit.apply(process, arguments);
+};
+
+const { DatabaseSync } = require('node:sqlite');
+
+const paths = require('../paths');
+
+// 本地库文件跟随工作目录（见 paths.js）：默认 <仓库根>/db/local.db。
+// 注意 SCHEMA_FILE 是**代码资产**，永远跟包走，不随工作目录移动。
+const DEFAULT_FILE = paths.localDb();
+const SCHEMA_FILE = path.join(__dirname, 'schema.sql');
+
+function applySchema(db) {
+  const sql = fs.readFileSync(SCHEMA_FILE, 'utf8');
+  db.exec(sql); // schema.sql 全部 IF NOT EXISTS，可重复执行
+}
+
+function createClient(file) {
+  const f = file || DEFAULT_FILE;
+  const dir = path.dirname(f);
+  if (dir && !fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+
+  const db = new DatabaseSync(f);
+  // 每次打开都应用 schema.sql：它是唯一真相源，且全部 IF NOT EXISTS，重复执行安全（毫秒级）。
+  // 反面教训（2026-09-21 线上四页 500）：原实现是「仅当缺 run_batch 表时才建表」——
+  // 于是库早已存在的机器上，后续新增的 tail_run / tail_pick 永远不会被创建，
+  // 本地库结构永久停在旧版本，直到某个接口查询时才炸。不要再加任何「缺某表才建」的条件。
+  applySchema(db);
+
+  const isRead = (sql) => /^\s*(SELECT|WITH|PRAGMA|EXPLAIN|VALUES)\b/i.test(sql.trim());
+
+  async function exec(sql) { db.exec(sql); return []; }
+
+  async function query(sql, params = []) {
+    const ps = db.prepare(sql);
+    if (isRead(sql)) return ps.all(...params);
+    ps.run(...params);
+    return [];
+  }
+
+  async function batch(statements) {
+    // 显式事务（不依赖 node:sqlite 的 db.transaction，跨版本更稳）
+    db.exec('BEGIN');
+    try {
+      for (const st of statements) db.prepare(st.sql).run(...(st.params || []));
+      db.exec('COMMIT');
+    } catch (e) {
+      try { db.exec('ROLLBACK'); } catch (_) {}
+      throw e;
+    }
+    return [];
+  }
+
+  function close() { try { db.close(); } catch (_) {} }
+
+  return { exec, query, batch, close, file: f };
+}
+
+module.exports = { createClient, DEFAULT_FILE };

package/db/verify_sync.js

@@ -0,0 +1,107 @@
+'use strict';
+// 一致性哨兵：比对「由快照派生的 4 张表」在远程 D1 与本地 db/local.db 上的指纹。
+//
+// 为什么可以直接比：
+//   这 4 张表完全由 data/snapshot-*.json 派生，写入是「纯函数式规范化 + 幂等」
+//   （UNIQUE(anchor_date) / UNIQUE(run_id,code) / UNIQUE(code,date) + run_at recency guard）。
+//   因此两端只要回放过同一批快照，指纹必然逐字段相等；不相等就说明有一端没跟上。
+//
+// 不参与比对的表：watch_group / pick_group_rel / stock_note
+//   —— 这三张由网页写接口产生，只存在于线上，本地库没有也不该有。
+//
+// 指纹一律用「整型化聚合」（金额 ×100、涨幅 ×1000 后 ROUND 求和），
+// 避免两端浮点求和顺序不同导致末位差异误报。
+//
+// 退出码：0 = 全部一致；1 = 存在不一致或无法比对（可直接用于定时任务哨兵）。
+const d1 = require('./d1client');
+const localSqlite = require('./sqlite_client');
+
+const CHECKS = [
+  {
+    table: 'run_batch',
+    sql: `SELECT COUNT(*) AS 运行批次,
+                 IFNULL(SUM(universe_count), 0) AS 全池合计,
+                 IFNULL(SUM(r01_count + r07_count + r05_count), 0) AS 规则命中合计,
+                 MAX(anchor_date) AS 最新锚定日
+          FROM run_batch`,
+  },
+  {
+    table: 'pick_record',
+    sql: `SELECT COUNT(*) AS 入选记录,
+                 COUNT(DISTINCT code) AS 入选个股,
+                 COUNT(DISTINCT run_id) AS 覆盖批次,
+                 IFNULL(SUM(CAST(ROUND(r01_chg * 1000) AS INTEGER)), 0) AS R01涨幅毫数和,
+                 IFNULL(SUM(CAST(ROUND(price * 100) AS INTEGER)), 0) AS 入选价分和
+          FROM pick_record`,
+  },
+  {
+    table: 'price_daily',
+    sql: `SELECT COUNT(*) AS 日线行数,
+                 COUNT(DISTINCT code) AS 覆盖个股,
+                 COUNT(DISTINCT date) AS 交易日数,
+                 MIN(date) AS 首日,
+                 MAX(date) AS 末日,
+                 IFNULL(SUM(CAST(ROUND(close * 100) AS INTEGER)), 0) AS 收盘分和
+          FROM price_daily`,
+  },
+  {
+    table: 'stock_base',
+    sql: `SELECT COUNT(*) AS 档案行数, COUNT(DISTINCT code) AS 档案个股 FROM stock_base`,
+  },
+];
+
+const fmt = (v) => (v === null || v === undefined ? 'null' : String(v));
+
+(async () => {
+  if (!d1.cfg()) {
+    console.error('[verify] 缺少 CF_ACCOUNT_ID / CF_D1_DATABASE_ID / CF_API_TOKEN，无法读取远程 D1');
+    process.exit(1);
+  }
+  const local = localSqlite.createClient();
+  console.log('[verify] 远程 D1 ←→ 本地 ' + local.file);
+  console.log('');
+
+  let bad = 0;
+  const todo = [];
+  for (const chk of CHECKS) {
+    let remoteRow = null, localRow = null, err = '';
+    try { remoteRow = (await d1.query(chk.sql))[0] || null; } catch (e) { err = '远程读取失败: ' + e.message; }
+    try { localRow = (await local.query(chk.sql))[0] || null; } catch (e) { err = (err ? err + '；' : '') + '本地读取失败: ' + e.message; }
+
+    if (err) {
+      bad++;
+      console.log(`  ${chk.table.padEnd(13)} FAIL  ${err}`);
+      continue;
+    }
+
+    const keys = Object.keys(remoteRow);
+    const diffs = [];
+    const pairs = [];
+    for (const k of keys) {
+      const a = remoteRow[k] ?? null;
+      const b = localRow ? (localRow[k] ?? null) : null;
+      pairs.push(`${k}=${fmt(a)}|${fmt(b)}`);
+      if (fmt(a) !== fmt(b)) diffs.push(`${k}(远程 ${fmt(a)} / 本地 ${fmt(b)})`);
+    }
+    if (diffs.length) {
+      bad++;
+      console.log(`  ${chk.table.padEnd(13)} FAIL  ${diffs.join('  ')}`);
+      todo.push(chk.table);
+    } else {
+      console.log(`  ${chk.table.padEnd(13)} PASS  ${pairs.join('  ')}`);
+    }
+  }
+
+  local.close();
+  console.log('');
+  if (bad) {
+    console.log(`[verify] ${CHECKS.length} 张表中 ${bad} 张不一致：${todo.join(' / ')}`);
+    console.log('[verify] 修复：node db/backfill.js --both   （全量幂等重放，落后的那一端会被补齐）');
+    process.exit(1);
+  }
+  console.log(`[verify] 全部一致：${CHECKS.length}/${CHECKS.length} 张派生表逐字段相同`);
+  process.exit(0);
+})().catch((e) => {
+  console.error('[verify] 中止:', e.message);
+  process.exit(1);
+});

package/db/write_live.js

@@ -0,0 +1,54 @@
+'use strict';
+// 实时入库：读取「最近一次」快照，写入
+//   Cloudflare D1（默认，不写本地）/ 本地 SQLite（--local）/ 两边都写（--both）。
+// 由 run_today.cmd/sh 在 gen_candidates 之后链式调用 —— 本机任务用 --both，
+// 这样一次运行就让本地库与线上库同时前进，不会出现「一边新一边旧」。
+// 凭据缺失或入库失败时：打印告警并退出 0（不阻断报告生成本身）。
+const fs = require('fs');
+const path = require('path');
+const { persistSnap } = require('./persist');
+const { resolveTargets } = require('./clients');
+const paths = require('../paths');
+
+// 快照目录跟随工作目录（见 paths.js）：默认 <仓库根>/data
+const DATA = paths.dataDir();
+
+function latestSnap() {
+  if (!fs.existsSync(DATA)) return null;
+  const files = fs.readdirSync(DATA).filter(f => /^snapshot-\d{4}-\d{2}-\d{2}\.json$/.test(f)).sort();
+  if (!files.length) return null;
+  return path.join(DATA, files[files.length - 1]);
+}
+
+(async () => {
+  const { targets, notes } = resolveTargets();
+  for (const n of notes) console.log('[db] ' + n);
+  if (!targets.length) {
+    console.log('[db] 未指定写入目标：--local 写本地 / --both 两边都写 / 配好 CF_* 凭据后默认写远程');
+    process.exit(0);
+  }
+  for (const t of targets) console.log(`[db] 写入目标 ${t.name}${t.file ? ' -> ' + t.file : ''}`);
+
+  const f = latestSnap();
+  if (!f) { console.log('[db] 无 snapshot 可入库'); process.exit(0); }
+  const snap = JSON.parse(fs.readFileSync(f, 'utf8'));
+  console.log(`[db] 入库快照 ${path.basename(f)}（锚定日 ${snap.anchor}）`);
+
+  let failed = 0;
+  for (const t of targets) {
+    try {
+      const r = await persistSnap(snap, t.client);
+      console.log(`[db] ${t.name} 完成 run_id=${r.runId} picks=${r.picks} prices=${r.prices} base=${r.base}`);
+    } catch (e) {
+      failed++;
+      console.error(`[db] ${t.name} 入库失败（不影响报告）: ` + ((e && e.message) || e));
+    }
+  }
+  for (const t of targets) if (t.client.close) t.client.close();
+
+  if (failed) {
+    console.error('[db] 单边补写：远程 `node db/write_live.js` ／ 本地 `node db/write_live.js --local`');
+    console.error('[db] 若快照有缺漏（不止今天这一份），直接全量重放：`node db/backfill.js --both`');
+  }
+  process.exit(0);
+})();

package/eod/build_industry_map.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+'use strict';
+/*
+ * eod/build_industry_map.js —— 生成「代码 → 行业（+ 上市日期）」缓存
+ * ---------------------------------------------------------------------------
+ * 为什么单独做成低频脚本：
+ *   行业归属几乎不变（一年也就调几次成分），但获取全市场映射必须走东财 clist
+ *   （一次 60 页、每页 100 只）。而**东财对突发高频请求会封 IP**（实测十余次请求后即
+ *   socket hang up），所以绝不能放进 14:50 的关键路径 —— 那里只读本脚本产出的缓存文件。
+ *
+ * 源与降级：
+ *   1. 东财 clist（主源，含 f100 行业 + f26 上市日期）
+ *      fs 覆盖 沪深A股 + 科创板 + 创业板 + 北交所；每页之间加节流，避免被封。
+ *   2. 失败时**保留既有缓存文件**并以非零码退出，绝不用半截数据覆盖好数据。
+ *
+ * 用法：
+ *   node eod/build_industry_map.js              # 刷新缓存
+ *   node eod/build_industry_map.js --dry        # 只统计不写文件
+ * ---------------------------------------------------------------------------
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { httpGet } = require('./lib/http');
+const { now } = require('../time');
+const paths = require('../paths');
+
+// 输出位置跟随工作目录（见 paths.js）：默认 <仓库根>/eod/data/industry-map.json
+const OUT = paths.industryMapFile();
+
+// 沪深A股 + 科创板 + 创业板 + 北交所。与全市场快照的代码覆盖面对齐。
+const FS_ALL = 'm:1+t:2,m:1+t:23,m:0+t:6,m:0+t:80,m:0+t:81+s:2048';
+const FIELDS = 'f12,f13,f14,f100,f26';
+const PAGE_SIZE = 100;
+// 东财有多个编号镜像主机；主站被封时换一个往往仍可用（实测 push2 全挂时 push2delay 正常）。
+const HOSTS = [
+  'https://push2.eastmoney.com',
+  'https://push2delay.eastmoney.com',
+  'https://82.push2.eastmoney.com',
+];
+const THROTTLE_MS = 220;
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+/**
+ * 东财返回的 6 位代码 -> 腾讯风格全码。
+ * 注意不能用 f13（市场）判断：东财把北交所也归到市场 0，
+ * 若按市场拼前缀会把 8xxxxx/920xxx 错拼成 sz。必须按代码首位判断。
+ */
+function toTsCode(code6) {
+  const c = String(code6);
+  if (/^6/.test(c)) return 'sh' + c;
+  if (/^[03]/.test(c)) return 'sz' + c;
+  if (/^[489]/.test(c)) return 'bj' + c;
+  return null; // 无法归类的（如 B 股）直接丢弃
+}
+
+async function fetchPage(host, pn) {
+  const url = `${host}/api/qt/clist/get?pn=${pn}&pz=${PAGE_SIZE}&po=1&np=1&fltt=2&invt=2`
+    + `&fid=f12&fs=${FS_ALL}&fields=${FIELDS}`;
+  return httpGet(url, { json: true, retries: 3, timeout: 20000, referer: 'https://quote.eastmoney.com/' });
+}
+
+(async () => {
+  const dry = process.argv.includes('--dry');
+  let host = null;
+  const stocks = {};
+  let page = 1;
+  let total = 0;
+
+  for (; page <= 200; page++) {
+    let obj = null;
+    // 逐主机降级：任一主机能出数就锁定它，后续页固定走同一台（避免来回换台被判定异常）
+    const order = host ? [host, ...HOSTS.filter((h) => h !== host)] : HOSTS;
+    let lastErr = null;
+    for (const h of order) {
+      try {
+        obj = await fetchPage(h, page);
+        if (obj && obj.data) {
+          if (host !== h) {
+            host = h;
+            console.log(`  数据源: ${h}`);
+          }
+          break;
+        }
+      } catch (e) { lastErr = e; }
+    }
+    if (!obj || !obj.data) {
+      console.error(`  第 ${page} 页获取失败（${lastErr ? lastErr.message : '空响应'}）`);
+      break;
+    }
+    if (page === 1) {
+      total = obj.data.total || 0;
+      console.log(`  全市场 ${total} 只，约 ${Math.ceil(total / PAGE_SIZE)} 页`);
+    }
+    const rows = obj.data.diff || [];
+    if (!rows.length) break;
+    for (const r of rows) {
+      const code = toTsCode(r.f12);
+      if (!code) continue;
+      // 东财对部分个股（B 股壳、未分类次新等）回 '-'：当作「无行业」处理，
+      // 让下游落到统一的「未分类」桶，而不是把 '-' 当成一个真实行业参与板块强度排序。
+      const sector = String(r.f100 || '').trim();
+      if (!sector || sector === '-') continue;
+      stocks[code] = { name: String(r.f14 || '').trim(), sector, listed: r.f26 ? String(r.f26) : null };
+    }
+    process.stdout.write(`\r  已抓 ${Object.keys(stocks).length} 条 / 共 ${total}`);
+    if (rows.length < PAGE_SIZE) break;
+    await sleep(THROTTLE_MS);
+  }
+  process.stdout.write('\n');
+
+  const n = Object.keys(stocks).length;
+  console.log(`\n共解析 ${n} 只（${(n / (total || 1) * 100).toFixed(1)}% 覆盖）`);
+
+  if (n < 3000) {
+    console.error(`\n✗ 解析条数过少（${n}），判定抓取不完整，**不覆盖既有缓存**。`);
+    console.error('  若东财封禁本机 IP，可稍后重试；期间站点会沿用旧缓存（不影响运行）。');
+    process.exit(1);
+  }
+
+  // 行业分布概览
+  const bySector = {};
+  for (const v of Object.values(stocks)) bySector[v.sector] = (bySector[v.sector] || 0) + 1;
+  const sectors = Object.entries(bySector).sort((a, b) => b[1] - a[1]);
+  console.log(`行业数 ${sectors.length}，前 12：`);
+  for (const [s, c] of sectors.slice(0, 12)) console.log(`  ${s.padEnd(10)} ${c}`);
+  const noListed = Object.values(stocks).filter((v) => !v.listed).length;
+  console.log(`上市日期缺失 ${noListed} 只（缺失时新股判定退回名称 N/C 前缀）`);
+
+  if (dry) { console.log('\n--dry：未写入文件'); return; }
+
+  const payload = {
+    generatedAt: now(),
+    source: `eastmoney clist (${host})`,
+    count: n,
+    stocks,
+  };
+  fs.mkdirSync(path.dirname(OUT), { recursive: true });
+  fs.writeFileSync(OUT, JSON.stringify(payload), 'utf8');
+  const kb = (fs.statSync(OUT).size / 1024).toFixed(0);
+  console.log(`\n已写出 ${OUT}（${n} 条，${kb} KB）`);
+})().catch((e) => {
+  console.error('构建失败:', (e && e.stack) || e);
+  process.exit(1);
+});