FAQ
常见问题与常见陷阱。
常见问题
我第一次接触 YMOS，最快从哪里开始？
三步：① 下载项目到本地目录 → ② 告诉你的 AI Agent 请完整读取 [YMOS路径]/总入口暗号.md → ③ 说「开始使用」，让 Agent 直接用 Level 0 通用事实基线运行「跑一下市场洞察」和「跑一下投资雷达」。首跑不要求 Profile、持仓或 Watchlist。
先把投研层跑起来，不需要第一天就填满 Strategy Profile，也不需要先使用交易计划台。推荐路径是：投研层 → 策略内核层 → 操盘层 → 反馈进化。投研层可用 当前关注方向与投资偏好.md 维护最近研究主题，但不读 Profile；只有买卖、持有、加仓、退出等动作级结论才进入内核，Profile 缺失或未激活时由 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 的市场洞察、投资雷达和当前关注文件。升级时原样保留 持仓与关注/当前关注方向与投资偏好.md 的高频用法：当前主题、事件与映射继续留在这里；只把入场、失效、风险、期限与动作门禁整理成独立 Strategy Profile。两者不投影、不互相覆盖。完成验收前，不要让两个目录同时写入真实数据。
需要会写代码吗？
完全不需要。特别是在使用 桌面客户端 时，客户端自带内置服务器、可视化数据源配置和一键初始化，不用装 Python、不用敲命令行、也不用写代码。日常投研由自然语言暗号和 Markdown SOP 驱动，直接在你惯用的 Agent 里对话即可。
桌面客户端和 GitHub 开源框架到底选哪个？
两者读写的是同一套文件夹资产，不存在版本割裂：
- 桌面客户端：给想直接用起来、不想折腾环境的人准备的。内置服务器、可视化配置、一键绑定/增量补全框架、Reader 阅读器与操盘决策台全在里面。
- 开源框架：给想深度定制代码、跑自动化流水线的开发者准备的。
你可以随时在两者之间无缝切换——只需复制或绑定同一个工作区文件夹即可。
不配置 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 吗？
有三种最常见的方式：
- 桌面客户端 Reader（最推荐）：打开客户端左侧导航点击 Reader（或顶部「今日全览」），聚合全部市场洞察与雷达报告，支持 Markdown 渲染与代码高亮。
- 命令行 Console：启动服务后在浏览器打开
http://localhost:5273/reader。 - 本地文件查看器：报告按日期保存在
Eyes/、Brain/和持仓目录中，用 Obsidian 或 VS Code 直接打开文件夹也能阅读。Obsidian 不是运行依赖，只是适合阅读本地 Markdown。
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 | 把市场洞察当投资雷达 | 洞察建立市场事实；雷达汇总热门报告、持仓/Watchlist、价格与事件，当前方向只从轻量关注文件增强，不读 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 不是一成不变的。执行过程中发现可优化的环节，如实记录，帮助用户持续迭代