跳到主内容

dsh-commandcode-provider 使用指南

将 Command Code 接入 DSH,提供模型目录、推理请求、图片输入和账户用量查看能力。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-commandcode-provider

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @mars-sea/dsh-commandcode-provider

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 插件包:可通过 dsh plugin add 安装到任意 dsh 配置,并提供 commandcode provider 路由,带实时模型目录(GET {apiBase}/provider/v1/models,缓存于 ~/.commandcode/models-cache.json)。
  • API key 解析顺序:config.apiKey → 凭据引用 apiKeyEnv(默认 COMMANDCODE_API_KEY)→ 启动环境变量 → 官方 CLI 认证文件(~/.commandcode/auth.json,由 command-code login 写入)。
  • 推理强度(reasoning-effort)支持:针对官方目录标为推理模型的模型(KNOWN_EFFORTS,与 [email protected] 一致);没有可选档位但仍支持思考的模型会自动思考,与官方 CLI 行为完全一致。
  • 支持视觉模型的图片输入(通过 dsh 附件服务、以官方 wire 格式发送);纯文本模型会明确拒绝图片(UNSUPPORTED_CONTENT)而非静默丢弃。
    • id: llm-commandcode

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件需要 API key 吗?

模型目录可以在没有 key 时浏览,但发送请求和查看账户用量需要可用的 Command Code API key。插件会先检查直接配置,再通过 DSH 凭据服务解析;没有凭据服务时才读取启动环境,最后回退到官方 CLI 登录文件。

支持图片输入吗?

支持,但仅限源码登记的 Vision 模型,并且需要 DSH 附件服务。文本模型或缺少附件服务时会明确拒绝图片请求。

为什么模型列表里没有某些模型?

默认会根据账户订阅套餐隐藏超出套餐的模型;账单查询失败、套餐未知或存在按需余额时会放开显示。也可以关闭“隐藏套餐外模型”选项,但服务端仍会对实际权限做最终判断。

长时间思考时请求中断怎么办?

插件默认等待首字节 60 秒、允许流空闲 300 秒。网络较慢或模型长时间不输出时,可在设置页调大对应超时;传输失败、限流和部分服务端错误会使用 DSH 默认重试策略。

是否支持 stop 序列?

不支持,因为 Command Code 请求格式没有对应字段。带有 stop 序列的请求会返回不支持选项错误,而不是静默忽略。

卸载后 API key 会被删除吗?

不会。卸载只移除插件包及其配置层,DSH 凭据库和 ~/.commandcode/auth.json 中的 key 会保留。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: >=0.1.0-rc.6
  • Node: >=22

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则