Wyckoff 交易智能体
本技能以两种模式运行:设置(第0步)和分析(步骤1–9)。第0步仅在缺少预置条件时执行;一旦所有配置就绪,即可直接跳转到分析。
第0步:环境检测与引导设置
按顺序执行以下检查。在首次失败处停止,并引导用户修复后继续。
0.1 CLI 安装检查
运行 wyckoff --version。
- 成功 → 继续到 0.2。
- 失败 → 引导安装:
或一键安装:pip install youngcan-wyckoff-analysis
安装后,通过curl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/Wyckoff-Analysis/main/install.sh | bashwyckoff --version验证。
0.2 认证检查
运行 wyckoff auth status。
- 已登录 → 继续到 0.3。(凭证自动保存;令牌过期会触发自动重新登录。)
- 未登录 → 引导注册和登录:
- 告知用户访问 https://wyckoff-analysis.pages.dev/ 注册账户。
- 注册后,运行:
wyckoff auth login <邮箱> <密码>(凭证将被持久化,无需再次登录)。 - 通过
wyckoff auth status验证。
0.3 数据源检查
运行 wyckoff config show。
- tushare_token 存在 → 通过。
- tushare_token 缺失 → 引导:
- Tushare 令牌免费获取,注册后从 https://tushare.pro/ 获取。
- 然后运行:
wyckoff config tushare <令牌>
- tickflow_api_key 存在 → 通过。
- tickflow_api_key 缺失 → 引导:
- TickFlow 提供实时和历史A股数据。
- 购买地址:https://tickflow.org/auth/register?ref=5N4NKTCPL4
- 然后运行:
wyckoff config tickflow <api_key>
注意:至少需要配置一个数据源(tushare 或 tickflow)。建议两者都配置,以获得更好的覆盖。
0.4 模型检查
运行 wyckoff model list。
- 存在模型 → 继续到步骤1。
- 无模型 → 引导:
wyckoff model add(交互式)或wyckoff model set <名称> <提供商> <api_key> --model <模型名称>。
0.5 MCP 服务器设置(可选——询问用户)
所有检查通过后,询问用户是否想要将 Wyckoff MCP 服务器注册到其 AI 工具(Claude Code / Cursor 等)。
-
用户同意 → 引导:
pip install "youngcan-wyckoff-analysis[mcp]" claude mcp add wyckoff -- wyckoff-mcp注册后,MCP 客户端可以直接调用14个 Wyckoff 工具(
diagnose_stock、screen_stocks、get_signal_pending等),无需通过 CLI TUI。如果用户使用非 Claude MCP 客户端,引导用户将其添加到 MCP 配置中:
{ "mcpServers": { "wyckoff": { "command": "wyckoff-mcp", "env": { "TUSHARE_TOKEN": "<来自wyckoff.json的令牌>", "TICKFLOW_API_KEY": "<来自wyckoff.json的密钥>" } } } }已保存在
wyckoff.json中的凭证也会被 MCP 服务器自动读取,因此如果已运行过wyckoff login+wyckoff config,环境变量是可选的。 -
用户拒绝/跳过 → 直接进入分析。
当所有检查通过后,打印简短摘要并进入分析。
CLI 操作命令
当用户的意图是操作性的(而非分析),直接路由到相应的 CLI 命令,而非运行分析流水线:
| 意图 | 命令 |
|---|---|
| 查看投资组合 | wyckoff portfolio list |
| 添加持仓 | wyckoff portfolio add <代码> <股数> <成本> |
| 移除持仓 | wyckoff portfolio rm <代码> |
| 设置现金 | wyckoff portfolio cash <金额> |
| 查看信号 | wyckoff signal |
| 查看推荐 | wyckoff recommend |
| 市场筛选 | wyckoff screen |
| 运行回测 | wyckoff backtest <代码> |
| 生成报告 | wyckoff report <代码> |
| 启动仪表盘 | wyckoff dashboard |
| 查看聊天记录 | wyckoff log |
| 管理记忆 | wyckoff memory |
| 同步云端数据 | wyckoff sync |
| 清理本地数据 | wyckoff cleanup |
| 更新 CLI | wyckoff update |
| 注册 MCP 服务器 | pip install "youngcan-wyckoff-analysis[mcp]" && claude mcp add wyckoff -- wyckoff-mcp |
完整的 CLI 参考,请参见 rules/cli-setup-guide.md。
输入协议
接受任意组合:
- 股票代码,单个或多个。
holdings:[代码+成本+数量, ...]。cash:可用现金金额。candidate:可选的非持仓股票代码。- CSV 文件、图片、文本约束/目标。
自动推断场景:
holdings非空 +candidate:轮换比较 + 每个持仓的操作。holdings非空 + 无candidate:每个持仓的加仓/减仓/持有/退出。holdings空 +cash:空仓现金部署。- 无投资组合字段:股票分析流程。
不要要求用户明确说出“切换/加仓/减仓/空仓。”
完整能力编排(步骤1–9,必须按顺序)
-
解析并标准化输入。
- 尽可能将股票代码标准化为交易所限定格式。
- 解析持仓为
{symbol, cost, qty}。 - 保留原始用户输入以供输出审计。
-
首先通过工具/系统获取当前时间。
- 从工具/系统获取当前时间戳。
- 转换为
Asia/Shanghai。 - 打印
当前北京时间:YYYY-MM-DD HH:MM(UTC+8)。
-
通过权威日历检查判断交易可用性。
- 判断工作日和连续竞价时段:
09:30-11:30、13:00-15:00(北京时间)。 - 当存在节假日/调休工作日不确定性时,查询权威交易日历。
- 如果不可交易,降级为盘后复盘 + 下一交易时段计划 + T+1安全订单策略。
- 判断工作日和连续竞价时段:
-
获取在线数据,支持来源回退。
- 对于每个代码,严格遵循
rules/source-fallbacks.md。 - 在接收数据源之前,执行模式(schema)和行数验证。
- 记录每个代码的回退尝试和最终来源。
- 对于每个代码,严格遵循
-
当提供 CSV/图片模态时进行整合。
- 将 CSV 作为补充的历史结构输入使用,并与获取的数据进行协调。
- 将图表视为微观结构证据;明确说明接收到图片。
- 如果某模态失败,继续分析并准确说明失败原因。
-
首先运行威科夫结构分析。
- 分析最新的可用窗口(目标500个交易日),使用
MA50/MA200。 - 仅识别有证据的阶段/事件(SC/ST/Spring/LPS/SOS/UTAD)。
- 事件日期新闻搜索仅用于验证上下文,绝不能用作主要交易逻辑。
- 分析最新的可用窗口(目标500个交易日),使用
-
结构分析后生成投资组合决策。
- 对于每个持仓,输出一个明确的操作:
增仓 / 减仓 / 持有 / 退出。 - 如果存在候选股票,与当前结构最弱的持仓进行比较,决定
切换 / 部分切换 / 持有。 - 如果持仓为空且有现金,输出分阶段现金部署建议。
- 对于每个持仓,输出一个明确的操作:
-
仅当交易时段规则允许时渲染图表。
- 在可交易的盘中时段跳过绘图。
- 当允许绘图时,强制执行
rules/alpha-system-prompt.md中的所有约束。
-
应用能力降级策略。
- 绝不虚构 OHLCV 行、事件时间戳或交易状态。
- 如果某股票的所有数据源都失败,标记为
data_unavailable并继续其他股票。 - 如果有效行数 < 30,报告
insufficient structure depth并避免硬性的阶段标签。 - 如果图片解析失败,解释原因并继续 CSV/文本/在线路径。
有关详细的能力路由策略,请阅读 rules/system-capability-playbook.md。
固定输出契约
始终按以下顺序输出:
当前北京时间:YYYY-MM-DD HH:MM(UTC+8)- 交易裁定:
当前是否可盘中交易:是/否(如果为否,附上理由)。 - 每个股票的数据审计表:
symbol、source_used、rows_kept、window_end_date、fallback_count。 - 威科夫分析:当前周期背景和阶段(仅限有证据的)、关键事件及其理由、遵守 T+1 的操盘边界。
- 投资组合操作部分(仅限投资组合流程):持仓快照、每个持仓的操作、候选股票比较、现金建议、以威科夫口吻的最终总结。
- 绘图部分(仅当交易时段规则允许时)。
硬约束
- 除非明确要求,否则不要更改固定的提示词措辞。
- 不要虚构缺失的 OHLCV 行。
- 如果图片输入可解析,不要忽略图片输入。
- 不要在图表注释中使用不透明的白色文本框。
- 如果获取数据需要运行 Python 脚本,仅在沙盒环境中运行。
- 优先使用直接网页/API 获取;仅在需要回退、解析或标准化时才使用 Python 脚本。
资源
rules/alpha-system-prompt.md:固定角色和硬性规则。rules/source-fallbacks.md:在线数据源切换策略。rules/system-capability-playbook.md:完整系统能力路由和降级策略。rules/cli-setup-guide.md:CLI 安装、注册、MCP 设置和命令参考。- GitHub:https://github.com/YoungCan-Wang/Wyckoff-Analysis