Discord AI 機器人（大笨bot）

👉 介紹網頁：不用看程式碼，直接看大笨bot 能做什麼。

讀取頻道的歷史訊息當上下文，用本地模型（例如 Qwen，經 LiteLLM 的 OpenAI 相容 API）回覆。 機器人本體跑在 Linux 伺服器上（systemd 服務 discord-bot），連到你設定的模型 API（LLM_BASE_URL）。 Discord 機器人只需要「往外連」Discord，不用開任何連接埠。

快速開始（自己架一隻）

1. 需要什麼

• Python 3.11 以上
• 系統要裝 ffmpeg（放音樂用）和 node（yt-dlp 解 YouTube 用）。Ubuntu／Debian：sudo apt install ffmpeg nodejs
• 一個 OpenAI 相容的模型 API：本機的 Ollama、LiteLLM、vLLM，或 OpenAI、DeepSeek 等線上服務都行
• 一個 Discord 機器人帳號（下一步）
• 選填：星盤圖要用 Chromium 把 SVG 轉成 PNG（pip install playwright && playwright install chromium，裝在哪個 Python 由 .env 的 SVG_PYTHON 指定）；沒裝就只有文字星盤

2. 建立 Discord 機器人並拿到 token

1. 到 Discord Developer Portal → New Application，取名字。
2. 左邊 Bot 頁 → Reset Token → 複製出現的 token（只會顯示一次）。這就是 DISCORD_TOKEN，等同機器人的密碼，不要貼到任何公開的地方。
3. 同一頁往下找到 Privileged Gateway Intents，打開 Message Content Intent（沒開機器人讀不到訊息內容）。
4. 左邊 General Information 複製 Application ID（也就是 client id）。
5. 邀請機器人進你的伺服器：把下面「邀請連結」裡的 YOUR_CLIENT_ID 換成剛才的 Application ID，用瀏覽器打開、選伺服器、同意。

3. 安裝與設定

git clone https://github.com/ggh93234999/discord-ai-bot.git
cd discord-ai-bot
python3 -m venv .venv
source .venv/bin/activate          # Windows：.venv\Scripts\activate
pip install -r requirements.txt

cp .env.example .env               # Windows：copy .env.example .env

然後用文字編輯器打開 .env，把金鑰填在這裡（這個檔案已被 .gitignore 擋住，不會被 git 上傳；千萬不要把它傳給別人或貼到聊天室）：

變數	填什麼
DISCORD_TOKEN	上一步複製的機器人 token
LLM_BASE_URL	模型 API 位址，要含 /v1。Ollama：http://localhost:11434/v1；LiteLLM：http://localhost:4000/v1；OpenAI：https://api.openai.com/v1
LLM_API_KEY	模型 API 的金鑰。Ollama 不檢查，隨便填一個非空字串（例如 ollama）即可
LLM_MODEL	模型名稱，要跟 API 那邊的名稱一樣，例如 qwen3:8b、gpt-4o-mini
DEEPSEEK_API_KEY	選填，只有想用 /餘額 查 DeepSeek 餘額才需要
ADMIN_USER_IDS	選填，除了機器人擁有者以外，還有誰能用 /模型 切模型（Discord 使用者 ID，逗號分隔）

其他選填設定都有預設值，說明寫在 .env.example 裡。

4. 啟動

python bot.py

看到「已同步斜線指令」就成功了。到 Discord 打 / 就能看到指令（第一次可能要等一兩分鐘，或按 Ctrl+R 重新整理）。 語音和聊天都在這一個程式裡，不需要對外開任何連接埠，機器人只是主動連出去 Discord 和你的模型 API。

要長期運作的話，可以用 systemd：參考 discord-bot.service.example，改掉使用者和路徑後放到 /etc/systemd/system/，再 sudo systemctl enable --now discord-bot。

5. 常見問題

• 機器人在線上但不回話：多半是 Message Content Intent 沒開（步驟 2-3），或 LLM_BASE_URL 連不到（看終端機的錯誤訊息）。
• 指令沒出現：重新整理 Discord（Ctrl+R）；確認邀請連結有包含 applications.commands。
• 放音樂沒聲音／失敗：確認系統有 ffmpeg，機器人有「連線」和「說話」權限；YouTube 常改版，pip install -U yt-dlp 通常就會好。
• token 外洩了：馬上回 Developer Portal 重新 Reset Token，舊的就失效，再把新的填進 .env。

什麼時候會回

• 私訊機器人
• 在頻道裡 @機器人，或直接回覆機器人的訊息
• 用 /自動回覆 開 開啟的頻道，任何人說話都回

其他機器人發的訊息一律不理，避免兩個機器人互相無限對話。 模型那台電腦關機或沒開模型時，機器人會回「模型那台電腦現在沒開或連不到」。

功能

• 看圖：最近 4 則訊息裡的圖片（最多 4 張）會縮圖後一起送給模型。
• 天氣：問天氣會用 Open-Meteo 查（免費、不用金鑰）。
• 上網：需要即時資訊時，模型自己決定要不要用 DuckDuckGo 搜尋、打開網頁讀內容。 查的時候會先出現「🔎 搜尋：…」，查完那則訊息會變成答案。
• 放音樂（YouTube）：先進語音頻道，再用 /播放 歌名或網址，或直接說「@大笨bot 放周杰倫的晴天」「放點讀書的音樂」「下一首」。 可以貼單首網址或整個播放清單（最多 50 首）。佇列播完 3 分鐘、或語音頻道沒人 1 分鐘，會自己離開。 yt-dlp 建議定期更新（可參考 update-ytdlp.sh.example 設成每週的 crontab），YouTube 改版時通常更新就會好。
• 開頻道（要叫它開的人本身要有「管理頻道」權限；機器人也要有「管理頻道」，臨時語音房再加「移動成員」）
  • /開頻道 名稱 類型 [分類] [私人]，或直接說「@大笨bot 幫我開一個叫 xxx 的語音頻道」
  • /改頻道 [頻道] [新名稱] [分類]：改名或搬到別的分類，也可以直接說「把大笨bot 語音頻道移到語音頻道分類」
  • /關頻道 方式 [頻道] [隱藏]：封存（鎖住、可還原）、解除封存、刪除（永久，會先跳確認按鈕）。 用說的只能封存／解除封存，不能刪除。封存需要機器人另有「管理身分組」權限。
  • /頻道狀態 [狀態] [頻道]：設定語音頻道狀態（留空＝清除），也能直接說「把語音狀態改成 讀書中」。手動設定的狀態不會被歌名蓋掉。
  • /臨時語音房 開：建立「➕ 建立語音房」入口，有人進去就自動開一間他的房間並移過去，人走光自動刪掉
