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 軟體平台內服務的實際部署或功能；這僅屬於內容管理程序。