快速上手

快速上手

从零开始跑通最小闭环。先跑起来，再逐层深入。

先确认它适不适合你

YMOS 不适合完全没有投资经验、还在寻找「买什么」答案的新手。它更适合这样的用户：已经在市场里形成过一些判断和生存逻辑，但这些逻辑还散在脑中、笔记和临场反应里；你愿意复盘，也知道自己会反复犯错，希望让 AI 帮你把信息处理、判断流程与执行纪律固定下来。

你是谁推荐路径
第一次接触 YMOS先跑投研层，接好数据、持仓与 Watchlist，用 Reader 看市场洞察和投资雷达；有了真实困惑后再梳理策略内核，最后按需启用操盘层
从 V3 升级保留原有投研主链、持仓、关注、P 系列和 SOP；先按仓库里的 UPGRADE.md 做迁移与回归，再把散落的策略收拢成 Profile。操盘层不是升级前置条件
MARKDOWN
Step 0-3  先把「投研系统」跑起来      ← 投研层 + Reader
Step 4-5  梳理并启用自己的投资逻辑     ← 策略内核层，不要求先用操盘台
Step 6    按需启用交易计划与买卖门禁   ← 操盘层，以作者页面为样板
Step 7    用复盘和真实结果持续进化      ← BrainStorm + 执行证据
💡 提示

首选推荐：使用桌面客户端开箱即用

如果你想直接用起来、不想折腾 Python 环境与命令行，推荐直接下载 YMOS 桌面客户端。客户端内置了服务器、可视化数据源配置与 Reader 阅读器，在首启页点击「一键初始化」即可自动完成框架拉取与绑定。

桌面版与开源框架是同一套资产：客户端读写的就是本地的 Markdown 文件夹；无论你用客户端还是直接用命令行，底层结构完全一致。

准备：获取 YMOS 框架到本地

路径 A：使用桌面客户端（推荐 · 最快）

前往 桌面客户端 页面下载安装包（Mac / Windows）。首次打开：

  • 从没用过：点「一键初始化 YMOS 工作区文件夹」，系统自动从官方 CDN 拉取最新快照并解压绑定。
  • 已有本地文件夹：点「选择我的文件夹」绑定即可。

路径 B：Git Clone（适合开发者 / 极客）

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

路径 C：手动下载快照（GitHub 打不开时）

国内网络访问 GitHub 不稳定？直接下载框架快照：

核心文件夹资产 · 不是客户端
📦 YMOS 文件夹资产快照

这是 YMOS 的核心——那套开源的「文件夹资产框架」本身（Eyes/、Brain/、Console/、持仓与关注/ …），不是桌面客户端。两个用途：

  • GitHub 打不开（如国内网络）时，在这里下载框架，解压到本地任意目录即可用；
  • 桌面客户端的「一键初始化」与「工作区增量补全」拉取的就是这份快照。

作者手动维护，保持与 GitHub 最新版 对齐。要最新、要核对，始终以 GitHub 仓库为准；快照是方便快速上手的镜像，可能滞后一点。

⬇️ 下载文件夹快照 ZIP或从 GitHub 拉最新版 →

无论哪种方式，拿到的都是 V4 最新版，不需要挑版本。放好后应该能看到 YMOS/ 文件夹，包含 Eyes/、Brain/、持仓与关注/、Agents/、BrainStorm/、Console/ 六个子目录和 总入口暗号.md 等文件。

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

第一次使用？把 YMOS 根目录和总入口暗号的路径给 AI（你惯用的 Claude Code / Codex / Hermes / OpenClaw / 豆包 / Kimi 等），然后说「开始使用」：

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

开始使用
ℹ️ 说明

为什么要先给路径？ AI 需要知道你的 YMOS 装在哪里，才能正确读写文件。给了总入口暗号的路径后，AI 会自动推导出整个项目的目录结构。后续对话中直接说暗号即可。桌面客户端的「使用指南」页也提供了各场景可一键复制的指令模板。

