youngcan-wang/wyckofftradingagent

---

用自然语言和一位威科夫大师对话。系统把 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。

---

Special Thanks

---

快速开始

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 即可对话。

Web App

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

Streamlit MVP 已下线

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

本地可视化面板（Dashboard）

wyckoff dashboard

回测网格

---

功能亮点

• 对话式 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 / wyckoff diag 产出统一 JSONL，方便复盘工具调用时间线
• 独立边缘后端 — React 统一调用 Hono Worker；后端提供请求 ID、安全响应头、请求体上限、Redis 共享限流和白名单沙箱任务，本地支持 VS Code 断点与 workerd 集成测试
• 观察篮临时行情 — 只为当前问题拉取相关 TickFlow 报价，浏览器快照 45 秒后失效，不写入 Redis 或业务数据库
• 依赖卫生检查 — CI 运行 scripts/check_dependency_hygiene.py，提示 Python/Web 依赖锁定和 lockfile 风险
• MCP Server — 18 个工具通过 MCP 协议对外暴露，Claude Code / Cursor 即插即用；包含研究假设与证据台账
• 多通道推送 — 飞书 / 企微 / 钉钉 / Telegram
• 本地面板 — wyckoff dashboard 一条命令启动可视化

---

演示视频

---

文档导航

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

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

---

配置

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

进阶配置见 架构文档。

数据源购买：TickFlow → ｜ 大模型购买：1Route →

---

交流

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

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

赞助

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

License

AGPL-3.0 © 2024-2026 youngcan

---