stock-analyzer-skill 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -5,6 +5,42 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [1.2.3] - 2026-06-09
+
+### Changed
+
+- 更新 `methodology.md`：策略权重更新为五因子模型，新增波动率因子权重配置
+- 更新 `docs/product-architecture.md`：添加五因子详解表格，更新策略权重与代码一致
+
+### Documentation
+
+- 明确五因子模型：质量、估值、动量、流动性、波动率
+- 添加各因子评分逻辑说明
+
+## [1.2.2] - 2026-06-09
+
+### Changed
+
+- 更新 `workflow.md`：新增 monitor、stock-init、backtest、help 等 4 个 skill，扩展工作流至 12 个技能
+- 更新技能速查表：添加决策门槛量化标准（监控告警、回测验证）
+
+### Documentation
+
+- 更新投资专家工作流：持仓实时监控链路、策略回测验证
+- 完善交接字段与决策门槛
+
+## [1.2.1] - 2026-06-09
+
+### Changed
+
+- 更新 `docs/product-architecture.md`：新增技术架构章节，添加三层架构设计、核心技术组件、数据源矩阵、行业差异化阈值表格
+- 更新 `docs/developer-guide.md`：更新项目结构，添加 BaseFetcher/CircuitBreaker/DataFetcherManager 核心技术说明，扩展数据源架构文档
+
+### Documentation
+
+- 完善开发者指南中的扩展开发说明
+- 添加健康检查和回测验证命令说明
+
 ## [1.1.0] - 2026-06-08
 
 ### Added

package/README.md

@@ -66,7 +66,7 @@ claude skills list
 
 ## 目录结构
 
-```
+```text
 stock-analyzer-skill/
 ├── .claude-plugin/                 # Claude Code plugin 配置
 │   ├── plugin.json                 # plugin 元数据
@@ -82,37 +82,101 @@ stock-analyzer-skill/
 │   ├── investment-researcher/SKILL.md
 │   └── help/SKILL.md
 ├── scripts/                        # 工具脚本（Python stdlib only）
-│   ├── common.py                   # 编码转换、字段映射、HTTP
-│   ├── quote.py                    # 腾讯实时行情
-│   ├── finance.py                  # 东财财务数据
-│   ├── kline.py                    # 新浪 K线
+│   ├── api/                        # CLI 入口层
+│   │   ├── quote_cli.py            # 行情查询 CLI
+│   │   └── screener_cli.py         # 选股器 CLI
+│   ├── business/                   # 业务逻辑层
+│   │   ├── stock_analysis.py       # 个股分析服务
+│   │   └── screening_service.py    # 选股服务
+│   ├── common/                     # 基础设施层
+│   │   ├── __init__.py             # HTTP 请求、编码转换、字段映射
+│   │   ├── validators.py           # 输入验证器
+│   │   └── exceptions/             # 统一异常类
+│   ├── config/                     # 配置外部化
+│   │   ├── loader.py               # YAML 配置加载器
+│   │   ├── data_source.yaml        # 数据源端点配置
+│   │   ├── industry_thresholds.yaml # 行业差异化阈值
+│   │   ├── scoring.yaml            # 评分权重配置
+│   │   └── limits.yaml             # 限流与超时配置
+│   ├── data/                       # 数据层
+│   │   ├── types.py                # 数据类型定义
+│   │   ├── cache.py                # 缓存管理
+│   │   ├── config.py               # 数据配置
+│   │   ├── industry_thresholds.json # 行业阈值数据
+│   │   ├── sector_etf.csv          # 板块 ETF 清单
+│   │   ├── sector_stocks.json      # 板块核心标的库
+│   │   ├── sector_mapping.json     # 板块映射关系
+│   │   └── portfolio_example.json  # 持仓配置示例
+│   ├── fetchers/                   # 数据获取层（多数据源适配）
+│   │   ├── tencent_quote.py        # 腾讯实时行情
+│   │   ├── eastmoney_quote.py      # 东财实时行情
+│   │   ├── eastmoney_finance.py    # 东财财务数据
+│   │   ├── eastmoney_kline.py      # 东财 K 线
+│   │   ├── sina_quote.py           # 新浪行情
+│   │   ├── sina_kline.py           # 新浪 K 线
+│   │   ├── akshare_quote.py        # AkShare 行情
+│   │   ├── akshare_finance.py      # AkShare 财务
+│   │   ├── akshare_kline.py        # AkShare K 线
+│   │   ├── efinance_*.py           # efinance 适配
+│   │   ├── baostock_kline.py       # baostock K 线
+│   │   ├── pytdx_*.py              # pytdx 适配
+│   │   ├── tushare_*.py            # tushare 适配
+│   │   └── yfinance_kline.py       # yfinance K 线（港股/美股）
+│   ├── strategies/                 # 选股策略系统
+│   │   ├── registry.py             # 策略注册中心
+│   │   ├── thresholds.py           # 阈值管理
+│   │   └── factors/                # 因子实现
+│   ├── technical/                  # 技术分析模块
+│   │   ├── macd.py / kdj.py / boll.py / rsi.py  # 指标计算
+│   │   ├── moving_average.py       # 均线系统
+│   │   ├── volume.py               # 量价分析
+│   │   ├── trend.py                # 趋势判断
+│   │   ├── candlestick.py          # K 线形态
+│   │   ├── astock.py               # A 股特色指标
+│   │   ├── signals.py              # 信号生成
+│   │   ├── scoring.py              # 综合评分
+│   │   └── report.py               # 报告生成
+│   ├── infrastructure/             # 基础设施（预留）
 │   ├── announcements.py            # 东财公告/研报