AI 会先启动最小入职。默认先验证零配置投研闭环，不把访谈或 Profile 当作启动门槛：

  1. 验证 Level 0 数据链 —— 市场事件用 RSS，价格用 Yahoo Finance；可选 Key 缺失不阻塞
  2. 跑第一轮投研闭环 —— 跑一下市场洞察 → 跑一下投资雷达
  3. 按需增加个人上下文 —— 市场范围、持仓、Watchlist 和轻量关注文件都可以之后再补；说“更新我的关注方向”即可维护
  4. 按需增强数据源 —— 再接 Market API、Finnhub、Tushare 或问财，不推倒基础链
  5. 告诉你下一层入口 —— 需要个性化动作判断时再配置 Profile，最后按需启用操盘台
❗ 重要

V4 不预装通用策略。系统不会配送一个替你选择仓位、止损和退出裁判的「默认激活策略」，只提供安全的 draft 骨架。投研主链不读 Profile，它是否存在都不改变市场洞察、投资雷达和事实调研；只有买卖、持有、加仓、退出等动作级结论才读取 Profile，并在缺失或未激活时被 kernel_not_ready 门禁拦住——这是可恢复的配置状态，不是报错。想建立自己的内核时说「配置一下我的内核」，AI 只问六组人类问题：范围、入场证据、失效信号、风险期限、加减仓、节奏与门禁。回答「不确定」也可以，写不出来的字段就留空，别编——空白是诚实的，编一个数字不是。

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

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

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

看到 Eyes/ 下生成了报告文件？恭喜，最小闭环已跑通。这一步就已经是一个能用的投研系统了——哪怕你后面什么都不配，每天两句话换两份压缩过的信息，这个价值已经成立。

阅读报告

  • 使用桌面客户端：直接在左侧导航点击 Reader 投研阅读器（点击「今日全览」一键聚合当天市场洞察与雷达）。客户端内置了轻量后端，不用敲命令。
  • 使用纯命令行：启动本地 Console：
    BASH
    cd Console
cp config.example.json config.json     # 编辑 vault_root
python3 server.py
    浏览器打开 http://localhost:5273/reader 即可。
💡 提示

公开版已经在市场洞察、投资雷达和策略分析目录各放了一份脱敏合成示例。第一次启动时，即使还没跑过自己的报告，也能直接在 Reader 看见三层如何衔接。示例带有 ymos_sample: true 标记，不会进入真实复盘和胜率统计。

Step 2：管理你的标的

MARKDOWN
关注 TSLA               → 加入 Watchlist，可选触发初始调研
建仓 NIO                → 标记候选建仓；Console 确认成交后才进入真实持仓
调研一下 NVDA           → AI 建立事实档案，按你的模块清单运行研究工具

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

Step 3：让投研层稳定、主动地跑起来

先按需要升级数据源：

级别配置解锁能力
Level 0（零配置）无需 API KeyRSS + Yahoo Finance
Level 1FINNHUB_API_KEY（免费注册）+美股/Crypto 报价和个股新闻
Level 1+TUSHARE_TOKEN（免费注册）+A股日线与最近交易日价格
Level 1++（可选 · Beta）问财官方 Skill + IWENCAI_API_KEY+A股 What’s Hot / 美股条件选股；公告、研报、新闻、财务为实验性入口
Level 2YMOS_MARKET_API_*+结构化市场事件 API

填入 Key 的方式：

  • 桌面客户端（推荐）：在客户端左侧导航进入「数据源配置」页，直接在对应输入框粘贴 Key / Token，点击「测试」验证是否连通，客户端会自动写回工作区的 .env 文件。
  • 命令行方式：将 .env.example 复制为 .env 并填入需要的 Key。

.env 已被 Git 忽略，不要把真实凭据写进 SOP、脚本或提交记录。详细配置见 进阶配置。

接着配置定时任务。手动暗号适合试跑；如果你希望 YMOS 日常替你盯市场，定时任务就是投研层的正常运行方式，不是装饰功能。起步先配两条，稳定运行一到两周再加别的：

