前言¶
在 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 支持維護。
