Auction

Auction

Bases: BaseModel

競標資料模型

id

id: Optional[int] = Field(None, description='競標ID')

guild_id

guild_id: int = Field(..., description='伺服器ID')

item_name

item_name: str = Field(..., description='拍賣物品名稱')

starting_price

starting_price: float = Field(..., description='起標價格')

increment

increment: float = Field(..., description='每次加價金額')

duration_hours

duration_hours: int = Field(default=24, description='競標持續時間 (小時)')

creator_id

creator_id: int = Field(..., description='創建者Discord ID')

creator_name

creator_name: str = Field(..., description='創建者Discord名稱')

created_at

created_at: datetime = Field(default_factory=now, description='創建時間')

end_time

end_time: datetime = Field(..., description='結束時間')

current_price

current_price: float = Field(..., description='當前最高價')

current_bidder_id

current_bidder_id: Optional[int] = Field(None, description='當前最高出價者ID')

current_bidder_name

current_bidder_name: Optional[str] = Field(None, description='當前最高出價者名稱')

is_active

is_active: bool = Field(default=True, description='是否活躍中')

currency_type

currency_type: str = Field(default='楓幣', description='貨幣類型 (楓幣、雪花或台幣)')

Bid

Bases: BaseModel

出價記錄模型

id

id: Optional[int] = Field(None, description='出價ID')

auction_id

auction_id: int = Field(..., description='競標ID')

guild_id

guild_id: int = Field(..., description='伺服器ID')

bidder_id

bidder_id: int = Field(..., description='出價者Discord ID')

bidder_name

bidder_name: str = Field(..., description='出價者Discord名稱')

amount

amount: float = Field(..., description='出價金額')

timestamp

timestamp: datetime = Field(default_factory=now, description='出價時間')

AuctionDatabase

AuctionDatabase(db_path: str = 'data/auctions.db')

競標資料庫操作類

Methods:

Name	Description
create_auction	創建新競標
get_auction	取得特定競標
get_active_auctions	取得特定伺服器的所有活躍競標
place_bid	出價
get_auction_bids	取得競標的所有出價記錄
end_auction	結束競標
claim_auction_to_guild	將未歸屬的拍賣 (guild_id=0) 歸屬到指定伺服器

Source code in src/cogs/auction.py

def __init__(self, db_path: str = "data/auctions.db"):
    self.db_path = db_path
    self._init_database()

db_path

db_path = db_path

create_auction

create_auction(auction: Auction) -> int

創建新競標

Source code in src/cogs/auction.py

def create_auction(self, auction: Auction) -> int:
    """創建新競標"""
    with sqlite3.connect(self.db_path) as conn:
        cursor = conn.cursor()
        cursor.execute(
            """
            INSERT INTO auctions (
                guild_id, item_name, starting_price, increment, duration_hours,
                creator_id, creator_name, end_time, current_price, currency_type
            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
        """,
            (
                auction.guild_id,
                auction.item_name,
                auction.starting_price,
                auction.increment,
                auction.duration_hours,
                auction.creator_id,
                auction.creator_name,
                auction.end_time,
                auction.current_price,
                auction.currency_type,
            ),
        )
        conn.commit()
        result = cursor.lastrowid
        return result if result is not None else 0

get_auction

get_auction(auction_id: int, guild_id: int) -> Optional[Auction]

取得特定競標

Source code in src/cogs/auction.py

def get_auction(self, auction_id: int, guild_id: int) -> Optional[Auction]:
    """取得特定競標"""
    with sqlite3.connect(self.db_path) as conn:
        conn.row_factory = sqlite3.Row
        cursor = conn.cursor()
        cursor.execute(
            "SELECT * FROM auctions WHERE id = ? AND guild_id = ?", (auction_id, guild_id)
        )

        row = cursor.fetchone()

        if row:
            try:
                currency_type = row["currency_type"]
            except (KeyError, IndexError):
                currency_type = "楓幣"  # Default for backward compatibility

            try:
                guild_id_from_row = row["guild_id"]
            except (KeyError, IndexError):
                guild_id_from_row = 0  # Default for backward compatibility

            return Auction(
                id=row["id"],
                guild_id=guild_id_from_row,
                item_name=row["item_name"],
                starting_price=row["starting_price"],
                increment=row["increment"],
                duration_hours=row["duration_hours"],
                creator_id=row["creator_id"],
                creator_name=row["creator_name"],
                created_at=datetime.fromisoformat(row["created_at"]),
                end_time=datetime.fromisoformat(row["end_time"]),
                current_price=row["current_price"],
                current_bidder_id=row["current_bidder_id"],
                current_bidder_name=row["current_bidder_name"],
                is_active=bool(row["is_active"]),
                currency_type=currency_type,
            )
        return None

