lywsvip/superpowers-zh
1
0
Fork 0
mirror of https://github.com/jnMetaCode/superpowers-zh.git synced 2026-09-03 07:23:56 +08:00
Code Issues Packages Projects Releases Wiki Activity
206 Commits 34 Branches 46 Tags
932ffdcd016772d4f99ec471650eeca19748767b
Commit Graph

9 Commits

Author SHA1 Message Date
AI不止语
932ffdcd01 feat(site): 官网补上「本版谁该重装」和 22 份工具文档入口——此前这两件事站上一个字都没有 
上一轮我把官网审计做成了纯技术体检（robots / CSP / 图片字节 / og 标签），扫的是
「哪里不对」，没扫「访客需要什么、站上却没有」。按内容维度重查，查出两个比那些
重得多的空洞。

## ① v1.7.11 的核心信息，官网完全没有

这个版本的全部意义是一句话：Codex CLI / VS Code / Windsurf / Qwen Code / DeerFlow /
Claw Code 六款此前装了不生效，请重装。而官网上关于这件事的表述实测为零：

    重新安装 / 变更 / 更新日志 / Release / RELEASE-NOTES   首页出现 0 次
    重装                                                   1 次，但在全局安装 FAQ 里，与本事无关
    v1.7.11                                                1 次，就是统计块里那个数字

**上周装过的用户今天来站上，没有任何途径知道自己装的那份是坏的。** README 顶部有
整块更新亮点，官网一个字都没有。

hero 下方加一条可点的版本提示条（三语），点进 RELEASE-NOTES。版本号不手写：从
RELEASE-NOTES.zh.md 的最新条目解析，再与 package.json 交叉校验 —— 两边漂了直接
构建失败。需要重装的工具列表抽成 REINSTALL_TOOLS 常量，三语共用一份。

## ② docs/ 里 22 份工具安装指南，官网零暴露

全站链接到它们的次数：0。而官网「安装」区全文只有 378 字，内容就是「选工具 →
复制命令」。那 22 份文档里装的恰恰是这里缺的：

    docs/README.codex.md    ## ⚠️ v1.7.10 及更早的项目级安装装错了地方
    docs/README.kiro.md     ## ⚠️ v1.7.9 及更早版本请重新安装
    docs/README.windsurf.md > 📌 --global 装到了 Windsurf 不读的目录，等于装了不生效

Kiro 用户想知道「为什么要重装、旧布局怎么清」，站上没有出口。

工具墙的 pill 改成：有专属文档的 20 款直接链过去（带 ↗ 与 title 提示），没有文档的
3 款（Claude Code / Cursor / Copilot CLI）保持纯文本，不造不存在的链接。

## 新增三条构建期门禁（都反向验证过）

| 门禁 | 造错 | 实际拦下 |
|---|---|---|
| release notes 与 package.json 版本一致 | 把条目改成 v1.7.12 | `版本漂移：package.json 是 1.7.11，RELEASE-NOTES 最新条目是 v1.7.12` |
| 工具文档必须存在 | doc 改成 windsurfff | `工具 Windsurf 的文档不存在：docs/README.windsurfff.md` |
| release notes 结构可解析 | 抹掉版本标题 | 退回上一条目并报版本漂移，而不是静默渲染空版本 |

第二条尤其必要：官网链到 GitHub 上一个不存在的 docs 文件，就是又一条「编造出处」,
而本仓已经因为编造链接栽过一次（033adc3）。

## 验证

- 三语版本条渲染正确，链接指向 RELEASE-NOTES.zh.md
- 工具墙：可点 20 款 / 纯文本 3 款，与 docs/ 实际拥有的文档一一对应
- **20 条文档链接逐条 curl，全部 200**（不抽样）；RELEASE-NOTES 链接 200
- 官网 66 页构建，站内死链 0、无效 href="#" 0、缺 height 的 img 0
- audit 170 pass 0 fail；verify-release 115 pass 0 fail
- tests/kimi · pi · opencode · brainstorm-server 全 PASS
 2026-09-02 22:45:22 +08:00
