Files
.pouch/skills/previewer
2026-10-12 12:53:10 +08:00
..
2026-10-11 18:19:46 +08:00
2026-10-12 12:53:10 +08:00
2026-10-12 12:53:10 +08:00
2026-10-12 12:53:10 +08:00
2026-10-12 12:53:10 +08:00

previewer

用 Node 启动默认存活 1 小时的轻量静态服务,再通过 Tailscale Serve 把本机的 HTML、PRD、报告 或其它静态文件暴露给 tailnet,并返回可访问的 HTTP URL。

什么时候使用

  • 想在手机、平板或另一台电脑查看本机生成的 HTML。
  • 其它 skill 需要把某个文件交给通用预览服务。

只面向 Tailscale tailnet,不提供公网访问,也不启动动态 Web 服务。

使用前准备

  • 本机已安装 Node.js、已登录 Tailscale,且访问者也在允许访问的 tailnet 中。
  • 提供要展示的文件路径;文件所在目录会被作为静态目录服务。

使用示例

用 previewer 展示这个文件:/workspace/docs/prd-v002.html,挂载到 /preview/billing。

Agent 会做什么

  1. 检查 Tailscale 是否在线,以及 Serve 状态是否可读取。
  2. 用 Node 在 localhost 启动文件所在目录的静态服务。
  3. 将指定 Tailscale 路径代理到本地端口。
  4. 返回包含 Tailscale IPv4 的 HTTP URL、Node PID、过期时间和停止命令。

默认 1 小时后自动关闭 Node 服务和对应的 Tailscale 路由;需要其它时长时可传 --ttl 秒数。

如何判断完成

  • 得到一个 HTTP URL,并能从 tailnet 内的另一台设备打开目标文件。
  • 失败时明确说明是 Tailscale 未安装、未登录、路由冲突还是 Serve 命令失败。