前言¶
在 DeepSeek Harness（DSH）里让智能体操作 Vercel 项目、部署和平台能力，通常要面对两件事：一是如何安全地连上 Vercel 账号，二是 Vercel MCP 暴露的工具数量很大，若一次性全部塞进上下文，会占用大量 token。社区插件 @adenxie/dsh-vercel（仓库 AdenXie/dsh-vercel）把 DSH 接到 Vercel 官方 MCP，并用 OAuth 完成授权，同时内置 34 份官方 Vercel 技能说明，可按需加载。下面介绍它的定位、能力与安装用法。
这是什么¶
@adenxie/dsh-vercel 当前版本为 0.4.0，维护者为 AdenXie，在 SkillHub 目录 中归类为联网工具。简介为：Vercel MCP and on-demand official Vercel skills for DeepSeek Harness。
一句话：安装并登录后，模型可查你的 Vercel 项目、部署、团队等信息，并在需要时读取内置的 Vercel 技能指南；连接代码采用 MIT 许可，捆绑的 Vercel skills 采用 Apache 2.0。
运行环境要求（以 README 与 package.json 为准）：
- DeepSeek Harness：
0.2.1-rc.2至0.2.x（engines.dsh:>=0.2.1-rc.2 <0.3.0） - Node.js：
^22.19.0或>=24.0.0
README 标明已在 Desktop 与独立 Host profile 下验证（见 docs/VALIDATION-0.4.0.zh.md）。
核心功能¶
连接 Vercel 官方 MCP¶
插件通过 OAuth（PKCE）与 Vercel 建立连接。首次使用需完成浏览器登录；授权范围包含 openid、offline_access，以便 Vercel 下发 refresh token。连接成功后，Vercel 侧 MCP 工具在 DSH 中以 mcp__adenxie_vercel__* 形式出现。
同一套账号工具 adenxie_vercel_mcp_account 支持：
action=login：首次登录status、test、clear：查看状态、测试连接、清除凭据- 设置面板也可完成授权、刷新 token；从旧版升级且旧授权无 refresh token 时，需在设置面板重新授权
手动完成回调时可用 action=finish 并传入完整回调 URL（含 code 与 state），或分别传入二者；仅传 code 会被拒绝，因为插件会校验 state。
按需加载 MCP 工具¶
Vercel 服务端暴露的工具超过两百个，若全部交给模型会占用大量上下文。因此每个 Agent 启动时只有 8 个辅助工具：
- 用
adenxie_vercel_mcp_search_tools搜索 - 将需要的工具名传给
adenxie_vercel_mcp_load_tools，下一轮起该 Agent 即可使用对应 Vercel 工具 - 若已知原始工具名（如
list_projects），可直接加载而无需搜索
约束与行为（README 原文）：
- 单个 Agent 最多同时加载 6 个工具，合并后的 schema 不超过 32,000 字符
- 在
deepseek-flash上，会话中途加载的工具可能以 deferred 声明发送，测试中模型有时直到上下文压缩后才视为可调用；此时可用adenxie_vercel_mcp_call传入name与arguments调用已加载工具 - 工具列表在 DeepSeek 路由上为 addition-only：尽量避免卸载；仅在预算用尽时用
adenxie_vercel_mcp_unload_tools - 已加载工具属于当前 Agent；子 Agent 只能加载父 Agent 已加载的工具
- 断开连接会清空已加载工具，重连后需重新搜索与加载
向模型声明的 schema 会做精简（去掉不影响校验的注解、仅保留第一层参数描述等）；Vercel 服务端仍按完整 schema 校验。精简后仍超过约 6,000 字符的工具（README 提到当前有 10 个，含 update_project、create_deployment）会对最大属性做折叠，需要细节时可调用 adenxie_vercel_mcp_describe_tool。
内置 Vercel 技能¶
插件捆绑 34 份 Vercel 官方技能指南（skills/vercel），模型在需要时可按需读取，用于对齐 Vercel 平台的最佳实践与操作说明。
设置与客户端¶
package.json 中 dsh.client 注入了 @deepseek-ai/dsh-client-ui-settings，面向 web 平台，提供与 OAuth、token 刷新相关的设置界面能力。
安装与启用¶
Desktop 与 Web 使用不同的 profile，请安装到实际运行插件的那一侧。安装前建议先打开一次 DSH Desktop 以生成 profile，然后完全退出 Desktop 再执行 CLI 安装。
从 npm 安装（推荐）¶
Windows Desktop 示例（使用 Desktop 自带的 dsh.cmd，无需把 dsh 加入 PATH）：
$DshCli = Join-Path $env:LOCALAPPDATA 'Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd'
& $DshCli plugin --profile desktop add '@adenxie/dsh-vercel@0.4.0'
安装完成后重新启动 Desktop。若使用 Web profile：
dsh plugin --profile web add @adenxie/dsh-vercel@0.4.0
从 tarball 安装¶
从 v0.4.0 Release 下载 adenxie-dsh-vercel-0.4.0.tgz，在存放该文件的目录执行（Desktop 示例）：
$DshCli = Join-Path $env:LOCALAPPDATA 'Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd'
$Archive = (Resolve-Path './adenxie-dsh-vercel-0.4.0.tgz').Path
& $DshCli plugin --profile desktop add $Archive
其他平台可将路径与 profile 替换为：dsh plugin --profile web add /path/to/adenxie-dsh-vercel-0.4.0.tgz。
典型用法¶
1. 完成 Vercel 授权¶
在 DSH 中调用 adenxie_vercel_mcp_account，action=login，按提示在浏览器完成 Vercel 登录。之后可用 action=status 或 action=test 确认连接。
2. 按任务加载工具¶
例如要列出项目：先 adenxie_vercel_mcp_search_tools 查找相关工具，或已知名称时直接 adenxie_vercel_mcp_load_tools 加载 list_projects，再在后续轮次让模型调用对应 MCP 工具。若模型未识别新加载的工具，可改用 adenxie_vercel_mcp_call 显式调用。
3. 查阅平台技能¶
当对话涉及 Vercel 部署、项目配置等平台细节时，模型可读取插件内置的 Vercel skills，减少与官方文档不一致的臆测。
更完整的工具列表、与上游能力对比见仓库内 docs/VERCEL_PARITY_AUDIT.zh.md。
适用场景与注意¶
适合谁：已在 Vercel 上托管项目、希望在 DSH 智能体对话中查询部署状态、管理项目或按官方技能指引操作 Vercel 的开发者。
权限与安全：插件以当前 DSH 进程权限运行，OAuth 凭据保存在本机 profile 中。安装前请自行查看 GitHub 源码 与许可证（连接代码 MIT，skills Apache 2.0）。社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，仅作生态索引。
日常开发：README 建议日常使用 npm 包或 tarball；从源码 link: 安装主要用于开发场景。
结尾¶
@adenxie/dsh-vercel 把 Vercel 官方 MCP 与 34 份按需技能收进 DSH 插件：OAuth 一次登录、工具按会话搜索加载，在控制上下文体积的前提下操作项目与部署。目录页：https://www.skillhub.cn/plugins/AdenXie/dsh-vercel；源码与文档：https://github.com/AdenXie/dsh-vercel。
