# Ashare Stock Research

> Use when 分析A股个股/板块题材/大盘量能/换手率/预测走势。免费接口拉数→技术指标→结构化报告。

- Skill: `aaaaqwq/ashare-stock-research` (Agent Skill, multi-file: 22 files)
- Install (CLI): `npx get-skill add aaaaqwq/ashare-stock-research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aaaaqwq/ashare-stock-research/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- License: MIT
- Author: aAAaqwq (https://skillmd.com/u/aaaaqwq)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/aaaaqwq/ashare-stock-research

---


# A股个股投研（数据源 + 结构化报告工作流）

A股个股分析的标准工作流：**免费公开接口拉数（腾讯/东财/新浪）→ 计算技术指标 → 画K线图 → 输出结构化投研报告**。本 skill 收录实测可用的数据源、字段映射、反限流技巧与用户偏好的报告结构。

## 触发条件
- 用户要求"分析/看看 XX 股票"、问板块/题材归属、预测明日走势、持仓后问"割肉还是持有/怎么操作"
- 用户给出涨停/异动监控列表（作战池）问题材归类
- 用户给出买入成本价，要求针对性操作方案
- **持仓盯盘告警系统**（加/删盯盘票、改成本价、改提醒频率、提醒太吵、"阈值过期/每次都在推同一句"、盯盘脚本报错）
  → 走 skill **`position-alert-watchdog`**（cron no_agent + 动态阈值 + 每日去重）；本 skill 只负责提供行情/日K数据源。
- **问"怎么看大盘/成交量怎么读/竞价缩量放量/量能趋势/板块资金流向"** → 走 `references/market-volume-analysis.md`：必须用真实数据出判定阈值表 + 一个板块的实证（用户明确要求"拿科技来看"这类具象化），不能只讲空泛方法论。
- **问"换手率本质是什么/意味着什么"、个股高换手能不能跟** → 走 `references/turnover-rate-analysis.md`：先给本质定义 → 三维判定表（换手率×主力资金×价格六象限）→ 配他自己的持仓票实证。
- **问"如何精确判断主力资金走向/怎么知道是主力在买还是散户在接"** → 走 `references/main-force-capital-verification.md`：先破除"主力资金流是推算值"的幻觉 → 证据金字塔 → 龙虎榜席位性质 + 股东户数两大硬武器 → 同日对照实证。用户偏好在结论后追问方法论，主动把它做成可复用框架。
- **问"筹码分析 / 进出货 / 庄家资金强弱 / 会不会突破 / 还是洗盘出货"** → 用户明确点名的**五维框架**（缺一不可）：
  **① 筹码结构 → ② 主力进出货 → ③ 庄家资金强弱 → ④ 所属板块共振 → ⑤ 大盘**。
  筹码分布东财 `cyq` 接口已 404，改用**自建筹码模型**（价格网格 + 换手率衰减），
  算法/指标/实证全在 `references/chip-distribution-model.md`。
  ⚠️ **只罗列指标不给结论是无效输出** —— 必须落到「**突破 / 洗盘 / 出货**」三选一 + 概率 + 关键触发位，
  并给出可执行价位（上方压力 / 下方防线 / 减仓位）。
- **问\"财报出来了怎么看 / 业绩这么好为什么还跌 / 是不是利好出尽 / 明天财报落地怎么走\"**，
  或用户拿着**刚发布的季报·业绩快报**问涨跌 → **第一步不是读财报数字，是查「这份东西市场什么时候知道的」**，
  走 `references/earnings-announcement-verification.md`：公告列表 + 公告正文两个接口，把
  **业绩预告的发布日与预告区间**和**实际值**并排摆出来。
  **利好落地（预告早披露 + 实际值落在预告区间中部 = 零超预期）≠ 利好突发**，前者次日大概率"利好出尽"。
  ⚠️ **只看财报数字不看披露时点，会把"已知信息的确认"误判成"新催化" —— 结论方向直接反过来。**
- **问"能不能做 T / 今日怎么做 / 该不该现在挂单 / X 卖 Y 买回 / 挂单要不要等开盘"**，或给出**底仓成本价**
  要求降成本方案 → 走 `references/t-plus-zero-and-order-placement.md`：集合竞价挂单规则（9:15-9:20 可撤、
  9:20-9:25 **不可撤**、盘前挂 = 9:15 才报送）、限价单不会吃暗亏的价格优先原理、做 T 三前提
  （**必须有底仓**，A股 T+1；振幅 ≥2-3%；非单边下跌）、降成本数学、分档挂单 + 四条铁律、
  卖点窗口判定（用前30min占比识别「早盘冲高」形态）、
  **⭐ 昨日 VWAP 做中枢（含腾讯字段单位坑）+ 净收益 <30 元就不做 + 正T/反T 按外部变量选 + 破 MA10 不买回 + 竞价后条件化方案表**。
  ⚠️ **用户给成本价时必须先算浮亏 + 止损线（成本×0.95）并明确说「已破/未破」**；若已破线，
  先点破这一点再谈做 T —— 且**「反抽减仓」要排在「做 T」之前**，别让做 T 掩盖该止损的事实。
- **问"怎么看放量还是缩量 / 成交量怎么看 / 盘中怎么看订单/盘口分析涨跌 / 量比在哪看"** →
  走 `references/stock-volume-and-orderbook.md`：个股量能标尺（量÷5日/10日/20日均量 + 阈值表、
  换手率按市值分档、**盘中按时间折算或直接看量比**）、**放量≠好（位置×方向四象限）**、
  盘口订单分析（委比/内外盘/大单/逐笔 + 四种盘口陷阱 + 东财手机APP量比位置）。
  ⚠️ 用户偏好**具象化**：不能只讲方法论，必须配**他自己持仓票的真实数据表**做实证。
- **问"现在能不能买宽基 ETF / 有没有推荐 / XX ETF 的风险收益比如何 / 这个位置值不值得买"** →
  走 `references/index-etf-risk-return.md`：四步流程（定位 → 估值 → 趋势 → **历史条件回测**）、
  年化收益/波动/夏普/卡玛/最大回撤/回本时间的纯 Python 算法、**⭐ 回撤深度分层回测**
  （510300 实测：浅回撤 15-25% 档 1 年胜率仅 31%，35-50% 档才 94%）、趋势确认信号回测
  （站上周 MA20/MA30 +7~9pp，MA52 金叉无效）、持有期 vs 胜率表、标的分层口径。
  ⚠️ **"跌到新低"不等于"便宜"**：必须同时报「近 250 日分位」和「历史 10 年+分位」两个尺度
  （实测 510300 一年新低 = 11.7 年的 63.7% 分位，一点都不便宜）。
  ⚠️ **禁止只看位置就下"可以分批买"的结论** —— 必须先跑回撤分层回测拿到历史胜率，再谈仓位。
- **问"有没有周期性 ETF / 要一个当前处于周期反弹上涨阶段的 / 今天建仓哪个 ETF 好、什么价入 / 结合新闻面和商品走势看走势"** →
  走 `references/cyclical-etf-screening.md`：**三维判据**（站上全部均线 + 对应商品期货在涨 + 板块龙头共振，缺一不可）、
  22 只周期 ETF 代码池 + 商品期货代码对照（`nf_XX0` 内盘 / `hf_XX` 外盘）、
  **⭐ 成分归因法**（ETF 跌但同主题单一商品 ETF 涨 ⇒ 跌幅来自另一部分，是可解释低开不是逻辑坏了）、
  三批建仓 + 跳空调整表、**宽基 ETF 不设价格止损 / 单一行业 ETF 必须设**的口径区别、新闻面五层框架 + 概率化情景。
  ⚠️ **"跌 39%"的有色/光伏不是"周期反弹"，是下跌趋势** —— 三维不满足就明说不碰。
  ⚠️ **银行 ETF 不是周期股**（红利逻辑），用户要商品周期时别拿它凑数。
- **问\"被套了，反弹回成本线要多久 / 还有没有机会回本 / 亏这么多要不要等\"** →
  走 `references/breakeven-time-calculation.md`：先算 `回本需涨 = 成本/现价 − 1`（**跌 30% 要涨 43%，
  非线性**），再跑 250 个起点的「首次达标耗时」分布，输出**三件套**：
  `需涨 X% | 中位 N 日 | 250日内达成率 Y%`。
  ⚠️ **⭐ 只报中位数就是骗人** —— 中位数只统计成功样本（示例股C实测：中位 20 日，但达成率仅 31%）。
  ⚠️ 结论要给「时间/机会/心理」三层成本 + **分批+死线**，不要一刀切（用户会讨价还价"真得完全割吗"）。

## ⭐ 选股流程（问「选几只优质股 / 明天哪个有机会 / 有没有有主力的」时）

完整框架在 skill `youzi-stock-quality-screen`（五标准 + 量价四象限）+ `ashare-volume-resonance-analysis`（四维共振）。**本节只记录三条被用户当面纠正过的硬规则** —— 无论走哪个框架，这三条必须遵守。

### 规则 1：**可买性是第一道闸，买不进的一切筛选都是白做**

> **用户原话：「根本买不进选的没用呀」** —— 2026-10-26 按框架选出三只全封死一字板（上海九百封单 11.25 万手、多伦科技 39.7 万手、卖1-3 全为 0），次日全部涨停但一股买不到。

| 指标 | 🟢 买得进 | 🔴 买不进 | 取法 |
|---|---|---|---|
| **封单金额** | **≤ 0.5 亿** | > 2 亿 | 东财涨停池 `fund` |
| **换手率** | **8-20%** | < 3% | 东财涨停池 `hs` |
| **量比** | **> 1** | < 0.5 | 腾讯 `[49]` |
| **炸板次数** | 0-2 次（说明会开） | 一字板且换手<1% | 东财涨停池 `zbc` |
| **卖1-5 挂单** | 有量（>100 手） | 全为 0 | 腾讯 `[19]~[28]` |

**口诀**：封单越小越能开、换手越高越能进、量比越低越买不到。**一字板 + 卖盘为 0 = 只能看不能做。**

⚠️ **先把这一层过掉再谈其他维度**。反过来，如果一只票「五标准全过但封死」，正确输出是**明确说买不进**，而不是把它当推荐。

### 规则 2：**开板了，是「分歧」还是「出货」——只看能不能快速回封**

| # | 判据 | 🟢 分歧（洗盘，可进） | 🔴 出货（派发，别碰） |
|---|---|---|---|
| **1** | **开板后能否快速回封**（最关键） | **5-15 分钟内回封** | 迟迟不回，或收盘没回 |
| 2 | 开板最低价距涨停价 | **−2% 以内** | **−5% 以上** |
| 3 | 开板时量能 | 温和（< 封单量 30%） | **突然放天量** |
| 4 | 回封后量能 | **缩量**（锁住） | **持续放量**（还在换手） |
| 5 | 炸板次数 | **1-2 次** | **3 次以上** |
| 6 | 当天资金流 | 净流入 | **大额净流出** |

**本质**：分歧 = 卖的人少买的人多 → 快速回封 → 筹码从弱手换到强手；出货 = 主力想卖的量 > 接盘量 → 越走越低回不来。
**口诀**：**开板不可怕，「开板后回不回得来」才是关键。**

**竞价阶段只能给倾向**（卖1-5 极薄 + 外盘 >75% + 低开 <2% → 偏分歧；卖2/卖3 压数千手 + 外盘 <50% + 低开 >3% → 偏出货），**必须等 9:30-9:45 真实回封行为确认**。

**⚠️ 顺带识别「内外盘背离」**：挂单很厚（买1 数千手）但内盘是外盘 3-4 倍 = **托单诱多**，挂单是假的、砸盘是真的。2026-10-26 实测示例股A竞价内/外盘 4.3:1、示例股F 3.9:1，当天分别 −9.40% / −7.65%。

**实战对照**：2026-10-27 东方海洋/秦安股份/襄阳轴承均炸板 1 次后 3-7 分钟回封 → 六判据全属真分歧（但封单 12.9-51.6 万手，当天仍买不进，见规则 1）；兰生股份开盘封 9.02 → 砸到 8.56 全天未回 + 天量 9.2x → 全指向出货。

### 规则 3：**永远不要承诺「必涨」**

用户会问「明天必涨的是哪个」。**必须当场拒绝这个提法，改成「概率 + 触发条件 + 失效条件」**：

- 先泼冷水：「没有任何方法能保证必涨」
- 报一个自己的概率估计（**弱势环境要压低，如 40-55% 而不是 70%**）
- 给「今天必须发生什么，明天才算有戏」的验证条件（如「海洋王今天封住涨停，明天才有溢价；封不住都是空谈」）
- **查市场宽度再说结论**：涨跌比 <1:2 → 所有追涨建议打折；<1:3 → 只减不加。2026-10-27 实测 1156 涨 vs 4303 跌（1:3.7），当天所有追涨结论都该附这个前提。
- 如果自己的系统（龙擎）`high_prob` 全为 false / 数据 `DEGRADED`，**如实告知**，别包装成有信心。
- **⭐ 给「明天可接力」的建议前，先看今天的高位股是否在批量崩塌**：若当天有 **≥2 只 4 板以上票跌停**，
  所有接力/连板建议作废，改「防守/减仓」口径。2026-11-16 实测：东方环宇（5板）、锋龙股份（4板）、
  大东方（4板）、日盈电子（前一日刚涨停）同日全部跌停，当日跌停 60 只 > 涨停 32 只、创业板 −4.37%。
  **配套教训**：系统分/首板强度只能选「当天」，不能预测「次日」—— 日盈电子当时龙擎加权分池内第一
  （0.842）、推荐后 40 分钟内封涨停，**次日仍直接跌停**。决定次日存活的是**位置**（距 MA30），不是分数。

### 规则 4：**追高禁令 —— 乖离 MA5 > 10% 不许给买点**

> **事故（2026-10-28）**：示例股B 600000 我写「现价可小仓」，用户冲到 **12.70** 买入 —— 那是当日最高 12.71 附近，**全天只有 3 分钟价格 ≥12.70**。当时乖离 MA5 已达 **+11.87%**（健康区间 3-8%），属严重透支。

| 乖离 MA5 | 判定 | 动作 |
|---|---|---|
| **0 ~ +8%** | 🟢 健康上涨 | 可给买点 |
| **+8% ~ +10%** | 🟠 偏热 | 只能小仓，且**必须写明「回踩 MA5 再进」** |
| **> +10%** | 🔴 **透支** | **不给多头建议**，只给「等回踩」或「已持仓减仓」 |

**配套的日内买点纪律**（写进任何盘中建议）：
- 不追当日涨幅 > **+5%** 的票（除非是 skill `main-force-prelaunch-pattern` 定义的「确认启动」放量突破）
- 必须报 **「现价距今日最高 X%」**；< 0.5% 就是买在最高点，要明确说
- 分时只能给倾向时，也要给「什么价位才算好买点」，不要只说「可以小仓」

**本质**：乖离大 = 短期成本高于市场平均太多，回踩 MA5 是均值回归的必然。**追高不是勇敢，是把胜率让给对手。**

### 规则 5：**成本必须用用户给的明确数字，不许自己推**

> **事故（2026-10-29）**：用户说「示例股B买了 12.7」，我按 12.70 算 → 报告「+2.83% 盈利」。用户发来持仓截图，实际成本 **13.527**（后来加过仓），真实是 **−3.60% 亏损** —— **盈/亏方向都算反了**。

**规则**：
1. 用户报成本 → **只用这个数字**，不推、不假设、不「按之前说的」。
2. 用户发持仓截图 → **逐字取**（持仓量 / 可用量 / 现价 / 成本 / 盈亏额），不沿用对话里的旧成本。
3. 疑似加仓/摊薄 → **主动确认「成本是 XX 吗，我按新成本重算」**，不默默沿用。
4. 发现自己算错 → **立刻明确纠正 + 重算全部相关数字**（含盈亏额、止损位、减半后的亏损额）。
5. 每份持仓分析开头列一行 **「成本 / 持仓量 / 来源（口述 or 截图）」**，保证可追溯。

---

### 数据入口：龙擎主力池优先

用户有自己的研究终端 `longqin.hanxai.cn`（主力池自带控盘度/强度/加权分）。**选股时先拉它，再补外部行情验证** —— 详见 `references/longqin-main-pool.md`（登录、端点、字段语义、breadth 判据、Pitfalls、实测案例）。

⚠️ 三个必记的坑：`high_prob` 常年整池 false；`strength` 高 + `control` 低 = 危险组合（如慈文传媒 strength 39.86 却 −4.18%）；池内 `industry` 与涨停池 `hybk` 口径不同，算结构轴要用后者。

---

## 数据源速查（全部免费、无需 key，实测 2026-08/09）

### 1. 实时行情（腾讯，最稳）
```bash
curl -s "http://qt.gtimg.cn/q=sz002491" | iconv -f gbk -t utf-8
# 或 Python urllib + decode('gbk')
```
返回 `v_sz002491="51~名称~代码~现价~昨收~今开~成交量~...~涨跌额~涨跌%~最高~最低~...~成交额万~换手%~...~PE~...~总市值亿~...~涨停~跌停~时间戳"`，**按 `~` split**，关键索引：
- `[1]`名称 `[2]`代码 `[3]`现价 `[4]`昨收 `[5]`今开 `[31]`涨跌额 `[32]`涨跌% `[33]`最高 `[34]`最低 `[37]`成交额(万) `[38]`换手% `[39]`PE(TTM) `[45]`总市值(亿) `[47]`涨停价 `[48]`跌停价 `[30]`时间戳(YYYYMMDDHHMMSS, 北京时间)
- 前缀：沪市 `sh`，深市 `sz`。多股一次查用逗号拼接 `q=sh000001,sz399001,sz002886`。
- 指数代码：上证 `sh000001`、深成 `sz399001`、创业板 `sz399006`。

### 2. 日K线（⚠️ 2026-10 起腾讯已失效，改东财主源）
```python
# 主源：东财 push2his（格式 日期,开,收,高,低,量(手),额 —— 注意是「开收高低」）
GET https://push2his.eastmoney.com/api/qt/stock/kline/get?secid=0.002403
    &fields1=f1,f2,f3,f4,f5,f6&fields2=f51,f52,f53,f54,f55,f56,f57
    &klt=101&fqt=1&end=20500101&lmt=120
