daily-stock-analysis

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

A 股量化筛选工作台

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

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

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

版本标识

• 当前开发预览版：v0.6.0-preview.2，修正公告总量冲突、行情涨跌停价与财务字段映射，并加固影子样本事务、结算校验和工作台生命周期；仍为预览版。
• Docker 发布版：v0.6.0-docker.2，基于同一源码提供 linux/amd64 和 linux/arm64 容器镜像。
• GitHub 保留上一轮回退版 v0.6.0-preview.1 / v0.6.0-docker.1 和稳定 Latest v0.5.0-docker.4。更早的 v0.5.0-preview.*、v0.5.0-docker.1–.3、v0.4.0-*、v0.3.5-preview.1 与 v0.3.4 Release/tag 已清理；Git 提交历史和 GHCR 镜像版本不受影响。

完整更新记录见 CHANGELOG.md。

GitHub Star History

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

一、快速开始

环境要求

• 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 标准库，并对可选依赖提供了降级处理：

python3 -m pip install -r requirements.txt

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

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

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

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

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

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

详细说明见 docs/web-workbench.md。

Docker 部署（公开仓库）

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

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

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

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

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

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 端口映射并确认网络可信。它同样不会自动下单。发布标签会由 GitHub Actions 构建并发布多架构镜像到 GitHub Container Registry；如果首次发布后镜像仍是私有的，需要在 GitHub Packages 中将其改为 Public。

docker pull ghcr.io/luqtest/big-a-chovy:v0.6.0-docker.2

1. 启动普通筛选 GUI

在 Finder 中双击：

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

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

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

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

2. 直接运行命令行筛选

在项目根目录执行：

# 默认：严格双池筛选
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

常用参数：

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

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

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

历史快照说明：2026-09-30 之前的快照里，创业板/科创板只进过独立的「扩展交易板观察」列表。这类旧快照仍按原口径展示并标注为历史口径，不要与当前「三板统一筛选」的结果直接比较。

3. 启动实时看板

双击：

daily-stock-analysis/运行实时看板.command

或在终端运行：

python3 daily-stock-analysis/scripts/realtime_dashboard.py

浏览器打开：http://localhost:8765

看板默认在交易时段自动刷新，启动时会预热日 K 缓存；行情不可用时会尽量保留最近一次完整结果。停止看板可以双击：

daily-stock-analysis/停止实时看板.command

也可以在终端按 Ctrl+C 停止。

看板提供以下本机接口：

curl -s http://localhost:8765/api/data    # 最新完整 JSON
curl -s http://localhost:8765/api/status  # 运行状态和缓存状态
curl -s http://localhost:8765/api/md      # 最新 Markdown 报告

二、筛选模块说明

• strict：严格超短池、趋势确认池及其交集。
• low：低吸 A/B/C 分层，重点关注买入区、追高禁区、资金方向和公告风险。
• watchlist：明日观察池，包含触发价、低吸区、失效条件和突破状态。
• 公告风险：clean、watch_risk、avoid、unknown；avoid 不得绕过。
• 交集状态机：跨快照记录“观察、首次交集、等待回踩、回踩确认、可新开仓、失效”等状态。
• 资金快照：保留最近约 30 分钟，用于计算 5 分钟和 15 分钟资金增量。

无论筛选结果多强，市场环境、板块共振、个股结构和实际买点有一项不满足，都应选择等待或空仓。

三、报告和辅助工具

这些工具都应在项目根目录执行：

# 扫描最新交易日报告，输出 5/5、4/5 和明日观察池
python3 tools/scan_reports.py --latest 10

# 扫描指定日期
python3 tools/scan_reports.py --date 20260824

# 扫描单份报告
python3 tools/scan_reports.py --file "筛选结果/20260824/A股筛选结果_20260824_0945.md"

# 跟踪一只股票在全天报告中的状态变化
python3 tools/track_stock.py 601666 --date 20260824

# 查询实时行情、五档、分时和近期日 K
python3 tools/query_quote.py 600188 000768