OMP HepAI Provider

English | 简体中文

HepAI 是**中国科学院高能物理研究所计算中心**建设的人工智能平台，面向粒子物理、天体物理、同步辐射、中子科学、加速器等多领域，连接模型、数据、算力、专业知识、科研软件和智能体，推动AI成为可复用、可共享的新型科研基础设施，加速科学发现。平台基于分布式部署框架（HaiDDF）将人工智能要素（如：模型、科学工具、数据、智能体等）转换为可发现、可接入、可交互和可重用的资源，聚合多种主流大语言模型，通过兼容标准接口的方式供用户调用。 本插件在oh-my-pi Harness中注册 hepai，发现当前 API Key 可用的模型，保留原始模型 ID，并使用 OMP 的 Responses、Chat Completions 和 Anthropic Messages 传输协议。上游 API 由 HepAI/HaiDDF 提供。

HepAI 与上游链接

• HepAI Portal：https://ai.ihep.ac.cn
• HepAI 生产 API：https://aiapi.ihep.ac.cn/apiv2
• HepAI API 参考文档
  • https://aiapi.ihep.ac.cn/#/api-reference/docs
  • https://docs-ai.ihep.ac.cn/s/hai/doc/api-UticaXRzFe
• HaiDDF 源码仓库：https://github.com/stcapo/hai-ddf
• HepAI平台介绍与使用教程：https://indico.ihep.ac.cn/event/30798/

HepAI API 兼容性实测日期： 2026/09/23。

HepAI 金额以 CNY 计价：catalog 单价、经费/credit、original_price、discount_amount、payable_amount，以及所有 cost_breakdown.*.cost（包括 internal_reasoning）。插件按 CNY × 0.143 写入 OMP 的 USD 字段。token 数量、计量数量、ID 和 total_discount_rate 保留原值。

HepAI API

模型 API 与云模型列表使用 https://aiapi.ihep.ac.cn；网站 SSO、模型详情与账单使用 https://ai.ihep.ac.cn。

方法	API域名	路径	鉴权	用途
GET	https://aiapi.ihep.ac.cn	/apiv2/models	模型 API Key	当前 Key 可访问模型的权威列表
GET		/apiv2/portal/model/list_cloud_models?page=1&page_size=-1	无	完整初始模型目录与元数据兜底
POST		/apiv2/responses	模型 API Key	Responses transport 与探测
POST		/apiv2/chat/completions	模型 API Key	Chat Completions transport 与探测
POST		/apiv2/anthropic/v1/messages	模型 API Key	Anthropic transport 与探测
GET	https://ai.ihep.ac.cn/	/oauth/ihep/login	浏览器 SSO 会话	获取网站 hai_refresh cookie
POST		/api/v1/auths/refresh	hai_refresh cookie、X-HAI-Session: 1	换取/续签网站 token
GET		/apiv2/portal/model/cloud_models_details?model_name=<id>	网站 SSO token cookie 和 Bearer token	单个可访问模型的可选元数据
POST		/apiv2/portal/billing/invoke_records	网站 token	调用记录与权威账单金额

OMP Anthropic transport 接收的 base URL 是 https://aiapi.ihep.ac.cn/apiv2/anthropic，并自行追加 /v1/messages。

快速开始

在父级 workspace 中运行：

npm install
omp plugin link .\omp-provider-hepai

然后在 OMP 中运行：

/hepai-login
/reload
/model

/hepai-login 接收用户提供的 HepAI 模型 API Key，并保存到 OMP AuthStorage。GET /apiv2/models 列出该 Key 可访问的模型。

模型 ID 不区分大小写包含以下任一关键词时归入 Specific 类：

• BOSS
• COMET
• HXMT
• BESIII
• HEPS
• NRS
• NPD
• XRD
• XIWU
• OCLIMAX
• reconstruct
• particle
• sensor
• materials
• protein
• algorithm
• simulation
• metadata
• filter
• analysis
• number

这类模型默认剔除；如需保留，关闭插件设置并刷新模型目录：

omp plugin config set omp-provider-hepai filterSpecificModels false
omp models refresh

将其设为 true 并再次刷新即可重新过滤。

模型 ID 不区分大小写包含以下任一关键词时归入 Agent 类：

• agent
• master
• Dr
• explorer

也默认剔除。如需保留，关闭独立的 Agent 过滤开关并刷新：

