zhixing-system/CONTEXT.md

# 知行量化研究上下文

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

## 分析语义

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

**选股策略**：一组针对明确目标交易日、依赖该日之前历史行情的选股规则；它产出可解释的选股信号，不等同于交易执行指令或收益承诺。

**知行 B1**：当前迁移中的知行选股策略名称；它按知行公式语义评估目标交易日，并包含七种可以独立命中的子信号。

**子信号**：选股公式中具有独立业务含义的命中分支；同一只股票在同一交易日可以同时命中多个子信号，不能因为存在合并条件而丢失分类信息。

**公式语义**：公式原文及已确认业务调整所表达的规则意图；当旧代码与公式意图冲突时，公式语义是迁移后的判断依据，旧代码只作为实现参考和差异证据。

**历史样本验证**：使用固定的历史行情样本和固定期望结果验证策略规则；它用于发现规则迁移偏差，不等同于回测收益评价。

## 市场数据

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## 板块资金雷达

**板块资金雷达**：在交易日收盘后，分别对概念板块和行业板块的资金指标进行横截面比较、排名与历史变化分析；它不是盘中实时信号，也不构成交易指令。

**板块排名池**：同一交易日、同一板块类型中参加同一指标排名的板块集合；概念板块与行业板块属于不同排名池，成员数量随交易日变化。

**板块成员快照**：数据源在指定交易日给出的板块与股票成员关系。历史分析只使用对应交易日的快照，缺失时标记成员未知，不用当前成员替代。

**独立指标策略**：知行系统根据 Tushare 原始事实自行定义的资金指标算法；它必须有稳定名称和版本，不能称为外部站点未公开公式的复刻。

**雷达发布批次**：针对一个目标交易日完成的输入采集、质量校验、指标计算和排名发布；同一交易日可以因上游修订产生多个批次。

**最近有效发布**：最近一个通过完整性与质量门的雷达发布批次。新批次失败或只完成部分数据时，读取端继续使用该批次并明确显示数据已过期。