快速上手

快速上手

从零开始，10 分钟跑通最小闭环。

准备：下载 YMOS 到本地

YMOS 运行在你的本地目录中，首先需要把项目下载到本地：

方式一：Git Clone（推荐）

BASH
cd /你的本地路径/
git clone https://github.com/Evan-XYZ/YMOS.git

方式二：手动下载

如果无法访问 GitHub，可以直接下载快照包：

YMOS-V3.0-260320快照

也可以从 GitHub 下载：访问 github.com/Evan-XYZ/YMOS → 绿色 Code 按钮 → Download ZIP

解压后将 YMOS 文件夹放入你的本地目录即可。

💡 提示

放好后应该能看到 YMOS/ 文件夹，里面有 Eyes/、Brain/、持仓与关注/ 三个子目录和 总入口暗号.md 等文件。确认结构完整后，进入下一步。

Step 0：说「开始使用」，AI 带你走一遍

第一次使用？把 YMOS 根目录和总入口暗号的路径给 AI，然后说「开始使用」：

MARKDOWN
读一下这个文件：/你的本地路径/YMOS/总入口暗号.md

开始使用
ℹ️ 说明

为什么要先给路径？ AI 需要知道你的 YMOS 装在哪里，才能正确读写文件。给了总入口暗号的路径后，AI 会自动推导出整个项目的目录结构。后续对话中直接说暗号即可。

AI 会启动入职引导，一步步跟你对话完成：

  1. 填写投资偏好（最重要）—— AI 会分 9 个维度访谈你，写入 当前关注方向与投资偏好.md
  2. 添加你的持仓 —— AI 帮你初始化持仓状态机
  3. 添加你的关注 —— AI 帮你建立 Watchlist
  4. 引导你跑第一轮 —— 体验一次完整闭环
💡 提示

整个过程大约 10-15 分钟。完成后你的系统就是个性化的了。

为什么投资偏好这么重要？

持仓与关注/当前关注方向与投资偏好.md 是整个系统的灵魂文件：

维度为什么重要
投资者画像告诉系统你的风险承受度和心理弱点，P5/P12 会据此拦截不合理的操作
仓位配置框架定义 PVE/PVP/现金的目标占比，系统据此判断是否”超配”
板块关联逻辑告诉系统哪些市场信号跟你有关，投资雷达据此过滤噪音
核心心法与历史教训用真金白银换来的经验，系统会在关键时刻提醒你

填得越详细，系统越懂你。每次投资策略有重大调整时，回来更新这个文件。

Step 1：零配置跑通最小闭环

YMOS 开箱即用，不需要任何 API Key：

MARKDOWN
跑一下市场洞察          → RSS 抓取 + P13 分析 → 市场日报
跑一下投资雷达          → Yahoo Finance 价格 + 趋势回顾 → 桥接报告

看到 Eyes/ 下生成了报告文件？恭喜，最小闭环已跑通。

Step 2：管理你的标的

MARKDOWN
关注 TSLA               → 加入 Watchlist，可选触发初始调研
建仓 NIO                → 从 Watchlist 转入持仓
调研一下 NVDA           → AI 自主完成 P1 建档 + P4 雷达 + P2 阶段判断

每个标的在 持仓与关注/ 下有独立文件夹，里面的所有文件（知识库、备忘录、历史策略报告、你手动拖入的研报）都会成为 AI 分析时的上下文。

Step 3：策略分析

MARKDOWN
我想买 TSLA             → P2 阶段判断 → P9 估值 → P5 FOMO 审计 → P12 纪律审查 → 你决策
持有怎么看 NIO          → P2 → P6 利润守门员 → P12 → 你决策
跑一下策略分析          → 自动读取雷达建议，批量处理

每条策略路由都经过 P12 纪律审查才能到你面前。系统会告诉你「P12 通过/不通过」和理由，但最终按不按按钮是你的事。

