dsh-grok-kit

中文 · English

通过 OAuth 在 DeepSeek Harness 中使用 Grok：主循环融合网页与 X 搜索、连续 reasoning、Imagine，以及仅作用于 xAI 的独立代理。

[!IMPORTANT] 非官方项目、商标与账户使用声明

dsh-grok-kit 是由社区独立开发的 DeepSeek Harness 第三方插件，不是 xAI、X、DeepSeek、DeepSeek Harness 或这些项目维护者的官方产品，也不代表它们。本项目不主张已获得上述主体对本插件或其名称的个别许可、背书、赞助或认可。Grok、xAI、X、DeepSeek、DeepSeek Harness 及相关名称与标识归各自权利人所有；本项目仅为准确说明兼容对象而提及这些名称。

OAuth 可用性可能受订阅档位、地区、xAI 条款、账户资格、速率限制和后续服务变更影响。用户应自行确认其账户与用途获准；本项目不保证持续可用性或兼容性，也不提供 xAI/Grok 账号、订阅或官方支持。

不止于 OAuth 登录

dsh-grok-kit 为 DeepSeek Harness 增加独立的 xai-oauth 路由。它不要求 XAI_API_KEY，也不修改 dsh 源码；重点不只是“能登录”，而是把服务端搜索和连续 reasoning 所需的请求字段接进主聊天路径。

• 搜索融入主循环： 网页与 X 检索发生在 grok-4.6 的同一轮 Think 中，推理可以直接使用刚搜到的材料
• 多轮 reasoning 连续： 默认使用 high effort，并保留 reasoning.encrypted_content，让后续回合能够带回加密推理上下文
• 登录状态与 Grok CLI 同步： 直接共用并回写 ~/.grok/auth.json，不是只复制一次后各自轮换 refresh token
• Imagine 与干净的模型选择器： grok_imagine 默认开启，非聊天模型不会混进对话模型列表；当前 DSH 不会把生成图直接显示在对话中

此外还包括 xAI 专用代理、聊天 401 强制刷新重试、凭据原子写入与诊断脱敏等支撑能力。

主循环融合搜索

同一个模型 id，不代表不同接入方式一定有相同的使用体验。xAI 官方说明 Grok Build 与公开 API 都提供 grok-4.6；真正影响搜索体验的，是服务端工具是否和主对话处在同一轮请求里。

分离式搜索会额外发起一轮模型请求完成检索或摘要，再把结果交回主对话。它仍然适合需要独立过滤条件的任务，但会多出一轮模型处理，而且搜索摘要不是在当前回复的 Think 中生成。

主循环融合搜索则按 xAI Responses API 的服务端搜索方式，把 {type:web_search} 与 {type:x_search} 直接放进主 grok-4.6 请求。检索发生在 Think 里，模型能在同一轮推理中使用刚获得的网页和 X 材料；默认 bundle 已启用这条路径。

为让两类搜索共存，宿主原生 web_search 仍保留在 DSH 工具列表中，但会从启用融合搜索的 xAI payload 里移除，避免服务端工具重名；其他模型路由仍可照常使用宿主搜索。

界面偶尔出现 x_keyword_search 等名称时，表示 xAI 已经完成了该次 X 搜索。插件中的同名项只负责让 DSH 收尾当前回合，不会再次检索。

需要按域名、账号或日期过滤时，可关闭 backendSearch 或启用 nestedSearchTools，改走独立的 grok_web_search / x_search。这是可选模式，不是默认路径。

statefulResponses 默认关。打开后用 store: true + previous_response_id 只追加新 user；上一轮若是 toolUse（x_keyword_search 收尾、bash 等）不会续链，否则会把已经写完的搜索正文再生成一遍。OAuth 探针里 follow-up 能列来源，但 cached_tokens 不会变成那次搜索的 10–30 万 KV。

界面与效果

账号、模型与代理

<p align="center"><em>设置页复用 Grok CLI 登录，展示账号可见模型，并按需设置仅对 xAI 生效的网络代理。图中的 <code>127.0.0.1</code> 是本机回环代理示例。</em></p>

<br><br>

网页搜索融入主循环

<p align="center"><em>没有另起嵌套搜索工具卡片：网页检索直接发生在同一轮 Think 中，材料随即用于当前回复。截图里的新闻内容只用于展示交互，不作为事实来源。</em></p>

<br><br>

X 搜索的服务端调用

<p align="center"><em>响应可能显示 <code>x_keyword_search</code> 等 <code>custom_tool_call</code>；搜索已在 xAI 服务端执行，插件只负责让该轮在 DSH 中收尾。截图内容仅作功能演示。</em></p>

安装

推荐从 npm 安装到 Web profile：

dsh plugin --profile web add dsh-grok-kit
dsh web

如果 PATH 中没有 dsh，可以使用同一个 CLI 包：

npx @deepseek-ai/dsh plugin --profile web add dsh-grok-kit
npx @deepseek-ai/dsh web

如果这个 profile 以前安装的是 GitHub 来源，可先尝试 dsh plugin --profile web add dsh-grok-kit@latest；若来源没有切换，先移除旧包再重新添加。

需要固定到可复现的 Git 提交时，可使用：

dsh plugin --profile web add github:MaRi23333/dsh-grok-kit#91266c116dd6be086cb91c51e225c1d3d9578562

完整 SHA 会固定安装结果；npm 安装则默认跟随 latest 稳定版本。

打开 设置 → xAI Grok，完成登录后选择 xai-oauth / grok-4.6 或账号当前可见的其他主线 Grok 模型。已经保存在 dsh 设置中的模型仍有更高优先级。

完整的安装、迁移、卸载和故障处理步骤见 INSTALL.zh.md。

模型与工具

• 模型选择器只展示主线 Grok 聊天模型；Imagine、video、embedding、build/code 变体会被隐藏
• 默认 grok-4.6 描述符使用 high reasoning，并请求 reasoning.encrypted_content，以便后续回合带回加密推理上下文
• grok_imagine 默认开启，但当前 DSH 还不能把生成图直接显示在对话中。需要直接取得文件时，请在提示中让 Agent 把生成结果保存到指定目录；未指定目录时，图片会保存到 DSH 附件库
• dsh 原生 web_search 仍保留在宿主工具列表中，但会从启用 backend search 的 xAI payload 中移除，避免工具重名

…