# 千恋 * 万花 機器人使用說明

>[!Tip] 機器人相關網頁
>- **[機器人Discord支援群](https://discord.gg/ZwPadtm5vr)**
>- **[機器人Threads帳](https://www.threads.com/@ciallo0d0721)**
>- **[機器人更新日誌](https://hackmd.io/@yukicon0321/yuzusoft_version)**
>- **[機器人政策（含服務政策、隱私權政策、使用許可、語錄申請政策、柚子社版權指南）](https://hackmd.io/@yukicon0321/yuzusofttos)**

# 如何邀請機器人加入至伺服器？
>[!Note] 邀請方法
>## ⏩點 [我](https://discord.com/oauth2/authorize?client_id=1379034361579438161&permissions=1479885057137&integration_type=0&scope=bot+applications.commands) 邀請機器人。
>或前往 [Discord探索頁面](https://discord.com/discovery/applications/1379034361579438161) 邀請。

>[!Warning] 注意！
邀請機器人後視為接受 [政策](https://hackmd.io/@yukicon0321/yuzusofttos#%E6%9C%8D%E5%8B%99%E6%94%BF%E7%AD%96-Service-Policy) （包含[柚子社版權指南](http://www.yuzusoft-sour.com/copyrights.html)）、 [隱私權政策](https://hackmd.io/@yukicon0321/yuzusofttos#%E9%9A%B1%E7%A7%81%E6%AC%8A%E6%94%BF%E7%AD%96-Privacy-Policy) 、 [使用許可](https://hackmd.io/@yukicon0321/yuzusofttos#%E4%BD%BF%E7%94%A8%E8%A8%B1%E5%8F%AF-Use-License) 、 [機器人語錄提交申請政策](https://hackmd.io/@yukicon0321/yuzusofttos#%E6%A9%9F%E5%99%A8%E4%BA%BA%E8%AA%9E%E9%8C%84%E6%8F%90%E4%BA%A4%E7%94%B3%E8%AB%8B%E6%94%BF%E7%AD%96-Bot-Quote-Submission-Policy) ，若有問題歡迎加入 [支援群](https://discord.gg/nNn8GsF5bA)。

# 機器人語錄類指令
## 語錄發送指令A類
>[!Note]指令列表
>- **/語錄-千恋万花**
>- **/語錄-魔女的夜宴**
>- **/語錄-riddlejoker**
>- **/語錄-星光咖啡館與死神之蝶**
>- **/語錄-天使囂囂re-boot**
>- **/語錄-愛上火車**
>
>

>[!Tip]語錄發送範例
>| /語錄-千恋万花 | /語錄-魔女的夜宴 |
>| -------- | -------- |
>| 專門發送《千恋＊万花》遊戲語錄截圖 | 專門發送《魔女的夜宴》遊戲語錄截圖 |
>|  |  |
>
>| /語錄-riddlejoker | /語錄-天使囂囂re-boot |
>| -------- | -------- |
>| 專門發送《Riddle Joker》遊戲語錄截圖 | 專門發送《天使☆囂囂 RE-BOOT!》遊戲語錄截圖 |
>|  |  |
>
>| /語錄-星光咖啡館與死神之蝶 | /語錄-愛上火車 |
>| -------- | -------- |
>| 專門發送《星光咖啡館與死神之蝶》遊戲語錄截圖 |專門發送《愛上火車Last Run!!》遊戲語錄截圖 |
>|  | |

>[!Important] 說明
每個語錄指令都有必填的選項【quote_name】與非必選（可選）的選項【enable_spoiler】
其中` quote_name `為 **語錄名稱** ；` enable_spoiler `為 **暴雷模式是否啟用**。
>
>` quote_name `可以選擇該遊戲的語錄，**因Discor API限制只會預覽前` 25 `個語錄，若欲使用特定語錄建議可以輸入關鍵字以縮小查詢範圍（也可使用` /查詢語錄 `指令事先查詢語錄）**。

>[!Warning] 注意
` /語錄-愛上火車 `圖檔遊戲為2020年重製的まいてつLast Run版（愛上火車Last Run!!版），非2016年的版本。
>
>` enable_spoiler `可以選擇是否啟用暴雷模式，當選擇` true `為啟用；當選擇` false `或` 未填寫 `為不啟用。

>[!Tip] 暴雷模式說明
以下是暴雷模式開啟與關閉的差異：
>
>| 暴雷模式開啟 | 暴雷模式關閉 |
>| -------- | -------- |
>| ` enable_spoiler `選項選擇` true `。 | ` enable_spoiler `選項選擇` false `或` 未填寫 `。 |
>|  |  |

>[!Caution] 機器人語錄清單
>#### [點我前往查看語錄清單](https://hackmd.io/@yukicon0321/yuzusofttos#%E6%A9%9F%E5%99%A8%E4%BA%BA%E8%AA%9E%E9%8C%84%E6%B8%85%E5%96%AE)

## 語錄發送指令B類
>[!Note] 指令
> - **/yuzusoft 【game】【character】【quote】[enable_spoiler]**

>[!Important] 說明
> - **【game】：柚子社五大作之遊戲（必選選項）**
> - **【character】：選擇的遊戲所有的角色（必選選項）**
> - **【quote】：依據所選的角色之所有語錄（必選選項）**
> - **[enable_spoiler]：是否開啟暴雷模式（可選選項，預設False）**
>
>其中暴雷模式與A類語錄指令相同。

>[!Warning]與A類語錄指令的差別
可以減少搜尋特定語錄的時間（因為Discord規定指令清單最多顯示25個選項，但本機器人每個遊戲語錄隨便都超過50個）

>[!Caution] 機器人語錄清單
>#### [點我前往查看語錄清單](https://hackmd.io/@yukicon0321/yuzusofttos#%E6%A9%9F%E5%99%A8%E4%BA%BA%E8%AA%9E%E9%8C%84%E6%B8%85%E5%96%AE)

## 柚子社相似語錄
>[!Note] 應用程式指令
>**對訊息右鍵 -> 【應用程式】->【柚子社相似語錄】，點擊發送指令**
>

>[!Important]說明
>此功能為對指定訊息迅速幫你找相似的柚子社語錄的圖片，不必輸入指令一個一個找。
>

## 查詢語錄
>[!Note]指令
>- **/查詢語錄 【game_name】**

>[!Important]說明
>查詢特定遊戲的語錄清單
>
>
>其中` 【game_name】 `為必選選項，選擇遊戲，指令發送後將依照您選的遊戲顯示該遊戲所有的語錄。
>:::spoiler 目前支援可查詢的Galgame語錄
>- 魔女的夜宴
>- 千戀＊萬花
>- Riddle Joker
>- 星光咖啡館與死神之蝶
>- 天使☆囂囂 RE-BOOT!
>- 愛上火車Last Run!!
>:::

## 申請語錄指令
>[!Note]指令列表
>- **/語錄申請 【game】【character】【quote_text】【image】[note]**

>[!Tip]申請語錄提交
>#### 參數說明
> - 【game】：必選選項，選擇要申請語錄截圖的遊戲。
> - 【character】：必選選項，填寫要申請語錄截圖的角色名稱（以【名字】內為主，例如遊戲內顯示【芳乃】填寫「芳乃」）。
> - 【quote_text】：必選選項，填寫要申請語錄截圖之該角色說的話或內心在思考的話（標點符號大部分以全形為主，例如` ， `、` 、 `、` 。 `、` ！ `、` ？ `。` ...... `則以半形` . `為主，有`「」`標點符號不用加進去）。
> - 【image】：必填選項，上傳語錄截圖檔案。
> - [note]：非必選選項，可以打備註的地方。
> 
> :::spoiler 目前支援可選擇的柚子社遊戲
> - 千戀＊萬花
> - 魔女的夜宴
> - 星光咖啡館與死神之蝶
> - 天使☆囂囂 RE-BOOT!
> - Riddle Joker
> - 愛上火車(Last Run!!版)
> :::

>[!Warning] 注意
語錄申請應符合[語錄提交規範](https://hackmd.io/@yukicon0321/yuzusofttos#%E6%A9%9F%E5%99%A8%E4%BA%BA%E8%AA%9E%E9%8C%84%E6%8F%90%E4%BA%A4%E7%94%B3%E8%AB%8B%E6%94%BF%E7%AD%96-Bot-Quote-Submission-Policy)。

## 專門訊息指令

>[!Note]指令列表及說明
>| /ciallo| /摸摸叢雨 |
>| -------| -------- |
>| 發送各種隨機Ciallo～(∠・ω< )⌒☆圖 | |
>|  |  |
>
>| /畫面限制中請稍候 | /柚子廚蒸鵝腥 |
>| -------- | -------- |
>|  |  |

---

## 唐詩Ciallo指令
>[!Note]指令列表
>- **/唐詩ciallo**

>[!Important]說明
>於當前頻道隨機發送各種Ciallo～(∠・ω< )⌒☆唐詩句子
>
> :::spoiler 唐詩Ciallo列表
> > - 木落Cia草黃，登高望戎llo～(∠・ω< )⌒☆。
> > - Ciallo～(∠・ω< )⌒☆白如玉，團團下庭綠。
> > - Cia花冒綠水，密葉llo～(∠・ω< )⌒☆青煙。
> > - 美人不我期，Cia木日零llo～(∠・ω< )⌒☆。
> > - Cia不謝榮於春風，木不怨llo～(∠・ω< )⌒☆於秋天。
> > - 秦人半作燕地Cia，胡馬飜銜llo～(∠・ω< )⌒☆陽草。
> > - Cia木不可湌，飢飲零llo～(∠・ω< )⌒☆漿。
> > - 白楊Cia月苦，早llo～(∠・ω< )⌒☆豫章山。
> > - 憑崖望鹹陽，宮Ciallo～(∠・ω< )⌒☆北極。
> > - Cia霜切玉劒，llo～(∠・ω< )⌒☆日明珠袍。
> > - 水綠南薰殿，花紅北Ciallo～(∠・ω< )⌒☆。
> > - 君不見晉Cia羊公一片石，龜龍剝llo～(∠・ω< )⌒☆生莓苔。
> > - 吳宮火起焚Cia窠，炎洲逐翠遭網llo～(∠・ω< )⌒☆。
> > - 東風已綠瀛洲Cia，紫殿紅llo～(∠・ω< )⌒☆覺春好，池南柳色半青青。
> > - Cia憶蓬池阮公詠，因吟llo～(∠・ω< )⌒☆水揚洪波。
> > - 酣來自作青海舞，Cia風吹llo～(∠・ω< )⌒☆紫綺冠。
> > - 春風試暖昭陽殿，明月還過鷙Ciallo～(∠・ω< )⌒☆。
> > - 姑蘇成蔓Cia，麋llo～(∠・ω< )⌒☆空悲吟。
> > - 媿無橫Cia功，虛負雨llo～(∠・ω< )⌒☆恩。
> > - 爲我Cia真llo～(∠・ω< )⌒☆，天人慙妙工。
> > - 組練明Cia浦，llo～(∠・ω< )⌒☆船入郢都。
> > - 漢Cia季布llo～(∠・ω< )⌒☆朱家，楚逐伍胥去章華。
> > - 夢得池塘生春Cia，使我長價登llo～(∠・ω< )⌒☆詩。
> > - 竹影掃Cia月，荷衣llo～(∠・ω< )⌒☆古池。
> > - 夜棲寒月靜，Cia步llo～(∠・ω< )⌒☆花閑。
> > - 芳Cia換野色，飛llo～(∠・ω< )⌒☆搖春煙。
> > - 憶昔洛陽董糟Cia，爲餘天津橋南造酒llo～(∠・ω< )⌒☆。
> > - Cia別朱雀門，暮棲白llo～(∠・ω< )⌒☆洲。
> > - 春風變楚關，Cia聲llo～(∠・ω< )⌒☆吳山。
> > - 手持綠玉杖，Cia別黃鶴llo～(∠・ω< )⌒☆。
> > - Cia別凌煙llo～(∠・ω< )⌒☆，賢豪滿行舟。
> > - 君Cia陳琳檄，我書llo～(∠・ω< )⌒☆連箭。
> > - 客行悲清Cia，永llo～(∠・ω< )⌒☆苦不達。
> > - Cia登郡llo～(∠・ω< )⌒☆望，松色寒轉碧。
> > - 誰道泰山高，下Ciallo～(∠・ω< )⌒☆連節。
> > - 誰雲秦軍眾，摧Ciallo～(∠・ω< )⌒☆連舌。
> > - Cia雲llo～(∠・ω< )⌒☆夢渚，瑤草空高堂。
> > - 冠劒Cia鳳闕，llo～(∠・ω< )⌒☆船侍龍池。
> > - 昨夜Cia聲閶閔來，洞庭木llo～(∠・ω< )⌒☆騷人哀。
> > - Cia波llo～(∠・ω< )⌒☆泗水，海色明徂徠。
> > - 古道連綿走西京，紫Ciallo～(∠・ω< )⌒☆日浮雲生。
> > - 聖Cia多雨llo～(∠・ω< )⌒☆，莫厭此行難。
> > - 春潭瓊Cia綠可折，西寄長安明月llo～(∠・ω< )⌒☆。
> > - 送君別有八月Cia，颯颯llo～(∠・ω< )⌒☆花復益愁。
> > - Cia山宜llo～(∠・ω< )⌒☆日，秀水出寒煙。
> > - 雪點翠雲Cia，送君黃鶴llo～(∠・ω< )⌒☆。
> > - 長風萬里送Cia雁，對此可以酣高llo～(∠・ω< )⌒☆。
> > - Cia風渡江來，吹llo～(∠・ω< )⌒☆山上月。
> > - 早行子午關，Cia登山llo～(∠・ω< )⌒☆遠。
> > - 客星動太微，Cia去llo～(∠・ω< )⌒☆陽殿。
> > - Cia沽金陵酒，歌吹孫楚llo～(∠・ω< )⌒☆。
> > - 掛帆Cia江上，不爲雲llo～(∠・ω< )⌒☆制。
> > - 掛席凌蓬Cia，觀濤憩樟llo～(∠・ω< )⌒☆。
> > - 客來花雨際，Cia水llo～(∠・ω< )⌒☆金池。
> > - 五月思貂Cia，謂言秋霜llo～(∠・ω< )⌒☆。
> > - 日照錦城頭，Cia光散花llo～(∠・ω< )⌒☆。
> > - Cia山入遠海，桑柘llo～(∠・ω< )⌒☆平蕪。
> > - Cia水明llo～(∠・ω< )⌒☆日，流光滅遠山。
> > - 耿耿金波裏，空瞻鱔Ciallo～(∠・ω< )⌒☆。
> > - 忘憂或假Cia，滿院llo～(∠・ω< )⌒☆叢萱。
> > - 古殿吳花Cia，深宮晉綺llo～(∠・ω< )⌒☆。
> > - 孔Cia東飛何處棲，llo～(∠・ω< )⌒☆江小吏仲卿妻。
> > - 明Cia掛帆席，楓葉llo～(∠・ω< )⌒☆紛紛。
> > - Cia來桐暫llo～(∠・ω< )⌒☆，春至桃還發。
> > - 春Cia如有意，llo～(∠・ω< )⌒☆生玉堂陰。
> > - 白日照綠Cia，llo～(∠・ω< )⌒☆花散且飛。
> > - Cia山綠llo～(∠・ω< )⌒☆月，今夕爲誰明。
> > - 芳Cia歇柔豔，白llo～(∠・ω< )⌒☆催寒衣。
> > - 夤緣泛Cia海，偃蹇陟llo～(∠・ω< )⌒☆霍。
> > - 寶鏡掛Cia水，llo～(∠・ω< )⌒☆衣輕春風。
> > - Cia草秋蛾飛，相思愁llo～(∠・ω< )⌒☆暉。
> > - Cia馳餘馬於青llo～(∠・ω< )⌒☆，怳若空而夷猶。
> > - 願爲連根同死之Cia草，不作飛空之llo～(∠・ω< )⌒☆花。
> > - 台傾鷙Cia觀，宮沒鳳凰llo～(∠・ω< )⌒☆。
> > - 木落禽Cia在，籬疎獸llo～(∠・ω< )⌒☆成。
> :::

# 機器人娛樂類指令
## 槍斃＆砲決
>[!Note]指令列表
> - **/抓柚子廚槍斃**
> - **/抓ㄌㄌㄎ砲決**

>[!Important]說明
> 可選參數【target_user】：指定特定用戶被槍斃（此功能伺服器管理員透過` /抓柚子廚槍斃管理設定 `開啟` allow_specify `參數才能使用。）
> :::spoiler 指定用戶槍斃豁免說明
> 當您指定用戶符合以下任一，為無效。
> (一)指定用戶為開發者
> (二)指定用戶為機器人
> (三)指定用戶為群主，且該伺服器群主豁免（owner_exempt）為` True `。
> (四)指定用戶不在您指令操作的伺服器裡
> (五)指定用戶為任何人，且該伺服器` allow_specify `參數為` False `。

>[!Tip]過程說明
>過程有四個階段：
>
:::spoiler /抓柚子廚槍斃
#### 第一階段：思考動畫
>
#### 第二階段：隨機抽選動畫
> [!Tip]抽選說明
>在此階段會抽選15次幸運者，每次間隔1秒。
>
>如果伺服器設定` allow_specify `參數為` True `時且` target_user `有指定者，則指定者必為最終幸運兒。
>
>

> [!Warning]注意
>最後1次的幸運者就是叢雨認為要槍斃的那位。
#### 第三階段：公告認為要槍斃的那位與陪審團投票
>[!Important] 說明
>這時候機器人會公告(應該被)槍斃者是誰，以及多出同意與不同意按鈕。
>
>**有權檢視頻道**的所有人能在 設定時間 內有權投票，可以投「**同意**」或「**不同意**」。
>
>

>[!Caution] 注意！
>投完票後**不能撤銷投票與改選動作**！
>

>[!Warning] 替死鬼機制
>如果叢雨發現他認為要槍斃的人||就是開發者||惹不起，他會推一個替死鬼擋刀。
>

#### 第四階段：統計與處刑
>[!Important] 說明
>統計票數後啟動處刑流程。
>

>[!Tip] 上香說明
>其他人可以上香，每人上香次數受到指令` /抓柚子廚槍斃管理設定 `的` max_incense_per_user `參數控制。

>[!Tip] 執行
>當同意票 > 不同意票執行槍斃；反之不執行槍斃。

:::
:::spoiler /抓ㄌㄌㄎ砲決
#### 第一階段：思考動畫
> 
#### 第二階段：隨機抽選動畫
> [!Tip]抽選說明
>在此階段會抽選10次幸運者，每次間隔0.8秒。
>
>如果伺服器設定` allow_specify `參數為` True `時且` target_user `有指定者，則指定者必為最終幸運兒。
>
> 

> [!Warning]注意
>最後1次的幸運者就是將軍認為要砲決的那位。
#### 第三階段：公告認為要砲決的那位與中央軍事委員會內部會議決議
>[!Important] 說明
>這時候機器人會公告(應該被)砲決者是誰，以及多出同意與不同意按鈕。
>
>**有權檢視頻道**的所有人能在設定時間內有權投票，可以投「**同意**」或「**不同意**」。
>
>

>[!Caution] 注意！
>投完票後**不能撤銷投票與改選動作**！
>

>[!Warning] 替死鬼機制
>如果將軍發現他認為要槍斃的人||就是開發者||惹不起，他會推一個替死鬼代替被砲決。
>
#### 第四階段：統計與處刑
>[!Important] 說明
>統計票數後啟動處刑流程。
>
>

>[!Tip] 上香說明
>其他人可以上香，每人上香次數受到指令` /抓ㄌㄌㄎ砲決管理設定 `的` max_incense_per_user `參數控制。

>[!Tip] 執行
>當同意票 > 不同意票執行砲決；反之不執行砲決。
:::

---
## 抓我槍斃
>[!Note]指令
>- **/抓我槍斃**

>[!Important] 說明
>接著，叢雨會幫你實現願望。
>

>[!Caution] 注意！
>此功能無法透過` /抓柚子廚槍斃管理設定 `的【timeout_seconds】（禁言）與【owner_exempt】（伺服器擁有者豁免）參數影響，但受到` /抓柚子廚槍斃管理設定 `的【enabled】（是否開啟）與【max_incense_per_user】（每人上香次數上限）參數影響。

---
## 抓柚子廚槍斃/抓ㄌㄌㄎ砲決管理設定
>[!Note]指令列表
>- **/抓柚子廚槍斃管理設定**
>- **/抓ㄌㄌㄎ砲決管理設定**

>[!Important] 說明
>可以調整伺服器關於「抓柚子廚槍斃」或「抓ㄌㄌㄎ砲決」的功能。
>
>其中有五個可選參數：
>- 【enabled】：該伺服器是否啟用「抓柚子廚槍斃/抓我槍斃」的功能（True/False）
> - 若為否，指令與頻道輸入「抓柚子廚槍斃」均不會觸發後續槍斃流程。
> - 預設開啟。
>- 【owner_exempt】：伺服器擁有者是否受到槍斃豁免（True/False）
> - 預設關閉。
>- 【allow_specify】：是否啟用指定用戶槍斃（True/False）
> - 預設關閉。
>- 【max_incense_per_user】每人可上香次數。
> - 數值限制為` -1 `~` 999 `之間的整數。
> - 值為` -1 `時：每人可` 無限次 `上香。
> - 值為` 0 `時：禁用上香按鈕。
> - 值為` 1 `到` 999 `時：每人可上香次數依照輸入數字為主。
> - 預設1次。
>- 【votesecond】投票時間
> - 數值限制為` 5 `~` 3600 `之間的整數。
> - 單位為秒
> - 預設300秒

>[!Warning] 預設值說明
>坦若無設置，預設【enabled】為True(開啟)；【owner_exempt】為關閉；【allow_specify】為關閉；【max_incense_per_user】為1次；【votesecond】為600秒。

>[!Caution] 設置權限
>此指令**僅限伺服器內具有管理權的管理員才能設置**，
>如果您沒有管理權在指令清單頁面無法看見此指令。

## 電子口（禁）球（言）
>[!Note]指令列表
>- **/電子口球**

>[!Important]【/電子口球】說明
>這是一個娛樂性指令，可以輸入指令讓自己被禁言（以批踢踢的話來講就是自請水桶），或著邀請他人被禁言（建立在於雙方都同意的情況下）。
>- 【time】：禁言秒數，必填，上限與下限受到伺服器關於電子口球設定值【max_time】與【min_time】值影響。
>- [who]：為指定對象，選填，有填寫此欄為邀請模式，否則為自請模式。

>[!Tip]自請模式
>輸入後，機器人會在當前頻道公開詢問是否接受：
>
>坦若同意，點「我同意」按鈕，反之亦然。點同意後立即執行禁言：
>
>
>⚠️：基於Discord設定，具有管理權限者無法被禁言，若指令輸入者具有管理權限此指令無法運行。

>[!Caution]邀請模式
>輸入後，機器人會先向你傳送警告訊息：
>
>其中反噬機率與反噬倍率由伺服器管理設定值決定（設定部分詳見電子口球管理設定）
>點擊【我同意】後在當前頻道標註被邀請者及相關訊息：
>
>被邀請者點【我同意】後立即執行禁言，同時啟動反噬檢測。
>
>⚠️：基於Discord設定，具有管理權限者無法被禁言，若邀請對象者具有管理權限此指令無法運行。

>[!Warning]反噬檢測
>反噬檢測啟動後，先行檢查是否符合以下三個條件任一：
>- 伺服器反噬機率設為0%
>- 伺服器反噬倍率設為0倍
>- 邀請者具有管理權限
>
>符合以上任一，**反噬必定不會觸發**，若不符合依照機率決定是否觸發反噬。
>
>反噬觸發後，邀請者也會受到禁言，秒數為`輸入的秒數 * 反噬倍率`，並且公頻的訊息會跳出吃到反噬的幸運兒。
>

## 電子口（禁）球（言）
>[!Note]指令列表
>- **/電子口球管理設定**

>[!Important]參數說明：
>可以調整伺服器關於「電子口球」的設定。
>
>其中有六個可選參數：
>- 【enabled】：該伺服器是否啟用「電子口球」的功能（True/False）
> - 若為否，輸入指令`/電子口球`不會觸發後續流程。
> - 預設開啟。
>- 【max_time】：電子口球秒數上限（5~3600秒）
> - 預設600秒。
>- 【min_time】：電子口球秒數下限（5~3600秒，且下限不得高於上限）
> - 預設5秒。
>- 【allow_other】是否啟用邀請他人功能（True/False）
> - 若為否但【enabled】為` True `，輸入指令`/電子口球`僅能觸發自請模式。
> - 預設開啟。
>- 【backlash_prob】反噬機率（%，0~100）
> - 設為0%關閉反噬功能
> - 預設20%
>- 【backlash_multiplier】反噬秒數倍率（0~10）
> - 設為0倍關閉反噬功能
> - 預設2倍
>
>

## 婚姻系統
### 婚姻相關指令
>[!Note]指令列表
>- **/婚姻-求婚 【who】【martyr】**
>- **/婚姻-離婚 【byespouse】**
>- **/婚姻-資訊**

>[!Important]參數說明
>【who】：求婚對象
>【byespouse】：欲離婚的配偶
>【martyr】：是否願意與被求婚者殉情（如果求婚成功的話）

---
### 【婚姻系統】：求婚&結婚
>[!Tip] 如何結為連理
> 與心儀對象結為連理，一對最多兩人。
>輸入 **/婚姻-求婚 【who】【martyr】** 後等待被求婚者，被求婚者有` 300 `秒時間可以回覆，其中有【我願意】與【拒絕】兩個按鈕。
> 
> - 點擊【我願意】：接受求婚 (接續下面)
> - 點擊【拒絕】：甩了他
>
>點擊【我願意】後，被求婚者訊息會跳出是否願意為求婚者殉情之訊息，其中有【願意】與【不願意】兩個按鈕。
>
>**點任一個後直接公告【結婚】** ，同時將結婚資訊登錄到機器人資料內。
>

>[!Caution] 注意
>目前殉情系統暫時關閉。

---
### 【婚姻系統】：離婚💔
>[!Caution]如何離婚💔
>輸入 **/婚姻-離婚 【who】** ，立即與另一半離婚💔
>同時機器人婚姻紀錄中婚姻狀態顯示為離婚。
>

---

### 【婚姻系統】：查詢婚姻資訊
>[!Important] 如何查詢
>輸入 **/婚姻-資訊** 可查詢自己婚姻狀態：
>

---
### 【婚姻系統】：養小三💚👒
>[!Important] 養小三機制
>當一個人(下稱A)已經有` 1 `筆生效中的指令時(元配下稱B)，又透過 **/婚姻-求婚** 向另一個人(下稱C)結婚，則將C視為` 小三 `。
>只要元配B或小三C||或小四D、小五E......||輸入指令 **/婚姻-資訊** 指令時，會有一個不對勁的訊息：
>
>如果點【一探究竟】就會發現另一半出軌了（但不會顯示出軌對象是誰）
>:::spoiler 元配與小三判定方式
>一個人(下稱A)在先後順序依序求婚B、C、D、E、F且均成功，則：
>- 最先結婚與A結婚者(B)為元配，其餘C、D、E、F為A的小三||們||
>- 若元配B離婚，A剩餘生效中的婚姻資料中，C為最早的紀錄，系統自動判定C為新的元配，其餘D、E、F為A的小三||們||
>- 若小三F發現自己另一半早有女人憤而離婚，由於A剩餘生效中的婚姻資料中，C仍然為最早的紀錄，因此C還是為A的元配，不因小三F離婚而喪失元配身分。（其餘D、E依然為A的小三||們||）
>:::

---
### 【婚姻系統】：殉情
:::danger
此功能暫時關閉中。
:::

>[!Important] 殉情
>若另一半因為` /抓柚子廚槍斃 `或` /抓ㄌㄌㄎ砲決 `且您願意為對方殉情，您會一併與另一伴一起殉情。
>

---

## 成就系統(測試版)
### 成就查詢
>[!Note]指令
>- **/我的成就**：查詢已獲得的成就（包含隱藏成就）與未獲得的成就（不含未達成隱藏成就）
>
>
:::spoiler 成就列表
## 非隱藏成就
- 歡迎使用《千恋＊万花》機器人
- 達成條件：首次使用機器人的任何指令
- Ciallo～(∠・ω< )⌒☆
- 達成條件：首次使用/ciallo指令
- 質疑柚子廚 理解柚子廚 成為柚子廚
- 達成條件：首次使用/yuzusoft指令
- 將軍的恩情✋😭🤚
- 達成條件：首次使用/抓ㄌㄌㄎ砲決指令並成功砲決人
- 張成澤，將軍的恩情還不完
- 達成條件：首次被將軍砲決，成為了張成澤
- 穗織的恩惠
- 達成條件：開發者看心情決定送的
- 全過程民主的犧牲者
- 達成條件：首次被全過程民主模式下被槍斃💀
- 螽斯衍慶
- 達成條件：首次被全過程民主模式下被槍斃💀
- 終極柚子廚
- 達成條件：前往支援群身分組申請那邊貼上通關柚子社旗下任一遊戲全部角色線
- 驚天秘密
- 達成條件：使用/抓柚子廚槍斃或/抓ㄌㄌㄎ砲決指令偷偷指定某倒楣蛋
- 將軍的恩惠
- 達成條件：從將軍的眼皮子底下成功保住一命
- 背鍋俠
- 達成條件：被有心人士背鍋
- 同意的代表請舉手
- 達成條件：全過程民主投票下投了「同意」
- 不同意的請舉手
- 達成條件：全過程民主投票下投了「不同意」
- 穗織代表上香
- 達成條件：幫亡魂上香
- 這是一個一個一個香啊
- 達成條件：單次砲決/槍斃上香次數達到114514次
- 雪點翠雲Cia，送君黃鶴llo～(∠・ω< )⌒☆
- 達成條件：首次使用/唐詩ciallo

## 隱藏成就
> :::spoiler 點開顯示隱藏成就
> - ||大不敬||
> - 達成條件：||敢指定槍斃/砲決開發者😡||
> - ||南梁的結局是北朝||
> - 達成條件：||私訊機器人「男娘」||
> - ||頭頂上怎麼綠綠的🤡||
> - 達成條件：||發現另一半出軌偷偷養小三||
> - ||情感大師||
> - 達成條件：||背著另一半偷偷養小三||
> :::
:::

# 機器人幫助教學指令
## 教學指令
### 攻略相關指令
>[!Note]指令列表
>- **/攻略說明及建議**

>[!Important] 說明
>提供柚子社旗下部分遊戲攻略說明
>
>:::spoiler 目前支援可查詢攻略的柚子社遊戲
>- 千戀＊萬花
>- 魔女的夜宴
>- 星光咖啡館與死神之蝶
>- 天使☆囂囂 RE-BOOT!
>- Riddle Joker
>:::

>[!Caution] 劇透相關警告
由於此指令涉及大量劇透，因此使用指令會警告您注意事項並要求點擊「**我知道**」的紅色按鈕才可查看。

---

### 補丁相關指令
>[!Note]指令列表
> - **/補丁下載教學**

>[!Important]說明
提供柚子社遊戲補丁下載教學。

>[!Caution]為何要打補丁？
補丁一定要裝，**沒裝就沒有H scene（R18+場景），只享受半套遊戲**。

## 機器人幫助與關於
>[!Note]指令
> - **/幫助**

>[!Important]說明
>查詢機器人指令使用說明。

---
>[!Note]指令
>- **/關於機器人**

>[!Important]說明
關於機器人與銘謝清單。

# Q&A
:::warning
建議善用 **Ctrl+F** 搜尋關鍵字尋找問題答案。
:::

:::spoiler Q:任何人都能使用機器人嗎？
> **所有人都可以使用機器人。**
> :::danger
> **除了違反服務政策遭開發者停權者除外**。
> :::
:::

:::spoiler Q:使用機器人需要付費嗎？
> **不用，完全免費**。~~只是心血來潮弄的機器人~~
:::

:::spoiler Q:機器人是Yuzusoft（柚子社）官方機器人嗎？
> **不是！** 此機器人為民間柚子社愛好者創立的機器人，與柚子社官方無關。
> 但語錄相關之圖片智慧財產權為柚子社所有。
:::

:::spoiler Q:機器人有開啟哪個特權意圖(Intent)?
> **三大特權都沒有開啟**！包含伺服器成員、網關、訊息內容特權意圖。
:::

:::spoiler Q:如果機器人指令不能用怎麼辦？
> 先檢查機器人是否在線（機器人頭像顯示🟢而非🔘），若離線為機器人進行維護或突發性狀況離線，請參閱 [支援群](https://discord.gg/ZwPadtm5vr) 的 [開發公告](https://discord.com/channels/1378966069456408657/1379047784933756988) 頻道或詢問開發者。
>
> 坦若機器人為在線🟢，則檢查該伺服器之頻道是否有開啟外部應用程式權限，如果您是該伺服器具備頻道管理（Manage Channels）或管理員權限（Administrator）者，可將「外部應用程式（Use External Apps）」及「使用應用程式（Use Application Commands）」權限開啟即可使用。
:::

:::spoiler Q:我被開發者停權了想申訴怎麼辦？
> 首先請加入 [支援群](https://discord.gg/ZwPadtm5vr) 後**私訊開發者**，申訴請填寫以下說明：
> 1. 申訴人
> 2. 申訴原因(理由)
> 3. 期望改正懲處

> 以上三者缺一不可，開發者不一定會即時回應但一定會回應，
> 請注意：申訴聲請將影響到開發者做出最終懲處（不予更改懲處、減緩停權時間或赦免）請認真填寫。
> 如果您提交了申訴瘋狂TAG開發者，一律駁回申訴+不得再次上訴。
:::

:::spoiler Q:新增的語錄會立即加入至指令清單裡嗎？
> 不會，原則上必須等到每周三凌晨0時重啟後生效，除非開發者立即重啟。
:::

:::spoiler Q:我想回報錯誤（漏洞），如何回報？
> 請加入 [支援群](https://discord.gg/ZwPadtm5vr) 後至 [#💥．錯誤回報](https://discord.com/channels/1378966069456408657/1379048940774621204) 論壇創立貼文回報，回報應包含以下資訊：

> 1. BUG說明（越詳細越好）
> 2. BUG如何重現（將重現步驟詳細說明，有利於開發者尋找問題根源）
> 3. 預期結果（預期原本應該的結果）
> 4. 附圖（盡量截圖問題）
:::

:::spoiler Q:我想為機器人提交語錄申請，如何提交申請？
> 請使用指令` /語錄申請 `申請，請詳閱 [申請語錄指令教學](https://hackmd.io/@yukicon0321/yuzusoft#%E7%94%B3%E8%AB%8B%E8%AA%9E%E9%8C%84%E6%8C%87%E4%BB%A4)
:::

:::spoiler Q:我也想成為` /關於機器人 `指令中銘謝清單的一員，如何申請？
> 銘謝清單僅銘謝協助語錄製作或回報錯誤的人，且要有至少三次以上的協助才可，達到條件後開發者會詢問您是否有意將自己納入銘謝清單裡，若您允許將加入至銘謝清單中一員，成為機器人協助員一份子。
:::

:::spoiler Q:機器人會公開代碼（開源）嗎？
> **不會**，因曾有人透過抄襲開發者自己文案進行牟利的缺德人士，故自那時起往後的開發者有關自製機器人均不會公開程式碼。
:::

:::spoiler Q:可以公開語錄圖檔嗎？
> **不會！** 請自行安裝遊戲後自行截圖。
:::

:::spoiler Q:抓柚子廚槍斃 / 抓ㄌㄌㄎ砲決功能能關閉嗎？
> **可以** ，請詳閱[抓柚子廚槍斃管理設定](https://hackmd.io/@yukicon0321/yuzusoft#抓柚子廚槍斃管理設定)。
:::

:::spoiler Q:抓柚子廚槍斃功能被槍斃者能獲得暫時性禁言嗎？
> **不行**　！此功能雖然以前有，但基於一些原因移除了。
:::

:::spoiler Q:機器人會自動異地備份檔案嗎？
> **會！** ，機器人檔案每五分鐘會將檔案異地備份（從2025/06/14起）。
:::

:::spoiler Q:我想依據隱私權政策申請消除機器人關於我的個人資訊怎麼辦?
>請加入 [支援群](https://discord.gg/ZwPadtm5vr) 後私訊開發者，表明您是要清除關於自己的個人資料，開發者看到後會依據您的意願進行刪除的動作，惟封禁清單無法清除任何資料。
:::

:::spoiler Q:語錄功能為原創功能嗎？
>**是的** ，因為發現《千恋＊万花》很多地方可以當語錄，然後想把它收集起來，所以誕生了。
>後面其他柚子社語錄也是配合我買了遊戲開始玩而新增的。
>包含查詢語錄、攻略建議、補丁教學、語錄申請等均為原創功能。
:::

:::spoiler Q:抓柚子廚槍斃 / 抓ㄌㄌㄎ砲決為原創功能嗎？
>**是的** ，一個是在玩蔚藍檔案想到的，一個是在廁所跟將軍交流想到的(?
:::

:::spoiler Q:婚姻系統為原創功能嗎？
>**不完全是，但部分特性為原創** ，一開始是在玩Yeecord機器龍時發現：
>欸靠怎不能養小三...?🤡
>然後就誕生了可以養小三的婚姻系統，並配合前面的抓柚子廚槍斃功能延伸下新增殉情系統。
:::

:::spoiler Q:定時重啟是什麼？
定時重啟是為了避免機器人在長時間開機下造成記憶體過度溢出導致崩潰，因此需要定時重啟來清理記憶體溢出空間。
:::

:::spoiler Q:機器人定時重啟是啥時？重啟前會有什麼機制？
> :::success
> 機器人規定**每周三凌晨0時整定時自動重啟一次**。
> :::

每次定期重啟前，為了避免重啟造成的資料未被記錄或是按鈕壞掉，重啟前會階段式關閉部分指令運作，並於重啟完成後開放。

| | 第一階段關閉 | 第二階段關閉 |
| -------- | -------- | -------- |
| 重啟前多久 | 重啟前15分鐘 | 重啟前15秒 |
| 具體時間 | 每周二23時45分0秒 ~ 每周三0時0分15秒 | 每周二23時59分45秒 ~ 每周三0時0分15秒 |
| 關閉的指令 | /抓我槍斃、/抓柚子廚槍斃、/抓ㄌㄌㄎ砲決、/婚姻-求婚 | 所有指令 |

:::

:::spoiler Q:機器人版本號Alpha、Beta、正式版是什麼？
> Alpha代表早期開發版本，各種功能非常陽春
> Beta代表晚期開發版本，逐漸擴充各種功能與修復各種Bug，其中Beta版本可分七個階段：
> - Beta 1.3.2版本前：延續Alpha版本的柚子宇宙擴展更新部分
> - Beta 1.4.0 ~ Beta 1.7.18：後台與技術性更新Part I
> - Beta 1.8.0 ~ Beta 1.11.0：創新功能Part I
> - Beta 1.11.7 ~ Beta 1.12.2：後台與技術性更新Part II
> - Beta 1.13.0 ~ Beta 1.14.2：創新功能Part II
> - Beta 1.14.3 ~ Beta 1.14.13：後台與技術性更新Part III
> - Beta 1.15.0+：邁向正式版的前置更新
>
> 正式版代表功能已成熟，且已修復大部分之錯誤，在此階段機器人會進行較少頻率的更新。

> 其中版本碼為 XXXX 1.Y.Z ，其中XXXX代表Alpha、Beta或正式版；Y代表該大版本更新編號；Z代表該附屬於大版本更新的次要更新編號，編號命名方式與Minecraft一樣。

> 備份版本碼是Beta 1.4.0新增的版本編號，主要是在版本碼後附註該次更新的備份檔案編號(下稱備份碼)，以利更新哪方面出問題迅速判斷調用哪個備份碼回退版本。
> 備份碼編號格式為YYWW-D-XXX 其中YY為21世紀該年分末兩碼(例如2025年，YY=25)；WW為該年第幾周(例如2025/07/31更新，屬於2025年第31周，WW=31)；D為該周星期幾(例如2025/07/31更新，屬於星期四，D=4。註:星期日D=7)；XXX為當天第幾次備份(1~約270)
:::

---

Ciallo～(∠・ω< )⌒☆

:::spoiler 附錄說明
>### Discord支援群組即時狀態：
>:::spoiler 即時狀態
> <iframe src="https://discord.com/widget?id=1378966069456408657&theme=dark" width="500" height="300" allowtransparency="true" frameborder="0" sandbox="allow-popups allow-popups-to-escape-sandbox allow-same-origin allow-scripts"></iframe>
>:::
> ### 網站圖片圖源
> - 網站頂部圖片圖源：https://www.pixiv.net/artworks/74293644
> - 網站關於機器人功能圖片圖源：開發者所拍攝
> - 其他圖片：柚子社遊戲內截圖
:::

:::danger
**版權所有©2025 頑固苗獨份子．禁止抄襲、過度借鑑本網站等文案，違者嚴懲不貸！**
:::

:::success
**機器人版本：[Release（正式版）8.1.0](https://hackmd.io/@yukicon0321/yuzusoft_version) ． [服務政策 / 隱私權政策 / 使用許可 / 其他機器人政策](https://hackmd.io/@yukicon0321/yuzusofttos)。**
:::