任务建议触发作用
市场洞察你关注的市场收盘后，或每天固定一次建立事实背景与事件地图
投资雷达市场洞察完成后汇总市场、热门报告、持仓/Watchlist、价格与事件；轻量关注文件可选增强，不读 Profile

定时任务提示词至少要明确角色、SOP、工作目录、成功标准：

MARKDOWN
你现在承担 Market Insight Agent 角色。
工作目录：/你的路径/YMOS
读取：Agents/market-insight-agent.md
执行：Eyes/SOP_市场洞察.md
成功标准：生成当日市场洞察；失败必须返回具体步骤和错误，不静默跳过。
💡 提示

Agent 文件和 SOP 本身不会自动运行；真正的触发器是你的 Agent 主控、定时任务或手动指令。设置定时任务时务必带上 总入口暗号.md 的完整路径——没有记忆的 Agent 每次执行都需要这个入口。桌面客户端「使用指南」页与仓库 Agents/SCHEDULES_REFERENCE.md 提供了完整参考配置。

Step 4-5：梳理并启用你的策略内核

这一步不要求先用操盘台。你可以只靠已有的投资经验、旧策略文件、投资日志、复盘记录和 BrainStorm，把「我到底怎么做投资」先说清楚：

MARKDOWN
整理我的历史投资资料    → 原件不改写，先建立时期 / 主题 / 观点状态索引
帮我做一次投资诊断      → 找入场、认错、仓位、期限之间的矛盾
配置一下我的内核        → 生成 Strategy Profile 草案，逐段由你确认

内核激活后，动作路由开始按你的 Profile 工作：

MARKDOWN
我想买 TSLA             → 先查 Profile 模块清单 → 只运行已启用/替换的审计链 → 你决策
持有怎么看 NIO          → 复现原论点 → 只运行 Profile 允许的退出审计链 → 你决策
跑一下策略分析          → 自动读取雷达建议，按你的 Profile 路由
检查一下持仓            → 扫账户敞口、盈亏、失效信号与结构告警

详细方法见 策略内核。

Step 6：按需启用操盘层

前五步已经能完成投研和个人化判断。操盘层解决最后一厘米：你知道该怎么做之后，怎样保证自己按计划执行并留下不可改写的证据。

  • 桌面客户端：左侧导航直接进入「交易计划台」（收盘后定调，开盘只执行）和「买卖决策台」（开新仓 / 加仓 / 止盈 / 止损各有一组门禁），开箱即用。
  • 命令行 Console：浏览器打开 http://localhost:5273，同样包含 Reader、交易计划台和买卖决策台。

详细原理见 Console 决策台。

Step 7：把思考与复盘变成长期反馈回路

MARKDOWN
复盘一下 [ticker]       → 平仓后提取「计划 vs 实际」，落盘成证据
开始今天的头脑风暴      → 原样记录今天的想法、困惑和交易理由
整理一下今天说的        → 压缩成 Insight、行动项和待验证问题
审计一下我的内核        → 聚合证据找重复缺口 → 变更提案（月度或季度）

不是每条想法都要升级。多数内容停留在 Raw、Insight、MEMORY 就已经有价值；只有经过 Human 审查、写明反证与回滚条件的少数认知，才写回长期规则。原理见 概览的反馈闭环。

暗号速查

每日运行

跑一下市场洞察
→ 获取并压缩外部市场事实
跑一下投资雷达
→ 汇总外部变化、轻量关注、持仓与 Watchlist；不读 Profile
更新我的关注方向
→ Human 确认后更新当前主题、事件窗口与映射
跑一下策略分析
→ 状态机 + 雷达双输入，按需进入分析路由
检查一下持仓
→ 扫账户敞口、盈亏、失效信号与结构告警

内核配置与进化

帮我做一次投资诊断
→ 只诊断策略结构，不设参数、不选流派
配置一下我的内核
→ 逐题访谈 → Strategy Profile 草案 → Human 单独确认激活
复盘一下 [ticker]
→ 平仓后提取「计划 vs 实际」，归档成证据
审计一下我的内核
→ 聚合已归档证据，找重复缺口并提出变更提案

手动触发