• 占卜（dbot/ai/divination.py）：直接聊天說「@大笨bot 幫我抽塔羅問工作」「幫我擲筊問明天面試好不好」「抽支籤問感情」「用易經卜一卦」就好，沒有斜線指令。
  • 種類：塔羅牌（78 張、正逆位；牌陣：單張、過去現在未來、二選一、感情）、擲筊（最多連擲 3 次，聖筊 1/2、笑筊 1/4、陰筊 1/4）、抽籤詩（天上聖母六十甲子籤，要擲到聖筊才算數，不然重抽）、易經（三錢法起卦，含變爻和之卦，依變爻數決定看卦辭或爻辭）。
  • 牌、籤、卦都由程式用系統亂數決定，結果卡由程式直接貼在回覆最上面，模型只負責解讀，不能自己編結果。
  • 籤詩和《周易》原文來自維基文庫，存在 dbot/ai/divination_data/；塔羅牌義是自己整理的常見解釋。
  • 每種占卜都附圖（dbot/ai/drawimg.py）：擲筊畫出每一擲兩個筊的平凸面、籤詩畫成直式籤紙、易經畫出本卦與之卦的卦象並標出變爻。
  • 塔羅會附上牌陣圖片（dbot/ai/drawimg.py 用 Pillow 畫；牌面是 1909 年的偉特塔羅牌，公有領域，取自維基共享資源，存在 divination_data/tarot/00.jpg～77.jpg，編號同 divination.TAROT，逆位會倒過來畫）。
• 八字命盤／星盤（dbot/ai/fortune.py）：說「@大笨bot 幫我排八字和星盤，1990-05-15 14:30 台北出生，男」。資料不夠時機器人會先問。
  • 八字會附上五行配色的命盤圖（四柱、十神、藏干、納音、五行數量、大運），也是 dbot/ai/drawimg.py 畫的。
  • 八字用 lunar_python（壽星萬年曆）：年柱、月柱看出生的絕對時刻（節氣交接準確），日柱、時柱用出生地真太陽時（經度＋均時差）；附十神、藏干、納音、五行數量，給性別會排大運。可輸入農曆生日（含閏月）。
  • 星盤用 kerykeion（Swiss Ephemeris，回歸黃道、普拉西度宮位）：行星落座、宮位、逆行、主要相位、元素分布，並畫成中文星盤圖附在回覆上（svg2png.py 用伺服器的 Chromium／playwright 把 SVG 轉 PNG，SVG_PYTHON 可指定要用哪個 Python）。沒有出生時間時用中午計算並提醒宮位、上升不準。
  • 出生地：台灣各縣市和常見城市內建經緯度與時區，其他地點用 Open-Meteo 地名搜尋，或由模型提供經緯度＋時區。
• 斜線指令
  • /播放 <歌曲>、/跳過、/暫停、/繼續、/停止、/佇列、

調整

• 個性和說話方式：改 system_prompt.txt，存檔後下一則回覆就生效，不用重開。 （上網工具的使用規則和現在時間是程式自動加在後面的，不用寫在這裡。）
• 其他設定在 .env，改完要 sudo systemctl restart discord-bot：
  • HISTORY_LIMIT：往回讀幾則訊息。越多越懂前後文，但模型處理越久。
  • REASONING_EFFORT：none 最快；想要它多想一下改 low / medium / high。
  • MAX_TOKENS：每次回覆長度上限。
  • WEB_TOOLS=off：關掉上網／天氣。
  • IMAGE_LOOKBACK、MAX_IMAGES、IMAGE_MAX_SIDE：看圖的範圍、張數、縮圖大小。

常用指令（在伺服器上）

sudo systemctl restart discord-bot   # 重開
sudo systemctl stop discord-bot      # 停
systemctl status discord-bot         # 狀態
journalctl -u discord-bot -f         # 即時 log

檔案說明

檔案	用途
bot.py	主程式：Discord client、對話流程、/總結 /重置 /歡迎 /自動回覆 等指令（systemd 只啟動它）
paths.py	執行時資料（data/）的路徑統一在這裡決定
dbot/core/	核心與管理：models.py（/模型 切換與用量統計）、aliases.py（中文指令的英文名字對照）、dmlog.py（/私訊紀錄）、channels.py（開頻道、臨時語音房）、vstatus.py（語音頻道狀態）、memberstatus.py、actstatus.py
dbot/ai/	給 AI 用的工具與生成：dbot/ai/divination.py＋dbot/ai/divination_data/（占卜與籤詩周易原文、塔羅牌圖）、dbot/ai/fortune.py＋svg2png.py（八字、星盤）、dbot/ai/drawimg.py（占卜與八字附圖）、extras.py（投票、抽籤、亂數、/狀態）、almanac.py、webimg.py、imagegen.py／sfxgen.py／videogen.py（畫圖、音效、影片）
dbot/money/	代幣與帳務：account.py（錢包存取、莊家＝大笨bot 的帳戶）、ledger.py（轉帳紀錄、帳本頻道、賭博彙整）、loans.py（借貸、還款、欠債扣款與催債）、minigames.py（老虎機、21 點）、horse_race.py（賽馬）、economy.py（斜線指令、給 Activity 用的內部 API，同時是對外窗口）、botwallet.py（大笨bot 自己的錢包工具：送錢、收還款、查帳）
dbot/music/	音樂播放：tracks.py（歌曲、搜尋、播放紀錄）、player.py（每個伺服器一個播放器）、panel.py（面板按鈕）、persist.py（重啟後接著播）、actions.py（點歌、電台、控制）、ai_tools.py（給 AI 的工具）、music.py（斜線指令與入口）
activity/	Discord Activity 小遊戲（前端 src/、後端 server/，見下方）
update-ytdlp.sh.example	每週自動更新 yt-dlp 的範例腳本（改路徑後用 crontab 跑）
.env	所有設定與金鑰都在這一個檔（只有自己讀得到，不要外傳）。INTERNAL_KEY（機器人與 Activity 後端的內部金鑰）第一次啟動會自動產生寫進來，不用自己設
.env.example	設定範本
system_prompt.txt	機器人的個性設定

邀請連結（含斜線指令權限，把 YOUR_CLIENT_ID 換成 Discord Developer Portal 的 Application ID；權限值可依需要調整）： https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&scope=bot+applications.commands&permissions=281475265154064

