🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
视觉能力·0 次阅读·Command Code 接入 插件页

一个非官方 provider 插在生态的哪一层:dsh-commandcode-provider

非官方 provider 插件的生态位——Command Code 接入是怎么长出来的 在 DeepSeek Harness(dsh)的插件生态里,「接入一个模型服务商」从来不是官方一个人的事。本文想聊的 Mars-Sea/dsh-commandcode-provider (页面中文名「Command Code 接入」)就是这么一个典型样本:它 不是 DSH 的一部分 ,却已经长成了生态里相当活跃

在 DeepSeek Harness(dsh)的插件生态里,「接入一个模型服务商」从来不是官方一个人的事。本文想聊的 Mars-Sea/dsh-commandcode-provider(页面中文名「Command Code 接入」)就是这么一个典型样本:它不是 DSH 的一部分,却已经长成了生态里相当活跃的一块。

先把身份钉死:这是非官方的第三方集成,你需要自备 Command Code 账号与 API key 或订阅,遵守其服务条款,本项目与 Command Code, Inc. 无关。 它由 Mars-Sea 维护,GitHub 星标 354,npm 包站点记录版本 0.12.1、registry latest 0.12.2。

一个 provider 插件,插在生态的哪一层

dsh 的插件体系是分层的:宿主管线(agent、会话、设置、凭据、UI 原语)在底层,插件在上面挂自己的路由与页面。dsh-commandcode-provider 选择的位置很清晰——它注册一个 commandcode provider 路由,把自己伪装成宿主管线认识的一个模型来源;当部署挂载了 web 能力(@deepseek-ai/dsh-web + @deepseek-ai/dsh-tool-web)时,它还会注册一个 commandcode search provider,让模型的 web_search 走 Command Code 的 /alpha/web-search 端点。同一个 key、同一个 base URL,不额外配搜索凭据。

也就是说,一个插件可以同时占两个「接缝」:模型接缝与搜索接缝。它不改造宿主,只是把外部服务的形状翻译成宿主能吃的形状。这类「翻译层」是生态里最普遍的一类插件,而「接模型」只是其中最显眼的一种。

读到这里,如果对你有帮助
不解锁内容

它是从哪来的:一次 MIT 上的移植

README 写得很直白:本插件移植自 pi-commandcode-provider,上游也是 MIT;本插件自己也用 MIT。开源生态里的 provider 插件大量是同源移植:有人在 A 宿主上写好对接,再有人把它搬到 B 宿主。

仓库同时挂着 awesome-dsh-plugin 的徽章,说明它被社区清单收录。但收录 ≠ 官方:社区清单只是人肉整理的目录,插件仍独立发行,与 DSH 官方发行没有从属关系。分清「清单收录」「官方发行」「社区集成」,是读懂这种生态的第一课。

它依赖谁:Harness 包归 profile 所有

看它的 package.json 会注意到:@deepseek-ai/cordis、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-settings、@deepseek-ai/dsh-credentials、@deepseek-ai/dsh-invariants、@deepseek-ai/dsh-web 等一大批 Harness 模块,全部声明在 peerDependencies 里,而不是自带一份——而且版本号写的是精确的 0.2.0-rc.2,不是范围。这是生态里一条很关键的边界:这些 Harness 包由当前 dsh profile 拥有,插件只是「借用」宿主已经装好的那一份。

好处是一致——插件与宿主用同一批模块实例,不会出现两份 dsh-* 打架;代价是插件被牢牢绑在宿主版本上。因此补依赖时不要自己再引 @deepseek-ai/dsh-invariants:它已经是 Host peer,由 profile 来管。

同一层的邻居,不止「接模型」

把视野从这一个插件拉开:生态里和它同层的,还有若干种 provider 与工具插件——比如「记忆检索类」的插件,同样是通过某个接缝把自己的能力供给宿主,同样以非官方集成的形式独立发行。它们共享同一种生存方式:向上翻译外部能力,向下依赖宿主契约。

社区集成的共同处境

作为社区集成,这类插件有几个绕不开的共性:

1. 跟着宿主引擎版本走。 宿主换个版本,插件可能就得换个版本。本插件就把 engines.dsh 写成了精确的 0.2.0-rc.2——只此一个。

2. 被单一上游版本绑死。 dsh 0.1.2–0.1.7 那条线之所以不再支持,是因为上游经历过 0.1.7 设置重写、RequestMessage 信封与持久化图片卸载契约的变化,桥接两代的兼容代码已被删除。旧引擎只能用旧版本(0.11.17 / 0.11.11 / 0.9.1),且都不再维护。

3. 受上游条款约束。 它只是把流量转发给 Command Code,账号、订阅与条款都是你自己的;这也是「非官方、需自备账号、与 Command Code, Inc. 无关」这句话反复出现的原因。

4. 靠社区清单流通。 被发现与安装主要靠社区目录,而不是官方渠道。

下面四个坑,恰好是这种「转发层」处境最真实的一面。

坑一 · 长截图会话,聊到一半整个请求开始失败

