数据归属¶
本项目按外部数据产品、本项目轻量快照和代码化报告划分边界。Hermes 读取确定性事实材料，并负责后续点评。事实数据由代码生成。
日报框架属于代码契约：需要哪些数据、数据缺失时怎么降级、报告按什么顺序写、发到哪些群，都由 Python 和 shell 流水线控制。Agent 的职责放在事实材料之后，用来解释、补充和回答追问。
原则¶
- 重型、历史、跨策略复用的数据由
quant-market-data-platform负责。 market-intel不内嵌quant-market-data-platform源码，也不把它作为子模块。market-intel可以保留轻量、报告专用、可持久化的快照。- 最终晨晚报由代码模板渲染。晚报状态、矛盾与验证条件来自确定性计算，大语言模型（LLM）/search 只允许产出带来源的候选新闻。
- 无来源、无 URL、无法通过契约校验的新闻不得进入代码化报告。
数据边界¶
| 数据域 | 负责仓库 | market-intel 的用法 |
是否允许实时抓取 |
|---|---|---|---|
| A 股全量日频、资金流、概念、两融、指数、历史回测输入 | quant-market-data-platform |
通过 DATA_PLATFORM_ROOT/assets/tushare/a_share/ 只读 |
不允许在报告阶段补抓全量 |
| ETF rotation / hot-sector 原始输入 | quant-market-data-platform |
子项目只读 DATA_PLATFORM_ROOT |
不允许写回数据湖 |
| DailyWatch20 候选池、策略计算和正式 artifact | quant-research（strategy_app.daily_watch20） |
market-intel 只读并校验 WATCHLIST20_ROOT；生产桥接与调度由 Deploy 维护 |
由 owner 发布，market-intel 不重算 |
| 跨市场快照：美股、日韩、商品、宏观、情绪 | market-intel |
data-snapshots/cross-market/ 与 latest/ |
允许快照缺失时兜底，并写回快照 |
| TuShare 轻量快照 | market-intel |
data-snapshots/tushare/，供备份任务和便携环境读取 |
允许 GitHub Actions 定时轻量抓取 |
| GLM/Aliyun/Gemini 市场新闻 | market-intel |
只消费结构化 items[]：title/source/url/published_at/summary |
允许联网搜索，未通过校验则跳过 |
| 晨报/晚报文本 | market-intel |
Python renderer 生成 Markdown/飞书消息 | 事实与确定性解释由代码生成 |
tushare_jobs 迁移状态（与 quant-market-data-platform 重叠收口）¶
src/tushare_jobs/ 中部分任务与 quant-market-data-platform 数据湖重复，应按 2026-07-29 整合评估
报告收回唯一 owner。当前状态：
| 任务 | 与 MDP 关系 | 处置 |
|---|---|---|
stock_st.py |
MDP 发布 stock_st |
只读消费：验证 receipt 后导出兼容 CSV |
listed_company.py |
MDP 发布 stock_company/stk_managers/share_float |
只读消费。仅轻量 stock_basic 报告快照保留直抓 |
index_weight.py / index_weight_daily.py |
MDP 发布 raw + daily mirror | 只读消费：不再重抓或本地展开 |
lightweight_snapshot.py |
MDP 无等价轻量 JSON | 保留：报告专用离岸/备份快照 |
报告增强镜像（mirror-a-share-*） |
已走 MDP（refresh_tushare_report_datasets.sh） |
已迁，无重叠 |
所有 MDP-owned reference 消费都会验证 receipt schema、dataset、SHA-256 和行数。验证失败
明确退出，不回退到旧下载器。详见 docs/boundary-contract.md（第三节）。
2026-07-30 更新：MDP 已在 feat/tushare-migration 分支建成等价下载能力
（providers/tushare_a_share_reference.py，含全部 6 个数据集的 DatasetSpec、download、
drift_weight 展开与 publish），并注册到 marketdata tushare download-a-share-reference 等子命令。
MDP 现为这些数据集的权威 owner。market-intel 已改为消费
<DATA_PLATFORM_ROOT>/assets/tushare/a_share/<dataset>/a_share_all_<dataset>_latest.parquet
和 receipt，旧重抓分支已退役。
部署约定¶
DATA_PLATFORM_ROOT 指向数据湖根目录。MDP_DIR 指向 quant-market-data-platform 代码仓库。默认约定：
export DATA_PLATFORM_ROOT=$HOME/data/market-data-platform
export MDP_DIR=/path/to/quant-market-data-platform
新机器或服务器只需要满足两个条件：
market-intel代码可运行。MDP_DIR指向已 clone 的私有仓库。DATA_PLATFORM_ROOT指向已刷新过的 quant-market-data-platform 数据目录。
如果缺少完整数据湖，晨报仍可读取 data-snapshots/ 中的跨市场和轻量 TuShare 快照。A 股完整分析、热点筛选和图表会降级或明确失败，避免在 market-intel 内临时重造全量下载器。
新机器配置步骤见 new-machine-setup.md。
报告生成边界¶
报告阶段不临时拼接自由文本。每次运行都会先形成可审计的中间产物：
- 新闻：
ai_market_news*.json（晨报默认写空 payload，不调用 AI 新闻抓取） - 晨报清单：
morning_manifest.json - 晚报清单：
evening_manifest.json - 晚报复盘：
evening_review.json、evening_review.md，其中market_temperature是可审计的确定性解释层 - 图表：
out/a_share_daily/*.png - 网页图表候选：
market_intel.a_share_charts.v1JSON，仅含经过字段白名单筛选的六图数值、原始观测日、来源和质量状态；候选本身不等于已批准公开 - 日间验证归档：
out/a_share_daily/history/evening_review_YYYYMMDD.json及对应 Markdown/温度图
这些产物通过契约和测试约束。投递层只消费这些文件，不向 LLM 请求新的事实判断。 网页图表候选必须写在仓库外，不能把私有 manifest、图表 PNG 路径或原始明细直接复制到公开站。后续公开审核与发布由 Pages 和部署仓库各自负责。
离线导出命令（不抓取、不发送、不发布）：
uv run a-share-daily chart-candidate --manifest /external/reports/morning_manifest.json --out /external/candidates/2026-09-18-morning.json --date 20260918 --kind morning
候选顶层只有 schema_version/publication/report_id/date/kind/generated_at/charts/content_sha256；恰有六张卡。publication 固定为 candidate，须经过下游逐点来源、授权和日期审核后，才可产生独立的公开产物。相同输入（含固定 generated_at）会产生相同 SHA-256。原始 manifest 内的飞书目标、错误文字和 PNG 绝对路径永不导出。
观测日取对应数据分区或美股收盘行，而非报告生成日。周图与仪表盘每个序列点保留自身日期；资金流使用较早分区、部分美股符号缺少可核实点时标记 degraded；无数据、无可信观测日或来源链接则标记 missing，占位 PNG 不算事实。当前 DailyWatch20 主题摘要缺少可公开核实的逐点 URL，故网页候选的主题卡保持缺项，不把内部 artifact 路径伪装成公开来源。晚报第四图实际是六维市场温度计，不能用晨报情绪指标的点冒充；在其独立点集可审核前，晚报候选将该卡标为缺项。既有晨晚报 PNG 与飞书投递不受该导出命令影响。
晨报入口：
生产桥接入口 scripts/morning_pipeline.sh 位于 quant-intel-deploy。它调用已安装的公开 CLI 和 owner 工具；报告框架及其测试由本仓维护。
scripts/morning_pipeline.sh
流程：
- Deploy 的
daily_watch20_delivery.sh调用已安装的daily-watch20-owner freshness --mode delivery校验quant-research的正式产物，再由 Platform 负责渲染和投递；失败时不阻塞后续报告。 a_share_daily.d11_h5_shadow_delivery只消费 owner 发布的研究产物。旧 AI 精选入口仅保留显式人工兼容调用，不进入默认调度。- 默认写空新闻 JSON，只有
MORNING_ENABLE_AI_NEWS=1时才调用fetch_ai_market_news.py。 a-share-daily morning生成机械清单。a-share-daily morning-report根据清单、快照和新闻items[]渲染 Markdown。morning_pipeline.sh调用a_share_daily.delivery.report_delivery投递代码化事实材料（lark-cli主通道，Hermes 补发，webhook 文字兜底）。- Hermes 可读取同一份 Markdown/清单做点评，点评失败不影响事实材料送达。
晚报入口：
生产桥接入口 scripts/evening_pipeline.sh 位于 quant-intel-deploy。它调用已安装的公开 CLI；报告框架及其测试由本仓维护。
scripts/evening_pipeline.sh
晚报继续复用 a-share-daily evening/review 的代码化输出。摘要版晚报由 a_share_daily.delivery.report_delivery 消费结构化事实和 market_temperature 生成。温度计算不联网、不调用模型，只消费当日聚合值、前 20 个交易日成交额基线和上一份归档中的验证条件。evening_review.md 不交给点评流程改写事实。
evening_pipeline.sh 生成 evening_summary.md、evening_review.md 和图表后，用六维市场温度计替换晚间旧情绪图，并归档当日复盘供下一交易日验证。随后由代码投递完整报告，Hermes 负责后续点评和解释。