前言¶
在 DeepSeek Harness（DSH）里接 LLM，常见做法是单独配置各家 API Key 或自建网关。若你已经在 Zed 编辑器里开通了 Zed Pro 或 Student 计划（按月发放的 prompt 额度），同一套账号能否在 Harness 的对话里直接用，取决于有没有把 Zed Cloud 的鉴权与模型列表接进 Host。
dsh-zed-provider（维护者 RGarrido03）做这件事：注册名为 zed-agent 的 LLM 路由，请求经 https://cloud.zed.dev 签发与流式转发，行为与 Zed 编辑器侧一致。本文介绍其定位、能力与安装用法；事实以 GitHub README 为准。
这是什么¶
dsh-zed-provider 是 DSH 社区插件（分类：模型推理），当前 package 版本 0.1.4，许可证 MIT。它在 Harness 内挂载 Zed Cloud 作为 provider，并在 Settings → Models 提供可编辑的 Zed 卡片与模型勾选器，便于管理凭据与可见模型。
DSH 生态强调「一切皆插件」；插件目录站 skillhub.cn 为社区索引，与 DeepSeek / 幻方无官方从属关系。安装前请自行查看源码与许可证——插件在当前 dsh 进程权限下运行。
核心功能¶
LLM 路由 zed-agent¶
Bundle 向 Host 注册一条 provider 路由 zed-agent。对话 turn 在 Zed Cloud 上 mint 并以流式返回，与 Zed 客户端走同一套云端路径。
支持的模型后端¶
插件通过凭据调用 GET /models，对外公布 Zed 返回且本插件实现了的后端：
- Claude（Anthropic Messages）
- GPT（OpenAI Responses）
Zed 目录里的 Gemini、Grok 会被过滤，避免提供不可用项；若仍选中不支持模型，会快速失败并返回 UNSUPPORTED_CONTENT。
各模型携带 Zed 侧的上下文窗口、输出上限；当 supports_thinking 为真时，提供 off / low / high / max 等等级，并映射到 Anthropic extended thinking 预算。
凭据与登录¶
凭据解析按优先级（任一即可）：
- 配置项
credentials— 字面量"<userId> <accessToken>"（或 JSON） config.apiKeyEnv（默认ZED_CREDENTIALS）— 经 credential seam 解析；Models 页 Zed 卡片的密钥字段即此引用/zed-login写入 Harness 凭据库的记录llm-zed/zed-agent- macOS（
zed.dev）或 Linux（secret-tool）上 Zed 编辑器本地 keyring 中的条目，插件可导入一次到 grant 记录
在 Composer 中执行 /zed-login 会打开 Zed 原生登录页，等待 loopback 回调，并将 grant 存入上述 store；后续请求复用该 grant，短期 gateway token 按需自动刷新。
Settings UI¶
Settings → Models → Zed 卡片由本 bundle 的 client 模块（lib/client.js）渲染，包括：
- 凭据状态（卡片 join + 实时的
credentials/describe） - 可编辑凭据字段（存
"<userId> <accessToken>"，引用名来自apiKeyEnv）；只读来源（如环境变量）会明确拒绝而非静默忽略 - 模型选择器：通过
llm/discoverModels读取目录，勾选写入visibleModels；空或全选表示展示插件能运行的全部模型
配额¶
用量由 Zed 记账：无计划或额度用尽时 HTTP 402，Harness 侧表现为 QUOTA 失败并指向 https://zed.dev/account。插件不自行估算剩余比例。
安装与启用¶
面向 web profile 的安装命令（README 原文）：
dsh plugin --profile web add dsh-zed-provider
package.json 声明与 DSH ^0.2.1-alpha.2 兼容（含 0.2.1-alpha.2、0.2.1-rc.2 等条目）。Host 侧 bundle 在 profile 重启后才会重新 import；client 侧在 Host 启动时 compose，增删 ./client 导出同样需要重启。
典型用法¶
1. 安装插件¶
执行上一节的 dsh plugin --profile web add dsh-zed-provider，并按需重启 profile。
2. 绑定 Zed 账号¶
在 Harness Composer 输入：
/zed-login
按提示完成 Zed 登录；或跳过命令，在 Settings → Models → Zed 卡片中填入 "<userId> <accessToken>"（或通过 ZED_CREDENTIALS 等 apiKeyEnv 指向的引用）。
3. 选择模型并开始对话¶
在 Models 页勾选要在选择器里出现的模型 id（对应配置 visibleModels）。在对话里选用 zed-agent 路由下的 Claude 或 GPT 模型即可；额度与策略以 Zed 账号为准。
配置项¶
| 字段 | 默认值 | 含义 |
|---|---|---|
apiKeyEnv |
ZED_CREDENTIALS |
存放 "<userId> <accessToken>" 的凭据引用名 |
credentials |
无 | 字面量凭据，组合时优先级最高 |
baseUrl |
https://cloud.zed.dev |
Zed Cloud 端点（cordis.patch.yml 中多为 composition-only） |
visibleModels |
全部支持项 | 限制目录中展示的 model id |
适用场景与注意¶
适合：已有 Zed Pro / Student 订阅、希望在 DSH Web 界面统一开发智能体，又不想为 Claude/GPT 再单独维护一套与 Zed 平行的 API 账单的用户。
注意：
- 仅 Claude、GPT 经本插件可用；勿依赖 Zed 目录中的 Gemini/Grok。
- 插件不替代 Zed 的计费与 ToS；402 需到 Zed 账户页处理。
- 安装即信任维护者与 bundle 代码；建议在 GitHub 仓库 阅读
cordis.patch.yml与src/后再用于生产环境。
链接¶
- 社区目录：https://www.skillhub.cn/plugins/RGarrido03/dsh-zed-provider
- 源码与 README：https://github.com/RGarrido03/dsh-zed-provider
经过上面的步骤，你可以在 Harness 里把 Zed 订阅额度当作一条标准 LLM 路由使用，并在 Models 页集中管理凭据与模型可见范围。
