前言¶

DeepSeek Harness（DSH）支持通過插件擴展功能。如果你在本地使用 Open WebUI 管理 AI 模型，通常需要額外的配置才能將其作爲標準 API 調用。dsh-owui-chat2api 插件通過本地反向代理，將 Open WebUI 的模型暴露爲標準的 OpenAI 兼容 /v1 API，並內置了控制面板和用量統計功能。

核心功能¶

此插件主要提供以下能力：

• 代理控制與配置：可在面板中啓動或停止代理，檢查 Python 環境及依賴安裝情況。支持配置 Open WebUI 的 URL、代理監聽的 Host 和 Port。
• 用量與成本統計：提供今日、昨日、本月及總量的統計面板。按模型排名展示，並附帶顏色分量的條形圖。支持手動填寫價格表（按每百萬 Token 計算，緩存 Token 單獨計價），將統計數據轉化爲成本估算。
• 緩存追蹤：當後端返回緩存 Token 時，顯示緩存命中率卡片；未報告緩存時會給出明確提示。同時會顯示估算失敗的調用。
• 界面集成：
  • 支持 DSH Desktop 2.0.10+：在側邊欄以 Dock Tab 形式停靠，不遮擋對話。
  • 較舊版本：顯示爲右上角的浮動膠囊。
• 模型管理：支持一鍵同步模型和推理等級（Reasoning effort）。它會自動移除在 Open WebUI 中已刪除的模型，防止列表無限增長。
• 日誌與主題：提供帶錯誤高亮、跟隨模式、複製功能的進程日誌。界面使用 Tabler 圖標，支持 DSH 的深色/淺色主題，不發送任何外部請求。

安裝¶

使用 DSH CLI 安裝插件。該插件依賴 git（用於 pnpm 克隆倉庫）。

dsh plugin --profile desktop add github:Wecury/dsh-owui-chat2api#v0.10.0

安裝完成後，請重啓 DSH。

使用步驟¶

1. 驗證與登錄：重啓 DSH 後，右上角應出現 OWUI 膠囊圖標。點擊打開面板，首次點擊 Start 會彈出瀏覽器窗口，進行一次性的登錄。後續會複用該會話。
2. 配置：在面板中設置正確的 Open WebUI URL（默認爲佔位符）。
3. 依賴檢查：如果面板顯示 “Attention”，需在終端安裝 Python 依賴：

    pip install requests playwright
    playwright install

4. 同步模型：點擊面板中的 “Sync models & reasoning levels” 按鈕，然後重啓 DSH，模型列表纔會更新。

注意事項¶

• 環境依賴：確保本機已安裝 git。如果通過代理訪問，需先導出 http_proxy / https_proxy 環境變量。
• 數據隔離：Open WebUI 的會話數據（.chrome-profile、token.json）及用量數據庫均存儲在本地，不會包含在 git 提交中，也不會隨插件更新丟失。配置與用量數據庫位於 ~/.dsh 目錄。
• 網絡監聽：代理僅監聽 127.0.0.1。
• Windows 安裝問題：如果在 Windows 上安裝遇到 [ERR_PNPM_EPERM] 錯誤，通常是之前手動安裝留下的 Junction 鏈接阻礙了安裝。請刪除該鏈接（僅刪除鏈接本身，不要刪除目標文件夾），然後重新運行安裝命令。

概覽¶

• 插件名：dsh-owui-chat2api
• 維護者：Wecury
• 分類：模型推理
• 許可證：MIT
• 倉庫：https://github.com/Wecury/dsh-owui-chat2api