Vibe-Research 环境配置清单Node、Python 与 Git 安装避坑指南【免费下载链接】Vibe-ResearchVibe-Research: Your Personal Trading Research Agent · A股/美股/港股 的个人投研 Agent每日复盘、资讯雷达、个股数据、板块中心、我的持仓、研究记录、回测。Vibe-Research 把数据和功能配齐由你自己的 Agent 驱动投资研究。基于开源的 Codex Harness 打造。项目地址: https://gitcode.com/gh_mirrors/vi/Vibe-ResearchVibe-Research 是面向 A股/美股/港股的个人投研 Agent支持每日复盘、资讯雷达、个股研究、回测等功能。从源码运行它只需备好三样软件Node.js、Python 和 Git。这份环境配置清单帮你确认版本要求、完成一键安装并绕开 5 个最常见的坑约 10 分钟跑起本地投研工作台。一、环境要求速览1 分钟看清 3 个工具版本软件最低版本推荐版本用途Node.js≥ 22.1824 LTS驱动后端编排器与浏览器界面Python≥ 3.113.12官方已验证计算库、回测引擎与取数脚本Git近期任意版本最新稳定版克隆仓库与日常更新操作系统支持Windows 11原生运行不要求 WSL、macOS 和 Linux三端都走同一套源码流程。⚠️ 关键前提无需单独安装全局 CodexAgent 引擎随依赖安装初始化脚本会一并处理。二、Node.js 安装2 个硬性要求要记牢这是新手最容易踩坑的地方请对照自查 要求 1版本必须 ≥ 22.18。项目不做构建打包而是让 Node 原生执行 TypeScript 源码22.18 起类型剥离默认开启版本不够直接跑不起来。要求 2必须是启用了 TypeScript 支持的构建。部分 Linux 发行版 apt / yum 仓库里的 Node 编译时关闭了这一项版本号够了也会报错。安装完在终端执行一条自查命令node -p process.features.typescript输出strip或transform即合格 ✅。如果输出undefined或启动时报ERR_UNKNOWN_FILE_EXTENSION .ts/ERR_NO_TYPESCRIPT说明你装到了发行版特供构建请改用nodejs.org 官方安装包或用nvm / fnm / Volta重新安装 Node 22.18 / 24 LTS。这个检查逻辑写在 scripts/check-node.mjssetup、start、doctor等脚本启动前都会先跑它并给出可照做的中文提示不会只甩一个晦涩的报错。三、Python 安装版本达标即可虚拟环境全自动需要Python ≥ 3.11推荐3.12项目已在本机验证。无需手动建虚拟环境setup会按python3.12 → python3.11 → python3 → python的顺序自动探测合格的解释器然后创建项目内.venv并安装取数依赖。如果提示未找到 Python 3.11 或更高版本装好新版 Python 重跑一次即可不用重新克隆仓库。Python 侧的依赖清单见 .agents/skills/data-access/scripts/requirements.txt安装脚本已替你处理一般不用关心细节。四、Git 克隆仓库 3 条命令完成一键安装Git 只负责一件事把仓库克隆到本地。git clone https://gitcode.com/gh_mirrors/vi/Vibe-Research vibe-research-agent cd vibe-research-agent然后按系统选择安装脚本均在仓库根目录执行macOS / Linuxscripts/setupWindowsPowerShell / CMDscripts\setup-windows.cmdsetup会一口气做完 6 件事不用你逐个敲命令检查 Node / npm 是否存在并跑 scripts/check-node.mjs 预检探测合格的 Python创建.venv虚拟环境pip安装数据访问依赖npm ci安装后端orchestrator/与前端desktop/依赖初始化产品私有数据层.local/目录、配置骨架、.gitignore不读写你的~/.codex运行产品体检doctor并给出中文修复提示脚本细节与 Windows PowerShell 版入口init.ps1/doctor.ps1说明见 scripts/README.md。五、doctor 体检安装后的环境体检单初始化最后会自动跑一次体检如需手动复查直接运行scripts/doctor # macOS / Linux scripts\doctor.ps1 # Windows PowerShell体检覆盖 Node 版本、产品配置链、Codex 引擎二进制、登录态、Python 与取数依赖、calc 自检、注册表、数据根写权限和密钥扫描每一项都标注ok / warn / fail / skip并附中文修复提示报告写入.local/doctor/时间.json。记住退出码含义0全部正常2只有警告可先启动按提示处理3存在失败项必须先修复。六、启动工作台看到首页就配置成功了一切就绪后启动命令只有一条scripts/start # macOS / Linux scripts\start.cmd # Windowsstart会先做端口与安装状态预检同时拉起本机 API 和浏览器界面真实健康检查通过后才自动打开浏览器无需开两个终端。默认地址浏览器界面http://127.0.0.1:5930后端 API 回环端口8765macOS / Linux 可加--no-open阻止自动打开浏览器按CtrlC会同时关闭两端。看到首页出现即代表环境配置全部到位 端口被占用的提醒5930/8765是默认地址不代表当前已有服务在跑若提示端口占用先确认端口属于哪个项目不要贸然终止其他服务。更多交付背景见 docs/source-delivery.md。七、5 个高频坑位速查表现象原因解决方案报ERR_UNKNOWN_FILE_EXTENSION .ts或ERR_NO_TYPESCRIPT发行版 Node 关闭了 TypeScript 支持换 nodejs.org 官方安装包或 nvm / fnm / Volta 装 24 LTSnode -v够新但仍启动失败同上构建问题不是版本问题跑node -p process.features.typescript自查setup 提示未找到 Python 3.11 或更高版本系统 Python 过旧安装 Python 3.12 后重跑setup无需重新克隆npm ci慢或失败网络波动重跑一次setup可重复执行必要时配置 npm 镜像doctor 退出码3有 fail环境某项未通过按屏幕中文提示逐项处理或看.local/doctor/下的 JSON 报告写在最后把这份清单收好Node ≥ 22.18TS 构建 Python ≥ 3.11 任意近期 Git克隆后一条setup、一条start本地投研工作台即可开工。遇到任何报错优先跑doctor看中文修复提示比盲目重装更高效。配置完成后记得进入接入 AI连接你自己的模型订阅或 APIVibe-Research 的复盘、研究、回测功能就能真正跑起来了。【免费下载链接】Vibe-ResearchVibe-Research: Your Personal Trading Research Agent · A股/美股/港股 的个人投研 Agent每日复盘、资讯雷达、个股数据、板块中心、我的持仓、研究记录、回测。Vibe-Research 把数据和功能配齐由你自己的 Agent 驱动投资研究。基于开源的 Codex Harness 打造。项目地址: https://gitcode.com/gh_mirrors/vi/Vibe-Research创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考