zhixing-system/CONTEXT.md

# 知行量化研究上下文

本上下文描述 A 股市场数据同步与选股策略分析中的业务语言，重点保证历史结果可以被可靠复现。

## 分析语义

**历史可复现分析**：给定一个历史交易日，在当前目标股票池范围内重建该日的行情与估值状态；价格采用数据库中当前最新修订的前复权行情，不要求还原某次同步时的价格版本。
_Avoid_: 用当前市值回填历史、把当前目标股票池当作无幸存者偏差的长期回测宇宙

## 市场数据

**股票主数据**：描述证券标识及其在市场中的基础状态，例如代码、名称、交易所和上市状态。

**当前目标股票池**：同步时仍处于上市状态的沪深 A 股集合，排除 ST/风险警示股和北交所股票，也不包含退市股票的长期历史成员资格。

**股票数量**：当前目标股票池中的股票总数；不把已经不活跃的历史股票计入当前数量。

**最近更新交易日**：最近一个开市交易日中，系统尝试同步市场数据的目标日期；它描述数据覆盖到哪一天，不等同于同步任务的完成时间。

**日更新状态**：最近更新交易日的市场数据同步状态；“当日”按最近开市交易日理解，并区分更新中、已更新、部分更新、未更新和暂无数据。

**有效选股股票池**：当前目标股票池中，行情和所需估值数据均已同步到目标交易日的股票集合；数据仍停留在更早交易日的股票不参与当天选股。

**日线行情**：以证券和交易日为粒度记录的开盘价、最高价、最低价、收盘价和成交量等交易结果。

**前复权行情**：按 `qfq` 口径整理的日线价格序列，作为当前选股策略分析的唯一价格口径。

**估值快照**：在某个交易日可见的证券估值与交易活跃度指标，例如总市值、流通市值和换手率。

**行情落地快照**：一次同步从数据源取得的完整行情集合，用于核对和传递数据，不承担策略查询职责。

**同步批次**：一次面向当前目标股票池的市场数据同步运行；批次可以全部成功、部分成功或失败，并保留每只股票的处理结果。

**重试批次**：针对已有同步批次中失败对象再次执行的同步批次；同一交易日的展示结果以最近一次已完成的批次为准。

**批次级错误**：无法归属于某一只股票的同步异常，例如数据库写入或数据保留处理失败；它影响同步批次状态，但不计入某只股票的失败明细。

**股票更新成功**：一只股票在目标交易日同时具备日线行情和估值快照时的状态。

**股票更新失败**：一只股票未能在目标交易日同时具备日线行情和估值快照时的状态，并应保留可读的失败原因。

**数据覆盖率**：目标交易日内，有效选股股票数占当前目标股票池目标数的比例，用于判断选股结果是否具备足够完整性。