前言¶
在 DSH 里接 xAI 模型，常见做法是配置 XAI_API_KEY，走内置 xai API 路由按密钥计费。若你已有 xAI SuperGrok 或 X Premium 订阅，更希望把订阅额度用在本地对话里，而不是单独再开一套 API Key，就需要一条「登录订阅、映射成模型路由」的通路。
社区插件 dsh-xai-auth（维护者 pzyyll，分类：模型推理）通过 cli-chat-proxy 完成 OAuth 登录，在 DSH 中提供 xai-supergrok/... 模型路由；内置 xai 路由保持不变，无需 XAI_API_KEY。
这是什么¶
dsh-xai-auth 是 DeepSeek Harness 的插件：登录 xAI SuperGrok（或 X Premium）订阅后，将订阅能力以 xai-supergrok 模型路由 暴露给 DSH 对话。仓库已包含预构建入口 dist/index.js，从 GitHub 安装时无需本地构建。
- 目录页：https://www.skillhub.cn/plugins/pzyyll/dsh-xai-auth
- 源码：https://github.com/pzyyll/dsh-xai-auth
- 许可证：MIT（package 版本 0.1.0）
核心功能¶
下面能力均来自项目 README，安装后可在插件页操作。
- Sign in / Sign out：OAuth 登录与本地凭据清除；Sign out 只删本地凭据，不会在 xAI 侧撤销 token。
- xai-supergrok 模型列表：对话里可选
xai-supergrok/...模型；插件页 Refresh models 刷新列表。 - Usage：展示订阅额度与账单相关信息；读取结果缓存 2 分钟。选中
xai-supergrok模型时，聊天输入区也会显示剩余额度百分比。 - 可选 API 端点：设置环境变量
GROK_OAUTH_USE_API_URL=1时，改用https://api.x.ai/v1，而不是默认的 cli-chat-proxy。
说明：列表里展示的模型价格是短上下文 API 价，不是订阅用量；订阅以 Usage 为准。
安装与启用¶
依赖 dsh >=0.2.0 <0.3.0。默认 profile 已包含插件所需服务。
从 GitHub 安装（将 <profile> 换成你的 profile 名）：
dsh plugin --profile <profile> add github:pzyyll/dsh-xai-auth
仓库自带 dist/index.js，无需执行 build。
若从本地目录安装（在插件父目录执行）：
dsh plugin --profile <profile> add ./dsh-xai-auth
本地二次构建需 mise，在包目录内执行 mise trust、mise install，再 mise exec -- pnpm install --frozen-lockfile 与 mise exec -- pnpm run build（开发文档要求 Node.js >=24.9.0）。
典型用法¶
- 打开 Plugins → dsh-xai-auth → Sign in。
- 在验证页打开链接并输入代码完成授权。
- 在对话中选择
xai-supergrok/...模型开始聊天。
若在授权过程中刷新了页面，需要重新点 Sign in。
适用场景与注意¶
适合：已有 SuperGrok 或 X Premium 订阅、希望在 DSH 内统一选模型对话，且不想维护 XAI_API_KEY 的开发者。
注意：
- 插件在 当前 dsh 进程权限 下运行，安装前请自行审阅源码与 MIT 许可证。
- DSH 社区插件目录（SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；安装来源以 GitHub 仓库说明为准。
- 需要继续用 API Key 走官方
xai路由时，本插件不替换该路径，两者可并存。
结尾¶
dsh-xai-auth 把 xAI 订阅登录接到 DSH，通过 xai-supergrok 路由使用 SuperGrok，并可在插件页查看用量。详情与更新见 SkillHub 目录页 与 GitHub 仓库。
