從一條指令到完整互動系統：Slash Commands 設計拆解

const COMMANDS = [
  {
    name: "ping",
    description: "測試 Bot 是否正常運作",
  },
  {
    name: "info",
    description: "查詢指定成員資訊",
    options: [
      {
        name: "user",
        type: 6,           // USER 類型
        description: "要查詢的成員（不填則查詢自己）",
        required: false,
      },
    ],
  },
  {
    name: "remind",
    description: "設定提醒",
    options: [
      {
        name: "message",
        type: 3,           // STRING 類型
        description: "提醒內容",
        required: true,
      },
      {
        name: "minutes",
        type: 4,           // INTEGER 類型
        description: "幾分鐘後提醒",
        required: true,
        min_value: 1,
        max_value: 1440,
      },
    ],
  },
];
 
// 和上一篇一樣，在 ready 事件裡呼叫 guild.commands.set()
// 差別只是把物件陣列抽成變數，方便後續動態新增指令
client.once("ready", async () => {
  const guild = await client.guilds.fetch(process.env.GUILD_ID);
  await guild.commands.set(COMMANDS);
  console.log("📝 指令已更新！");
});

if (commandName === "remind") {
  const message = interaction.options.getString("message");
  const minutes = interaction.options.getInteger("minutes");
  await interaction.reply(`✅ 會在 ${minutes} 分鐘後提醒你：${message}`);
}

async function prepareCommands() {
  // 從 Sheets 讀取分類選項
  const rows = await getCategoryOptions(); // 回傳 [["A 類"], ["B 類"], ...]
 
  const choices = rows
    .map((row) => row[0]?.trim())
    .filter(Boolean)
    .map((name) => ({ name, value: name }));
 
  COMMANDS.push({
    name: "search",
    description: "依分類搜尋",
    options: [
      {
        name: "category",
        type: 3,
        description: "選擇分類",
        required: true,
        choices, // 動態組合的 choices
      },
    ],
  });
}

import { PermissionFlagsBits } from "discord.js";
 
COMMANDS.push({
  name: "announce",
  description: "發送公告（僅限管理者）",
  default_member_permissions: PermissionFlagsBits.Administrator.toString(),
  options: [
    {
      name: "message",
      type: 3,
      description: "公告內容",
      required: true,
    },
  ],
});

if (commandName === "announce") {
  const ALLOWED_ROLE_ID = "123456789012345678"; // 改成你的身分組 ID
 
  if (!interaction.member.roles.cache.has(ALLOWED_ROLE_ID)) {
    return interaction.reply({
      content: "你沒有權限使用此指令。",
      flags: 64, // ephemeral —— 只有本人看得到
    });
  }
 
  const message = interaction.options.getString("message");
  await interaction.reply(`📢 公告：${message}`);
}

client.on("interactionCreate", async (interaction) => {
 
  // 第一層：按鈕互動
  if (interaction.isButton()) {
    if (interaction.customId === "confirm_action") {
      return handleConfirm(interaction);
    }
    if (interaction.customId === "cancel_action") {
      return handleCancel(interaction);
    }
    return;
  }
 
  // 第二層：下拉選單互動
  if (interaction.isStringSelectMenu()) {
    if (interaction.customId === "select_category") {
      return handleCategorySelect(interaction);
    }
    return;
  }
 
  // 第三層：Slash Command 互動
  if (!interaction.isChatInputCommand()) return;
  const { commandName } = interaction;
 
  if (commandName === "ping")     return handlePing(interaction);
  if (commandName === "info")     return handleInfo(interaction);
  if (commandName === "remind")   return handleRemind(interaction);
  if (commandName === "daily")    return handleDaily(interaction);
  if (commandName === "announce") return handleAnnounce(interaction);
});

await interaction.reply({
  content: "你沒有權限使用此指令。",
  flags: 64,
});

await interaction.deferReply({ flags: 64 }); // 可加 flags: 64 讓轉圈只有本人看到
 
// 執行耗時操作…
const data = await sheets.spreadsheets.values.get({ ... });
 
// 再用 editReply 回傳最終結果
await interaction.editReply(`處理完成：${data}`);

import { Client, GatewayIntentBits, PermissionFlagsBits } from "discord.js";
import "dotenv/config";
import { getLastCheckIn, setCheckIn } from "./googleSheets.js"; // 上一篇建立的函式
 
const client = new Client({
  intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMembers],
});
 
