Vibe-Research · 个人 AI 投研系统
面向A股/美股/港股的个人投研Agent，聚合行情、研报、资金面等数据，并接入你自己的AI模型进行深度分析。
- Star 数
- ★ 2.7k
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 59/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 个人投资者每日复盘：通过“每日复盘”页面查看大盘、全球市场、短线情绪、板块资金，并一键让AI生成当日复盘。
- 不适合
- 不想自己配置 AI 模型或 API key 的用户
- 只想看买卖建议、希望产品直接荐股的用户
- 源码审查
- 59/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Vibe-Research 是一个开源的“个人AI投研看板”，主推A股，兼容美股和港股。它将行情、研报、估值、财务、公告、资金面、资讯等大量公开数据整合到一个干净的界面中，并提供多种方式接入用户自己的AI模型（订阅CLI、API key、MCP），让模型基于这些数据进行复盘、问答、多空辩论等分析。项目分为FastAPI后端（:8900）和React前端（:5899），内置A股数据引擎（a-stock-data v3.6.0）、全球股票数据（global-stock-data v2.0.3）和资讯雷达（investment-news），开箱即用。核心设计强调数据客观呈现，不推荐个股、不预测涨跌，所有分析结论由用户自己的AI给出。
Vibe-Research运行一个FastAPI后端（backend/，端口8900）和一个React前端（frontend/，端口5899）。后端通过astock.py、gstock.py、newsradar.py等模块提供A股、美股/港股数据以及资讯聚合，并实现工具层（tools.py）暴露23个数据工具。用户可通过三种方式接入AI：1) 订阅接入（cli_runtime.py）调用本机已登录的CLI（如Claude Code、Codex）使用用户订阅额度；2) API接入（chat.py）支持OpenAI兼容端点，实现function-calling自动调取数据工具；3) MCP（mcp_server.py）供Claude Code等agent调用。核心功能包括每日复盘（全球指数、短线情绪、资金流）、资讯雷达（108个RSS源）、个股数据（估值、财报、资金面等）、多空辩论（debate.py）流程：先抓取13项客观数据作为底稿，再由多方/空方研究员基于同一数据立论，中立主持归纳共识与分歧，不产出买卖结论。反思审计（reflection.py）对已有分析进行推理审计。持仓、自选股、研报上传仅存本地（~/.vibe-research/），不上传。
- 个人投资者每日复盘：通过“每日复盘”页面查看大盘、全球市场、短线情绪、板块资金，并一键让AI生成当日复盘。
- 研究个股基本面：在“个股数据”页输入A股代码或美股/港股代码（如AAPL、00700），查看估值、财报、资金面、研报等，并让AI按五维框架分析。
- 获取资讯要点：使用“资讯雷达”页，从108个公开RSS源中提炼今日要点，支持按关注列表过滤。
- 多空辩论分析：对一只股票发起多空辩论，获得基于同一份客观底稿的多方与空方论点、分歧点和验证清单，辅助独立决策。
- 管理个人投资组合：在“我的持仓”中录入持仓和已清仓记录，实时跟踪盈亏；上传自己的研报（PDF/Word等）按行业归档，仅存本地。
- 反思与审计：将AI的分析结果交给“反思审计”，让AI自我审查推理中是否有数据支撑，找出最脆弱环节。
如何安装或部署这个 Agent？
- 克隆仓库：git clone https://github.com/simonlin1212/Vibe-Research
- 后端安装：cd backend && python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
- 前端安装：cd frontend && npm install
- 启动后端：cd backend && .venv/bin/python -m uvicorn app:app --host 127.0.0.1 --port 8900
- 启动前端：cd frontend && npm run dev
- 浏览器访问 http://localhost:5899
无需额外API key即可使用数据功能；AI功能需在“接入AI”页配置（订阅CLI或API key）。
如何使用这个 Agent？
- 启动前后端后，打开前端页面。
- 在“接入AI”页配置AI：选择订阅接入（需本机有已登录的CLI）或API接入（填key，baseURL自动填充）。
- 在“每日复盘”页查看市场数据，点击“AI当日复盘”生成复盘。
- 在“个股数据”页输入股票代码（如600519、AAPL、00700）查看数据，点击“问AI”进行分析。
- 在“自选股”页批量粘贴代码添加关注，开启实时行情开关可自动刷新。
- 在“多空辩论”页选择股票，发起辩论（约100秒），查看共识与分歧。
- 在“我的持仓”录入持仓，在“我的研报”上传文档，均本地保存。
这个 Agent 有哪些优点和局限？
- 数据全面且开箱即用：内置A股、美港股、全球资讯数据源，零配置即可使用，且数据源都在仓库内快照，稳定可靠。
- AI接入灵活：支持订阅CLI（Claude Code、Codex等）、API key（DeepSeek、OpenAI等）和MCP三种方式，用户可自由选择模型和成本控制。
- 多空辩论设计创新：多agent辩论基于客观数据底稿，不产出买卖结论，帮助用户看清分歧和验证清单，而非替代决策。
- 本地隐私保护好：持仓、自选、研报、API key只存本地，不上传，重新部署不丢数据。
- 合规框架清晰：不荐股、不预测，仅呈现客观数据，适合注重合规的用户。
- 多空辩论耗时且消耗token：一轮约100秒、3次模型调用，两轮则翻倍，成本较高。
- 依赖用户自己的AI模型：若没有订阅或API key，核心AI分析功能无法使用，需要额外配置。
- 数据源可能被限流：内置节流但仍可能被上游限流，高频使用可能影响体验。
- 前端为React 19等较新版本，可能需要较新的Node.js环境，对旧系统不友好。
这个 Agent 与同类方案有什么区别？
相较于TradingAgents、ai-hedge-fund等开源多agent金融框架，Vibe-Research刻意不设置trader或portfolio_manager角色，不产出买卖建议，而是以分歧和验证清单为输出，更适合用作研究工具而非自动交易。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Vibe-Research · 个人 AI 投研系统 当前 | 59 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 2.7k | 1 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| FinnewsHunter 金融情报平台 | 29 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 1.5k | 3 个月前 | Python | OpenAI API |
| 智能公司研究助手 | 0 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 2.3k | 3 天前 | Python | OpenAI API |
| MindSearch 深度搜索器 | 42 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 6.9k | 1 年前 | JavaScript | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：README 明确说明 API key 只存本地浏览器、不上传；持仓/研报只存本地用户目录；有 VR_API_KEY 鉴权中间件（test_fixes.py 测试）。但未发现用户确认机制（如删除/覆盖前确认），数据流透明性部分（如哪些数据发送给 AI）未详细说明。依赖安全方面，未提供依赖漏洞扫描或锁定文件（requirements.txt 存在但未审查）。外部影响（如网络请求）未明确限制。回滚方面，有数据迁移但无版本回滚机制。来源归属：数据源明确标注（东财、腾讯等），但未提供数据许可证明。
证据显示：测试覆盖工具层、辩论、反思、API 校验，且测试注释表明修复了多个问题（如脏数据、超时）。依赖可用性：分级依赖设计（akshare/mootdx 惰性导入）和降级处理（test_fixes.py 测试）表明依赖缺失时服务不崩溃。失败消息：测试表明错误会返回 error 字段或 400/404 状态码，且 CLI 超时有明确提示。
证据显示：README 明确目标用户（个人投资者）和场景（A股/美股/港股投研），能力边界清晰（不荐股、不预测），触发条件（如代码格式校验）有测试，环境适配（本地部署、CLI/API/MCP 接入）说明详细。
证据显示：README 结构清晰，安装步骤明确，命名稳定（版本号唯一来源），有示例（快速开始、接入 AI），已知限制（如 CLI 不支持多轮工具调用）有说明，MIT 许可证，有 CHANGELOG，维护责任（作者 Simon）明确。
证据显示：输出可用性（看板、报告、辩论结果）设计良好，边际价值（多 agent 辩论、反思审计）有特色，成本效益（辩论开销表格）有说明。
证据显示：README 声明与测试代码对应（如辩论流程、数据缺口处理），但跨源验证不足（未提供多个独立数据源交叉验证的证据），事实与推断分离（底稿先行、不得臆测）有明确设计。
- 未发现用户确认机制，删除或覆盖操作可能无提示。
- 依赖安全未提供漏洞扫描或锁定文件，建议审查 requirements.txt 并固定版本。
- 数据流透明性不足，未详细说明哪些数据发送给 AI 模型。
- 外部网络请求未明确限制，可能访问第三方数据源。
- 回滚机制缺失，版本升级后可能无法回退。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
修 Windows 上的几个问题。界面和使用方式没有变化。闪窗口的修复来自社区 PR #53（感谢 @ruijh）；其余是从 [Vibe AStock v2.1.1](https://github.com/simonlin1212/vibe-astock/releases/tag/v2.1.1) 搬回来的底座修复，其中前 4 个提交来自 vibe-astock PR #22（感谢 @Boomyuan，提交保留原作者署名）。 修复 - Windows 上深度研究时不停闪黑窗口（#53）：复算、取数、计算库版本探测、体检、批量模式、压测、本机 Agent 账号探针和启动这几处子进程，启动时没声明隐藏窗口。复算是每条计算单独起一个进程，一次研究要起几十到上百次，所以看起来一直在闪。现在都隐藏窗口，其他系统不受影响。 - Windows 上没以管理员身份运行时，可能报「无法收紧 Windows 文件权限」、启动不了：私密文件原来用 PowerShell 的 Set-Acl 收紧，普通用户没有它需要的权限。现在改用系统自带的 icacls：断开继承，只给当前用户（按 SID）完全控制，别的账户单独挂的授权、文件上的拒绝规则都删掉，所有者不是当前用户时改回当前用户；收紧后马上复查，没收紧到位就报错。 …在 GitHub 查看 ↗ -
发布说明摘录
修 v2.2.0 新加的报告数字核对和回测输出里的 4 个问题，都是 [Vibe AStock](https://github.com/simonlin1212/vibe-astock) 合并 v2.2.0 时的发版审计发现的；修复本身又做了一次独立复核，补了复核找到的 6 处。界面和使用方式没有变化，建议 v2.2.0 用户升级。 修复 - 引了用户资料或知识档案的数字，按位数和单位核对：v2.2.0 在资料片段、档案引文里找出处时会退回只比裸数字，资料写 120.5 亿元、报告写 120.5 万元（差一万倍）也不遮。现在按写出来的位数和单位换算后比对，正负号也要对；资料里写「百万港元」「billion」「个百分点」的按写的量级读，资料里的区间「31.2%-35.8%」右端不当负数；引了证据编号的行引档案旧值也按单位核对。 - 区间共用单位：「31.2-35.8 亿元」「31.3 至 35.8 亿元」左端没写单位时用右端写的单位，有出处的不再被遮；「999-1,500 亿元」这类整数左端借到单位后也要核对（原来按计数跳过）。 - 算式「≈」：结果只有一位有效数字时放得太宽，「30 ÷ 49 ≈ 100%」（实为 61%）也判对。现在放宽不超过结果的 5%，但不低于个位的半格，「≈ 2200」「≈ 58%」「10 ÷ 3 ≈ 3 倍」照旧算对。 …在 GitHub 查看 ↗ -
发布说明摘录
把 [Vibe AStock](https://github.com/simonlin1212/vibe-astock) 改造时审计出的通用问题修回来，并定下上一版留着的三条取舍。界面和使用方式没有变化。 三条取舍 - 报告里找不到出处的数字遮掉：没引证据或计算编号的数字，交付前在本次取到的数据和计算里找出处（数据原文里有，或按写出来的位数和单位能对上，都算有出处；同一行引了本次用到的用户资料的，资料片段里有也算）。找不到的只把数字换成「〔未核实〕」，报告开头说明有几处，运行状态记为「不完整」。日期、编号、写明「假设 / 如果 / 情景」的行和表格、「数据缺口」一节不查；「31.2%-35.8%」这类区间按两个正数查。上线前拿本机 9 份历史报告试过：一处都没遮。 - 回测最后一天卖不出去的不再编一笔卖出：能卖的照旧按收盘价平仓；最后一天没有行情、A 股最后一天才买进的部分（T+1；最后一天加仓的只留加的那部分）、A 股收盘封在跌停的，按收盘价计入期末净值、不扣卖出费用，报告的口径披露里写明是哪几只、为什么，并说明胜率等按平仓记录算的指标不含它们。 - 持仓收益率里没填费用的买卖按 0 算并写明几笔，提示「费用合计偏少，收益率可能偏高」。明确填了 0 的不算。 主要修复 …在 GitHub 查看 ↗