FAQ
常见问题与常见陷阱。
常见问题
我第一次接触 YMOS，最快从哪里开始？
三步：① 下载项目到本地目录 → ② 告诉你的 AI Agent 请完整读取 [YMOS路径]/总入口暗号.md → ③ 说「开始使用」，完成最小入职后运行「跑一下市场洞察」和「跑一下投资雷达」。
先把投研层跑起来，不需要第一天就填满 Strategy Profile，也不需要先使用交易计划台。推荐路径是：投研层 → 策略内核层 → 操盘层 → 反馈进化。Profile 仍为 draft 时，市场洞察、投资雷达和事实调研照常运行；只有买卖、持有、加仓、退出等动作级结论会被 kernel_not_ready 门禁拦住。
三层都必须启用吗？
不必须。只使用投研层，YMOS 就是一套能持续生成市场洞察和投资雷达的本地投研系统；你也可以在不启用操盘台的情况下，用旧日志、诊断和 BrainStorm 梳理策略内核。交易计划台与买卖决策台是按需增加的操盘层。
为什么没有一个开箱即用的通用策略 Profile？
因为仓位、止损、期限、证据优先级和退出裁判不存在跨用户通用答案。预置一份 active Demo 会减少表面报错，却等于在用户不知情时替他选择策略。
V4 的处理是：公共模板只预置 draft、Human 确认和决策执行分离等安全结构；投研层立即可用。第一次提出动作级问题时，Agent 会把 kernel_not_ready 解释为「尚未完成个人配置」，并询问是否现在进入快速入职，而不是只返回错误。
已经有 V1 / V2 / V3，怎么升级？
不要把 V4 直接覆盖到旧目录。先完整备份，再把 V4 放在独立目录运行；V3 用户按仓库里的 UPGRADE.md 迁移持仓、Watchlist、自定义 P / SOP、旧日志、BrainStorm 和定时任务。
V4 没有推翻 V3 的市场洞察与投资雷达主链。升级的重点是把散落的个人策略收拢成 Strategy Profile，再按需要接上 Reader、操盘台和证据反馈闭环。完成验收前，不要让两个目录同时写入真实数据。
需要会写代码吗？
不需要。日常操作由自然语言暗号和 Markdown SOP 驱动。最常见的技术操作只是复制 .env.example 为 .env、填写 API Key，以及运行 python3 Console/server.py；这些也可以交给能读写本地文件的 Agent 帮你完成。想增加数据源、改页面或写新脚本，会一点代码更方便，但这属于进阶改造，不是使用前提。
不配置 API Key 能不能用？
能。Level 0 使用 RSS + Yahoo Finance，就可以先跑市场洞察、价格兜底、投资雷达、Reader 和大部分分析链。API Key 是渐进增强：美股用户可以加 Finnhub，A 股用户可以加 Tushare；需要条件选股和结构化事实检索时再装问财 Skills；希望直接消费清洗后的市场事件时再配置 Market Data API。详见 进阶配置。
支持哪些市场？
- 美股 / Crypto：Finnhub 增强，Yahoo Finance 兜底
- A 股：Tushare 提供日线与最近交易日价格，Yahoo Finance 兜底；问财是可选的条件选股与事实数据层
- 港股：Yahoo Finance 提供基础价格路径；问财官方港股 Skill 可由 Agent 单独调用，但公开版暂未提供港股 What’s Hot 自动链
- 其他市场：框架本身不锁市场，可以按
Eyes/scripts/的统一输出契约接入新数据源
Ticker、接口覆盖和数据时效由外部服务决定。YMOS 负责路由、降级和留痕，不把任一免费数据源包装成交易所级行情。
AI 会不会替我做投资或交易决策？
不会。YMOS 坚持 Human in the Loop：AI 可以收集信息、做结构化分析、指出矛盾、提出候选方案并在门禁处提醒，但不能替你设置个人参数、批准内核变更或执行真实交易。P12 或 Console 门禁「通过」也不等于系统替你背书；最终判断、下单和结果责任始终属于 Human。
推荐用什么 Agent？作者自己怎么运行？
YMOS 不绑定某一家模型或 Agent。最低要求是：能读取和写入本地文件，并能运行 Python 脚本。实际使用可以分成两类：
- Agent 运行统筹：负责长期记忆、角色编排、定时任务和任务串联，建议只选一个。作者目前使用 Hermes 作为 YMOS 的统筹层；OpenClaw 同样可以完整运行 YMOS，包括自然语言暗号、Python 脚本、角色任务与定时调度
- 具体任务执行：Claude Code、Codex、OpenClaw 或其他顺手的 Agent 都可以按单次任务参与；完成后把产出写回 YMOS 的 Markdown 真相源即可
关键不是选哪家，而是只保留一套连续的统筹状态与文件真相源。详见 扩展与生态。
报告在哪里看？必须使用 Obsidian 吗？
报告按日期保存在 Eyes/、Brain/ 和持仓目录中，也可以启动 Console 后从 http://localhost:5273/reader 集中阅读。
Obsidian 不是运行依赖，只是很适合阅读本地 Markdown。它默认不显示 .py、.json 和 .env 等代码文件，这是正常的；需要编辑这些文件时，用任意 IDE（如 VS Code）或让 Agent 处理即可。
P 系列、SOP、定时任务和前端可以改吗？
可以，而且这正是 V4 的设计目标。Brain/references/ 是判断工具样板，SOP 是工作流程，Agents/SCHEDULES_REFERENCE.md 是调度参考，Console 三页是作者打样。
修改时只守住两条边界：不要把作者的个人参数当公共答案；不要让前端、P 文件和 Profile 各自长出互相冲突的规则。
应该选择什么模型？
尽量给策略诊断、深度调研和内核审计使用你当前能稳定获得的强模型；新闻拉取、格式转换、文件归档等机械任务可以使用更轻的模型。具体型号变化很快，YMOS 不写死模型名。模型再强也不能替代证据边界：事实要有来源，规则要可证伪，变更要由 Human 审批。
数据都在本地吗？Key 安全吗？
YMOS 的报告、状态机、计划和审计记录默认保存在本地 Markdown，不使用 YMOS 自建云端数据库。但只要启用云端 Agent、网页搜索或外部 API，查询内容会受对应服务商的隐私政策约束。
真实 Key 只放本地 .env 或 Agent 宿主的 Secret 管理中，不要写进 Markdown、SOP、脚本、定时任务提示词、聊天记录或 Git。公开仓库只保留 .env.example 的空字段。
常见陷阱
以下是 Agent 和用户在使用过程中最容易踩的坑。
| # | 陷阱 | 正确做法 |
|---|---|---|
| 1 | Day 0 就想把 Profile 填满 | 写不出来的字段留空；先跑投研层，有了真实困惑再配内核 |
| 2 | 让 Agent 从作者案例或「常识」补参数 | 所有数值由你填；缺参数就返回 data_incomplete |
| 3 | 把市场洞察当投资雷达 | 洞察不看持仓，雷达才映射到你的持仓、关注与 Profile |
| 4 | 把「建仓」暗号当成真实成交 | 建仓只建候选；Console 确认成交后才进入真实持仓 |
| 5 | Agent 代写「已执行」「已成交」 | 真实执行证据必须由 Human 操作产生 |
| 6 | 亏了一笔就改规则 | 单笔结果不改内核；结果验证型提案建议至少 10 笔归档证据 |
| 7 | 把脱敏示例当真实数据 | 带 ymos_sample: true 的文件不进复盘和真实统计 |
| 8 | 同时维护 Profile 和一套跟它矛盾的 rules.json | rules.json 只是投影；冲突时以 Human 确认的 Profile 为准 |
| 9 | 个股分析只读一个文件 | 个股文件夹下所有文件都是上下文 |
| 10 | 把所有 SOP 都做成每日定时任务 | 健康配置长期启用 4–6 个；先手动跑通再进调度 |
Agent 执行态度
这不仅是给 Agent 的要求，也是判断 AI 是否正确执行 YMOS 的标准。
- 不偷懒：按 SOP 定义的完整流程走完每一步，不因为「数据看起来够了」就跳过后续环节
- 不静默失败：某个步骤出错时，把错误信息和上下文清晰地展示给用户，而不是吞掉错误继续跑
- 不自作主张：遇到 SOP 没覆盖的边界情况，暂停并询问用户，而不是猜测用户意图
- 不越权：不是自己角色的写入目标，只提建议，不动手
- 养系统的心态：SOP 不是一成不变的。执行过程中发现可优化的环节，如实记录，帮助用户持续迭代