FAQ
常见问题与常见陷阱。
常见问题
已经有 V1 了，怎么最快用上 V3？
把旧的 YMOS 文件夹重命名为 YMOS-V1（保留备份），然后从 GitHub 下载 V3（下载后的文件夹本身就叫 YMOS，不需要手动新建），放到你的本地目录里，跑一遍入职引导（开始使用）即可。V3 完全取代 V1，不需要迁移数据——你在 V1 里的研报和笔记可以手动拖入 V3 的个股文件夹。
需要会写代码吗？
不需要。所有操作通过自然语言暗号触发，配置通过 Markdown 文件修改。唯一可能需要终端操作的是配置 .env 环境变量（填 API Key），但这也不是必须的——零配置就能跑通最小闭环。
支持哪些市场？
美股、A 股、Crypto 都支持。价格路由器会根据 ticker 格式自动判断走 Finnhub（美股/Crypto）、Tushare（A股）还是 Yahoo Finance（兜底）。板块关联逻辑支持跨市场映射（如”英伟达财报 → A股光模块”）。
AI 会不会替我做交易决策？
不会。YMOS 严格遵循 Human in the Loop 原则。所有策略建议都要经过 P12 纪律审查，审查结果只是”建议”——最终按不按按钮、下不下单，永远是你自己的事。
P 系列提示词能改吗？
能，而且鼓励你改。Brain/references/ 下的 P1-P16 是框架样板，你可以根据自己的投资风格调整权重、修改红线规则、增加行业特定指标。让系统的大脑越来越像你自己的投资直觉，才是最核心的进阶。
推荐用什么 Agent 工具来运行 YMOS？
YMOS 可以在任何支持文件读写和代码执行的 AI Agent 环境中运行：
- 首选（本地方案）：OpenClaw（龙虾）—— 本地运行、数据不出本机、支持定时任务和 subagent 编排
- 订阅会员方案：Claude Code / Claude Cowork、ChatGPT Codex —— 都支持文件系统操作和定时任务
- 其他支持的环境：任何能读写 Markdown 文件 + 运行 Python 脚本的 AI Agent 平台
核心要求只有两个：能读写本地文件 + 能运行 Python 脚本。满足这两点，YMOS 就能跑。详细对比见 扩展与生态。
怎么最快开始使用？
三步：① 下载项目放到本地目录 → ② 告诉你的 AI Agent 请读取 [YMOS路径]/总入口暗号.md → ③ 说「开始使用」，Agent 会引导你走完入职流程（设置投资偏好、初始化持仓）。入职完成后，说「跑一下市场洞察」就能看到第一份报告。
不想自己折腾配置，有没有省事的方式？
有。部署咨询服务（¥1000）包含 Market Data API 一年使用权 + 30 分钟 1v1 语音远程部署 + 7 天微信答疑。帮你配好环境、接好 API、设好定时任务、跑通第一轮完整闭环。前提是你已经有了可用的 Agent 工具（Claude Code / ChatGPT Codex 等）。
报告在哪里看？
所有报告都是 Markdown 文件，按日期归档在本地目录里：
- 市场洞察：
Eyes/市场洞察/YYYY-MM/ - 投资雷达：
Eyes/投资雷达/YYYY-MM/ - 策略分析：
Brain/策略分析/YYYY-MM/ - 持仓备忘录视图：
持仓与关注/持仓备忘录_视图.md - 可视化 Dashboard：
持仓与关注/dashboard/YYYY-MM/（HTML 文件，浏览器打开）
推荐用 Obsidian 日常浏览——它是本地存储的 Markdown 笔记工具，阅读报告和管理知识库很方便。
模型选择有什么建议？
永远尽可能选当下最强的模型。 YMOS 的核心价值在 SOP + P 系列提示词的分析质量，这完全取决于底层模型的能力。作者建议（2026 年 3 月）：优先使用 Claude Opus 4.6 或 ChatGPT-5.4。如果资源有限，优先把最好的模型用在策略分析环节（Brain 模块的 P5/P6/P8/P9/P12），市场洞察和投资雷达可以用稍弱的模型，但策略分析和纪律审查一定要用最强的。
数据安全呢？所有数据都在本地吗？
是的。所有产出物都是 Markdown 文件，存在你自己的本地目录里。没有云端数据库、没有 SaaS 依赖、没有数据上传。你的投资数据完全由你掌控。
必须用 Obsidian 吗？
不是必须的。YMOS 运行时不依赖 Obsidian 软件——它只需要一个本地文件目录。你可以把 YMOS 文件夹放在任何你觉得方便的位置。但我们推荐搭配 Obsidian 使用：它是一个本地存储的 Markdown 笔记工具，用来日常阅读报告、浏览个股知识库、管理整个文档体系非常方便，而且同样是本地存储，跟 YMOS 的数据安全理念一致。
用 Obsidian 打开项目后，看不到 Python 脚本文件？
这是正常的。Obsidian 是 Markdown 笔记工具，默认只显示它能渲染的文件类型（.md、图片等），不会显示 .py、.json、.env 等代码文件。但这些文件确实存在于项目目录中——你的 AI Agent 可以正常读取和执行它们，不影响 YMOS 的任何功能。
如果你需要查看或编辑代码文件（比如配置 .env、查看脚本逻辑），可以用以下任一 IDE 工具打开 YMOS 文件夹：
- VS Code — 微软出品，免费，最主流的代码编辑器
- Trae — 字节跳动出品，免费，内置 AI 编程助手
- Google Antigravity — Google 出品，免费，内置 Gemini AI
用 IDE 打开同一个 YMOS 文件夹，你就能看到完整的项目结构，包括 Eyes/scripts/ 下的所有 Python 脚本。日常使用推荐 Obsidian 看报告 + IDE 看代码，各司其职。
常见陷阱
以下是 Agent 和用户在使用过程中最容易踩的坑。
| # | 陷阱 | 正确做法 |
|---|---|---|
| 1 | 给报告加 _v2/_v3 后缀 | 同日覆盖，不加后缀 |
| 2 | 跳过 P2 就进 P5/P6 | 必须先知道现在在哪个阶段 |
| 3 | 没有 P12 就给买卖建议 | 纪律审查是最终关卡 |
| 4 | 因前置缺失就完全不跑 | 能跑的先跑，缺啥补啥 |
| 5 | 把市场洞察当投资雷达 | 洞察不看持仓，雷达才看持仓 |
| 6 | 直接给买/卖建议 | 只建议路由暗号，策略分析 SOP 负责结论 |
| 7 | 个股分析只读一个文件 | 个股文件夹下所有文件都是上下文 |
| 8 | 跳过投资偏好文件 | 当前关注方向与投资偏好.md 是策略分析的必要输入 |
Agent 执行态度
这不仅是给 Agent 的要求，也是判断 AI 是否正确执行 YMOS 的标准。
- 不偷懒：按 SOP 定义的完整 Pipeline 走完每一步，不因为”数据看起来够了”就跳过后续分析环节
- 不静默失败：某个步骤出错时，把错误信息和上下文清晰地展示给用户，而不是吞掉错误继续跑
- 不自作主张：遇到 SOP 没覆盖的边界情况，暂停并询问用户，而不是猜测用户意图
- 养系统的心态：SOP 不是一成不变的。执行过程中发现可优化的环节，在报告末尾如实记录，帮助用户持续迭代