A 股 AI Agent & Skill 项目包

项目包里有什么

下载解压后的 ai-mock-trade/ 不只是一个复盘工具，而是一套完整的 A 股 AI 研究系统：六组能力 + 两套 AI 系统指令 + 两份心法 / 策略文件。AI IDE 打开目录后会自动加载系统指令，你只需用自然语言对话，柚子 AI 会自己调用对应能力，不需要手动敲命令。

六组能力

• 行情查询：大盘汇总、热点板块、个股详情与分时、连板天梯、主力资金、主题与「今天炒什么」事件、LLM 盘面分析、自然语言选股
• AI 盯盘：盘中自主盯盘、情绪判断、持仓止损止盈检查、选股与交易（模拟）
• 每日复盘：盈亏与情绪复盘、次日计划、自选池整理
• 定时调度：常驻进程按交易时段自动盯盘、盘后自动复盘，无人值守
• 状态读写：本地交易日志、自选池、复盘总结、动态策略（纯本地文件）
• AI 调教：主动指导 Agent 优化心法和交易策略，调教成最适合自己的样子

AI 系统指令与策略

• CLAUDE.md / AGENTS.md：系统总纲（角色、操作流程、输出规范、执行边界），Claude Code 读前者、Opencode 读后者
• memory/trading-mindset.md：核心纪律（选股红线、仓位上限、止损止盈哲学）
• memory/dynamic-strategy.md：动态策略（LLM 字段消费规则、买点 / 止损阈值、输出规范）

方式 A · 可以怎么对话

AI IDE 打开项目后，直接用大白话说需求即可，柚子 AI 会自动调用对应能力并组织回复：

方式 B · 定时盯盘（watch_scheduler.py）

如果你想让柚子 AI 在行情时段自动盯盘、盘后自动复盘，运行项目内置的 watch_scheduler.py 即可。它是一个常驻 Python 进程，按 A 股交易时段在本地调用 AI CLI 执行盯盘/复盘，不依赖任何 IDE 插件，关掉终端前会一直跑。所有操作均用于学习研究，不构成任何投资建议。

默认行为

• 交易日（周一至周五）09:30-11:30、13:00-15:00，每 5 分钟触发一次「执行一次盯盘」
• 每个交易日 21:00 触发一次「复盘今天的行情数据」
• 非交易时段脚本只 sleep，不消耗 CPU 与网络资源；周末不盯盘
• 默认调用 Opencode（与 AGENTS.md 配合），也可切换到 Claude Code

启动

在 ai-mock-trade/ 目录下执行一行命令即可（启动后会持续在终端打印每次触发的简要结果，Ctrl+C 可优雅退出，会等待当前 CLI 跑完再停）：

# 默认：常驻循环（盘中每 5 分钟盯盘 + 21:00 复盘）
python watch_scheduler.py

# 常驻后台（关闭终端不被 kill）
nohup python watch_scheduler.py >> data/watch_scheduler.out 2>&1 &

# 只跑一次就退出（不进入循环）：watch=盯盘、review=复盘
python watch_scheduler.py --once watch

常用参数

CLI 参数与同名环境变量效果一致，参数优先级更高，或者你也可以直接修改文件内 parse_args 默认的参数：

更多参数：--project-dir、--prompt-review、--log-dir；完整列表见 python watch_scheduler.py --help。

日志与排障

日志默认写到 data/watch_scheduler_logs/，分两类：

• scheduler-YYYY-MM-DD.log：调度器自身的 INFO/ERROR，每次触发的「谁/做了什么/结果」一行
• run-YYYYMMDD-HHMMSS.log：每次 CLI 调用的完整 stdout/stderr，CLI 报错时优先看这个

常见排查：CLI 报 command not found → which opencode 检查 PATH；密钥失效 → 重新登录下载页拿新 .env；CLI 长时间无输出 → 检查网络与 provider 配额（单次失败不会中断后续轮次）。

环境准备（如果上面跑不起来再看）

脚本只做调度，执行依赖本机的 Python（3.8+）与 AI CLI。若启动命令报 command not found，说明对应工具尚未安装，请自行查阅官方文档：

• Python 3.12+：参见 python.org
• opencode（默认 CLI）：参见 opencode.ai，首次使用需 opencode 需配置密钥
• Claude Code（备选 CLI）：参见 claude code 官方文档，首次使用需 claude login 或 配置密钥

链路验证（推荐先跑一次再启动常驻调度）：在 ai-mock-trade/ 目录下手动执行 opencode run "执行一次盯盘"，能正常出盘面摘要即为通畅。ai-mock-trade/.env 下载时已自动写入密钥，手动复制场景才需要自己补。

项目自更新工具

服务端会持续优化 skills（六组能力）/ 系统指令（AGENTS.md / CLAUDE.md）/ 心法与策略（memory/），本地用 tool.py 一行命令即可增量拉取最新，免手动重下整包。下列命令均在 ai-mock-trade/ 目录下执行。

python tool.py update          # 默认更新最常变的 skills，日常用它就够

更新指定模块

只查询，不下载

遇到版本门禁异常（check / update 都报 list 接口失败）时，可用 python tool.py update all --force 跳过门禁强制下载，作为兜底。

安全说明：覆盖前自动备份到 backups/，可随时恢复；data/（交易日志）与 .env（密钥）永不被覆盖；已是最新时不下载，不占每日下载次数。

旧版本用户（项目根没有 tool.py）需重新下载一次完整项目包获取 tool.py，之后即可增量更新。