代幣系統（economy.py）

• 賺：每分鐘最多 +10 🪙——在文字頻道發言，或掛在語音頻道（沒關耳機、不在 AFK 頻道）。新玩家起始 200。資料在 wallet.json，每個伺服器各自一本帳。
• 賭博類斜線指令（/賽馬 /擲硬幣 /骰子 /老虎機 /21點）目前暫時下架，程式都還在：把 dbot/money/economy.py 的 GAMBLING_ENABLED 改成 True 再重啟機器人就會回來。同樣的遊戲仍可在 Discord Activity 裡玩（見下）。
• 指令：/規則(rules) /錢包(wallet) /排行(leaderboard) /轉帳(pay) /擲硬幣(coinflip) /骰子(dice) /老虎機(slots) /21點(blackjack)。
• 老虎機：單排 3 格用 🍒🍋💎 三種圖案，三個一樣 2~3.2 倍，兩個一樣退錢（理論回報率約 95%）；21 點 Blackjack 賠 1.5 倍；其餘賭局公平。
• 21 點開局先扣賭注，機器人若在牌局中重啟，該局賭注會損失。
• /發錢 對象 金額（give）：機器人擁有者專用，直接發代幣。
• /老虎機 賭注 [格數]：3 格（單排）、9 格（3×3，8 條連線）、16 格（4×4，整排整欄加兩條對角線共 10 條，4 格一樣才算，3 種圖案）。多格版可同時中很多條，3×3 只有 🍒🍋🔔💎 四種圖案（約 41% 的把數會賺錢，三個一樣 1.2~2.8 倍）。各版本理論回報率都調在約 95%。
• /賽馬 [等待秒數]（horserace）：開一場賽馬，6 匹馬從 10 匹固定名單隨機出賽，每匹有速度／耐力／爆發數值（存 horses.json）、當天狀態和歷史戰績（出賽、勝場、近 5 場名次）。賠率 = 0.95 ÷ 勝率，勝率由能力＋狀態算出，所以強馬賠少、冷門賠多。按按鈕選馬、填賭注；每人一注，截止後播放跑道動畫並結算。機器人在比賽中途重啟，這場的賭注會損失。

借貸、帳本與欠債

• /借錢 金額 理由：跟大笨bot 借，由它（AI）判斷要不要借，理由正當就盡量借。一般最多 10 萬，手上錢越多可借越多（上限 50 萬）。利息每天 50%、複利，欠款最多滾到本金的 10 倍就不再增加。/還錢 還款、/債務 看欠多少；直接在聊天跟大笨bot 說「我要還錢」也可以。
• 有欠債時，賺到的錢（發言、掛語音、遊戲贏的）會自動先扣 50% 還債，並掛上「欠債人」身分組，還清就拿掉；每天 20:00（台北時間）會在帳本頻道公告欠債名單和今天扣了多少。
• 大笨bot 也能用工具轉帳給人（單次最多 10 萬、每人每天最多 50 萬）、收還款、查轉帳紀錄，不用另外下指令。
• 帳本頻道：/設定帳本 頻道（需要「管理伺服器」權限）指定一個文字頻道，轉帳、借款、還款會逐筆發在那裡，賭博類輸贏每 10 分鐘彙整一則（同一個人合併）。/關閉帳本 關掉；沒設定就完全不發。紀錄本身仍存在 data/logs/transfers.json，大笨bot 查帳用。
• Activity 的賭博類遊戲（老虎機、21 點、賽馬、賭石…）以大笨bot 當莊家，輸贏進出它的帳戶；鍛造、種菜、抽卡的錢不經過莊家，也不記帳本。
• 多個伺服器：錢包、借貸、帳本都是每個伺服器各一份。Activity 從哪個伺服器開，就算那個伺服器的帳（抓不到伺服器 ID 時退回 .env 的 ACTIVITY_GUILD_ID）。

Discord Activity 小遊戲（activity/）

在語音頻道打開的內嵌遊戲視窗（Discord Embedded App SDK），WebSocket 即時同步。選單依序分五類：

• 鍛造：鍛劍、賣劍，以及神兵榜（見下方「鍛造」）。
• 種菜：個人農場，作物照真實時間長大，收成賣代幣，也能拜訪別人的農場偷菜（見下方「種菜」）。
• 上網找圖：對話說「找一張…的圖」，bot 會用 web_image 工具搜圖（ddgs）、下載並貼到頻道；接著說「改成水彩風」就會用 edit_image 改剛找到的圖（暫存 30 分鐘、每頻道最近 3 張）。也可以直接給圖片網址。只抓公網的圖（擋內網位址）、單張 12 MB 以內、一定要是真的圖片；非 NSFW 頻道只搜安全內容。
• 大圖：/畫圖、/智慧畫圖 有「大小」選項（一般／大圖長邊約 1900／超大圖長邊 2048，API 上限 2048），只有快速畫質支援；對話裡特別說要大張、高解析度時 bot 也會自己選。
• 畫圖：/畫圖 或對話說「畫一張…」，呼叫 LiteLLM 的圖片 API（draw-klein 快速／draw-qwen-fast 文字較乾淨／draw-flux 最高畫質約 10 分鐘），背景排隊、畫好自動貼回；內建過濾只擋涉及未成年人的性內容，不限張數（同時只畫一張、最多排 4 張），服務暫停時回覆「暫停中」。也能改圖（draw-klein，約 20 秒）：傳圖並說「把背景改成白天」、回覆一張圖說怎麼改，或用 /改圖（最多 3 張參考圖，第一張是主圖）。畫圖和改圖預設只能在年齡限制（NSFW）頻道使用（IMAGE_NSFW_ONLY=off 可關）。設定見 .env.example。
• 賭場：見下一點。
• 棋類（雙人）：五子棋、四連棋、黑白棋、西洋棋（王車易位、吃過路兵、升變）、象棋（將死／困斃；尚未做長將判和）。可對賭代幣。
  • 西洋棋、象棋可以跟電腦下：一個人入座、對手位空著時，棋盤下方有「🤖 加電腦對手」，可選新手／普通／高手／大師；開局前或打完後可移除或換難度，「再來一局」會黑白互換、電腦跟著換邊。有電腦的房間不能對賭（練習用）；真人全部離開電腦就跟著撤掉。
  • 電腦引擎在 activity/server/games/board/botengine.js（alpha-beta + 靜止搜尋，直接用 chess.js／xq.js 的規則，所以走法一定合法），搜尋放在 botworker.js 的獨立執行緒、由 bots.js 管理（兩條輪流，逾時就隨便走一步不卡局）。新手只看一步、常亂走；普通看兩步；高手限時 0.9 秒、大師限時 3 秒。
