Vibe-Research：把 Codex Harness 变成 A 股投研工作台，但 Agent 默认是关的
Vibe-Research: Your Personal Trading Research Agent · A股/美股/港股 的个人投研 Agent：每日复盘、资讯雷达、个股数据、板块中心、我的持仓、研究记录、回测。Vibe-Research 把数据和功能配齐，由你自己的 Agent 驱动投资研究。基于开源的 Codex Harness 打造。
秒懂
- 它是什么？
- Vibe-Research 是一个本地金融研究工作台，用 Codex Harness 承载 Agent，把每日复盘、六阶段个股研究、回测和多空辩论打包成可复核的流程。它刻意让 Agent 默认关闭，把普通对话与研究任务分开，适合愿意自己接模型、自己核对证据的个人投资者。
- 适合谁用？
- 适合愿意自己接模型、自己核对证据链的个人投资者，尤其是 A 股玩家：你能接受本地跑 Node 22 和 Python 3.11，愿意把持仓截图发给自己的 AI 来源，并且想要一份带 evidence.json 和 calculations.json 的研究报告。不适合只想打开就用、不想碰 CLI 或不想读英文证据的人。
- 能商用吗？
- 可以。MIT 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。
- 还在维护吗？
- 在维护。仓库最近一次提交在 4 天前。
- 用什么语言写的？
- 主要是 TypeScript（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月15日）和我们的分析，不构成法律意见。
开源项目深度解析
它解决的问题：研究过程不可复核
个人做股票研究，最常见的问题是结论来得太黑盒。问一个 AI 助手某只股票值不值得买，它给你一段流畅的回答，但你看不到它看了哪些公告、用了哪一天的财务数据、估值模型里假设了什么。Vibe-Research 想改的是这件事。它的定位不是自动交易机器人，也不是行情终端，而是一个本地研究工作台：你日常跟它聊天，需要做正经研究时再打开 Agent。它服务的对象很具体，A 股、美股、港股都覆盖，但六阶段研究只对 A 股完整实现。作者在 README 里直接写明，作者正在找 AI 相关岗位，这个项目的个人色彩很重，更像一个可运行的作品集，而不是商业产品。
Agent 默认关闭，普通对话与研究任务分开
这个设计取舍值得注意。大多数 Agent 产品把自动化当作卖点，Vibe-Research 却把 Agent 设成 opt-in，左上角一个开关，默认关。普通对话模式只保留聊天记录，不调用工具，适合翻译、闲聊、找材料。开启 Agent 之后，模型才被允许调用本地数据、计算和研究工具。README 里强调，后台研究启动前会先跟你确认，回复里会显示实际用了哪些工具。这等于把「AI 替你干活」和「AI 陪你聊天」切成两个状态，避免模型在轻量对话里偷偷调用工具、产生你没想到的网络请求或本地操作。代价是操作多一步，但换来了行为可预期。对金融研究这种需要谨慎的场景，这个开关是合理的。
六阶段研究：输出不是一段文字，而是一组文件
Vibe-Research 的核心机制是 A 股六阶段研究，覆盖公司画像、财务、一致预期、估值、风险、报告。它真正有意思的地方在输出格式。研究结束不只是一份 report.md，而是六个文件一起落地。evidence.json 记录每条证据的来源、资料期和原文引用，calculations.json 保存派生数字的输入、函数和计算 DAG，conflicts.json 把跨来源冲突明晃晃地列出来，不静默取舍。manifest.json 记录模型、版本、阶段、状态和运行清单，viewer.html 让你在浏览器里看证据和报告。这套设计把研究从「模型说了什么」变成「模型基于什么、怎么算出来的」。如果关键数据拿不到，状态会变成 incomplete 或 failed，不会用旧值或猜测填空。这是它区别于普通聊天机器人的核心。
运行方式：源码、两个脚本、一个端口
安装路径很直接，不要求 Docker，不要求 WSL。Windows 用户跑 scripts\setup-windows.cmd 和 scripts\start.cmd，macOS 和 Linux 用户跑 scripts/setup 和 scripts/start。setup 会创建 .venv、安装 Node 和 Python 依赖、初始化产品私有目录并运行体检。start 会同时启动本地 API 和浏览器 UI，然后打开 http://127.0.0.1:5930。环境要求是 Node.js 22.18 以上、Python 3.11 以上。README 特意提醒，Node 必须是启用了 TypeScript 支持的构建，部分 Linux 发行版打包的 Node 会报 ERR_UNKNOWN_FILE_EXTENSION ".ts"。Agent 引擎 Codex Harness 是随依赖安装的，当前锁定 0.153.4，不需要你全局装 Codex。整个流程就是克隆、setup、start，然后浏览器里接模型。
模型接入：订阅与 API 两条路，各有坑
接入 AI 是第一次打开时的必经步骤。当前支持三种订阅入口：Codex、Claude Code、WorkBuddy（CodeBuddy），外加通用 API。订阅的方式是复用你本机已登录的 CLI 账号，比如 Claude Code 或 CodeBuddy 的登录态。Codex 需要完成产品专用的登录流程，在自动打开的 OpenAI 官方页面授权。API 方式需要自己填 key，Qwen Code 和 DeepSeek CLI 也归入这一类。README 明确说，订阅普通对话仍需启动对应客户端，不承诺固定响应时间。这意味着你机器上得真的装了并登录了那些 CLI，否则「测试并保存」会失败。v1.0.4 的发布说明里就有一条修复，叫「修复带全局 MCP 配置时对话与『测试并保存』全部失败」，可见这块的坑是真实存在的。
数据与隐私：本地台账，但转写会发给模型
持仓和自选股保存在本地，支持 A 股、美股、港股代码识别和行情刷新。有个功能叫截图或表格转写，你可以把持仓截图或表格贴进去，系统会生成草稿，人工核对后再确认保存。这里有个隐私点要拎出来说：选定的图片或表格内容会发送给当前 AI 来源，提交前请移除无关敏感信息。README 还解释，转写暂存文件会在成功、失败或取消后清理，但这个清理只针对本机暂存件，不代表模型服务商删除了已收到的内容。也就是说，你的持仓截图会离开本机，进到 OpenAI、Anthropic 或腾讯的服务器。对隐私敏感的人，这条要自己掂量。另外，持仓导入只生成草稿，不自动写入台账，这个克制是好的，避免模型误写。
边界与替代方案：不是行情终端，也不是万能 Agent
README 有专门一节讲当前边界，可惜内容被截断，具体边界列表看不到。但从已有信息能推断几件事。第一，它不是实时交易工具，回测只提供 Agent 对话入口，信息不足时会补问，齐备后才调用真实回测工具。第二，六阶段研究只对 A 股完整，美股港股只覆盖持仓和自选股，没有对应的六阶段流程。第三，Agent 引擎锁定 Codex Harness 0.153.4，升级要等作者跟进。替代方案方面，你可以直接用 OpenAI Codex Harness 本身，自己写工具和 SOP，但那就得自己处理金融数据源、证据校验和报告生成，工作量不小。也可以只用 Claude Code 或 CodeBuddy 的订阅客户端，配上自己的 MCP 工具，但 Vibe-Research 把研究阶段的内建工具关掉、只开放五个受控 MCP 工具这个设计，自己搭很难复刻。它的价值在于把研究流程固化成文件，而不是提供一个更聪明的模型。
维护与许可：MIT，但升级要自己动手
项目是 MIT 许可，源码在 GitHub 上，最近一次推送是 2026 年 9 月 9 日，v1.1.0 和 v1.0.4 都是 9 月初发的，迭代节奏快。但注意，当前源码版本是 v1.2.0，而 v1.1.0 的 Mac 客户端已经被撤下，只维护源码加本地浏览器工作台。README 说得很直白：本次更新源码，不提供新版安装包。旧 Mac 客户端数据不会自动迁入源码工作区，作者提醒不要删除 ~/.vibe-research-desktop。升级路径是：先备份自己的数据，再更新代码并执行 setup，不必重新克隆。依赖方面，Codex Harness 随依赖安装，锁定 0.153.4，这意味着如果 Codex 上游有安全更新或 bug 修复，你得等这个项目跟进。整体看，维护是活跃的，但你要接受源码级的使用方式，没有一键升级的安装包。
编辑结论
适合愿意自己接模型、自己核对证据链的个人投资者，尤其是 A 股玩家：你能接受本地跑 Node 22 和 Python 3.11，愿意把持仓截图发给自己的 AI 来源，并且想要一份带 evidence.json 和 calculations.json 的研究报告。不适合只想打开就用、不想碰 CLI 或不想读英文证据的人。订阅入口依赖 Codex、Claude Code 或 WorkBuddy 的登录状态，API 方式要自己填 key，首次接入的失败率不低。部署前先确认 Node 版本带 TypeScript 支持，跑 node -p process.features.typescript 应输出 strip 或 transform；再确认你的模型来源在设置页能通过「测试并保存」。旧 Mac 客户端数据不会自动迁入源码工作区，升级前先备份 ~/.vibe-research-desktop。它的价值不在自动化，而在把研究过程变成可审计的文件，这一点在同类工具里少见。
社区笔记