-│   ├── screener.py                 # A股多因子选股器
-│   ├── technical.py                # 纯技术分析
-│   ├── classifier.py               # 个股类型分类
+│   ├── backtest.py                 # 历史回测引擎
 │   ├── chan.py                     # 缠论结构
-│   └── patterns_local.py           # A股本土战法形态
-├── data/                           # 静态参考数据
-│   ├── sector_etf.csv              # 板块 ETF 清单
-│   ├── sector_stocks.json          # 板块核心标的库
-│   └── portfolio_example.json      # 持仓配置示例
+│   ├── classifier.py               # 个股类型分类
+│   ├── finance.py                  # 财务数据入口
+│   ├── init_pool.py                # 候选池初始化
+│   ├── kline.py                    # K 线数据入口
+│   ├── monitor.py                  # 实时监控
+│   ├── patterns_local.py           # A 股本土战法形态
+│   ├── quote.py                    # 行情数据入口
+│   ├── refresh_pool.py             # 候选池刷新
+│   ├── screener.py                 # A 股多因子选股器
+│   └── technical.py                # 技术分析入口
+├── data/                           # 输出数据
+│   └── reports/                    # 分析报告
 ├── experts/                        # 8 人专家定义
-│   ├── buffett.md
-│   ├── lynch.md
-│   ├── soros.md
-│   ├── duan_yongping.md
-│   ├── xu_xiang.md
-│   ├── zhao_laoge.md
-│   ├── chaogu_yangjia.md
-│   └── zuoshou_xinyi.md
-├── tests/
-│   └── smoke_test.sh               # 端到端冒烟测试
+│   ├── buffett.md / lynch.md / soros.md / duan_yongping.md
+│   ├── xu_xiang.md / zhao_laoge.md / chaogu_yangjia.md / zuoshou_xinyi.md
+│   └── decide.md                   # 决策整合规则
+├── tests/                          # 测试套件
+│   ├── conftest.py                 # pytest 配置与 fixtures
+│   ├── smoke_test.sh               # 端到端冒烟测试
+│   ├── test_*.py                   # 单元测试
+│   └── unit/                       # 更多单元测试
+├── docs/                           # 详细文档
+│   ├── quick-start.md              # 快速入门
+│   ├── user-guide.md               # 使用者指南
+│   ├── developer-guide.md          # 开发者指南
+│   ├── methodology.md              # 方法论文档
+│   ├── api-reference.md            # API 参考
+│   ├── implementation-plan.md      # 实现计划
+│   └── improvement-roadmap.md      # 改进路线图
 ├── package.json                    # npm 发布配置
+├── pyproject.toml                  # Python 项目配置
 ├── install-plugin.js               # npm postinstall 脚本
 ├── install.sh                      # 传统安装脚本
 ├── README.md                       # 本文件
