工具箱管理指南

工具条目 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 格式，在工具详情页展示