YoungCan-Wang/WyckoffTradingAgent

A 股 / 港股 / 美股威科夫量价分析智能体 — 你说人话，他读盘面。
English | 架构文档
用自然语言和一位威科夫大师对话。系统把 A 股日线行情、威科夫结构识别、AI 研报、持仓风控、形态复盘和通知推送串成一条自动化链路，并已扩展支持港股与美股漏斗扫描。
React Web、CLI、MCP 与 GitHub Actions 共同组成当前产品形态；日线行情通过 TickFlow 实时拉取（无 Supabase 行情缓存），Supabase 仅用于用户配置、持仓、形态复盘、市场信号、信号反馈与任务结果。
TickFlow 全市场快照使用 GET /v1/quotes 的 universes 标的池参数，先整池获取再本地筛选；历史日K默认每批200只，美股通道在 workflow 层单独压到100只。午间及 14:55 独立研究的取数与失败边界见 批量行情协议 和 14:55 首屏快照。
> 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.
主线与外部观察池共用配置档加载器，参数优先级不变；FunnelConfig 已移除无消费者的 evrlookback / markuprspositivemin。这是配置维护精简，不是收益改善或策略合并，详见 配置说明。
换手拼接按行情截止日读取流通股本，保持有效原生值，按来源的手/股单位折算；未知单位保留缺失。覆盖率只计算最新日期行有效值，95%门槛不变。报告同时显示主线来源数量、信号状态和重叠拦截原因，不把发现或数据修复当作BUY。详见 数据质量合同。
## 云端运行成本透明
WyckoffAgent 会始终保持开源，欢迎 fork 自行部署、提交 Issue 和 PR。
项目的云端共享服务按付费基础设施运行：行情源、数据库、AI 报告、在线分析服务和自动化维护都会进入显性成本模型。完整成本明细与风险边界见 docs/COSTMODEL.md。
## Special Thanks
TickFlow
感谢 TickFlow 为 WyckoffAgent 提供高质量 A 股 / 美股 / 港股行情数据能力支持。
CZSC
缠中说禅
缠中说禅（CZSC）
感谢顶级交易开源项目缠中说禅（CZSC）的作者 zengbin93 在交易策略上的指导与点拨。
## 快速开始
### CLI（推荐）
bash
# 一键安装
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/PYPIRELEASE.md。
bash
wyckoff # 启动 Agent 对话
wyckoff dashboard # 启动本地可视化面板
启动后 /model 选择模型（Gemini / Claude / OpenAI / DeepSeek V4），输入 API Key 即可对话。DeepSeek 官方适配支持 Flash/Pro、off/low/high/max 思考强度和 1M 上下文；旧 deepseek-chat / deepseek-reasoner 配置会按原模式迁移，自定义代理不会被注入官方专用字段。
展开更多 CLI 截图
| 持仓查询 | 诊断报告 | 操作指令 |
### Web App
在线地址：wyckoff-analysis.pages.dev
展开更多 Web App 截图
| 漏斗选股 | 形态复盘 |
| 持仓管理 | 单股分析（脱敏样例） |
| 新闻打点（300684 本地验收） |
形态复盘页按数据库实际存在的最近 30 个复盘交易日读取数据：“复盘记录”保留窗口内的数据源行数，“总入选次数”按唯一的股票+入选日统计，“覆盖股票数”和涨跌幅摘要则按股票代码去重。单股分析页会把规则过滤后的关键新闻打到 K 线上，只作读盘解释，不改变漏斗候选。服务端报错进 Cloudflare Workers Logs（约 3 天）；页面 PV/UV 用 Web Analytics；星球会员的点击热力图走 Clarity 项目 y6albpfin1。这三样都不写业务库。
### Desktop
Electron 桌面端把 Agent 对话、持仓、定时任务、跟踪归因、报告和 K 线放进同一个本地工作台，支持 Windows x64 与 macOS Intel/Apple Silicon。写操作的确认就在对话里当场问、当场执行（不跳转到别的页面），批过什么在“确认记录”里可查。
公开安装包统一放在 GitHub Releases，不会把 Actions Artifact 当下载站。桌面端在“设置 → 通用 → 软件更新”显示当前版本，发现新的 desktop-v 正式版时会直接给出下载入口。日常 PR/main CI 只跑三平台 Electron 测试，不构建安装包；只有显式手动候选构建或调用 desktop-release Skill 发布版本时才构建带真实 Python 运行时的 EXE 和 DMG，手动候选最多保留 1 天。公开包采用零付费的 Windows 未签名 / macOS 临时签名方案，并明确提示系统警告。按需发布、存储清理与升级清单见 docs/DESKTOPRELEASE.md。
### Streamlit MVP 已下线
Streamlit 已经不再迭代维护，主分支已全面移除 Streamlit 运行代码。相关代码仍保留在 release/streamlit 分支；Streamlit MVP 时期的产品架构和效果图见 docs/STREAMLITMVPARCHITECTURE.md。
### 本地可视化面板（Dashboard）
bash
wyckoff dashboard
展开更多 Dashboard 截图
| 形态复盘 | 信号池 |
| 持仓 | Agent 记忆 | 后台任务 |
| 对话日志 | 同步状态 | 对话日志详情（Trace） |
### 定时任务常驻（macOS launchd）
定时任务默认只在 TUI 打开时运行 —— 关掉窗口就停。装上 daemon 后它独立常驻，关 UI 也继续跑：
bash
scripts/daemoninstall.sh # 装成 launchd 用户级服务
wyckoff daemon --status # 看运行状态
tail -f ~/.wyckoff/logs/daemon.log
scripts/daemonuninstall.sh # 卸载
daemon 持锁时 TUI 会自动让出调度权，两边不会重复触发。
无人监督时的写操作策略。 daemon / wyckoff run 先恢复本机已保存的 CLI 登录态，再跑工具；