+├── CHANGELOG.md                    # 版本变更记录
 ├── CONTRIBUTING.md                 # 贡献指南
-├── workflow.md                     # 8 个 skill 的协作流程
+├── workflow.md                     # 9 个 skill 的协作流程
 └── methodology.md                  # 完整投资方法论
 ```
 
@@ -120,7 +184,7 @@ stock-analyzer-skill/
 
 ### 快速个股分析
 
-```
+```text
 /stock sh600989
 ```
 
@@ -128,7 +192,7 @@ stock-analyzer-skill/
 
 ### 大盘快评
 
-```
+```text
 /market quick
 ```
 
@@ -136,15 +200,15 @@ stock-analyzer-skill/
 
 ### 持仓健康检查
 
-```
+```text
 /portfolio
 ```
 
-读取 `data/portfolio_example.json`（可复制为 `portfolio.json` 自定义持仓）。
+读取 `scripts/data/portfolio_example.json`（可复制为 `portfolio.json` 自定义持仓）。
 
 ### 多因子选股
 
-```
+```text
 /screener --sector 资源 --strategy quality_value --top 5
 ```
 
@@ -152,7 +216,7 @@ stock-analyzer-skill/
 
 ### 技术面确认
 
-```
+```text
 /technical sh600989 --quick
 ```
 
@@ -160,7 +224,7 @@ stock-analyzer-skill/
 
 ### 完整五层 + 专家辩论
 
-```
+```text
 /stock sh600989 debate
 ```
 
@@ -168,7 +232,7 @@ stock-analyzer-skill/
 
 ### 查看帮助
 
-```
+```text
 /help
 ```
 
@@ -177,11 +241,11 @@ stock-analyzer-skill/
 ## 自定义持仓
 
 ```bash
-cp data/portfolio_example.json data/portfolio.json
+cp scripts/data/portfolio_example.json scripts/data/portfolio.json
 # 编辑 portfolio.json，修改 codes 字段
 ```
 
-`/portfolio` 命令默认读取 `data/portfolio.json`（或 `data/portfolio_example.json` 作为回退）。
+`/portfolio` 命令默认读取 `scripts/data/portfolio.json`（或 `scripts/data/portfolio_example.json` 作为回退）。
 
 ## 数据源
 
@@ -220,7 +284,10 @@ cp data/portfolio_example.json data/portfolio.json
 ## 解耦特性
 
 ✅ **零项目依赖**：不引用任何业务项目内文件（`src/`、`data_provider/`、`AGENTS.md` 等）
-✅ **零外部 Python 库**：只用 stdlib（`urllib` + `json` + `pathlib`）
+✅ **零外部 Python 库**：只用 stdlib（`urllib` + `json` + `pathlib` + `yaml`）
+✅ **三层架构**：API 层（CLI 入口）→ Business 层（业务逻辑）→ Data 层（数据获取/缓存），职责清晰
+✅ **配置外部化**：行业阈值、评分权重、数据源端点等均通过 YAML 配置，无需改代码
+✅ **多数据源适配**：fetchers/ 下统一接口，腾讯/东财/新浪/AkShare 等可自由切换
 ✅ **单源真理**：方法论、数据、脚本各自集中在一处
 ✅ **可移植**：可打包为 git 仓库或 npm 包分发
 
@@ -241,19 +308,23 @@ rm -f ~/.claude/skills/stock ~/.claude/skills/market ~/.claude/skills/sector ~/.
 
 ## 近期改进
 
+- **三层架构重构**：scripts/ 拆分为 API 层（cli 入口）、Business 层（分析/选股服务）、Data 层（fetchers/缓存/配置），职责清晰、易扩展
+- **配置外部化**：行业阈值、评分权重、数据源端点等提取为 YAML 配置（`scripts/config/`），无需改代码即可调整
+- **多数据源适配**：新增 fetchers/ 统一接口层，支持腾讯/东财/新浪/AkShare/eFinance/baostock/pytdx/tushare/yfinance 等 9+ 数据源自由切换
+- **统一异常与验证**：新增 `common/exceptions/` 统一异常类、`common/validators.py` 输入验证器
 - **Plugin 化分发**：支持通过 Claude Code plugin 系统一键安装，无需重启
 - **帮助系统**：新增 `/help` skill，显示所有可用 skills 和使用说明