• 動作・競技：小朋友下樓梯（1–4 人）、彈珠台（單人）、皮卡丘排球 2P、小朋友齊打交（最多 8 人）。皮卡丘與 LF2 的原版素材/程式不在 repo 內（見 activity/.gitignore）。
• 影音：一起看影片（見下方）。
• 賭場內容：老虎機（3 格／3×3／4×4）、德州撲克、台灣麻將、日本麻將、橋牌、大老二、21 點、賽馬、骰子、擲硬幣，以及「旁觀大廳」。每個遊戲都有 📖 規則；老虎機、21 點、賽馬、骰子、擲硬幣可選練習幣或真代幣（賭注模式，背景會變紅色），右側有賭注紀錄；德州撲克、麻將、橋牌只用練習點數。
• 「👀 同房玩家」面板（老虎機、擲硬幣、骰子、21 點、賽馬、鍛造）：同一個 Activity 裡玩同一個遊戲的人，名字旁顯示他目前模式的餘額（灰色練習幣、黃色真代幣），下面是他最新一把（鍛造是最新的鍛造／賣劍結果，但鍛造不寫入賭注紀錄）。
• 觀戰：所有雙人桌預設先進觀眾席（可在座位列選擇上場／離座），旁觀大廳可同步看別人的房間。皮卡丘排球有音量滑桿。

德州撲克

2–6 人，練習籌碼（起始 1000），可按空位加電腦玩家，其他人旁觀。發牌與判定全在伺服器（activity/server/games/table/poker.js）。

• 邊池、最小加注、25 秒行動時限（桌面中央有倒數計時，輪到自己整個背景變藍）、攤牌時列出所有未棄牌者的底牌與牌型並停留 11 秒；Q-K-A-2-3 不算順子，A-2-3-4-5 與 10-J-Q-K-A 算。
• 加注可拉桿、½池／1池／全下，也可直接輸入自訂金額。牌用四色（黑桃黑、紅心紅、方塊藍、梅花綠）。
• 牌桌下方顯示「你目前最大」的牌型（例如「兩對 K 和 7」、「順子（到 5）」），組成這個牌型的牌加金框；只有伺服器傳給自己，別人和旁觀者看不到。蓋牌後顯示「你已蓋牌，原本是…」。
• 先入座再開打：有 2 人（含電腦）以上入座後，任一位入座的人按「▶ 開始」才發第一手，之後自動連續；人數掉到不足 2 人就停下，要再按開始。
• 可自訂名稱（記在瀏覽器）、🔄 重開（兩段確認，大家籌碼回起始值）。
• 盲注：預設固定 10/20；可在「⚙ 盲注設定」改起始小盲（大盲 = 2 倍），並可選擇「隨手數升盲」（每 N 手升一級，順序 …10→15→20→30→50→75→100→150→200…）。從下一手起生效。
• 電腦：用蒙地卡羅算勝率＋底池賠率決定動作，每個名字有不同個性（愛衝、穩健、老狐狸、跟注機、超緊、心機、全下狂、新手；畫面只顯示「？」）。加入順序隨機；電腦輸光會換成新電腦（盡量不重複）。

種菜（Activity 版）

獨立玩法（不是賭博，不寫入賭博紀錄）：每個身分一塊田（起始 6 塊，最多 24 塊），作物按真實時間生長，關掉 Activity 也照長，回來再收成。規則、數字、隨機全在 activity/server/games/life/farm.js，前端 src/farm.js 只畫田和送指令。

• 6 種作物：蘿蔔（3 分）、小白菜（10 分）、番茄（30 分）、玉米（1 小時）、南瓜（3 小時）、西瓜（8 小時），種子價 10～1500。每塊地一次的產量跟果樹差不多（蘿蔔、小白菜 20 個，番茄 24、玉米 26、南瓜 28、西瓜 30 個），單個賣價 = 種子價 × 1.25 ÷ 一半的數量（進位），和果樹一樣，所以就算被偷到只剩一半，主人這一輪賣掉也至少是種子價的 1.25 倍（沒被偷約 2.5 倍；蘿蔔因為單價要取整數，沒被偷是 4 倍），每個收成各自抽稀有變種：大顆（5%，賣 2 倍）、金色（1%，賣 5 倍）。算下來每塊地每小時約賺 430～800 代幣（蘿蔔最高）（要一直回來收才拿得到）；擴地要花代幣（500、1000、1500…），是額外的代幣出口。
• 7 種果樹（🍒櫻桃、🫐藍莓、⭐楊桃、🍑水蜜桃、🍇麝香葡萄、🥭愛文芒果、🥑酪梨）：樹苗只買一次（60～720 代幣），每隔一段時間（1～12 小時）結一次果，一次 20～30 個，收成後樹還在、重新計時；可以按 🪓 砍掉換地。任何人都能偷果樹，同一個人每棵樹每輪只能偷 1 個，很多人偷的話最多偷到剩一半（floor(產量/2)）。單價 = 樹苗價 × 1.25 ÷ 一半的數量（進位），所以就算被偷到只剩一半，主人這一輪賣掉也至少是樹苗價的 1.25 倍，不會虧本。連續偷同一種果實，主人的紀錄會合併成「×N」。
• 練習模式和真代幣模式（真代幣）各有一份農場：練習模式用農場自己的練習幣（起始 300）；真代幣模式買種子、擴地用機器人錢包扣款，賣菜補發，賣出中途伺服器重啟會在啟動時補發（farm.json 的 pend）。
• 拜訪與偷菜：「拜訪別人」列出同模式的農場；別人的菜成熟後 5 分鐘（主人優先）才能偷，每人每塊地（每棵樹）每輪只能偷 1 個，很多人偷的話最多偷到剩一半（floor(產量/2)，主人至少留一半），偷菜沒有每天次數上限；偷到的放進自己的倉庫，被偷的人會在「最近發生的事」看到。
• 存檔 data/records/activity/farm.json（含 Discord 使用者代號，已加入 .gitignore）。

圖創區（Activity 版）

大家用 AI 畫圖、分類收藏的頁面（活動選單「創作 → 圖創區」）。畫的圖只顯示在這個頁面，不會傳到 Discord，用跟機器人相同的畫圖模型（LiteLLM）。

