docs: clarify HTML previewer integration

2026-10-13 00:21:22 +08:00
parent ab29598a9a
commit d3b6732d40
7 changed files with 40 additions and 16 deletions
@@ -1,11 +1,12 @@
 # previewer

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

 ## 什么时候使用

 - 想在手机、平板或另一台电脑查看本机生成的 HTML。
+- 可以直接说“把这个 HTML 渲染出来，并告诉我用哪个 IP”。
 - 其它 skill 需要把某个文件交给通用预览服务。

 只面向 Tailscale tailnet，不提供公网访问，也不启动动态 Web 服务。
@@ -21,12 +22,17 @@
 用 previewer 展示这个文件：/workspace/docs/prd-v002.html，挂载到 /preview/billing。
 ```

+```text
+把 /workspace/docs/prd-v002.html 渲染出来，告诉我用哪个 IP 和 URL 查看。
+```
+
 ## Agent 会做什么

 1. 检查 Tailscale 是否在线，以及 Serve 状态是否可读取。
 2. 用 Node 在 localhost 启动文件所在目录的静态服务。
 3. 将指定 Tailscale 路径代理到本地端口。
-4. 返回包含 Tailscale IPv4 的 HTTP URL、Node PID、过期时间和停止命令。
+4. 返回 Tailscale IPv4、完整 HTTP URL、Node PID、过期时间和停止命令，并明确告诉用户
+   应该使用哪个 IP。

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