# data.klines[] 每行逗号分隔字符串

# 备源：新浪（volume 单位是股，÷100 转手）
GET https://money.finance.sina.com.cn/quotes_service/api/json_v2.php/CN_MarketData.getKLineData
    ?symbol=sz002403&scale=240&ma=no&datalen=120

# 兜底（已 501，仅留兼容）：腾讯 fqkline → data.sz002491.qfqday = [[date,open,close,high,low,volume],...]
```
取 120 根够算 MA60；画图常用最近 50-60 根。
**⚠️ 双源降级 + 统一封装代码 + 前缀拼接坑（`szsz399006`）见 `references/data-sources.md`「日K 三源降级链」** —— 写任何 K 线脚本前先读那节，别只接一个源。

### 3. 新闻（东财搜索 jsonp）
```python
GET https://search-api-web.eastmoney.com/search/jsonp?cb=cb&param={"keyword":"<urlencoded>","type":["cmsArticleWebOld"],"param":{"cmsArticleWebOld":{"sort":"time","pageIndex":1,"pageSize":10}}}
# 返回 cb({...}) — 需正则剥壳：re.search(r'cb\((.*)\)$', raw, re.S)
# result.cmsArticleWebOld[] 每条含 date/title/content
```
- 搜个股名可得：龙虎榜新闻、异动公告报道、板块行情（如"光纤概念震荡走强"）。
- 搜"A股 收评/涨停 主线/美联储 加息"等可得大盘与信息面。

### 4. 财务（东财 F10，中英字段混合）
```python
GET https://emweb.securities.eastmoney.com/PC_HSF10/NewFinanceAnalysis/ZYZBAjaxNew?type=0&code=SZ002491
```
- `type=0` + code 格式 `SH600183`/`SZ002491`。返回 `data[]` 按报告期倒序。
- 关键字段（金额为**原始元**，报表时 ÷1e8 转亿）：`TOTALOPERATEREVE`营收、`TOTALOPERATEREVETZ`营收同比%、`PARENTNETPROFIT`归母净利、`PARENTNETPROFITTZ`净利同比%、`KCFJCXSYJLR`扣非净利、`XSMLL`毛利率%、`ROEJQ`ROE%、`EPSJB`、`BPS`。
- 必查 3-4 期：中报→一季报→上年报→上年中，才能看出业绩拐点。

### 5. 题材/概念归属（东财 F10 CoreConception）
```python
GET https://emweb.securities.eastmoney.com/PC_HSF10/CoreConception/PageAjax?code=SZ002235
```
返回 dict 内 `gnbk`（概念板块）/`hybk`（行业）/`ssbk`（所属）各列表，取 `BOARD_NAME`。**题材归属以此为准**，不是自己编；但"当前市场实际在炒哪个"需结合当日新闻判断（标签有滞后）。

### 6. 龙虎榜（东财数据中心）
```python
GET https://datacenter-web.eastmoney.com/api/data/v1/get?reportName=RPT_DAILYBILLBOARD_DETAILSNEW&columns=ALL&filter=(TRADE_DATE='2026-09-02')(SECURITY_CODE="002104")&pageNumber=1&pageSize=20
```
汇总字段：`BILLBOARD_NET_AMT`净买额(负=净卖)、`BILLBOARD_BUY_AMT/SELL_AMT`、`BUY_SEAT/SELL_SEAT`席位家数、`TURNOVERRATE`、`EXPLAIN`机构说明、`CHANGE_RATE`。
- **买入席位明细用 `RPT_BILLBOARD_DAILYDETAILSBUY`**（实测可用；`RPT_BILLBOARD_TRADEDETAIL` 常返回 null）：
  ```python
  GET https://datacenter-web.eastmoney.com/api/data/v1/get?reportName=RPT_BILLBOARD_DAILYDETAILSBUY
      &columns=ALL&pageNumber=1&pageSize=12&filter=(TRADE_DATE='2026-09-07')(SECURITY_CODE="603228")
      &source=WEB&client=WEB
  ```
  字段：`OPERATEDEPT_NAME`席位名、`BUY`/`SELL`/`NET`(元)。**这是判断"谁在买"的唯一硬数据**——席位名本身暴露身份（机构专用 / 沪股通专用 / 高盛等外资券商 / 游资营业部 / 东方财富拉萨=散户接盘）。席位性质词典 + 交叉验证法见 `references/main-force-capital-verification.md`。
- **查"最近 N 条"不要带日期 filter**：改用 `&sortColumns=TRADE_DATE&sortTypes=-1`，带日期的写法高频 400。
- 兜底：东财新闻搜"XX 龙虎榜"（媒体已摘要机构/深股通/营业部买卖）。

### 7. 主力资金流
- **东财历史日线**：`https://push2his.eastmoney.com/api/qt/stock/fflow/daykline/get?lmt=0&klt=101&secid=1.600183&fields1=f1,f2,f3,f7&fields2=f51,f52,f53,f54,f55,f56` → `data.klines` 每行 `日期,主力,小单,中单,大单,超大单`(元)。⚠️ **高频访问极易 429/连接被断**，需重试 + 间隔 3-5s。
- **新浪兜底**（更稳）：`https://vip.stock.finance.sina.com.cn/quotes_service/api/json_v2.php/MoneyFlow.ssl_qsfx_zjlrqs?page=1&num=5&sort=opendate&asc=0&daima=sz002104` → `netamount`净流入、`r0_net`超大单净流入、`turnover`换手、`ratioamount`净占比。