• 每個 Discord 伺服器各有一份（分類、圖片、聊天紀錄）；同一個伺服器不同頻道開的 Activity 看到同一份。要先用 Discord 登入，伺服器端用登入時 Discord 回報的伺服器清單確認你在這個伺服器裡才給看、給畫。
• 預設 6 個分類（風景、人物、動物、奇幻、迷因、隨便畫），任何人都能用「＋」新增（最多 24 個）；空的分類可以刪。
• 三個分頁：🖼️ 圖庫（縮圖、點開看大圖與提示詞、能刪自己畫的、「用這個提示詞畫」）、✏️ 畫圖（形狀、大小、畫質、智慧擴寫與語言）、💬 大笨bot（在這個分類裡跟它說話，它會回話，也可以請它畫圖，畫好放進目前的分類）。
• 規則：一次畫一張、每人同時一張、全部最多排 IMAGE_MAX_QUEUE（預設 4）張；內容只擋「性內容 + 未成年人」；每個伺服器最多留 400 張（GALLERY_MAX_IMAGES），超過刪最舊的。圖片與縮圖存在 activity/server/gallery_data/（GALLERY_DIR 可改，已加入 .gitignore）。這個頁面不受「畫圖只能在 NSFW 頻道」的限制，因為它不是 Discord 頻道。
• 後端 activity/server/media/gallery.js，大笨bot說話走機器人內部 API POST /gallery/chat（bot.py 的 gallery_chat）；縮圖用 gallery_thumb.py（Pillow）。

鍛造（Activity 版）

獨立玩法（不是賭博，不寫入賭博紀錄、不列在旁觀大廳）：把一把劍鍛到最高 100 階（10 種材質 × 10 級，每一階都有程式畫的 SVG 外觀，越高階越華麗；神劍有旋轉光環）。每次鍛造要付鍛造費，有機率成功或劍碎（整把歸零）；每階有賣價，隨時可賣。

• 每個身分（練習幣／真代幣各自）最多同時擁有 10 把劍，上方 1~10 號格子可以切換要鍛造或賣掉哪一把；舊的單把存檔會自動放進 1 號。
• 鍛造身分組（真代幣模式）：手上每把劍所在區間各對應一個 Discord 身分組——30 鑄劍學徒、40 百煉匠、50 鑄劍師、60 名匠、70 劍宗、80 劍聖、90 劍仙、100 神鑄；持有幾個不同區間的劍就有幾個身分（同區間多把只算一個），劍碎或賣掉後沒有該區間的劍了，身分就移除；低於 30 階沒有身分。身分組由機器人建立（需要「管理身分組」權限，且機器人的身分組要排在這些之上），活動後端透過內部 API /forge/role 通知機器人：同一個人一次只送一個請求，送完再檢查劍有沒有又變（避免連續鍛造時舊請求晚到、劍碎了身分組卻沒拔），活動後端每次啟動也會把所有真代幣玩家的身分組重新對一次。
• 鍛造音效：用 Web Audio 即時合成（不需要音檔）——開始鍛造的兩下敲鐵砧、成功的鈴聲（階數越高越亮，50 階以上多一串閃光）、失敗的悶響加玻璃碎裂、卷軸擋下的閃光和弦、賣劍的金幣聲。畫面左上角的 🔊 可以開關，設定記在這個瀏覽器。
• 神兵榜：活動選單「鍛造」那一類裡有「🏆 神兵榜」，分真代幣模式（真代幣）和練習模式兩張榜，依每個人目前手上最高階的劍排名（前 30 名，每 10 秒更新），顯示名字、階數、劍名、擁有幾把、賣價。名字有登入 Discord 才知道，沒登入的練習玩家顯示「匿名鍛造師」。
• 防止破壞卷：劍 30 階以上才會出現，在鍛造按鈕上方勾選「防止破壞卷」，這次鍛造多付一份卷軸費，失敗時劍不會碎、留在原階（成功照樣升階）；可無限次使用，練習幣和真代幣都能用。卷軸價為「失敗平均損失×1.15」與「6×成功率×賣價增加−鍛造費」取大，所以每步都用卷軸衝的期望回收率只有約 1/6。價格表在 forge.js 的 SC。
• 數字在 activity/server/games/life/forge.js：第 1 階約 47、第 50 階約 1.26 萬、第 70 階約 10.8 萬、第 90 階約 121 萬、第 100 階約 448 萬（真代幣賣出沒有上限）；成功率前 49 階 97.3%→94.3%、50 階起 94%→91%；從零全部成功鍛到 100 階共花 100 萬，全部成功的機率：10 階約 74%、30 階約 33%、50 階約 12%、100 階約 0.23%。第 3 階起賣掉就賺；每一步的期望回收率：1~49 階約 103%、50 階以後約 101%，所以鍛造越久期望淨值越高（從零衝到 50 階再賣約 +530、70 階約 +950、100 階約 +2,600）。鍛造在活動選單最上面，獨立成一類。
• 練習幣與真代幣模式（真代幣）各存各的劍，存在 data/records/activity/forge.json（已 .gitignore）：練習模式用瀏覽器識別碼，真代幣模式用 Discord 身分。真代幣的費用和賣出走機器人錢包，中途重啟由 escrow 退回／補發；真代幣的鍛造費超過單筆上限時分筆扣款。練習模式起始 10 萬練習幣。

賭石（單人，練習幣／真代幣，3D 原石市場）

賭場分類。幾何在 activity/shared/stonegeo.js（伺服器和前端共用的純數學：石頭形狀、內部、切面格子），邏輯在 activity/server/games/casino/stone.js（隱藏的翡翠、外表線索、價格模型、收購商出價），金流在 server/casino.js（cstone 訊息：market／buy／cut(axis,pos)／sell／open，和 21 點一樣走託管，伺服器中途重啟會全額退回）。3D 畫面在 activity/src/stone3d.js（three.js，只在進賭石時才動態載入）。