+- **回测引擎**：新增 `backtest.py`，支持策略历史回测验证
+- **候选池管理**：新增 `init_pool.py` / `refresh_pool.py`，支持候选池初始化与定期刷新
+- **实时监控**：新增 `monitor.py`，支持持仓和关注标的实时监控
 - **行业差异化阈值**：五层分析框架按行业分档（金融/消费/科技/周期/医药/制造/能源/地产），避免一刀切误判
 - **风控体系强化**：集中度控制（单只≤15%、单行业≤30%）、时间止损、极端情景预案、加仓规则
-- **缠论盘整背驰**：补全中枢进入段 vs 离开段的 MACD 面积对比
-- **评分上限修正**：各维度评分独立 clamp，总分不超过 100
-- **流动性板块差异化**：主板/创业板/科创板/北交所使用不同满分阈值
 - **专家权重优化**：长短线权重随投资期限变化，巴菲特否决权限定中长期模式
 - **工作流增强**：交接字段补充投资期限/催化剂/论点破灭条件，决策门槛量化
 
 ## 已知限制
 
 - 实时数据依赖外部 API 端点稳定性；如遇变更，修改 `scripts/common.py` 中端点即可
-- portfolio skill 默认读取 `data/portfolio_example.json` 作为示例，实际使用前需自定义
+- portfolio skill 默认读取 `scripts/data/portfolio_example.json` 作为示例，实际使用前需自定义
 - 部分 API（如东财公告）可能有反爬限制，已加超时和重试
 - 多因子权重基于经验设定，尚未经过历史回测验证

package/data/reports/202506_Stock_Analysis_Summary.md

