dsh-mc-server-ops 0.5.1 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +40 -3
  2. package/package.json +8 -1
package/README.md CHANGED
@@ -1,12 +1,26 @@
1
1
  # dsh-mc-server-ops
2
2
 
3
- 把一台 **Minecraft 服务器**托管到 [DeepSeek Harness](https://github.com/deepseek-ai) 里的插件:QQ 群里的群友可以直接查状态、看日志、绑定游戏名,服主可以启停服务器、改配置、修 KubeJS 配方。
3
+ [![npm version](https://img.shields.io/npm/v/dsh-mc-server-ops.svg)](https://www.npmjs.com/package/dsh-mc-server-ops)
4
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-mc-server-ops.svg)](https://www.npmjs.com/package/dsh-mc-server-ops)
5
+ [![license](https://img.shields.io/npm/l/dsh-mc-server-ops.svg)](https://github.com/mogutofu/dsh-mc-server-ops/blob/main/LICENSE)
6
+ [![DSH](https://img.shields.io/badge/DeepSeek%20Harness-%E2%89%A50.2.0-blue)](https://github.com/deepseek-ai)
4
7
 
5
- > 插件本身只是「服务器操作 + 人设」这一层,**聊天通道由 QQ 机器人插件提供**。
6
- > 安装前请先装好并配置 `@tencent-connect/dsh-qqbot`(见下方「前置插件」),否则装上了也没有入口。
8
+ **在 QQ 群里管理 Minecraft 服务器。** 服主不用开电脑、不用记命令——群里发一句话,就能查状态、启停服务器、绑白名单、投票授权;游戏聊天还能直通 QQ 群,不经过 AI、不耗 token。
9
+
10
+ > 当前版本 **0.5.2** · 更新于 **2026-11-07** · 以本页和 [npm](https://www.npmjs.com/package/dsh-mc-server-ops) 为准
11
+
12
+ ## 它解决什么问题
13
+
14
+ - **服主不在电脑前**:群里问一句「服务器卡吗」,直接回 TPS、在线玩家、CPU、内存、磁盘
15
+ - **朋友想自己开服**:服务器确认关闭或假死时,群友也能重启,不用等服主
16
+ - **改东西怕手滑**:动 world / ops\data / 白名单要 2 位群友投票,凑不满就作废
17
+ - **群里看不到游戏里聊啥**:游戏聊天直通 QQ 群,不经过 AI、不耗 token
18
+ - **一条命令搞崩服**:`kill @a`、`whitelist off` 这类静态拦截,服主也发不出去
7
19
 
8
20
  ## 前置插件(必须)
9
21
 
22
+ 插件本身只是「服务器操作 + 人设」这一层,**聊天通道由 QQ 机器人插件提供**。安装前请先装好并配置 `@tencent-connect/dsh-qqbot`(见下方表格),否则装上了也没有入口。
23
+
10
24
  | 插件 | 作用 | 获取 |
11
25
  | --- | --- | --- |
12
26
  | `@tencent-connect/dsh-qqbot` | QQ 群/私聊通道:把群消息送进 Harness,把回复发回群里 | npm / DSH 插件市场 |
@@ -286,6 +300,29 @@ TPS 也是按服务端自动探测:`forge tps` → `tps`(Paper/Spigot)→
286
300
  - **投票超时**:已实现。`vote.timeoutMinutes`(默认 15)到点没凑够门槛会自动标成 `expired`,不再占「同时最多 3 个待确认投票」的名额。
287
301
  - **人设注入范围**:按会话 id 前缀判断(`session-*` 是本机界面),是启发式;如果 DSH 以后改会话 id 规则,这里要跟着调。
288
302
 
303
+ ## FAQ
304
+
305
+ **这是什么?**
306
+ 一个 DSH 插件,让服主和群友在 QQ 群里直接管理 Minecraft 服务器:查状态、启停、绑白名单、投票授权、群服互通。
307
+
308
+ **支持哪些服务端?**
309
+ Paper / Spigot / Purpur / Folia / Leaves、Forge / NeoForge / Fabric / Quilt、Arclight / Mohist / Cardboard / Youer / Banner、vanilla,以及任意 `run.bat` 启动的服。插件只看端口、RCON 和进程,不假设服务端类型。
310
+
311
+ **需要公网 IP 吗?**
312
+ 不需要。插件在本机连 RCON(默认 25575)和读日志,服务器不用暴露到公网;QQ 侧走官方机器人 API。
313
+
314
+ **安全吗?群友会不会乱来?**
315
+ 三层:静态命令拦截(`kill @a`、`whitelist off` 这类谁都发不了)、投票放行(动 world / ops\data / 白名单要 2 位群友同意,凑不满前 1 票反对就作废)、服主名单(高危操作只有名单里的 QQ 能做)。拦截在插件层和 PowerShell 层各生效一次。
316
+
317
+ **支持 Linux / macOS 吗?**
318
+ 只读操作和启停已经跨平台(`ops/rcon.mjs` 是纯 Node);投票、白名单、绑定、KubeJS 这些写数据的动作还在 Windows 上,在别的平台调用会明确提示,不会报「找不到 PowerShell」。
319
+
320
+ **和 Pterodactyl 面板什么关系?**
321
+ `adapter=panel` 时,start / stop / restart / cmd 走 Pterodactyl 客户端 API;只读操作不经过适配器。要接 Pelican / AMP / PufferPanel 只需再写一个适配器文件。
322
+
323
+ **群服互通会消耗 token 吗?**
324
+ 不会。桥直接读日志、直接调 QQ 开放平台,不创建 agent 会话、不调模型。只有群友真的问问题时才走 AI。
325
+
289
326
  ## License
290
327
 
291
328
  MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-mc-server-ops",
3
- "version": "0.5.1",
3
+ "version": "0.5.2",
4
4
  "description": "在 DeepSeek Harness 里托管 Minecraft 服务器的插件:状态/启停/日志/白名单/投票授权,静态命令拦截,本地/Pterodactyl 可插拔适配器,游戏聊天直通 QQ 群(不经过 AI、不耗 token),并把人设注入 QQ 会话。需要先安装 QQ 机器人插件。",
5
5
  "type": "module",
6
6
  "main": "./index.js",
@@ -31,13 +31,20 @@
31
31
  "dsh",
32
32
  "dsh-plugin",
33
33
  "minecraft",
34
+ "minecraft-server",
35
+ "minecraft-server-manager",
34
36
  "server",
37
+ "server-management",
38
+ "game-server",
35
39
  "rcon",
36
40
  "pterodactyl",
37
41
  "qqbot",
42
+ "qq-group",
43
+ "kubejs",
38
44
  "cordis"
39
45
  ],
40
46
  "license": "MIT",
47
+ "author": "mogutofu (https://github.com/mogutofu)",
41
48
  "engines": {
42
49
  "node": ">=20.3.0",
43
50
  "dsh": ">=0.2.0-0"