技能介绍

它解决什么问题

已登录站点与公开页面不同：MCP 服务器可以通过 npx @taprun/cli 临时启动，但 Chrome 扩展的 native-messaging 桥接需要一个稳定的本地 tap 二进制。npx 的临时路径不能作为桥接目标，因此已登录站点需要真正的本地安装，而不是随用随下。问题在于：用户可能已经装了一部分，但不知道缺了哪一环；盲目重装往往浪费时间，甚至重复安装。

技能如何工作

第一步永远是诊断，不是安装。 运行 tap embed --verify 会打印一条前置条件阶梯：稳定二进制 → NM 桥接清单 → Chrome 扩展 → host socket，每一环都标 ✓ 或 ✗。只修 ✗ 的环，从最便宜的开始；已 ✓ 的直接跳过。如果全 ✓，直接告知已就绪并停止，不做多余的事。

逐环修复遵循最小代价原则：

缺少稳定二进制时，优先用 npx -y @taprun/cli bridge setup 将正在运行的引擎自复制到 ~/.tap/bin/tap，不产生二次下载；只有 npx 缺失时才回退到远程安装，且必须先展示命令并取得同意。
NM 桥接清单缺失时，用 tap bridge setup 幂等写入。
Chrome 扩展未安装时，打开商店页让用户点击 Add to Chrome 并接受权限提示——这是一道人工信任闸门，无法自动化。
host socket 未活时，确认 Chrome 在运行且扩展已启用。

修复后再次运行 tap embed --verify 确认全 ✓，然后让用户重启 WorkBuddy，让 MCP 在启动时重新加载。

适用边界与注意点

本技能只处理已登录站点；公开页面和开放 API 无需任何配置，MCP 服务器已经能跑。
逻辑在引擎里，本技能只做编排：不写配置文件、不硬编码路径，只调用命令、读取输出、补上缺失的环。
两道人工闸门（装二进制、装扩展）不能也不该自动化：凭据从不离开本机，扩展权限那一次点击是 Tap 复用已登录会话的信任步骤。
WorkBuddy 通过 ~/.workbuddy/mcp.json 连接 Tap（stdio: npx -y @taprun/cli mcp stdio）；不要运行 tap embed claude-code 或 tap embed cursor，否则会为其他 agent 注册重复的 MCP 服务器。