get_active_auctions

get_active_auctions(guild_id: int) -> list[Auction]

取得特定伺服器的所有活躍競標

Source code in src/cogs/auction.py

def get_active_auctions(self, guild_id: int) -> list[Auction]:
    """取得特定伺服器的所有活躍競標"""
    with sqlite3.connect(self.db_path) as conn:
        conn.row_factory = sqlite3.Row
        cursor = conn.cursor()
        cursor.execute(
            """
            SELECT * FROM auctions
            WHERE guild_id = ? AND is_active = TRUE AND end_time > datetime('now')
            ORDER BY end_time ASC
        """,
            (guild_id,),
        )

        auctions = []
        for row in cursor.fetchall():
            try:
                currency_type = row["currency_type"]
            except (KeyError, IndexError):
                currency_type = "楓幣"  # Default for backward compatibility

            try:
                guild_id_from_row = row["guild_id"]
            except (KeyError, IndexError):
                guild_id_from_row = guild_id  # Use provided guild_id as fallback

            auctions.append(
                Auction(
                    id=row["id"],
                    guild_id=guild_id_from_row,
                    item_name=row["item_name"],
                    starting_price=row["starting_price"],
                    increment=row["increment"],
                    duration_hours=row["duration_hours"],
                    creator_id=row["creator_id"],
                    creator_name=row["creator_name"],
                    created_at=datetime.fromisoformat(row["created_at"]),
                    end_time=datetime.fromisoformat(row["end_time"]),
                    current_price=row["current_price"],
                    current_bidder_id=row["current_bidder_id"],
                    current_bidder_name=row["current_bidder_name"],
                    is_active=bool(row["is_active"]),
                    currency_type=currency_type,
                )
            )

        return auctions

place_bid

place_bid(auction_id: int, bidder_id: int, bidder_name: str, amount: float, guild_id: int) -> bool

出價

Source code in src/cogs/auction.py

def place_bid(
    self, auction_id: int, bidder_id: int, bidder_name: str, amount: float, guild_id: int
) -> bool:
    """出價"""
    with sqlite3.connect(self.db_path) as conn:
        cursor = conn.cursor()

        # 檢查競標是否存在且活躍
        cursor.execute(
            """
            SELECT current_price, increment, end_time, is_active, current_bidder_id, creator_id
            FROM auctions WHERE id = ? AND guild_id = ?
        """,
            (auction_id, guild_id),
        )

        auction_data = cursor.fetchone()
        if not auction_data:
            return False

        current_price, increment, end_time, is_active, current_bidder_id, creator_id = (
            auction_data
        )

        # 檢查競標是否已結束
        if not is_active or datetime.fromisoformat(end_time) <= datetime.now():
            return False

        # 檢查用戶是否為拍賣創建者
        if bidder_id == creator_id:
            return False

        # 檢查用戶是否為當前最高出價者
        if current_bidder_id is not None and bidder_id == current_bidder_id:
            return False

        # 檢查出價是否足夠（必須至少為當前價格 + 加價金額）
        min_bid = current_price + increment
        if amount < min_bid:
            return False

        # 記錄出價
        cursor.execute(
            """
            INSERT INTO bids (auction_id, guild_id, bidder_id, bidder_name, amount)
            VALUES (?, ?, ?, ?, ?)
        """,
            (auction_id, guild_id, bidder_id, bidder_name, amount),
        )

        # 更新競標當前價格
        cursor.execute(
            """
            UPDATE auctions
            SET current_price = ?, current_bidder_id = ?, current_bidder_name = ?
            WHERE id = ? AND guild_id = ?
        """,
            (amount, bidder_id, bidder_name, auction_id, guild_id),
        )

        conn.commit()
        return True

get_auction_bids

get_auction_bids(auction_id: int, guild_id: int) -> list[Bid]

取得競標的所有出價記錄