• 市場全服共用：最多 100 顆，價格 30～4000，被買走就消失，每 15 秒補一顆（RESTOCK_MS）；市場只存在記憶體，重啟會重新擺貨。買的時候先從市場拿走再扣款，同時買同一顆只有一人成功，付款失敗會放回去。變動用 smkt 訊息即時推給所有人。
• 每顆石頭裡面是真的一個「翡翠體」（橢球，核心等級 q 最高、往外遞減，一條色根通到表面，外圍有霧層）加幾道裂（平面、有範圍）。外表線索由它推出來：場口（皮色、出翡翠機率）、松花（朝色根那側）、蟒帶、霧、癬、表面裂線、窗口（磨開一個點，看到那一點的內部）。都是機率性的線索，不保證。
• 價格：賣家看外表（用 bench/stfit.mjs 以模擬資料做 Poisson 迴歸得到的係數 BETA）估每公斤價，加價 12% 並加一點隨機誤差，所以看得準有機會撿便宜。整體價值／價格約 0.9。重量依價格範圍微調。
• 切石：沒有次數限制（最多 32 塊，MAX_PIECES）。石頭一開始是一塊盒子（座標軸對齊的 box），每一刀只切你選的那一塊：選軸（x／y／z）和位置（每 0.05，離該塊邊緣至少 0.1），付買價 3%，那塊變成兩塊（applyCut）。伺服器取該平面和翡翠體、裂的交集，回傳 48×48 格子（base64），前端畫成切面圖。切開後各塊保持分開（用裁切平面剪出並沿各刀法線稍微拉開，切面貼那張圖，見 stone3d.js 的 makeSplit）。
• 估價（pieceInfo／estBody）：把所有切面上翡翠格子的世界座標範圍合起來，得到翡翠體在 x／y／z 的範圍（只在一個平面看到的方向厚度未知，用已知方向的幾何平均補；某方向有一刀完全沒切到翡翠，就把範圍限在同一邊），當成一個橢球。每一塊的翡翠 = 橢球落在該塊盒子裡的比例 × VOLK × 重量 × 切面平均等級單價 × OFFER_K，另加殘值（買價 × 該塊占石頭的比例 × 4%）。每塊的收購價 = 已看到的部分（上面的橢球）+ 預期（hope）+ 殘值。預期 = 買家看外表（場口、松花、霧、窗口等，用 marketPerKg）對整顆的期望價值 × 該塊占比 × 係數：還沒看到翡翠時係數是 HOPE0=0.65、每切一刀沒看到翡翠就 ×HOPE_DECAY=0.65；看到翡翠後，離橢球越近的塊預期越高（最多 HOPE_NEAR=0.25）。這個預期和賣家的開價不同（賣家有加價和誤差），所以外表看得準、買得比預期便宜的人有機會賺。收購價只依「目前看得到的」，不會偷看隱藏的真值。
• 比重：顯示的重量 = 同樣大小的普通石頭重量 ×（1 + DENS_JADE(0.3) × 翡翠體積占比）× 石頭本身的密度差異（約 ±7%，所以重不一定有料）；價格仍用普通石頭的重量算，所以偏沉的是便宜貨。資訊裡給重量和體積（公升），另外給一個有誤差的「手感」（偏輕／普通／稍沉／很沉，pub.heft）。
• 擦皮／打燈：切之前才能做，點 3D 石頭表面取一個方向（stone3d.js 的 pickMode，射線打到石頭取 local 點再換成方向）。擦皮（rubAt，買價 1.5%，最多 4 處，買下後才能擦）看到該點內部（同窗口）；打燈（lightAt，標價 0.5%，每顆最多 6 處，市場就能打）沿著往內的方向找最近的翡翠，依深度和皮厚的隨機誤差給 0～3 級透光與光的顏色（沒翡翠也有約 8% 的假訊號：石英脈透白光）。標記存在伺服器（市場階段存在 ws.notes，買下後帶進 st.marks），畫在 3D 上。
• 塊大小：翡翠單價乘 sizeMult(kg)（0.1 公斤以下 ×0.5、1 公斤 ×1、5 公斤以上 ×1.5，取 log2 線性內插），估價和隱藏的真值都用；切碎翡翠會降價。
• 切損耗：每刀鋸縫吃掉 KERF(0.04) 厚度的翡翠（applyCut 扣 hid.vol，估價也扣）；切面上翡翠與裂同時出現（裂格數 ≥ 3）時有機率「崩」（機率 = 裂格數 × 0.06，最多 60%）：翡翠體積 ×0.75、裂折損 ×0.8，並在切面註明，估價也跟著降。
• 賣出：可以賣單塊或全部賣出（sell，piece = 編號或 "all"），每次賣出就結算那些塊；全部賣完後揭曉隱藏的翡翠（等級、體積、整顆真值、最大切面）。斷線自動賣出剩下的塊；真代幣的託管金額會隨已賣出的收入遞減。
• 簡化：場口只是一個調整出翡翠機率與等級的參數，不是真正的地質；價格和等級單位是遊戲數字，不是真實行情。調數字改 stone.js 的 TIERS／CUT_FEE／YIELD／OFFER_K／VOLK／SITES（數值還沒重新平衡，先把玩法做對）。

阿瓦隆（5～10 人，沒有計時）

Activity「桌遊・派對」分類，每個 instance 一桌，不足人數由電腦補，不用點數。伺服器 activity/server/games/table/avalon.js，畫面 activity/src/avalon.js。

• 5～10 人（好人：壞人 = 3:2、4:2、4:3、5:3、6:3、6:4），任務人數照標準表，7 人以上第 4 次任務要 2 張失敗。梅林、刺客必有；可選派西維爾＋莫甘娜、莫德雷德、奧伯倫。
• 流程：隊長選隊 → 全員同時投票（過半通過）→ 隊員出成功／失敗 → 3 次成功後刺客刺梅林。連續 5 次否決壞人贏。
• 沒有計時：投票結果、任務結果要真人按「下一步」；電腦和離線玩家自動行動，全場沒有真人在線時自動往下。
• 身分只在該玩家的連線畫面送出，旁觀者看不到；結束才公開全部身分。

大老二（台灣玩法）

賭場裡的 4 人牌桌、練習點數，每個 Activity instance 一桌，缺人由電腦補。伺服器 activity/server/games/table/bigtwo.js，牌型判斷在 activity/shared/bigtwo_rules.js（前後端共用），畫面 activity/src/bigtwo.js（沿用橋牌牌桌的 CSS）。

• 大小 3 < … < K < A < 2，同點比花色 ♣ < ♦ < ♥ < ♠。牌型：單張、對子、五張（順子 < 同花 < 葫蘆 < 鐵支 < 同花順；順子不繞圈）。
• 每一手都是 ♣3 的人先出且必含 ♣3（不論上一手誰贏）。壓牌要同張數更大，或過；三家都過則最後出牌者重新自由出。
• 結算：其他人付「剩餘張數 × 每張點數」（10 張以上雙倍、13 張三倍）給贏家；長度 1／3／5／10 手。時限 30 秒，超時由電腦代打。

