YoungCan-Wang/WyckoffTradingAgent

WyckoffAgent – 面向中国、香港和美国股票市场的AI驱动交易助手

功能

• 充当对话式“威科夫大师”。您输入自然语言问题，代理根据威科夫量价分析方法返回市场分析。
• 从TickFlow拉取实时每日行情，将用户特定数据（投资组合、信号反馈、回测结果等）存储在Supabase中，并运行一系列工具：
  1. 在A股、港股和美股的日线柱中识别威科夫结构。
  2. 将这些结构与AI生成的研究报告、风险控制检查和漏斗筛选逻辑相结合。
  3. 将结果推送到Web UI、CLI仪表板、Electron桌面应用或外部MCP工具。

主要组件

组件	作用
TickFlow	实时行情数据提供商（无Supabase缓存）。
Supabase	存储用户配置、投资组合、回测日志、信号反馈和任务结果。
LLM后端	Gemini、Claude、OpenAI、DeepSeek V4 – 用于自然语言对话和AI驱动的研究报告。
React Web应用	交互式聊天、漏斗筛选、投资组合视图、新闻覆盖等。
CLI / TUI	wyckoff命令启动终端UI、仪表板（wyckoff dashboard）或一次性任务（wyckoff run …）。
Electron桌面应用	为Windows/macOS捆绑相同的UI和工具，并提供对话框内写入操作。
MCP（Model-Context-Protocol）服务器	公开19个公共工具，可从GitHub、文件系统或自定义数据源添加；所有操作都通过审批队列。
Cloudflare Workers + Vercel沙箱	在安全、短期存在的环境中执行繁重的研究计算。

主要工作流程

1. 数据摄取 – TickFlow的/v1/quotes返回全市场快照；代理在本地过滤。
2. 威科夫漏斗 – 扫描A股市场（约5,000只股票），以识别概念层面的“主线”结构、八通道强度、候选赛道和买点确认。
3. AI研究 – LLM生成三层报告（逻辑分解、储备营、发射台）并对其进行评判。
4. 信号反馈循环 – 收盘后，将观察结果反馈以改进漏斗并允许影子策略验证。
5. 执行保护 – “每日漏斗×次日开盘”规则仅允许在开盘价落在模型生成的区间内时进行交易；否则将信号记录为警告。
6. 用户交互 – 通过聊天，您可以请求投资组合诊断、回测网格，或运行自定义/screen、/checkup、/report、/backtest技能。所有写入操作都排队等待手动审批。

安装与使用

# 一键安装
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

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

首次运行时，您选择LLM模型，提供其API密钥，代理即可就绪。

成本与许可

• 代码是AGPL-3.0且完全开源；您可以自行托管。
• 运行托管服务会产生云成本（数据提供商、Supabase、LLM使用、Cloudflare Workers）。详细的成本模型记录在docs/COST_MODEL.md中。
• 可选“知识星球”会员（每年518元人民币）补贴共享基础设施；不构成投资建议。

适用人群

• 遵循威科夫方法并希望获得AI辅助模式检测和研究的交易者。
• 对结合LLM聊天、实时市场数据、数据库后端和多平台前端的全栈示例感兴趣的开发人员。
• 任何正在寻找受监管、基于审批的交易自动化管道的参考实现的人。

了解更多

• 架构：docs/ARCHITECTURE.md
• 漏斗流程：docs/A_SHARE_FUNNEL_FLOW.md
• 信号反馈循环：docs/SIGNAL_FEEDBACK_LOOP.md
• 公开演示视频和截图嵌入在README中。