关注 [ticker]
→ 新增 Watchlist 身份
建仓 [ticker]
→ 初始化候选建仓；Console 确认成交后才进入真实持仓
移除关注 [ticker]
→ Watchlist 状态转换
清仓 [ticker]
→ 先核对决策台 close 事件；确认后归档身份
调研一下 [ticker]
→ 建立基础研究上下文
我想买 [ticker]
→ 买入分析链 → Human 决策
加仓 [ticker]
→ 加仓一致性与风险复核（计划/压力测试，不伪造成交）
我想卖 [ticker]
→ 对照原始论点与退出规则
持有怎么看 [ticker]
→ 持有论点与失效信号复核
做个仓位再平衡
→ 组合级 P7 与 Human 确认
查一下价格 [ticker]
→ 价格路由自动分流，写明来源与时间

作者扩展（默认关闭 · 启用前需映射到你自己的 Profile）

查看作者扩展
→ 模块边界、依赖与启用清单
用 P9/P17 看一下 [ticker]
→ Human 点名后的专项深研
跑一下 What's Hot
→ A股热门与主线候选扫描
跑一下美股热门追踪
→ 美股异动、事件与资产候选扫描
跑一下核心资产动态判定表
→ 刷新你已配置的核心资产候选
自动建档 Watchlist
→ 对 Human 选中的候选补资料与观察壳
跑一下A股核心资产回踩扫描
→ 检查你已定义的价格条件

问财数据层（可选 · Beta，需官方 Skill + Key）

查一下财务 [ticker]
→ 问财个股财务数据查询
查一下公告 [ticker]
→ 问财公告搜索
查一下研报 [ticker]
→ 问财经研报搜索
查一下新闻 [ticker]
→ 问财新闻搜索

BrainStorm 沉淀

开始今天的头脑风暴
→ 原样记录今天的想法，整理 Insight
整理一下今天说的
→ 把对话整理成候选语料
整理我的历史投资资料
→ 旧日志原件不改写；建索引、阶段地图与代表样本
用这些旧日志帮我做投资诊断
→ 先读索引与相关原文，再进入结构诊断
给我下一步行动指南
→ 从当前状态与 Insight 生成待确认清单

目录结构

MARKDOWN
YMOS/
├── Eyes/                        # 投研层：事实、行情、市场洞察与外部能力
│   ├── SOP_市场洞察.md
│   ├── SOP_投资雷达.md
│   ├── SOP_问财*.md             #   可选：条件选股与事实检索
│   └── scripts/                 #   零依赖原子脚本，也是你改造的参考
├── Brain/                       # 策略内核层：策略、分析、配置与审计
│   ├── references/              #   P1–P18 判断工具（每个都标了归属）
│   ├── 策略配置/                #   Strategy Profile Schema、模板与唯一运行 Profile
│   ├── 内核审计/                #   入职配置、平仓复盘归档、周期审计、变更提案
│   ├── ymos-diagnosis/          #   结构诊断与 YMOS 适配
│   ├── 买入卖出决策/            #   单笔生命周期与账户快照
│   ├── 交易计划/                #   盘前计划 + 盘中实际
│   └── 决策审计/                #   放行、拦截与执行偏差证据
├── 持仓与关注/                  # 跨层运行状态：投研注意力与对象身份
│   ├── 当前关注方向与投资偏好.md  #   投研层高频状态，不是 Profile 投影
│   ├── SOP_关注方向维护.md     #   Human 确认后更新当前研究主题
│   ├── 持仓_状态机.md
│   └── Watchlist_状态机.md
├── Agents/                      # 跨层角色、顺序与写回权限
├── BrainStorm/                  # 长期投资思考、历史日志、复盘与进化语料
├── Console/                     # Reader + 操盘层两个决策台
├── ARCHITECTURE.md              # 三层定义与归层规则
├── AGENT_GUIDE.md               # Agent 权限与读取顺序
├── 总入口暗号.md                # 所有自然语言入口
├── 进阶指南.md                  # 补投研、装内核、调操盘、按证据进化
└── CHANGELOG.md                 # 版本历史