@@ -0,0 +1,271 @@
+# 近期深度分析股票汇总
+
+> 汇总时间：2026-06-08 | 分析框架：五层分析 + 8人专家圆桌
+
+---
+
+## 一、分析方法论
+
+### 1.1 五层分析框架
+
+| 层级 | 分析内容 | 输出 |
+|------|----------|------|
+| 基本面 | ROE/增速/毛利/负债/现金流 | 评级(A/B/C) |
+| 估值 | PE/PEG/PE-ROE | 评级(低估/合理/偏贵) |
+| 技术面 | K线趋势/支撑阻力/量价 | 评级(强/中/弱) |
+| 板块 | 所属板块/大宗商品/行业景气 | 评级 |
+| 风险收益比 | 情景分析+概率加权 | 期望收益% |
+
+### 1.2 专家圆桌机制
+
+**长线组**：巴菲特（价值）、彼得·林奇（成长）、索罗斯（趋势）、段永平（逆向）
+
+**短线组**：徐翔（涨停板）、赵老哥（趋势龙头）、炒股养家（情绪流）、作手新一（低吸）
+
+**决策规则**：
+- 市场环境权重：震荡市（长线55%，短线45%）
+- 冲突解决：巴菲特≤39触发否决权
+- 信心指数 = 一致性分×0.4 + 综合分×0.6
+
+### 1.3 输出格式模板
+
+```
+## 一句话结论
+[核心判断 + 置信度]
+
+## 一、五层分析
+### 第1层：基本面 评级 [A/B/C]
+[财务指标表格]
+
+### 第2层：估值 评级 [低估/合理/偏贵]
+[PE/PEG/同业对比]
+
+### 第3层：技术面 评级 [强/中/弱]
+[技术指标 + 支撑阻力]
+
+### 第4层：板块
+[行业景气 + 大宗商品]
+
+### 第5层：风险收益比
+[情景分析 + 凯利公式仓位]
+
+## 二、8人专家圆桌
+[评分表 + 分组汇总 + 信心指数]
+
+## 三、综合投资建议
+[评级 + 仓位 + 止损止盈 + 跟踪条件]
+```
+
+---
+
+## 二、股票分析汇总
+
+### 2.1 海尔智家（600690）
+
+| 维度 | 数据 | 评级 |
+|------|------|------|
+| 现价 | 20.17元 | - |
+| 涨跌 | -0.69% | - |
+| PE | 10.11 | 低估 |
+| 2025 ROE | 16.98% | A |
+| Q1净利增速 | -15.22% | C |
+| 负债率 | 55.15% | B+ |
+| 技术评分 | 50.5 | 中性 |
+| **综合评级** | **Hold/Observe** | 置信度65% |
+
+**核心逻辑**：PE 10x偏低估，ROE达标，但Q1业绩下滑15%短期承压��技术面偏弱
+
+**风险点**：Q1净利下滑、毛利率持续收窄、白电行业增速放缓
+
+---
+
+### 2.2 宝丰能源（600989）
+
+| 维度 | 数据 | 评级 |
+|------|------|------|
+| 现价 | 23.60元 | - |
+| 涨跌 | +0.73% | - |
+| PE | 13.76 | 低估 |
+| 2025 ROE | 24.84% | A+ |
+| Q1净利增速 | +50.23% | A |
+| 毛利率 | 37.40% | A |
+| 负债率 | 44.86% | A |
+| 技术评分 | 68.6 | 偏多 |
+| **综合评级** | **Buy** | 置信度78% |
+
+**核心逻辑**：ROE 25%顶级，净利增速50%+，PEG仅0.17严重低估，技术面三阴一阳+缠论底背驰
+
+**催化剂**：油价高位运行、内蒙古项目放量、估值修复
+
+---
+
+### 2.3 云铝股份（000807）
+
+| 维度 | 数据 | 评级 |
+|------|------|------|
+| 现价 | 26.80元 | - |
+| 涨跌 | -3.04% | - |
+| PE | 10.71 | 低估 |
+| 2025 ROE | 19.70% | A |
+| Q1净利增速 | +269.45% | A+ |
+| 毛利率 | 31.57% | A |
+| 净利率 | 25.30% | A+ |
+| 负债率 | 17.74% | A+ |
+| 技术评分 | 63.5 | 偏多 |
+| **综合评级** | **Buy** | 置信度80% |
+
+**核心逻辑**：Q1净利暴增269%创纪录，PE仅10.7x，负债率17.7%极安全，技术面双针探底+老鸭头
+
+**催化剂**：铝价高位、电解铝满产、绿电优势
+
+---
+
+### 2.4 洛阳钼业（603993）
+
+| 维度 | 数据 | 评级 |
+|------|------|------|
+| 现价 | 16.89元 | - |
+| 涨跌 | -7.15% | - |
+| PE | 14.96 | 低估 |
+| 2025 ROE | 26.61% | A+ |
+| Q1净利增速 | +96.65% | A |
+| 毛利率 | 22.88% | B+ |
+| 负债率 | 52.03% | B |
+| 技术评分 | 70.6 | 偏多 |
+| **综合评级** | **Buy** | 置信度75% |
+
+**核心逻辑**：铜金双极战略，Q1净利+97%，PE仅15x，MACD底背离+老鸭头技术面共振
+
+**催化剂**：铜价高位、金价上涨、KFM铜钴矿放量
+
+---
+
+### 2.5 贵研铂业（600459）
+
+| 维度 | 数据 | 评级 |
+|------|------|------|
+| 现价 | 23.85元 | - |
+| 涨跌 | -3.64% | - |
+| PE | 29.79 | 偏高 |
+| 2025 ROE | 8.75% | C |
+| Q1净利增速 | +9.13% | C |
+| 毛利率 | 3.63% | C |
+| 净利率 | 1.80% | C |
+| 负债率 | 64.91% | C |
+| 技术评分 | 57.0 | 中性 |
+| **综合评级** | **Hold** | 置信度55% |
+
+**核心逻辑**：贵金属催化剂概念热门，但基本面薄弱（ROE 8.8%、净利率1.8%），PE 30x偏贵
+
+---
+
+### 2.6 华友钴业（603799）
+
+| 维度 | 数据 | 评级 |
+|------|------|------|
+| 现价 | 46.72元 | - |
+| 涨跌 | -6.49% | - |
+| PE | 12.05 | 低估 |
+| 2025 ROE | 13.70% | B |
+| Q1净利增速 | +99.45% | A |
+| 毛利率 | 20.69% | B+ |
+| 负债率 | 63.57% | C |
+| 技术评分 | 46.2 | 中性偏弱 |
+| **综合评级** | **Hold** | 置信度65% |
+
+**核心逻辑**：Q1净利翻倍，PE 12x低估，但技术面极弱（MACD死叉、均线空头），负债率63.6%偏高
+
+**催化剂**：钴价回暖、一体化成效
+
+---
+
+### 2.7 中兴通讯（000063）
+
+| 维度 | 数据 | 评级 |
+|------|------|------|
+| 现价 | 36.81元 | - |
+| 涨跌 | -5.93% | - |
+| PE | 39.35 | **高估** |
+| 2025 ROE | 7.58% | C |
+| Q1净利增速 | **-46.58%** | **C** |
+| 毛利率 | 28.28% | B |
+| 净利率 | 3.77% | C |
+| 负债率 | 65.87% | C |
+| 技术评分 | 58.5 | 中性 |
+| **综合评级** | **Sell** | 置信度55% |
+
+**核心逻辑**：PE 39x严重高估，净利连续负增长（-33%、-46%），ROE仅7.6%远低于15%优秀线
+
+**风险点**：运营商业务承压、手机亏损、估值泡沫
+
+---
+
+## 三、对比总结
+
+### 3.1 评级排序
+
+| 排名 | 股票 | 评级 | 置信度 | PE | Q1增速 |
+|------|------|------|--------|-----|--------|
+| 1 | 云铝股份 | Buy | 80% | 10.7 | +269% |
+| 2 | 宝丰能源 | Buy | 78% | 13.8 | +50% |
+| 3 | 洛阳钼业 | Buy | 75% | 15.0 | +97% |
+| 4 | 华友钴业 | Hold | 65% | 12.1 | +99% |
+| 5 | 海尔智家 | Hold | 65% | 10.1 | -15% |
+| 6 | 贵研铂业 | Hold | 55% | 29.8 | +9% |
+| 7 | 中兴通讯 | **Sell** | 55% | 39.4 | **-47%** |
+
+### 3.2 关键指标对比
+
+| 股票 | PE | ROE(2025) | Q1增速 | 负债率 | 技术分 |
+|------|-----|-----------|--------|--------|--------|
+| 云铝股份 | 10.7 | 19.7% | +269% | 17.7% | 63.5 |
+| 宝丰能源 | 13.8 | 24.8% | +50% | 44.9% | 68.6 |
+| 洛阳钼业 | 15.0 | 26.6% | +97% | 52.0% | 70.6 |
+| 华友钴业 | 12.1 | 13.7% | +99% | 63.6% | 46.2 |
+| 海尔智家 | 10.1 | 17.0% | -15% | 55.2% | 50.5 |
+| 贵研铂业 | 29.8 | 8.8% | +9% | 64.9% | 57.0 |
+| 中兴通讯 | **39.4** | 7.6% | **-47%** | 65.9% | 58.5 |
+
+---
+
+## 四、经验总结
+
+### 4.1 选股核心逻辑
+
+1. **基本面优先**：ROE > 15%、净利增速 > 20%、毛利率 > 30%
+2. **估值匹配**：PE/ROE < 3，PEG < 1（高增长允许放宽）
+3. **技术面确认**：趋势向上、支撑有效、买入信号共振
+4. **同业对比**：确认相对优势，避免估值陷阱
+
+### 4.2 风险识别模式
+
+| 风险类型 | 识别信号 | 典型案例 |
+|----------|----------|----------|
+| 业绩下滑 | Q1增速转负 | 中兴通讯(-47%) |
+| 估值泡沫 | PE > 30 且负增长 | 中兴通讯(PE 39x) |
+| 负债过高 | 负债率 > 60% | 华友钴业(63.6%) |
+| 技术破位 | MACD���叉+放量下跌 | 华友钴业 |
+| 周期陷阱 | 低价但无成长 | 贵研铂业(PE 30x) |
+
+### 4.3 今日市场特征
+
+- 沪深300ETF: -2.15%（大盘偏弱）
+- 有色/能源/AI板块领跌
+- 7只分析股票中6只下跌，仅宝丰能源微涨
+- 市场整体处于震荡调整期
+
+---
+
+## 五、后续跟踪
+
+| 股票 | 跟踪指标 | 预期信号 |
+|------|----------|----------|
+| 云铝股份 | Q2财报、铝价 | 增速维持50%+ |
+| 宝丰能源 | 油价、内蒙古项目 | 钴价/烯烃价格 |
+| 洛阳钼业 | 铜价、KFM投产 | 铜价维持9000+ |
+| 华友钴业 | 钴价、负债率下降 | MACD金叉 |
+| 中兴通讯 | 算力业务订单 | Q2业绩拐点 |
+
+---
+
+> **注意**：本汇总仅供方法论参考，不构成投资建议。投资有风险，入市需谨慎。

