WebMCP 工具工作区 jo32/DeepDeck

DeepDeck

在 macOS 桌面工作区里构建并复用 WebMCP 工具，为 DeepSeek Harness 服务。

下载 Mac 版 · Apple Silicon / Intel ·官网 ·试一试 ·浏览器指南

描述一个网站任务。DeepDeck 的智能体可以直接使用网站已有的 WebMCP 工具，也可以探索网站界面，构建出工具，供你查看并在以后复用。源码和已保存的版本随时可查，可停用，也可回滚。

| 为网站构建工具 | 在任务中复用这些工具 |
| Builder 报告为 X 创建并验证了 23 个工具 | Use 模式调用已保存的工具，准备一份 Hello world 草稿但不发布 |
| 在这个 X 示例里，Builder 创建了 23 个工具，用于读取页面、搜索和编辑草稿。 | 切到 Use，让它准备一份 Hello world 草稿。示例会填好草稿，但不发布。 |

初次探索和验证要花时间，也要消耗 token。复用能省多少，取决于任务和工具设计；网站改版后可能需要重新验证。具体能省多少，目前还没有定论。

试一试

1. 下载最新版本，选适合你 Mac 的 DMG，打开 DeepDeck。如果还没配置过 Harness，先在设置里配好模型。
2. 打开 Browser，访问一个网站，再打开 Site Agent → WebMCP，查看网站提供了哪些工具。
3. 如果缺了需要的工具，切到 Builder，描述它该做什么。检查生成的工具和验证结果，然后回到 Use，让它执行任务。

DeepDeck 是 macOS 桌面应用，请从 Releases 安装。通用的 dsh plugin add 命令装不了桌面应用，也装不了它自带的浏览器桥接。想从源码开发，见首次运行。

亮点

浏览器 + WebMCP

下载最新 DeepDeck 版本，支持 Apple Silicon 和 Intel Mac。

让智能体去用网站，再把它学到的东西存成 WebMCP 工具。 你描述目标，智能体探索真实网站，试跑它的工作流，核对结果，把跑通的操作保存成可复用的工具。构建 WebMCP，相当于把智能体使用网站的经验留存下来，以后的任务直接复用，不用再让人一步步写操作说明。
这套经验落在可检查、可执行的工具里：怎么搜索、怎么读结果、怎么编辑并校验草稿。DeepDeck Browser 既支持复用已有的 WebMCP 工具，也支持为还没有工具的网站快速构建工具，让现有产品更容易被智能体操作。

什么是 WebMCP？

WebMCP 是一项提案中的 Web API，让网站把 JavaScript 函数或 HTML 表单暴露成工具，并附带自然语言描述和结构化输入 schema。智能体能发现网站能做什么，给出正确的参数，在当前页面内调用它的工具，共享用户的浏览器上下文和可见界面。它是对后端 MCP 集成的补充。

WebMCP 与普通 computer use 的对比

computer use 通过界面操作网站：观察、定位控件、点击或输入，再观察。WebMCP 暴露的是具名能力，带描述和输入 schema，模型可以直接调用工具并读取结果。参见 WebMCP 项目的动机与目标。

| | 普通 computer use | WebMCP |
| 理解 | 从截图或页面结构推断功能和状态。 | 发现明确的工具名、描述和参数。 |
| 执行 | 在多个观察/动作步骤中定位并操作控件。 | 给工具传参数；工具执行对应操作并返回结果。 |
| 复用 | 通常要重复 UI 步骤；复用需另行保存脚本或工作流。 | DeepDeck 把验证过的操作保存成工具，后续任务可直接复用。 |
| 时间与 token | 反复读页面、反复做模型决策，带来额外开销。 | 对工具有覆盖的任务，观察和交互轮次更少，能省时间和 token。 |
| 最适合 | 探索网站，处理没有现成工具的交互。 | 调用已有工具，复用反复出现的网站工作流。 |