// ── 1. 靜態指令定義 ──────────────────────────────────────────
const COMMANDS = [
  { name: "ping", description: "測試 Bot 是否正常運作" },
  {
    name: "info",
    description: "查詢指定成員資訊",
    options: [{ name: "user", type: 6, description: "要查詢的成員", required: false }],
  },
  {
    name: "remind",
    description: "設定提醒",
    options: [
      { name: "message", type: 3, description: "提醒內容", required: true },
      { name: "minutes", type: 4, description: "幾分鐘後提醒", required: true, min_value: 1, max_value: 1440 },
    ],
  },
];
 
// ── 2. 動態指令（從外部來源讀取，在 ready 前 push 進去）────────
// 這裡先用 mock 資料示範概念；實際場景換成從 Google Sheets 或資料庫讀取
// 例如上一篇 googleSheets.js 的 getLastCheckIn 改寫成讀取選項欄位即可
async function getCategoryOptions() {
  // mock：回傳與 Sheets 相同格式 [["A 類"], ["B 類"], ["C 類"]]
  return [["A 類"], ["B 類"], ["C 類"]];
}
 
async function prepareCommands() {
  const rows = await getCategoryOptions();
  const choices = rows.map((r) => r[0]?.trim()).filter(Boolean).map((n) => ({ name: n, value: n }));
  COMMANDS.push({
    name: "search",
    description: "依分類搜尋",
    options: [{ name: "category", type: 3, description: "選擇分類", required: true, choices }],
  });
}
 
// ── 3. 需要權限的指令 ─────────────────────────────────────────
COMMANDS.push({
  name: "announce",
  description: "發送公告（僅限管理者）",
  default_member_permissions: PermissionFlagsBits.Administrator.toString(),
  options: [{ name: "message", type: 3, description: "公告內容", required: true }],
});
 
// ── 4. ready：組完所有指令後統一註冊 ─────────────────────────
client.once("ready", async () => {
  await prepareCommands();                              // 先組動態指令
  const guild = await client.guilds.fetch(process.env.GUILD_ID);
  await guild.commands.set(COMMANDS);                  // 再一次性送給 Discord
  console.log("✅ Bot 上線，指令已更新");
});
 
// ── 5. interactionCreate：三層分流 ───────────────────────────
client.on("interactionCreate", async (interaction) => {
 
  // 第一層：按鈕
  if (interaction.isButton()) {
    if (interaction.customId === "confirm_action") return handleConfirm(interaction);
    if (interaction.customId === "cancel_action")  return handleCancel(interaction);
    return;
  }
 
  // 第二層：下拉選單
  if (interaction.isStringSelectMenu()) {
    if (interaction.customId === "select_category") return handleCategorySelect(interaction);
    return;
  }
 
  // 第三層：Slash Command
  if (!interaction.isChatInputCommand()) return;
  const { commandName } = interaction;
 
  if (commandName === "ping")     return handlePing(interaction);
  if (commandName === "info")     return handleInfo(interaction);
  if (commandName === "remind")   return handleRemind(interaction);
  if (commandName === "announce") return handleAnnounce(interaction);
});
 
// ── 6. handler 範例：需要耗時操作時，先 deferReply ───────────
async function handleRemind(interaction) {
  const message = interaction.options.getString("message");
  const minutes = interaction.options.getInteger("minutes");
 
  // 快速回覆，不需要 deferReply
  await interaction.reply(`✅ 會在 ${minutes} 分鐘後提醒你：${message}`);
}
 
async function handleAnnounce(interaction) {
  // 權限檢查（程式碼層第二道防線）
  const ALLOWED_ROLE_ID = "123456789012345678";
  if (!interaction.member.roles.cache.has(ALLOWED_ROLE_ID)) {
    return interaction.reply({ content: "你沒有權限使用此指令。", flags: 64 });
  }
 
  // 耗時操作先 deferReply，之後改用 editReply
  await interaction.deferReply();
  const message = interaction.options.getString("message");
  // 耗時操作（例如呼叫 API、寫入 Sheets）
  // 此處可呼叫上一篇定義的 setCheckIn，或換成你自己的寫入邏輯
  const today = new Date().toISOString().slice(0, 10);
  await setCheckIn(interaction.user.id, today);
  await interaction.editReply(`📢 公告：${message}`);
}
 
client.login(process.env.BOT_TOKEN);