# daily-stock-analysis

Adopt this skill: https://proskills.md/skills/other/luqtest-big-a-chovy-daily-stock-analysis

Page: https://proskills.md/skills/other/luqtest-big-a-chovy-daily-stock-analysis
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: daily-stock-analysis/SKILL.md
size: 5458
upstream: https://github.com/luqtest/big-a-chovy/blob/main/daily-stock-analysis/SKILL.md

````text
---
name: daily-stock-analysis
description: 获取并校验 A 股实时行情，运行超短、趋势、低吸和观察池筛选，生成候选报告与原始量化字段。只负责发现层，不承担最终买卖、仓位或持仓裁决。
---

# Daily Stock Analysis · 筛选与报告发现层

## 职责边界

本工具是筛选工具之一，只负责行情获取、指标计算、候选筛选、报告生成和筛选状态保存；**不负责最终买入、卖出、仓位、持仓或真实仓权限裁决**。

权威层级固定为：

1. `盘中` skill：用户实际使用的决策入口和沟通流程；
2. 根目录 `选股框架.md`：交易规则、参数、否决条件和待验证状态的唯一权威；
3. `决策记录/YYYYMMDD.md`：实际执行、持仓和 T+1 状态的唯一记录；
4. 本目录：筛选和数据发现层，输出只作为 `盘中` 的输入。

如果用户提出买卖、持仓、仓位或复盘问题，本工具只提供带时间戳的筛选证据，并由 `盘中` skill 按《选股框架.md》完成裁决。若请求包含“继续看筛选”“今日信号”“能否买”或其他决策意图，生成报告后不得停在发现层，必须继续交给 `盘中` 做双仓分层裁决；本工具的发现层边界不等于整次请求只能输出筛选结果。

## 支持的筛选模式

1. **低吸超短线**：寻找仍在可交易买区、接近 VWAP/支撑且未明显追高的候选；
2. **低吸短线趋势**：筛选均线结构和趋势条件，输出趋势候选；
3. **严格超短线**：输出原始短线动能筛选结果；
4. **严格趋势**：输出原始趋势筛选结果；
5. **明日观察池**：输出触发价、支撑区、失效位和追高提示，作为观察数据，不代表可买；
6. **双池交集/状态机**：保存筛选状态和候选变化，状态本身不等于交易许可。

各模式必须独立运行，不能把不同模式的阈值或结果混合。详细筛选条件见 `references/screeners.md`。

## 运行入口

在项目根目录执行：

```bash
python3 daily-stock-analysis/scripts/a_share_daily_screen.py --mode all --format md
python3 daily-stock-analysis/scripts/a_share_daily_screen.py --mode low watchlist --format md
python3 daily-stock-analysis/scripts/a_share_daily_screen.py --mode strict low --format json --save /tmp/a_share_screen.json
python3 daily-stock-analysis/scripts/a_share_daily_screen.py --mode all --skip-announcements
```

普通筛选工具负责生成报告；实时看板负责展示数据。它们都不会自动下单，也不会替代 `盘中` skill 的最终裁决。

## 数据证据与离线研究

候选需要补证据时按需调用共享适配器，不能在每轮全市场筛选中逐只重型抓取：

```bash
python3 tools/query_ticks.py 600519 --json
python3 tools/query_financials.py 600519 --json
python3 tools/query_events.py 600519 --date 2026-10-03 --json
python3 tools/query_context.py 600519 --topic news --date 2026-10-03 --json
```

分笔是腾讯约 3 秒聚合的 B/S/M 证据，不是 Level-2 原始委托；卖额为零、窗口覆盖不足、分页不完整或源失败都保持 `null`/明确失败状态。财务必须把已披露利润表与动态/TTM PE 分开，不能用正 PE 代替盈利证据。事件、情绪和上下文只作展示与核验，不自动加分、否决或放行真实仓。

离线研究使用 `tools/query_history.py` 的通达信盘后 ZIP 和 `tools/query_chips.py --history-json/--history-csv` 的跨日估算。历史结果必须注明数据日、股/元单位、输入窗口、换手率与复权口径；所有跨日结果都标为“筹码估算”，不能称主力真实成本，也不进入生产筛选门槛。缺换手率、混合复权或 ZIP 结构异常时拒绝/返回不可用。

