Vibe-Research

作者求职｜深圳 · 香港 · 远程

我是 Simon，专注于 AI Agent 与实用工具开发，正在寻找深圳、香港或远程工作机会。
欢迎联系：simonlin0423@gmail.com。

Vibe-Research 是一款面向个人投资者的 AI 投研工作台，把市场资讯、行业跟踪、公司研究和资料管理汇集在一起，让研究有据可查、持续积累。

界面预览

以下为 2026-09-07 拍摄的 v1.1.0 真实界面。首屏直接聊天，Agent 默认关闭；需要联网查证或多步研究时再开启。

截图使用空白、未接入 AI 的隔离工作区，没有私人持仓、研报或账号凭据；截图说明。

用 Vibe Research 做什么

从市场变化出发，找到值得跟踪的行业与公司，再核对观点、整理资料，留下自己的研究记录。下表对应左侧的 13 个一级栏目；分组用于阅读，不改变产品里的栏目名称。

首页：先聊问题，再按需研究

连接 AI 后，可以在首页直接提问。其他栏目右上角也有对话入口，方便围绕当前页面继续交流。

Agent 默认关闭。 普通对话适合梳理思路、解释概念和翻译；需要联网查资料、取数、计算或多步研究时，再打开左上角“开启Agent”。开启后可以研究得更深入，但通常更慢，也更消耗 Token。开关保留已选的 AI 来源，不要求重新接入。

后台研究经确认后启动；普通对话不会自动变成一轮完整研究。未接入 AI 时也可以先浏览栏目。

个股研究：从公司业务到风险，逐步展开

选择一家 A 股公司，研究会依次整理 公司画像 → 财务 → 盈利预期 → 估值 → 风险 → 报告。不是只给一段结论，还保留各阶段使用的资料、计算依据、来源冲突与数据缺口。

研究过程中可以查看进度、请求中止，刷新页面后继续查看状态。发出中止请求不代表已经停止，页面会区分请求与确认状态。完整六阶段研究目前只支持 A 股；港美股支持范围见数据与市场。

我的研报与证据核对：读结论，也能回头看依据

把 PDF、DOCX、TXT、MD 或 CSV 资料导入“我的研报”，可以查阅、检索，并围绕资料提问。回答中的资料引用用于回查原文，文本型 PDF 保留页码；扫描版 PDF 需要先做文字识别。

公司研究中的原始数据保留来源与资料期，派生数字保留计算输入和结果。遇到来源冲突或缺数据，会记录下来，不把空缺当成零，也不把无法验证的结果当作已完成。有引用不代表推论必然正确，仍需核对原文与计算条件。

原始研报在本机保存和解析，检索命中的正文片段会发送给所选模型；“本地保存”不等于全程离线。

多空辩论与回测：从不同角度核对想法

多空辩论让不同分析视角围绕同一份资料展开，查看支持理由、风险解释和反驳，帮助发现尚未解决的分歧。

回测用于检查明确的历史规则。先用自然语言说明问题；缺少条件时继续补充，条件齐备后调用回测工具。工具失败或不支持的条件会说明，不把未执行的任务写成回测结果。

两者都需要开启 Agent。报告会保存在“研究记录”，方便之后查找、比较和回看。历史表现不代表未来结果，也不是现实交易建议。

自选股、持仓与记录：把研究积累留下来

“自选股”管理关注清单，“我的持仓”整理已有持仓，“研究记录”保存研究产出。A 股、美股与港股代码均可用于自选股与持仓记录。

持仓与自选股支持从截图或表格整理草稿，人工核对后再确认保存，不会上传后直接改写台账。选定内容会发给当前 AI，请先移除无关敏感信息。转写暂存件在成功、失败或取消后清理；请保留原文件核对。清理本机暂存件不代表模型服务商删除了已收到的内容。

接入 AI

已有 WorkBuddy，也可以接入 Vibe Research。 可以使用自己的订阅，或填写模型 API；连接成功后，日常无需反复选择。

接入需要对应服务的安装、登录、接口兼容与可用额度；产品不附赠订阅。一次连接测试成功不等于所有业务和供应商都已验证。

上图为 2026-09-07 的 v1.1.0 接入弹窗，使用未登录的隔离工作区拍摄；不是当前账号状态。

第一次连接

首页直接显示交流框。尚未连接时会弹出“请接入AI”：已登录的 Codex、Claude Code、WorkBuddy 可点击对应入口测试并保存；“其他接入方式”进入设置，支持 API 配置与登录帮助。新连接默认关闭 Agent， 以后打开首页无需重复选择，左上角显示已保存的实际来源。也可先关闭弹窗浏览栏目。 交流框按模式提供常见问题，下方按五类整理现有功能入口。需要联网查证或多步研究时，打开左上角“开启Agent”。 明确切换的状态会保留；重新测试同一来源不会重置。订阅普通对话仍需启动对应客户端，不承诺固定响应时间。

