Skip to content
dsh marketplace

dsh-plugin-cohere

Verified

dsh-plugin-cohere · v0.1.10 · MIT · Web UI

DSH native model provider for the Cohere v2 Chat API (https://api.cohere.com/v2/chat) — direct wire adapter, no proxy.

Install

dsh plugin add dsh-plugin-cohere

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-plugin-cohere

原生 DSH (DeepSeek Harness) 模型 Provider，直连 Cohere v2 Chat API，无中间代理。

  • 路由名：cohere（插件入口：llm-cohere）
  • 模型格式：cohere/<model-id>（例如 cohere/command-a-plus-05-2026）
  • 端点：POST https://api.cohere.com/v2/chat
  • 认证：Authorization: Bearer <key>

特性

  • 对话与流式：原生支持流式输出与完整 StreamChunk 生命周期，精确还原 token 消耗与缓存统计。
  • 函数调用 (Tool Calling)：支持工具调用及参数组装，按模型与 Schema 结构自适应发送 strict_tools。
  • 思考推理 (Reasoning)：支持 thinking 模式（含 off、low、high），根据模型输出上限动态钳制 token 预算。
  • 多模态视觉：内置纯几何长宽比重采样算法，按像素及大小预算处理图片输入，支持自动触发图像卸载（IMAGE_OFFLOAD_REQUIRED）。
  • 结构化输出与引用：支持 JSON Mode（response_format: { type: 'json_object' }）及 Citations 尾部脚注块生成。
  • Web 端独立卡片：集成于 DSH 设置页，直接提供 API Key 存取、API 节点配置、模型在线发现与逐行编辑。
  • 模型支持：内置预置 Command A、Command R 以及 Aya 等系列常用模型，同时支持跟随配置节点动态发现端点可用模型。

安装到 DSH

dsh plugin 只是把参数转发给 profile 目录里的 pnpm，所以下面两种写法等价（以 ~/.dsh/profiles/<name> 为例）：

dsh plugin --profile <name> add dsh-plugin-cohere    # 推荐

cd ~/.dsh/profiles/<name>
pnpm add dsh-plugin-cohere

也可以直接在 Web 侧边栏的插件页安装。注意 desktop profile 由 Electron 持有，npm CLI 会拒绝针对它的插件请求，请在 Desktop 的插件页或内置命令里操作。

包本身已带编译产物（lib/），安装即完成，无需任何构建脚本批准。

安装后还要做两件事：

  1. 在 profile 的 package.json 中，向 dsh.profile.bundles 数组追加 "dsh-plugin-cohere"（Web 插件页安装会自动选入组合包，命令行安装需手动补）。
  2. 重启 DSH，在 Models 设置页 Cohere 行的卡片中填入 API Key（存入凭据服务，不落盘明文），点击 从端点刷新模型 即可使用。

其他安装方式

方式 spec 说明
npm 注册表 dsh-plugin-cohere 推荐；prepack 已把 lib/ 打进 tarball
tarball pnpm add /abs/path/dsh-plugin-cohere-<ver>.tgz 离线分发；同样自带 lib/
本地目录 pnpm add /abs/path/to/dsh-plugin-cohere 直接指向 clone 的仓库，开发用；请先用绝对路径，相对路径会被拒绝
git pnpm add github:cn47mp/dsh-plugin-cohere 需先自行构建：pnpm 11 默认拦下依赖的构建脚本（allowBuilds 未列出的包按未审查处理，strictDepBuilds 默认 true），而 prepare 在全新 clone 中依赖尚未安装、tsc 不存在。保持 lib/ 不入库时，这条路必须先手动 npm install && npm run build

开发

git clone https://github.com/cn47mp/dsh-plugin-cohere.git
cd dsh-plugin-cohere
npm install       # 安装依赖并构建（prepare 钩子会跑 build）
npm run build     # 编译 TypeScript 到 lib/，并把 Web 端客户端代码复制为 lib/client.js
npm run typecheck # 仅执行 TypeScript 类型检查
npm test          # node --test

发布

发布走 Release 工作流，推 v* 标签即触发。工作流会先跑 typecheck 与测试，再校验标签版本与 package.json 的 version 一致，并确认 lib/index.js、lib/client.js、cordis.patch.yml 都在包内，才允许发布：

# 改 package.json 的 version（或 npm version patch --no-git-tag-version）
git commit -am "chore: release v0.1.11"
git tag v0.1.11
git push origin v0.1.11

首次发布必须提供一个 npm token：npm 的 trusted publishing（OIDC）只能配置在已存在的包上，而发布新包本身就要凭据，所以第一个版本只能用 token 引导。在仓库 Settings → Secrets and variables → Actions 添加 NPM_TOKEN（npm 的 Automation token，或对该包有读写权限的 granular token），然后重跑工作流。

包建立后建议改用 OIDC：在 npmjs.com 该包的 Settings 里把 trusted publisher 指向本仓库的 release.yml，此后不再需要 NPM_TOKEN，provenance 也由 npm 签名。

不想走 CI 也可以本机发布（注意必须显式指定官方源，镜像只读）：

npm login --registry=https://registry.npmjs.org/
npm publish --registry=https://registry.npmjs.org/

配置项

字段 默认值 说明
baseURL https://api.cohere.com/v2 自定义网关 / 私有部署端点
apiKeyEnv COHERE_API_KEY 凭据引用名（通过 credentials 服务读取）
providerName Cohere 显示名称
models 内置目录 覆盖或增补模型配置；缺失时自动补充默认模型
jsonMode false 启用结构化输出（response_format: { type: 'json_object' }）
includeCitations false 请求引用并在输出末尾生成「引用来源：」脚注块
strictTools true 对支持的路由且符合规范的工具发送 strict_tools
requestTimeoutMs 120000 初始响应头超时（毫秒）
streamIdleTimeoutMs 300000 流式数据空闲心跳超时（毫秒）
maxRequestImageBytes 20971520 (20MB) 请求包含图片的总 Base64 大小上限
requestImagePixelBudget 4194304 (2048²) 单图像素缩放预算
requestImageMaxBytes 1048576 (1MB) 单图编码字节上限

许可

MIT