Python 原生 GreenMoon面板，多功能易上手的强大的endstone插件。 v10.2.3

GreenMoon · Endstone 服务器管理加机器人和AI自动化管理服务器的系统性面板​

一款对新手和面板服极度友好的 Endstone 面板插件 —— 部署无脑，群服互通不用折腾，还带跨服和支持接入AI自动管理服务器（需自备支持tool的ai的API）。

---

1.如何部署​

作为一款真实为适配非专业人员而设计的插件，本插件部署及其简单， 全程不需要 SSH、不需要 pip，控制台 + 网页端搞定。

1.停服
2.将下载的whl文件放到/pulgins里
3.启动服务器
等到启动完成后，在控制台分别输入以下三条指令
首先，设置面板的UI网页端口。
gm port "你的端口"
这里请注意，如果你是使用NAT转发的VPS，填内网端口。
然后，设置登录账号
gm name xxx
注意请使用英文字母，不支持字符，中文（主要考虑到兼容性），奇奇怪怪的符号，纯阿拉伯数字这些作为用户名。
最后设置密码
gm pass xxx
输入注意事项同上。

4.输入完成且无报错后，重启服务器。（重要）​

5.用你联机用的网址输入浏览器，在把最后的端口号改为你设置的端口号。即可访问登录页面。输入账户密码即可使用。（如果是NAT转发，请使用外网端口）
6.根据服务器信息板块所显示的内容下载对应依赖包（.gmlib格式）
下载地址：https://1849050194.mshare.123pan.cn/123pan/4YYQvd-H6rvd
示例：
假设你使用hly.greenmoon作为联机地址。然后开了一个NAT转发，（8080-1234）
gm port "8080"
gm name hly
gm pass hly123
然后你可以使用hly.greenmoon:1234访问面板。以hly为用户名以hly123为密码登录了。

---

亮点：AI 从"能聊天"升级到"能干活"​

手机上的 AI 只会读日志、提建议，你不动手它什么也做不了。
greenmoon把它变成可托付的管理员 —— 但每一分权力都握在你手里。

【三级接管】取代旧的"影子模式"开关，默认第二级​

---

· 第一级 · 纯建议
只输出分析与建议，任何工具都不执行，连提议也不产生。
适合刚接入、先观察。

· 第二级 · 白名单自动（默认）
只读查询与可逆操作（踢人、封禁）由 AI 直接执行并留审计；
白名单批准/驳回也自动完成。
危险操作依然生成待确认提议，等你点确认。

· 第三级 · 完全放开
包括删档、改服务器属性在内的所有工具都由 AI 直接执行，
不再等确认。
执行后登记撤销记录，在「撤销窗口」内（默认 30 秒）可一键回滚；
窗口过后才真正不可逆。

升级不会把你推进第三级：
旧 shadow_mode=True 迁移到第一级、False 迁移到第二级，
行为与升级前完全一致。想全放开必须显式点。

【撤销窗口】放开​

---

第三级的每次不可逆操作都会留下撤销记录（工具、参数、执行人、时间），
窗口内一键回滚，面板和群里同时告知你"AI 刚做了什么、还能撤"。
窗口时长、条数上限都可配。

【AI 高级设置】提示词完全由你掌控​

---

分析任务与群聊的提示词均可自定义，完全替换语义 ——
服主可以把内置约束也删掉，一键恢复默认。
但工具白名单 / 结果脱敏 / 发言限频 这三道代码防线不受提示词影响：
能说错话 ≠ 能动手。

【群友 @ai 聊天】默认关闭​

---

@ 机器人即可调用你配置的 LLM 答复，max token、温度、限频等后台可配。
四道防线自动生效：

1. 提示词写死「与你对话的是普通群友，不是管理员」，
防止借 AI 权限套取目的；
2. AI 手上只有只读工具；
3. 结果自动脱敏（IP / 路径 / xuid / 手机号全部打码）；
4. 按人限频 + 每日上限。

【子插件 AI 接口】​

---

把 AI 能力开放给子插件：
· 探测是否启用（available()）
· 问答（ask()）
· 注册自己的工具给 AI 用（走同一套风险模型）
· 读写接管级别（写需 ai:control 权限）

不可逆工具注册需 ai:irreversible 权限，卸载自动注销，不留僵尸。

【四道安全底线】FORBIDDEN 禁区永不注册​

---

核心设计：模型只能「提议」，代码才能「决定」。

提权、执行任意命令这类禁区能力在结构上根本不存在 ——
任何级别、任何来源（含子插件）都注册不进来。

风险四级：
· 只读 直接执行
· 可逆 执行留审计
· 不可逆 视接管级别
· 禁区 不存在

工具权限与接管级别是 AND 关系：
级别是硬闸门，面板勾选只在允许范围内再收窄。

其他核心能力​

【官方机器人（直连）】​

插件直接连 QQ 官方开放平台，不需要第三方网关。

【OneBot v11】​

需 NapCat / LLOneBot 等，
正向/反向双模式都支持。
注意：插件不能免除 NapCat，只有走官方机器人这条路才直连。

· 跨服能力
不依赖 Redis、不依赖独立守护进程，配置完就能跑。

· 机器人 × 跨服打通
QQ 群里能看到跨服玩家动态，跨服后仍被机器人规则/绑定/通知覆盖。

· 加权式安全系统
不是黑白名单，而是按权重算可信度（0~100）——
设备指纹、签到、在线时长、QQ 绑定综合打分，
自动联动权限组，可设"信任的人"永久满分。

· 子插件生态
完整 gm API（白名单、封禁、可信度、模组、机器人、跨服、地图画……），为大部分功能提供基础模块。
约 1.5 万行测试守护，配套开发文档。

· AI 用自己的 Key
任何 OpenAI 兼容端点均可，插件不代理、不提供模型服务，
Key 存本机，重启不丢。

对比​

---

AI 辅助开发，代码量约 4.2 万行
其中部分OneBot连接技术和正则引擎来自LumenBridge页面。

BUG反馈与帮助获取​

---

加入QQ群：1124387896（答案greenmoon）
@群主
请写明：
· 操作步骤（无故崩溃写"未进行操作"）
· 系统环境
· Bug 现象
· 日志 / 截图 / 录屏（强烈建议附上，方便定位问题所在）

注意，以下属于正常现象，不是BUG​

1. 跨服时收纳袋/药水不同步（测试版）

Endstone 暂未暴露相关 API，预计 Endstone更新0.12 时修复。



2. 启动时警告

主线程健康监测探针正常工作；

若线程为 None 且排队 = 0，直接忽略。



3. 机器人定期掉线

连接超时 / Token 过期所致，插件自动重连（带熔断 + 慢重试）。

仅当多次重试仍失败且 AppID/AppSecret 确认无误时，请附日志反馈。

开源地址​

欢迎 Star