Source code in src/cogs/auction.py

def get_auction_bids(self, auction_id: int, guild_id: int) -> list[Bid]:
    """取得競標的所有出價記錄"""
    with sqlite3.connect(self.db_path) as conn:
        conn.row_factory = sqlite3.Row
        cursor = conn.cursor()
        cursor.execute(
            """
            SELECT * FROM bids WHERE auction_id = ? AND guild_id = ?
            ORDER BY amount DESC, timestamp DESC
            LIMIT 10
        """,
            (auction_id, guild_id),
        )

        bids = []
        for row in cursor.fetchall():
            try:
                guild_id_from_row = row["guild_id"]
            except (KeyError, IndexError):
                guild_id_from_row = guild_id  # Use provided guild_id as fallback

            bids.append(
                Bid(
                    id=row["id"],
                    auction_id=row["auction_id"],
                    guild_id=guild_id_from_row,
                    bidder_id=row["bidder_id"],
                    bidder_name=row["bidder_name"],
                    amount=row["amount"],
                    timestamp=datetime.fromisoformat(row["timestamp"]),
                )
            )

        return bids

end_auction

end_auction(auction_id: int, guild_id: int) -> bool

結束競標

Source code in src/cogs/auction.py

def end_auction(self, auction_id: int, guild_id: int) -> bool:
    """結束競標"""
    with sqlite3.connect(self.db_path) as conn:
        cursor = conn.cursor()
        cursor.execute(
            """
            UPDATE auctions SET is_active = FALSE WHERE id = ? AND guild_id = ?
        """,
            (auction_id, guild_id),
        )
        conn.commit()
        return cursor.rowcount > 0

claim_auction_to_guild

claim_auction_to_guild(auction_id: int, guild_id: int) -> bool

將未歸屬的拍賣 (guild_id=0) 歸屬到指定伺服器

Source code in src/cogs/auction.py

def claim_auction_to_guild(self, auction_id: int, guild_id: int) -> bool:
    """將未歸屬的拍賣 (guild_id=0) 歸屬到指定伺服器"""
    with sqlite3.connect(self.db_path) as conn:
        cursor = conn.cursor()

        # 只更新 guild_id=0 的拍賣
        cursor.execute(
            """
            UPDATE auctions SET guild_id = ? WHERE id = ? AND guild_id = 0
        """,
            (guild_id, auction_id),
        )

        # 捕獲拍賣更新的行數
        auction_updated = cursor.rowcount > 0

        # 同時更新相關的出價記錄
        if auction_updated:
            cursor.execute(
                """
                UPDATE bids SET guild_id = ? WHERE auction_id = ? AND guild_id = 0
            """,
                (guild_id, auction_id),
            )

        conn.commit()
        return auction_updated

AuctionCurrencySelectionView

AuctionCurrencySelectionView()

Bases: View

貨幣類型選擇視圖

Methods:

Name	Description
currency_select

Source code in src/cogs/auction.py

def __init__(self):
    super().__init__(timeout=300)

currency_select

currency_select(select: Select, interaction: Interaction) -> None

Source code in src/cogs/auction.py

@nextcord.ui.select(
    placeholder="選擇貨幣類型...",
    options=[
        SelectOption(label="楓幣", value="楓幣", emoji="🍁", description="遊戲內楓幣"),
        SelectOption(label="雪花", value="雪花", emoji="❄️", description="雪花貨幣"),
        SelectOption(label="台幣", value="台幣", emoji="💰", description="台灣新台幣"),
    ],
    min_values=1,
    max_values=1,
)
async def currency_select(self, select: Select, interaction: Interaction) -> None:
    selected_currency = select.values[0]
    modal = AuctionCreateModal(currency_type=selected_currency)
    await interaction.response.send_modal(modal)

AuctionCreateModal

AuctionCreateModal(currency_type: str = '楓幣')

Bases: Modal

創建競標的模態對話框

Methods:

Name	Description
callback

Source code in src/cogs/auction.py

