CSUBOT機器人使用說明書

CSUBOT 是一個超級管理員機器人。

目前可以通過驗證碼驗證新成員，自動防止群聊中的垃圾機器人。未來會增加更多功能。

優勢：不在群組中發布驗證請求，避免打斷群組聊天，打擾其他群友。

您可以點擊這裡，來測試 CSUBOT 機器人的入群審核功能： 加入 CSUBOT 的討論群組

推薦： 查詢本機訪問不同網站的公網 IP ，用於檢查當前網路環境。

打開機器人： @csubot

作為用戶如何加入群組？

您點擊加群的邀請連結之後，根據您加入群組的類型不同，您可能會看到以下兩種提示：

• 如果該群組是私有群組：您會看到一張群組名片，並提示您需要經過管理員同意才能加入群組，有一個加入按鈕「Request to Join Group」。
• 如果該群組是公開群組：您可以看到群組聊天記錄，底部的加入按鈕為「Apply to Join Group」。

點擊按鈕發送加群申請之後，機器人會私聊您，給您發送一個含有驗證按鈕的消息，您只需要找到此消息，點擊按鈕，在彈出的網頁中完成驗證，即可加入群組。

當然，您需要至少把 telegram 升級到以下版本，才可以使用相關功能。這些版本的客戶端是 2022 年發布的，也就是說，如果您的 Telegram 客戶端是在 2022 年之後安裝的，那麼可以使用 CSUBOT 機器人 完成入群審核。

• Telegram iOS v8.7.0 (23204)
• Telegram Android v8.7.0 (2622)
• Telegram macOS 8.6.0 (228674)
• Telegram Desktop 3.7.0

當然，您也可以使用網頁版 Telegram 完成 CSUBOT 的驗證。登錄地址：

• Telegram WebK
• Telegram WebA

作為群管理員如何開始使用機器人

使用前提

進行此操作，您需要是以下身份之一：

• 群主（Owner）
• 群管理員（Administrator），且擁有該群組的「Invite Users via Link」與「Add New Admins」管理員權限

機器人需要 Invite Users via Link, Ban Users 和 Delete Messages 的權限。其中，

• Invite Users via Link 和 Ban Users 用於驗證新成員
• Delete Messages 用於刪除群友 加入群組、退出群組 的消息。未來的 AI 審核功能也會使用到此權限。

操作步驟

首先添加加機器人為群組管理員，然後開啟入群審核的開關。

如果您無法找到後文中的相關設置，請升級您的客戶端到最新版本。

添加機器人為管理員

方法1： 打開 https://t.me/csubot?startgroup=start&admin=delete_messages+ban_users+invite_users ，選擇要添加機器人的群組，確認給予三項權限： Invite Users via Link, Ban Users 和 Delete Messages ，然後點擊「Add Bot as Admin」按鈕

方法2：

1. 點擊需要啟用機器人的群組（或者安卓客戶端打開群組綁定的頻道的設置），打開資料頁，點擊「修改（Edit）」或「管理群組（Manage Group）」
2. 點擊「管理員（Administrators）」，點擊 「添加管理員（Add Administrators）」
3. 輸入 @suabot （包括 @ ）
4. 確認給予三項權限： Invite Users via Link, Ban Users 和 Delete Messages

開啟入群審核的開關

公開群組開啟入群審核

1. 點擊需要啟用機器人的群組（或者安卓客戶端打開群組綁定的頻道的設置），打開資料頁，點擊「修改（Edit）」或「管理群組（Manage Group）」
2. 點擊「群組類型（Group type）」，在「誰可以發送消息（Who can send messages）」部分，選擇「僅限成員（Only members）」 （如果沒有這個選項，請直接進行下一步操作）
3. 開啟下方出現的「審核新的成員（Approve New Members）」的開關，點擊「保存（Save）」或「完成（Done）」使更改生效

私有群組開啟入群審核

1. 點擊需要啟用機器人的群組（或者安卓客戶端打開群組綁定的頻道的設置），打開資料頁，點擊「修改（Edit）」或「管理群組（Manage Group）」
2. 點擊「群組類型（Group type）」，在「誰可以發送消息（Who can send messages）」部分，選擇「僅限成員（Only members）」 （如果沒有這個選項，請直接進行下一步操作）
3. 啟動下方出現的「審核新的成員（Approve New Members）」的開關，點擊「保存（Save）」或「完成（Done）」使更改生效 （如果沒有這個選項，請直接進行下一步操作）
4. 在「管理群組（Manage Group）」中點擊「邀請連結（Invite Links）」進入群組連結管理頁面
5. 點擊管理頁面下方的「創建新連結（Create a New Link）」按鈕，進入創建新邀請連結頁面。在此頁面中將「Request Admin Approval」開關打開。不要做其他的任何限制。確保設置無誤後，點擊「Create」按鈕
6. 分享上一步中創建的連結。不要分享默認的連結，通過默認的邀請連結加群，機器人無法進行審核。（如果您錯誤的分享了默認的邀請連結，您可以點擊此連結的右側「…」按鈕，並點擊「Revoke」，以確保之前分享的連結失效。）

