用途
该技能用于为一个已经存在的智能体 Webhook 接收端构建本地控制 UI,并在用户要求时通过 Tailscale 暴露该 UI。它不负责创建新的 Codex 或 Claude Webhook 服务,而是围绕现有接收端进行集成。
主要能力
- 识别现有接收端,阅读其文档化的请求、认证与成功契约,确认哪个事件会启动智能体工作,以及如何观察投递结果。
- 定义 UI 的小型操作 schema 以及接收端允许的操作。
- 将请求体视为不可信数据,进行输入验证与授权设计。
- 通过环境已有的安全机制获取凭据,并保留在服务端,不放入浏览器、聊天或技能本身,不打印、不记录凭据值。
- 使用仓库现有技术栈构建 UI 与本地服务端代理,默认绑定 localhost。
- 遵循接收端真实的请求头、超时、幂等与重试契约,不把任意 HTTP 200 当作工作已启动的证明,不通过 Webhook 发送媒体字节。
- 使用无害的受支持事件或契约夹具进行验证,并检查对应的投递或执行证据。
- 仅在用户要求时通过 Tailscale 暴露 UI,复用已有节点,检查可用 CLI,遵循当前文档化的设置流程。
使用方式
- 确认接收端存在并读取其契约;若不存在,报告该前置条件并停止此集成路径。
- 定义 UI 操作 schema 与接收端允许操作,完成输入验证、授权与凭据存储的具体设计。
- 使用仓库技术栈构建 UI 与本地服务端代理,默认绑定 localhost,浏览器请求只到达本地代理,代理遵循文档化的接收端协议。
- 用无害事件或契约夹具验证,检查投递或执行证据,保留失败可见;仅当接收端确实能排空或确认时,才使用持久重试队列。
- 若用户要求暴露,则通过 Tailscale 进行:复用已有节点,不在此前已在线节点上创建第二个主机名;将服务器绑定到 0.0.0.0:<port> 而非 127.0.0.1;若设置打印登录 URL,将该 URL 发送给用户,由用户在浏览器中批准机器;不索取、不输入 Tailscale 凭据;若登录 URL 过期,重新运行 tailscale up 并发送新 URL;向用户提供 http://<hostname>.<tailnet>.ts.net:<port> 与 http://<100.x.x.x>:<port>,使用 HTTP,除非用户要求否则不添加 HTTPS。
适用场景
- 已有智能体 Webhook 接收端,需要为其添加本地控制界面。
- 需要在本地验证 Webhook 投递与执行行为。
- 需要在受控网络内通过 Tailscale 访问该控制 UI。
限制
- 若不存在接收端,则无法继续此集成路径。
- 不创建新的 Codex 或 Claude Webhook 服务。
- 不通过 Webhook 发送媒体字节。
- 不将凭据暴露给浏览器、聊天或技能本身。
- Tailscale 暴露仅在用户要求时进行,且不索取或输入 Tailscale 凭据。
- 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。