工具箱管理指南

工具條目 vs 工具功能頁

工具系統分為兩個獨立層：

層級	檔案位置	作用
元數據層	src/content/tools/[分類]/[slug].md	控制工具在列表中的展示：標題、描述、分類、標籤等
功能層	src/pages/tools/[slug].astro	工具的實際互動頁面（HTML + JS），需手動創建

管理後台只管理元數據 .md 檔案，功能頁面需要開發人員手動在伺服器上創建並觸發重建。

通過後台管理工具條目

進入 後台 → 工具管理（側邊欄）。

新建工具

1. 點擊「新建工具」按鈕
2. 填寫必填欄位（標題、描述、分類、Slug）及可選資訊
3. 點擊「保存」
4. 前往觸發重建頁面重建網站

如果工具有互動功能（非外鏈），還需手動在伺服器創建對應的 .astro 頁面，參見下方「添加互動功能頁」。

編輯工具

在工具列表中點擊「編輯」，修改所需欄位後保存，然後觸發重建。

刪除工具

在工具列表中點擊「刪除」，確認後工具的 .md 檔案將被移除。觸發重建後該工具從列表消失。

注意：刪除元數據不會自動刪除對應的功能頁（.astro）。如果工具有獨立功能頁，需手動在伺服器上刪除 src/pages/tools/[slug].astro。

添加互動功能頁

當工具 isExternal 為 false 且 downloadUrl 設為 /tools/xxx/ 時，需要對應的 .astro 檔案存在。

步驟

1. 在伺服器上創建頁面檔案

Slug 為 account-management/ip-checker 時，創建：

src/pages/tools/ip-checker.astro

檔名只需 slug 的最後一段，不需要帶分類目錄。

2. 頁面基本結構

---
import BaseLayout from '@/layouts/BaseLayout.astro';
import Breadcrumb from '@/components/Breadcrumb.astro';

const breadcrumbs = [
  { label: '首頁', href: '/' },
  { label: '工具箱', href: '/tools/' },
  { label: 'IP 檢測器' },
];
---

<BaseLayout title="IP 檢測器 - 蜂巢工具箱" description="檢測當前 IP 歸屬地">
  <section class="py-16 bg-dark-900 min-h-screen">
    <div class="max-w-3xl mx-auto px-4 sm:px-6 lg:px-8">
      <div class="mb-8"><Breadcrumb crumbs={breadcrumbs} /></div>
      <h1 class="text-3xl font-bold text-white mb-8">IP 檢測器</h1>

      <!-- 工具 UI -->
      <div id="result" class="card p-6 text-gray-300"></div>
      <button id="btn" class="mt-4 btn-primary">檢測</button>
    </div>
  </section>
</BaseLayout>

<script>
  document.getElementById('btn')?.addEventListener('click', async () => {
    const res  = await fetch('https://api.ipify.org?format=json');
    const data = await res.json();
    document.getElementById('result').textContent = 'IP: ' + data.ip;
  });
</script>

3. 觸發重建

在管理後台觸發一次重建即可生效。

工具欄位說明

欄位	必填	說明
Slug	✓	分類/名稱 格式，小寫字母、數字、連字符
標題	✓	工具顯示名稱
描述	✓	工具簡短描述，用於列表卡片和 SEO
分類	✓	在工具列表中按此分類分組展示
平台		適用平台，逗號分隔，如 android, web
標籤		工具標籤，逗號分隔，如 指紋, 帳號隔離
下載/使用連結		工具頁面路徑（/tools/xxx/）或外鏈地址
外鏈工具		勾選後連結跳轉到第三方頁面
精選		勾選後顯示在工具箱首頁「精選工具」區域
草稿		勾選後不在前台列表展示，但 URL 仍可訪問
排序		數字越小越靠前，預設 0
封面圖		工具卡片和詳情頁頂部圖片 URL
正文		Markdown 格式，在工具詳情頁展示