前言¶
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 之間的協議差異。它通過運行時驗證和自動回滾機制，降低了配置錯誤的成本。