def __init__(self, currency_type: str = "楓幣"):
    super().__init__(title="創建拍賣", timeout=300)
    self.selected_currency = currency_type

    self.item_name = TextInput(
        label="物品名稱",
        placeholder="請輸入要拍賣的物品名稱...",
        required=True,
        max_length=100,
    )

    currency_display = get_currency_display(currency_type)
    self.starting_price = TextInput(
        label="起標價格",
        placeholder=f"請輸入起標價格 ({currency_display})，支援小數點...",
        required=True,
        max_length=20,
    )

    self.increment = TextInput(
        label="加價金額",
        placeholder=f"請輸入每次最少加價金額 ({currency_display})，支援小數點...",
        required=True,
        max_length=20,
    )

    self.duration = TextInput(
        label="拍賣時長 (小時)",
        placeholder="請輸入拍賣持續時間 (1-168小時)...",
        required=True,
        max_length=3,
        default_value="24",
    )

    self.add_item(self.item_name)
    self.add_item(self.starting_price)
    self.add_item(self.increment)
    self.add_item(self.duration)

selected_currency

selected_currency = currency_type

item_name

item_name = TextInput(label='物品名稱', placeholder='請輸入要拍賣的物品名稱...', required=True, max_length=100)

starting_price

starting_price = TextInput(
    label="起標價格",
    placeholder=f"請輸入起標價格 ({currency_display})，支援小數點...",
    required=True,
    max_length=20,
)

increment

increment = TextInput(
    label="加價金額",
    placeholder=f"請輸入每次最少加價金額 ({currency_display})，支援小數點...",
    required=True,
    max_length=20,
)

duration

duration = TextInput(
    label="拍賣時長 (小時)",
    placeholder="請輸入拍賣持續時間 (1-168小時)...",
    required=True,
    max_length=3,
    default_value="24",
)

callback

callback(interaction: Interaction) -> None

Source code in src/cogs/auction.py

async def callback(self, interaction: Interaction) -> None:
    try:
        starting_price = float(self.starting_price.value)
        increment = float(self.increment.value)
        duration_hours = int(self.duration.value)
        currency_type = self.selected_currency

        if starting_price <= 0:
            await interaction.response.send_message("❌ 起標價格必須大於 0!", ephemeral=True)
            return

        if increment <= 0:
            await interaction.response.send_message("❌ 加價金額必須大於 0!", ephemeral=True)
            return

        if not (1 <= duration_hours <= 168):
            await interaction.response.send_message(
                "❌ 拍賣時長必須在 1-168 小時之間!", ephemeral=True
            )
            return

        # 檢查是否在伺服器中執行命令
        if interaction.guild is None:
            await interaction.response.send_message(
                "❌ 拍賣功能只能在伺服器中使用，不支援私人訊息!", ephemeral=True
            )
            return

        # 創建競標
        auction = Auction(
            guild_id=interaction.guild.id,
            item_name=self.item_name.value,
            starting_price=starting_price,
            increment=increment,
            duration_hours=duration_hours,
            creator_id=interaction.user.id,
            creator_name=interaction.user.display_name,
            end_time=datetime.now() + timedelta(hours=duration_hours),
            current_price=starting_price,
            currency_type=currency_type,
        )

        db = AuctionDatabase()
        auction_id = db.create_auction(auction)
        auction.id = auction_id

        # 創建競標顯示
        embed = self._create_auction_embed(auction)
        view = AuctionView(auction)

        await interaction.response.send_message(
            f"🎉 拍賣已成功創建!拍賣編號：#{auction_id}", embed=embed, view=view
        )

    except ValueError:
        await interaction.response.send_message("❌ 請輸入有效的數字格式!", ephemeral=True)
    except Exception as e:
        logfire.error(f"創建拍賣時發生錯誤: {e}")
        await interaction.response.send_message(
            "❌ 創建拍賣時發生錯誤，請稍後再試!", ephemeral=True
        )

AuctionBidModal

AuctionBidModal(auction: Auction)

Bases: Modal

出價模態對話框

Methods:

Name	Description
callback

Source code in src/cogs/auction.py

def __init__(self, auction: Auction):
    super().__init__(title=f"競標 - {auction.item_name}", timeout=300)
    self.auction = auction

    min_bid = auction.current_price + auction.increment
    currency = get_currency_display(auction.currency_type)

    self.bid_amount = TextInput(
        label="出價金額",
        placeholder=f"最低出價：{min_bid:,.2f} {currency} (支援小數點)",
        required=True,
        max_length=20,
    )

    self.add_item(self.bid_amount)

auction

auction = auction

bid_amount