omp plugin config set omp-provider-hepai filterAgentModels false
omp models refresh

将其设为 true 并再次刷新即可重新过滤。

技术行为

凭据

扩展注册两个相互独立的 provider：

Provider ID	凭据	用途
hepai	HepAI 模型 API Key	模型发现和推理
hepai-website-sso	网站 hai_refresh cookie 与 token	模型详情元数据与账单

网站 token 作为 Bearer token 和 token cookie 用于模型详情及网站账单。模型 API Key 用于 /apiv2/models 和推理接口。初始云模型列表请求不带 Authorization 头。

模型发现

OMP 解析 hepai 凭据后调用 provider 的动态模型加载器。

1. 有模型 API Key 时，加载器先请求 GET /apiv2/models；请求成功后以其模型 ID 为准。
2. 加载器单次请求 /portal/model/list_cloud_models?page=1&page_size=-1，取得兜底模型 ID 和元数据，再对候选 ID 去重。/apiv2/models 请求失败时使用云模型列表中的 ID。
3. 在执行任何过滤之前，插件使用完整的去重候选集，对每个 ID 向 ai.ihep.ac.cn 请求 /portal/model/cloud_models_details?model_name=<id>，并限制并发数。网站 SSO 预检或登录成功后会触发 OMP 在线模型目录刷新。
4. 详情记录按模型 ID 精确匹配，再按云模型列表 → 网站详情 → /apiv2/models 的优先级合并非空字段。所有候选模型的详情请求与元数据合并完成之后，才开始执行过滤。五轮过滤及后续映射规则见下文。

完整注册顺序

1. 读取 /apiv2/models；成功时只允许注册该响应 data[].id 中的模型。该请求失败时，改用云模型列表的 model_name → id。
2. 对候选 ID 去重，然后在执行任何过滤之前为每个候选 ID 请求网站详情。详情响应必须按 id 或 model_name 与请求 ID 精确匹配，不能引入候选列表以外的模型。
3. 同一 ID 的记录按云模型列表 → 网站详情 → /apiv2/models 顺序合并，后者的非 null、非 undefined、非空字符串字段覆盖前者；显示名字段还会把占位字符串视为空值，不能覆盖低优先级来源中的有效名称。这是字段级浅合并，嵌套对象不做递归合并。
4. 对合并结果依次执行五轮过滤：无有效显示名 → ID 含 demo → 无斜杠重复 ID → Specific → Agent。精确 ID aliyun/qwen3.8-max、moonshot/kimi-k3 和 Metadata_completion_model 豁免前三轮过滤，但不豁免 Specific 或 Agent 过滤；后两轮由开关控制且默认开启。
5. 无论后两个开关实际是否关闭，另行按 Specific、Agent 均开启计算“完整五轮过滤存活集”。只有这个集合中的模型才执行下表的 Context/Max output fallback 和 K-token 单位修正。因关闭后两个开关才重新出现的模型保留原始数值。
6. 将实际可见模型映射为 ProviderModelConfig，再按 provider 分组、显示名自然排序、ID 破同名并列，最后由 fetchDynamicModels 返回给 OMP。

fetchDynamicModels 返回的动态模型目录由 OMP 写入其 SQLite model cache，并按 OMP 的缓存生命周期复用；插件不另建模型注册数据库。omp models refresh 会强制重新执行完整流程并更新该缓存。

Provider 注册参数

OMP registerProvider("hepai", …) 参数	写入值或来源
baseUrl	https://aiapi.ihep.ac.cn/apiv2
api	hepai-auto
streamSimple	插件的自动传输路由：Responses / Chat Completions / Anthropic Messages
authHeader	true，模型 API Key 以 Bearer 认证发送
apiKey	正常运行不写；仅 HEPAI_DEV_USE_ENV=1 时设为环境变量名 HEPAI_API_KEY
fetchDynamicModels(apiKey)	执行上述发现、合并、过滤、映射和排序流程

注册模型字段对应表

下表中的 JSON 路径均相对于上述三个来源合并后的单个模型记录。valid(x) 表示有限非负数；价格结果统一执行 Number(value.toFixed(12))。

