previewer

用 Node 直接预览已有 HTML 和静态文件，返回可打开的 HTTP URL。只需要 Node.js，无需安装 npm 依赖，也不配置隧道或代理。

用法

node ~/.pouch/skills/previewer/scripts/serve_file.js /workspace/preview/index.html

默认只允许同机访问，自动选择空闲端口，一小时后关闭。需要局域网访问时：

node ~/.pouch/skills/previewer/scripts/serve_file.js /workspace/preview/index.html --host 0.0.0.0 --port 8088

输出包含 URL、监听地址、端口、PID、过期时间和停止命令。绑定所有接口时还会列出本机网卡的候选 URL，实际可达性取决于访问者所在网络。

其它 skill 生成文件后，直接执行上面的同一份脚本，读取 JSON，不需要再次委派 Agent。相同文件和参数的连续或并发调用会复用仍存活的服务，端口与过期时间保持不变。 HTML、CSS 或 JavaScript 更新后刷新页面即可；React 等项目需先由调用方构建成静态文件。

文件父目录作为服务目录，相对资源可以正常加载；不提供目录列表，也不允许访问目录外的文件。本工具提供文件，页面由浏览器渲染；不执行模板生成或截图。

node --test ~/.pouch/skills/previewer/tests/serve_file.test.js