bid_amount = TextInput(
    label="出價金額",
    placeholder=f"最低出價：{min_bid} {currency} (支援小數點)",
    required=True,
    max_length=20,
)

callback

callback(interaction: Interaction) -> None

Source code in src/cogs/auction.py

async def callback(self, interaction: Interaction) -> None:
    try:
        bid_amount = float(self.bid_amount.value)
        min_bid = self.auction.current_price + self.auction.increment
        currency = get_currency_display(self.auction.currency_type)

        if bid_amount < min_bid:
            await interaction.response.send_message(
                f"❌ 出價金額必須至少為 {min_bid:,.2f} {currency}!", ephemeral=True
            )
            return

        # 檢查用戶是否為當前最高出價者
        if self.auction.current_bidder_id == interaction.user.id:
            await interaction.response.send_message(
                "❌ 你已經是當前最高出價者了!", ephemeral=True
            )
            return

        # 檢查用戶是否為拍賣創建者
        if self.auction.creator_id == interaction.user.id:
            await interaction.response.send_message(
                "❌ 拍賣創建者不能參與自己的拍賣!", ephemeral=True
            )
            return

        # 處理出價
        db = AuctionDatabase()
        if self.auction.id is None:
            await interaction.response.send_message("❌ 拍賣ID無效!", ephemeral=True)
            return

        # 檢查是否在伺服器中執行命令
        if interaction.guild is None:
            await interaction.response.send_message(
                "❌ 拍賣功能只能在伺服器中使用!", ephemeral=True
            )
            return

        success = db.place_bid(
            self.auction.id,
            interaction.user.id,
            interaction.user.display_name,
            bid_amount,
            interaction.guild.id,
        )

        if success:
            # 更新競標資訊
            updated_auction = db.get_auction(self.auction.id, interaction.guild.id)
            if updated_auction:
                embed = self._create_auction_embed(updated_auction)
                view = AuctionView(updated_auction)

                await interaction.response.edit_message(
                    content=f"🎉 出價成功! {interaction.user.mention} 出價 {bid_amount:,.2f} {currency}",
                    embed=embed,
                    view=view,
                )
            else:
                await interaction.response.send_message(
                    "❌ 出價失敗，請稍後再試!", ephemeral=True
                )
        else:
            await interaction.response.send_message(
                "❌ 出價失敗，可能有其他人同時出價了!", ephemeral=True
            )

    except ValueError:
        await interaction.response.send_message("❌ 請輸入有效的數字格式!", ephemeral=True)
    except Exception as e:
        logfire.error(f"出價時發生錯誤: {e}")
        await interaction.response.send_message(
            "❌ 出價時發生錯誤，請稍後再試!", ephemeral=True
        )

AuctionView

AuctionView(auction: Auction)

Bases: View

競標互動視圖

Methods:

Name	Description
bid_button
history_button
refresh_button

Source code in src/cogs/auction.py

def __init__(self, auction: Auction):
    super().__init__(timeout=None)  # 不設置超時
    self.auction = auction

auction

auction = auction

bid_button

bid_button(button: Button, interaction: Interaction) -> None

Source code in src/cogs/auction.py

@nextcord.ui.button(label="出價", style=nextcord.ButtonStyle.green, emoji="💰")
async def bid_button(self, button: Button, interaction: Interaction) -> None:
    # 檢查是否在伺服器中執行命令
    if interaction.guild is None:
        await interaction.response.send_message(
            "❌ 拍賣功能只能在伺服器中使用!", ephemeral=True
        )
        return

    # 自動歸屬未歸屬的拍賣
    if self.auction.guild_id == 0 and self.auction.id is not None:
        db = AuctionDatabase()
        if db.claim_auction_to_guild(self.auction.id, interaction.guild.id):
            self.auction.guild_id = interaction.guild.id
            # 重新載入拍賣資訊以獲取最新數據
            updated_auction = db.get_auction(self.auction.id, interaction.guild.id)
            if updated_auction:
                self.auction = updated_auction

    # 檢查競標是否已結束
    if datetime.now() >= self.auction.end_time:
        await interaction.response.send_message("❌ 此拍賣已結束!", ephemeral=True)
        return

    modal = AuctionBidModal(self.auction)
    await interaction.response.send_modal(modal)

history_button

history_button(button: Button, interaction: Interaction) -> None

