← 返回列表
⚠ 装前注意
@huyang2024/dsh-openai-api
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/9/11 · 已提供中文文档
DeepSeek Harness (dsh) 的 OpenAI 兼容 HTTP 接口：在 harness webServer + llm 运行时上提供 POST /v1/chat/completions、POST /v1/responses、GET /v1/models
综合分
37
GitHub 分
37
用户评分
—
★ Stars
3
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add huyang2024/dsh-openai-api未发布到 npm registry，仅可从源码安装，改用 GitHub 源安装
信任档位：已验证本站已于 2 天前真实安装成功（L4 · 真实安装）
- 是什么
- dsh 原生插件 · chat
- 装得上吗
- 本站已真实安装成功（L4 · 真实安装，非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 14 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/24
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/20（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包@huyang2024/dsh-openai-api（未发布到 npm，仅可源码安装）
✓Node 引擎要求 >=20 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/20 06:31:01
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成@huyang2024/dsh-openai-api
为 DeepSeek Harness 提供标准 OpenAI 兼容 HTTP 接口的插件，由 真实 DSH Agent 会话 提供服务。
安装到 dsh 配置（profile）后，harness 的 Web 服务会额外提供：
| 接口 | 用途 |
| --- | --- |
| POST /v1/chat/completions | Chat Completions API（流式 + 非流式） |
| POST /v1/responses | Responses API 子集（流式 + 非流式） |
| GET /v1/models | 广告的模型 id |
“Agent 承载”含义
每个请求由 一个存活的 DSH Agent 会话 服务（harness 的 agents 注册表 + agent 循环），因此每次调用都获得 agent 的完整世界：其配置的工具、bash/文件访问、技能、提示词分段和预设人格。这是 agent 网关，不是轻量 LLM 代理：
- 工具调用由 agent 自主决定。客户端的 tools / tool_choice / function-call 消息会被拒绝——由 agent 决定调用哪些工具以及为什么。
- 流式 delta 按每一条已提交的 assistant 消息 到达，而非按 token。思考、工具调用和 token 级块流都不上线路；只有已提交的 assistant 文本到达客户端。
- 每个 (key, preset) 组合的首个请求会通过把客户端完整消息数组渲染成带标签的转写提示来播种会话；后续请求只接收最新用户轮次（会话已持有历史）。
会话身份
(API key 租户, X-Agent-Preset)：
- 被接受的 apiKey 为调用者命名空间 —— 每个 key 一个会话，因此不同 key 即使同 preset 也绝不共享会话，客户端重连会恢复自己的会话。
- X-Agent-Preset 头 指定会话加入的预设（缺省 → profile 默认预设）。仅在会话创建时解析。
安装
从 GitHub 安装
dsh plugin --profile web add github:huyang2024/dsh-openai-api
或本地目录安装
dsh plugin --profile web add file:/absolute/path/to/dsh-openai-api
再在 profile 用户补丁层 $DSH_HOME/profiles/web/cordis.patch.yml 中以 insert: 方式加入新行（补丁层的裸 {id, name} 条目只用于改写下层已有行，不会生效）：
- insert:
- id: openai-api
name: '@huyang2024/dsh-openai-api'
inject: [webServer]
config:
pathPrefix: '/v1' # 可选，默认值如此
apiKeys: [] # 可选，见下表
model: default # 可选；/v1/models 广告的模型 id
provider: '' # 可选；创建会话使用的 provider 路由
cwd: '' # 可选；会话绝对工作目录
重启 profile 使新行生效。
配置
所有键可选；创建的会话回退到宿主默认值。
| 键 | 默认 | 作用 |
| --- | --- | --- |
| model | default | /v1/models 广告的模型 id。请求 model（缺省或等于此值）时使用宿主默认选择；其它 id 作为模型传入会话。 |
| provider | 宿主默认 | 创建会话使用的 provider 路由。 |
| apiKeys | 未设 | 每客户端密钥。每个不同 key 是一个独立租户——每个 (key, preset) 一个会话。设置后，请求必须携带一个（Authorization: Bearer ），否则 401。未设置时，表面是单个无密钥租户，仅限本机回环 调用。 |
| cwd | dsh web 进程 cwd | 创建会话的绝对工作目录。必须以 / 开头。 |
使用 API
import OpenAI from 'openai'
const client = new OpenAI({ baseURL: 'http://127.0.0.1:3080/v1', apiKey: 'local-key' })
// 可选：指定会话加入的 agent 预设（缺省 → 默认预设）。
const preset = { 'X-Agent-Preset': 'custom-agent-preset' }
const reply = await client.chat.completions.create(
{ model: 'default', messages: [{ role: 'user', content: 'What are you?' }] },
{ headers: preset },
)
/v1/responses 遵循同一会话模型；previous_response_id 被接受但忽略（粘性会话本身就是存储）。
鉴权与信任
- 设置了 apiKeys：需要精确的 Authorization: Bearer ，匹配到的 key 即租户。
- 未设置 apiKeys：仅服务 本机回环 调用者（这是在参考实现基础上的刻意加固，避免误绑局域网端口后暴露未鉴权的 agent 访问）。
- 其它 Origin 的浏览器跨域调用被拒绝，除非列入 allowedOrigins 或携带有效密钥。三条路径都响应 OPTIONS 预检。
本地开发
node --check lib/index.js # 语法检查
node test/smoke.mjs # 基于假 agents 服务的协议测试