package/experts/README.md

@@ -1,5 +1,8 @@
 # 8 人专家圆桌 · 投资哲学档案库
 
+> 版本：v1.1.0（2026-06-08）
+> 数据接口更新：所有调用方式已适配 `scripts/data/` 和 `scripts/common/` 模块
+
 本目录是 [methodology.md §三 专家讨论模式](../methodology.md#三专家讨论模式8人圆桌) 的扩展档案库。
 每位专家单独成文，深度档（1200-1500 中文字），覆盖：
 
@@ -97,13 +100,31 @@
 
 **标准流程**：
 
-1. 获取目标股票数据（scripts/）
-2. 获取大盘环境数据（scripts/quote.py sh000001,sh510300）
+1. 获取目标股票数据（`scripts/data/`）
+2. 获取大盘环境数据（`scripts/quote.py sh000001,sh510300` 或 `get_quote("sh000001")`）
 3. 判断市场状态 → 确定长线/短线权重
 4. 每位专家按 §九 评分矩阵独立打分
 5. 按 decide.md 进行投票汇总和冲突解决
 6. 输出：评分表 + 方向 + 风险 + 仓位
 
+**代码示例**：
+
+```python
+from data import get_quote, get_quotes, get_kline, get_finance
+
+# 获取单只股票数据
+quote = get_quote("sh600989")
+finance = get_finance("sh600989")
+kline = get_kline("sh600989", scale=240, datalen=30)
+
+# 获取多只股票数据
+quotes = get_quotes(["sh600989", "sz000807"])
+
+# 获取大盘数据
+index_quote = get_quote("sh000001")  # 上证指数
+etf_quote = get_quote("sh510300")    # 沪深300 ETF
+```
+
 ---
 
 ## 使用建议

package/experts/buffett.md

@@ -88,4 +88,47 @@
 
 ### 调用方式
 
-debate 模式中，从 scripts/ 获取最新 ROE/PE/负债率/FCF 后，按上表打分。估值分需结合 PE 历史分位调整——A 股取近 5 年 PE 分位，<20%分位额外+15分，>80%分位额外-20分。
+debate 模式中，从 `scripts/data/` 获取最新 ROE/PE/负债率/FCF 后，按上表打分。估值分需结合 PE 历史分位调整——A 股取近 5 年 PE 分位，<20%分位额外+15分，>80%分位额外-20分。
+
+**代码示例：**
+
+```python
+from data import get_quote, get_finance
+from common import to_float
+
+# 获取数据
+quote = get_quote("sh600989")
+fin = get_finance("sh600989")[0]
+
+# 基本面维度
+roe = to_float(fin.get("ROEJQ", 0))
+if roe >= 20:
+    base_score = 100
+elif roe >= 15:
+    base_score = 75
+elif roe >= 10:
+    base_score = 40
+else:
+    base_score = 0
+
+# 估值维度
+pe = to_float(quote.get("pe", 0))
+if pe <= 15:
+    pe_score = 100
+elif pe <= 25:
+    pe_score = 60
+elif pe <= 40:
+    pe_score = 25
+else:
+    pe_score = 0
+
+# 安全边际维度
+debt_ratio = to_float(fin.get("ZCFZL", 0))
+fcf_ratio = to_float(fin.get("MGJYXJJE", 0)) / max(to_float(fin.get("EPSJB", 1)), 0.01)
+if debt_ratio < 30 and fcf_ratio > 0.8:
+    margin_score = 100
+elif debt_ratio < 50:
+    margin_score = 60
+else:
+    margin_score = 0
+```