机构结构与风险观察：口径与更新
首次实施：2026-09-05；最新周度更新：2026-10-06，机构流截止2026-09-30。10条市场序列中9条覆盖同日，DR007最近有效日期为2026-09-29。
本次更新：2026-09-30截止
新增9月28—30日的2,376条机构记录，标准化表共734,976行、684个源交易日。表内实际日期决定覆盖范围，源文件名的9月25日起点不用于补造记录。最近5个源交易日为9月23日至9月30日。入库与历史未变证据见 data/staging/institution_update_20261006/publish_validation.json。
iFinD两次响应均仅返回约60个近期值，且9月30日DR007为空。同步器保留已验证EDB历史，重叠有效值逐项核对一致；冲突、重复主键、身份/单位/频率错误和传输错误仍阻止发布。数值空白保留为缺失并标记无效行情，不覆盖旧的有效值，不用前值填充。默认仍要求所有序列覆盖截止日；本次通过明确参数 --allow-stale-series DR007 允许该序列的截止日缺失，并在来源审计、观察摘要和资金表披露。下游9月30日DR007、5日变化、R007−DR007及相应历史位置留空。机构金额、映射、期限与滚动窗口口径未改。
最新报告为机构行为事实周报和机构结构与风险观察。事实周报的旧iFinD行情仍截止2026-07-10，其曲线缺口不因新观察层更新而消失。
自本次起，两份报告均固定加入“近期显著变化”文字章节，比较本周与前20/40日周均及往年同进度5/20日，说明方向、金额和持续性；每次重跑自动重新计算。详见计算与编排口径，更新后另运行 scripts/validate_weekly_institution_changes.py 校验比较明细及两份报告。
最新一周：2026-09-07至2026-09-11
已新增3,960条机构记录，五个源日期各792条；标准化表共725,472行、672个源日期，覆盖2024-01-02至2026-09-11。历史721,512行逐项复核未变，主键无重复、无丢弃行和无效日期，原始Excel未修改。入库证据见 data/staging/institution_update_20260913/publish_validation.json。
最新报告为机构行为事实周报和机构结构与风险观察（历史来源，未公开）。本周净买额源网格缺失比例58.59%、成交额缺失比例64.80%；缺失保留未知，金额和配对强度仍按下述既定口径计算。
现券、期货与国债曲线复用并快照核验现有缓存。DR007、R007、AAA商业银行1年存单通过iFinD EDB更新至9月11日，重叠历史数值与9月5日保留响应一致。DR007和R007的9月11日单点与新华财经当日货币市场日报一致；这不代表存单或全部历史获得独立复核。两条回购指标的目录截止仍为9月10日，实际数值至9月11日，差异已保留。存单目录与实际截止一致，没有沿用上周的目录滞后提示。
本轮仅修正复核日期、复核范围与来源提示的更新方式，未改变机构映射、期限、金额或滚动窗口定义。同步器新增 --spot-checks 参数，从已核验的日期、数值与来源记录生成复核说明；不再固定显示首次实施时的9月4日。对应文件为 data/staging/institution_update_20260913/independent_market_spot_checks.json。运行下述更新命令时，将截止日改为2026-09-11、EDB响应路径改为 institution_update_20260913，并加上该参数。旧QuantAPI本轮未重试，旧iFinD数据及缺口表保持原状。
首次实施记录（下文数据与验收均截至2026-09-04）
本轮完成与用途
已将8月31日至9月4日的3,960条机构流记录并入唯一标准化事实源，重建事实周报，并新增机构结构与风险观察页（历史来源，未公开）。标准化表现有721,512行、667个源交易日期，始于2024-01-02。原始机构映射、期限定义、金额单位和缺失值规则保持一致。
业务目的：把近期买入累积、边际转向、机构类别结构和市场表现并列，避免把价格上涨组成的综合分解释为持仓拥挤。新增指标覆盖2024年至本次截止日；下游产物为独立观察CSV与观察页，事实周报增加入口。旧研究规则没有重新估计，也没有升级成风险概率。
实施前备份位于 reports/trading_signal_research_2026/checkpoints/20260905_before_20260904_observation/。新增源的独立核对及入库记录位于 data/staging/institution_update_20260905/publish_validation.json 与 data/quality/institution_flow_ingestion_events.jsonl。本轮无丢弃行、无无效日期，新增前的历史记录逐项核对未变。
工作口径
机构数据只读 data/processed/institution_flows_standardized.csv；原始Excel仍仅由标准化入口读取。观察页使用当前展示的8个标准化机构类别，银行分列且保留“其他”。历史标准化表还保留截至2025-12-16的“外资银行”和“其他产品类”，本页没有将其擅自映射进其他类别；因此集中度历史比较只在当前展示口径的完整窗口内开展。未知不填零，金额聚合使用 sum(min_count=1)。
| 板块 | 源期限桶 | 源债券类型 | 行情对照 |
|---|---|---|---|
| 7—10Y政金债 | 7-10Y | 政策性金融债-新债、政策性金融债-老债 | 10年国开活跃券；流量范围更广 |
| 7—10Y国债 | 7-10Y | 国债-新债、国债-老债 | 10年国债活跃券 |
| 20Y+国债代理 | 20-30Y、>30Y | 国债-新债、国债-老债 | 30年国债活跃券；非精确剩余期限 |
| 20Y+地方债代理 | 20-30Y、>30Y | 地方政府债 | 配置背景，单独展示 |
| 长端全券种 | 7-10Y、10-15Y、15-20Y、20-30Y、>30Y | 全部 | CSV保留，不合成为方向分 |
先按源日期和标准化机构聚合。完整的5、20、60个源日期均有日度净额，才计算对应滚动净买；跨年不清零，遇缺失不缩短窗口。源日期不等于所有行情市场的开市日，行情按源日期对齐，缺口留空。
| 字段 | 定义与解释 |
|---|---|
net_5d/net_20d/net_60d |
对应窗口成交净额之和，单位亿元；不是实际持仓 |
previous_5d/change_5d |
不重叠的前5日净额；近5日减前5日 |
pctl_*d、pctl_*d_n |
当前滚动净额在此前120个源日期有效窗口中的弱百分位，即历史值≤当前值的比例；排除当日，至少30个有效窗口；n为样本数 |
positive_days_20d/positive_streak |
完整20日内正净买天数；连续正净买源日期数。缺失中断连续计数 |
matched_intensity_5d |
仅在净额与成交额同时有值的记录上，5日净额合计÷成交额合计；每日均须有配对记录且总分母为正 |
matched_abs_net_coverage_5d |
配对记录的绝对净额之和÷所有已知净额记录的绝对净额之和；度量已知净额的配对覆盖，不是全部成交覆盖率 |
net_buyer_category_hhi |
先计算每个机构类别5日净额，再将正值除以有值类别的正净额总和；HHI为这些份额平方之和 |
fund_broker_positive_share |
基金、证券各自正净额份额之和；两类机构先各自取正值，不用两者净额之和作分母 |
observed_categories |
5日净额有值的类别数；与集中度并列，缺失类别不视作零 |
类别HHI包含“其他”，不能说明单一持有人集中程度，也不是总买入成交份额。HHI历史基准仅接受完整5日窗口都处于2025-12-17及以后相同展示口径的观测，再在此前120个源日期中计算分位。缺失类别的构成仍可能变化，须同时查看有值类别数。正净买总额为零或全缺失时，份额及HHI留空。
高净买分位不一定代表大量买入：若金额仍为负，可能只是相对少卖。不同期限、券种的金额未经久期归一化，不相加解释为等量风险。全机构净买的近零加总也不是全市场净流入指标。
行情、资金与来源
本次同步10条序列，均核对实际数值截止至9月4日。已有本地缓存通过读取和快照复用，未重复下载；DR007、R007、存单通过现有iFinD MCP EDB接口取得。
| 来源 | 序列 | 核验与限制 |
|---|---|---|
bondcandle_dmapi/data/bond_kline |
10年国开、10年国债、30年国债活跃券日线 | CSV/元数据哈希、系列身份、OHLC核验；记录实际券代码，零成交或不完整行情无效 |
国债期货K线分析/data/cache |
T0、TL0日线 | 连续期货价格，换月效应未单独校正 |
截面策略/data/raw/akshare_curves_daily.csv |
中债国债10年、30年估值曲线 | 估值期限曲线，与DM活跃券分开 |
| iFinD MCP EDB | DR007 L001619493、R007 L004109430 |
日频、百分比；两条R007定义返回值一致属于同源核验 |
| iFinD MCP EDB | AAA商业银行同业存单1年 L004428055 |
估值曲线，日频、百分比；无独立来源全历史复核 |
现券5日收益率变化为当前减5个源日期前的值，再乘100，单位bp；要求6个端点及中间观测完整，且实际券代码不变。换券窗口留空。期货变化为价格比值减1再乘10,000，单位价格收益bp，两种bp不可混同。
DM trade_num按供应商手册解释为成交笔数。近5日日均笔数除以此前不重叠20日日均笔数作为活跃度对照；它不代表成交额、盘口深度或机构成交冲击。日变化20日标准差保存在行情CSV中，当前没有设风险阈值。
本次EDB目录的截止元数据落后于实际返回值，保留 provider_catalog_end/provider_catalog_lag 和原始响应，未隐藏冲突。新华财经2026年9月4日货币市场日报支持DR007当日1.3726%的单点；不代表R007、存单或全历史已独立验证。
旧iFinD QuantAPI交叉核验返回 -4318 月度额度耗尽，未继续重试或改写凭据。旧行情文件及其缺口表保留原状；新观察层的覆盖不能解释成旧曲线接口已修复。基金真实日度净申赎查询返回空；持仓、机构杠杆、赎回压力、发行到期供给及盘口深度尚未形成同口径可用层。
可用时间与预测研究边界
observed_at记录本次采集或同步时间，机构流事件另记入库时间、来源文件和哈希。历史 available_at保持未知，不能将周末取得的数据倒填为此前盘中可见信息。
本轮完成数据更新、观察指标和来源接入。预测增量验证尚未进行。后续应先取得真实发布时间，或明确采用可审计的保守滞后假设并单列假设实验；再检查可用时间之后的日内最大不利变动、波动、误报、提前量及价格/波动基线的对比。指标分位无前视不等于数据可用性已满足无前视要求。
已确认规则仍为项目的数据源、映射、缺失、源日窗口和研究/执行边界。本次窗口、板块及集中度分母属于明确记录的工作口径。拥挤阈值、风险阈值、警报频率、覆盖率门槛及升级标准仍未决定。
重跑与下一次更新
使用项目Python。更新机构流时仍通过唯一标准化入口，以 --source '2026=新工作簿.xlsx' --append-existing 暂存并核对后发布；检查主键、映射、日期年份、丢弃行和历史记录差异，保留版本证据。
本次市场层可从保留的接口响应重跑。以下命令在项目根目录执行；后续日期应提供对应日期的新响应，不改写旧响应冒充最新数据。
PY=[本地]/.cache/codex-runtimes/codex-primary-runtime/dependencies/python/bin/python3
"$PY" scripts/sync_institution_observation_sources.py \
--as-of 2026-09-04 \
--funding-response data/staging/institution_update_20260905/ifind_funding_response.json \
--ncd-response data/staging/institution_update_20260905/ifind_ncd_response.json
"$PY" scripts/build_institution_observation.py --as-of 2026-09-04
"$PY" scripts/validate_institution_observation.py
"$PY" -m unittest discover -s tests -p test_institution_observation.py
EDB响应格式为此次接口保存的标准表封装，解析时校验成功状态、指标代码、单位、频率、重复值和合理范围。同步器只读其他项目缓存，不自动联网；任一系列实际可用截止不足时停止发布新行情表。已存在但内容改变的源快照保留在 versions/。
机构流更新后运行 scripts/build_institution_futures_signals.py 重建事实表、季节性与报告，再运行 scripts/validate_institution_behavior_report.py。--render-only仅用于从已有事实产物重绘展示，不替代数据重建。新增观察不复跑历史原始Excel面板入口。
可复核产物：
outputs/institution_observation/：日度板块指标、当日40行快照、类别结构、行情背景、构建收据。data/quality/institution_observation_source_inventory.csv、institution_observation_source_audit.json：实际覆盖、源版本哈希、来源限制。data/raw/institution_observation/20260904/：10条序列对应源文件、原始接口响应及能力缺口证据。data/quality/institution_observation_validation.json：独立按标准化表复算金额、分位、强度、配对覆盖、集中度和市场窗口的结果。output/playwright/institution_observation_20260904/：浏览器显示验收证据。
验证数据和页面完成后交付事实观察；不得将检查通过写成预测有效或交易规则已获确认。
本次交付验收：观察层326项独立检查、事实周报128项检查、8项回归测试全部通过；桌面与390px手机端显示、来源链接和事实周报入口通过检查，控制台无错误。验收收据为 data/quality/institution_observation_delivery_validation.json。