举个例子，用 computer use 搜索关键词并读取结果，通常要找到搜索框、输入、提交、读新页面、提取结果。用 WebMCP，智能体把关键词传给搜索工具，读取结果，需要时再调用单独的结果读取工具。

DeepDeck 把两种方式结合起来。 智能体通过浏览器交互探索并验证网站，再把跑通的操作保存成 WebMCP 工具。后续任务可以复用这套经验，工具覆盖不到的地方仍可走浏览器交互。初次构建工具需要探索和验证；能省多少取决于网站、工具设计和任务，网站改版后可能还要更新工具。

1. 复用已有的 WebMCP

打开网站，选择 Site Agent → WebMCP，在 Website 下查看发现的工具。在 Use 模式下描述你的任务，智能体就能调用可用的工具。下图展示 DeepDeck 在 openai.com 上发现 search_openai。

DeepDeck 在 openai.com 的 Website 下自动发现 search_openai 工具

2. 快速给已有网站加上 WebMCP

网站没有 WebMCP 时，打开 WebMCP Builder，或把 Site Agent 切到 Builder。描述你想要的能力，例如：「给这个站点构建 WebMCP 工具，让我能搜索、读帖子、编辑草稿。」你给出目标，智能体自己摸索怎么用这个站点。Builder 会探索站点的真实控件，试跑相关的工作流，把验证过的操作变成工具。这段经验保存在 DeepDeck 里，不用改网站源码，也不用单独部署 MCP 服务器。

WebMCP Builder 报告为 X 构建并验证工具

X 这个例子产出了 23 个工具，列在 Built with DeepDeck 下，包括读取账号状态、帖子、个人资料和搜索状态。网站自带的工具和 DeepDeck 构建的工具一起显示，来源有区分。启用的工具按网站保存，下次回来会重新加载；来源和已保存版本都留着，可以查看，也可以回滚。

WebMCP 标签页列出为 X 构建的 23 个工具

切回 Use，提出任务。这个例子里，「compose a hello world x post」会调用 WebMCP 工具，把 Hello, world! 👋 准备成草稿。帖子不会发布；填写和提交是两个分开的动作。Use 和 Builder 共用站点的会话，所以你可以补上缺的能力，就地接着干活。

Site Agent 调用 WebMCP 工具在 X 上撰写 Hello world 草稿，但不发布

探索 → 使用 → 验证 → 保存 → 复用。 智能体在网站上的工作，变成下一个任务可复用的能力，让已有产品借助智能体变得更好用，同时保留用户熟悉的网页界面。

细节见 Browser 指南，功能公告见网站更新。

应用与桌面工作区

DeepDeck 桌面应用

- 扩展你的工作区。 在 Settings → Apps 里发现并安装 Harness 插件，或用 Bun Builder 构建可信的本地插件源码。
- 沿用熟悉的 Harness 设置。 在桌面应用里使用兼容的配置档、模型设置、凭据和已安装插件，支持原生浏览器标签页、下载和自动更新。

架构

DeepDeck 是桌面客户端，操作体验贴近原生应用，基于 DeepSeek Harness 构建。上游项目固定在 0.2.1-rc.2（687f282e86），以浅克隆 Git 子模块的形式放在 vendor/deepseek-harness。插件开发依赖也链接到这份检出，其中包括 Cordis 和 Schemastery 两个库，它们尚未发布到 RC 要求的版本。本仓库负责桌面生命周期、插件组合界面、品牌、打包和自动更新层。dsh-codex-connect 仍是独立的固定检出，作为普通 Cordis bundle 预加载。

DeepDeck 复用官方 web 配置档及其完整的插件组合 UI。桌面宿主在操作系统分配的环回端口上启动 Harness 进程，等它就绪后，在应用窗口里打开本地 UI。关闭应用时，Harness 进程会干净退出。

