前言¶

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