### 8. secid 规则（东财接口用）
`0.` + 深市代码（如 `0.002491`）、`1.` + 沪市代码（如 `1.600183`）。

### 9. 分时数据（腾讯，当日 + 近5日）— 量能/竞价分析的命脉
```python
GET https://web.ifzq.gtimg.cn/appstock/app/minute/query?code=sh000001   # 当日逐分钟(242行)
GET https://web.ifzq.gtimg.cn/appstock/app/day/query?code=sh000001      # 近5个交易日逐分钟
# 返回 data.<code>.data = [{"date":"20260909","data":["0930 3943.92 5496012 7661274928.70", ...]}, ...]
# ⚠️ 倒序：最新一天在前，算"环比前一日"必须先 [::-1] 转成正序
```
每行 = `HHMM 价格 累计成交量(手) 累计成交额(元)`，**是累计值不是增量**（要增量就前后相减）。派生指标：
- 首行 `0930` 累计成交额 ≈ **集合竞价成交额**（A股竞价量在 9:30 计入）
- `1000` 累计额 − `0930` 累计额 = **开盘前30分钟成交额**
- 末行 = **全天成交额**；关键时点：0930 / 1000 / 1130 / 1300 / 1400 / 1500
- 一次只给 5 个交易日；更长历史靠日K，或按 `scripts/market_volume_snapshot.py` 每日攒台账

