尧图网页设计 
Vibe-Research 开发者指南接入自定义 Provider 并跑通 10 项兼容矩阵【免费下载链接】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支持每日复盘、资讯雷达、个股研究、回测等功能由你自己的 AI Agent 驱动。本文面向开发者讲清两件事如何接入一家自定义模型 Provider以及如何用 10 项兼容矩阵验证它真的可用。一、Provider 机制是什么Vibe-Research 基于开源 Codex Harness 构建Agent 引擎只认 OpenAI 兼容的Responses 协议。每家模型厂商对应一份 JSON 模板放在 providers/ 目录下官方说明见 providers/README.md。内置模板一览供应商信息核实于 2026-08-26id厂商环境变量默认模型openaiOpenAI 官方OPENAI_API_KEY引擎默认deepseekDeepSeek 官方 ResponsesDEEPSEEK_API_KEYdeepseek-v4-flashqwen/glm/kimi阿里云百炼DASHSCOPE_API_KEY各自模型mimo小米 MiMo 原生 ResponsesMIMO_API_KEYmimo-v2.5模板只引用环境变量名永不含真实 token密钥只经env_key声明的环境变量提供。二、新建一份自定义 Provider 模板 以自托管模型为例仓库自带占位模板 providers/selfhosted.json流程是复制 → 改字段 → 跑矩阵复制模板放到.local/providers/id.json用户私有覆盖同结构、优先级更高或参考 providers/deepseek.json 新建providers/id.jsonid小写字母开头只含a-z0-9_-且与文件名一致。填写关键字段字段要求wire_api只能responseschat会被契约层当场拒绝base_url第三方必须显式填写远程要 HTTPS本机localhost/127.0.0.1允许 HTTP如http://127.0.0.1:11434/v1留空会让 Codex 回退到 OpenAI 官方端点密钥会发错主机env_key大写变量名不能是 HOME / PATH 等受保护名auth_modes第三方只能[api_key]responses_support厂商自带/responses填native经自建网关转换填gateway不能填nonestructured_output可选。厂商不支持服务端json_schema时填prompt产品会把 schema 写进提示词密钥不落盘http_headers/query_params里写了像密钥的值会被直接拒绝密钥只能经env_key/env_http_headers引用。模板如何映射到 Codex 配置、进程环境如何只透传必要变量详见 docs/model-access.md 与 orchestrator/src/providers.ts。三、一键接入UI 与命令行两条路 ⚡普通用户路径启动后进入左侧接入 AI→API 接入选择供应商填写 API 地址、模型名与 key点击测试并保存。页面会先发起一次真实对话探针成功才保存失败不会覆盖当前已生效配置。开发者路径用于跑完整矩阵# 1) 密钥只放环境变量变量名见模板 env_key export DEEPSEEK_API_KEY... # 2) 跑 10 项兼容矩阵 node orchestrator/src/finance/provider_matrix.ts --provider deepseek --model deepseek-v4-flash持久化配置写进.local/config.json{ provider: { profile: deepseek }, defaults: { model: deepseek-v4-flash } }优先级.local/config.json← 环境变量VRA_PROVIDER/VRA_PROVIDER_AUTH← CLI--provider/--auth。产品级默认见 vibe-research.config.json。四、读懂 10 项兼容矩阵 orchestrator/src/finance/provider_matrix.ts 会用 Codex SDK 对目标 Provider真跑 10 个小回合机器判定pass / partial / fail / n/a / error。运行在临时目录沙箱里无网络、不加载产品宪法结果写.local/provider-matrix/id/时间/落盘前做两层脱敏不含任何密钥。#项目pass 判据①单次文本回复含约定 token②单工具调用至少 1 条命令且输出含约定串③连续三轮工具调用step-A/B/C 出自不同命令项且按序④并行工具调用两条命令都执行且事件流观察到同时在途⑤工具失败自修复先失败 → 修复 → 最终回复说明⑥长流1–200 行编号一个不缺 流正常收尾⑦reasoning item事件里出现 reasoning 项不回传记 partial不算 fail⑧schema 严格输出最终回复为合法 JSON 且字段齐⑨多轮上下文延续第二回合能复述第一回合约定词⑩无 previous_response_id 延续responses 协议下由 Codex 内部处理记 n/a几个实用参数--tests 1,2,8只跑指定项快速定位问题--reasoning low|medium|high调 reasoning 档位第 ⑦ 项依赖模型回传推理摘要退出码0表示无 fail/error可直接接入 CI 式检查。真实案例小米 MiMo 实测mimo-v2.5结果为 pass 7 · partial 1 · error 1 · n/a 1其中 ⑧ 因厂商不支持json_schema报错——矩阵如实记录不粉饰产品侧用structured_output: prompt绕开见 providers/mimo.json。OpenAI 基线为 9 pass · 1 n/aproviders/openai.json。五、矩阵全绿后才算正式可用 ✅矩阵不全绿的 Provider 只可用于试验不应用于正式研究运行编排器会把 Provider 与矩阵状态写进每次运行的manifest.json。矩阵通过后按结果回填模板里的matrix.status/matrix.results/matrix.note。注意 ⑦ partial 是模型能力问题换更高档模型可能有 reasoning、④ partial 表示工具调用被串行化功能可用但慢、⑩ n/a 是当前所有 responses 模板的常态——不要误判为故障。⚠️ 百炼三件套qwen/glm/kimi模板里的{WorkspaceId}占位符必须换成自己的工作空间 ID否则选用时当场被拒。六、常见问题速查 报环境变量 XXX_API_KEY 未设置密钥只从环境变量读先export再运行。报不支持 authchatgpt_login第三方 Provider 只能api_key删掉显式设置即可。报引擎不再支持 wire_apichat旧模板改用厂商 Responses 端点或自建网关并填responses_support: gateway。报base_url 里还有未替换的占位符把模板复制到.local/providers/id.json改完再用。Responses↔Chat 自建适配器不在本仓库范围属于独立子项目。完整接入流程、订阅通道与局域网访问等细节建议通读官方文档 docs/model-access.md项目总览与安装步骤见 README.md。输出文章【免费下载链接】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），仅供参考 Vibe-Research 开发者指南：接入自定义 Provider 并跑通 10 项兼容矩阵
Vibe-Research 开发者指南接入自定义 Provider 并跑通 10 项兼容矩阵【免费下载链接】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支持每日复盘、资讯雷达、个股研究、回测等功能由你自己的 AI Agent 驱动。本文面向开发者讲清两件事如何接入一家自定义模型 Provider以及如何用 10 项兼容矩阵验证它真的可用。一、Provider 机制是什么Vibe-Research 基于开源 Codex Harness 构建Agent 引擎只认 OpenAI 兼容的Responses 协议。每家模型厂商对应一份 JSON 模板放在 providers/ 目录下官方说明见 providers/README.md。内置模板一览供应商信息核实于 2026-08-26id厂商环境变量默认模型openaiOpenAI 官方OPENAI_API_KEY引擎默认deepseekDeepSeek 官方 ResponsesDEEPSEEK_API_KEYdeepseek-v4-flashqwen/glm/kimi阿里云百炼DASHSCOPE_API_KEY各自模型mimo小米 MiMo 原生 ResponsesMIMO_API_KEYmimo-v2.5模板只引用环境变量名永不含真实 token密钥只经env_key声明的环境变量提供。二、新建一份自定义 Provider 模板 以自托管模型为例仓库自带占位模板 providers/selfhosted.json流程是复制 → 改字段 → 跑矩阵复制模板放到.local/providers/id.json用户私有覆盖同结构、优先级更高或参考 providers/deepseek.json 新建providers/id.jsonid小写字母开头只含a-z0-9_-且与文件名一致。填写关键字段字段要求wire_api只能responseschat会被契约层当场拒绝base_url第三方必须显式填写远程要 HTTPS本机localhost/127.0.0.1允许 HTTP如http://127.0.0.1:11434/v1留空会让 Codex 回退到 OpenAI 官方端点密钥会发错主机env_key大写变量名不能是 HOME / PATH 等受保护名auth_modes第三方只能[api_key]responses_support厂商自带/responses填native经自建网关转换填gateway不能填nonestructured_output可选。厂商不支持服务端json_schema时填prompt产品会把 schema 写进提示词密钥不落盘http_headers/query_params里写了像密钥的值会被直接拒绝密钥只能经env_key/env_http_headers引用。模板如何映射到 Codex 配置、进程环境如何只透传必要变量详见 docs/model-access.md 与 orchestrator/src/providers.ts。三、一键接入UI 与命令行两条路 ⚡普通用户路径启动后进入左侧接入 AI→API 接入选择供应商填写 API 地址、模型名与 key点击测试并保存。页面会先发起一次真实对话探针成功才保存失败不会覆盖当前已生效配置。开发者路径用于跑完整矩阵# 1) 密钥只放环境变量变量名见模板 env_key export DEEPSEEK_API_KEY... # 2) 跑 10 项兼容矩阵 node orchestrator/src/finance/provider_matrix.ts --provider deepseek --model deepseek-v4-flash持久化配置写进.local/config.json{ provider: { profile: deepseek }, defaults: { model: deepseek-v4-flash } }优先级.local/config.json← 环境变量VRA_PROVIDER/VRA_PROVIDER_AUTH← CLI--provider/--auth。产品级默认见 vibe-research.config.json。四、读懂 10 项兼容矩阵 orchestrator/src/finance/provider_matrix.ts 会用 Codex SDK 对目标 Provider真跑 10 个小回合机器判定pass / partial / fail / n/a / error。运行在临时目录沙箱里无网络、不加载产品宪法结果写.local/provider-matrix/id/时间/落盘前做两层脱敏不含任何密钥。#项目pass 判据①单次文本回复含约定 token②单工具调用至少 1 条命令且输出含约定串③连续三轮工具调用step-A/B/C 出自不同命令项且按序④并行工具调用两条命令都执行且事件流观察到同时在途⑤工具失败自修复先失败 → 修复 → 最终回复说明⑥长流1–200 行编号一个不缺 流正常收尾⑦reasoning item事件里出现 reasoning 项不回传记 partial不算 fail⑧schema 严格输出最终回复为合法 JSON 且字段齐⑨多轮上下文延续第二回合能复述第一回合约定词⑩无 previous_response_id 延续responses 协议下由 Codex 内部处理记 n/a几个实用参数--tests 1,2,8只跑指定项快速定位问题--reasoning low|medium|high调 reasoning 档位第 ⑦ 项依赖模型回传推理摘要退出码0表示无 fail/error可直接接入 CI 式检查。真实案例小米 MiMo 实测mimo-v2.5结果为 pass 7 · partial 1 · error 1 · n/a 1其中 ⑧ 因厂商不支持json_schema报错——矩阵如实记录不粉饰产品侧用structured_output: prompt绕开见 providers/mimo.json。OpenAI 基线为 9 pass · 1 n/aproviders/openai.json。五、矩阵全绿后才算正式可用 ✅矩阵不全绿的 Provider 只可用于试验不应用于正式研究运行编排器会把 Provider 与矩阵状态写进每次运行的manifest.json。矩阵通过后按结果回填模板里的matrix.status/matrix.results/matrix.note。注意 ⑦ partial 是模型能力问题换更高档模型可能有 reasoning、④ partial 表示工具调用被串行化功能可用但慢、⑩ n/a 是当前所有 responses 模板的常态——不要误判为故障。⚠️ 百炼三件套qwen/glm/kimi模板里的{WorkspaceId}占位符必须换成自己的工作空间 ID否则选用时当场被拒。六、常见问题速查 报环境变量 XXX_API_KEY 未设置密钥只从环境变量读先export再运行。报不支持 authchatgpt_login第三方 Provider 只能api_key删掉显式设置即可。报引擎不再支持 wire_apichat旧模板改用厂商 Responses 端点或自建网关并填responses_support: gateway。报base_url 里还有未替换的占位符把模板复制到.local/providers/id.json改完再用。Responses↔Chat 自建适配器不在本仓库范围属于独立子项目。完整接入流程、订阅通道与局域网访问等细节建议通读官方文档 docs/model-access.md项目总览与安装步骤见 README.md。输出文章【免费下载链接】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），仅供参考