TencentCloudADP/Tencent-ADP-dsh-plugin

@tencentcloudadp/dsh-adp

把腾讯云 ADP 接到 DeepSeek Harness 的插件包。

License: MIT
Node
pnpm
GitHub stars

English ·

这个插件把一个 DSH profile 接到腾讯云 ADP：网关模型（混元等）、混元 AI 搜索、API/MCP 插件市场、技能广场，以及把 ADP 应用注册成 ask 工具。不是 ADP Worker。

安装

dsh plugin --profile web add @tencentcloudadp/dsh-adp
dsh web

装好后到 设置 → 插件配置 → 腾讯云 ADP 填凭证（见下节）。装不上、装过旧名字、或 pnpm 拦住构建的，见 docs/pitfalls.md。

配置：独立站 / 公有云

ADP 需要三类凭证。配置里只写引用名（ADP_API_KEY 等）；实际值放在 $DSH_HOME/.credentials.yaml 或环境变量。

官方 API 文档覆盖的是控制面 AKSK和AppKey SSE 对话。本插件还用一条 OpenAI 形态的模型网关，官方概览没有写这条。端点和密钥出处见 API 概览。平面和报错见 docs/credentials.md。

设置 → 插件配置 → 腾讯云 ADP 卡片

| 平面                   | 引用名                                | 官方出处                                                                                                                                              | 缺失时                                       |
| -------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
| 工具密钥                 | ADP_API_KEY                      | 独立站或公有云的 密钥管理页面，上方“新建工具密钥”                                                                                                                    | LLM / 搜索 / 插件调用报 MISSING_CREDENTIAL |
| SecretId / SecretKey | ADP_SECRET_ID / ADP_SECRET_KEY | 公有云：CAM 访问密钥。独立站：ADP 控制台 密钥管理                                                         | 模型 / 插件 / 应用目录为空                      |
| 按应用的 AppKey          | TENCENT_ADP_APP_KEY（subagent 默认）或 ADP_APP_KEY_* | 应用发布 → API 管理 或应用 调用（SSE） | subagent / ask 工具无法调用已发布应用 |

1. 开通 ADP

注册腾讯云并完成实名认证，再打开产品（产品概述）。主账号首次登录会自动建一个企业和一个默认工作空间；那个空间的 id 不是补丁里的字符串 default_space（企业、工作空间与权限概述）。

| 站点      | 控制台                                                    | 控制面                       | 对话 SSE                                          |
| ------- | ------------------------------------------------------ | ------------------------- | ----------------------------------------------- |
| 独立站 | adp.tencent.com             | capi.adp.tencent.com    | https://adp.tencent.com/adp/v2/chat           |
| 公有云 | 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 密钥管理。
2. 没有密钥就新建（主账号访问密钥管理）。立刻复制 SecretId 和 SecretKey；2023-11-30 之后新建的密钥只在创建时展示 SecretKey。
3. 子账号需要在 CAM 角色里开通智能体开发平台（原大模型知识引擎）读写权限（技术常见问题）。协作者账号不能用（122569）。

独立站 — ADP 控制台密钥（约 26 位，不是 AKID）：

1. 登录 adp.tencent.com。
2. 打开 密钥管理，复制 SecretId / SecretKey（API 概览 · 独立站）。

这对密钥只签控制面（DescribeModelList、DescribeSpaceList、市场目录）。它不是 ADP_API_KEY。

3. 获取工具密钥（ADP_API_KEY）

- 独立站：密钥管理上方新建“工具密钥”。
- 公有云：密钥管理上方点击“新建工具密钥”。

该工具密钥用于模型、 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、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 贴进去（工作空间）。

装上即用

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。
- 当前 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/seams.md — 本插件与 DSH 之间的对接约定
- docs/pitfalls.md — 踩过的坑
- docs/verification.md — 手工验证清单

验证

pnpm test         # 模拟 HTTP；不需要密钥；CI 门禁
pnpm test:live    # 真实账号；环境变量缺失则跳过

贡献

欢迎在 GitHub 提 Issue 和 PR。提 PR 前先跑一遍 pnpm test。

许可证

MIT。Copyright (C) 2026 Tencent。正文和第三方声明见 LICENSE.txt（eventsource-parser、fflate）。