Source code in src/cogs/auction.py

@nextcord.ui.button(label="查看記錄", style=nextcord.ButtonStyle.gray, emoji="📊")
async def history_button(self, button: Button, interaction: Interaction) -> None:
    if self.auction.id is None:
        await interaction.response.send_message("❌ 拍賣ID無效!", ephemeral=True)
        return

    # 檢查是否在伺服器中執行命令
    if interaction.guild is None:
        await interaction.response.send_message(
            "❌ 拍賣功能只能在伺服器中使用!", ephemeral=True
        )
        return

    # 自動歸屬未歸屬的拍賣
    if self.auction.guild_id == 0 and self.auction.id is not None:
        db = AuctionDatabase()
        if db.claim_auction_to_guild(self.auction.id, interaction.guild.id):
            self.auction.guild_id = interaction.guild.id
            # 重新載入拍賣資訊以獲取最新數據
            updated_auction = db.get_auction(self.auction.id, interaction.guild.id)
            if updated_auction:
                self.auction = updated_auction

    if self.auction.id is None:
        await interaction.response.send_message("❌ 拍賣ID無效!", ephemeral=True)
        return

    db = AuctionDatabase()
    bids = db.get_auction_bids(self.auction.id, interaction.guild.id)

    if not bids:
        await interaction.response.send_message("📭 此拍賣還沒有出價記錄。", ephemeral=True)
        return

    embed = Embed(
        title=f"📊 拍賣記錄 - {self.auction.item_name}",
        description=f"拍賣編號：#{self.auction.id}",
        color=0x00AAFF,
    )

    currency = get_currency_display(self.auction.currency_type)
    bid_list = []
    for i, bid in enumerate(bids, 1):
        time_str = bid.timestamp.strftime("%m/%d %H:%M")
        bid_list.append(
            f"{i}. **{bid.bidder_name}** - {bid.amount:,.2f} {currency} ({time_str})"
        )

    embed.add_field(
        name="💰 出價記錄 (前10筆)",
        value="\n".join(bid_list) if bid_list else "暫無記錄",
        inline=False,
    )

    await interaction.response.send_message(embed=embed, ephemeral=True)

refresh_button

refresh_button(button: Button, interaction: Interaction) -> None

Source code in src/cogs/auction.py

@nextcord.ui.button(label="刷新", style=nextcord.ButtonStyle.gray, emoji="🔄")
async def refresh_button(self, button: Button, interaction: Interaction) -> None:
    if self.auction.id is None:
        await interaction.response.send_message("❌ 拍賣ID無效!", ephemeral=True)
        return

    # 檢查是否在伺服器中執行命令
    if interaction.guild is None:
        await interaction.response.send_message(
            "❌ 拍賣功能只能在伺服器中使用!", ephemeral=True
        )
        return

    db = AuctionDatabase()

    # 自動歸屬未歸屬的拍賣
    if self.auction.guild_id == 0 and db.claim_auction_to_guild(
        self.auction.id, interaction.guild.id
    ):
        self.auction.guild_id = interaction.guild.id

    updated_auction = db.get_auction(self.auction.id, interaction.guild.id)

    if updated_auction:
        self.auction = updated_auction
        embed = self._create_auction_embed(updated_auction)
        view = AuctionView(updated_auction)

        await interaction.response.edit_message(embed=embed, view=view)
    else:
        await interaction.response.send_message("❌ 無法載入拍賣資訊!", ephemeral=True)

AuctionListView

AuctionListView(auctions: list[Auction])

Bases: View

拍賣列表視圖

Methods:

Name	Description
auction_select

Source code in src/cogs/auction.py

