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 配置,并提供commandcodeprovider 路由,带实时模型目录(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
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则