v1.4.1: README 更新持仓跟踪智能体模块(架构/目录/表/API/版本历史)

README.md

@@ -128,6 +128,7 @@ cd works/stock-advisor
 | `strategy_backtests` | 策略回测结果（408 条） | strategy/code/metrics/equity/trades |
 | `settings` | 系统设置 KV | key/value |
 | `notification_log` | 舆情通知日志 | news_id/importance/status |
+| `tracking_reports` | 持仓跟踪报告（含数据源/影响度 JSON） | code/report/meta/sources |
 
 ---
 
@@ -194,6 +195,22 @@ cd works/stock-advisor
 
 **防打扰机制**：`monitor_last_news_id` 水位只扫新增；首次启动只建水位不通知历史；单封邮件最多 20 条。
 
+### 5. 持仓跟踪智能体（engine/agent.py + chain_data.py）
+
+对**自选股（持仓）**定期主动跟踪，由**大模型智能体 + 工作流**驱动：
+
+```
+工作流：读取产业链知识库 → RAG+DB 采集(个股/上游/下游/同业) → LLM 产业链深度分析
+      → 影响度判定(0-100) → 入库 tracking_reports → 重大变化(≥阈值)邮件通知
+```
+
+- **产业链知识库** `chain_data.py`：覆盖 40+ 行业，每个行业定义 上游(供给/成本)/下游(需求/客户)/同业 + 检索关键词（引用池内股票代码便于 RAG 过滤）
+- **深度分析报告**结构：个股最新动态 / 上游产业链分析 / 下游产业链分析 / 同行业竞争格局 / 产业链传导与投资启示 / 风险提示 / 关注要点
+- **影响度判定**：大模型输出 JSON（significance / impact_score / change_kind / summary / chain_trend），前置输出防截断，容错解析
+- **主动调度**：后台调度器按间隔（默认 60 分钟）跟踪全部自选股；支持「立即跟踪全部/单只」
+- **重大变化通知**：impact_score ≥ 阈值（默认 65）自动邮件
+- **页面 `/tracking`**：持仓最近跟踪一览 + 全部跟踪记录 + 详情弹窗（报告 + 四环节数据源）
+
 ### 5. 系统设置（/settings）
 
 - **📧 邮件**：SMTP 服务器/端口/加密模式（plain/starttls/ssl）/账号/密码/收件人 + 测试邮件
@@ -250,6 +267,15 @@ cd works/stock-advisor
 | GET | `/api/ratings/upgrades` | 评级变动榜 |
 | GET | `/api/holdings/moves` | 基金增减持榜 |
 
+### 持仓跟踪
+| 方法 | 路径 | 说明 |
+|---|---|---|
+| GET | `/api/tracking` | 跟踪报告列表 |
+| GET | `/api/tracking/stock/<code>` | 某股跟踪记录 |
+| GET | `/api/tracking/<id>` | 跟踪详情（含数据源） |
+| POST | `/api/tracking/run` | 立即跟踪全部自选股 |
+| POST | `/api/tracking/run/<code>` | 立即跟踪单只 |
+
 ### 量化策略
 | 方法 | 路径 | 说明 |
 |---|---|---|
@@ -327,6 +353,7 @@ IS_MOCK = False
 | v1.1.0 | AI 分析历史记录 + 数据源详情页（/analysis/&lt;id&gt;，展示 RAG 新闻/提示词等） |
 | v1.2.0 | 量化策略模块：6 主流策略全市场回测 + 单股净值曲线 + 交易明细 |
 | v1.3.0 | 舆情驱动自动化（定期扫新闻→邮件通知）+ 系统设置区（邮件/大模型/监控可配） |
+| v1.4.0 | 持仓跟踪智能体：产业链上下游深度分析（上游供给/成本、下游需求/景气、同业），影响度判定+重大变化通知 |
 
 ---