cyh-artifact-sharelisted
Install: claude install-skill cyh-skill/artifact-share
# cyh-artifact-share
把一份本地 HTML 页面或静态站点部署到**用户自己的 Cloudflare Pages**,返回一条可以直接分享的公开链接。
- **URL 形态**:`https://<slug>.<项目>.pages.dev`。一个项目(默认 `artifacts`)当作 artifact 托管站,每个页面一个 slug(即 Pages 分支别名);地址在相应项目和部署保留期间可复用,**重发同一个 slug 会原地覆盖更新**。
- **无需全局装 Wrangler**:脚本用 `npx` 运行固定版本 `wrangler@4.128.0`。
- **鉴权 = 本地 API Token**:不依赖交互式 `wrangler login`,适合脚本调用。
**资源路径**:下文的 `<skill目录>` 指本 `SKILL.md` 所在目录,与用户当前工作目录无关。Claude Code 中即 `${CLAUDE_SKILL_DIR}`(独立安装与插件安装���适用);Codex 中为已加载 Skill 的目录(如 `~/.agents/skills/cyh-artifact-share`)。不要在用户项目目录里直接运行 `scripts/...` 相对路径。
## 何时用
用户明确说「分享这个页面 / 把它部署到 Cloudflare / 发布出去 / 给我个能发出去的链接」,而内容是一个本地 HTML 页面或静态站点时使用。该明确发布请求是部署授权;生成、修改和本地预览任务的交付面保持为本地文件。
## 前置检查(每次先做)
1. 确认凭据已配置:存在 `~/.config/cyh-artifact-share/config.env` 或环境变量 `CLOUDFLARE_API_TOKEN`。
2. 没配就引导用户创建 Token 并在自己的终端跑一次 setup:
- Cloudflare 控制台 → **My Profile → API Tokens → Create Token**,权限至少 **Account → Cloudflare Pages → Edit**(多账号再填 Account ID)。
- 然后运行 `bash <skill目录>/scripts/setup.sh`,按静默提示粘贴 Token;多账号可加 `--account-id <ACCOUNT_ID>`,项目名可加 `--project <PROJECT>`。脚本先在线验证候选 Token,成功后才原子写入权限为 600 的 `~/.config/cyh-artifact-share/config.env`,验证失败不会覆盖旧配置。确需离线保存时可显式加 `--skip-verify`。
- Token 是敏感信息:由用户自己创建并在终端输入,只存放在受支持的配置文件或预注入的 `CLOUDFLARE_API_TOKEN` 中;**不得进入对话、命令参数、日志或提交**。
## 用法
```bash
# 单个 HTML 文件(最常见:先把 artifact 写成一个 .html,再部署)
bash <skill目录>/scripts/deploy.sh /path/to/page.html my-page
# 一个目录(多文件站点,需含 index.html)
bash <skill目录>/scripts/deploy.sh /path/to/site/ my-site
# 不传 slug