xgb_wiki 文档
xgb_wiki：将选股宝脱水研报（内网 MySQL，7797 篇，2023-11 → 2026-09）整理为题材本体——题材在产业链中的位置、关联个股（出现次数 / 衰减热度 / 5-30日时间窗 / 活跃天数）、推荐观点、券商引用、评级事件与图片证据。8 实体 / 11 关系，schema 兼容 Ontology-Playground，实例数据经 Flask 本地展示 + Cloudflare Pages 静态站（CI 自动发布，含
/daily每日简报），并经/api/nlq、MCP server 与 skill 对外提供自然语言查询能力。
文档地图
| 文档 | 内容 | 什么时候读 |
|---|---|---|
| 设计方案 | 为什么这样设计：数据事实基础、本体 schema、衰减热度 / 时间窗与活跃天数 / 推荐观点 / 开放字典等模型（§2.4、§2.4b、§2.5、§2.6）、决策记录（v2.1，已实施状态） | 改本体结构、加实体关系、改时间窗口径之前必读 |
| 整体架构 | 系统怎么组织：数据流水线、模块划分与依赖方向、Web 路由（含每日题材 /timeline）、技术选型理由、部署形态（本机 Flask + CI 静态站 + MCP/skill 对外） |
想了解全貌 / 定位代码位置 |
| 数据模型 | 数据长什么样：全库 ER 关系图、8 实体表 + 7 关系表逐字段字典（含时间窗列与 theme_daily）、开放字典文件格式、chain_map 格式、本体↔存储对照、源库→本地映射 | 写 SQL / 改 schema / 做导出时查 |
| 名词解释 | 术语什么意思：脱水研报/大涨题材行/衰减热度/时间窗/数据日/活跃天数/自然语言查询/MCP·skill…按业务域分组 | 读其他文档遇到生词时 |
| 数据同步 | 数据怎么更新：MySQL→SQLite 增量/全量同步的五阶段流程（环境检查/备份/临时库/校验/回退）、水位规则、校验清单、同步日志、备份恢复与排障 | 日常更新数据 / 同步报错 / 想了解校验与回退机制 |
| 运行手册 | 怎么跑：环境准备、数据同步与时间窗重算、链映射审校、图片解析队列、对外查询（MCP/CLI/skill）、CI 发布、已知坑与红线 | 日常操作与排障 |
| 每日简报 PRD | 每日简报的需求与决策：观点单元口径（聚合拆分/正文分节主源）、实测依据、已确认决策与分期 | 做 /daily 相关功能之前 |
| Pages 发布 | 怎么发布：研报站 Cloudflare Pages CI（GitHub Actions 自动构建部署）+ 本体 schema 推 Playground fork + 文档站 MkDocs 完整配置 | 发布研报站 / 要创建文档站时 |
推荐阅读路径
- 新协作者：名词解释 → 设计方案 §1–2（含 §2.4b 时间窗与活跃天数模型）→ 整体架构
- 接手运维：运行手册 → 数据同步指南 → 数据模型（当字典查）
- 准备发布：Pages 发布（含检查清单）
- 要查题材数据 / 接入智能体：名词解释（自然语言查询、MCP·skill 条目）→ 运行手册"对外查询"节（CLI 一行命令即可上手）
目录约定
- 文件名用英文 slug（URL 友好），内容为中文
- 站内一律相对链接；指向仓库外或仅本地可用的资源（如内网路径）会明确标注
- 本目录可直接被 Jekyll / MkDocs / docsify 渲染为静态站（见 publishing.md）
- 原单文件版设计文档《实施方案.md》（v1.0–v1.1）已并入 design.md 并升级至 v2.0，git 历史
docs/实施方案.md → docs/design.md连续