在 Settings → Apps 里，可以从 dshfind 支持的市场发现并安装插件。DeepDeck 把 dshfind 当作发现目录：校验选中的 GitHub 仓库和 DSH bundle，预览构建计划，安装依赖时禁用生命周期脚本，运行插件自带的构建脚本前要求你确认。受信任的本地插件源码也可以在 Settings → Plugins → Bun Builder 里编译。

首次运行

前置条件：Node.js ^22.19.0 或 >=24.0.0、Corepack、Git。

git submodule update --init --depth 1
pnpm install
pnpm bootstrap
pnpm start

pnpm bootstrap 安装并构建固定的 Harness 和 Codex Connect 源码，然后构建桌面应用。之后运行 pnpm start 时，只要源码、构建配置和依赖没变，就复用已有的桌面产物；相关改动或产物缺失会自动触发重建。拉取更新了 Harness 子模块后，启动时会先安装其固定依赖并重建引擎，再编译桌面插件。pnpm check 和桌面构建执行同样的引擎就绪检查。想强制重建桌面，用 pnpm start:rebuild。

桌面使用标准 Harness 主目录（$DSH_HOME，未设置时为 ~/.dsh），因此配置档、模型设置、凭据、补丁和已安装插件都与上游命令行兼容。想要隔离的桌面配置档，就在启动前设置 DSH_HOME。

首次启动时，DeepDeck 把桌面 bundle 加入 web 配置档，并保持本地插件链接可用。bundle 默认值在用户补丁之前应用，所以在 Harness 0.2.1 下设置仍可写。已有的配置档清单会备份为 package.json.deepdeck-before-bundle。

品牌

面向用户的品牌资源放在上游子模块之外，路径是 branding/brand.json。替换其中引用的文字标识、图标、favicon 和应用图标文件，就能给桌面端换品牌，无需改动 vendor/deepseek-harness。启动时设置 DESKTOP_BRAND_PATH，可加载另一份清单。

常用命令

pnpm start # reuse fresh artifacts, rebuild changed code, and launch
pnpm start:rebuild # force a desktop rebuild and launch
pnpm start:packaged # rebuild and launch the packaged desktop client
pnpm check # type-check desktop main, preload, and renderer code
pnpm test # run focused desktop tests
pnpm test:harness-ui # verify real Electron + Harness with an isolated profile
pnpm test:questions # verify question cards against recorded model output
pnpm package:local # build and verify an unsigned local macOS package
pnpm package:mac # build signed production macOS packages
pnpm harness:build # rebuild the pinned Harness checkout

DeepDeck WebMCP 基准测试指南 说明了如何编辑 benchmarks/webmcp 里的本地语料、添加自己的任务文件，以及如何让 Docker 网站跑在隔离的 DeepDeck Agent 会话中。先运行 pnpm benchmark:webmcp 查看可用命令。

依赖边界和插件集成方向见 docs/architecture.md。

桌面端更新

打包版本启动后不久会检查更新。有新版本时，桌面端侧边栏显示更新提示；由你主动开始下载，并看到原生更新器的进度。下载完成后，桌面端会安全停止 Harness 进程，安装更新，然后自动重启。开发模式启动不会连接更新服务。

electron-updater 读取打包流水线生成到 app-update.yml 里的发布服务商。DEEPSEEK_DESKTOP_UPDATE_URL 可以用通用 HTTP(S) 源覆盖该服务商，适合受控构建和更新测试。生产更新发布到 https://deepdeck-updates.getmegaportal.com。该源包含平台元数据、签名产物和 blockmap；macOS 版本除 DMG 外还提供 ZIP 更新目标。

签名发布流程和回滚模型见 docs/release.md。

社区

LINUX DO

许可证

DeepDeck 采用 MIT License。固定的 DeepSeek Harness 子模块和其他第三方依赖各自保留自己的许可证。

直接测试网站的 WebMCP 增量：pnpm benchmark:webmcp ablate --url https://your-website.example --query "你的任务" --n 3。无需 Docker；详见 benchmark 文档。