OMP ProviderModelConfig 字段	HepAI JSON 字段或公式	缺失、异常及补充规则
id	/apiv2/models.data[].id；该接口失败时为云列表 data[].model_name，再退到 data[].id	原样保留、精确去重；详情记录不改变 ID
name	第一个有效的 display_name（字符串或数组元素）→ display_label → 豁免 ID 的显示名	""、纯空白、"{}"、"[]"、"null"、"undefined" 不区分大小写视为无效；非豁免模型没有有效名称时在第一轮过滤中剔除
api	固定值 "hepai-auto"	不从 HepAI JSON 读取
reasoning	固定值 true	不采用不完整或错误的 is_reasoning / capabilities.reasoning
thinking	插件不直接写入	OMP 根据模型 ID、reasoning: true 和内置 catalog/policy 生成实际思考强度；上游最终决定请求是否接受
input	基础值 ["text"]；若 capabilities.input_modalities ?? input_modalities 数组包含 "image"，则为 ["text", "image"]	其他模态不写入当前 OMP 字段
contextWindow	正整数 context_window ?? limitations.context_window，取整	完整五轮过滤存活集内：Context 缺失或原始组合为 8192/2048 时，使用 OMP bundled catalog 参考值；无参考时为 128000。否则若 Context 与 Max output 都 <=1024，Context 乘 1000
maxTokens	正整数 max_output_tokens ?? limitations.max_output_tokens，取整	触发上述 fallback 时使用 OMP 参考模型 maxTokens，并限制为不超过参考 Context；无参考时为 min(32768, contextWindow)。否则若两个原始值都 <=1024，本值乘 1000；仅本字段缺失而 Context 有效时为 16384
cost.input	round12(valid(input_price_per_mtoken) ?? valid(model_pricing.pricing_details.input_cost_per_million_tokens) ?? valid(model_pricing.pricing_details.rates.prompt) ?? 0) × discount × 0.143	实际实现先选原价，再整体乘折扣和汇率并舍入；表中 round12 表示对整个乘积舍入
cost.output	(valid(output_price_per_mtoken) ?? valid(model_pricing.pricing_details.output_cost_per_million_tokens) ?? valid(model_pricing.pricing_details.rates.completion) ?? 0) × discount × 0.143，最后 round12	缺失或非法原价为 0
cost.cacheRead	(valid(model_pricing.pricing_details.cache_read_input_cost_per_million_tokens) ?? valid(model_pricing.pricing_details.rates.input_cache_read) ?? 0) × discount × 0.143，最后 round12	缺失或非法原价为 0
cost.cacheWrite	(valid(model_pricing.pricing_details.cache_creation_cost_per_million_tokens) ?? valid(model_pricing.pricing_details.rates.input_cache_write) ?? 0) × discount × 0.143，最后 round12	缺失或非法原价为 0
premiumMultiplier、preferWebsockets、headers、compat	不写入	OMP 可在注册后的模型构建与 policy 解析阶段补充适用的运行时数据；不是 HepAI JSON 的直接映射

四项价格公式中的 discount = valid(model_pricing.discount_rate) ?? 1，单位均为 USD/百万 token。这里是会话进行中的 catalog 估价；完成请求后的账单结算仍按后文的权威账单字段重写费用。

动态加载器返回的注册模型先按最高优先级的可用 provider 字母排序分组，组内按显示名称自然排序，同名时按 ID 排序。缺少 provider 时使用模型 ID 中 / 前的前缀；无前缀的模型归入 Other。模型 ID 与显示名称不变。OMP 模型选择器另有显示排序规则。

没有 SSO 时，模型发现使用云模型列表元数据。Context 缺失按上表查询 OMP catalog 或使用 128000/32768；仅 Max output 缺失时使用 16384；未知价格为 0。

传输路由

注册的模型 API 为 hepai-auto，由 OMP 内置传输协议处理流式响应。

模型 ID	初始顺序
包含 claude 或 anthropic/ 片段	Anthropic Messages → Responses → Chat Completions
其他 ID	Responses → Chat Completions → Anthropic Messages

传输成功前暂存事件。每个模型 ID 最后成功的传输协议保存在 OMP agent 目录的 cache/hepai-transports.json（通常位于 ~/.omp 下），重启后继续使用。文件只保存模型 ID 和协议名称。已缓存协议出现兼容性错误时，先删除该条目再尝试其他协议；认证错误和上游错误不会使其失效。

遇到 HTTP 400、404、405、422 等协议/模型兼容错误时尝试下一个传输协议。以下情况停止路由：

• HTTP 401 或 403；
• HTTP 5xx；
• 协议/模型兼容错误之外的流错误。

可选传输诊断

