📦 deps(thirdparty): update snapshots

2026-06-25 16:06:49 +00:00
parent 1da991f912
commit a225b70c17
376 changed files with 27320 additions and 4607 deletions
@@ -15,8 +15,8 @@

 ### 1. 计数

- `README.md`、`package.json` 和生成的工件与当前集合大小（`1,204+` 技能）保持一致。
- `npm run sync:all` 和 `npm run catalog` 是保持计数和生成文件同步的规范命令。
+- `README.md`、`package.json` 和生成的工件应与当前集合大小（`1,684+` 技能）保持一致。
+- `npm run sync:repo-state`、`npm run catalog` 和发布流程中的 `npm run sync:release-state` 是保持计数和生成文件同步的规范命令。

 ### 2. 技能验证

@@ -5,14 +5,16 @@
 ### 1. **智能自动分类脚本**
 创建了 [`tools/scripts/auto_categorize_skills.py`](../../tools/scripts/auto_categorize_skills.py)，它:
 - 分析技能名称和描述
- 针对 13 个类别的关键词库进行匹配
+- 针对作为当前生成类别元数据种子的关键词库进行匹配
 - 自动分配有意义的类别
 - 移除"未分类"批量分配

-**结果:**
+**历史初次运行结果:**
 - ✅ 776 个技能自动分类
 - ✅ 46 个已有类别的技能被保留
- ✅ 124 个仍为未分类（边缘情况）
+- ✅ 当时仍有 124 个未分类（边缘情况）
+
+当前计数请以 `skills_index.json` 为准；活跃仓库已经超过该历史快照。

 ### 2. **类别分布**

@@ -26,20 +28,8 @@ security: 4

 **之后:**
 ```
-Backend: 164          ████████████████
-Web Dev: 107          ███████████
-Automation: 103       ███████████
-DevOps: 83            ████████
-AI/ML: 79             ████████
-Content: 47           █████
-Database: 44          █████
-Testing: 38           ████
-Security: 36          ████
-Cloud: 33             ███
-Mobile: 21            ██
-Game Dev: 15          ██
-Data Science: 14      ██
-Uncategorized: 126    █
+生成类别元数据现在来自当前的 skills_index.json。
+不要在面向用户的文档中保留这些历史计数。
 ```

 ### 3. **更新的索引生成**
@@ -54,16 +44,16 @@ Uncategorized: 126    █
 **主页更改:**
 - ✅ 类别按技能数量排序（最多的在前）
 - ✅ "未分类"移至底部
- ✅ 每个类别显示计数："Backend (164)"、"Web Dev (107)"
+- ✅ 每个类别显示从生成索引计算出的计数
 - ✅ 更易于导航

 **更新的代码:**
 - [`apps/web-app/src/pages/Home.tsx`](../../apps/web-app/src/pages/Home.tsx) - 智能类别排序
 - 使用 categoryStats 按数量排序类别
 - 未分类始终在最后
- 在下拉菜单中显示计数
+- 在下拉菜单中显示生成的计数

-### 5. **分类关键词**（13 个类别）
+### 5. **分类关键词**（种子桶）

 | 类别 | 主要关键词 |
 |----------|--------------|
@@ -97,16 +87,16 @@ Uncategorized: 126    █

 ### 更好的用户体验
 1. **更智能的过滤**: 类别按相关性排序
-2. **视觉提示**: 显示计数 "(164 个技能)""
+2. **视觉提示**: 显示当前生成计数
 3. **未分类最后**: 将不良选项隐藏
 4. **有意义的分组**: 按实际功能查找技能

 ### 示例工作流
 用户想要查找数据库技能:
 1. 打开 Web 应用程序
-2. 看到过滤器下拉菜单："Backend (164) | Database (44) | Web Dev (107)..."
-3. 点击 "Database (44)"
-4. 获得 44 个相关的 SQL/MongoDB/Postgres 技能
+2. 看到带有生成计数的过滤器下拉菜单
+3. 点击当前与数据库相关的类别
+4. 获得当前匹配的 SQL/MongoDB/Postgres 技能
 5. 完成！🎉

 ## 🚀 使用方法
@@ -1,6 +1,6 @@
 # CI 漂移修复指南

-**问题**：失败的作业是由于在更新脚本运行后在 `README.md`、`skills_index.json` 或目录文件中检测到未提交的更改引起的。
+**问题**：失败的作业通常是因为 `main` 上的规范同步步骤运行后仍留下受跟踪的漂移。

 **错误**：