## 数据质量要求

- 每次输出必须标注数据时间、交易状态和数据源；
- 行情、K 线、公告、均价线或资金字段缺失时，明确标记“无法验证/数据不足”，不得自行补值；
- 使用统一单位：成交额和资金流向必须注明元、万元或亿元；
- 报告解析按表头动态定位，不能硬编码列号；
- 空结果先检查报告完整性、字段列位和网络状态，不能直接解释为“没有候选”；
- `A/B/C`、`strict/hopeful`、`buy zone` 等都是筛选层标签，不是买卖权限；
- `avoid`、`unknown`、`watch_risk` 只作为筛选结果中的风险字段呈现，最终含义由 `盘中` 和《选股框架.md》裁决。

## 输出约定

报告可以输出以下原始字段：代码、名称、价格、涨跌幅、成交额、换手率、量比、行业、均线、VWAP、日内高位回落、主力净额、超大单、大单、5 分钟增量、公告风险、板块共振和状态机状态。

输出“低吸候选”“观察”“追高风险”时，只描述筛选结果和卡点；不输出最终买入、卖出、真实仓开仓、仓位比例或 T+1 执行指令。

影子验证数据由 `tools/shadow_tracker.py` 统一维护。本工具不修改影子结算结果，也不把未完成样本转成交易结论。

## 明确禁止

- 不把筛选入榜直接写成“可以买”；
- 不绕过《选股框架.md》的超大单、公告、VWAP、板块和待验证权限门槛；
- 不读取或推断当前持仓来替代 `决策记录`；
- 不因用户希望交易而放宽筛选条件；
- 不在本工具内新建另一套交易规则。
````

## File: README.md
upstream: https://github.com/luqtest/big-a-chovy/blob/main/README.md

````text
> **数据源说明**：本版已按 2026-09 的实测结果适配取数路径（东财 `/webguest` 路由 + 腾讯日 K 多主机故障转移），行情、资金流与公告均可正常获取。第三方公开接口可能随时调整，若出现取数失败，先运行 `python3 tools/verify_em_webguest.py` 查看各入口状态，再参考 [`docs/东财请求频率与限流.md`](docs/东财请求频率与限流.md)。

# A 股量化筛选工作台