正常请求会自动选择并缓存可用传输协议。/hepai-test <model-id> 是可选的排障命令，会并行向三个推理 endpoint 各发送一个最小非流式请求，并将结果分类为：

• supported
• model-unsupported
• auth-failed
• endpoint-missing
• request-rejected
• upstream-error

若有一个或多个协议可用，命令会按正常优先级报告建议协议，不修改路由或持久缓存。探测会产生真实、可能计费的 API 请求，输出上限为 16 token。

命令

命令	行为
/hepai-login	提示输入 hepai 模型 API Key，并保存到 OMP AuthStorage
/hepai-test <model-id>	可选传输诊断；探测三种协议，省略参数时使用当前选中的 HepAI 模型
/login hepai-website-sso	打开 https://ai.ihep.ac.cn/oauth/ihep/login，并将网站刷新会话及 token 保存到 OMP
/hepai-website-auth	报告 hepai-website-sso 是否已保存，并显示登录命令
/hepai-settle	恢复当前 session 中 pending 账单的精确 ID 结算

网站 SSO 与账单

模型发现与推理使用模型 API Key。网站 SSO 提供模型详情与账单。

/login hepai-website-sso 通过 OMP browser-session 捕获网站的 hai_refresh cookie，再调用 POST /api/v1/auths/refresh 取得网站 token。OMP 将刷新 Cookie 和 token 保存为 OAuth 凭据；JWT 剩余有效期小于 900 秒时，插件会在使用前通过相同接口续签。

网站登录使用隔离的 Chromium 会话，按刷新接口 URL 匹配 hai_refresh 的 Path 范围；捕获后关闭浏览器。JWT每次签发的有效期均为 3,600 秒，hai_refresh 不轮换。

每个 OMP 进程首次 session_start 时检查网站 SSO；已保存的有效 hai_refresh 可在无界面模式下续签网站 token。刷新会话缺失或失效时，交互式 TUI 打开 browser-session SSO；无界面模式需之后执行 /login hepai-website-sso。IHEP 用户名和密码留在浏览器 SSO 流程中。

响应与账单的精确关联

每次模型请求成功后，插件从响应头提取 x-request-id 作为 requestId、可选的 x-trace-id 作为 traceId，并以响应体的 id 作为 responseId。OMP 将 responseId 保存在 assistant 消息中。插件先把 requestId、traceId、responseId、请求时间和 session 路径写入 <session>.hepai-billing.json，再启动账单查询。

查询向 /apiv2/portal/billing/invoke_records 发送 page、page_size、start_date 和 end_date。接口会忽略请求体中的 request_id，因此插件在请求时间前后各 1 天的范围内逐页读取，每页 100 条，直到精确匹配或读完接口报告的总页数。只有 remarks.request_id === requestId 且已捕获 trace ID 时 remarks.trace_id === traceId 才算匹配。记录顺序、时间接近程度、响应体 id 和账单 invoke_id 都不是匹配键；匹配后才保存 invoke_id。

读取过的账单缓存在 OMP 全局 agent 目录的 <agentDir>/cache/hepai-invoices.json（默认 ~/.omp/agent/cache/hepai-invoices.json）。<agentDir> 随 OMP 当前 profile 或 PI_CODING_AGENT_DIR 确定，因此同一 profile 的 session 共用缓存，不同 profile 不混用。记录在 30 天后失效，并在下次写入时清理。缓存以 requestId 为键；命中后无需再次逐页查询。缓存只保存 request/trace ID、账单 ID、请求时间、token 数和账单金额，不保存原始 remarks、用户名、API Key、请求头、prompt 或响应预览。

Session 真实费用结算

精确匹配账单后，插件先把实际嵌套结构或旧版顶层结构规范化并持久化到 sidecar billing，再只从这份 sidecar billing 映射 OMP session Usage。HepAI 的 completion/output_tokens 与 internal_reasoning/reasoning_tokens 是两个独立 token 计费组，彼此不是子集。OMP 只有一个 output 费用桶，因此映射时 usage.output = completion + internal_reasoning，同时以 reasoningTokens 标记其中由 HepAI 单独计费的 reasoning 数量；totalTokens 为 input、合并后的 output 和两种 cache token 数之和。顶层 payable_amount 换算为 USD 后写入 sidecar，并成为 OMP 的权威总费用。

