前言¶
DeepSeek Harness (DSH) 在调用自定义 OpenAI Chat Completions 端点时，有时会遇到请求体结构不匹配的问题。简单的连通性检查可能通过，但 Harness 默认的请求结构（如 developer 角色、max_completion_tokens 字段等）可能不被目标端点接受。DSH Provider Passport 是一个独立的社区插件，旨在 Harness 首次真实任务失败之前，通过有界、审查优先的预检机制，发现并修复这些请求方言差异。
插件定位¶
项目名称：armywas/dsh-provider-passport
维护者：ArmyWas
许可证：MIT
项目类型：模型推理插件
这是一个公开预览的插件，独立于 DeepSeek 官方，仅用于描述兼容性。
核心能力¶
1. 请求方言预检
插件会检查自定义端点与 Harness 之间的请求差异。它只提议 Harness 支持的兼容字段，并通过真实的 Harness LLM 运行时进行验证。如果验证失败，插件会自动恢复之前的设置，取消操作也不会写入配置。
2. 安全与隐私
* 内存安全：凭据和自定义头部仅保留在内存中，绝不会进入报告或日志。
* 请求限制：每次预检最多发送 10 个固定请求，每个请求最多 1 个输出 token，且每请求有 12 秒超时。
* 最小化影响：选定的模型仅接收最小的观察到的兼容配置文件，其他模型不受影响。
* 明确确认：每次预检都需要用户明确确认，且不运行后台任务。
3. 适用范围限制
* 路由必须明确声明 api: openai-completions。当省略 api 时，插件会排除该路由，而不是进行猜测。
* 提议的字段仅限于 maxTokensField、supportsDeveloperRole、supportsStore、supportsReasoningEffort 和 supportsUsageInStreaming。
* 使用 Responses、Anthropic Messages 或其他协议的路由不在范围内。
安装与启用¶
在使用前，请确保环境满足以下要求：
* Node.js 22.19+
* DeepSeek Harness Web 配置文件
执行安装命令：
npx @deepseek-ai/dsh plugin --profile web add dsh-provider-passport@preview
安装完成后启动 Harness Web：
npx @deepseek-ai/dsh web
使用流程¶
1. 进入插件界面
打开 设置 → 插件，展开 提供商兼容性护照。
2. 选择模型与预检
选择一个自定义 OpenAI Chat Completions 模型。审查请求预算（最多 10 个请求，每个 1 token，12 秒超时），并确认预检。
3. 验证与报告
插件会通过运行时验证更改。验证通过后，点击 复制脱敏报告。该报告会移除端点、模型 ID、凭据、请求文本、响应体和模型输出，适合提交给社区。
生态背景与注意事项¶
DSH 的理念是“一切皆插件”。该插件仅负责“最后一公里”的兼容性检查，不替代通用的 API、流式或工具合规性工具，也不涉及路由、回退或代理适配器。
在使用前，建议阅读源码并检查许可证。对于涉及敏感企业端点的测试，请先阅读隐私设计文档。
总结¶
DSH Provider Passport 提供了一种安全、受控的方式来排查自定义 OpenAI 兼容端点与 Harness 之间的协议差异。它通过运行时验证和自动回滚机制，降低了配置错误的成本。