常見問題

我無法通過 Cloudflare 的驗證碼驗證

我可以打開 CSUBOT 的驗證網頁，但是無法通過 Cloudflare 的驗證碼驗證，該怎麼辦？

在 Cloudflare 的驗證碼小部件加載的時候，您就可以在 CSUBOT 的驗證網頁上，無規律地 移動滑鼠 或者 滑動螢幕。

如果仍然錯誤，請嘗試其他客戶端 或者 網頁版 Telegram 。網頁版登錄地址：

• Telegram WebK
• Telegram WebA

如果您的網路速度太慢，或者 IP 頻繁變動，也有可能導致驗證失敗。

為何會提示我 csubot 會收集 IP 地址？

這是 Telegram 的固定提示。

Telegram 的網頁版應用（web app）基於網頁技術構建。和您用瀏覽器訪問其他網站時類似，當您使用時，您的 IP 地址會包含在發送給 csubot 的網路請求中。

如果是惡意 Bot ，可能會濫用您的資訊。所以 Telegram 會顯示這個提示避免承擔責任。

請放心，csubot 不會存儲您個人以及所加入群組的任何數據。

您可以訪問 csubot 的 源碼庫 來查閱和審計其代碼。

csubot 和 tg-watchdog 有什麼聯繫和區別？

csubot 經過很多次迭代，目前是第四個大版本。之前數個版本使用了 Python, Javascript 等其他的語言，以 AI 審核為主，且不開放原始碼。

實際使用過程中發現， AI 審核有很多誤判，使用同一 prompt，無法滿足各種各樣的群組的審核要求。

實際上，【 機器人確認加入的人是人類，加上群管理員手動審核群友發言 】的方案就可以滿足大多數群組阻止廣告機器人的要求。

因此，csubot 作者參考成熟的 tg-watchdog 專案的實現，重新編寫 第四個大版本 的 csubot ，

• 前端在 tg-watchdog 基礎上進行修改 https://github.com/cjh0613/csubot-vue
• 後端參考 tg-watchdog ，使用 Golang 重新實現 https://github.com/cjh0613/csubot

目前代碼完全與 tg-watchdog 專案相容，您可以使用 tg-watchdog 前端+ csubot 後端；或者是 csubot 前端+ tg-watchdog 後端。

目前有如下區別：

• 後端採用效率更高的 Golang 編寫
• 網頁前端和機器人後端支援更多本地化語言
• 支援刪除群友 加入群組、退出群組 的消息

我可以自己部署一個 csubot 嗎？

當然可以！點擊這裡查看部署文件： 部署文件

為何會提示，請求我給予 csubot 個人數據？

您可能會在我們的網頁中看到如下消息：

請求您同意我們將您的個人數據用於以下目的 (Asks for your consent to use your personal data to)：

• 個性化廣告和內容，廣告和內容效果衡量，受眾調研和以及服務開發 (Personalised advertising and content, advertising and content measurement, audience research and services development)
• 存儲和訪問設備上的資訊 (Store and access information on a device)

為確保能滿足歐洲經濟區 (EEA)、英國和瑞士法規的要求，我們對上述地區的用戶顯示這個提示。由 Google, Cloudflare 提供的服務，可能會收集這些數據。

部分美國的州也有類似的法規要求，所以也會顯示類似的提示。

致謝

https://github.com/tg-watchdog/tg-watchdog ，前端 Fork 自這個專案。CSUBOT 專案的後端可以搭配這個專案的前端使用，完全相容。說明文件也參考了這個專案。

https://t.me/bot_zh 說明文件參考了這個頻道

Github, Google, ChatGPT

本網頁的其他版本

本文章有多種語言的版本。

如果您想發表評論，請訪問以下網頁：

ZH EN ZH-TW JA

這些網頁僅支援瀏覽，無法發表評論或留言，但提供了更多語言選項，並且加載時間更短：

ZH EN ZH-TW JA RU KO CS ES AR FR PT DE TR IT NL SV DA FI PL UK HE RO HU EL HR TH HI BN ID SW VI NO