WebMCP 工具工作区jo32/DeepDeck

DeepDeck

在面向 DeepSeek Harness 的 macOS 桌面工作区中构建并复用 WebMCP 工具。

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

描述一个网站任务。DeepDeck 的 Agent 可以使用该网站已有的 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。

让 Agent 使用网站，然后把它学到的东西保存为 WebMCP 工具。 你描述目标。Agent 探索真实网站，尝试其工作流程，检查结果，并将可用的操作保存为可复用的工具。构建 WebMCP 就像保存 Agent 使用网站的经验，这样未来的任务就可以复用它，而无需人工编写分步说明。
这种经验存在于可检查、可执行的工具中：如何搜索、读取结果，或编辑并验证草稿。DeepDeck Browser 既支持复用已有的 WebMCP 工具，也支持为没有这些工具的网站快速构建工具，让现有产品更容易被智能体使用。

什么是 WebMCP？

WebMCP 是一个提议中的 Web API，它让网站能够将 JavaScript 函数或 HTML 表单暴露为工具，并带有自然语言描述和结构化输入模式。智能体可以发现网站的功能，提供正确的参数，并在当前页面内调用其工具，共享用户的浏览器上下文和可见界面。它是对后端 MCP 集成的补充。

WebMCP 与普通计算机使用

计算机使用通过网站界面进行操作：观察、定位控件、点击或输入，然后再次观察。WebMCP 暴露带有描述和输入模式的具名能力，因此模型可以调用工具并读取其结果。参见 WebMCP 项目的动机与目标。

| | 普通计算机使用 | WebMCP |
| --- | --- | --- |
| 理解 | 从截图或页面结构推断功能和状态。 | 发现明确的工具名称、描述和参数。 |
| 执行 | 在多个观察/操作步骤中定位并操作控件。 | 向工具提供参数；它执行相应操作并返回结果。 |
| 复用 | 通常重复 UI 步骤；复用需要单独保存脚本或工作流。 | DeepDeck 将已验证的操作保存为工具，供后续任务复用。 |
| 时间和 token | 重复的页面读取和模型决策会增加开销。 | 对于工具覆盖的任务，更少的观察和交互轮次可以节省时间和 token。 |
| 最适合 | 探索网站并处理没有现成工具的交互。 | 调用现有工具并复用重复出现的网站工作流。 |

例如，使用计算机使用搜索关键词并读取结果通常意味着找到搜索字段、输入、提交、读取新页面并提取结果。使用 WebMCP 时，智能体用关键词调用搜索工具并读取结果，如果需要，还可以使用单独的结果读取工具。

DeepDeck 结合了两种方法。 智能体通过浏览器交互探索并验证网站，然后将可用的操作保存为 WebMCP 工具。后续任务可以复用这些经验，对于工具未覆盖的内容仍可使用浏览器交互。初始工具构建需要探索和验证；节省程度取决于网站、工具设计和任务，网站变化可能需要更新工具。

1. 复用现有的 WebMCP
打开一个网站，选择 Site Agent → WebMCP，然后查看 Website 下发现的工具。在 Use 模式下，描述你的任务，Agent 就可以调用可用的工具。下面的截图展示了 DeepDeck 在 openai.com 上发现 search_openai。

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

2. 快速为现有网站添加 WebMCP

对于没有 WebMCP 的网站，打开 WebMCP Builder 或将 Site Agent 切换到 Builder。描述你想要的能力，例如：“为这个网站构建 WebMCP 工具，以便我可以搜索、阅读帖子和编辑草稿。”你提供目标；Agent 会找出如何使用该网站。Builder 会探索其真实控件，尝试相关工作流，并将验证过的操作转化为工具。这样就把这些经验保存在 DeepDeck 中，而无需修改网站源代码或部署单独的 MCP 服务器。

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

X 示例生成了 23 个工具，显示在 Built with DeepDeck 下，包括读取账户状态、帖子、个人资料和搜索状态。网站提供的工具和用 DeepDeck 构建的工具会一起显示，并区分其来源。启用的工具按网站保存，并在你返回时再次加载；来源和已保存版本仍可供检查和回滚。

WebMCP 选项卡列出了为 X 用 DeepDeck 构建的 23 个工具

切换回 Use 并请求执行任务。在这个示例中，“compose a hello world x post”会调用 WebMCP 工具，将 Hello, world! 👋 准备为草稿。帖子不会被发布；填写和提交是分开的操作。Use 和 Builder 共享该网站的对话，因此你可以构建缺失的能力，并就地继续你的工作。

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

探索 → 使用 → 验证 → 保存 → 复用。 Agent 在网站上的工作会成为下一个任务可复用的能力，帮助现有产品通过 agent 变得更易使用，同时保留其熟悉的 Web 界面。

有关详细信息，请参阅 Browser 指南，有关功能公告，请参阅网站更新。

应用与桌面工作区

DeepDeck 桌面应用

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

架构
DeepDeck 是一个基于 DeepSeek Harness 构建的、具有原生体验的桌面客户端。上游项目以浅层 Git 子模块的形式固定在 vendor/deepseek-harness；本仓库负责桌面生命周期、插件组合界面、品牌、打包以及自动更新层。dsh-codex-connect 仍是一个单独固定的检出，并作为普通的 Cordis 包预加载。

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

插件可以从 dshfind 支持的市场中发现并安装，位于 Settings → Apps。DeepDeck 将 dshfind 视为发现目录：它会验证所选的 GitHub 仓库和 DSH 包，预览构建计划，在禁用生命周期脚本的情况下安装依赖，并在运行插件自身的构建脚本之前要求确认。受信任的本地插件源代码也可以从 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），因此配置文件、模型设置、凭据、补丁和已安装插件与上游 CLI 保持兼容。如果需要隔离的桌面配置文件，请在启动前设置 DSH_HOME。

品牌

面向用户的品牌位于上游子模块之外的 branding/brand.json 中。替换所引用的字标、标记、favicon 和应用图标文件即可重新品牌化桌面，而无需编辑 vendor/deepseek-harness。设置 DESKTOP_BRAND_PATH 以在启动时加载不同的清单文件。

常用命令

pnpm start             # 复用最新的构建产物，重新构建已更改的代码，并启动
pnpm start:rebuild     # 强制进行桌面重新构建并启动
pnpm start:packaged    # 重新构建并启动打包后的桌面客户端
pnpm check             # 对桌面主进程、预加载和渲染进程代码进行类型检查
pnpm test              # 运行针对性的桌面测试
pnpm test:harness-ui   # 使用隔离的配置文件验证真实的 Electron + Harness
pnpm test:questions    # 根据录制的模型输出验证问题卡片
pnpm package:local     # 构建并验证未签名的本地 macOS 包
pnpm package:mac       # 构建已签名的生产 macOS 包
pnpm harness:build     # 重新构建固定版本的 Harness 检出

DeepDeck WebMCP 基准测试指南 说明了如何编辑 benchmarks/webmcp 中的本地语料库、添加你自己的任务文件，以及通过隔离的 DeepDeck Agent 会话运行 Docker 网站。可用命令请从 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 许可证 下提供。固定版本的 DeepSeek Harness 子模块及其他第三方依赖保留各自的许可证。

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