Step 4：按需升级数据源

级别配置解锁能力
Level 0（零配置）无需 API KeyRSS + Yahoo Finance
Level 1FINNHUB_API_KEY（免费注册）+美股/Crypto 实时报价和新闻
Level 1+TUSHARE_TOKEN（免费注册）+A股实时行情
Level 2YMOS_MARKET_API_*+结构化市场事件 API

将 .env.example 重命名为 .env，填入 API Key 即可。详细配置方法见 进阶配置。

暗号速查

每日运行

跑一下市场洞察
→ 市场日报（RSS + P13 分析）
跑一下投资雷达
→ 桥接报告（趋势 + 价格 + 建议）
跑一下策略分析
→ 处理雷达建议（P链自动执行）

手动触发

关注 [ticker]
→ 新增 Watchlist
建仓 [ticker]
→ Watchlist → 持仓
清仓 [ticker]
→ 持仓 → Watchlist
调研一下 [ticker]
→ P1+P4+P2+P9 深度调研
我想买 [ticker]
→ 买入策略路由
我想卖 [ticker]
→ 卖出策略路由
持有怎么看 [ticker]
→ 持有评估
做个仓位再平衡
→ 组合再平衡
查一下价格
→ 价格扫描

定时任务（可选）

YMOS 的三步闭环可以设置为定时任务，让 AI 每天自动跑完：

MARKDOWN
市场洞察 → 投资雷达 → 策略分析
⚠️ 注意

三者有先后依赖：投资雷达依赖市场洞察的输出，策略分析依赖投资雷达的建议。请按顺序设置，每步间隔 5-15 分钟。

推荐时间窗口：

场景市场洞察投资雷达策略分析
A股盘中10:3010:4511:00
美股盘前20:3020:4521:00
收盘后复盘收盘后 30min+15min+15min

怎么设置？ 把 SOP 路径和指令告诉 AI：

MARKDOWN
请读取 /你的路径/YMOS/总入口暗号.md

帮我设置三个定时任务：
1. 每天 10:30 执行「跑一下市场洞察」
2. 每天 10:45 执行「跑一下投资雷达」
3. 每天 11:00 执行「跑一下策略分析」
💡 提示

关键提示：设置定时任务时务必带上 总入口暗号.md 的完整路径。没有记忆功能的 Agent 每次执行都需要这个路径作为入口。详细的执行时间估算和自动调研机制见 进阶配置。

目录结构

MARKDOWN
YMOS/
├── Eyes/                          # 眼睛模块
│   ├── SOP_市场洞察.md            # P13 市场日报
│   ├── SOP_投资雷达.md            # 桥接报告（核心）
│   ├── scripts/                   # 取数脚本（零第三方依赖）
│   ├── 市场洞察/                  # 按月归档
│   └── 投资雷达/                  # 按月归档
│
├── Brain/                         # 大脑模块
│   ├── SOP_策略分析.md            # 策略路由（5条路线）
│   ├── SOP_初始调研.md            # P1+P4+P2 建档
│   ├── references/                # P1-P16 提示词资产
│   └── 策略分析/                  # 按月归档
│
├── 持仓与关注/                    # 状态层
│   ├── SOP_入职引导.md            # 首次使用引导
│   ├── SOP_标的管理.md            # 关注/建仓/清仓
│   ├── 持仓_状态机.md             # 持仓真相源
│   ├── Watchlist_状态机.md        # 关注真相源
│   ├── 当前关注方向与投资偏好.md  # 用户投资策略（灵魂文件）
│   ├── 持仓/                      # 个股文件夹
│   └── 动态Watchlist/             # 关注标的文件夹
│
├── 总入口暗号.md                  # 所有暗号路由表
├── AGENT_GUIDE.md                 # Agent 操作手册
├── 进阶指南.md                    # 数据源升级 + 策略定制 + 扩展
└── README.md                      # 项目说明