Rockyzsu/stock / 概览
Rockyzsu/stock：一个个人 A 股量化工作台，不是开箱即用的策略库
先说结论，因为它决定了你该怎么用它。这个仓库的主体是 152 个 Python 脚本加 49 个 Jupyter Notebook，散在 21 个目录里，作者从 2016 年写到现在，做的是把「自己每天在用的采集、选股、监控、推送、交易脚本」堆在同一个仓库。它没有 setup.py、没有 pyproject.toml、没有 CI、没有 Release、也没有 Dockerfile；requirements.txt 只有 17 行、130 字节，且没有任何版本号。
所以它既不能 pip install，也不会替你装好环境。官方 README 是一份模块清单加一段配置说明，而 README 自己写着「目前正在重构项目代码，目录结构可能与下面描述有些出入」（2022-12-08）。这句话是理解整个项目的钥匙：文档与代码已经不对齐了。本站做的事不是翻译 README，而是替你把这件事核到底。
项目来源
Rockyzsu/stock · Star 约 8.7k · Fork 约 1.7k · 747 commits · 无 Release
GitHub 公开仓库页截图，2026-10-09 采集（1600x1100），对应提交 9478dee。可见 8.7k star、1.7k fork、3 Branches、0 Tags、747 Commits、BSD-3-Clause 许可与「No releases published」。数字会随社区活动变化，仅证明采集当天的仓库状态，不证明本机安装或运行成功。
查看源码 ↗Rockyzsu/stock · 问题定位
Rockyzsu/stock 解决什么、不解决什么：四问四答
| 你可能的期待 | 它实际给什么 | 落空的部分 | 更适合的做法 |
|---|---|---|---|
| 找一个能直接跑的量化框架 | 152 个独立脚本 + 49 个 Notebook，逐个文件独立运行 | 没有统一入口、没有统一配置、没有包管理；脚本之间靠相对路径和全局变量耦合 | 要看框架去看 vnpy / qlib / backtrader 这类有发行包的项目 |
| 找一个能验证收益的策略 | 选股脚本、涨停池采集、监控脚本、交割单记录 | 仓库里没有任何回测绩效报告，没有胜率、没有净值曲线 | 把这里的脚本当「信号生成器」，收益验证必须自己做 |
| 学 A 股量化每个环节怎么写代码 | 数据采集、落库、筛选、监控、推送、下单、交割单七个环节都有真实代码 | Rockyzsu/stock 的 README 与代码不一致，照 README 找文件会找不到 | 先读本站的版本核验页，再决定看哪个文件 |
| 免运维地跑起来 | 纯 Python 脚本，理论上 clone 就能改 | 需要自建 MySQL、MongoDB、Redis、Elasticsearch；还有 8 个模块在 import 期就会报错 | 先看环境安装页的最小实验，再决定投入多少 |
一句话定位：把 Rockyzsu/stock 当成「一个人的量化工作台源码」，而不是「一个要安装的软件」。它的主要价值是真实工程细节——数据源怎么登、cookie 怎么存、监控怎么触发、交割单怎么落库；这些在普通「量化项目介绍」里最难找到。
Rockyzsu/stock · 系统地图
Rockyzsu/stock 的七段流水线：代码按什么顺序串起来
| 段 | 做什么 | 对应目录 | 主要文件 | 状态 |
|---|---|---|---|---|
| ① 数据采集 | 从各站点取行情、公告、基金、汇率 | datahub/（28 个 .py） | jisilu.py、ninwen.py、jucao_announcement.py、dfcf_hot_block.py | 部分可跑（依赖登录态） |
| ② 落库 | 把采集结果写进数据库与搜索库 | 各脚本内嵌 | MySQL / MongoDB / Redis / Elasticsearch / SQLite 五种落点 | 需自建服务 |
| ③ 分析与选股 | 按因子筛选、算指标、识别形态 | analysis/（10 .py + 39 .ipynb）、k-line/（4 .py） | select_stock.py、StockAnalyze.py、recognize_form.py | 导入期即报错（1 个） |
| ④ 监控 | 轮询行情或转债，命中阈值就告警 | monitor/（9 个 .py） | jsl_monitor.py、realtime_monitor_ts.py、big_deal.py、ceiling_break.py | 配置键缺失（1 个） |
| ⑤ 推送 | 邮件、企业微信、Server 酱、短信 | 各脚本内嵌 | configure/util.py 的 4 个发送函数、utils/push_msn.py | 需自备账号 |
| ⑥ 交易执行 | 券商客户端下单、PTrade 桥接、富途接口 | trader/、ptrade/、futu/ | auto_trader.py、server_api.py、futu/*.py | 缺凭证 / 目录为空 / 无下单代码 |
| ⑦ 记录与复盘 | 持仓、交割单、每日盈亏、选股跟踪 | utils/（3 个 .py）+ 根目录脚本 | delivery_order.py、recordMyChoice.py、statistices.py | 依赖券商导出文件 |
Rockyzsu/stock 流水线里第 ④ 和 ⑥ 段值得注意：monitor/ 有 9 个脚本却完全没出现在 README 的目录清单里；ptrade/ 在 README 里被写成「ptrade自动交易实盘代码」，而仓库里只有一个 0 字节的 __init__.py。这两处是「文档与代码不对齐」最典型的例子，详见版本核验页。
Rockyzsu/stock · 模块速览
Rockyzsu/stock 的 21 个目录分别放什么
| 目录 | .py 数 | README 有写吗 | 一句话职责 | 上手注意点 |
|---|---|---|---|---|
fund/ | 45 | 有 | LOF/ETF 场内份额、ARK 持仓、天天基金、雪球私募 | 基金数据多为爬虫，站点改版即失效 |
datahub/ | 28 | 有 | 集思录、宁稳、巨潮、东财涨停池、汇率、行业 | 登录态与验证码是主要卡点 |
| 根目录脚本 | 25 | 部分 | 选股、K 线、龙虎榜、质押、股吧新闻 | 裸脚本，靠 toolkit.py 与配置耦合 |
analysis/ | 10（+39 ipynb） | 有 | 次新涨停强度、股票诊断、IPO 速度、封单金额 | 以 Notebook 为主，依赖作者的中间表 |
monitor/ | 9 | 无 | 可转债监控、自选池实时监控、大单、封板 | README 完全未提及此目录 |
common/ | 7 | 有 | Tushare 封装、基类、AES、PDF 转文本 | AES 与 PDF 依赖未列入依赖清单 |
backtest/ | 5 | 无 | backtrader 入门示例与均线回测 | 数据路径硬编码为作者本机目录 |
futu/ | 5 | 有 | 富途 OpenAPI 行情订阅基础用法 | 只有行情，没有下单 |
k-line/ | 4 | 有 | talib 形态识别、K 线绘图 | talib 需要本地 C 库 |
utils/ | 3 | 无 | 交割单入库、盈亏对比、价格提醒 | 交割单表按券商分表 |
configure/ | 2 | 有 | 配置读取与数据库选择器 | 导入期即读 config.json |
hk_stock/ | 2 | 有 | 港股打新数据（aastocks / lianghuaipo） | 需 selenium 与浏览器驱动 |
trader/ | 2 | 有 | easytrader 自动下单 | 缺 config.py 与 user.json |
ptrade/ | 1 | 有 | README 称「实盘代码」 | 实际是 0 字节空文件 |
machine_learning/ | 1 | 有 | 「机器学习预测」 | 整个目录只有 1 个文件 |
market/ | 1 | 无 | 上交所开户数与指数关系 | 写入 MongoDB |
daily/ / juejin/ / data/ / temp/ / source_code_reading/ | 0 | 无 | 复盘 Notebook、掘金取数、临时数据、源码阅读 | 散件，无脚本 |
「README 有写吗」一栏是按 Rockyzsu/stock 仓库的 _readme_diff.py 程序化比对得出的：共 10 个顶层目录 README 从未提及（backtest / configure / daily / data / juejin / market / monitor / source_code_reading / temp / utils）。完整清单与比对方法见版本核验页。
Rockyzsu/stock · 路线选择
Rockyzsu/stock 自建路线，和用现成技能有什么区别
| 对比维度 | 路线 A：自建这套工作台 | 路线 B：用 EasyClaw 技能做同类任务 |
|---|---|---|
| 前置条件 | Python 环境 + MySQL/MongoDB/Redis/Elasticsearch + 各数据源账号 | 安装 EasyClaw 客户端，按任务加载对应技能 |
| 取数 | 自己维护 cookie、token、验证码识别与站点改版 | 技能封装好的行情与基本面接口（如 akshare-finance 覆盖 A 股、基金、债券、外汇） |
| 选股与筛选 | 改 select_stock.py，连自己的库 | 自然语言提问式条件筛选（同花顺问财、东财妙想系技能） |
| 监控与推送 | 自建 cron 与监控脚本，自备推送通道 | 监控类技能可按规则判断并给出结论；推送需按技能能力确认 |
| 交易执行 | easytrader 券商客户端下单（缺凭证） | 本机 29 个技能中没有等价的下单技能，只有富途 OpenAPI 与模拟组合 |
| 可复用性 | 代码在你手里，逻辑透明，可任意改 | 封装度高，改造成本低；但逻辑不可见，深度定制受限 |
| 适合谁 | 要改逻辑、要自己控数据、能接受运维成本 | 想先验证一个想法，不想先搭四套数据库 |
这不是二选一。合理的组合是：先用路线 B 验证「这个想法值不值得做」，确认值得再落到路线 A 的代码里长期跑。完整的能力对照与边界放在导航栏的「对比」页里。
Rockyzsu/stock · 免部署演示
同一批任务，用 EasyClaw 提问是什么体验
下面两张是 EasyClaw 对话截图：左边一张问区间涨跌幅与年化波动率，右边一张问三项技术指标状态——这两件事在 Rockyzsu/stock 里分别对应 datahub/ 的取数脚本与 analysis/ 的指标计算。它们展示的是「不用先搭四套数据库、直接把问题问出来」的路径。两张截图由本站于 2026-10-09 在本机客户端中实际提问后截取，不是 Rockyzsu/stock 的运行结果。
Rockyzsu/stock · 核验快照
动手前先看 Rockyzsu/stock 的十条事实：哪些可按提交核对
| 项目问题 | 事实 | 证据位置 | 对你的影响 |
|---|---|---|---|
| 项目是什么 | 30天掌握量化交易，个人 A 股量化工作台 | 仓库描述与 README.MD 首行 | 定位是个人工作台，不是产品 |
能不能 pip 装 | 不能：无 setup.py / pyproject.toml / Dockerfile | 仓库根目录清单 | 要自己装依赖、自己建库 |
| 依赖清单可靠吗 | requirements.txt 仅 17 行、130 字节、无版本号，且 loguru 重复 3 次 | 仓库 requirements.txt | 实际第三方包约 40 个，缺约 24 个 |
| 有没有版本发布 | 无 Release、无 Tag，只有 master 分支 | GitHub Releases / Tags 均为空 | 无法锁版本，只能锁 commit |
| README 与代码一致吗 | 不一致：36 个点名路径里 12 个不存在、9 个已移动、10 个目录未提及 | 版本核验页的比对表 | 照 README 找文件会找不到 |
| 代码现在能跑吗 | 部分不能：至少 8 个模块在 import 期就会失败 | 报错排查页的分类表 | 先修导入期问题，再谈功能 |
| 许可 | BSD-3-Clause，版权行为「Copyright (c) Stock developers.」 | 仓库 LICENSE（1514 字节） | 可改写与再分发，需保留许可声明 |
| 中文文档 | 没有：README 为中文但只覆盖模块清单与配置示例 | 仓库内文档清单 | 无中文 API 文档、无 wiki 教程 |
| 末次更新 | 2026-04-17（README 内最后一次说明写于 2022-12-08） | 提交记录与 README 正文 | 近半年仍有提交，但文档未同步 |
| 社区规模 | Star 约 8.7k、Fork 约 1.7k、747 commits、贡献者 2 人 | 仓库页截图（2026-10-09 采集） | issue 响应不保证，需自备排障能力 |
核验基准：本站对 Rockyzsu/stock 的所有静态结论都锚定在固定提交 9478dee528cc（2026-04-17），而不是「某天抓的 README」。这样你今天复现、三个月后再复现，看到的是同一份代码。方法见版本核验页。
Rockyzsu/stock · 适合人群
谁适合开始用 Rockyzsu/stock，谁应该先绕道
适合：想学 A 股量化工程细节的人
这里有七个环节的真实代码：集思录登录要做 JS 加密、宁稳要过验证码、巨潮公告要翻页、交割单要按券商分表入库。这些细节在教程里通常被跳过，而在这个仓库里是现成的可读实现。
适合：已经有一个想法、想快速搭原型的人
不需要从零写取数层。把 datahub/ 里对应站点的抓取脚本改一改，接上自己的库即可；select_stock.py 的因子筛选框架可以直接改条件。
适合：想对照「自建 vs 现成技能」的人
同一个任务（取行情、按条件选股、盯盘预警、技术分析）两边都有实现，可以直接比维护成本与可复现性，再决定投入方向。
不适合：想找能直接赚钱的策略
仓库里没有任何绩效证据。没有净值曲线、没有胜率、没有样本外测试。把这里的脚本当信号源，而不是收益来源。
不适合：不想碰数据库与登录态的人
MySQL、MongoDB、Redis、Elasticsearch 四类服务，加上集思录 cookie、宁稳验证码、Tushare token。这些不是可选项——多数脚本的 import 期就依赖配置。
不适合：只想复制粘贴一条命令就跑起来的人
requirements.txt 之外还缺约 24 个包，8 个模块导入即报错，backtest/ 的数据路径是作者本机绝对路径。要跑通必须自己动手修。
FAQ
关于 Rockyzsu/stock 的常见问题
Rockyzsu/stock 是量化框架吗？
setup.py、没有 pyproject.toml、没有 Release，也没有 CI。想用框架请去看 vnpy、qlib、backtrader 这类有发行包的项目；这个仓库的定位是个人量化工作台源码，价值在于真实的数据源对接与工程细节。以官方仓库当前状态为准。它和 EasyClaw 有什么关系？
「30天掌握量化交易」是承诺吗？
它能接实盘吗？
trader/auto_trader.py 用 easytrader 调券商客户端，但依赖被 .gitignore 排除的 config.py 与 user.json；ptrade/ 目录只有 0 字节文件；monitor/server_api.py 的 22 个字段值全部是空键。详见交易边界页。本站不演示下单。支持 A 股吗？支持港股和美股吗？
hk_stock/ 两个打新脚本。美股只有 fund/ark_funds.py 取 ARK ETF 持仓这一类外围数据。以源码中的实际接口为准。需要花钱吗？
有中文文档吗？
怎么判断某一页的结论可信？
9478dee528cc 上的源码与文件清单（标 verified）；②GitHub 元数据与截图（标 qualified，注明采集日期）。本站没有在本机跑过这套代码，所以不做实机运行结论，所有「能否运行」的判断都限定为静态源码核验。