def __init__(self, auctions: list[Auction]):
    super().__init__(timeout=300)
    self.auctions = auctions

    if auctions:
        options = []
        for auction in auctions:
            remaining_time = auction.end_time - datetime.now()
            hours = int(remaining_time.total_seconds() // 3600)
            currency = get_currency_display(auction.currency_type)

            description = f"當前價格: {auction.current_price:,.2f} {currency} | 剩餘: {hours}h"
            options.append(
                SelectOption(
                    label=auction.item_name, description=description, value=str(auction.id)
                )
            )

        self.auction_select.options = options
    else:
        self.auction_select.disabled = True

auctions

auctions = auctions

auction_select

auction_select(select: Select, interaction: Interaction) -> None

Source code in src/cogs/auction.py

@nextcord.ui.select(placeholder="選擇要查看的拍賣...", min_values=1, max_values=1)
async def auction_select(self, select: Select, interaction: Interaction) -> None:
    auction_id = int(select.values[0])

    # 檢查是否在伺服器中執行命令
    if interaction.guild is None:
        await interaction.response.send_message(
            "❌ 拍賣功能只能在伺服器中使用!", ephemeral=True
        )
        return

    db = AuctionDatabase()
    auction = db.get_auction(auction_id, interaction.guild.id)

    if auction:
        embed = self._create_auction_embed(auction)
        view = AuctionView(auction)

        await interaction.response.send_message(embed=embed, view=view, ephemeral=True)
    else:
        await interaction.response.send_message("❌ 找不到該拍賣!", ephemeral=True)

AuctionCogs

AuctionCogs(bot: Bot)

Bases: Cog

拍賣系統功能

Methods:

Name	Description
auction_create	創建新拍賣
auction_list	查看拍賣列表
auction_info	查看特定拍賣資訊
auction_my	查看個人拍賣記錄

Source code in src/cogs/auction.py

def __init__(self, bot: commands.Bot):
    self.bot = bot
    # 初始化競標資料庫
    self.auction_db = AuctionDatabase()

bot

bot = bot

auction_db

auction_db = AuctionDatabase()

auction_create

auction_create(interaction: Interaction) -> None

創建新拍賣

Source code in src/cogs/auction.py

@nextcord.slash_command(
    name="auction_create",
    description="Create a new item auction",
    name_localizations={Locale.zh_TW: "創建拍賣", Locale.ja: "オークション作成"},
    description_localizations={
        Locale.zh_TW: "創建新的物品拍賣",
        Locale.ja: "新しいアイテムオークションを作成",
    },
    dm_permission=False,
    nsfw=False,
)
async def auction_create(self, interaction: Interaction) -> None:
    """創建新拍賣"""
    # 檢查是否在伺服器中執行命令
    if interaction.guild is None:
        embed = Embed(
            title="❌ 錯誤",
            description="拍賣功能只能在伺服器中使用，不支援私人訊息!",
            color=0xFF0000,
        )
        await interaction.response.send_message(embed=embed, ephemeral=True)
        return

    embed = Embed(
        title="🏺 創建拍賣", description="請先選擇拍賣使用的貨幣類型：", color=0xFFD700
    )
    view = AuctionCurrencySelectionView()
    await interaction.response.send_message(embed=embed, view=view, ephemeral=True)

auction_list

auction_list(interaction: Interaction) -> None

查看拍賣列表

Source code in src/cogs/auction.py

@nextcord.slash_command(
    name="auction_list",
    description="View active auctions",
    name_localizations={Locale.zh_TW: "拍賣列表", Locale.ja: "オークションリスト"},
    description_localizations={
        Locale.zh_TW: "查看進行中的拍賣列表",
        Locale.ja: "進行中のオークション一覧を表示",
    },
    dm_permission=False,
    nsfw=False,
)
async def auction_list(self, interaction: Interaction) -> None:
    """查看拍賣列表"""
    await interaction.response.defer()

    # 檢查是否在伺服器中執行命令
    if interaction.guild is None:
        embed = Embed(
            title="❌ 錯誤",
            description="拍賣功能只能在伺服器中使用，不支援私人訊息!",
            color=0xFF0000,
        )
        await interaction.followup.send(embed=embed)
        return

    auctions = self.auction_db.get_active_auctions(interaction.guild.id)

    if not auctions:
        embed = Embed(
            title="📋 拍賣列表", description="目前沒有進行中的拍賣。", color=0xFFAA00
        )
        embed.add_field(
            name="💡 提示", value="使用 `/auction_create` 來創建新的拍賣!", inline=False
        )
        await interaction.followup.send(embed=embed)
        return

    embed = Embed(
        title="📋 進行中的拍賣",
        description=f"共有 {len(auctions)} 個拍賣進行中",
        color=0x00AAFF,
    )

    # 顯示前5個拍賣的摘要
    auction_summary = []
    for i, auction in enumerate(auctions, 1):
        remaining_time = auction.end_time - datetime.now()
        hours = int(remaining_time.total_seconds() // 3600)
        currency = get_currency_display(auction.currency_type)

        summary = (
            f"{i}. **{auction.item_name}** (#{auction.id})\n"
            f"   💰 {auction.current_price:,.2f} {currency} | ⏰ {hours}h 剩餘"
        )
        auction_summary.append(summary)

    embed.add_field(name="🏺 拍賣預覽", value="\n\n".join(auction_summary), inline=False)

    if len(auctions) > 5:
        embed.add_field(name="📝 說明", value="請使用下方選單查看詳細資訊。", inline=False)

    view = AuctionListView(auctions)
    await interaction.followup.send(embed=embed, view=view)

auction_info

auction_info(
    interaction: Interaction,
    auction_id: int = nextcord.SlashOption(
        name="auction_id",
        description="Auction ID to view",
        name_localizations={Locale.zh_TW: "拍賣編號", Locale.ja: "オークション番号"},
        description_localizations={
            Locale.zh_TW: "要查看的拍賣編號",
            Locale.ja: "表示するオークション番号",
        },
        required=True,
    ),
) -> None

查看特定拍賣資訊

Source code in src/cogs/auction.py

@nextcord.slash_command(
    name="auction_info",
    description="View detailed information about a specific auction",
    name_localizations={Locale.zh_TW: "拍賣資訊", Locale.ja: "オークション情報"},
    description_localizations={
        Locale.zh_TW: "查看特定拍賣的詳細資訊",
        Locale.ja: "特定のオークションの詳細情報を表示",
    },
    dm_permission=False,
    nsfw=False,
)
async def auction_info(
    self,
    interaction: Interaction,
    auction_id: int = nextcord.SlashOption(
        name="auction_id",
        description="Auction ID to view",
        name_localizations={Locale.zh_TW: "拍賣編號", Locale.ja: "オークション番号"},
        description_localizations={
            Locale.zh_TW: "要查看的拍賣編號",
            Locale.ja: "表示するオークション番号",
        },
        required=True,
    ),
) -> None:
    """查看特定拍賣資訊"""
    await interaction.response.defer()

    # 檢查是否在伺服器中執行命令
    if interaction.guild is None:
        embed = Embed(
            title="❌ 錯誤",
            description="拍賣功能只能在伺服器中使用，不支援私人訊息!",
            color=0xFF0000,
        )
        await interaction.followup.send(embed=embed)
        return

    auction = self.auction_db.get_auction(auction_id, interaction.guild.id)

    if not auction:
        embed = Embed(
            title="❌ 錯誤", description=f"找不到編號 #{auction_id} 的拍賣。", color=0xFF0000
        )
        await interaction.followup.send(embed=embed)
        return

    embed = self._create_auction_embed(auction)
    view = AuctionView(auction)

    await interaction.followup.send(embed=embed, view=view)

auction_my

auction_my(interaction: Interaction) -> None

查看個人拍賣記錄

Source code in src/cogs/auction.py

@nextcord.slash_command(
    name="auction_my",
    description="View your auctions and bids",
    name_localizations={Locale.zh_TW: "我的拍賣", Locale.ja: "マイオークション"},
    description_localizations={
        Locale.zh_TW: "查看你的拍賣和出價記錄",
        Locale.ja: "あなたのオークションと入札記録を表示",
    },
    dm_permission=False,
    nsfw=False,
)
async def auction_my(self, interaction: Interaction) -> None:
    """查看個人拍賣記錄"""
    await interaction.response.defer()

    # 檢查是否在伺服器中執行命令
    if interaction.guild is None:
        embed = Embed(
            title="❌ 錯誤",
            description="拍賣功能只能在伺服器中使用，不支援私人訊息!",
            color=0xFF0000,
        )
        await interaction.followup.send(embed=embed)
        return

    active_auctions = self.auction_db.get_active_auctions(interaction.guild.id)
    user_auctions = self._get_user_created_auctions(active_auctions, interaction.user.id)
    leading_auctions = self._get_user_leading_auctions(active_auctions, interaction.user.id)

    embed = Embed(title=f"📋 {interaction.user.mention} 的拍賣記錄", color=0x9966FF)

    self._add_auction_fields_to_embed(embed, user_auctions, leading_auctions)
    await interaction.followup.send(embed=embed)