现象。 一个攒了很多截图的会话,前期一切正常,跨过某个点后之后每个请求都开始失败。原因。 这个 provider 对单次请求的大小有上限,约 50 MB,而且并未文档化;截图越攒越多的长会话一旦越过该预算,就会整轮失败。解决。 插件自带降级:超出预算的最老图片被替换成一句「image omitted」说明(点明是哪张附件),最新图片照常发送;若仍被判为过大,就用更小的图片预算重试一次,再失败才报错。别把几十张大图堆进同一个会话。

坑二 · 打开 ZDR 之后,某些模型直接 422

现象。 开了零数据保留(ZDR)后,选到某些模型请求直接失败,报 422 cmd_zdr_no_providers。原因。 ZDR 要求请求只能走不保留提示与补全的上游;没有可用 ZDR 上游的模型会失败,而且请求不会被去掉 header 重试。插件维护一份 KNOWN_NON_ZDR_MODELS 例外清单(2026-09-29 时是 23 个模型)。解决。 换一个 ZDR 可用的模型,或按报错提示关掉 ZDR。另外要有心理准备:ZDR 通常更贵,容量有限且按各上游的透传费率计费,哪个上游服务一次请求逐请求可变;会话费用读数仍按普通目录价,真实单价要看 Command Code 的 Studio 用量页。

坑三 · 带图的会话,一切到纯文本模型就被拒

现象。 会话里已经贴了图片,把模型切到一个不支持图片的模型,dsh 直接拒绝。原因。 图片输入受模型限制:只有 Vision 模型收图,纯文本模型拒收;在带图会话里切纯文本模型会被 dsh 拒绝。解决。 要么挑模型选择器里标了 Image 的模型,要么先把图片删掉再切。

坑四 · DeepSeek thinking-mode 的工具循环,缺了推理就被拒

现象。 用支持思考模式的模型跑工具调用循环,中途被上游拒绝。原因。 历史推理必须重放:DeepSeek thinking-mode 的工具循环缺了历史 reasoning 会被拒。解决。 这一条其实是插件自己在做的——两条传输都把历史 reasoning 送回去(/provider/v1/chat/completions 用 reasoning_content,/alpha/generate 用重建 assistant turn 里的 reasoning 块),且只重放「有配对工具结果的工具调用」。用户侧别用行为不一致的老客户端旁路这套逻辑。

总结

dsh-commandcode-provider 的生态位可以一句话概括:非官方、MIT 移植、注册两个接缝、依赖宿主 Harness 包、跟着单一引擎版本走。想对照更多同类插件的中文清单,见 DeepSeek Harness Hub 插件清单。

适合与不适合

适合:想研究 dsh provider 插件机制、愿意读 README 与源码的人;在 dsh 0.2.0-rc.2 上、且已有 Command Code 账号与订阅的开发者;能接受社区清单而非官方渠道获取插件的用户。

不适合:需要官方背书与 SLA 的团队;引擎长期停在旧线又不打算升级的人;把「能看模型目录」当成「配好了」、不愿处理上游条款与配额的用户。

标签:dsh-commandcode-provider、DeepSeek Harness、插件生态、非官方集成、provider 插件

本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。

拆开 dsh-commandcode-provider 的适配层,看单版本锁定背后的取舍

Mars-Sea/dsh-commandcode-provider 是 dsh 生态里一个非官方的 Command Code 接入插件,移植自 pi-commandcode-provider(MIT)、自己也是 MIT。这一篇拆它的适配层:看它怎么把外部服务的形状翻译给 dsh,以及为何把版本锁得这么死。

先钉身份:这是社区集成,你需要自备 Command Code 账号与 API key 或订阅,遵守其服务条款,本项目与 Command Code, Inc. 无关。npm 包站点记录 0.12.1,registry latest 0.12.2。

为什么 engines.dsh 是一个精确值

打开 package.json,最有信息量的一行是:

"engines": {
  "node": ">=22",
  "dsh": "0.2.0-rc.2"
}

注意 dsh 后面不是 ^ 也不是 ~,而是精确等于 0.2.0-rc.2。与之呼应,dsh.compatibility.dshReleases 也只记录这一个版本;README 的说法是「supports dsh 0.2.0-rc.2 and nothing else」。

这不是作者保守,而是适配层性质决定的。一个 provider 插件要伸进宿主好几处接缝:设置页注册、请求消息信封形状、图片卸载契约、凭据引用……这些都是宿主内部契约,任何一个动了,插件对不上就会在隐蔽处出问题——README 直接点名了三处:设置页、消息信封、请求图片预算。与其放一个宽范围让用户踩坑,不如锁死一个已验证版本。

这也解释了那几条旧版本线的存在逻辑:引擎换版本,插件就换版本。

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

分别对应 dsh 0.1.7、0.1.2–0.1.6、0.5.0 线,都按精确版本装,且均已不再维护。README 给的原因是:0.1.2–0.1.7 那条线早于 0.1.7 设置重写、RequestMessage 信封、持久化图片卸载契约,桥接两代差异的兼容代码已经被删除。不是「没人测」,是「路已经拆了」。

两条传输,各重放一遍推理