实际读取字段及缺失时的 fallback 顺序如下。顺序从左到右；无效值（非有限数、负 token 或非整数 token）视为缺失。可选 token 分项全部缺失时为 0，但 payable_amount 缺失时拒绝结算，防止把估算费用误写成权威账单。

HepAI 理论上有五个标准计费组：prompt、completion、input_cache_read、input_cache_write 和 internal_reasoning。实际账单是稀疏响应：某组的 token 或费用为 0 时，std_amounts、std_costs 或 cost_breakdown 中可能完全不返回该组。只要账单提供了任一 cost_breakdown，未出现的组就按账单值 0 处理，不会用 OMP 估算费用补回；只有整个新旧 cost_breakdown 都缺失时，才保留响应结束时的 OMP 估算分项。

HepAI 来源及 fallback	先写入 sidecar billing	再由 sidecar 写入 OMP session
input_tokens = standard_invoke_record.input_tokens → *.std_amounts.prompt → prompt/input breakdown amount → 0	standard_invoke_record.input_tokens = input_tokens	usage.input = billing.standard_invoke_record.input_tokens
completion_tokens = standard_invoke_record.output_tokens → billing_basis.usage.output_tokens → *.std_amounts.completion → completion/output breakdown amount → 0	standard_invoke_record.output_tokens = completion_tokens	usage.output = billing.standard_invoke_record.output_tokens + billing.standard_invoke_record.reasoning_tokens
reasoning_tokens = standard_invoke_record.reasoning_tokens → usage.output_tokens_details.reasoning_tokens/thinking_tokens → *.std_amounts.internal_reasoning → reasoning breakdown amount → 0	standard_invoke_record.reasoning_tokens = reasoning_tokens	usage.reasoningTokens = billing.standard_invoke_record.reasoning_tokens；它是合并后 usage.output 的子集
cache_read_tokens = standard_invoke_record.cache_read_tokens → *.std_amounts.input_cache_read → usage.cache_read_input_tokens → cache-read breakdown amount → 0	standard_invoke_record.cache_read_tokens = cache_read_tokens	usage.cacheRead = billing.standard_invoke_record.cache_read_tokens
cache_write_tokens = standard_invoke_record.cache_write_tokens → *.std_amounts.input_cache_write → usage.cache_creation_input_tokens → cache-write breakdown amount → 0	standard_invoke_record.cache_write_tokens = cache_write_tokens	usage.cacheWrite = billing.standard_invoke_record.cache_write_tokens
上述 token 桶	不另存 totalTokens；可由上述字段重算	usage.totalTokens = usage.input + usage.output + usage.cacheRead + usage.cacheWrite
prompt_cost = billing_basis.cost_breakdown.prompt.cost → 旧版 prompt.cost/input.cost → 0	cost_breakdown.prompt.cost = prompt_cost × 0.143	usage.cost.input = billing.cost_breakdown.prompt.cost × billing.total_discount_rate
completion_cost = completion.cost/output.cost → 0	cost_breakdown.completion.cost = completion_cost × 0.143	usage.cost.output = (billing.cost_breakdown.completion.cost + billing.cost_breakdown.internal_reasoning.cost) × billing.total_discount_rate
reasoning_cost = internal_reasoning.cost → 0	cost_breakdown.internal_reasoning.cost = reasoning_cost × 0.143，独立保留	不单独写入 OMP Usage
cache_read_cost = input_cache_read.cost → cache_read.cost/cacheRead.cost → 0	cost_breakdown.input_cache_read.cost = cache_read_cost × 0.143	usage.cost.cacheRead = billing.cost_breakdown.input_cache_read.cost × billing.total_discount_rate
cache_write_cost = input_cache_write.cost → cache_write.cost/cacheWrite.cost → 0	cost_breakdown.input_cache_write.cost = cache_write_cost × 0.143	usage.cost.cacheWrite = billing.cost_breakdown.input_cache_write.cost × billing.total_discount_rate
顶层 payable_amount；缺失或无效时拒绝结算	payable_amount = payable_amount × 0.143	usage.cost.total = billing.payable_amount
顶层 original_price → payable_amount + discount_amount → payable_amount	original_price = original_price × 0.143	不单独写入 OMP Usage
顶层 discount_amount → max(0, original_price - payable_amount)	discount_amount = discount_amount × 0.143	不单独写入 OMP Usage

