feat: add previewer static serving
This commit is contained in:
@@ -0,0 +1,32 @@
|
||||
# previewer
|
||||
|
||||
把本机的 HTML、PRD、报告或其它静态文件通过 Tailscale Serve 暴露给 tailnet,并返回可访问的 HTTP URL。
|
||||
|
||||
## 什么时候使用
|
||||
|
||||
- 想在手机、平板或另一台电脑查看本机生成的 HTML。
|
||||
- 其它 skill 需要把某个文件交给通用预览服务。
|
||||
|
||||
只面向 Tailscale tailnet,不提供公网访问,也不启动动态 Web 服务。
|
||||
|
||||
## 使用前准备
|
||||
|
||||
- 本机已安装并登录 Tailscale,且访问者也在允许访问的 tailnet 中。
|
||||
- 提供要展示的文件路径;文件所在目录会被作为静态目录服务。
|
||||
|
||||
## 使用示例
|
||||
|
||||
```text
|
||||
用 previewer 展示这个文件:/workspace/docs/prd-v002.html,挂载到 /preview/billing。
|
||||
```
|
||||
|
||||
## Agent 会做什么
|
||||
|
||||
1. 检查 Tailscale 是否在线,以及是否已有 Serve 路由。
|
||||
2. 将文件所在目录挂到指定的独立路径,不覆盖冲突路由。
|
||||
3. 返回包含 Tailscale IPv4 的 HTTP URL 和停止该路由的命令。
|
||||
|
||||
## 如何判断完成
|
||||
|
||||
- 得到一个 HTTP URL,并能从 tailnet 内的另一台设备打开目标文件。
|
||||
- 失败时明确说明是 Tailscale 未安装、未登录、路由冲突还是 Serve 命令失败。
|
||||
Reference in New Issue
Block a user