disabling-services

此技能为 Coolify 生态系统中的服务文档过期或隐藏提供了系统化的处理方式。它专为需要从主要导航和索引页面（如服务目录）中删除服务的文件维护人员所设计，同时避免断开外部链接或丧失搜索引擎最佳化 (SEO) 权重。通过将文件档保留但标记为已停用，您可以确保依赖直接书签或搜索结果的现有用户，仍能存取关键的历史资讯、迁移路径或过渡说明。

• 透过内部脚本处理，自动从中央服务目录和列表页面中筛选掉服务。

• 支持透过 YAML frontmatter disabled: true 进行明确的状态宣告。

• 针对警告提示框的模式侦测，允许开发人员在 markdown 正文中侦测到如 'SERVICE NOT AVAILABLE' 等特定短语时，自动隐藏该服务。

• 与 VitePress 和自订产生脚本 (scripts/services-data.mjs) 整合，以维持全站一致的状态。

• 保留重新导向 (redirect) 设置，确保即使在从公开列表中移除服务后，流量仍能正确路由。

• 此流程需要执行 bun run generate:services 以更新底层的 services.json 和 all.md 文件；若未重新产生这些文件，将导致文档状态不一致。

• 请务必将 frontmatter disabled: true 作为权威信号，以确保建置脚本能正确处理变更，而不受内文影响。

• 在记录已停用的服务时，请务必在文件顶端加入警告提示框，告知用户服务的目前状态，例如 'DEPRECATED'（已弃用）、'REMOVED'（已移除）或 'TEMPORARILY DISABLED'（暂时停用）。

• 在文档内文中提供清晰的迁移路径或替代服务，以协助受服务移除影响的用户。

• 确保所有重新产生的文件（特别是 services.json 和 all.md）都包含在 Git 提交中，以反映生产环境中的变更。

• 此工作流程仅适用于文档维护，不会影响 Coolify 软件平台内服务的实际部署或功能；这仅属于内容管理程序。