Skip to main content

Wyckoff method quantitative analysis system for A-shares, Hong Kong stocks, and US stocks

Project description

WyckoffAgent — Open-Source Wyckoff Trading Agent

A 股 / 港股 / 美股威科夫量价分析智能体 — 你说人话,他读盘面。

PyPI Python License Web App Homepage

English | 日本語 | Español | 한국어 | 架构文档


用自然语言和一位威科夫大师对话。系统把 A 股日线行情、威科夫结构识别、AI 研报、持仓风控、形态复盘和通知推送串成一条自动化链路,并已扩展支持港股与美股漏斗扫描。

React Web、CLI、MCP 与 GitHub Actions 共同组成当前产品形态;日线行情通过 TickFlow 实时拉取(无 Supabase 行情缓存),Supabase 仅用于用户配置、持仓、形态复盘、市场信号、信号反馈与任务结果。

Risk disclosure: WyckoffAgent is for educational, research, and informational use. It does not provide investment advice, does not account for every personal financial circumstance, and does not guarantee future performance.


云端运行成本透明

WyckoffAgent 会始终保持开源,欢迎 fork 自行部署、提交 Issue 和 PR。
2026-06-03 起,项目的云端共享服务按付费基础设施运行:行情源、数据库、AI 报告、在线分析服务和自动化维护都会进入显性成本模型。下面的 Supabase 配额提示是这类成本边界的例子,完整成本明细与风险边界见 docs/COST_MODEL.md

Supabase quota grace period until 03 Jun, 2026


Special Thanks

TickFlow TickFlow
感谢 TickFlow 为 WyckoffAgent 提供高质量 A 股 / 美股 / 港股行情数据能力支持。
CZSC
缠中说禅
缠中说禅(CZSC)
感谢顶级交易开源项目缠中说禅(CZSC)的作者 zengbin93 在交易策略上的指导与点拨。

快速开始

CLI(推荐)

# 一键安装
curl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/WyckoffTradingAgent/main/install.sh | bash

# 或 Homebrew / pip
brew tap YoungCan-Wang/wyckoff && brew install wyckoff
uv pip install youngcan-wyckoff-analysis

维护者发布 PyPI 的自动 patch 流程与 Trusted Publishing 一次性配置见 docs/PYPI_RELEASE.md

wyckoff          # 启动 Agent 对话
wyckoff dashboard  # 启动本地可视化面板

启动后 /model 选择模型(Gemini / Claude / OpenAI),输入 API Key 即可对话。

CLI 启动界面

展开更多 CLI 截图
持仓查询 诊断报告 操作指令

Web App

在线地址:wyckoff-analysis.pages.dev

Web 读盘室

展开更多 Web App 截图
漏斗选股 形态复盘
持仓管理 单股分析(脱敏样例)

Streamlit MVP 已下线

Streamlit 已经不再迭代维护,主分支已全面移除 Streamlit 运行代码。相关代码仍保留在 release/streamlit 分支;Streamlit MVP 时期的产品架构和效果图见 docs/STREAMLIT_MVP_ARCHITECTURE.md

本地可视化面板(Dashboard)

wyckoff dashboard

Dashboard 总览

展开更多 Dashboard 截图
形态复盘 信号池
持仓 Agent 记忆 后台任务
对话日志 同步状态 对话日志详情(Trace)

回测网格

回测网格最优参数与梯队表

展开更多回测截图
参数矩阵

