早盘多维扫描 — Morning Briefing v2.2
📌 零依赖纯标准库,开箱即用。neodata Token 不可用时自动回退新浪财经免费API。
快速开始
python morning_briefing.py scan --fallback # 立刻开始(无需Token)
python morning_briefing.py scan --fallback --html # 同时生成HTML报告
python morning_briefing.py me # 连通性自检 + Token获取引导
python morning_briefing.py faq # 常见问题解答
python morning_briefing.py dashboard # 历史扫描可视化面板
python morning_briefing.py scan # 全量扫描(有Token时优先neodata)
python morning_briefing.py report --in result.json # 从JSON生成HTML
功能一览
| 功能 | 命令 | 说明 |
|:--|:--|:--|
| 数据拉取 | scan | neodata通道8路 / 免费API通道6路并行,进度播报,stdout结构化JSON |
| HTML报告 | report / scan --html | 深色研报风自包含HTML(离线可打开) |
| 连通性自检 | me | Token状态 + 免费API检测 + Token获取引导 |
| 常见问题 | faq | 10条FAQ + 反模式速查 + 错误解决指南 |
| 可视化面板 | dashboard | 历史扫描统计 + 成功率趋势 + 错误日志 |
| 运行日志 | 自动 | 每次运行自动写入 .morning_briefing_log.jsonl |
🚀 无需Token即可运行
本 Skill 设计为零门槛开箱即用。即使没有 neodata Token,scan --fallback 能通过新浪财经免费API拉取:
✅ 美股三大指数(道琼斯/纳斯达克/标普500) ✅ 伦敦金/银 + COMEX黄金/白银期货 ✅ WTI原油实时价格 ✅ VIX恐慌指数(交易时段) ✅ 美元指数 DXY(交易时段)
💡 如何获取 neodata Token(可选)
Token 非必需,但获得后可使用8路完整查询(含宏观/新闻/北向资金等):
方法1(推荐): 在 WorkBuddy 中使用 neodata-financial-search skill 查询一次金融数据。
系统自动缓存 Token 到 ~/.workbuddy/skills/.neodata_token。
方法2: 设置环境变量 export NEODATA_TOKEN="your_token"。
方法3: 手动写入 config.json,加入 "neodata_token": "your_token"。
📌 Token 有效期12小时,过期后自动回退免费API,不影响使用。
8路数据源
| # | 查询内容 | neodata | 免费API回退 | |---|---------|---------|------------| | 1 | 美股三大指数 | ✅ | ✅ 新浪财经 | | 2 | 贵金属(XAU/XAG/GC/SI) | ✅ | ✅ 新浪财经 | | 3 | 美国宏观(CPI/利率) | ✅ | ⚠️ 需neodata | | 4 | 国际新闻 | ✅ | ⚠️ 需neodata | | 5 | VIX恐慌指数 | ✅ | ✅ 新浪财经 | | 6 | A股热点/北向资金 | ✅ | ⚠️ 需neodata | | 7 | 黄金新闻/ETF | ✅ | ⚠️ 需neodata | | 8 | 美股板块 | ✅ | ⚠️ 需neodata |
免费API至少4路可用。≥3路成功即生成报告。
报告结构
- 免责横幅(黄色醒目)
- 今日要点 — 美股/黄金/VIX/美元 四要素摘要卡片
- 美股三大指数 — 3列卡片 + 红涨绿跌
- 贵金属行情 — 4列卡片(XAU/XAG/GC/SI)
- 风险情绪 & 汇率 — VIX + 美元 + 原油 三列
- 市场新闻 — neodata频道新闻摘要(需neodata通道)
- 黄金动态 — 黄金相关新闻(需neodata通道)
- A股影响 — 美股传导 + 黄金信号 + 板块速查
第6、7项在免费API模式下不显示(需要neodata通道获取新闻内容)。
可视化面板
python morning_briefing.py dashboard
生成包含以下内容的仪表板HTML:
- 总扫描次数 / 平均成功路数 / 错误计数
- 最近20次扫描明细表(日期/数据源/成功路数/时间)
- 数据源使用分布(neodata vs 免费API 占比)
- 最近5条错误日志(如有)
错误码速查
| 错误码 | 含义 | 解决 |
|:--|:--|:--|
| exit 2 | 文件不存在 | 先运行 scan 产出JSON,再 report |
| exit 4 | 数据不足(<3/8路成功) | 检查网络,稍后重试 |
| exit 5 | 日志解析失败 | 删除 .morning_briefing_log.jsonl 重建 |
| exit 0 | 无扫描记录 | 先运行 scan 产生日志 |
Token 不可用时自动回退免费API,不会触发 exit 3。
🛑 反模式速查
| ❌ 不要 | ✅ 应该 |
|:--|:--|
| 不设 --fallback | Token不可用自动回退,或用 --fallback 强制免费模式 |
| 忽略 stderr 输出 | 进度播报和错误提示在 stderr,stdout 只有JSON |
| 假设 scan 生成HTML | 显式 report 或加 --html 参数 |
| 重复创建同日报告 | 会覆盖已有文件,这是设计意图 |
| 硬编码日期 | 使用 --date 参数或自动取今天 |
配置
| 环境变量 | 用途 | 默认值 | |:--|:--|:--| | NEODATA_TOKEN | neodata Token | 自动从缓存/文件加载 | | MORNING_BRIEFING_OUTPUT_DIR | 输出目录 | 当前工作目录 |
输出产物
| 产物 | 路径 | 何时生成 |
|------|------|---------|
| 原始数据JSON | {cwd}/{DATE}_morning_briefing_raw.json | scan ≥3路成功 |
| HTML报告 | {cwd}/{DATE}_morning_briefing_raw.html | report / scan --html |
| 可视化面板 | {cwd}/morning_briefing_dashboard.html | dashboard 子命令 |
| 运行日志 | .morning_briefing_log.jsonl | 每次运行自动追加 |
版本历史
| 版本 | 日期 | 变更 | |------|------|------| | 2.2.0 | 2026-07-28 | 🔥 FAQ子命令 + 反模式速查 + Token获取引导 + 自动日志(.jsonl) + 可视化面板(dashboard) + scan --html 一步生成 | | 2.1.0 | 2026-07-28 | 双通道(neodata+免费API) + HTML自生成 + stdout结构化JSON | | 2.0.0 | 2026-07-25 | 工程化升级 | | 1.0.0 | 2026-07-17 | 初始版本 |
免责声明
本技能产出仅供市场热度追踪和投顾沟通参考,不作为投资建议。
微信扫一扫