进阶配置

投研层的数据源升级与日常调度：补你真正需要的信息，让系统的”眼睛”看得更远。

数据源分级：先解决问题，再加 Key

统一配置方式：

cp .env.example .env

然后只填写需要的字段。脚本会从 YMOS 根目录自动读取 .env，不需要安装 python-dotenv。

Level 0：RSS + Yahoo Finance，先验证最小闭环

不申请任何账户即可使用：fetch_rss.py 拉取公开 RSS，供市场洞察做事件归纳；fetch_price_router.py 在没有专用 Key 时回退 Yahoo Finance。市场洞察、投资雷达、Reader、Strategy Profile 和 BrainStorm 都不依赖付费数据源。

python3 Eyes/scripts/fetch_rss.py 1 –output /tmp/ymos_rss.json
python3 Eyes/scripts/fetch_price_router.py \
  –symbols “AAPL,000001.SZ,0700.HK” \
  –output-dir /tmp/ymos_prices

Level 0 的限制也要接受：RSS 可能失效或延迟，Yahoo 是免费兜底，不应被当作交易所级实时行情。单个源失败时，报告应该留下错误和降级说明，而不是假装数据完整。

Level 1：Finnhub，美股 / Crypto 的报价和事件增强

1. 前往 finnhub.io 注册，在 Dashboard 复制 API Key
2. 在 .env 填写 FINNHUB_API_KEY=你的Key

python3 Eyes/scripts/fetch_price_router.py –symbols “AAPL,NVDA” –output-dir /tmp/ymos_finnhub
python3 Eyes/scripts/fetch_finnhub_news.py –hours 24 –output /tmp/ymos_finnhub_news.json

Level 1+：Tushare，补 A 股日线与最近交易日价格

Tushare 解决的是 A 股代码和日线稳定性问题，不是券商级实时行情。

1. 前往 tushare.pro 注册，在个人中心复制 Token（不同接口所需积分以官网当前规则为准）
2. 在 .env 填写 TUSHARE_TOKEN=你的Token

价格路由自动分流

.SS / .SZ → Tushare；无 Token 时回退 Yahoo
.HK       → Yahoo Finance
其他      → Finnhub；无 Key 时回退 Yahoo

Level 1++：问财数据层（可选 · Beta）

V4 起新增，让投研层从「只能取价格和新闻」变成「能做条件选股和事实检索」——研究触角变长了，但不替你改变判断规则。

它不是 YMOS 内置 Skill，需要两步：从同花顺问财官方 SkillHub安装对应 Skill，再配置 IWENCAI_API_KEY。推荐流程：

1. 登录 SkillHub，打开所需的官方 Skill
2. 在安装方式中选择 Agent 用户，把官方生成的安装 Prompt 交给你的 Agent
3. 按 SkillHub 当前说明获取 IWENCAI_API_KEY
4. 优先安装到 Agent 自己的标准 Skills 目录；装在其他位置时，把「包含各 Skill 文件夹的上级目录」写入 YMOS_SKILL_ROOT
5. 安装后同时确认宿主能识别 Skill、YMOS 能找到 scripts/cli.py——「文件夹存在」不等于安装完成

# .env
YMOS_SKILL_ROOT=/包含各个Skill文件夹的上级目录   # 不是 Key；已装在自动搜索目录时可留空
IWENCAI_API_KEY=你的问财服务Key
IWENCAI_BASE_URL=https://openapi.iwencai.com

# 自检：检查 YMOS 实际发现了哪些问财 Skills
python3 Eyes/scripts/skill_resolver.py

Level 2：Market Data API（yongmai.xyz）

这是作者自用的数据管道对 YMOS 提供的结构化入口。当前底层以 28 源处理管道为基础，对中英文市场信息做抓取、清洗、分类与去重，减少本地处理 RSS 的 Token 消耗和中文源维护成本。来源概览见 TIB RSS 信息源清单。

前往 yongmai.xyz 注册页注册或登录，在用户中心自助开通并生成专属 API Key：

YMOS_MARKET_API_URL=https://yongmai.xyz/wp-json/tib/v1/reports
YMOS_MARKET_API_KEY=你的key

# 测试
python3 Eyes/scripts/fetch_market_api.py 1 –output /tmp/ymos_market_data.json

自定义 RSS 与更多 API

默认 RSS 不够时，先复制补充配置，不要直接改公共源文件：

cp Eyes/scripts/rss_sources_custom.json.example \
   Eyes/scripts/rss_sources_custom.json

rss_sources_custom.json 已被 Git 忽略。市场洞察会把补充 RSS 与主数据源并行读取——无论主数据源是 API 还是默认 RSS，适合行业博客、公司工程博客或特定研究者。

如果要接新的金融 API，参考 fetch_finnhub_news.py 或 fetch_price_api.py：从 .env 读取凭据，输出带来源和时间的 JSON，在 SOP 里声明失败降级，再用正常、空结果和失败三个样本验证。

一个合格驱动的职责

只做四件事：取事实、记来源和时间、输出结构化结果、说明失败降级。建议输出：

{
  “schemaVersion”: 1,
  “source”: “provider-name”,
  “asOf”: “YYYY-MM-DD HH:mm”,
  “market”: “”,
  “symbols”: [],
  “facts”: [],
  “unresolved”: [],
  “errors”: []
}

配完之后怎么判断是否成功

不要只看「命令没有报错」。至少确认：

1. 输出文件真实存在且能解析
2. source、时间与市场字段正确
3. 空结果和接口失败会留下明确状态
4. 投资雷达实际读取了新数据，而不是仍在使用旧缓存
5. 删除或清空 Key 后，系统能按文档回退，而不是静默生成假报告

定时任务：写依赖，不抄时间表

暗号适合试跑和临时调用；定时任务让 YMOS 真正承担日常监测与重复劳动。公开版只定义顺序：

外部事实就绪 → 投资雷达映射 → 策略分析/持仓体检
  → Human 审阅 → 盘前计划 → 盘中执行与留痕

建议先启用两条投研主链跑两周；启用操盘层后，再增加平仓复盘：

内核周期审计建议月度或季度跑，不要每周——样本不足 10 笔时提案没有意义。What’s Hot 等作者扩展默认关闭，按需启用。一条调度至少写清：时区与触发条件、上游产物、读取范围、允许写入的路径、空数据与失败怎么处理、Human 要审阅什么。

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

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

数据新鲜度

Profile 里写明各类事实的有效期。Agent 不能把旧快照当实时行情用。需要精确金额、止损判断或再平衡时必须先刷新——过期就只提示刷新，不给动作结论。

模型选择

模型名称变化很快，不在文档写死。按任务风险分配即可：