呀吼~指挥官!把群组交给涅普涅普就放心吧!(๑•̀ㅂ•́)و✧
诶?你说为什么是海王星女神来管群组?因为人家是「主人公」啊!涅普♪
Neptune - 穿越到 Telegram 群组的紫耀之都守护女神,基于 Cloudflare Workers 构建的群管理Bot!
虽然平时有点懒散,但关键时刻可是很可靠的涅普!(大概)
- 入群欢迎 - 自定义欢迎消息,支持 Markdown 和占位符,让新人感受到涅普涅普的热情款待~
- 入群认证 - BMP 图片验证码验证,支持群规阅读确认,把可疑的家伙统统挡在外面!(5 次错误自动锁定,支持验证码复用,省得涅普每次都要画新的)
- 自动回复 - 关键词/正则匹配自动回复(支持繁简中文互匹配),这就是传说中的自动应答姬!涅普也可以偷懒了~
- AI 聊天 - 搭载涅普顿本人人格的 AI 对话,支持上下文记忆(自动重试、超时保护),和真正的涅普聊天才更开心嘛!
- 投票踢人 - 群成员投票踢人,支持启用/禁用,过期自动清理,民主的力量!(虽然涅普觉得直接踢更省事……)
- 管理员私聊管理 - 通过私聊管理群组设置,支持多群组切换,指挥官的特权~涅普也会乖乖听话的!
- 举报与警告 - 群成员可通过
/report举报违规消息,管理员通过/warn直接警告用户,举报由 Web 管理面板审核处理,自动删除违规消息并通知举报人。 - Web 管理面板 - 基于 Telegram Login Widget 认证的网页后台(
worker域名/admin),支持举报审核和警告管理,指挥官的作战指挥室! - GitHub Release 通知 - 自动接收 Kazumi 仓库新 Release 并发送到 Telegram 频道,新版本的情报就交给人家吧!发布完了记得请涅普吃布丁哦?
- 权限控制 - 所有管理命令仅限管理员使用,越权什么的不可以哦!涅普可是很有原则的!(才不是因为懒呢)
- 涅普最喜欢布丁了!写上「涅普的」防止被偷吃,但碧雪总会拿走写了名字的那个……
- 涅普讨厌茄子!一闻到茄子味就全身无力,所以群里请不要发茄子图片!
- 涅普是游戏高手!沉迷死宅,有什么好玩的游戏记得推荐给涅普哦!
- 涅普有主角光环!作为「主人公中的主人公」,运气总是很好呢~
- 涅普绝不穿裙子!这是原则问题!(虽然女神化会变身……)
- 涅普的口癖是「涅普」!惊讶、被打、疑问、甚至睡觉呼噜都是「ねぷぅ……ねぷぅ……」
通用(谁都可以用哦!)
| 命令 | 说明 |
|---|---|
/help |
显示帮助信息,不知道做什么的时候就用这个!涅普也会用的~ |
/ping |
检查机器人是否在线,pong~! 涅普还活着哦! |
/id |
获取当前群组 ID(自动关联群组),指挥官请记好~ |
管理员(私聊里用,指挥官的特权!)
| 命令 | 说明 |
|---|---|
/connect <群组ID> |
绑定私聊与群组(需群组管理员权限),涅普会记住你的! |
/switch |
切换管理的群组(按钮选择),涅普帮你切换~ |
入群欢迎(需要管理员权限,涅普帮你热情招待新人!)
| 命令 | 说明 |
|---|---|
/setwelcome <消息> |
设置欢迎消息,让新人感受涅普的热情!支持占位符哦~ |
/enablewelcome |
启用入群欢迎,新人来了涅普会打招呼! |
/disablewelcome |
禁用入群欢迎,涅普可以偷懒了~ |
入群认证(需要管理员权限,把可疑家伙挡在外面!)
| 命令 | 说明 |
|---|---|
/rule <内容> |
设置群规(入群需阅读),/rule off 清除。涅普也会遵守的!(大概) |
/setverifybutton <文案> |
设置认证按钮文案,写得可爱点~ |
/setverifytimeout <秒> |
设置认证超时时间,太短的话涅普画验证码会来不及的! |
/testverify |
测试验证消息(群组中使用),涅普来试试看! |
自动回复(需要管理员权限,让涅普可以偷懒的魔法!)
| 命令 | 说明 |
|---|---|
/addkeyword <关键词> <回复> |
添加关键词规则,涅普帮你自动回复~ |
/addregex <正则> <回复> |
添加正则规则,这是高级魔法! |
/listkeywords |
列出所有规则,涅普帮你整理好了~ |
/removekeyword <关键词> |
删除规则,不需要的就扔掉吧! |
关键词和正则均支持繁简中文自动匹配,例如关键词为"学习"可匹配"學習",反之亦然。 这就是传说中的繁简转换魔法!✨ 涅普也会这个哦!
投票踢人(需要管理员权限启用,民主的力量!)
| 命令 | 说明 |
|---|---|
/enablevotekick |
启用投票踢人,让大家一起决定! |
/disablevotekick |
禁用投票踢人,涅普觉得直接踢更省事…… |
/kick |
回复目标用户消息发起踢人投票(群成员均可使用),投票完记得请涅普吃布丁! |
举报与警告(维护群组秩序!)
| 命令 | 说明 |
|---|---|
/report <原因> |
回复目标用户消息提交举报(群成员可用),管理员在 Web 面板审核处理 |
/warn [原因] |
回复目标用户消息进行警告(管理员可用),记录警告次数 |
- 管理面板:访问
worker域名/admin登录后可审核举报(通过/驳回)和查看警告记录 - 举报处理:通过后自动删除违规消息并警告用户,举报人收到结果通知
AI 聊天(和真正的涅普聊天!)
| 触发方式 | 说明 |
|---|---|
| @机器人 + 消息 | 直接与涅普顿对话,呀吼~ |
| 回复机器人消息 | 继续对话,涅普会记住你说的话哦! |
- 每日限额:普通用户 15 次/天,管理员不限(管理员大人真是太伟大了!涅普给你点赞!)
- 记忆机制:群内共享上下文,保留最近 50 条消息(滚动 7 天窗口),涅普记性很好的!(大概)
- 模型:小米 MiMo V2.5,涅普的专用大脑!
- 容错:API 超时 25 秒,429/5xx 自动重试最多 2 次,涅普会努力不掉线的!
欢迎消息和自动回复支持以下占位符,涅普帮你变出个性化内容!
| 占位符 | 说明 |
|---|---|
{nickname} |
用户昵称,涅普会记住你的名字哦! |
{userid} |
用户 ID,独一无二的数字身份~ |
{groupname} |
群组名称,这是哪个群来着? |
- 将涅普加入群组并设为管理员(拜托了!涅普会努力工作的!)
- 在群组中发送
/id获取群组 ID(自动关联你的账号,涅普会记住你的!) - 在私聊中发送
/switch选择要管理的群组(涅普帮你切换~) - 使用各种命令配置群组功能,就这样,很简单对吧?涅普都能学会!
详见 CONTRIBUTING.md。(涅普不太懂这些,但指挥官应该没问题吧?)
bun install # 安装依赖(涅普帮你装好了~)
bun run dev # 本地开发(涅普在旁边看着你写代码!)
bun run lint # Biome 检查(代码要写得漂亮哦!)
bun run typecheck # TypeScript 类型检查(涅普帮你检查!)
bun run deploy # 部署到 Cloudflare(涅普帮你发布!)MIT(涅普觉得这个协议挺好的,很自由~)
Neptune - 穿越到 Telegram 群组的紫耀之都守护女神
Made with ❤️ and TypeScript(还有布丁!)
涅普涅普,出击!(๑•̀ㅂ•́)و✧