Skip to content

ChouChiu/Neptune

涅普涅普的群组守护大作战!Nepktune

呀吼~指挥官!把群组交给涅普涅普就放心吧!(๑•̀ㅂ•́)و✧

诶?你说为什么是海王星女神来管群组?因为人家是「主人公」啊!涅普♪

Neptune - 穿越到 Telegram 群组的紫耀之都守护女神,基于 Cloudflare Workers 构建的群管理Bot!

虽然平时有点懒散,但关键时刻可是很可靠的涅普!(大概)

涅普的超能力菜单 (ノ>ω<)ノ

  • 入群欢迎 - 自定义欢迎消息,支持 Markdown 和占位符,让新人感受到涅普涅普的热情款待~
  • 入群认证 - BMP 图片验证码验证,支持群规阅读确认,把可疑的家伙统统挡在外面!(5 次错误自动锁定,支持验证码复用,省得涅普每次都要画新的)
  • 自动回复 - 关键词/正则匹配自动回复(支持繁简中文互匹配),这就是传说中的自动应答姬!涅普也可以偷懒了~
  • AI 聊天 - 搭载涅普顿本人人格的 AI 对话,支持上下文记忆(自动重试、超时保护),和真正的涅普聊天才更开心嘛!
  • 投票踢人 - 群成员投票踢人,支持启用/禁用,过期自动清理,民主的力量!(虽然涅普觉得直接踢更省事……)
  • 管理员私聊管理 - 通过私聊管理群组设置,支持多群组切换,指挥官的特权~涅普也会乖乖听话的!
  • 举报与警告 - 群成员可通过 /report 举报违规消息,管理员通过 /warn 直接警告用户,举报由 Web 管理面板审核处理,自动删除违规消息并通知举报人。
  • Web 管理面板 - 基于 Telegram Login Widget 认证的网页后台(worker域名/admin),支持举报审核和警告管理,指挥官的作战指挥室!
  • GitHub Release 通知 - 自动接收 Kazumi 仓库新 Release 并发送到 Telegram 频道,新版本的情报就交给人家吧!发布完了记得请涅普吃布丁哦?
  • 权限控制 - 所有管理命令仅限管理员使用,越权什么的不可以哦!涅普可是很有原则的!(才不是因为懒呢)

涅普的小秘密 (various)

  • 涅普最喜欢布丁了!写上「涅普的」防止被偷吃,但碧雪总会拿走写了名字的那个……
  • 涅普讨厌茄子!一闻到茄子味就全身无力,所以群里请不要发茄子图片!
  • 涅普是游戏高手!沉迷死宅,有什么好玩的游戏记得推荐给涅普哦!
  • 涅普有主角光环!作为「主人公中的主人公」,运气总是很好呢~
  • 涅普绝不穿裙子!这是原则问题!(虽然女神化会变身……)
  • 涅普的口癖是「涅普」!惊讶、被打、疑问、甚至睡觉呼噜都是「ねぷぅ……ねぷぅ……」

命令列表 ヽ(✿゚▽゚)ノ

通用(谁都可以用哦!)

命令 说明
/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 次,涅普会努力不掉线的!

占位符魔法 (various)

欢迎消息和自动回复支持以下占位符,涅普帮你变出个性化内容!

占位符 说明
{nickname} 用户昵称,涅普会记住你的名字哦!
{userid} 用户 ID,独一无二的数字身份~
{groupname} 群组名称,这是哪个群来着?

使用流程 (Step by Step)

  1. 将涅普加入群组并设为管理员(拜托了!涅普会努力工作的!)
  2. 在群组中发送 /id 获取群组 ID(自动关联你的账号,涅普会记住你的!)
  3. 在私聊中发送 /switch 选择要管理的群组(涅普帮你切换~)
  4. 使用各种命令配置群组功能,就这样,很简单对吧?涅普都能学会!

开发 (for Developers)

详见 CONTRIBUTING.md。(涅普不太懂这些,但指挥官应该没问题吧?)

bun install           # 安装依赖(涅普帮你装好了~)
bun run dev           # 本地开发(涅普在旁边看着你写代码!)
bun run lint          # Biome 检查(代码要写得漂亮哦!)
bun run typecheck     # TypeScript 类型检查(涅普帮你检查!)
bun run deploy        # 部署到 Cloudflare(涅普帮你发布!)

License

MIT(涅普觉得这个协议挺好的,很自由~)


Neptune - 穿越到 Telegram 群组的紫耀之都守护女神

Made with ❤️ and TypeScript(还有布丁!)

涅普涅普,出击!(๑•̀ㅂ•́)و✧

About

Telegram 群管理 Bot,基于 Cloudflare Workers 构建。

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors