設定精靈

bun run setup 是推薦的本機 Bun 自架路徑。該指令會在載入精靈之前先從 bun.lock 安裝相依套件，包含在全新複製的環境中。精靈會建立你的 .env、產生 CRYPTO_SECRET、詢問你的 Discord bot 權杖並設定 PostgreSQL。重複執行也很安全；既有的 .env 值會保留，除非你選擇重新設定它們。

事前準備

Bun：用來執行 bot 與精靈本身。
Discord bot 權杖：已啟用 GuildMembers、MessageContent 與 GuildPresences 特權意圖。
已安裝 PostgreSQL：TomoriBot 把所有東西都存放在 PostgreSQL 中。你不需要手動設定，精靈會幫你處理：如果你已經安裝了 PostgreSQL 它就會直接使用，沒有的話會在 Docker 中為你執行一個。只要確保在開始前兩者之一已安裝好即可。TomoriBot 會在首次啟動時自動初始化其結構描述、種子資料、遷移、pgcrypto 與 RAG 結構描述。

取得程式碼

git clone https://github.com/Bredrumb/TomoriBot.git
cd TomoriBot

執行精靈

使用以下指令執行設定精靈：

bun run setup

執行指令後，你會從兩條路徑中選擇一條：

路徑	何時使用	功能說明
完整安裝	你想要推薦的設定加上輕量的額外項目。	先執行基礎安裝，接著嘗試底下的額外項目。
基礎安裝	你只需要最低限度可運作的 bot。	建立/設定 `.env`、Discord 權杖、PostgreSQL 與相依套件。

完整安裝的額外項目

完整安裝會先執行基礎安裝，接著嘗試安裝底下的額外項目。若有任何一項失敗，它會印出手動完成的指令或指南，並繼續進行：

額外項目	用途
`pgvector`	文件/RAG 記憶的向量搜尋。
`pg_cron`	選用的排程冷卻/提醒資料列清理。
Tokenizer 資產	本機 tokenizer 資產，用於 NovelAI 文字生成與依模型調整的 logit 偏權值。

若要手動安裝其中任何一項，請參閱手動設定的額外項目。

設定完成後

bun run dev                          # 僅 bot
bun run launch --searxng --crawl4ai  # bot + 本機伺服器（請參閱 bun run launch --help）

當 bot 上線後，在 Discord 中執行 /setup。它會引導你連接 AI 供應商或你的自訂端點。

更新

使用備份優先的更新指令：bun run update

這會執行 bun run backup，接著執行 git pull --rebase --autostash，再執行 bun install --frozen-lockfile。若你從 dist/ 執行請加上 --build，若是 Compose 部署請加上 --docker。完整詳細資訊請參閱維護與備份頁面。