适配层里最具体的一段,是它对两条传输分别写了对账逻辑:

  • /provider/v1/chat/completions:历史推理以 reasoning_content 回传;
  • /alpha/generate:历史推理被塞进重建的 assistant turn 里,作为一个 reasoning 块——这是官方 CLI 发送的形状。

两条都要送,是因为宿主与官方 CLI 走的是不同端点、期望字段不同;缺了这一段,DeepSeek thinking-mode 的工具循环会被上游拒绝。同时它只重放「有配对工具结果的工具调用」,避免把半截调用链塞回去。

schema 归一化:把根拽回 type: "object"

另一个易被忽略的适配点,是工具参数 schema 的归一化。Command Code 的 provider 要求每个工具的根 schema 是 type: "object";但现实里 schema 来源五花八门:第三方插件手写的 schema、MCP 服务器自带的 inputSchema、生成出来带根 $ref 的结构——都可能不满足「根即 object」。

不处理会怎样?整轮失败,报 schema must be a JSON Schema of 'type: "object"'。插件做的就是在发出前把每个工具的根拽回 type: "object"。

图片预算的降级路径

图片也要适配层自己管。单请求有约 50 MB 的上限(未文档化),于是它设计了降级链路:

1. 超出预算的最老图片被替换成一句「image omitted」说明,并点明是哪张附件;

2. 最新图片照常发送;

3. 若请求仍被判为过大,用更小的图片预算重试一次,再失败才报错。

前者是硬预算保护,和后面的「停止重放已见图片」(成本缓解开关)是两码事。

例外清单与 profile 结构

适配层里还有一份 KNOWN_NON_ZDR_MODELS 例外清单,标注「没有可用 ZDR 上游」的模型(2026-09-29 时为 23 个)。

最后是一个结构性事实:每个 dsh profile 拥有自己的插件列表。插件通过 dsh plugin --profile <name> add 装进某一个 profile,web 装了不代表 dsh-tui 有;所以它的安装、更新、卸载都要带 --profile 参数。

坑一 · 为了「补全依赖」,自己又装了一份 Harness 包

现象。 看到一堆 @deepseek-ai/dsh-* 报缺失,就顺手 npm add @deepseek-ai/dsh-invariants 补上,结果宿主行为诡异。原因。 这些 Harness 模块在插件里是 Host peer——由当前 dsh profile 拥有,插件只是借宿主那一份;自己再引一份,等于在树里塞进第二份同名包。解决。 不要额外添加 @deepseek-ai/dsh-invariants(或任何 @deepseek-ai/dsh-*)依赖;缺 peer 回到 profile 层面解决,让宿主保持对这些 Harness 包的归属。

坑二 · 打开「停止重放已见图片」之后,模型看不见那张图了

现象。 开启这个开关后,模型对某张早先贴过的图片「失忆」了。原因。 该开关(offloadSeenImagesForCache,默认关闭)会让 dsh 的持久化 image/offload 面把旧图替换成稳定文本占位符,让后续文本不必回放旧像素即可命中缓存。代价是:除非重新读源文件或用户重新贴,模型没法再看那张被卸载的图。 解决。 想清楚再开。它不是 bug:它只是缓解成本尖峰的折中,并不修复 Command Code 底层多模态缓存行为。

坑三 · 卸载了插件,凭据却还留在机器上

现象。 remove 之后清点机器,发现 key 之类的东西还在。原因。 卸载不会清理凭据:dsh 凭据库里的 key 与 ~/.commandcode/auth.json 都会被原样留下。解决。 要彻底清理得自己动手:确认没有别的 profile 还在用这套凭据,再手动清 dsh 凭据库与 ~/.commandcode/auth.json。

坑四 · 给另一个账号挑同一个「专用模型」,等于把它搬走

现象。 明明账号 A 已经认领了某个模型,给账号 B 也勾上同一个后,A 那边就选不到了。原因。 一个模型同一时间只能属于一个账号;专用模型存成 modelAccountRules,给另一个账号选同一个模型就是把它搬走。解决。 规划好哪个账号认领哪些模型,别来回勾同一个;轮换交给 accounts[] 默认逻辑,而不是重复认领。

总结

拆完会发现,单版本锁定的取舍是自洽的:接缝多、契约细,锁死一个引擎版本能把不兼容挡在门外;代价是旧引擎只能吃不再维护的旧版本。想对照更多 dsh 插件的中文清单与版本约束,见 DeepSeek Harness Hub 插件清单。

适合与不适合

适合:想读懂第三方 provider 适配层的开发者;在 dsh 0.2.0-rc.2 上、已自备 Command Code 账号与订阅的人;愿意按精确版本管理插件的人。

不适合:想在单一引擎版本上「装完就不管」的人;需要官方支持与长期维护承诺的团队;不愿接受上游条款约束的用户。

标签:dsh-commandcode-provider、DeepSeek Harness、源码解读、适配层、版本兼容

本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。

本文同步发布于

这篇内容有帮助吗
赞赏随意,不解锁任何内容,也不必留个人信息。
扫码用
查看 Command Code 接入 插件详情
安装命令 · 中文 README · 兼容性报告
前往插件页 →
回到顶部