Investment News

Investment News —— 本地投资资讯看板

一个自包含工具:fetch.py 抓源 → digest.py 用用户自己的大模型出「今日要点」+翻译 → index.html 看板呈现,server.py 提供刷新接口。

给 Agent 的操作指南

🔑 核心:这个工具的产物是一个【浏览器看板】(http://localhost:8793),不是终端输出、也不是 data.js 文件。 用户想"看资讯 / 看某赛道 / 更新看板"时,你的最终动作必须是 open http://localhost:8793 把网页打开,并明确告诉用户"看板在浏览器里,去看"。 ❌ 不要在终端里罗列/粘贴新闻内容(那不是这个工具的用法);❌ 不要跑完 fetch/digest 生成完 data.js 就当任务结束。没把用户导向那个网页 = 没完成。 看板里的「AI 今日要点 + 中文翻译 + 分赛道 + 跳转原文」才是价值所在,终端给不了。

1. 第一次用(setup)——必须先问用户用哪种大模型

打开 llm.config.json,两种 provider 二选一,主动问使用者:

• claude-cli(默认,推荐)：用本机 Claude Code 订阅,$0、零 key。前提:本机装了 Claude Code 且 claude login 过。仅本机可用。
• api：用 OpenAI 兼容 API key(DeepSeek/OpenAI/硅基/OpenRouter…),任意机器可用,按量付费。需在 llm.config.json 的 api.api_key 填 key。

确认后写进 llm.config.json。

2. 启动看板,并把网页打开(关键,别漏)

python3 server.py            # 默认端口 8793,保持运行
open http://localhost:8793   # 必做:把看板在浏览器打开(Win 用 start、Linux 用 xdg-open)

启动后一定要把 http://localhost:8793 在浏览器打开,并对用户说一句: 「投资资讯看板已在浏览器打开(http://localhost:8793)——左边 12 个赛道随便点,每栏顶部是 AI 今日要点,点 ↗ 跳原文,左上角 ⟳ 可刷新。」

3. 更新数据(两种方式等价)

• 看板里点左上角 ⟳ 刷新(后端会跑 fetch+digest,转圈等它)
• 或命令行：python3 scripts/fetch.py && python3 scripts/digest.py
  • fetch.py：抓 sources.json 全部源 → data.js(带红线过滤 + 最近 N 天)
  • digest.py：用 llm.config.json 配的模型,给每个赛道出 3–5 条中文要点 + 翻译每条标题 → 写回 data.js

4. 加源 / 调参

• 加源:sources.json 的 sources 里加一行 { "name","hint"(赛道key),"type":"rss","url" }。
• 只看最近几天:改 sources.json 的 fetch.recent_days(默认 7)。
• 红线词:sources.json 的 redline_keywords(默认滤赌博/预测市场/加密/色情;时政/财经照收)。

注意

• 纯 Python 标准库,不用 pip 装任何东西。
• claude-cli 模式下 digest 会 spawn 本机 claude -p(订阅鉴权,--disallowedTools 全禁,只让它处理文本),只能在用户本机跑。
• 个别批次若被订阅模型安全策略拒答(如某些医疗内容),该赛道会优雅降级(只显示新闻列表,无要点);换 api 模式可避免。
• 本工具仅为资讯聚合,不构成投资建议。