### 10. 指数与板块口径（算"两市成交额""科技占比"必用）
- **两市总成交额 = 上证综指 `sh000001` + 深证综指 `sz399106`**。实测 `sz399001`(深证成指) 与 `sz399106` 的成交量/成交额字段几乎相同、都≈深市全部（不是成分股口径），任取其一加沪市即可。
- 科技类指数（腾讯直接可查，可替代限流的东财板块）：

  | 代码 | 名称 | 9/9成交额参考 |
  |---|---|---|
  | sz399811 | CSSW电子 | 1621亿 |
  | sh000685 | 科创芯片 | 704亿 |
  | sh000998 | 中证TMT | 2883亿 |
  | sh000688 | 科创50 | 592亿 |
  | sz399006 | 创业板指 | 4333亿 |

- 东财行业板块日K（push2his，secid=`90.BK####`）：半导体 BK1036、元件 BK0459、通信设备 BK0448、软件开发 BK0737、计算机设备 BK0735。⚠️ 限流极重，连查 5-8 次后整批失败且重试无效 → 分析主链路优先腾讯。
- 新浪行业板块快照（一次拿全行业涨跌+成交额，GBK）：`https://vip.stock.finance.sina.com.cn/q/view/newSinaHy.php` → `"code,名称,家数,均价,涨跌额,涨跌幅%,总成交量(股),总成交额(元),领涨股代码,..."`
- 东财板块实时接口（clist `fs=m:90+t:2`）**盘前返回 `f3=0, f6="-"`**，只能盘后/盘中取。

