ROUTE COMPARISON · TASK BY TASK
两条路线怎么选：自己跑 QuantsPlaybook，还是先用本机技能拿结果
这两条路解决的不是同一个问题。QuantsPlaybook 给你的是「研报怎么落到代码」的完整链路，代价是环境与数据门槛；本机技能给你的是「现在就拿到数据与指标」的能力，代价是拿不到研报级的研究资产。
- QuantsPlaybook：58 个案例目录 / 65 个 Notebook / 83 份研报 PDF，但无 pip 包、无许可证、需自备数据。
- EasyClaw 本机：29 个技能目录，覆盖取数 / 指标 / 选股 / 估值 / 出图 / 盯盘。
- 交集很小但有一个关键共性：两者都能用 Tushare Pro Token 取 A 股数据。
- QuantsPlaybook 不在本机技能目录中，两者无已证实集成。
两条路线各能走到哪一步
TASK BY TASK
QuantsPlaybook 八类任务在两条路线上各能走到哪一步？
「哪条路线更好」是个问错的问题。正确问法是「我现在要的结果，属于哪一类任务」。
| 你的任务 | QuantsPlaybook 路线 | 本机技能路线 | 关键差异 |
|---|---|---|---|
| 复现某份券商研报里的因子或择时方法 | 对口：案例目录里同时有研报 PDF、公式说明与 Notebook | 不对口：技能里没有研报案例库，quant-analyst 只提供方法论与检查清单 | 这是 QuantsPlaybook 不可替代的地方 |
| 快速查一只票的行情 / 指标 / 估值 | 绕路：要先建环境、配数据、写代码 | 对口：akshare-finance（免 Key）、a-stock-analysis、a-share-metrics-card | 本机路线在这里快得多 |
| 按条件筛一批股票 | 不对口：项目不做选股产品 | 对口：iwencai（问财）、mx-select-stock（妙想）、tonghuashun-research-assistant | 但要留意问财类技能需要自己的 API Key |
| 系统做因子检验（IC / ICIR / 分组回测） | 对口：案例含 Qlib + alphalens 的完整流程，factor_analyze.py 等脚本齐备 | 部分对口：quant-analyst 给方法与检查清单，不提供可执行的因子引擎 | 要真跑因子分析，仍以自建环境为主 |
| 把结果画成图 | 自带绘图模块：hugos_toolkit/VectorbtStylePlotting | 对口：chart-image 直接输出 PNG（折线/柱状/K 线/热力图） | 两边都能做，本机路线不需要装 Python 环境 |
| 盯盘与预警 | 不对口 | 对口：stock-monitor-skill-0-1-0（7 类预警规则，不自动下单） | 关注持仓风险时用本机路线 |
| 估值建模（DCF 等） | 不对口：项目聚焦研报复现，不含估值引擎 | 对口：fp-dcf（DCF 估值引擎，支持 A 股/港股/美股） | 任务不同，不构成替代 |
| 实盘下单 | 不支持：项目不含交易通道 | 不支持：技能均明确不自动下单、不生成投资建议 | 两条路都不适合 |
依据：QuantsPlaybook 固定 commit 的文件树与案例 README；本机 C:\Users\CF\.easyclaw\skills 下逐个技能的 SKILL.md。均为 2026-09-29 核验。
SKILL INVENTORY
12 个本机技能各管什么？清单与前置条件
下表只列与 QuantsPlaybook 任务域相关的技能，并标注前置条件与它不做什么——后者往往比前者更重要。
| 技能（本机目录名） | 负责什么 | 前置条件 | 它不做什么 | 与 QuantsPlaybook 的关系 |
|---|---|---|---|---|
akshare-finance | 股票 / 期货 / 期权 / 基金 / 外汇 / 债券 / 指数 / 加密货币的行情与基本面数据 | 免 API Key（需装 akshare） | 不提供投资建议、不处理实盘交易 | 可替代案例里的取数层（字段与 Tushare 口径不同） |
tushare-finance | 220+ Tushare Pro 接口（行情 / 财务 / 宏观） | 需 TUSHARE_TOKEN（积分与权限挂钩） | 不生成策略、不做回测 | 与 QuantsPlaybook 新案例同一个数据源——同一个 Token 两边通用 |
quant-analyst | 策略建模、回测方法论、风险指标（VaR / Sharpe / 回撤）、组合优化、统计套利 | 无 | 只提供方法与检查清单；仓库里仅有一份 playbook 与一个环境检查脚本 | 与案例的「方法论层」重叠，但不提供因子引擎 |
stock-technical-mastery | MACD / RSI / 布林带 / 均线 + K 线形态识别 | 无（覆盖 A 股） | 不覆盖港股 / 美股 / 期货 | 近似于案例中技术指标类择时信号的「轻量替代」 |
chart-image | 从数据生成 PNG 图表（折线 / 柱状 / 面积 / K 线 / 热力图等） | 首次需 npm install | 只出图，不算指标 | 可替代 VectorbtStylePlotting 的出图职责 |
iwencai | 同花顺问财入口（自然语言选股 / 模拟炒股） | 需 IWENCAI_API_KEY | 与项目的因子研究流程无关 | 提供「按条件筛股票」这一项目不具备的能力 |
tonghuashun-research-assistant | 问财 / iFinD / 行情 / 公告新闻检索 / 板块个股研究 | 需相应权限 | 不支持持仓监控与下单 | 用于快速做个股或板块的资料汇总 |
mx-select-stock / mx-data / mx-search | 东方财富妙想：智能选股 / 金融数据库查询 / 资讯搜索 | 需 MX_APIKEY | 不负责策略研究 | 同属「取数与筛选」层 |
a-stock-analysis / a-share-metrics-card | A 股实时行情与分时量能 / 单只股票指标体检卡（估值、盈利质量、现金流等） | 无（接口来自东方财富与新浪） | 不生成投资建议 | 项目不含这类「实时 + 单体」能力 |
stock-monitor-skill-0-1-0 | 7 类预警规则（成本盈亏 / 均线 / RSI / 量能 / 跳空 / 止盈） | 需配置监控清单 | 不自动下单、不覆盖期货外汇加密货币 | 项目不含盯盘能力 |
fp-dcf | DCF 估值引擎（FCFF / WACC / 敏感性分析），支持 A 股 / 港股 / 美股 | akshare / baostock / yfinance 或手工输入 | 不支持相对估值（PE/PB/PS） | 项目里 A 类基本面案例做的是选股模型，不是估值 |
futuapi / futu-zhitou / tongdaxin / yahoo-finance-github | 富途 OpenAPI（需 OpenD）/ 异动检测 / 通达信 MCP（需 APIKEY）/ 美股数据（免 Key） | 各自需要凭据 | 均不自动下单 | 扩展数据源覆盖面 |
口径：以上技能「能在目录里查到」不等于已安装、已授权或已在本机跑通。每个技能的 SKILL.md 都写明了前置条件与不支持范围，使用前请逐个确认。
LIVE SCREENSHOTS
本机技能路线实际能做什么？三张对话截图
下面三张都是本机技能的实际对话截图，用来说明「不配环境、一句话提问」这条路能拿到什么。它们展示的是技能路线自己的任务，与 QuantsPlaybook 的复现流程无关。
这三张截图证明的是「本机技能能回答这类问题」，不证明 QuantsPlaybook 已集成、已安装或已复现任何研报结论。
DECISION
两条路线怎么选？三个判断问题
不用比较功能列表，问三个问题就有答案。
| 判断问题 | 如果答案是「是」 | 如果答案是「否」 | 为什么这样判断 |
|---|---|---|---|
| ① 我要的结果是「复现某份研报的方法」吗？ | 走 QuantsPlaybook 路线：案例目录里有研报原文、公式与 Notebook | 继续问第 ② 题 | 这是 QuantsPlaybook 不可替代的能力，其它路线都替代不了 |
| ② 我能在 30 分钟内拿到需要的数据吗？ | 走本机技能路线：直接提问拿结果 | 继续问第 ③ 题 | 数据门槛是这个项目的真实分水岭；拿不到数据的案例实质不可用 |
| ③ 我愿意为「可复现的方法」投入环境与数据成本吗？ | 按案例清单页的推荐顺序，从离线快照案例开始 | 先走本机技能路线拿到初步结果，再决定要不要深入 | 两者不是替代关系，而是「先做什么」的顺序问题 |
最常见的错误顺序
先花两天配 Qlib 环境、再申请数据账号、最后发现要复现的那份研报其实是 2018 年的、数据区间已经拿不到了。正确顺序是：先看案例清单确认有没有这份研报，再看数据页确认能不能拿到数据，最后才动手装环境。
一个共用的凭据
如果你已经有 Tushare Pro Token，它同时可以用于 QuantsPlaybook 的新案例（.env 的 TS_TOKEN）与本机的 tushare-finance 技能。这是两条路线共同的实操交集。
两条路线可以叠加
用本机技能取数、用 chart-image 出图，再按案例里的因子定义自己实现——这样既绕开了 Qlib 环境，也绕开了数据账号，代价是放弃「与研报逐行对齐」的那部分价值。
BOUNDARIES
本页不声称什么？边界披露
为避免误读，把本页的边界单独写清楚。
| 不声称的事项 | 实际情况 | 依据 |
|---|---|---|
| 不声称 QuantsPlaybook 已集成到 EasyClaw | QuantsPlaybook 不在本机技能目录（C:\Users\CF\.easyclaw\skills）中，无 Skill 定义，也无 Integration 证据 | 本机技能目录清点 2026-09-29 |
| 不声称本机技能能替代研报复现 | 两者任务不同：一个是研究资产（研报 + 复现 + 偏离评估），一个是随取随用的数据与分析能力 | 两侧能力的逐条核对 |
| 不声称技能已安装 / 已授权 | 技能「在目录里可查到」与「已安装、已授权、跑通过」是四件不同的事；部分技能需要自己的 API Key | 各技能 SKILL.md 的前置条件 |
| 不提供任何投资建议或收益预期 | 本页只比较任务覆盖范围与前置条件，不评价任何策略或标的的表现 | 站点合规口径 |
| 不复制作者的付费内容 | 仓库根有作者的社群与打赏入口；本站只描述公开仓库事实，与作者的付费内容无关，也不作推广 | 仓库文件树 + README |
本站是第三方撰写的中文研究笔记，与 QuantsPlaybook 作者、EasyClaw 官方均无合作关系；一切以实现、官方文档与官方许可为准。
FAQ
两条路线怎么选的常见问题
QuantsPlaybook 可以在本机技能里用吗？
不能。QuantsPlaybook 是仓库形态的 Jupyter 案例库，没有 pip 包、没有 Skill 定义，也不在本机技能目录（C:\Users\CF\.easyclaw\skills）里，与 EasyClaw 无已证实集成。本页做的是「任务分工对照」，不是集成说明。
两条路线能一起用吗？
可以，而且这是最实用的组合：用本机技能（akshare-finance / tushare-finance）取数，用 chart-image 出图，再按 QuantsPlaybook 案例里的因子定义与公式自己实现。这样绕开了 Qlib 环境与数据账号两道门槛，代价是放弃「与研报逐行对齐」的那部分价值。
我只有 Tushare Pro 的 Token，两边通用吗？
通用。QuantsPlaybook 的 2026 年新增案例（如 基于稀疏自编码器的指数择时）用 .env 里的 TS_TOKEN；本机的 tushare-finance 技能也用 Tushare Pro Token。同一个 Token 可以同时支撑两条路线——这是两者共同的实操交集。
本机技能和 quant-analyst 有什么区别？
quant-analyst 是本机技能之一，定位是方法论：回测设计、风险指标、组合优化、统计套利，主要提供检查清单与通行做法，仓库里只有一份 playbook 与一个环境检查脚本，不含数据源与回测引擎。它能帮你「想清楚怎么做」，但不能替你「跑出因子结果」——后者需要自建环境或用其它数据工具。
为什么两条路线都不支持实盘下单？
因为定位不同：QuantsPlaybook 是研报复现案例库，不含交易通道；本机技能则普遍在说明里明确写了「不自动下单」「不生成投资建议」（如 stock-monitor-skill-0-1-0、a-stock-analysis）。两条路线都面向研究与教育用途。
如果我只想快速筛一批股票，该走哪条？
走本机技能路线。可选项包括 iwencai（问财，需 IWENCAI_API_KEY）、mx-select-stock（妙想，需 MX_APIKEY，免 Key 的选项可先用 akshare-finance 取数后自行筛选。成本提示：筛选类问题的耗时与费用主要取决于扫描范围（标的数量），建议把范围限定在单只标的或单一板块，不要做全市场海选。
这些结论是怎么核验的？
两侧都做了逐条核对：QuantsPlaybook 侧按固定 commit 1e4a2310 的全量文件树与各案例 README；本机技能侧逐个读取 SKILL.md 的 frontmatter 与正文（共 29 个技能目录）。本站没有跑通任何 QuantsPlaybook 案例（无 JQData / TuShare Pro 付费权限），也不声称任何技能已授权或已运行。