mirror of https://github.com/jnMetaCode/superpowers-zh.git synced 2026-09-02 22:54:06 +08:00

Files

AI不止语 e77aaf6601 feat(sponsors): 新增旗舰赞助商 Infistar.cc 无限星河

旗舰位此前一直是「虚位以待」招商卡。Infistar.cc 上旗舰位，展示形式对齐
jnMetaCode/agency-agents-zh 的旗舰版式：整块大图 banner + 独立文案段 + 福利行，
排在两个常规位之前。

## 落位

| 位置 | 呈现 |
|---|---|
| 官网赞助商页（三语） | 顶部整块 banner（1269×337）+ 定位一句话 + 简介 + 福利 + 行动按钮；「虚位以待」卡自动消失，下面两家转入「更多赞助商」 |
| 福利汇总表 | 排第一行，优惠码列为 —（推广链接自带 aff，无需手填码） |
| 两版 README | 赞助商区块顶部 `<p align="center">` 整幅 banner + 文案段 + 🎁 福利行 + `<hr>`，与参考仓库同版式 |

## 文案口径

素材原文里福利写的是占位符 `[5美元等值测试额度 / 首充专属优惠]`，二选一未定 ——
这句会直接印在 README 和官网上，跟你确认后定为**「注册并完成首次调用领 5 美元
等值测试额度」**，不写没定下来的首充折扣。其余数字均照素材原文：一个 API Key 接入
Claude / ChatGPT / Gemini / Kimi / GLM / DeepSeek，价格低至官方渠道 1 折。

推广链接发版前实测 200（含 www 与裸域）。

## 顺带加一条构建期门禁

旗舰卡读 `img`，常规卡读 `logo` —— 两条渲染路径要的字段不一样。把 tier 从
flagship 改成 standard 而忘了配 logo，页面上就是个静默碎图，而赞助位是付费展示位，
图挂了就是事故。

`assertSponsors()` 在构建期校验三件事：字段按 tier 齐全、素材文件真的存在、
三语文案不缺。反向验证过 —— 把 img 改成不存在的文件、把 tier 改成 standard，
构建各自直接失败并指名道姓报出缺什么。

赞助素材规格说明（官网赞助 FAQ 三语 + site/README.md）同步更新为旗舰 1269×337 /
常规 800×368，并写明常规位还需方形小图标。

## 验证

- 官网 66 页构建通过，三语赞助页均渲染旗舰卡、「虚位以待」卡消失、福利表首行正确
- 全站链接扫描：站内死链 0、无效 `href="#"` 0；banner 落盘 dist 并本地预览 200
- README 引用的 3 个本地素材全部存在
- audit 170 pass / 0 fail；verify-release 115 pass / 0 fail（外链验活覆盖了新增的
  infistar.cc 推广链接）
- CI 等价检查 + tests/kimi · pi · opencode · brainstorm-server 全 PASS

2026-09-02 17:46:29 +08:00

4.2 KiB

Raw Permalink Blame History

superpowers-zh 官网

零依赖静态站生成器。一条命令产出中/英双语站点 + 每个 skill 的详情（操作文档）页，内容全部来自 ../skills/*/SKILL.md，与源文件同步、不会漂移。

构建 / 预览

node site/build.mjs          # 生成 site/dist/（66 个页面）
npx serve site/dist          # 本地预览（或 python3 -m http.server）

产物结构：

dist/
  index.html              # 中文首页
  sponsors.html           # 中文赞助商页（每种语言一份）
  en/index.html           # 英文首页
  skills/<name>.html      # 中文 skill 详情（操作文档）× 20
  en/skills/<name>.html   # 英文 skill 详情 × 20
  styles.css  app.js      # 深/浅主题 + 交互（原生 JS，零依赖）
  assets/                 # 图标 + 公众号/抖音二维码
  _headers                # Cloudflare Pages 缓存策略

特性

中英双语：服务端生成两套真实页面（非前端切换），SEO 友好、无闪烁。导航栏「中文 / EN」互切。
深 / 浅主题：CSS 变量 + localStorage 记忆，内联脚本在首屏前生效，无白屏闪烁。导航栏 ◐ 按钮切换。
Skill 详情页：内置零依赖 Markdown 渲染器（md.mjs），把每个 SKILL.md 渲染成完整操作文档，支持标题/代码块/表格/列表/引用。
安装命令生成器、Skill 搜索 / 分类筛选、一键复制 —— 全部原生 JS。

改内容改哪里

想改什么	改哪里
Skill 正文 / 文档内容	源头 `skills/<name>/SKILL.md`（改完重新 `node site/build.mjs`）
Skill 中/英标题、英文简介、分组	`site/build.mjs` 的 `SKILL_META`
首页所有文案（中/英）	`site/build.mjs` 的 `T.zh` / `T.en`
支持工具 / 安装命令	`site/build.mjs` 的 `TOOLS`（与 `bin/superpowers-zh.js` 的 `TARGETS` 对齐；每条的 `mode` = `auto` 自动识别 / `manual` 必须 `--tool` / `global` 只有 `--global` 才生效）。条目数由 `scripts/audit.sh` 卡死 = TARGETS 条目数 + 1（Copilot CLI 单独计数）
赞助商（logo / banner / 文案 / 链接 / 优惠码）	`site/build.mjs` 的 `SPONSORS`（`logo` 小图标 + `img` 大 banner 都放 `assets/sponsors/`，构建时自动拷进 `dist/assets/sponsors/`）——首页不放赞助内容，全部在 `sponsors.html`。改完同步改 README.md / README.zh-Hant.md 的赞助商区块
赞助商页文案 / 赞助权益 / 赞助 FAQ	`site/build.mjs` 的 `T.<lang>.sp`
谁上旗舰位	`SPONSORS` 里该条的 `tier`：`'flagship'` 用大 banner 单独成块（读 `img` + `w` / `h`，不读 `logo`），其余是紧凑卡（读 `logo`，简介截 4 行）；没有 flagship 时该区块渲染成「虚位以待」招商卡。改 tier 时字段要跟着换 —— 构建期 `assertSponsors()` 会校验字段齐全、素材文件存在、三语文案不缺，缺了直接构建失败
样式 / 主题	`site/template/styles.css`
交互逻辑	`site/template/app.js`
Markdown 渲染规则	`site/md.mjs`

部署到 Cloudflare Pages

发布目录 site/dist，三选一：

方式 A — 连接仓库自动构建（推荐，无需密钥）

Cloudflare Dashboard → Pages → 连接 GitHub 仓库 jnMetaCode/superpowers-zh：

Build command：node site/build.mjs
Build output directory：site/dist

之后每次 push 自动重建发布。绑自定义域名（当前线上：sp.aiolaola.com）。

方式 B — 命令行一键发布

npx wrangler login                  # 浏览器登录（交互，仅首次）
npm run site:deploy                 # = 构建 + wrangler pages deploy site/dist

在本会话中可用 ! 前缀直接登录：!npx wrangler login

方式 C — GitHub Actions 自动部署

仓库已含 .github/workflows/deploy-site.yml。在 Settings → Secrets and variables → Actions 配置：

CLOUDFLARE_API_TOKEN（Pages 编辑权限）
CLOUDFLARE_ACCOUNT_ID

之后 site/ 或 skills/ 变更 push 到 main 即自动部署。

国内访问优先用 Cloudflare Pages + 自定义域名；GitHub Pages 在国内访问较慢，不建议作为主站。

4.2 KiB Raw Permalink Blame History Unescape Escape