AI不止语
293b300365 refactor(sponsors): 旗舰赞助商文案改回分段展示，压成一整段把结构揉没了 
赞助商给的原文本来是三条并列要点（⚡ 稳定承载 / 🧠 一个 Key 接入 / 🛠️ 赋能工作流），
上一版为了塞进卡片压成了一整段 —— 信息没丢，但骨架没了：卡片里是一堵 140 字的墙，
README 里也是。付费展位应当按赞助方的文案结构呈现，读者也更容易扫。

## 改法

- 官网旗舰卡：`desc` 整段 -> `points` 三条要点（图标 + 加粗小标题 + 说明），三语各一份；
  新增 `.flag-points` 样式，图标定宽一列、标题与说明纵向对齐，颜色走 --text /
  --text-dim，深浅主题都已定义
- 两版 README：改成「标题行 + 致谢行 + 三条 bullet + 🎁 福利行」，与赞助商原文一一对应，
  福利行补上原文的「superpowers-zh 用户专属福利」前缀
- 常规位不受影响，仍用整段 `desc`（卡片窄，四行截断的排版是为整段设计的）

## 门禁跟着分流

`assertSponsors()` 原来无差别要求每家都有 `desc`。现在按 tier 分：旗舰要
`img/w/h/points`，常规要 `logo/desc`；并新增一条 —— 三语要点**条数必须一致**，
每条的 `icon/t/d` 不能空。漏翻一条要点是最容易发生的漂移，页面上不会报错，
只会某个语言少一条。

反向验证：删掉繁體第三条 -> `points 三语条数不一致：zh/en/zht = 3/3/2`；
把简体第一条标题清空 -> `zh 要点缺 icon/t/d`。两条都按预期拦下。

## 验证

- 三语赞助页各渲染 3 条要点，图标 / 标题 / 说明逐条核对无误
- 官网 66 页构建通过，站内死链 0、无效 href="#" 0
- styles.css 改动后内容 hash 已变（?v=786ad3f27f），边缘缓存不会喂旧 CSS
- audit 170 pass / 0 fail；verify-release 115 pass / 0 fail
 2026-09-02 18:03:43 +08:00
AI不止语
c68725b4f6 feat(site): 导航栏补当前页高亮，赞助商入口不额外加粗 
导航此前没有任何当前页标识。参考站看着「赞助商」更重，是因为停在
该页时的 active 态（其导航项统一 font-medium，active 只把颜色从
muted 提到 foreground，字重不变），并非给赞助位单独加粗。

照此实现：停在 /sponsors 时该项颜色提亮 + aria-current="page"，
其余情况与其他导航项完全一致。不给商业位额外字重——导航里单独加粗
一项会被读成「当前页」，点进去发现不是反而困惑。

三语页面同步生效。
 2026-08-18 19:30:31 +08:00
AI不止语
ae316d87f3 feat(site): 新增赞助商独立页；顺带修掉三处一直坏着的链接 / 布局 
官网此前一条赞助商内容都没有。这一版把赞助内容全部收敛到独立页
/sponsors（中 / EN / 繁三语各一份），首页不放任何赞助位，入口进导航栏。

赞助商页结构：Hero → 旗舰位 → 当前赞助商 → 专属福利汇总 → FAQ →
赞助权益 → CTA。

- 分档由数据驱动：SPONSORS 里 tier: 'flagship' 的用大 banner 单独成块
  （读 img），其余是紧凑卡（读 logo，简介 CSS 截 4 行）；当前无 flagship，
  该区块渲染成「虚位以待」招商卡
- 紧凑卡的简介可展开：JS 比对 scrollHeight/clientHeight，只有真被截断
  时才显示「展开全部」，避免出现点了没反应的死按钮
- 福利汇总表里的优惠码点一下即复制，复用站内已有的 copy 委托，未新增
  第三方依赖
- Hero 原文案写「不做付费墙也不接广告」，但赞助位本身就是付费展示位，
  自相矛盾。改为如实说明；外链一律 rel="sponsored nofollow noopener"

顺带修掉三处做入口时发现的老问题（都是线上正在坏的）：

- 每个 skill 详情页的「← 返回全部 Skill」是 404：链接写的 index.html，
  从 /skills/xxx 解析成 /skills/index.html —— 该文件不存在。实测线上
  同样 404。60 个详情页全中，已改 ../index.html