功能亮点

  • 对话式 Agent — 用自然语言触发诊断、筛选、研报;CLI、Web、MCP 各自按权限编排多工具
  • 主线漏斗筛选 — A 股全市场约 5000 股动态发现概念主线、八通道强度、候选车道和买点确认;NEUTRAL 主线优先,RISK_ON 禁新开
  • 日漏斗 × 次日开盘串联 — 漏斗定候选与环境,跨日 confirmed 后由 OMS 给出唯一允许买入区间,开盘价在区间内才执行;报告顶部固定「执行纪律」
  • 跨市场 — A 股 / 港股 / 美股漏斗独立 workflow
  • AI 三阵营研报 — 逻辑破产 / 储备营地 / 起跳板,LLM 独立审判
  • 信号反馈闭环 — 漏斗记录 observations,盘后 feedback 聚合 health / registry,支持 shadow 动态策略验证
  • 持仓诊断 & 私人决断 — EXIT/TRIM/HOLD/PROBE/ATTACK;非主线 5 日时间管理;灾难地板约 -12%
  • Agent 分层记忆 — L1 原子记忆 + L2 场景 + L3 画像,FTS5/代码/关键词混合召回并保留来源追溯
  • Skills 扩展 — 内置 /screen/checkup/report/backtest,用户可自定义
  • Prompt 模板 — 内置 /daily/review-l4/step3-audit 等高频投研模板,也支持 ~/.wyckoff/prompts/*.md
  • 模型元数据与成本可见性wyckoff model list/usage/cost 展示上下文窗口、reasoning 能力和本地 token 成本估算
  • 会话分叉与导出wyckoff session export/fork 或 TUI /fork 把历史对话变成可复盘、可继续的新分支
  • 标准事件流wyckoff trace --events <scratchpad.jsonl> / wyckoff diag 产出统一 JSONL,方便复盘工具调用时间线
  • 独立边缘后端 — React 统一调用 Hono Worker;后端提供请求 ID、安全响应头、请求体上限、Redis 共享限流和白名单沙箱任务。读盘室的研究计算必须经用户确认,先进入单并发 Cloudflare Queue,再由签名的 Node 执行桥进入无网络、自动销毁的 Vercel Sandbox;Worker 与 bridge 用 requestId/runId 输出不含脚本与密钥的结构化执行日志,本地支持 VS Code 断点与 workerd 集成测试
  • 观察篮临时行情 — 只为当前问题拉取相关 TickFlow 报价,浏览器快照 45 秒后失效,不写入 Redis 或业务数据库
  • 依赖卫生检查 — CI 运行 scripts/check_dependency_hygiene.py,提示 Python/Web 依赖锁定和 lockfile 风险
  • 测试隔离与单次覆盖率 — pytest 不读取本机 .env、底层 socket 默认断网;CI 只执行一次 coverage-instrumented Python 全量套件并复用结果生成覆盖率 artifact
  • MCP Server — 18 个工具通过 MCP 协议对外暴露,Claude Code / Cursor 即插即用;包含研究假设与证据台账
  • 多通道推送 — 飞书 / 企微 / 钉钉 / Telegram
  • 本地面板wyckoff dashboard 一条命令启动可视化

演示视频

「从0到1读盘」Web 全流程(读盘室→设置)
「终端党最爱」CLI 流程(启动→执行→结果)

文档导航

每类事实只在一份主文档中详细维护,其余页面只做摘要和链接:

权威内容 唯一主文档
技术架构、Actions 总表、数据表、缓存 docs/ARCHITECTURE.md
A 股主漏斗的阶段顺序与上下游数据流 docs/A_SHARE_FUNNEL_FLOW.md
信号反馈实现、shadow/on 动态策略 docs/SIGNAL_FEEDBACK_LOOP.md
研究路线、证据门槛与晋级治理 docs/ITERATION_STRATEGY.md
运营成本、规模化预算 docs/COST_MODEL.md
策略语义:漏斗、AI 研报、OMS、回测 README_STRATEGY.md
实盘操作(日漏斗×次日开盘) docs/OPERATOR_PLAYBOOK.md
术语速查 GLOSSARY.md
MCP Server 配置 docs/ARCHITECTURE.md
密钥、Actions Secrets 与本地配置 docs/ARCHITECTURE.md

Wiki 深度阅读交易方法论 Wiki技术架构 Wiki。Wiki 解释方法和设计取舍,不重复维护配置值、工作流清单或数据表契约。


配置

零配置即可使用 — 启动后 /model 添加 LLM API Key 即可对话。

进阶配置见 架构文档

数据源购买:TickFlow → | 大模型购买:1Route →


交流

如果你希望免去行情数据源、数据库、云服务器、AI API 和自动化任务的运维成本,可以加入 「威科夫策略交流学习」知识星球,使用云端共享入口:多端同步、每日全市场漏斗推送、自动 AI 研报和专属交流社区都由共享基础设施统一承载。

年费 CNY 518/年,折合每天约 1.4 元。518 取“我要发”的好彩头;这笔费用主要用于共同平摊系统运维硬成本,不是投资顾问费,也不构成任何收益承诺。成本明细与风险边界见 docs/COST_MODEL.md

威科夫策略交流学习 知识星球二维码

飞书一群 飞书二群 QQ群 飞书个人

群号: 761348919

赞助

觉得有帮助?给个 Star。赚到钱了?请作者吃个汉堡。

支付宝 微信

License

AGPL-3.0 © 2024-2026 youngcan


Star History Chart

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

youngcan_wyckoff_analysis-0.9.216.tar.gz (1.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

youngcan_wyckoff_analysis-0.9.216-py3-none-any.whl (1.3 MB view details)

Uploaded Python 3

File details

Details for the file youngcan_wyckoff_analysis-0.9.216.tar.gz.

File metadata

File hashes

Hashes for youngcan_wyckoff_analysis-0.9.216.tar.gz
Algorithm Hash digest
SHA256 0267e7ae0118e1a13b82fd3b858f5a346ad06523c8e12dec00658633774157a2
MD5 f5cbd1893ebd4208210f8627531ab07d
BLAKE2b-256 c874ce16a443eb306305d61cb28ae355fad78da64137b99d808dbf4d130fa666

See more details on using hashes here.

Provenance

The following attestation bundles were made for youngcan_wyckoff_analysis-0.9.216.tar.gz:

Publisher: pypi_patch_release.yml on YoungCan-Wang/WyckoffTradingAgent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file youngcan_wyckoff_analysis-0.9.216-py3-none-any.whl.

File metadata

File hashes

Hashes for youngcan_wyckoff_analysis-0.9.216-py3-none-any.whl
Algorithm Hash digest
SHA256 5673eee17bf2702093c46cd55b470b777eb10014f552092aef1fa4aba3621887
MD5 52715a1000898b05184f72db0fd81c8c
BLAKE2b-256 ca00568a893ef7ca5e23c899f6abb093c6d9f4d24ef60f2fc9949d359f58e020

See more details on using hashes here.

Provenance

The following attestation bundles were made for youngcan_wyckoff_analysis-0.9.216-py3-none-any.whl:

Publisher: pypi_patch_release.yml on YoungCan-Wang/WyckoffTradingAgent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page