### 11. 公告列表 + 公告正文（判断"利好何时被市场知道"的唯一硬源，实测 2026-10-27 可用）
```python
# ① 公告列表（含发布日期 + art_code）
GET https://np-anotice-stock.eastmoney.com/api/security/ann
    ?sr=-1&page_size=30&page_index=1&ann_type=A&client_source=web
    &stock_list=000001&f_node=0&s_node=0
# data.list[] → notice_date / title / art_code

# ② 公告正文（纯文本，直接可读，无需解析 PDF）
GET https://np-cnotice-stock.eastmoney.com/api/content/ann
    ?art_code=AN202610121830361471&client_source=web&page_index=1
# data.notice_content → 全文纯文本
```
**用途**：把「业绩预告的发布日 + 预告区间」和「正式财报实际值」并排，直接判定利好是**落地**还是**突发**。
- 公告标题里出现 **`股票交易异常波动公告`** 的日期 = 该股近期被炒/被砸的时点标记，串起来就是资金节奏。
- `业绩预告` / `业绩快报` 的日期，就是市场对该期业绩**完成定价**的日子；正式财报只是复述。
- 进阶：搜"业绩变动原因说明"段落 → 直接拿到公司自述的景气逻辑（如"覆铜板行业量价齐升"），比自己编产业逻辑可靠。

