dsh-llm-grok

DeepSeek Harness 插件：把 Grok 订阅额度 接成 DSH 的 LLM 提供方。

• GitHub：https://github.com/clarkzhao/dsh-llm-grok
• npm：dsh-llm-grok
• topic：dsh-plugin

Grok 4.6 / 4.5 在本插件里是原生多模态：用户贴图和 tool-result 里的图会随同一次 /chat/completions 发给订阅端点。图不是先 OCR 成字再交给文本模型，也不会多出一个识图工具。

能力

• 默认 baseURL：https://cli-chat-proxy.grok.com/v1
• 走本机 HTTP 代理（默认 Clash http://127.0.0.1:7890），不依赖 Python 旁路
• 会话日志只存附件引用（sha256:）。像素只在发请求时从 ctx.attachments 读出，编成 image_url data URL
• 缺附件服务、或图出现在 system / assistant 消息里：UNSUPPORTED_CONTENT

安装

dsh plugin --profile web add dsh-llm-grok
# 未全局安装 dsh 时：
npx @deepseek-ai/dsh plugin --profile web add dsh-llm-grok

其他来源：github:clarkzhao/dsh-llm-grok，或在仓库目录执行 dsh plugin --profile web add .。把 web 换成你的 profile 名即可。

安装后 bundle 会写入 llm-grok 并注册 grok provider。若曾在 llm-pi-ai 里加过同名 grok，先删掉，避免路由冲突。

凭据

插件不读 ~/.grok/auth.json。它只解析 DSH 凭据 GROK_SESSION_TOKEN。

1. grok login（token 会落到 ~/.grok/auth.json，方便你复制） 2. 写入 ~/.dsh/.credentials.yaml：

``yaml GROK_SESSION_TOKEN: <token> ``

或启动 DSH 前 export GROK_SESSION_TOKEN=...

未配置时请求会失败：dsh-llm-grok: missing credential GROK_SESSION_TOKEN。

发往订阅端点时使用：

Authorization: Bearer <token>
X-XAI-Token-Auth: xai-grok-cli
x-authenticateresponse: authenticate-response
x-grok-client-version: 1.0.4
x-grok-model-override: grok-4.6 | grok-4.5

后端据此按 订阅用户 计费，而不是普通 API Key。

配置

默认在插件的 cordis.patch.yml。可在 profile 或 home 层覆盖：

- id: llm-grok
  name: dsh-llm-grok
  config:
    baseURL: https://cli-chat-proxy.grok.com/v1
    apiKeyEnv: GROK_SESSION_TOKEN
    proxy: http://127.0.0.1:7890
    models:
      - id: grok-4.6
        name: Grok 4.6
        contextWindow: 500000
        maxTokens: 128000
        reasoningEfforts:
          low: low
          medium: medium
          high: high
          xhigh: xhigh
      - id: grok-4.5
        name: Grok 4.5
        contextWindow: 500000
        maxTokens: 128000
        reasoningEfforts:
          low: low
          medium: medium
          high: high

开发

npm install
npm test
npm run build

dsh-llm-grok/
├── package.json
├── cordis.patch.yml
├── src/
│   ├── index.ts       # 注册 grok provider，注入凭据与附件读取
│   ├── adapter.ts     # LlmAdapter：chat-completions + 模态声明
│   ├── serialize.ts   # DSH 消息 → 文本 / image_url / 工具
│   ├── translate.ts   # SSE → DSH StreamChunk
│   └── types.ts
└── tests/
    └── serialize.test.ts

限制

• 只走 chat-completions，不实现官方 CLI 默认的 Responses API
• 不做大图请求体驱逐（grok-build 约 50MB 那套策略尚未搬过来）
• Trajectory 不会出现单独的「识图」tool 行：图在 adapter 组请求时编进 user / tool 消息