Skip to main content

QuotaFuse Wire · 资讯线报

为 A股投资者打造的全球产业链资讯看板
12 大赛道 · 100+ 全球信源 · 每日中文「今日要点」 · 数据不出本机

version python license topics sources fetch local llm


核心能力 · 快速开始 · CLI · MCP · Agent Skill · 文档


QuotaFuse Wire 是为 A股投资者打造的全球产业链资讯看板。半导体、AI、机器人、新能源车、航天…… 12 大赛道,对应 A股投资者最关心的板块;而真正驱动板块的领先信号,往往先出现在全球英文信源里。Wire 覆盖 100+ 个公开信源,调用你自己的大模型,把各赛道每日最新动向提炼为中文「今日要点」并完成翻译,统一呈现在一个本地浏览器看板里。

它区别于信息过载的新闻聚合器,核心在于由 AI 完成阅读与提炼:每个赛道置顶当日「今日要点」,跨源聚合、同一事件去重,并能下钻到原文核实。采集、存储与看板全部跑在本机(Python + SQLite,无前端构建链),AI 使用你自己的 Claude 订阅($0)或任意 OpenAI 兼容 API,无需账号、无托管依赖。

适用场景

  • 跟踪半导体、AI、新能源车、机器人等板块的全球先行信号,但海外资讯多为英文、且分散在上百个信源——Wire 把它们汇成一屏中文要点。
  • 同时跟踪多个投资赛道,但资讯庞杂、难以尽读,且多为英文。
  • 门户与聚合器提供的是离散信息流;真正需要的是「该赛道当日发生了什么核心进展」——这正是 AI 要点层要解决的问题。

边界:Wire 呈现的是行业动向与领先信号,并非行情数据,更不构成投资建议。Industry trends, not financial advice.

核心能力

能力 说明
模块化内核 src/qf_wire/ 分层:core / sources / pipeline / digest / render / cli / mcp / web / provider / storage / config,各层可独立替换与测试
并发采集 asyncio + aiohttp 并发拉取 100+ 信源;本地 106 源实测 21.4s → 1.0s(并发 24),并发度可用 QF_WIRE_FETCH_CONCURRENCY 调整
单源容错 每个信源独立超时、重试与降级标记;任一源失效只降级该源,整轮采集继续
配置化赛道与信源 config/topics.yaml / config/sources.yaml 定义 12 大赛道与 100+ 信源,增删赛道或 RSS 源无需改代码
按赛道提炼 config/digest.yaml 为每个赛道配置 prompt、模型与输出结构,提炼规则可演进
结构化输出 统一 WireEnvelope 契约,附 source / freshness / confidence / source_status 溯源字段;同时生成看板用的 data.js
历史归档 本地 SQLite + 按日期归档,支持历史回溯与增量对比
事件聚合 标题相似度 + 实体提取聚类,同一事件多源折叠为“多源 N”,并生成事件时间线
信源质量 按准确率、时效性、重复率对信源评分,权重参与要点排序与可信度标注
本地看板 qfw serve 一键启动,默认仅本机监听
生态接入 4 个 MCP 工具,Claude Desktop / Cursor 等任意 MCP 客户端可直接消费
部署 本机 Python 直接运行,或 Docker Compose 一键部署(M4)

设计原则:自包含、本地优先、零强制 API key。代码分层但不引入重型中间件,采集与分析全部在本机完成,数据不出本机。

架构

┌─────────────────────────────────────────────────────┐
│ 调用层:CLI(qfw) │ 本地看板 │ MCP Server      │
└─────────────────────────────────────────────────────┘
                          │
┌─────────────────────────────────────────────────────┐
│ QuotaFuse Wire 核心                                  │
│ 采集调度 │ 清洗去重 │ 事件聚类 │ AI 提炼 │ 信源评分  │
│ 配置化赛道 │ 历史归档 │ 结构化输出                    │
└─────────────────────────────────────────────────────┘
                          │
┌─────────────────────────────────────────────────────┐
│ 数据层                                               │
│ 本地 SQLite / Parquet 归档 │ data.js 兼容输出         │
│ 可选:本地文档 / 外部 RSS                            │
└─────────────────────────────────────────────────────┘

快速开始

要求:Python 3.10+,无需任何托管服务;提炼可选本机 Claude 订阅或任意 OpenAI 兼容 API。

git clone https://github.com/QuotaFuse-ai/quotafuse-wire.git
cd quotafuse-wire
python -m pip install -e .

# 全量采集 + 提炼 + 输出
qfw run