## 报告结构（用户偏好，按此顺序输出）
用户期望中文报告固定骨架：
1. **标题**：股票名 + 代码 + 分析日期 + 现价/涨跌
2. **新闻面表格**：日期 | 事件 | 信号(🚀催化/⚠️利空/💎业绩/🔄分歧)，含近期关键催化
3. **产业逻辑**：业务卡位、行业景气逻辑，⭐给强度评分，指出基本面 vs 题材
4. **板块共振**：列出同板块 5-6 只同行涨跌/换手对比表——**判断是板块行情还是独立行情**（同行都不动只有它放量=游资独立炒作，风险高）
   - ⚠️ **反向信号更要重视：板块齐涨、唯独它跌 = 个股在派发，不是"板块退潮"** ——
     此时别拿"板块还行"给自己安慰。实测案例：PCB 板块生益科技 +3.94% / 胜宏科技 +1.28% /
     沪电股份 +1.11%，而持仓票 **-2.08% 独跌** ⇒ 结论是个股出货、按纪律止损。
   - 务必配合主力资金看：**净流入连续递减直至单日转负**（实测 +15.98亿 → +6.41亿 → +3.81亿 →
     +1.56亿 → +0.84亿 → **-0.06亿**）是派发的标准曲线，比单看当日涨跌幅可靠得多。
   - 用户给的**成本价要先算出止损位**（成本 × 0.95）并与现价对照，**明确说出"已破/未破"** ——
     用户自定纪律是硬约束，不要用"还有支撑"之类的话术软化它。
5. **个股技术形态**：近期走势复盘（关键高低点日期）、MA5/10/20/60、MACD DIF/DEA/柱、RSI14、量能、均线多头/破位、支撑压力位（含涨停/跌停价）
6. **走势预测**：分基准/乐观/悲观三情景 + 概率
7. **操作建议**：分情景给策略；若用户给了成本价，**先算浮盈/浮亏**，按强弱给止损止盈铁律；高位妖股原则=反弹离场不补仓、破位止损
8. **一句话结论**
9. **风险提示**：非投资建议 + 高换手游资风险
10. **MEDIA:** 附图（K线图路径）

## 技术指标计算（Python 内置即可，见 references/indicators.md）
MA/RSI/MACD 用纯 Python 列表实现；画图用 matplotlib（lazy-packages 有：`sys.path.insert(0,'$PY_EXTRA_PACKAGES')`）。成图存 `$AST_DATA_DIR/images/<name>_kline.png` 后 `MEDIA:` 发给用户。

## Pitfalls
- **⚠️ 「位置低」不等于「该买」—— 下结论前必须跑一次历史条件回测**：本会话看到「创业板/中证1000/沪深300 全在 250 日最低点、PE 13」就给了「可以分批买 30%」的偏乐观建议；随后按**回撤深度分层回测**发现该档位（−15~−25%）历史上 1 年胜率只有 **31%、中位收益 −8.9%**，真正的高胜率区（94%）要跌到 −35% 以下。**"跌了这么多"是直觉，不是依据。** 凡是回答「能不能买/什么位置买」，先给出**同档位历史胜率**再谈仓位，否则就是拿感觉当分析。同理：「一年新低」也要和「10 年分位」一起报（实测 510300 一年新低 = 11.7 年的 63.7% 分位）。
- **腾讯行情 GBK 编码**：`qt.gtimg.cn` 返回 GBK，必须 decode('gbk')，否则中文乱码/报错。
- **东财搜索是 jsonp**：返回 `cb({...})`，json.loads 前必须剥壳。
- **东财财务金额单位是元**：记得 ÷1e8 才是亿，报告里标"亿"。
- **push2his 资金流限流严重**：连续多股查询必 429 或 Remote end closed，每股之间 sleep 3-5s，失败换新浪。
- **东财数据中心 filter 引号**：日期值用 `'2026-09-02'` 单引号，代码用双引号 `"002104"`。
- **判断连板数**：靠新闻（"XX 9天5板"），不是简单数 K 线红盘。
- **⚠️ 容器时钟可能偏差数天，连 `date` 都不可信**：实测容器 `date` 显示 `2026-09-14 09:16`，
  而行情时间戳是 `20260915131141`（**9/15 13:11**）—— 差了一整天，还落在完全不同的交易时段。
  **开工第一步永远是：拉一次行情 → 读 `[30]` 时间戳 → 据此确定"今天几号 + 现在是否盘中"**，
  再决定报告口径。`datetime.now()`、`date` 命令、会话开头标注的日期都**不能**作为判断依据。
  - 踩坑代价：误判成「盘前」，于是按"预测今日走势"组织报告，实际已在盘中，
    而且用户问的票**当天已跌破他自己定的止损位** —— 结论方向完全错，用户要的是"现在怎么办"。
  - 同理，K 线最后一根的日期（若已含今日）也能佐证"今天是不是交易日、是否在盘中"。
- **系统容器时钟可能非北京时间**：分析"今日/昨日"边界时以行情时间戳（`[30]`）或 K 线最后日期为准，不要用 `datetime.now()` 裸判断。
  - **容器时区实测为 UTC（`date +%Z %z` → `UTC +0000`），北京时间 = UTC + 8h**。这一条本会话连续踩两次：
    容器 `date` 报 `2026-10-08 10:24 UTC`，实际已是北京 **18:24（当日盘后）**，差点按"盘中"作答。
  - **NAS 文件 mtime 是北京时间，容器是 UTC，两者天然差 8 小时** —— 别拿"NAS 文件时间是 18:23"
    去反推容器时间，会得出"现在 18:23"而容器说 10:24 的矛盾。**以行情时间戳为唯一锚点。**
  - 判断顺序：① 拉行情读 `[30]`（北京时间）→ ② 若时间戳停在上一交易日收盘（如 16:14），
    说明**当前非交易时段**（盘前/盘后/假期）→ ③ 用 `minute/query` 的 `date` 字段确认最新交易日 → ④ 再决定口径。