使用 ChatGPT 订阅：启动界面后进入“接入 AI”→“订阅接入”，点击“登录 Codex”，在自动打开的 OpenAI 官方页面完成授权；页面自动识别登录结果后，点击“测试并保存”。产品使用独立的 .local/codex-home，不会读取或覆盖用户的 ~/.codex。授权页没有自动打开时，回到设置页重新点击 “登录 Codex”；本地状态仍不明确时运行 scripts/doctor（Windows 为 scripts\doctor.ps1）查看修复提示。

使用 Claude.ai 订阅：先安装并登录 Claude Code；设置页会自动检测，不需要把 Claude 的 key 填进产品。

使用 WorkBuddy / CodeBuddy：如果电脑已经安装并登录 WorkBuddy 桌面版，设置页会直接识别它自带的官方 CodeBuddy Code CLI，不需要重复安装或登录。没有桌面版时，也可以运行 npm install -g @tencent-ai/codebuddy-code 安装腾讯官方 CLI，再运行 codebuddy 登录。两种方式都不需要 把账号 token 或 API key 填进产品。

API 接入：进入“接入 AI”→“API 接入”，选择供应商并填写 API 地址、模型名和 key，再点击 “测试并保存”。系统先发起一次真实模型对话，成功才保存并供全站使用；同时会记录该 provider 是否通过 模型直连能力验证。出现重新连接提示时，请检查是否尚未登录、登录失效或连接探针未通过，按页面具体错误处理；不要把所有接入失败都当作订阅已过期。

• Agent Runtime 负责本地上下文、工具调用、任务状态、进度和失败处理。Codex 订阅走 Codex Harness；Claude 订阅走 Claude Code Agent；WorkBuddy / CodeBuddy 走 CodeBuddy Code Agent，三者不会混叫。
• Claude Code 与 WorkBuddy / CodeBuddy Agent 可运行完整 A 股六阶段研究；每个阶段使用一次独立会话，只能调用 Vibe Research 的受控 MCP，不会暗中换成 Codex。
• AI 来源可以是订阅登录，也可以是用户自己的 Model Provider API。新来源默认关闭 Agent，同一来源重测保留明确选择。
• 模型直连不运行 Agent、不调用工具，也没有 Agent 任务记忆；六阶段研究、多空辩论和 Agent 回测会明确提示重新开启 Agent，不会静默降级。
• Codex 订阅使用产品自己的 CODEX_HOME，不读写用户的 ~/.codex；Claude 与 CodeBuddy 订阅复用各自本机登录态。普通对话关闭全部工具与 MCP；六阶段研究关闭内建工具，只开放产品受控 MCP。用户配置与自动记忆保持关闭。WorkBuddy 自带的旧 CLI 若没有“禁止会话落盘”参数，整次回答会改在一次性临时用户目录运行，结束后删除。
• 无论订阅或 API，点击“测试并保存”都会先做一次真实对话探针；探针失败不覆盖当前已生效配置。
• API 模式的 key 会持久保存在当前浏览器的本机 localStorage，方便下次直接使用；它不是系统钥匙串， 也不承诺加密，只建议在可信个人电脑使用。key 随请求交给本机后端，但不进入仓库、后端配置、运行账本 或日志；共享电脑用完请主动清除。

内置 provider 模板：OpenAI、DeepSeek、Qwen、GLM、Kimi、MiMo，以及未实测的 selfhosted 自托管占位模板。Codex Harness 的 API 通道只支持 Responses API； 直连通道使用 provider 模板中单独声明并验证的协议。模板存在不等于已经通过兼容矩阵，界面会区分 “已实测”和“有模板、未实测”；普通对话不把未验证来源伪装成已验证的 API 直连能力。

详细说明见 docs/model-access.md 和 providers/README.md。

局域网访问为可选功能，默认关闭。从仓库根启动：VRA_LAN=1 bash scripts/start；Windows PowerShell 先设置 $env:VRA_LAN="1"，再运行 scripts/start.ps1。只开放前端，后端仍绑定回环； 也可在后端已启动时运行 VRA_LAN=1 npm run dev --prefix desktop。 仅限受信任局域网：这是单用户工作台共享，不是账号隔离；网络内能访问端口的人可操作该工作台。 HTTP 传输不加密，API key 和研究资料可能在网络上明文传输。不要暴露公网或在不可信网络开启。 代理先校验浏览器同源，再归一化 Origin；远程模型地址仍须 HTTPS，本机模型可用回环 HTTP。 详见 模型接入与局域网边界。

快速开始

从源码运行

当前版本 v1.2.0 提供开源源码 + 本地浏览器工作台，便于用自己的开发 Agent 改造。Mac 客户端已暂撤；v1.1.0 的 DMG 也已于 2026-09-10 从 GitHub 撤下，旧版本记录和源码归档保留。旧客户端数据不会自动迁移，详见源码交付说明。

macOS、Windows 和 Linux 都使用下面的源码流程。页面仍在本机运行，不是把私人研究上传到网站。首次使用需要先安装 Node.js、Python 和 Git，再初始化项目。

让开发 Agent 打开克隆下来的仓库即可改造页面与功能。desktop/ 是浏览器前端目录，并非 Mac 客户端；修改代码后按开发与测试验证。

环境要求

