SuperAPI AI 工具集

pstack-make-bot-ui

智能体与模型

查看项目

更新于 10-28 16:16

技能介绍

用途

该技能用于为一个已经存在的智能体 Webhook 接收端构建本地控制 UI,并在用户要求时通过 Tailscale 暴露该 UI。它不负责创建新的 Codex 或 Claude Webhook 服务,而是围绕现有接收端进行集成。

主要能力

  • 识别现有接收端,阅读其文档化的请求、认证与成功契约,确认哪个事件会启动智能体工作,以及如何观察投递结果。
  • 定义 UI 的小型操作 schema 以及接收端允许的操作。
  • 将请求体视为不可信数据,进行输入验证与授权设计。
  • 通过环境已有的安全机制获取凭据,并保留在服务端,不放入浏览器、聊天或技能本身,不打印、不记录凭据值。
  • 使用仓库现有技术栈构建 UI 与本地服务端代理,默认绑定 localhost。
  • 遵循接收端真实的请求头、超时、幂等与重试契约,不把任意 HTTP 200 当作工作已启动的证明,不通过 Webhook 发送媒体字节。
  • 使用无害的受支持事件或契约夹具进行验证,并检查对应的投递或执行证据。
  • 仅在用户要求时通过 Tailscale 暴露 UI,复用已有节点,检查可用 CLI,遵循当前文档化的设置流程。

使用方式

  1. 确认接收端存在并读取其契约;若不存在,报告该前置条件并停止此集成路径。
  2. 定义 UI 操作 schema 与接收端允许操作,完成输入验证、授权与凭据存储的具体设计。
  3. 使用仓库技术栈构建 UI 与本地服务端代理,默认绑定 localhost,浏览器请求只到达本地代理,代理遵循文档化的接收端协议。
  4. 用无害事件或契约夹具验证,检查投递或执行证据,保留失败可见;仅当接收端确实能排空或确认时,才使用持久重试队列。
  5. 若用户要求暴露,则通过 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 凭据。
  • 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。