橋牌（台灣簡易版）

賭場裡的 4 人牌桌、練習點數（不碰代幣），每個 Activity instance 一桌。伺服器 activity/server/games/table/bridge.js，前端 activity/src/bridge.js。

• 南北（座位 0、2）對東西（1、3），順時針。叫牌 1～7 線位，♣<♦<♥<♠<無王，連續三家 Pass 結束、四家都 Pass 重新發牌；大牌點 4 點以下（A4 K3 Q2 J1）的人叫牌結束前可以要求重洗（電腦一定喊）；最後叫的人是莊家，莊家方要 6＋N 墩、防守方要 8－N 墩，先達成的一方贏（剩下的牌不打）。沒有夢家，由莊家的下家先出，必須跟花色。
• 結算：輸的那隊每人付「線位 × 每線位點數」給贏的那隊每人；每人 10,000 點起，4／8／16 手。
• 電腦個性（bridge.js 的 PERSONA，跟著名字走，名字旁顯示標籤）：愛搶叫、穩健、老狐狸、愛叫無王、保守、挺同伴、新手（偶爾亂出）、老派高花、高手、莽夫，調整叫牌膽量、支持同伴、無王門檻、改叫意願。「高手」橋神另外用抽樣模擬：把看不到的牌照已知缺門隨機發給另外三家，只留跟實際叫牌最吻合的幾組，叫牌時把每個選項（Pass 或各種叫品）的後續叫牌和打牌模擬完、出牌時每張候選牌都模擬打完，選得分／達成機率最高的。複式比較（同一副牌換人打）對上標準電腦平均每手多約 +19 點（每線位 100 點時）。測試工具：bridge.js 的 _playDeal、_deal。
• 電腦：叫牌用大牌點＋長度點估自己和同伴（從同伴叫過的線位猜）能吃幾墩；出牌會清王、先出確定最大的牌、二家低三家高、同伴贏就墊小牌、沒花色就用最小能贏的王牌王吃。
• 畫面：叫牌時有 1♣～7無王 的按鈕（比目前低的變灰）和叫牌紀錄表，手牌上方顯示自己的大牌點，符合條件才出現「🔄 要求重洗」；出牌時只有能出的牌會亮，吃下一墩的牌會發光，桌面角落有「上一墩」。
• 時限 25 秒（超時由電腦代叫／代出），每墩打完停 1.3 秒讓大家看清楚。離座或斷線由電腦代打，可以接手。

麻將（台灣 16 張／日本立直）

賭場裡兩張獨立的牌桌，4 人一桌、練習點數（不碰代幣），每個 Activity instance 各一桌。流程共用 activity/server/games/mahjong/mahjong.js，牌的編碼／向聽數／拆牌在 mjcore.js，計分在 mjtw.js（台數）和 mjjp.js（役、符、翻、點數）；前端是 activity/src/mahjong.js。

• 先入座、可按空位「＋電腦」，任一位入座的人按「▶ 開始」開打（空位自動補電腦）。打到一半離座或斷線由電腦代打；沒入座的人可以點電腦的位置接手（保留點數）。所有真人都走了牌桌就重置。
• 台灣麻將：16 張、花牌自動補花、吃碰槓、搶槓、0 台可胡；底／台可選（30/10～1000/300），一圈或一將。莊家 1 台、連 N 拉 N 加 2N 台（莊家胡或莊家付錢時才算）；留 16 張流局、莊家連莊。八張花直接八仙過海。
• 日本麻將：13 張，一定要有役才能胡；立直（含雙立直、一發、裏寶牌）、槓寶牌、嶺上、振聽（含同巡與立直後振聽）、流局聽牌料、本場、立直棒；東風戰或半莊戰，被擊飛就結束。有赤寶牌（萬筒條的 5 各一張紅色，每張 +1 翻，開局可關；牌用 100+牌種 表示，mjcore.kindOf 換回牌種）、雙倍役滿不另計、一炮多響只算順位最近的一家。
• 電腦個性（mahjong.js 的 PERSONA，跟著名字走，畫面上不顯示）：速攻、穩健、老狐狸、愛吃碰、鐵壁、做大牌（清一色／混一色）、新手（會打錯）、門清派（只胡不叫）、高手、莽夫，調整吃碰積極度、立直機率、何時開始打安全牌、做色傾向。「高手」雀神另有一套判斷：日麻會讀牌防守（現物、立直後別人打過的牌、筋、壁、字牌見張算放槍危險度，依向聽數決定要衝還是棄和；有人立直、叫完還沒聽牌就不叫），並留寶牌、赤五、役牌對子；台麻實測防守反而吃虧，所以只保留手牌價值判斷。對上標準電腦：日麻東風戰平均名次約 2.3、台麻約 2.4（四人平均 2.5）。_simGame 可以指定四家電腦。
• 標準電腦的基本打法：用向聽數＋進張數決定打哪張；日麻聽牌時依個性決定要不要立直、只在有役牌時才副露，有人立直時依個性改打現物；台麻能讓向聽數變少就吃碰。
• 雀魂式自動功能（手牌下方四個開關，亮綠色是開）：自動理牌（預設開，記在瀏覽器；關掉後新牌放最右邊，可以用滑鼠拖曳手牌排順序）、自動和牌（能自摸或榮和就和）、不吃碰槓（別人打牌自動跳過，能和牌時還是會問）、自動摸切（摸到就打掉，能自摸時會停下來）；後三個只在這次有效，重新整理就關掉。
• 滑鼠指到手牌（手機長按）會顯示這種牌場上看得到幾張、還剩幾張沒出現、誰打的、誰副露了，桌上同樣的牌用藍框標出來。日麻的寶牌會金色發光，赤寶牌是紅框。
• 音效（activity/src/mjsfx.js，Web Audio 即時合成、不用音檔）：開局洗牌、打牌、自己摸牌、吃碰、槓、立直、補花、輪到自己、可以叫牌、胡牌（自己胡更熱鬧）、放槍、流局；標題列 🔊 可以關，記在瀏覽器。
• 輪到自己打牌時整個背景變藍色，可以吃碰槓胡時變橘色。
• 時限：輪到自己 20 秒（超時打出摸到的牌，能自摸就自摸），叫牌 9 秒（超時算過）。
• 測試：mahjong.js 有 _simGame(rule, cfg, greedy) 可以讓 4 個電腦直接打完一整場（greedy 會什麼都叫、能槓就槓），用來檢查點數守恆和罕見流程。

一起看影片（Activity）