Node 必须是启用了 TypeScript 支持的构建（nodejs.org 官方安装包、nvm / fnm / Volta 装的都是）：node -p process.features.typescript 应输出 strip 或 transform。部分 Linux 发行版仓库打包的 Node 编译时关闭了这一项，启动或跑测试会报 ERR_UNKNOWN_FILE_EXTENSION ".ts" / ERR_NO_TYPESCRIPT，请换官方构建。npm test 前会先做这项检查并给出同样的提示。

安装依赖

已有源码副本请先备份自己的数据，再更新代码并执行 setup，不必重新克隆。旧 Mac 客户端数据不会自动迁入源码工作区；不要删除 ~/.vibe-research-desktop，也不要把它提交到仓库。

Windows（PowerShell / CMD）：

git clone https://github.com/simonlin1212/Vibe-Research.git vibe-research-agent
cd vibe-research-agent
scripts\setup-windows.cmd
scripts\start.cmd

setup-windows.cmd 会创建 .venv、安装 Node/Python 依赖、初始化产品私有目录并运行体检； start.cmd 会启动本地 API、浏览器 UI 并打开 http://127.0.0.1:5930。

macOS / Linux：

git clone https://github.com/simonlin1212/Vibe-Research.git vibe-research-agent
cd vibe-research-agent
scripts/setup
scripts/start

scripts/setup 会创建 .venv、安装本产品自带的 Agent 引擎与 Node/Python 依赖、初始化私有目录并运行 体检；scripts/start 会检查安装状态和端口，同时启动两端，确认都可用后才打开浏览器。无需全局安装 Codex， 也无需打开两个终端。

启动浏览器 UI

Windows 运行 scripts\start.cmd，macOS / Linux 运行 scripts/start。两者都会同时管理本机 API 与界面， 浏览器地址为 http://127.0.0.1:5930。macOS / Linux 如不想自动打开浏览器， 可运行 scripts/start --no-open；按 Ctrl+C 会同时关闭两端。

Vite 只在本机代理 /api/*，并在服务端补上鉴权信息。若设置了 VRA_DATA_ROOT，两个进程必须使用 同一个值。

数据与市场

• 当前注册表：117 个端点、30 层，覆盖 CN、US、HK。
• 数据类别：行情、K 线、财务、一致预期、公告、研报、资金、筹码、期权、SEC/FINRA/CBOE、 新闻、宏观、产业温度计、招聘、管制与数据日历。
• A 股、美股和港股都可用于自选股、持仓、资料归档与 Agent 对话。
• 六阶段个股研究目前只支持 A 股。 港美市场不会启动一条没有完整数据链的空研究。
• 扫描版 PDF 需要先 OCR；文本型 PDF 会保留页码引用。

端点目录见 datasources/CATALOG.md。

安全与隐私

• 开启 Agent 后，公开网页读取可能经第三方 Jina Reader 转发；目标网址（包括查询参数）会发送给该服务。不要提交含私密令牌、内部资料或签名下载凭据的网址。搜索请求同样会发送到对应搜索服务。

• 原始研报文件只保存在本机；模型只接收服务端检索命中的正文片段。

• 后端默认 provider 的 key 只走环境变量，不写入产品配置或仓库。

• 浏览器里填写的 API key 只保存在当前浏览器 localStorage，仅在调用时经本机后端转给所选模型服务商。

• 普通对话不调用工具；开启 Agent 后，对话可使用产品提供的联网和研究工具。专门的资料抽取等有界任务仍按任务限制执行权限。

• 资料引用格式为 [资料:<id> p.<页码>]，漏引、错引和未知引用会被机器校验拒绝。

• Agent 研究阶段无网络；取数由编排器使用受控脚本完成，原始响应落盘并记录哈希。

• 本机 API 默认只绑定 127.0.0.1，写请求必须鉴权并使用 JSON。

• 输出只包含数据、分析框架、情景概率和裁决点，不提供建仓、加减仓、目标价或止损位。

当前边界

• 当前只提供源码 + 本地浏览器 UI，不提供 Mac 客户端或安装包构建工具；v1.1.0 DMG 已撤下，旧版本记录与源码归档保留。
• MiMo API 已完成从空配置到真实业务报告的端到端验证；其他第三方模型仍需使用者自己的 key， 没有真实跑过兼容矩阵的模板不会标成“已实测”。
• Windows 11 原生支持已接入：PowerShell 初始化/启动脚本、Windows 路径与进程处理、受控研究工具链， CI 配置包含 windows-latest / macos-latest / ubuntu-latest，Windows 使用选定的跨平台契约测试，并非全部后端测试。仍未在 Windows 实机验收，也尚未验证正常退出后的 Job Object 子进程回收保证。Windows 10 仅按 Codex 上游能力尽力兼容。
• 源码运行需要本机依赖环境；端点登记在册不保证第三方服务随时可用。

工作方式

本地浏览器工作台
首页 Agent · 复盘 · 资讯 · 个股研究 · 回测 · 资料库
        │
        ▼
金融 Agent 层
117 个数据端点 · 六阶段 SOP · calc · validator · report archive
        │
        ▼
本地 Agent 运行时（Local Agent Runtime）与模型