Vibe-Research · 个人 AI 投研系统
面向A股/美股/港股的个人投研Agent，聚合行情、研报、资金面等数据，并接入你自己的AI模型进行深度分析。
证据显示：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 模型。
- 外部网络请求未明确限制，可能访问第三方数据源。
- 回滚机制缺失，版本升级后可能无法回退。
这个 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 有哪些优点和局限？
- 数据全面且开箱即用：内置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？
- 克隆仓库：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 与同类方案有什么区别？
相较于TradingAgents、ai-hedge-fund等开源多agent金融框架，Vibe-Research刻意不设置trader或portfolio_manager角色，不产出买卖建议，而是以分歧和验证清单为输出，更适合用作研究工具而非自动交易。