其中 total_discount_rate = billing_basis.total_discount_rate → 顶层 total_discount_rate → 1。该折扣率写入 sidecar billing.total_discount_rate，并只用于账单提供 breakdown 时计算 OMP 分项费用；sidecar 的各组 cost_breakdown.*.cost 保存换算为 USD 的折扣前金额，总费用始终直接使用 payable_amount × 0.143。

当 standard_invoke_record 存在时，其规范 token 数优先于所有重复字段；billing_basis.usage 和 std_amounts 只补缺失字段，不覆盖规范值。HepAI 的 completion 和 reasoning token 独立计量、独立计价；由于 OMP 要求 reasoningTokens 是 usage.output 的子集，插件只在 sidecar → OMP 映射层将两者合并进 output。实际嵌套 breakdown 和旧版顶层 breakdown 都按 CNY 换算后进入 sidecar；存在 breakdown 时，省略的零值组保持为零，只有整个 breakdown 缺失时才保留 OMP 估算分项。

五组费用的 cost 均是 HepAI 返回的 CNY 分项原价。插件计算 OMP 分项费用时使用 cost × total_discount_rate × 0.143。如果账单存在 cost_breakdown，其中未出现的组表示该组费用为 0；只有整个嵌套及旧版 cost_breakdown 都缺失时，才保留模型响应结束时的 OMP 估算分项。payable_amount × 0.143 始终是 OMP cost.total 的权威值，因此分项之和不被用来替代总价。

存在旧结构 cost_breakdown 时的字段映射：

• payable_amount 写入 usage.cost.total，包含全部收费项目。
• original_price、discount_amount、payable_amount 和每个 cost_breakdown.*.cost 按 CNY × 0.143 换算；token amount 和 total_discount_rate 保留原值。
• sidecar 记录 currency: "USD"、sourceCurrency: "CNY"、exchangeRate: 0.143 以及完整换算后的 breakdown，包括 internal_reasoning。
• usage.output 合并 completion 与 internal_reasoning token；usage.cost.output 合并两者折后费用。reasoningTokens 标识推理子集，totalTokens 只计算一次合并后的 output。input 与 cache 项写入对应 OMP 字段。
• ID 关联和账单明细以外的敏感调用字段不写入 sidecar。

结算按 responseId 定位 assistant entry，更新其 OMP Usage，并通过 SessionManager.rewriteEntries() 持久化。随后由 @oh-my-pi/omp-stats 重新 ingest。每个 request ID 结算一次。pending 记录跨重启保留；重试耗尽后标为 failed。SSO 登录后，重启或 /hepai-settle 会重试 pending 和 failed 记录。

SSO 要求

• 网站 SSO 登录使用 OMP 内置的 Chromium 启动器。
• Chromium 需要访问 ai.ihep.ac.cn 和 newlogin.ihep.ac.cn。Windows 上遇到 ERR_CONNECTION_CLOSED 时，为 browser-session 配置系统代理；它不继承 HTTP_PROXY/HTTPS_PROXY。
• 网站 SSO 从 ai.ihep.ac.cn 发起，IHEP 统一认证由 newlogin.ihep.ac.cn 完成。

配置与安全

隔离开发时，HEPAI_DEV_USE_ENV=1 让 OMP 读取 HEPAI_API_KEY。正常登录使用 /hepai-login。

OMP 将凭据保存在本地 SQLite AuthStorage。使用账户权限和磁盘加密保护 OMP 数据目录、session sidecar 和账单缓存；SQLite 凭据没有明确的 DPAPI 或系统钥匙串保护。

Catalog 价格按 CNY price × model_pricing.discount_rate × 0.143 提供临时 USD 分项估算，折扣率缺失时按 1。结算用 payable_amount × 0.143 替换总费用；只有账单提供 cost_breakdown 时才替换分项价格，并使用账单自身独立的 total_discount_rate。OMP 成本字段没有币种标记，界面可能显示固定 $ 前缀。

开发与验证

在父级 workspace 中运行：

npm run typecheck --workspace omp-provider-hepai
npm test --workspace omp-provider-hepai
npm run build --workspace omp-provider-hepai

真实服务集成测试使用临时 OMP 配置，发现 HepAI 模型并执行一次生成：

$env:HEPAI_E2E = "1"
bun test test/omp-auth-e2e.test.ts

运行前在环境变量中设置 HEPAI_API_KEY。该测试会产生真实费用，从 PATH 查找 omp；OMP_BIN 可指定其他可执行文件。