[![Latest release](https://img.shields.io/github/v/release/LuQTest/Big-A-chovy?label=latest%20release&style=flat-square)](https://github.com/LuQTest/Big-A-chovy/releases)
[![GitHub stars](https://img.shields.io/github/stars/LuQTest/Big-A-chovy?style=flat-square&label=stars)](https://github.com/LuQTest/Big-A-chovy/stargazers)
[![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square)](LICENSE)

这是一个面向 A 股盘中筛选、低吸候选、明日观察池和复盘分析的本地工具集。

它负责查询行情、计算筛选条件、生成报告和维护观察状态；**不会自动下单**。筛选结果只是发现候选，买卖、仓位和止损仍应按照项目规则人工确认。

### 功能概览

- 实时看板：自动刷新行情、资金、公告和筛选状态，并集中显示数据时点、来源、降级告警、任务占用和自动刷新状态。
- 筛选工作台：按本次任务选择筛选模式、交易板、公告检查和资金排名，运行一次筛选并查看结果。
- 报告库：同时读取根目录平铺报告与 `筛选结果/YYYYMMDD/` 归档，按报告文件名中的交易日和时间合并、排序，支持按日期/时间检索和继续查看筛选。
- 证据查询：提供行情/分时/五档、财务、交易日历、公告与事件、板块和上下文等查询工具，明确区分 `ok`、`empty`、`partial`、`stale` 和 `unavailable`。
- T+1 核验：只在官方交易日、目标日期和共享目标时刻都可验证时生成早盘证据；历史分钟目标不保证可追溯，不能用当前数据替代历史目标。

职责边界：`daily-stock-analysis` 仅是筛选与报告发现工具，不承担最终买卖、仓位或持仓裁决。最终决策入口是 `盘中` skill，交易规则以根目录 `选股框架.md` 为准，实际持仓以 `决策记录/` 为准。

## 版本标识

- 当前正式版：[v0.7.2](https://github.com/LuQTest/Big-A-chovy/releases/tag/v0.7.2)，源码发布、容器镜像和文档对应同一最终提交。
- Docker 镜像：`ghcr.io/luqtest/big-a-chovy:v0.7.2`，由 GitHub Actions 发布到 GitHub Container Registry；支持的架构以该次构建的清单为准。
- `v0.7.1` 正式版及其镜像继续保留作为回退；更早的预览 Release 页面已清理，Git tag 历史不被补丁版发布移动或覆盖。

完整更新记录见 [`CHANGELOG.md`](CHANGELOG.md)。

### 软件内更新提示

工作台和实时看板顶部会显示本机版本，发现同渠道新版本时给出提示、更新内容和升级命令。**不自动下载、不自动替换、不重启**，也不会在交易时段弹窗打断操作。

- **版本单一来源**：仓库根 `VERSION` 只保存共同的基础版本（如 `0.7.2`），渠道由发布 tag 提供——`v0.7.2` 是正式版、`v0.7.2-preview.2` 是预览版、`v0.7.2-docker.2` 是容器版。
- **只比同一渠道**：正式版只与正式版比，预览版只与预览版比，容器版只与容器版比。不同渠道的版本不互相比大小——`0.6.0-docker.2` 与 `0.6.0-preview.2` 是同一源码提交的两种打包形态。
- **升级命令按实际安装方式给出**：源码安装是 `git pull`；引用 GHCR 镜像的 Compose 是 `docker compose pull && docker compose up -d`；本仓库自带的 `docker-compose.yml` 用的是本地 `build`，因此提示 `git pull && docker compose up -d --build`。
- **离线、限流或上游异常时完全静默**：只是没有提示，软件照常使用。

版本对账（发布流水线会跑同一套校验）：

```bash
python3 tools/validate_version.py                 # VERSION 与 CHANGELOG 顶部条目
python3 tools/validate_version.py --tag v0.7.2    # 额外校验发布 tag 的基础版本与渠道
```

设计与边界见 [`docs/更新检查.md`](docs/更新检查.md)。

## GitHub Star History

仓库的 Star 数量和趋势图会随 GitHub 数据自动更新。点击徽章可查看当前 Star 列表，点击趋势图可查看详细历史：

<a href="https://www.star-history.com/?repos=LuQTest%2FBig-A-chovy&type=date&legend=top-left">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=LuQTest/Big-A-chovy&type=date&theme=dark&legend=top-left" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=LuQTest/Big-A-chovy&type=date&legend=top-left" />
   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=LuQTest/Big-A-chovy&type=date&legend=top-left" />
 </picture>
</a>

## 一、快速开始

### 环境要求

- macOS（双击 `.command` 启动器需要 macOS）。
- Python 3.10 或更高版本，建议使用 Python 3.13。
- 能访问行情接口的网络环境。默认 `auto` 模式会实测直连、本机候选代理端口、环境代理和系统代理后择优；如直连受限，请在 `daily-stock-analysis/scripts/proxy_ports.json` 中配置可用的本机 HTTP 代理端口。代理软件不限定为 Clash。

> Tkinter GUI、`.command` 启动器和部分 macOS 代理/进程管理逻辑仍按 macOS 编写；Windows 用户请使用上方 Web 工作台。命令行核心脚本可直接尝试，但不代表完整桌面 GUI 已适配。

脚本依赖尽量使用 Python 标准库，并对可选依赖提供了降级处理：

```bash
python3 -m pip install -r requirements.txt
```

`requests` 用于更稳定地访问行情接口；`pyyaml` 用于读取决策记录中的持仓快照。没有这些库时，部分功能仍可使用，但网络或 YAML 解析能力可能降级。

从源码安装或升级到正式版：

```bash
git fetch origin --tags
git checkout v0.7.2
python3 -m pip install -r requirements.txt
```

后续升级时先阅读 `CHANGELOG.md`，再切换到新的正式 tag；源码运行和 Docker 运行使用同一 tag 的代码，二者的功能与规则口径保持一致。

### Web 工作台（B/S 架构，推荐 Windows 用户使用）

不想受限于 macOS GUI？启动 Web 工作台，在浏览器里使用筛选、报告库和工具箱：

```bash
# Windows：双击根目录 启动工作台.bat，或：
uv run --python 3.13 --with requests --with pyyaml --with tzdata python daily-stock-analysis/scripts/web_workbench.py

# macOS / Linux
python3 daily-stock-analysis/scripts/web_workbench.py
```

- 工作台：<http://localhost:8765/workbench>（一次性筛选 + 报告库 + 工具箱）
- 实时看板：<http://localhost:8765/>（原版页面不变）

两个页面共用同一套导航与运行状态：顶部同一组视图切换「实时看板｜筛选工作台」（同页切换、标出当前位置），下方同一条运行状态条显示**数据时点 / 数据源 / 自动刷新 / 引擎占用**，并把会影响判读的异常做成旗标（降级数据、最近快照、行情不完整、东财冷却、代理断开、**公告检查或资金排名被关闭**）。看板顶部原来分散的「数据时间 / 数据源 / 下次刷新 / 行情不完整 / K 线缓存」五处展示已收敛进这条状态条，同一事实不再重复出现。

运行选项两页同名同极性：勾选=执行（`公告检查`、`资金排名`），作用域分别标注——工作台是**本次任务参数**（只影响这一次手动筛选），看板顶部是**看板默认**（持久设置，对每一轮自动刷新生效）；工作台会显示看板当前的这两个开关状态，避免改错地方。动作被占用时不静默，会在页面内提示原因（例如「看板自动刷新正在运行」）。

看板默认配置保存成功后会显示保存时间；配置冲突或保存失败会在页面内提示。已保存的配置从下一轮自动刷新开始生效，不会改变已经运行中的那一轮；工作台本次任务参数仍只作用于当前手动筛选。

Web 工作台默认只监听本机，避免报告、持仓和决策快照被局域网读取。确实需要手机或其他电脑访问时，显式运行：

```bash
python3 daily-stock-analysis/scripts/web_workbench.py --host 0.0.0.0
```

这会开放包含个人数据的接口，只应在可信局域网使用，禁止直接暴露到公网。

详细说明见 [`docs/web-workbench.md`](docs/web-workbench.md)。

### Docker 部署（公开仓库）

仓库提供一个不依赖 macOS GUI 的 Web 工作台与实时看板容器。源码、Docker 配置和 GitHub Actions 可以公开发布；报告、决策记录、持仓、影子样本和运行缓存仍保留在本机挂载目录，不会写入镜像。

```bash
cp .env.example .env       # 不需要代理时也可以跳过
docker compose up -d --build
```

浏览器打开 <http://localhost:8765/workbench> 使用工作台，打开 <http://localhost:8765/> 查看实时看板；查看状态或日志：

```bash
docker compose ps
docker compose logs -f dashboard
docker compose down
```

容器默认尝试直连行情接口。如果宿主机需要代理，在 `.env` 中填写容器可访问的地址，例如 Docker Desktop 下：

```dotenv
HTTP_PROXY=http://host.docker.internal:7890
HTTPS_PROXY=http://host.docker.internal:7890
```

Docker 运行版同时启动 Web 工作台和实时看板，不启动 Finder、macOS `.command` 启动器或桌面 GUI；宿主机端口默认只绑定 `127.0.0.1`，需要局域网访问时应明确修改 compose 端口映射并确认网络可信。它同样不会自动下单。正式 tag 与 Docker 镜像来自同一最终源码提交；GitHub Actions 负责构建并发布已验证架构的镜像到 GitHub Container Registry。

```bash
docker pull ghcr.io/luqtest/big-a-chovy:v0.7.2
```

`docker compose up -d --build` 会从当前源码 checkout 本地构建；如果需要直接使用已发布镜像，请使用上面的正式 tag，并自行确认宿主机挂载的报告、决策记录、持仓、影子样本和运行状态目录权限。源码版与镜像版都只提供筛选、证据和查询能力，不执行交易。

### 1. 启动普通筛选 GUI

在 Finder 中双击：

```text
daily-stock-analysis/scripts/运行A股筛选.command
```

GUI 可以选择筛选模块、公告检查、资金排名、输出格式，并维护本地持仓列表。筛选完成后会生成 Markdown 或 JSON 报告。

如果双击没有反应，也可以在终端运行：

```bash
python3 daily-stock-analysis/scripts/a_share_screen_gui.py
```

### 2. 直接运行命令行筛选

在项目根目录执行：

```bash
# 默认：严格双池筛选
python3 daily-stock-analysis/scripts/a_share_daily_screen.py --mode strict --format md

# 一次输出严格双池、低吸池、明日观察池
python3 daily-stock-analysis/scripts/a_share_daily_screen.py --mode all --format md

# 保存为 JSON，便于其他程序读取
python3 daily-stock-analysis/scripts/a_share_daily_screen.py \
  --mode strict low watchlist \
  --format json \
  --top 15 \
  --save /tmp/a_share_screen.json
```

常用参数：

| 参数 | 作用 |
| --- | --- |
| `--mode strict` | 严格超短/趋势双池 |
| `--mode low` | 低吸 A/B/C 候选池 |
| `--mode watchlist` | 明日观察池和触发价 |
| `--mode all` | 同时运行以上三类 |
| `--format md/json` | 输出 Markdown 或 JSON |
| `--top 15` | 每个模块最多输出多少条 |
| `--save 文件路径` | 同时保存到指定文件 |
| `--network-mode auto` | 并发实测直连、候选代理、环境/系统代理，按实际可用延迟择优 |
| `--network-mode proxy` | 仅使用环境变量或 macOS 系统代理；本机候选端口请使用 `auto` 模式，由 `daily-stock-analysis/scripts/proxy_ports.json` 管理 |
| `--network-mode direct` | 强制直连 |
| `--skip-announcements` | 跳过公告风险检查，不建议日常使用 |
| `--skip-capital-ranking` | 跳过资金排名辅助模块 |
| `--boards main chinext star` | 交易板范围，默认 `main`（仅沪深主板）。可任意非空组合；勾选后该交易板股票**统一参与完整筛选**（同一门槛、同一排名、同一条状态机），未勾选的交易板不进入新增候选（见下） |

### 交易板范围（默认只筛沪深主板）

`--boards` 与看板配置里的 `enabled_boards` 决定**哪些交易板进入本轮筛选**；它与按行业计算的「板块共振」是两个概念，故不叫“板块”。

- **所选交易板统一参与完整筛选**：资金增量与状态 → 超短池／趋势池 → 双池交集 → 资金优选／低吸／明日观察池 → 现有状态机，**同一套门槛与排名**（三板都读 `tools/rule_config.py`，暂不单独放大创业板/科创板阈值）。因此超出当前涨幅或价格区间的两板股票被排除，属正常筛选结果。
- 默认只选**沪深主板**，输出与历史基线一致；勾选创业板（`300/301`）或科创板（`688/689`）后，两板股票直接出现在正常栏目中，**每行带「交易板」字段**。
- **未勾选的交易板不进入新增候选**；切换范围后旧范围留下的锁存／等待回踩／突破状态不继续生效，**已持仓股票的监控不受影响**。
- 行业共振的强势股计数按所选交易板统计，行业上涨比例与平均涨幅仍用全市场背景；「主板涨停／跌停」统计仍只指沪深主板。
- 公告、超大单为负、主导资格、数据完整性等门禁对三板**一视同仁**；数据降级或快照不完整时，报告会区分「未符合条件」与「数据不可用」。
- 北交所与其它代码不在选项内（归 `unknown`，一律排除）；ST/退市与字段不全的股票照旧排除。
- 范围在**每轮开始时冻结**：运行中改配置只影响下一轮；报告头部与结果（`meta.enabled_boards`／`board_scope_note`）记录本轮实际范围、各板计数与范围结论——数据完整且无候选是「未符合条件」，降级/快照不完整是「本轮结果不完整」，两者不会混为一谈。

> 历史快照说明：2026-09-30 之前的快照
````