- **高位妖股特征**：连续涨停+换手 20%+→ 见顶信号（冲高长上影/天量/主力净流出/龙虎榜净卖/北向卖出）→ 次日常跌停/低开；操作建议倾向"反弹离场、破位止损、不补仓"。
- **⚠️ 财报大超预期 ≠ 利好。先查预告日期，再谈利好利空**：2026-10-27 示例股A三季报 Q3 单季净利
  同比 **+276.24%**，看着像爆炸性利好；但 **10-13 就发过业绩预告（+90.78%~+102.00%），实际 +97.52%
  正落在区间中部 = 零超预期**，而且 10-13/10-14 已经两个涨停把这件事定价完了。当天盘面 **−4.81%**，
  之后是"利好出尽"。**教训：财报数字本身没有信息量，「数字 − 已预告的区间」才是信息量。**
- **⚠️ 缩量下跌有三种，别一律当洗盘**：① 缩量**横盘**、重心不破 = 洗盘；② 缩量**阴跌**、
  连跌数日跌破全部均线 + 主力连续净流出 = **派发尾声的失血**（主力已经卖完，不需要再供量，
  价格靠"没人接"自然滑落）；③ 缩量涨停封死 = 锁仓。判别只看两条硬证据：**资金流方向**和
  **筹码获利盘**（失血时获利盘已剩个位数 %）。详见 `references/chip-distribution-model.md` 的
  「洗盘 / 派发 / 失血 三态判定表」。
- **⚠️ 「净流出累计 > 前次拉高净流入」= 派发确认，比任何指标都硬**：超声实测 10-20 净流入 **+8.00 亿**
  把股价顶到二次顶（未破前高 = 双顶形态），之后 5 日净流出 **−9.30 亿**（超大单 −6.38 亿）——
  不但把那次拉高的钱全反手卖掉，还多卖了 1.3 亿。**这种"流入一次、流出更多"的结构出现，
  就不必再找别的理由了。**
- **⚠️ 破线后别再谈"还有支撑"**：用户成本 × 0.95 = 纪律线，**首次收盘跌破就要报"已破线 N 个交易日"**，
  并把超出的百分点算出来（超声 22.97 破线，10-22 首破，回答时已破 4 日、超出 24.7pp）。
  用户会讨价还价，正确做法是**先点破"止损已经迟了几天"，再给分批+死线**，而不是软化。

## Pitfalls（续）
- **腾讯 K 线字段顺序是 `[date, open, close, high, low, volume]`，不是 OHLC**！把 `[3]` 当最高价会全盘算错（本会话踩过）。索引：0=日期 1=开 2=收 3=最高 4=最低 5=成交量(手)。
- **腾讯 `day/query` 近5日分时是倒序**（最新在前），算环比必须先反转，否则"昨日"取到的是更早那天。
- **东财 push2his（K线/资金流/板块）限流阈值极低**：连查几次后整批 RemoteDisconnected，重试+sleep 也无效，需等较久。分析主链路走腾讯，东财只做补充。
- **画图中文乱码**：系统已装文泉驿正黑，不设则中文全是方框。**但 matplotlib 版本差异要兼容**：
  3.11+ 已移除 `matplotlib.font_manager.addfont`（会报 `AttributeError: module 'matplotlib.font_manager' has no attribute 'addfont'`），
  改用 `font_manager.fontManager.addfont(path)`。稳妥写法：
  ```python
  from matplotlib import font_manager as _fm
  p = '/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc'
  try:    _fm.fontManager.addfont(p)      # 新版
  except AttributeError: _fm.addfont(p)  # 旧版
  plt.rcParams['font.sans-serif'] = [_fm.FontProperties(fname=p).get_name()]
  plt.rcParams['axes.unicode_minus'] = False
  ```
  另注：`execute_code` 沙箱**没有 matplotlib**，画图必须走 `terminal()` 并以
  `sys.path.insert(0,'$PY_EXTRA_PACKAGES')` 载入（该目录下有 matplotlib 3.11 / numpy 2.4）。
- **新浪 `MoneyFlow.ssl_qsfx_zjlrqs` 返回的是标准 JSON，不是 JSONP**！直接 `json.loads()` 即可。不要用\"给裸 key 补引号\"的正则去修它，会把数组/嵌套类型弄坏报 `Expecting ':' delimiter`（本会话踩过）。
- **新浪 `newSinaHy.php` 是 GBK**，且返回 `var S_... = {...}` 前缀，需剥壳后 json.loads。
- **算历史换手率序列时分母别用总股本**：用 `流通市值÷现价` 得流通股本。只有全流通股两者才等价；口径错了整条换手曲线都会偏，妖股尤其明显。
- **东财 datacenter-web 返回 400 Bad Request 的根因通常是 filter 写法，不是服务挂了**（本会话最初两只票全 400）：① 去掉日期 filter，改用 `&sortColumns=TRADE_DATE&sortTypes=-1` 查最近 N 条；② filter 值 `urllib.parse.quote` 后再拼 URL；③ 带上 `&source=WEB&client=WEB`。按此改写后连查龙虎榜/席位/股东户数/大宗交易 6 个报表全通。仍失败再转"东财新闻搜 `XX 龙虎榜`"兜底。

