前言¶
在 DeepSeek Harness（DSH）里跑智能体，常见摩擦不在「能不能调模型」，而在 Provider 怎么登、默认模型怎么切、纯文本模型遇到图片怎么办、以及 token 和费用能不能在原生界面里看清。社区里有人用 API Key 填配置，有人自己拼 OAuth 回调，还有人把用量统计拆到外部脚本——每条路都能走，但维护成本不低。
dsh-AuthInOne 是社区维护的 DSH 插件，把 Provider 登录、模型管理、可选视觉回退、用量与成本统计，以及同端口 Web 重启收进一个自包含安装流程。下面按「是什么 → 能做什么 → 怎么装 → 怎么用 → 注意什么」介绍。
这是什么¶
dsh-AuthInOne（GitHub：Stormycry-cryp/dsh-AuthInOne）面向 DSH 的 Models 与 Usage 设置页，提供：
- Provider / 账号登录（含 OpenAI Codex、Kimi Code 及若干实验性兼容流程）
- API Key 与自定义 OpenAI 兼容 Provider 配置
- 未来会话默认模型切换
- 主模型声明纯文本输入时的可选视觉回退
- 跨会话 token 用量与可审计的成本统计
- 安装后在同 URL、同端口重启 Web，无需改 DSH 核心或手动改 profile
维护者：Stormycry-cryp。当前版本：Alpha v0.2.0-alpha.4，兼容目标为官方 DSH 47f9438。许可证：MIT。项目为社区维护，非 DeepSeek 或 OpenAI 官方产品。
SkillHub 目录分类为「模型推理」，截至撰写时 GitHub 约 64 stars。
核心功能¶
以下能力均来自项目 README 中的 Verified capabilities 与账号支持矩阵，仅列已标明验证状态的部分。
Provider 与账号登录¶
OpenAI Codex（稳定）：浏览器 OAuth，使用 state、S256 PKCE 与 loopback 回调；验证已到 auth.openai.com 用户确认边界。
Kimi Code（实验性）：基于 RFC 8628 设备流的完整授权链接；链接内嵌短码，用户通常只需登录并确认。
实验性兼容账号（均标为 Experimental compatibility，验证到各 Provider 授权边界）：xAI Grok、Anthropic、GitHub Copilot、Command Code、Cursor、Google Antigravity、Kiro。
凭证处理原则：OAuth verifier、授权码、设备码、access token、refresh token 留在 Host；插件不导入 ~/.codex/auth.json、OpenCodex 状态、Cookie、浏览器存储、OTP 或其他产品的凭据。
API Key 与自定义 Provider¶
支持通过 DSH 原生 Models 页管理 API Key Provider（含 DeepSeek API Key 实呼验证）及自定义 OpenAI 兼容 Base URL、请求头、模型映射；AuthInOne 保留原生 Models 卡片并读取其公开 Provider 投影。
Plan/API 预设覆盖 OpenAI、xAI、Gemini、Anthropic、Kimi Code、GLM Coding Plan、ModelStudio/Qwen 等；GLM 与 Qwen 的使用限制会在界面保留显示。
模型切换与视觉回退¶
可在不替换 DSH 每会话模型选择器的前提下，设置未来会话的默认模型，并支持连接测试。
当所选主模型显式声明仅支持文本输入时，可单独配置视觉模型，仅在需要时对图片做描述。支持 PNG、JPEG、WebP、GIF，通过 DSH ImageBlock 引用；多图、原生多模态透传、关闭回退等路径有对应测试覆盖。
用量与成本统计¶
在 Settings → Usage 提供跨会话 token 活动、模型/Provider 维度统计、时间桶与成本投影。README 记载：基于真实 DSH 会话日志重建了 26,383 Token 的 KPI、热力图等投影。部分 Provider（如 Codex、Kimi、xAI、Anthropic、Cursor、Antigravity）在上游有数据时支持订阅配额展示，属 best effort。
同端口自包含安装¶
安装命令由本包提供：校验运行中的标准 DSH Host，走官方 dsh plugin add 路径，再在同一 URL 上替换该 Host。不需要打补丁的 DSH 核心、手动改 profile、第二个 Web 实例或临时端口。
安装与启用¶
环境需已安装 pnpm，且本机有正在运行的标准 DSH Web profile。
官方安装命令（README 文档版本，对应 v0.2.0-alpha.4）：
pnpm dlx github:Stormycry-cryp/dsh-AuthInOne#v0.2.0-alpha.4 install --profile web
说明：将上述命令作为一条完整操作执行，不要拆成手动 dsh plugin add 再加即兴重启。引导程序会校验监听器、经官方 DSH 插件 CLI 安装、回到原 URL 并报告 ready 后再接受 UI 操作。若引导程序因未知 launcher 或 DSH owner 指纹拒绝，应停止并按报错处理，不要猜测绕过。
非默认端口、源码检出安装与升级/卸载方式见 GitHub README 的「Install, upgrade, and remove」章节。
典型用法¶
安装完成并确认 Web 就绪后：
- 打开 DSH，进入 Settings → Models 或 Settings → Usage。
- 在 Models 页：按需完成 Codex / Kimi 等账号授权，或填写 API Key / 自定义 OpenAI 兼容 Provider；设置未来会话默认模型；必要时配置视觉回退模型。
- 在 Usage 页：查看 token 活动、按模型与 Provider 的用量分布及成本统计；有上游配额数据时可在 Models 页查看订阅额度（best effort）。
浏览器侧会收到聚合用量、脱敏状态、授权 URL，以及在需要时的 user code；敏感令牌不离开 Host。
适用场景与注意¶
适合：
- 希望在 DSH 内完成 OpenAI Codex 或 Kimi Code 登录，或明确接受实验性兼容流程；
- 在原生 Models 页统一管理 API Key 与自定义 OpenAI 兼容 Provider；
- 需要默认模型切换、纯文本主模型的图片回退、可重建的 token/成本统计。
注意：
- 插件以当前 DSH 进程权限运行；安装前请自行审阅源码与 MIT 许可证。
- 七个额外账号流程均为实验性兼容，行为可能随上游变更；OpenAI Codex 为 README 中标注的稳定路径。
- 最低兼容：多数账号与视觉回退能力要求官方 DSH
47f9438与 bundled compat owner；部分 API Key 能力在 DSH0.1.0-rc.6已验证。 - SkillHub 为独立社区目录，与 DeepSeek / 幻方无官方从属关系；插件同样为社区项目。
链接¶
- SkillHub 目录：https://www.skillhub.cn/plugins/Stormycry-cryp/dsh-AuthInOne
- GitHub 仓库：https://github.com/Stormycry-cryp/dsh-AuthInOne
若该插件对你有用，可在 GitHub 为项目点 Star 支持维护。