# 启动本地看板(默认 http://127.0.0.1:8790)
qfw serve

打开看板后,在左侧「AI 与生成」里填写接口地址、模型名和 API Key,保存后点「生成今日要点」即可,不用改配置文件,也不用另开终端。配置只保存在本机 .env.local(已被 git 忽略),页面不会回显密钥明文。

喜欢命令行的也可以直接配环境变量或 config/digest.yaml,再运行 qfw digest,效果相同。

Docker Compose(可选)

本机没有 Python 环境时,可直接用容器运行;数据仍落在宿主目录,不进入镜像。

git clone https://github.com/QuotaFuse-ai/quotafuse-wire.git
cd quotafuse-wire
cp .env.example .env            # 可选:设置 QF_WIRE_API_TOKEN 等
docker compose up -d --build
docker compose logs -f wire
curl http://127.0.0.1:8790/api/health
  • 打开 http://127.0.0.1:8790。宿主只发布回环地址 127.0.0.1:8790,外部无法直接访问。
  • ./data 挂载到 /data,./config 挂载到 /app/config;镜像只含默认配置模板,不含用户数据与密钥。
  • 容器同时运行定时任务(qfw serve --with-scheduler),任务由 config/schedule.yaml 控制。
  • 停止:docker compose down(保留数据)。完整参数、备份与清理见 docs/DEPLOYMENT.md。

为便于已有部署平滑过渡,根目录保留同名脚本入口,统一委托新内核:

python fetch.py          # 等价于 qfw run --sources-only
python digest.py         # 对当日数据重新提炼
python server.py         # 启动旧版看板入口(8793)

首次启动会自动检测早期版本的配置文件(llm.config.json、sources.json),迁移到 config/ 并把旧文件保留为只读。

CLI

# 采集与提炼
qfw run                          # 全量采集 + 提炼 + 输出
qfw run --topic semiconductor    # 只跑指定赛道(别名 semi 也可)
qfw run --sources-only           # 只采集不提炼
qfw digest --date 2026-10-22     # 对指定日期数据重新提炼

# 看板
qfw serve --port 8790            # 启动本地看板
qfw serve --user alice           # 多用户:只服务 alice(需 QF_WIRE_MULTIUSER=true)
qfw serve --with-scheduler       # 看板 + 定时任务同进程

# 多用户凭据(一个实例服务多个用户时)
qfw token --user alice           # 生成/查看 alice 的 API 凭据
qfw token --user alice --rotate  # 轮换,旧凭据立即失效

# 定时调度
qfw schedule --dry-run           # 查看 schedule.yaml 的任务表
qfw schedule --once              # 立即执行一轮启用的任务
qfw schedule                     # 常驻调度(Ctrl+C 退出)

# 信源与赛道
qfw sources list
qfw sources validate
qfw topics list
qfw topics add --file topics.yaml

# 历史与事件
qfw history --topic semiconductor --days 7
qfw event show <event_id>
qfw event timeline <event_id>

# MCP
qfw mcp stdio
qfw mcp http --port 8791

# 配置
qfw config validate
qfw config migrate               # 迁移早期版本的配置文件

输出约定:

  • 结构化结果写 stdout,日志写 stderr;
  • 支持 --output json|table|csv;
  • 退出码:0 成功、2 参数错误、3 配置错误、4 源不可用、6 对象不存在(如事件 id)、8 部分源失败;
  • qfw mcp stdio 的 stdout 只输出 MCP 协议报文。

配置

文件 用途
config/topics.yaml 赛道定义:id、名称、关键词、关联信源、别名
config/sources.yaml 信源清单:id、类型、URL、超时、重试、权重
config/digest.yaml 提炼策略:默认模型、按赛道的 prompt 与输出结构
config/schedule.yaml 定时任务(M4)

校验命令:qfw config validate;JSON Schema 位于 config/schema/。

数据契约

所有结构化产出统一为 WireEnvelope,附溯源字段,便于下游按统一契约消费:

class WireEnvelope(BaseModel):
    domain: str          # news / policy / industry
    topic: str
    event_id: str | None
    data_as_of: date
    payload: dict        # 要点、多源列表、时间线
    source: str          # wire
    source_detail: str   # 原始信源列表
    fetched_at: datetime
    freshness: str       # realtime / cached / archive
    confidence: str      # high / medium / low
    source_status: str   # ok / degraded / partial

看板消费 data.js(window.DATA),字段保持旧版结构,仅为新增能力追加字段。

MCP 工具

