快速上手

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

先确认它适不适合你

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

你是谁	推荐路径
第一次接触 YMOS	先跑投研层，接好数据、持仓与 Watchlist，用 Reader 看市场洞察和投资雷达；有了真实困惑后再梳理策略内核，最后按需启用操盘层
从 V3 升级	保留原有投研主链、持仓、关注、P 系列和 SOP；先按仓库里的 `UPGRADE.md` 做迁移与回归，再把散落的策略收拢成 Profile。操盘层不是升级前置条件

MARKDOWN

Step 0-3  先把「投研系统」跑起来      ← 投研层 + Reader
Step 4-5  梳理并启用自己的投资逻辑     ← 策略内核层，不要求先用操盘台
Step 6    按需启用交易计划与买卖门禁   ← 操盘层，以作者页面为样板
Step 7    用复盘和真实结果持续进化      ← BrainStorm + 执行证据

💡 提示

部署前先看看 YMOS 长什么样： 打开 YMOS 浏览器 Demo。

Demo 的 Reader 会先用一棵虚拟目录树展示 YMOS 的完整结构，让你直观看到 Eyes/、Brain/、持仓与关注/、BrainStorm/、Agents/ 与 Console/ 怎样组成一整套本地 Markdown-first 投资系统；随后还可以阅读三份脱敏合成报告，并体验交易计划台和买卖决策台的基本交互。

Console 只是 YMOS 的阅读与操盘入口，不是系统本体。Demo 不读取持仓、Watchlist 或 API Key，不写入服务器，也不执行交易；投研层与策略内核层的真实能力，需要完整安装项目并让 Agent 执行本地 SOP 后才能看到。

准备：下载 YMOS 到本地

方式一：Git Clone（推荐）

BASH

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

方式二：手动下载

访问 GitHub 仓库首页 → 绿色 Code 按钮 → Download ZIP。解压后将 YMOS 文件夹放入你的本地目录即可。

无论哪种方式，拿到的 main 分支都是 V4，不需要挑版本。

💡 提示

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

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

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

MARKDOWN

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

开始使用

ℹ️ 说明

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

AI 会先启动最小入职，一步步完成：

配置投研层 —— 你要看哪些市场、哪些数据源已可用、失败了怎么降级
建立最小运行偏好 —— 只确认市场、能力圈和关注方向；写不出的策略参数先留空
添加持仓与关注 —— 初始化状态机和 Watchlist；空仓或暂时没有关注也可以
跑第一轮投研闭环 —— 跑一下市场洞察 → 跑一下投资雷达
告诉你下一层入口 —— 需要时再做完整策略诊断、启用操盘台，不在 Day 0 强迫一次配完

❗ 重要

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

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

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

MARKDOWN

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

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

想更方便地阅读，启动 Console 后先只使用 Reader：

BASH

cd Console
cp config.example.json config.json     # 编辑 vault_root
python3 server.py

打开 http://localhost:5273/reader。Reader 只是报告入口，不要求你同时使用交易计划台和买卖决策台。

💡 提示

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

Step 2：管理你的标的

MARKDOWN

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

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

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

先按需要升级数据源：

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

将 .env.example 复制为 .env，填入需要的 Key。.env 已被 Git 忽略，不要把真实凭据写进 SOP、脚本或提交记录。详细配置见进阶配置。

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

任务	建议触发	作用
市场洞察	你关注的市场收盘后，或每天固定一次	建立事实背景与事件地图
投资雷达	市场洞察完成后	把事实映射到持仓、关注和最小偏好

定时任务提示词至少要明确角色、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：按需启用操盘层

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

浏览器打开 http://localhost:5273，三个页面：Reader（只读报告）、交易计划台（盘前定调，第二天只执行）、买卖决策台（开新仓 / 加仓 / 止盈 / 止损各有一组门，全绿才允许扣扳机）。详见 Console 决策台。

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

MARKDOWN

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

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

暗号速查

每日运行

跑一下市场洞察

→ 获取并压缩外部市场事实

跑一下投资雷达

→ 把外部变化映射到 Profile、持仓和关注

跑一下策略分析

→ 状态机 + 雷达双输入，按需进入分析路由

检查一下持仓

→ 扫账户敞口、盈亏、失效信号与结构告警

内核配置与进化

帮我做一次投资诊断

→ 只诊断策略结构，不设参数、不选流派

配置一下我的内核

→ 逐题访谈 → 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 的兼容投影视图
│   ├── 持仓_状态机.md
│   └── Watchlist_状态机.md
├── Agents/                      # 跨层角色、顺序与写回权限
├── BrainStorm/                  # 长期投资思考、历史日志、复盘与进化语料
├── Console/                     # Reader + 操盘层两个决策台
├── ARCHITECTURE.md              # 三层定义与归层规则
├── AGENT_GUIDE.md               # Agent 权限与读取顺序
├── 总入口暗号.md                # 所有自然语言入口
├── 进阶指南.md                  # 补投研、装内核、调操盘、按证据进化
└── CHANGELOG.md                 # 版本历史