让 AI 自动完成本地应用发现、分享方案选择、连接建立、故障修复与公网验证。
你只需要说出目标，最后拿走一条真正可用的链接。
在需要分享的项目目录中打开任意能够联网、读取文件并执行终端命令的 AI Agent，把下面这句话发给它：
请读取 https://github.com/claw-codes/share-local-app，安装并使用 Share Local App Skill，
把当前项目生成一个别人可以直接打开的链接，并帮我确认页面和主要功能都能正常使用。
完成后请只用简单的话告诉我分享链接和注意事项；当我说“停止分享”时，请直接帮我停止。
Tip
不用先克隆仓库，不用寻找 Skill 安装目录，也不用照着教程复制一串命令。把 GitHub 链接交给 AI，让它自己读取、安装并执行。
如果已经确定分享方案，可以直接在同一句话里说明：
优先使用 NATAPP，访问者主要在中国大陆。
使用 Cloudflare Quick Tunnel，我需要免费的临时 HTTPS 链接。
启动一个分享客户端并不难。难的是确保别人打开后真的能用。
| 常见结果 | Share Local App 的处理方式 |
|---|---|
| 页面打开了，数据却加载失败 | 同时验证页面、代理链路和关键 API |
| 前端 5173、后端 8000，不知道该分享哪个 | 从完整用户流程判断唯一正确入口 |
| 公网返回 403 / 502 | 定位并修复 Host 白名单、API 代理或 CORS |
| 终端一关，链接立即失效 | 后台运行客户端，保存 PID 和日志 |
| 重启后还在发送旧链接 | 从当前运行实例重新提取有效地址 |
| 一不小心公开了后台或敏感配置 | 分享前检查风险，凭据写入 Git 忽略目录 |
| “我这里能开”但别人打不开 | 区分本机验证与异地网络验证，不虚报结果 |
| 🔗 分享地址 直接发给访问者 |
✅ 验证结果 页面与关键 API |
🟢 运行状态 哪些程序要保持开启 |
⏯️ 一句话管理 说“停止分享”即可停止 |
🛡️ 风险说明 别人能查看或修改什么 |
flowchart LR
A[用户一句话提出需求] --> B[发现本地应用与端口]
B --> C[验证页面与关键 API]
C --> D{选择分享方案}
D -->|中国大陆优先| E[NATAPP]
D -->|免费临时 HTTPS| F[Cloudflare]
E --> G[建立并保持连接]
F --> G
G --> H[修复 Host / Proxy / CORS]
H --> I[验证公网页面与 API]
I --> J[用简单的话交付链接和注意事项]
核心原则是以实际证据为准，不凭配置猜测：不因为客户端启动了就宣布成功，不因为首页返回正常就忽略 API，也不把同一台电脑上的测试说成全球可访问。
查看 AI Agent 的完整执行清单
- 检查项目文件、进程、监听端口和历史日志。
- 从开发者视角判断哪个入口承载完整用户流程。
- 验证本地首页、健康检查和关键数据接口。
- 说明获得链接的人能够查看或修改什么。
- 让用户明确选择 NATAPP 或 Cloudflare。
- 只从官方来源获取客户端，并保护 Token。
- 将运行文件放入已忽略的
.share-local-app/。 - 后台启动分享客户端并提取当前链接。
- 验证公网页面、API 和客户端存活状态。
- 用简单的话交付链接和必要提醒；用户说“停止分享”时直接代为停止。
| NATAPP | Cloudflare Quick Tunnel | |
|---|---|---|
| 更适合 | 访问者主要在中国大陆 | 快速演示、海外访问、临时 HTTPS |
| 账号要求 | 需要账号和 Web 隧道 | 不需要账号 |
| 凭据要求 | 需要隧道 Authtoken |
不需要 Token |
| HTTPS | 免费版可能只有 HTTP；通常需付费套餐 | 自动提供免费临时 HTTPS |
| 地址稳定性 | 由 NATAPP 套餐决定 | 重启后随机地址会变化 |
| 主要限制 | 需要提前创建隧道 | 中国大陆可能不稳定，无可用性保证 |
| 推荐场景 | 国内客户预览、国内设备联调 | 临时 Demo、海外协作、快速分享 |
如果没有指定方案，Skill 会先用容易理解的语言说明差异，等你选择后再继续，不会因为某个客户端更容易安装就擅自替你决定。
Share Local App 不绑定某个 AI 产品。核心能力由通用 Markdown 指令和跨平台 Python 脚本组成：
share-local-app/
├── SKILL.md # Agent 工作流、决策规则与验收标准
├── scripts/
│ ├── tunnel_helper.py # 服务发现、链接提取与分层验证
│ └── run_detached.py # 后台启动、状态检查与停止
├── references/
│ ├── natapp.md # NATAPP 配置与验证
│ ├── cloudflare.md # Cloudflare Quick Tunnel 配置
│ └── troubleshooting.md # 403 / 502 / 1033 等故障矩阵
└── agents/openai.yaml # 可选的 OpenAI/Codex 界面元数据
只要 AI Agent 能够：
- 读取 GitHub 仓库和 Markdown；
- 检查、修改当前项目文件；
- 执行终端命令；
- 在需要时请求网络或系统权限；
它就能使用这套流程。agents/openai.yaml 只是一个可选适配层，不影响其他工具读取核心内容。
Important
分享链接意味着其他人可以使用该 HTTP 应用对外提供的功能。没有登录保护的应用，任何拿到链接的人都可能读取或修改其中的数据。
- ✅ 适合：本地网站、开发预览、HTTP API、前后端联调。
- ❌ 不适合：数据库端口、Shell、远程桌面、路由器后台或包含私密信息的管理页面。
- 🔐 NATAPP Token、客户端、日志和 PID 应放在项目内已忽略的
.share-local-app/。 - 🧪 同机测试不能证明所有地区可访问；重要演示应使用手机流量或目标地区网络复测。
- 🖥️ 电脑、本地应用和分享客户端必须保持运行，任意一项停止都会使链接失效。
- 将开发中的网站发给同事、客户或测试人员预览；
- 在手机、平板或外部测试设备上访问电脑里的本地项目；
- 临时演示前后端联调结果；
- 为外部设备提供短期可访问的本地 HTTP API；
- 排查 NATAPP、Cloudflare、Vite 403、API 502 或 Tunnel 1033。