SuperAPI AI 工具集

renaming-services

部署与运维

查看项目

更新于 10-15 20:28

技能介绍

用途:在 Coolify 文档仓库中重命名某个服务的文档,并保证所有引用同步更新。适用于服务在 Coolify 仓库中改名、修正命名(如 camelCase 改 kebab-case)、合并重复文档或修正 slug 拼写错误。

关键要求:重命名时必须更新四处位置——docs/services/ 下的文档文件、docs/.vitepress/theme/components/Services/List.vue、docs/services/all.md、nginx/redirects.conf。遗漏任一处会导致断链或 404。

主要步骤:1) 用 git mv docs/services/old-name.md docs/services/new-name.md 重命名文件,命名只用小写、空格用连字符(kebab-case),并与 service-templates-latest.json 中的服务名一致,即使 JSON 用 camelCase 也转小写(如 denoKV → denokv.md)。2) 在 List.vue 中把对应条目的 slug 改为新名,并确认 icon 路径正确。3) 在 nginx/redirects.conf 添加 301 重定向,旧路径与可能存在的旧知识库路径都要保留重定向,即使页面已删除也应保留以防搜索引擎和书签 404。4) 更新 all.md 中对应分类下的条目链接。5) 用 grep -r "old-name" docs/ 搜索并更新其他内部链接。6) 如需要,用 git mv 重命名 logo 文件并更新 List.vue 中的 icon 路径。

验证清单:新文件存在、旧文件已移除或重定向、List.vue 的 slug 与文件名一致、icon 路径正确、all.md 条目已更新、redirects.conf 已加重定向、无断链、本地 http://localhost:5173/docs/services/new-name 可访问、旧 URL 能跳转到新 URL。

常见场景:camelCase 转 kebab-case(denoKV → denokv.md、homeAssistant → home-assistant.md);加版本号(mautic.md → mautic5.md);合并复合名(ente.md → ente-photos.md)。

排错:出现 404 时检查 redirects.conf 是否有重定向、List.vue 的 slug 是否匹配文件名、Markdown 文件是否存在;旧 URL 仍可用可能是 Nginx 未重载或重定向语法有误;搜索引擎仍显示旧 URL 属正常,301 会提示其更新,需等待重新抓取。

限制:资料未提供该技能的具体运行环境、安装方式、依赖版本或自动化程度,暂未提供。