用本地 AI Agent 做 A 股/美股/港股投研（Vibe-Research）

个人做投研的麻烦集中在两处：资料散在行情软件、公告页、PDF 研报和聊天记录里；跟 AI 聊完一轮，结论和依据留不下来。Vibe-Research 把这两件事装进一个跑在本机的浏览器工作台，用你自己的 AI 订阅或模型 API 驱动，研究过程、引用来源和计算依据都留在本地。

Vibe-Research 是一款用 TypeScript 写的个人投研工作台，面向 A 股、美股、港股的个人投资者，输入自己的 AI 订阅或模型 API，输出带来源的研究报告、回测结果与持仓台账。

它基于开源的 Codex Harness 打造，前端是 React + Vite，后端是 Python，跑起来后是一个本地后端加浏览器 UI 的单用户工作台。仓库地址 https://github.com/simonlin1212/Vibe-Research，采用 MIT 许可证，主要语言 TypeScript，当前 2636 Star、539 Fork、18 Watcher、2 个开放 Issue。当前版本 v1.2.0 只交付开源源码加本地浏览器工作台，不再提供 Mac 安装包。

装它需要什么

• 操作系统：Windows 11、macOS 或 Linux，Windows 原生运行，不要求 WSL。
• Node.js ≥ 22.18，推荐 24 LTS。构建必须启用 TypeScript 支持，用 node -p process.features.typescript 检查，应输出 strip 或 transform。部分 Linux 发行版仓库打包的 Node 关掉了这一项，启动或跑测试会报 ERR_UNKNOWN_FILE_EXTENSION ".ts" 或 ERR_NO_TYPESCRIPT。
• Python ≥ 3.11，推荐并已验证 3.12。
• Git，用于克隆仓库。
• Agent 引擎 Codex Harness 随依赖安装，当前开发分支锁定并已本机验证 0.153.4，不需要另装全局 Codex。
• AI 来源：Codex 订阅、本机已登录的 Claude Code、WorkBuddy / CodeBuddy，或模型 API 的服务地址、模型名和 key。产品不附赠订阅，接入需要对应服务本身可用并有余量。
• 源码版本 v1.2.0，许可证 MIT，主要语言 TypeScript。

跑起来

1. 克隆仓库：git clone https://github.com/simonlin1212/Vibe-Research.git vibe-research-agent
2. 进入目录：cd vibe-research-agent
3. Windows 下运行 scripts\setup-windows.cmd，它会创建 .venv、安装 Node 与 Python 依赖、初始化产品私有目录并运行体检。
4. 接着运行 scripts\start.cmd，启动本地 API 与浏览器 UI。
5. macOS / Linux 走同一套流程，启动脚本在 README 里以 bash scripts/start 的形式出现；这段文档节选没有给出对应的 setup 脚本名。
6. 浏览器打开 http://127.0.0.1:5930，首次进入会弹出「请接入AI」。
7. 已登录的 Codex、Claude Code、WorkBuddy 点对应入口测试并保存；其它情况走「API 接入」，填 API 地址、模型名和 key，再点「测试并保存」。
8. 日常直接对话即可；需要联网查证、取数或多步研究时，打开左上角「开启Agent」。Agent 默认关闭。

输出是什么

结果落在浏览器界面里，地址是 http://127.0.0.1:5930，左侧共 13 个一级栏目：首页、每日复盘、资讯雷达、产业信号、板块中心、个股研究、多空辩论、回测、自选股、我的持仓、我的研报、研究记录、接入 AI。

研究产出的归集点是「研究记录」，研究、回测和多空辩论的报告都在那里按时间存放，可搜索、可回看。个股研究按 公司画像 → 财务 → 盈利预期 → 估值 → 风险 → 报告 六个阶段推进，每个阶段保留所用资料、计算依据、来源冲突与数据缺口。

判断这次跑成功有两处信号：启动脚本执行后 5930 端口页面能打开；接入 AI 的判据是「测试并保存」会先发起一次真实模型对话，成功之后才保存并供全站使用。持仓与自选股支持从截图或表格生成草稿，人工核对后才确认保存，不会上传后直接改写台账。

研报原文在本机保存和解析，检索命中的正文片段会发送给所选模型，本地保存不等于全程离线。历史表现不代表未来结果，这些输出都不是现实交易建议。

先说它做不到什么

• 不做交易。「我的持仓」只整理台账并结合行情查看，仓库里明确写了不提供下单交易。
• 覆盖面有限。完整六阶段研究目前只支持 A 股，港美股的范围以 README 的「数据与市场」一节为准。Mac 客户端已暂撤，v1.1.0 的 DMG 也于 2026-09-10 从 GitHub 撤下，当前只有源码加本地浏览器工作台，旧客户端数据不会自动迁移。
• 安全边界要自己守。API 模式的 key 持久保存在当前浏览器的本机 localStorage，不是系统钥匙串，也不承诺加密，只建议在可信的个人电脑上使用。局域网访问默认关闭，开启后仅限受信任局域网，属于单用户工作台共享而非账号隔离，HTTP 传输不加密，不要暴露公网。

适合已经有 A 股、美股或港股持仓，愿意自己准备 AI 订阅或模型 API、也肯动手跑一遍源码的个人投资者。只想看行情推送，或者期待装完即用的手机 App 的人，这个项目帮不上忙。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 9.3 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。