工具 说明
wire_get_digest(topic, date) 获取某赛道某日要点
wire_search_events(keyword, window, topic) 查询事件的多源报道
wire_get_timeline(event_id) 获取事件时间线
wire_list_sources(topic) 列出信源与质量评分

作为 Agent Skill 使用

skills/quotafuse-wire/ 是一份可直接挂载到支持 Skill 的 Agent 上的技能包,让 Agent 知道何时取资讯、按什么顺序取、如何标注可信度,而不是自由发挥。

skills/quotafuse-wire/
├── SKILL.md                    # YAML frontmatter(name / description)+ 操作 SOP
├── references/digest-format.md # WireEnvelope 与日报字段、枚举、最小示例
└── examples/read-daily-brief.md# CLI 与 MCP 两条路径的端到端示例

挂载方式按宿主而定,常见两种:

  • 目录挂载:把 skills/quotafuse-wire/ 复制或软链到宿主的技能目录(如 ~/.claude/skills/、项目的 .agent/skills/),宿主按 SKILL.md 的 description 决定何时加载。
  • 仓库内引用:Agent 直接读取仓库中的 skills/quotafuse-wire/SKILL.md,按其 SOP 调用 MCP 工具或 qfw 命令。

无论哪种方式,运行前提都一样:本机已安装 qfw、已有归档,并配置 qfw mcp stdio(或 qfw mcp http --port 8791)。技能只做资讯解释,不输出买卖建议。

里程碑

M1–M4 均已实现;下表为各里程碑的内容与验收标准。

里程碑 内容 验收
M1 工程健壮性 模块化重组;采集超时/重试/降级;SQLite 归档;配置化赛道与源;旧入口兼容 单源失败不拖垮全局;历史可查;旧用法可用
M2 采集与分析深度 asyncio 并发;事件聚类与时间线;信源评分;可配置提炼策略 采集提速;多源聚合可见;评分展示
M3 生态接入 Provider 接口;模型网关复用;MCP 工具;结构化输出 任意 MCP 客户端可调用;源列表一致
M4 产品化 Docker Compose;只读 API;多用户隔离;定时调度 一键部署;API 本机监听;多用户隔离

目录结构

quotafuse-wire/
├── pyproject.toml
├── README.md
├── config/        # topics / sources / digest / schedule + schema
├── prompts/       # 提炼 Prompt 模板
├── docs/          # 架构、配置、信源、MCP、Provider、迁移、部署
├── src/qf_wire/   # core / sources / pipeline / digest / render / cli / mcp / web / provider / storage / config
├── compatibility/ # 旧版脚本入口兼容层
├── skills/        # Agent Skill:quotafuse-wire
├── data/          # 运行数据(gitignore)
├── tests/         # unit / integration / contract / compat
└── scripts/       # 信源校验、导出、迁移

文档

边界

  • 不输出交易信号或买卖建议;
  • 不采集行情、财报、公告、资金数据;
  • 不强制托管、不要求云端账户;
  • 默认仅本机监听,敏感配置脱敏。

License

MIT

Metadata

Release files for quota-fuse-wire 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for quota-fuse-wire 0.1.1
File Size Uploaded Provenance Actions
quota_fuse_wire-0.1.1.tar.gz 118.9 kB Without provenance Details for quota_fuse_wire-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for quota-fuse-wire 0.1.1
File Interpreter ABI Platform Actions
quota_fuse_wire-0.1.1-py3-none-any.whl Python 3 none any Details for quota_fuse_wire-0.1.1-py3-none-any.whl

Total release size: 260.6 kB

Release files / quota_fuse_wire-0.1.1.tar.gz

Download URL quota_fuse_wire-0.1.1.tar.gz
Size 118.9 kB
Tags Source
SHA-256 checksum
How to use checksums
8ca959a8b2e64b63fcc3402265c2192634a14339616d7b8d5372dbea80574f55
BLAKE2b-256 checksum
How to use checksums
aacd8a99de109ac80b898b00215dc12b30c603367bd5880437fd8bff37d4c090
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Release files / quota_fuse_wire-0.1.1-py3-none-any.whl

Download URL quota_fuse_wire-0.1.1-py3-none-any.whl
Size 141.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
146b9b2c224ef1a318b81d8e9ad6f412d12b8912e43022c4ccfa4c946d2d4181
BLAKE2b-256 checksum
How to use checksums
5876e6cedca321e3523883e8e2de091becd39f949e99b1496eaa7b9968e93043
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Security for quota-fuse-wire 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page