遊戲間「🎬 影音」裡的「📺 一起看影片」：同一個 Activity 的人同步看 YouTube。後端 activity/server/media/theater.js，前端 activity/src/theater.js。

• 貼 YouTube 連結（watch、youtu.be、shorts 都可以）或直接打關鍵字（搜尋第一個結果）加入清單；清單可移除、移到下一部、跳過。直播和超過 3 小時的影片不收。
• 伺服器用 yt-dlp 把影片下載成 H.264＋AAC 的 mp4（主要畫質是影片有的最高畫質，最多 1080p；video_cache/，已 .gitignore，超過 30 GB 自動刪最久沒看的），從 /api/tv/<影片ID>.mp4（720p 以外是 <影片ID>.q<畫質>.mp4）串流（支援 Range，可以拖進度）。整部下載好才開始播，清單接下來兩部會先下載。
• 播放／暫停／拖進度／換片由伺服器統一記錄，每 5 秒推一次狀態，前端誤差超過 1～1.5 秒就自動跳過去校正。音量、靜音、全螢幕各自調。
• 操作：點畫面中間＝播放／暫停（大家一起），連點兩下＝全螢幕。控制列分兩排，第一排是整條進度條，第二排是播放、跳過、靜音、音量、時間，右邊是畫質、速度、字幕、🌐、全螢幕。音量滑桿用三次方曲線（拉到 20% 實際約 1%，小聲比較好調），滑鼠放在滑桿上可以用滾輪每格調 2%，記在瀏覽器。
• 畫質每個人自己選（360p／480p／720p／1080p，依影片有的 H.264 畫質）：預設 1080p，影片沒有 1080p 就自動往下用它最高的畫質，房間先下載這個主要畫質；有人選別的畫質時伺服器才另外下載（<影片ID>.q1080.mp4 這類檔名，也算在快取上限裡），準備好就從同一秒切過去，選擇記在瀏覽器。1080p 每人約 4～8 Mbps。
• 播放速度（0.5～2 倍）大家一起變；字幕每個人自己選：只用 YouTube 影片本身的字幕（上傳者提供的＋YouTube 依原語言自動產生的），第一次選時才下載（/api/tv/sub/<影片ID>/<語言>.vtt，還在下載時回 202、前端每 3 秒再問），簡體中文字幕會在本機用 OpenCC 轉成繁體。不用 YouTube 的「自動翻譯」字幕（常被限流 429），也不用 AI 翻譯。
• 全螢幕：先試瀏覽器原生全螢幕，不行就鋪滿活動視窗（控制列 2.5 秒自動隱藏、雙擊或 Esc 切換）。在 Discord 裡另有 🌐「在瀏覽器開啟」，用 openExternalLink 開 …/wordle/?room=<同一個房間>&g=theater，跟 Discord 裡的人同步，瀏覽器可以真正全螢幕。網址帶 ?g=遊戲代號 會直接開那個遊戲。
• 瀏覽器規定沒按過畫面不能自動放聲音，被擋時會出現「🔊 點一下開始播放」。
• 每個觀眾都是從家裡的伺服器拿影片（1080p 約 4～8 Mbps／人、720p 約 2～4 Mbps／人），人多時注意家裡網路的上傳頻寬。

賽馬（Activity 版）

所有人共用同一場；伺服器決定名次、每人畫面一致。10 匹馬的能力值、出賽、勝場、近 5 場存在 data/records/activity/horses.json（所有人共用，已 .gitignore；初始以 1000 場模擬當基本資料）。每匹有跑法（先行／逃馬／追込／穩定／爆發）和毛色，會影響動畫。下注頁每匹馬顯示戰鬥卡：能力雷達圖、歷史戰績、近 5 場、當天狀態、倍率；不顯示本場勝率，要自己判斷。

部署

• 前端：activity/（Vite 打包，npm install && npm run build，產物在 activity/dist/；前端改動只需重新 build）。把 VITE_CLIENT_ID（Application ID，不是密鑰）和 DISCORD_CLIENT_SECRET（真代幣模式登入用）都寫進專案根目錄的 .env，bot、前端、後端共用同一個檔。
• 後端：activity/server/（Node + ws，預設 127.0.0.1:3101，用 node server.js 或 systemd 常駐；後端改動需重啟）。賭場／撲克／賽馬紀錄等執行時資料（horses.json、casino_log.json、escrow.json…）都在這裡，不進 git。
• 對外：需要公開 HTTPS 網址。Developer Portal → Activities → URL Mappings 把 / 指到你放 dist/ 的目錄；WebSocket 路徑 /ws 要轉到後端（Apache 用 ProxyPass /你的路徑/ws http://127.0.0.1:3101/ws upgrade=websocket）。
• 機器人端：Discord 開啟 Activities 後會自動建立入口指令 /launch；整批同步指令時必須把它一起帶上（bot.py 的 sync_commands 已處理）。
• 沒發佈的 Activity 只有擁有者和開發團隊成員能開。

執行時資料放哪裡

機器人和 Activity 產生的資料都集中在專案根目錄的 data/（不進 git）：

• data/records/：存檔與狀態——錢包、賽馬能力、機器人設定、音樂佇列、私訊名單；activity/ 子資料夾是農場、鍛造、抽卡、賭場託管、圖創區的圖。
• data/logs/：事件流水與紀錄——轉帳帳本（transfers.json）、機器人送錢紀錄、動作紀錄、播放紀錄；activity/ 子資料夾是賭場流水。
• 路徑統一由 paths.py（機器人）和 activity/server/paths.js（Activity）決定。從舊版升級時，第一次啟動會自動把舊位置的檔案搬進來。

程式資料夾結構

bot.py            機器人入口（systemd 只啟動它）
paths.py          執行時資料路徑
dbot/core/        設定（config.py）、核心與管理      dbot/ai/     AI 工具、模型呼叫、畫圖指令
dbot/money/       代幣與帳務（account／ledger／loans／小遊戲）      dbot/music/  音樂（tracks／player／panel…）
data/             執行時資料（records＝存檔、logs＝流水），不進 git
activity/server/
  server.js bet.js wager.js paths.js   伺服器入口與共用的押注／託管／路徑
  games/board/    棋類與電腦引擎    games/table/  牌桌與桌遊
  games/mahjong/  麻將              games/action/ 動作遊戲（下樓梯、排球物理）
  games/casino/   賭場（含賭石、老虎機）  games/life/ 經營（種菜、鍛造、抽卡）
  media/          一起看影片、圖創區