@@ -9,30 +9,54 @@
 ```

 **原因**：
-像 `tools/scripts/generate_index.py`、`tools/scripts/update_readme.py` 和 `tools/scripts/build-catalog.js` 这样的脚本会修改 `README.md`、`skills_index.json`、`data/catalog.json`、`data/bundles.json`、`data/aliases.json` 和 `CATALOG.md`。工作流期望这些文件在脚本运行后没有更改。任何差异意味着提交的仓库与生成脚本产生的内容不同步。
+规范同步契约不只覆盖根注册表文件。`generate_index.py`、`update_readme.py`、`build-catalog.js`、`setup_web.js` 和插件同步助手可能合法更新：

-**如何修复（每次都要这样做）：**
+- `README.md`
+- `CATALOG.md`
+- `skills_index.json`
+- `data/*.json`
+- `apps/web-app/public/` 下受跟踪的 Web 资产
+- 生成的插件元数据和插件安全副本

-1. 在本地运行**完整的验证链**：
+工作流期望这些同步步骤结束后仓库是干净的。任何剩余的受跟踪或非托管更改都表示 `main` 与生成管道实际产物不同步。
+
+## Pull Request vs Main
+
+- **Pull Request**：PR 现在应保持 **source-only**。贡献者不应提交派生注册表工件（`CATALOG.md`、`skills_index.json`、`data/*.json`）。CI 会阻止这些直接编辑，并将生成漂移作为信息性预览报告。
+- **`main` push**：漂移仍是严格错误。`main` 必须在自动同步步骤后保持干净。
+
+## 如何在 `main` 上修复
+
+1. 在本地运行规范维护者同步：

   ```bash
-   npm run chain
-   npm run catalog
+   npm run sync:repo-state
   ```

-2. 检查更改：
+2. 检查是否仍有脏工作树：

   ```bash
   git status
   git diff
   ```

-3. 提交并推送任何更新：
+3. 如果同步只产生规范/生成文件更改，请暂存并提交它们。优先使用生成文件契约，而不是手写文件列表：
+
   ```bash
-   git add README.md skills_index.json data/catalog.json data/bundles.json data/aliases.json CATALOG.md
-   git commit -m "chore: sync generated registry files"
+   node tools/scripts/generated_files.js --include-mixed
+   git add $(node tools/scripts/generated_files.js --include-mixed)
+   git commit -m "chore: sync canonical artifacts"
   git push
   ```

+4. 如果 `sync:repo-state` 留下无关或非托管漂移，请停止并检查。`main` 上的 bot 只允许推送规范/生成子集；其他任何东西都应让工作流失败，而不是被静默自动提交。
+
+## PR 维护者指南
+
+- 验证源代码变更，而不是要求贡献者提交生成工件。
+- 如果贡献者 PR 直接修改 `CATALOG.md`、`skills_index.json` 或 `data/*.json`，请要求他们从 PR 中删除这些文件，或在刷新分支时移除。
+- 如果合并冲突涉及生成注册表文件，请保留 `main` 版本，并让 `main` 合并后自动同步最终生成物。
+- 如果 `main` 上的 CI 后续创建带 `[ci skip]` 的 bot 提交，这只对规范/生成子集是预期行为，不代表可以推送任意额外漂移。
+
 **总结**：
-始终提交并推送 registry、README 同步和 catalog 脚本产生的所有更改。这通过确保仓库和生成的工件与规范的 `tools/scripts/*` 管道保持同步，保持 CI 通过。
+只在 `main` 上把生成器漂移视为硬失败。对 PR 来说，契约更简单：审查 source-only 变更，生成输出仅作预览，最终规范工件由 `main` 生成。
@@ -1,432 +1,99 @@
 # 发布流程

-这是维护者的仓库发布操作手册。历史发布记录在[`CHANGELOG.md`](../../CHANGELOG.md)中；本文档记录可重复的流程。
+这是维护者切发布版本时使用的操作手册。历史发布记录属于 [`CHANGELOG.md`](../../CHANGELOG.md)；本文档只记录可重复的当前流程。

 ## 前置条件

- 工作目录是干净的，或者您已经明确隔离了发布更改。
- `package.json`包含您打算发布的版本。
- 生成的注册表文件已同步。
- README统计、徽章和致谢是最新的。
+- 受 Git 跟踪的工作树是干净的。
+- 当前分支是 `main`。
+- `CHANGELOG.md` 已经包含准备发布的版本段落。
+- README 统计、徽章、致谢和支持链接是最新的。

 ## 发布检查清单

-### 1. 运行操作验证套件：
+1. 运行脚本化预检：

 ```bash
-npm run validate
-npm run validate:references
-npm run sync:all
-npm run test
-npm run app:build
+npm run release:preflight
 ```

-### 2. 可选的强化检查：
+该预检会运行确定性的 `sync:release-state` 流程，刷新 `apps/web-app/public` 中受跟踪的 Web 资产，执行本地测试套件，安装 Web 应用依赖，构建 Web 应用，并执行 `npm pack --dry-run --json`，因此发布标签会用与 CI 后续相同的 artifact 路径验证。
+
+当前 CI/发布契约还要求：
+
+- Python 依赖来自 `tools/requirements.txt`。
+- Web 应用覆盖率任务（`npm run app:test:coverage`）保持通过。
+- `npm run security:docs` 通过，且不依赖非阻塞审计警告。
+
+2. 运行必需的文档安全加固检查：
+
+```bash
+npm run security:docs
+```
+
+该检查用于在发布前验证整个仓库的高风险命令模式和类似 token 的内联示例。
+
+3. 可选强化检查：

 ```bash
 npm run validate:strict
 ```

-将其用作诊断信号。它有助于发现历史质量债务，但目前还不是整个仓库的发布阻止因素。
+它适合发现历史质量债务，但目前不是整个仓库的发布阻断条件。

-### 3. 更新版本号：
+4. 更新发布面向文档：
+
+- 在 [`CHANGELOG.md`](../../CHANGELOG.md) 中添加发布条目。
+- 确认 `README.md` 反映当前版本和生成计数。
+- 确认 Credits & Sources、贡献者和支持链接仍然正确。
+- 如果 PR 或 CI 工作流行为在本周期发生变化，确认维护者和贡献者文档提到了当前检查。
+- 如果维护者运行了 `npm run sync:risk-labels` 或类似清理流程，确认维护者文档仍描述当前 audit -> sync -> repo-state 循环。
+
+5. 在本地准备发布提交和标签：

 ```bash
-# 更新package.json中的版本
-npm version patch|minor|major
-
-# 或手动更新为特定版本
-npm version 1.2.3
+npm run release:prepare -- X.Y.Z
 ```

-### 4. 生成变更日志：
+该命令会：
+
+- 检查 `CHANGELOG.md` 中是否存在 `X.Y.Z`。
+- 对齐 `package.json` / `package-lock.json`。
+- 运行完整发布套件。
+- 刷新 `README.md` 中的发布元数据。
+- 暂存规范发布文件。
+- 创建 `chore: release vX.Y.Z` 提交。
+- 创建本地标签 `vX.Y.Z`。
+
+6. 发布 GitHub Release：

 ```bash
-npm run changelog
+npm run release:publish -- X.Y.Z
 ```

-审查生成的变更日志，确保：
- 所有重要更改都已记录
- 版本号正确
- 破坏性变更已标记
- 新功能已突出显示
+该命令会推送 `main`，推送 `vX.Y.Z`，并根据匹配的 `CHANGELOG.md` 段落创建 GitHub Release 对象。

-### 5. 更新文档：
-
-```bash
-npm run readme
-npm run catalog
-```
-
-验证：
- README中的技能数量正确
- 新技能已分类
- 示例代码可运行
- 链接有效
-
-### 6. 运行完整测试套件：
-
-```bash
-npm run test:ci
-```
-
-确保：
- 所有测试通过
- 代码覆盖率达标
- 安全检查通过
- 性能基准稳定
-
-### 7. 创建发布分支：
-
-```bash
-git checkout -b release/vX.X.X
-```
-
-### 8. 提交所有更改：
-
-```bash
-git add .
-git commit -m "chore: prepare release v$VERSION"
-```
-
-### 9. 创建标签：
-
-```bash
-git tag -a v$VERSION -m "Release v$VERSION"
-```
-
-### 10. 推送更改和标签：
-
-```bash
-git push origin main
-git push origin release/vX.X.X
-git push origin v$VERSION
-```
-
-## 发布后操作
-
-### 1. 合并发布分支：
-
-```bash
-git checkout main
-git merge release/vX.X.X
-git push origin main
-```
-
-### 2. 发布到NPM：
+7. 如有需要发布到 npm：

 ```bash
 npm publish
 ```

-### 3. 创建GitHub Release：
+通常 npm 发布仍由 GitHub Release 发布后的现有工作流完成。该工作流会重新运行 `sync:release-state`，从 `tools/requirements.txt` 安装 Python 依赖，刷新受跟踪的 Web 资产，通过 `git diff --exit-code` 检测规范漂移，执行测试和文档安全检查，运行 Web 应用覆盖率门禁，执行 `npm audit --audit-level=high`，构建 Web 应用，并在 `npm publish` 前 dry-run npm 包。

- 访问 [GitHub Releases页面](https://github.com/sickn33/antigravity-awesome-skills/releases)
- 点击"Create a new release"
- 选择刚推送的标签
- 粘贴变更日志内容
- 添加发布说明
- 点击"Publish release"
+## 规范同步 Bot

-### 4. 更新网站和文档：
+`main` 仍使用仓库的自动同步模型来维护规范生成物，但契约必须保持窄而可预测：

-```bash
-npm run deploy:docs
-npm run deploy:web
-```
+- PR 保持 source-only。
+- 合并后，`main` 工作流可以用 `[ci skip]` 将规范生成文件直接提交到 `main`。
+- 这些 bot 提交会跳过 CI，因此只能暂存规范/生成文件；任何非托管漂移都必须让工作流失败，而不是被静默推送。
+- bot 只允许暂存 `tools/scripts/generated_files.js --include-mixed` 解析出的文件。
+- 如果 repo-state sync 后留下任何非托管的受跟踪或未跟踪漂移，工作流必须失败。
+- 定时 hygiene workflow 使用相同契约和 concurrency group，确保同一时间只有一个规范同步写入者运行。

-### 5. 社区公告：
+## 回滚说明

-#### Discord公告：
-```text
-🎉 Antigravity Awesome Skills v$VERSION 已发布！
-
-主要更新：
-• [关键更新1]
-• [关键更新2]
-• [关键更新3]
-
-获取更新：npx antigravity-awesome-skills
-
-详情：[GitHub Release链接]
-```
-
-#### Twitter公告：
-```text
-🚀 Antigravity Awesome Skills v$VERSION 发布了！
-
-[最激动人心的新功能]
-
-立即更新：npx antigravity-awesome-skills
-
-#AI #Skills #ClaudeCode #Gemini
-```
-
-#### 博客文章：
- 撰写详细的发布说明
- 包含新功能示例
- 添加迁移指南
- 分享最佳实践
-
-## 紧急发布流程
-
-### 何时需要紧急发布：
-
- 关键安全漏洞修复
- 生产环境破坏性bug
- 重大安装问题
-
-### 紧急发布步骤：
-
-1. **立即修复**
-   ```bash
-   git checkout -b hotfix/issue-description
-   # 实施修复
-   npm test
-   ```
-
-2. **快速验证**
-   ```bash
-   npm run validate:quick
-   ```
-
-3. **发布修复**
-   ```bash
-   npm version patch
-   git tag v$VERSION
-   git push origin v$VERSION
-   npm publish
-   ```
-
-4. **通知社区**
-   - Discord紧急通知
-   - GitHub Issue说明
-   - Twitter安全公告
-
-## 版本控制策略
-
-### 语义化版本控制
-
-遵循[SemVer](https://semver.org/)规范：
-
- **主版本号（MAJOR）**：不兼容的API更改
- **次版本号（MINOR）**：向后兼容的功能添加
- **修订号（PATCH）**：向后兼容的问题修复
-
-### 版本号格式
-
-```
-MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]
-```
-
-示例：
- `1.0.0` - 稳定发布
- `1.0.0-alpha.1` - Alpha版本
- `1.0.0-beta.2` - Beta版本
- `1.0.0-rc.3` - 候选版本
-
-### 发布周期
-
- **主版本**：每3-6个月
- **次版本**：每月
- **修订版本**：根据需要（bug修复）
-
-## 质量门禁
-
-### 发布前检查
-
-**必须通过：**
- [ ] 所有自动化测试通过
- [ ] 代码覆盖率 > 80%
- [ ] 安全扫描无高危漏洞
- [ ] 性能测试无回归
- [ ] 文档生成成功
- [ ] 技能验证通过
-
-**可选通过：**
- [ ] 严格验证通过
- [ ] 手动QA验证
- [ ] 社区反馈收集
-
-### 发布后监控
-
-**监控指标：**
- NPM下载量
- GitHub Stars
- 社区反馈
- 错误报告
- 性能指标
-
-**告警阈值：**
- 下载量下降 > 20%
- 错误率上升 > 5%
- 社区投诉 > 10条
-
-## 回滚程序
-
-### 何时回滚
-
- 安装失败率 > 10%
- 关键功能破坏
- 安全问题发现
- 用户大量投诉
-
-### 回滚步骤
-
-1. **立即停止推广**
-   - 撤下发布说明
-   - 更新Discord状态
-   - 暂停Twitter宣传
-
-2. **创建回滚分支**
-   ```bash
-   git checkout -b rollback/v$VERSION
-   git revert $MERGE_COMMIT
-   ```
-
-3. **发布回滚版本**
-   ```bash
-   npm version patch
-   git tag v$ROLLBACK_VERSION
-   npm publish
-   ```
-
-4. **社区通知**
-   ```text
-   🚨 v$VERSION 紧急回滚
-   
-   问题：[问题描述]
-   解决：[回滚版本 v$ROLLBACK_VERSION]
-   
-   建议：暂缓更新或使用 --version $ROLLBACK_VERSION
-   ```
-
-## 工具和自动化
-
-### 发布脚本
-
-```bash
-#!/bin/bash
-# release.sh - 自动化发布脚本
-
-set -e
-
-VERSION=$(node -p "require('./package.json').version")
-echo "🚀 发布版本 v$VERSION"
-
-# 运行检查
-npm run validate
-npm run test
-
-# 更新文档
-npm run readme
-npm run catalog
-
-# 创建发布
-git add .
-git commit -m "chore: release v$VERSION"
-git tag -a v$VERSION -m "Release v$VERSION"
-
-# 推送
-git push origin main
-git push origin v$VERSION
-
-# 发布到NPM
-npm publish
-
-echo "✅ 发布成功 v$VERSION"
-```
-
-### 持续集成配置
-
-**GitHub Actions工作流：**
-```yaml
-name: Release
-on:
-  push:
-    tags:
-      - 'v*'
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
-      - run: npm ci
-      - run: npm test
-      - run: npm publish
-```
-
-## 贡献者认可
-
-### 发布致谢
-
-在每个发布中感谢贡献者：
-
-```markdown
-## 贡献者
-
-特别感谢本版本的贡献者：
- @username - [主要贡献]
- @username2 - [主要贡献]
- @username3 - [主要贡献]
-
-以及所有报告问题和反馈的用户！
-```
-
-### 奖励机制
-
- 🏆 **月度贡献者** - Discord特别角色
- 🎁 **发布贡献者** - 项目商品
- 📝 **技术写作奖** - 优秀文档奖
- 🌟 **新星奖** - 新贡献者鼓励
-
-## 文档和培训
-
-### 维护者培训
-
-**新维护者入职：**
-1. 阅读完整的维护者文档
-2. 观摩一次完整的发布流程
-3. 在监督下进行一次发布
-4. 独立执行发布（有回滚支持）
-
-### 技能文档
-
-**必备文档：**
- 发布流程检查清单
- 紧急响应程序
- 工具使用指南
- 常见问题解答
-
-**可选文档：**
- 高级故障排除
- 性能优化指南
- 社区管理最佳实践
-
---
-
-## 🎉 成功发布指标
-
-### 发布成功标志
-
- ✅ 所有自动化检查通过
- ✅ 社区反馈积极
- ✅ 下载量稳步增长
- ✅ 错误率在可接受范围内
- ✅ 文档完整准确
-
-### 持续改进
-
-每次发布后进行：
- 📊 性能分析
- 📋 用户反馈收集
- 🔄 流程优化
- 📚 文档更新
- 🎯 目标调整
-
---
-
-这个发布流程确保Antigravity Awesome Skills的质量、稳定性和社区满意度。通过遵循这些指导方针，我们能够为用户提供可靠、高质量的技能生态。
-
-如果您有任何问题或建议，请随时联系维护团队。🚀
+- 如果发布标签错误，在重新发布前同时删除本地和远程标签。
+- 如果打标签后生成文件发生漂移，切一个后续 patch release，而不是修改已发布标签。
+- 如果 npm publish 在打标签后失败，修复问题、递增版本并发布新版本，不要复用同一个版本号。
@@ -6,7 +6,7 @@

 首选定位:

-> 适用于 Claude Code、Cursor、Codex CLI、Gemini CLI、Antigravity 和其他 AI 编码助手的 1,494+ 代理技能的可安装 GitHub 库。
+> 适用于 Claude Code、Cursor、Codex CLI、Gemini CLI、Antigravity 和其他 AI 编码助手的 1,684+ 代理技能的可安装 GitHub 库。

 关键框架:

@@ -20,7 +20,7 @@

 首选描述:

-> 适用于 Claude Code、Cursor、Codex CLI、Gemini CLI、Antigravity 等的 1,494+ 代理技能的可安装 GitHub 库。包括安装程序 CLI、捆绑包、工作流以及官方/社区技能集合。
+> 适用于 Claude Code、Cursor、Codex CLI、Gemini CLI、Antigravity 等的 1,684+ 代理技能的可安装 GitHub 库。包括安装程序 CLI、捆绑包、工作流以及官方/社区技能集合。

 首选主页:

@@ -28,7 +28,7 @@

 首选社交预览:

- 使用清晰的预览图像，显示 `1,494+ 代理技能`
+- 使用清晰的预览图像，显示 `1,684+ 代理技能`
 - 提及 Claude Code、Cursor、Codex CLI 和 Gemini CLI
 - 避免在社交卡片中出现密集文本和微小徽标

@@ -69,7 +69,7 @@ copy skills_index.json apps\web-app\public\skills.json
 更新过程会刷新:
 - 技能索引 (`skills_index.json`)
 - Web 应用程序技能数据 (`apps\web-app\public\skills.json`)
- 技能目录中的所有 1,494+ 技能
+- 技能目录中的所有 1,684+ 技能

 ## 更新时机

@@ -9,26 +9,28 @@
 ✅ 当前仓库通过生成的目录索引
 - 大多数技能都在有意义的类别中
 - 较小的尾部仍需要手动审查或更好的关键词覆盖
- 11 个主要类别
- 类别按技能数量排序（最多的在前）
+- `skills_index.json` 是当前类别标签和计数的事实来源
+- 类别过滤器应在构建时从生成索引派生

 ## 类别分布

-| 类别 | 数量 | 示例 |
-|----------|-------|----------|
-| Backend | 164 | Node.js、Django、Express、FastAPI |
-| Web Development | 107 | React、Vue、Tailwind、CSS |
-| Automation | 103 | Workflow、Scripting、RPA |
-| DevOps | 83 | Docker、Kubernetes、CI/CD、Git |
-| AI/ML | 79 | TensorFlow、PyTorch、NLP、LLM |
-| Content | 47 | Documentation、SEO、Writing |
-| Database | 44 | SQL、MongoDB、PostgreSQL |
-| Testing | 38 | Jest、Cypress、Unit Testing |
-| Security | 36 | Encryption、Authentication |
-| Cloud | 33 | AWS、Azure、GCP |
-| Mobile | 21 | React Native、Flutter、iOS |
-| Game Dev | 15 | Unity、WebGL、3D |
-| Data Science | 14 | Pandas、NumPy、Analytics |
+不要把固定计数复制到面向用户的文档中。要查看当前分布，请从索引生成：
+
+```bash
+node - <<'NODE'
+const fs = require('fs');
+const skills = JSON.parse(fs.readFileSync('skills_index.json', 'utf8'));
+const counts = new Map();
+for (const skill of skills) {
+  const category = skill.category || 'uncategorized';
+  counts.set(category, (counts.get(category) || 0) + 1);
+}
+console.log(`skills=${skills.length} categories=${counts.size}`);
+for (const [category, count] of [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 12)) {
+  console.log(`${category}: ${count}`);
+}
+NODE
+```

 ## 工作原理

@@ -91,20 +93,17 @@ Sample changes:

 **之后:**
 - 类别按技能数量排序（最多的在前，"未分类"最后）
- 显示计数："Backend (164)" "Web Development (107)"
+- 显示从生成索引计算出的计数，而不是文档中的硬编码数字
 - 更易于浏览

 ### 示例下拉菜单

 **排序顺序:**
 1. All Categories
-2. Backend (164)
-3. Web Development (107)
-4. Automation (103)
-5. DevOps (83)
-6. AI/ML (79)
-7. ... 更多类别 ...
-8. Uncategorized (126) ← 在最后
+2. 技能数最高的生成类别
+3. 下一个生成类别
+4. ... 更多生成类别 ...
+5. Uncategorized（如果存在）放在最后

 ## 对于技能创建者