policr
Version, currently master branch1 version
- master branchlatestJan 5, 2023
github.com/xp018/TG018
专注于审核群成员的 Telegram 机器人
0 stars
0 dependents
License: MIT
Installation
# Add this to your shard.yml
dependencies:
policr:
github: xp018/TG018
branch: mastermaster is a branch, not a release, so this tracks it rather than pinning a version.
Then run:
shards installshard.yml
- Crystal
0.31.1- License
- MIT
- Author
- Hentioe
- Targets
samfrom sam.crpolicrfrom src/policr.cr
Dependencies
Runtime Dependencies
- sam*github: imdrasil/sam.cr
- i18n*github: TechMagister/i18n.cr
- clicr*github: j8r/clicr
- kemal*github: kemalcr/kemal
- ksuid*github: Sija/ksuid.cr
- markd*github: icyleaf/markd
- dotenv0.3.1github: gdotdesign/cr-dotenv
- gomoku*github: policr-community/gomoku.cr
- digests*github: Hentioe/digests.cr
- dispatch*github: bmulvihill/dispatch, branch: master
- jennifer0.8.3github: imdrasil/jennifer.cr
- schedule*github: hugoabonizio/schedule.cr
- rule_engine*github: policr-community/rule_engine
- telegram_bot*github: policr-community/telegram_bot, branch: bugfix
- kemal-session*github: kemalcr/kemal-session
- telegram_markd*github: policr-community/telegram_markd, branch: compatible/telegram
- jennifer_sqlite3_adapter*github: imdrasil/jennifer_sqlite3_adapter, commit: bfe4deda12c288642ac3d6415d65bcc2b79a3fe9
Development Dependencies
- ameba*github: veelenga/amebadev
README
注意,本项目当前处于不积极维护的阶段。虽然这是暂时性的,但在考虑使用前请慎重。
PolicrBot
大概是 Telegram 平台最强大的审核机器人
介绍
本项目的设计原则是定制、专注和私有部署。核心审核功能完备且复杂,能应对各种意外情况,还有人性化的验证容错设计。
专注体现在不做不相干的功能,定制体现在提供友好的设置菜单和众多的可选项,并支持多种验证方式(之所以称之为最强大,这也是核心原因。如果不是,请打醒)。
注意:无论是官网还是本页面都可能是过时的,想知道最新功能请关注更新频道。
功能概括
构成审核的四大子功能
- 新入群用户验证(支持六种方式)
- 封杀清真名称和发表清真消息的用户
- 自动限制普通成员新拉入的机器人
- 黑名单系统:举报、投票、预先封禁和申诉
内容审查功能(严格模式)
- 限制消息的长度和行数
- 限制上传文件格式
- 编写规则(基于自主规则引擎)屏蔽内容
定制内容屏蔽(不合规、垃圾或广告内容)
- 订阅全局规则,可选自动上报至黑名单投票
- 编写私有规则,视情况而自行定义屏蔽内容
附带的周边小功能
- 调查通过验证用户的来源
- 给通过验证用户发送欢迎消息
- 删除服务消息
强大的定制能力
- 定制审核子功能启用状态
- 定制周边功能启用状态
- 定制各种痕迹消息的删除以及延迟时间
- 定制验证方式
- 自定义验证问题
- 定制验证提示模板
- 定制验证倒计时时长
- 定制删除服务消息的类型
自由、安全而开放
- 可启用容许错误的验证机制
- 基于被信任管理员的机器人调整权
- 所有用户皆可举报违规消息
- 自动化且无法程序模拟的申诉流程
- 自助申请投票权(暂未开放)
额外特殊说明:
- 本项目(永远)不会支持图片验证码,因为我们提供了更加高级而友好的验证方式(这里有详细原因)
- 黑名单系统不仅是自由开关的,其透明开放的设计也是保证公信力的前提。毕竟已经有一些被质疑黑箱操作的机制简单的黑名单机器人作为前车之鉴:)
开发技术
得益于原生语言 Crystal 的优势,机器人实例能以极低的成本高效率执行。编译完成后的二进制只有区区 4.9MB 大小,内存占用不超过 10MB,在保持低资源占用的同时能处理超高并发量的消息。
不同于很多将处理逻辑都集中于一个文件中的简单机器人,此项目源码有清晰的文件结构和良好的消息处理单元抽象。具备很高的扩展性和可维护性,能在不侵入已有功能代码的情况下进行扩展和定制。
使用&部署
相关说明已经全部迁移到官网首页,请访问这里。
加入我们
Documentation
Built from the current release. The first visit to a release nobody has asked for starts its build.
Links
This branch
- Branch
master- Seen
- Jan 5, 2023
- Crystal
0.31.1- Indexed
- yes
Dependents
No indexed shard depends on this one yet.
Repository
github.com/xp018/TG018
Metadata
- Created
- Aug 12, 2026
- Updated
- Aug 15, 2026
- Synced
- Aug 15, 2026
- Versions
- 1