## 支持文件
- `references/data-sources.md` — 完整接口 URL/字段/示例 + 板块题材速查
- `references/indicators.md` — MA/RSI/MACD 纯 Python 实现片段 + matplotlib K线图画法要点
- `references/market-volume-analysis.md` — 大盘/板块量能分析框架：三层量能、竞价与开盘30min判定阈值、量价四象限、日内节奏、科技占比口径 + 2026-09-09 实盘案例
- `references/turnover-rate-analysis.md` — 换手率框架：本质定义/三层含义、计算口径、流通盘标尺、换手率×主力资金×价格六象限、洗盘vs出货、顶部换手衰减、三陷阱 + 国芳集团累计换手80.6%实证
- `scripts/market_volume_snapshot.py` — 一键拉近5日两市+科技指数的竞价额/开盘30min额/全天额/环比，直接打印判定表
- `scripts/auction_t.py` — **竞价后做T方案取数**（读 positions.json，输出竞价开盘价/竞价量/量比/当日VWAP/MA5-10-20/近10日振幅/**净收益是否 ≥30 元的门槛判定**）；可直接挂 cron `09:26` 一次性触发
- `references/main-force-capital-verification.md` — **主力资金五维交叉验证**：软件资金流的推算本质与造假手法、证据金字塔、龙虎榜买入席位明细接口 + 席位性质词典、股东户数/大宗交易接口、换手率×资金×价格六象限、假资金流5特征 + 景旺电子(真机构建仓) vs 国芳集团(游资派发) 同日对照实证
- `references/chip-distribution-model.md` — **筹码分布自建模型**（cyq 接口失效后的替代）：价格网格+换手率衰减算法、流通股本反推与交叉验证、获利盘/均价/90%区间/集中度/成本分层五指标、**五维框架串联判据表**（筹码→进出货→庄家强弱→板块→大盘）+ 景旺电子 2026-09-18 实证
- `references/t-plus-zero-and-order-placement.md` — **做 T 与挂单时机**：集合竞价时间表（9:15-9:20 可撤 / 9:20-9:25 不可撤 / 盘前挂=9:15 报送）、限价单价格优先不吃暗亏、做 T 三前提与降成本数学、分档挂单 + 四条铁律、卖点窗口判定（前30min占比识别「早盘冲高」）+ 示例股G 2026-10-09 实证
- `references/stock-volume-and-orderbook.md` — **个股放量/缩量判定 + 盘口订单分析**：量÷5日/10日/20日均量阈值表、换手率市值分档、盘中时间折算与量比、放量≠好（位置×方向四象限）、委比/内外盘/大单/逐笔、四种盘口陷阱、**东财手机APP量比位置（数据行左右滑动）** + 示例股G量能标尺实证
- `references/index-etf-risk-return.md` — **宽基 ETF/指数的风险收益时间比评估**：四步流程（定位/估值/趋势/**历史条件回测**）、年化-波动-夏普-卡玛-最大回撤-回本时间算法、**⭐回撤深度分层回测**（15-25% 档 1 年胜率仅 31%，35-50% 档 94%）、趋势信号回测（周 MA20/MA30 有效、MA52 金叉无效）、持有期 vs 胜率、**"新低≠便宜"双尺度口径**、腾讯周线 600 根拉 11 年历史 + 东财 push2his 限流替代、标的分层口径（510300 核心 / 515080 防御 / 159915 进攻 / 588000 回避）+ 510300 全量实测数据
- `references/cyclical-etf-screening.md` — **周期性 ETF 筛选 + 商品联动 + 盘中执行**：三维判据（均线/商品/广度）、22 只周期 ETF 池 + `nf_XX0`/`hf_XX` 商品代码表、**成分归因法**（能源ETF 跌而煤炭ETF 涨 ⇒ 跌的是石油不是逻辑）、三批建仓与跳空调整表、宽基 vs 单行业 ETF 止损口径区别、新闻面五层框架 + 概率化情景、**9:15-9:25 虚拟竞价价 ≠ 9:25 最终开盘价**（实测 1.732→1.755）、ETF 前复权字段取错的坑
- `references/breakeven-time-calculation.md` — **持仓回本时间测算**：`回本需涨=成本/现价−1`（非线性）、250 起点「首次达标耗时」分布算法与代码、**达成率 vs 中位数（幸存者偏差）**、波动能力辅助判据（涨停次数/5日最大涨幅）、时间-机会-心理三层成本话术、分批+死线而非一刀切 + 2026-10-19 示例股E/瑞康/示例股C三只实测（94% / 40% / 31%）
- `references/longqin-main-pool.md` — **龙擎 Alpha Terminal（longqin.hanxai.cn）主力池接入**：登录端点（只有 `/api/auth/login` 有效）、131 端点清单、`/api/v7/main-pool` 字段语义（`control` 控盘度 / `strength` 强度 / `weighted_score` 加权分 / `high_prob`）、`/v1/market/snapshot` 的 **breadth 涨跌比判据**（<1:2 弱势 / <1:3 只减不加）、筛选模板、Pitfalls（`code` 带 `.SH` 后缀需转换、`strength` 高+`control` 低=危险、池内 industry ≠ 涨停池 hybk）、**2026-10-27 四维共振筛池实测**（涨幅最高的海洋王共振分反而 −1）
- `references/earnings-announcement-verification.md` — **财报落地核验（"这份业绩市场什么时候知道的"）**：公告列表 + 公告正文两个接口、**利好三档定性表（按实际值落在预告区间的 pos 分位）**、预告日→异动公告日→财报日的资金节奏串法、单季/累计算法坑、同板块同日发季报的横向摊薄效应 + 示例股A 2026-10-27 实证（+276% 却是利好落地，pos=0.60）

- `references/cyclical-etf-pool.md` — 宽基/周期性 ETF 池速查 + 商品期货代码 + 实测快照
- `references/financials-api-fallback.md` — 财务数据接口可用性：东财 F10 失效后的 datacenter 替代路径
- `references/intraday-main-force-signals.md` — 盘中判断主力是否还在的信号框架（内外盘/大单/资金验证）
- `scripts/a_share_pipeline.py` — 行情/K线/新闻/财务的一体化取数脚本（v2.0 遗留，保留供追溯）
- `scripts/indicators.py` — MA/RSI/MACD 纯函数实现
- `scripts/test_indicators.py` — 指标纯函数冒烟测试，不联网：`python3 scripts/test_indicators.py`

