# @tencentcloudadp/dsh-adp 把腾讯云 ADP 接到 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的插件包。 [License: MIT](LICENSE.txt) [Node](https://nodejs.org) [pnpm](https://pnpm.io) [GitHub stars](https://github.com/TencentCloudADP/Tencent-ADP-dsh-plugin) [English](README.md) · [中文](README.zh-CN.md) 这个插件把一个 DSH profile 接到腾讯云 ADP：网关模型（混元等）、混元 AI 搜索、API/MCP 插件市场、技能广场，以及把 ADP 应用注册成 ask 工具。不是 ADP Worker。 ## 安装 ```sh dsh plugin --profile web add @tencentcloudadp/dsh-adp dsh web ``` 装好后到 设置 → 插件配置 → **腾讯云 ADP** 填凭证（见下节）。装不上、装过旧名字、或 pnpm 拦住构建的，见 [docs/pitfalls.md](docs/pitfalls.md#install)。 ## 配置：独立站 / 公有云 ADP 需要三类凭证。配置里只写**引用名**（`ADP_API_KEY` 等）；实际值放在 `$DSH_HOME/.credentials.yaml` 或环境变量。 官方 API 文档覆盖的是**控制面 AKSK**和**AppKey SSE 对话**。本插件还用一条 OpenAI 形态的模型网关，官方概览没有写这条。端点和密钥出处见 [API 概览](https://cloud.tencent.com/document/product/1759/133868)。平面和报错见 [docs/credentials.md](docs/credentials.md)。 设置 → 插件配置 → 腾讯云 ADP 卡片 | 平面 | 引用名 | 官方出处 | 缺失时 | | -------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | | 工具密钥 | `ADP_API_KEY` | 独立站或公有云的 **密钥管理**页面，上方“新建工具密钥” | LLM / 搜索 / 插件**调用**报 `MISSING_CREDENTIAL` | | SecretId / SecretKey | `ADP_SECRET_ID` / `ADP_SECRET_KEY` | 公有云：[CAM 访问密钥](https://cloud.tencent.com/document/product/598/40488)。独立站：ADP 控制台 **密钥管理** | 模型 / 插件 / 应用**目录**为空 | | 按应用的 AppKey | `TENCENT_ADP_APP_KEY`（subagent 默认）或 `ADP_APP_KEY_*` | [应用发布 → API 管理](https://cloud.tencent.com/document/product/1759/104209) 或应用 **调用**（[SSE](https://cloud.tencent.com/document/product/1759/105561)） | subagent / ask 工具无法调用已发布应用 | ### 1. 开通 ADP 注册腾讯云并完成实名认证，再打开产品（[产品概述](https://cloud.tencent.com/document/product/1759/104193)）。主账号首次登录会自动建一个企业和一个**默认工作空间**；那个空间的 id **不是**补丁里的字符串 `default_space`（[企业、工作空间与权限概述](https://cloud.tencent.com/document/product/1759/122569)）。 | 站点 | 控制台 | 控制面 | 对话 SSE | | ------- | ------------------------------------------------------ | ------------------------- | ----------------------------------------------- | | **独立站** | [adp.tencent.com](https://adp.tencent.com) | `capi.adp.tencent.com` | `https://adp.tencent.com/adp/v2/chat` | | **公有云** | [adp.cloud.tencent.com](https://adp.cloud.tencent.com) | `adp.tencentcloudapi.com` | `https://wss.lke.cloud.tencent.com/adp/v2/chat` | 两边的模型补全都打 `https://api.adp.cloud.tencent.com/chat/completions`（不要加 `/v1`）。没有 `api.adp.tencent.com`。 ### 2. 拿 SecretId / SecretKey **公有云** — CAM 的 `AKID…` 密钥（36 位）： 1. 打开 [访问管理 → API 密钥管理](https://console.cloud.tencent.com/cam/capi)。 2. 没有密钥就新建（[主账号访问密钥管理](https://cloud.tencent.com/document/product/598/40488)）。立刻复制 **SecretId** 和 **SecretKey**；2023-11-30 之后新建的密钥只在创建时展示 SecretKey。 3. 子账号需要在 CAM 角色里开通智能体开发平台（原大模型知识引擎）读写权限（[技术常见问题](https://cloud.tencent.com/document/product/1759/109469)）。协作者账号不能用（[122569](https://cloud.tencent.com/document/product/1759/122569)）。 **独立站** — ADP 控制台密钥（约 26 位，**不是** `AKID`）： 1. 登录 [adp.tencent.com](https://adp.tencent.com)。 2. 打开 **密钥管理**，复制 SecretId / SecretKey（[API 概览 · 独立站](https://cloud.tencent.com/document/product/1759/133868)）。 这对密钥只签控制面（`DescribeModelList`、`DescribeSpaceList`、市场目录）。它不是 `ADP_API_KEY`。 ### 3. 获取工具密钥（`ADP_API_KEY`） - **独立站**：[密钥管理](https://adp.tencent.com/adp#/key-manage)上方新建“工具密钥”。 - **公有云**：[密钥管理](https://adp.cloud.tencent.com/adp#/key-manage)上方点击“新建工具密钥”。 该工具密钥用于模型、 API/MCP 插件调用。 ### 4. 可选：AppKey 用于 `subagent_adp` 和 `adp_ask` / `adp_ask_`（对已发布应用做 SSE），选 `adp:Hunyuan/hy3` 不需要它。迁移自 `dsh-plugin-subagent` 的 provider 继续使用原来的默认引用名 `TENCENT_ADP_APP_KEY`。 1. 先发布应用。 2. 打开 **应用发布 → 服务状态 → API 管理**，或 **应用管理 → 调用**，复制 AppKey（[104209](https://cloud.tencent.com/document/product/1759/104209)、[105560](https://cloud.tencent.com/document/product/1759/105560)）。 ### 5. 填到 DSH 卡片 1. 在本机回环地址跑 `dsh web`（`127.0.0.1`）。只有回环地址允许写入凭证。 2. 设置 → 插件配置 → **腾讯云 ADP**。 3. 选 **独立站** 或 **公有云**。 4. 贴上工具密钥、SecretId 和 SecretKey，保存。值经 `credentials.set` 写入 `$DSH_HOME/.credentials.yaml`。 5. AKSK 存上之后，卡片用 `DescribeSpaceList` 拉工作空间列表，选一个。公有云的应用和插件调用需要真实 **SpaceId**；补丁默认的 `default_space` 在多数账号上不是工作空间（控制面 `4510004`）。列表为空时，从 ADP 控制台把 SpaceId 贴进去（[工作空间](https://cloud.tencent.com/document/product/1759/122576)）。 ## 装上即用 `adp-core`、`llm-adp`、`web-adp`、`plugins-adp`、`skills-adp`、`control-adp`、`subagent-adp` 和 `tool-subagent-adp` 随插件启动。`agents-adp` 仍由包内的 `/agents` 入口提供，但默认 bundle 不加载： - 选 `adp:Hunyuan/hy3`（或其他网关模型），完成一轮带工具调用的对话。目录和补全怎么接：[docs/seams.md](docs/seams.md#how-models-work-llm-adp)。 - 当前 provider 选中时，`web_search` 走混元 AI 搜索=。 - 用 `adp_plugin_list` / `adp_plugin_enable` 或 `enabledPluginIds` 打开市场里的 API / MCP 插件。公有云的应用和插件调用需要先选好工作空间。 - 生成类媒体链接会落到工作区 `saved_files`。 - 技能广场作为 `ctx.skills` provider（没有下载 URL 的条目只出现在 `list`）。 - 可选的 `agents-adp` 提供 `adp_provision_agent` 和 `adp_ask` / `adp_ask_`；需要旧的普通问答工具模式时手动加载 `@tencentcloudadp/dsh-adp/agents`。 - `subagent_adp` — 把已发布的 ADP 应用作为真正的 DSH child Agent 运行；思考、远端工具轨迹和最终回复写入原生 child session。默认从 `TENCENT_ADP_APP_KEY` 解析 AppKey；未显式配置 `endpoint` 时，每次调用都复用 `adp-core` 当前站点的 SSE 地址。 - `adp_list_actions` / `adp_call`，配合 `allowMutating` 做 App/Agent/Release 的增删改。会改控制面的调用需要审批。 ## 文档 - [docs/credentials.md](docs/credentials.md) — 每类凭证从哪来，缺了会坏什么 - [docs/seams.md](docs/seams.md) — 本插件与 DSH 之间的对接约定 - [docs/pitfalls.md](docs/pitfalls.md) — 踩过的坑 - [docs/verification.md](docs/verification.md) — 手工验证清单 ## 验证 ```sh pnpm test # 模拟 HTTP；不需要密钥；CI 门禁 pnpm test:live # 真实账号；环境变量缺失则跳过 ``` ## 贡献 欢迎在 [GitHub](https://github.com/TencentCloudADP/Tencent-ADP-dsh-plugin) 提 Issue 和 PR。提 PR 前先跑一遍 `pnpm test`。 ## 许可证 MIT。Copyright (C) 2026 Tencent。正文和第三方声明见 [LICENSE.txt](LICENSE.txt)（`eventsource-parser`、`fflate`）。