宿主指南 · 豆包工作

在豆包工作里使用海报大师

豆包不运行本地脚本,所以这里走另一条路:让它通过 MCP 连接器触达你本机的工具。

下面每一步都在豆包工作 · macOS 上实测过。 这条路已证实可行——不是推断:本机探针记下了它真实发起的工具调用。 但它不等于能在豆包里跑完整编辑流程,那一项仍待验收。

Skill 版本
v1.0.0 · 263124 字节
ZIP SHA-256
fa4087b7a8766b8d60e25a41ce32dce3ba5eabc414625f8d523f984f110fb3c5
实测环境
macOS 25.6.0 · 豆包的 MCP 客户端 rmcp 3.0.0(应用版本本次未核实,故不写)

先理解这一点

为什么这里和 WorkBuddy 不一样

豆包工作不会替你运行本地脚本。 所以它用不了 WorkBuddy 那条「让宿主跑 CLI」的路子。可行的是另一条: 你在自己的终端启动一个只监听回环地址的本机服务,豆包通过 MCP 连接器调用它暴露的工具。 这条路我们已实测证实;它的代价是要你手动配一次连接器。

操作步骤

四步配通

每一步都给出应当看到的实际输出。

  1. 1

    下载校验并解压

    下载 Skill ZIP, 用 SHA256SUMS.txt 核对 (本版为 fa4087b7a8766b8d60e25a41ce32dce3ba5eabc414625f8d523f984f110fb3c5),解压到你自己的目录。

  2. 1b

    把技能装进豆包(已实测成功)

    在豆包的技能入口上传同一个 ZIP 即可。 这条已实测通过:装完后客户端技能目录 (~/Library/Application Support/DoubaoWork/<Profile>/.doubaowork/agent_mode/workspace/.user_skills/<slug>/) 里的 SKILL.md 报出 version: 1.0.0—— 我们是直接读磁盘上那份文件核实的,不是看界面标签。

    上传这一步需要你手动点原生文件面板,和 WorkBuddy 一样。 与 WorkBuddy 不同的是:豆包这边没有出现"已经安装、不能重复"的拒绝, 我们这次的上传直接把版本换成了新的。

    装了技能并等于豆包会替你跑本地脚本——下面那条 MCP 路径仍然是必要的。

  3. 2

    切到「本地电脑」模式

    这一步不做后面全都不成立。 豆包的输入框工具条上有一个执行目标选择器;自定义连接器只在「本地电脑」模式下可用 (豆包自己的对话框里就这么写)。选成「云电脑」时,任务跑在云端 VM 里, 永远碰不到你本机的回环地址,探针会一直连不上。

  4. 3

    在你自己的终端启动探针

    准备一个只放测试文件的目录,然后:

    node scripts/probe-host.mjs --http --root "<测试目录>" --out "<测试目录>/evidence.json"

    它输出一行 JSON,其中 url 是回环页面地址,url + mcp 是 Streamable HTTP 端点。它只监听 127.0.0.1,唯一的写入是 --out 指定的那个文件, 而且证据里的路径只保留文件名、不含你的用户名。

  5. 4

    配连接器(这一步需要你手动点)

    输入框工具条「连接器」→「管理连接器」→ 新增/编辑一个自定义连接器: 传输类型 HTTP(Streamable HTTP),服务器 URL 填上一步的 url + mcp,保存后把它的开关打开。

    这一步无法自动化: 豆包的对话框不暴露任何可访问控件(辅助功能树里只有窗口的关闭/最小化/全屏三个按钮), 所以程序按不到它的「保存」。我们如实写明它需要人工完成。

    连接器开关是按对话生效的:新开一个对话里它可能是关着的, 那时豆包会回答「看不到这个连接器」——这句话就是提示你去把开关打开。

用起来

在对话里调用,以及一个容易卡住的细节

配好后,在对话里请它依次调用连接器暴露的工具并把返回原样贴出来。实测它会真的调用:

echo_file      {"path":"poster.jpeg","form":"absolute-posix"}   ok
workbench_url  (无参数)                                      ok
write_evidence (无参数)                                      ok

发送快捷键是 + Enter, 不是 Enter。这一条值得单独写出来:单按 Enter 不会发送,而它的发送按钮也按不到, 很容易以为「消息发不出去」。

跑完后用探针自己的汇总看结果,不要只看宿主怎么说

node scripts/probe-host.mjs --summarize "<测试目录>/evidence.json"

实测到的问题

会遇到什么

  • 要当心

    宿主的技术解释不能当证据

    实测一次:我们请求四个工具,它只调了三个, 然后解释说「探针里定义了那个工具,但连接器未向宿主导出」,还声明自己没有编造返回。 这句解释是错的——直接问探针,tools/list 返回的四个工具里就有它。 它只是没调,原因不在探针。所以请以 --summarize 的输出为准, 而不是以宿主的自述为准。

  • 需人工

    配连接器要手动

    见第 4 步。另外「连接器」菜单有时点不开,重试或换个入口即可。

验收边界

这份指南覆盖了什么