- EN / 繁體页面的导航与品牌链接全部跳回中文首页：base 原本按「相对站点
  根」算，/en/index.html 的导航是 ../index.html。已改为相对当前语言根
- 导航栏在 900px 以下挤成两三行（「支持工具」被竖排拆开）：原来跟着
  720px 断点走，721–900px 这段一直是坏的。现改为导航项永不折行 + 独立
  900px 断点 + 窄屏横向滚动

赞助商图标取自 ao.aiolaola.com（同一维护者的站、同一批赞助商）。
 2026-08-18 18:56:03 +08:00
AI不止语
970a4373b9 feat(site): 扫码关注区新增 X/Twitter 二维码 (#104) 
- 官网页脚「扫码关注」由微信 + 抖音两张码扩为三张，新增 X/Twitter 二维码（扫码/点击直达 x.com/jnMetaCode）
- 三语（简/繁/EN）同步 qrX 文案；二维码卡与 figcaption 可点击
- 新增静态资源 qr-x.png（build 时拷入 dist/assets）
- qr-card 链接样式：继承色、hover 下划线，避免默认蓝色
 2026-07-14 15:45:53 +08:00
AI不止语
9a50f0ae9d chore: 下架赞助商展示，仅保留赞助联系方式 
移除 README 与官网的赞助商板块（含 5Cookie Code 展示卡、logo、
中英文案、.sponsor 样式、资源复制与图片文件）。按需求仅在 README
保留一行赞助联系方式（[email protected]），官网 footer 联系邮箱不变。

站点重建 42 页正常、dist 零赞助残留、无悬空引用与破图。
 2026-07-13 20:36:59 +08:00
AI不止语
cc1148887e feat(site): 页脚 + README 增加扫码关注（公众号 + 抖音二维码） 
- 官网页脚新增"扫码关注"区块：公众号 AI不止语 + 抖音 @AI不止语（AIBZY）
  两张二维码并排展示（中英 i18n + 响应式）
- README 交流区在公众号文案处嵌入公众号二维码
- 二维码自托管于 assets/，CSP img-src 'self' 已允许，无需放行外域

资源：site/template/assets/qr-{wechat,douyin}.jpg（站点）、assets/qr-wechat.jpg
（README）；build.mjs 增加拷贝逻辑 + 页脚 figure 区块 + i18n 文案；
styles.css 增加 .foot-qr/.qr-card 样式。

验证：重建 42 页；两张 QR 拷入 dist；页脚区块生成；CSP 不受影响。
 2026-06-20 06:04:15 +08:00
AI不止语
ceb92f3536 fix(site): 详情页排版居中 + star 数更新 233k + 页脚加 X/Twitter 
- styles.css: .doc 容器补 margin:0 auto + 左右 24px 内边距，修复 skill
  详情页正文紧贴左边缘、右侧大片空白的排版问题
- build.mjs / README: 上游 star 数 159k+ → 233k+（实际 233,268）
- build.mjs: 页脚生态区新增 X / Twitter（https://x.com/jnMetaCode）

验证：重建 42 页；.doc 居中边距生效；无 159k 残留；X/Twitter 入页脚。
 2026-06-20 05:47:50 +08:00
AI不止语
c8a4ebd930 feat(site): 新增项目官网（静态站点生成 + Cloudflare Pages 自动部署） 
为 superpowers-zh 增加官方站点：用 site/build.mjs 从 skills/ 与模板生成
中英双语静态站（42 页：中/英首页 + 20 skill × 2 语言详情），部署到
Cloudflare Pages。

- site/build.mjs + site/md.mjs + site/template/：站点生成器源码
- site/README.md：站点说明
- .gitignore：忽略 site/dist/（构建产物不入库，CI 重建）
- .github/workflows/deploy-site.yml：push 到 main 且 site/ 或 skills/
  变更时，构建并部署到 Cloudflare Pages 项目 superpowers-zh-site
  （需仓库 Secrets：CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID）
- package.json：加 site / site:deploy 脚本

验证：node site/build.mjs 构建成功，生成 42 页到 site/dist；
site/dist 已确认被 gitignore 排除、未入库；build.mjs 无硬编码密钥。
 2026-06-20 04:06:02 +08:00