前言¶
DeepSeek Harness（DSH）把 Agent 循环、工具执行和模型调用拆开：模型侧通常走各家 API 或自建网关。若企业已在 SAP AI Core 上部署 Orchestration，并希望在 DSH 里直接选模型、共用 OAuth，而不是为每个模型单独写路由和流式解析，就需要一个独立的模型 Provider 插件。
下面介绍社区维护的 dsh-sap-ai-core（GitHub：solstice621/dsh-sap-ai-core）。它在 DSH 中承担 Token、部署路由、流式响应和工具协议；DSH 仍负责 Agent 与工具闭环。目录页见 SkillHub 插件页，源码与 Release 在 GitHub 仓库。
这是什么¶
dsh-sap-ai-core 是面向 DeepSeek Harness 的 SAP AI Core 模型插件，维护者为 solstice621，分类为模型推理。当前 Release 0.1.0-rc.4 在 cn40 提供五个 Qwen 模型：Qwen 3.6 Plus、3.6 Flash、3.7 Plus、3.7 Max、3.8 Max；五个模型共用现有 Orchestration 部署。插件仍支持原有的 OpenAI 兼容 Chat Completions 路由。
与「只在 Cordis 里手写单条 HTTP 配置」相比，该插件把 OAuth 认证、部署查找、流式 SSE 和 DSH 工具协议集中在一处，并在 profile 里通过预设 JSON 扩展模型目录。
核心功能¶
多模型与 Orchestration¶
0.1.0-rc.4 的五个 cn40 模型共用一份 OAuth，切换模型可保留上下文；并发认证复用、取消后恢复在仓库说明中已有验证记录。模型列表来自配置中的五模型预设，可按其他 SAP AI Core 实例能力扩展；预设会只读查找唯一的 RUNNING Orchestration 部署，多个候选时需填写已有的共享 Deployment ID。
思考强度档位¶
五个模型均提供 低／中／高／极高／Max 五档思考强度，默认 Max，并保留关闭思考选项。各档思考 Token 预算上限分别为 25,600／51,200／76,800／102,400／128,000（每档相差 25,600）；思考与正文分别显示。这些是配置上限，模型可提前结束；实际生成长度仍受模型、服务和超时限制。128,000 档已有五模型短请求的参数接受证据，中间四档数值尚未分别做真实请求验收。详细边界见仓库内 docs/acceptance.md、docs/progress.md 与 docs/configuration.md。
插件与 DSH 的分工¶
README 说明：插件处理 Token、部署路由、流式响应和工具协议；DSH 负责 Agent 循环与工具执行。传输层主实现为 undici + eventsource-parser（见 docs/adr-001-transport.md）。
诊断 CLI¶
安装后可使用包内诊断命令，按层级检查 config、auth、deployment（不发起推理）；chat、stream、tools 需加 --allow-inference，最多 4 次请求、每次至多 256 output tokens：
./node_modules/.bin/dsh-sap-ai-core-diagnose \
--config /absolute/path/plugin.json \
--provider sap-ai-core-demo --model qwen-demo --level config
开发入口为 npm run diagnose -- --help；运维说明见 docs/operations.md。
安装与启用¶
兼容 DSH 0.2.1-rc.5、Cordis 4.0.5、Node 24（24.19.0 起）。开发基线为 Node 24.19.0 / npm 11.17.0。仓库已提交 dist 与 dsh.bundle，安装期无需允许构建脚本。
方式一：DSH 插件安装界面
在界面中输入 GitHub 地址：
https://github.com/solstice621/dsh-sap-ai-core
也可使用 Release 上的预编译 tgz 作为同一界面的安装目标。
方式二：DSH 命令
桌面版需先正常退出应用，对 desktop profile 安装后再重新打开：
dsh plugin --profile desktop add github:solstice621/dsh-sap-ai-core#v0.1.0-rc.4
其他 CLI profile 将 desktop 换成实际 profile 名称。
启用配置
默认 bundle 以空的 instances/providers 加载。在 profile 的 cordis.patch.yml 中，将现有 sap-ai-core 条目的 config 设为仓库示例 cn40 五模型预设，填写 OAuth host，并在 DSH credentials 中配置引用的 client ID 与 secret。随后在 DSH 中选择 SAP AI Core cn40 及所需 Qwen 模型。
若继续使用单模型直连接口，可使用原 Chat Completions 配置 patch。升级时保留已有 provider/model ID，例如本地 qwen-cn40 仍代表 Qwen 3.6 Plus。
凭证、两种协议、可选 Agent peers、代理/CA 与 Kubernetes Secret 示例见 配置说明。DSH profile 需提供 llm 与 credentials 服务。
典型用法¶
完成安装与 patch 后，在 DSH 中选 Provider SAP AI Core cn40 及五个 Qwen 之一即可对话与跑 Agent。需要排查连通性时，先用诊断 CLI 的 config / auth / deployment 层级，确认 OAuth 与部署后再对 chat 或 stream 加 --allow-inference 做有限次推理测试。
从源码构建产物（需 Node 环境）：
npm ci --ignore-scripts
npm run test:pack
产物为 artifacts/dsh-sap-ai-core-0.1.0-rc.4.tgz，校验清单为 artifacts/manifest.json。
适用场景与注意¶
适合谁： 已在 SAP AI Core（尤其 cn40 Orchestration）上运行 Qwen 部署、并在 DSH 中做 Agent 开发与工具闭环的团队；希望一份 OAuth、多模型切换且保留 OpenAI Chat Completions 兼容路径的场景。
运行与信任边界： 插件以当前 DSH 进程的权限运行，会读取 profile 中的 credentials 与网络配置。安装前应自行审阅 MIT 许可 与源码；SkillHub 目录为社区站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
版本与生态： 插件通过 GitHub 源码与 Release tgz 交付，未发布 npm。未验证的模型能力见仓库 docs/compatibility.md。真实 cn40 联调与长测需显式环境变量与连接文件，属于维护者验收流程，默认 CI 不读取公司凭证。
结尾¶
dsh-sap-ai-core 把 SAP AI Core 的 OAuth、Orchestration 路由和 DSH 所需的流式与工具协议封装成独立模型插件，并在 0.1.0-rc.4 提供 cn40 五款 Qwen 及可配置思考档位。若要安装或查变更，可从 SkillHub 目录页 进入，或直接打开 GitHub 仓库 与 Releases。
