dsh-mc-server-ops 0.6.0 → 0.6.1

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.
package/README.md CHANGED
@@ -96,7 +96,7 @@ dsh plugin add /path/to/dsh-mc-server-ops
96
96
  | `vote.protectedPaths` | `world, ops/data, whitelist` | 改动这些位置需要群友投票放行 |
97
97
  | `bridge.enabled` | `true` | 是否启用群服互通(游戏聊天 → QQ 群) |
98
98
  | `bridge.mode` | `auto` | `auto` 有玩家在线才转发 / `on` 常开 / `off` 常关 |
99
- | `bridge.groups` | `[]` | 转发到哪些群(群 openid) |
99
+ | `bridge.groups` | `[]` | 转发到哪些群(群 openid);留空 = 自动用上次记住/最近捕获的群,重装插件不会哑 |
100
100
  | `bridge.events` | 三项都关 | 除聊天外还转发哪些事件(进出服和死亡默认不转,防刷屏) |
101
101
  | `bridge.coalesceMs` | `3000` | 固定合并窗口(`coalesce.mode=fixed` 时用) |
102
102
  | `bridge.coalesce.mode` | `auto` | 合并窗口:`auto` 按最近发言节奏 + 在线人数自动调整 / `fixed` 固定 |
@@ -242,6 +242,8 @@ powershell -File <服务器目录>\ops\mcadmin.ps1 -Action owner-add -Arg <openi
242
242
 
243
243
  群 openid 不知道怎么办:官方没有「列出机器人加入的群」的稳定接口(`/v2/users/@me/groups` 直接 404),只能从一条真实的群消息里抓一次。详细过程写在 [docs/qq-bridge.md](https://github.com/mogutofu/dsh-mc-server-ops/blob/main/docs/qq-bridge.md)。
244
244
 
245
+ 插件会自动记住用过的群:正常转发过一次后,群 openid 会存到 `ops/data/bridge-groups.json`;`bridge.groups` 留空或因为重装插件被重置时,自动用上次记住的群,再退回最近捕获的群(`ops/data/qq-keys.txt`),所以**重装/升级插件不会再让群服互通断掉**。状态和日志里会标出来源(`config` / `remembered` / `captured`)。
246
+
245
247
  ## 游戏内 AI 对话(/ai)
246
248
 
247
249
  配套 Forge mod:[mogutofu/dsh-mc-ai-chat](https://github.com/mogutofu/dsh-mc-ai-chat)(服务端 Forge 1.20.1-47.x)。玩家在游戏里输入 `/ai 你好`,mod 会把请求 POST 到本机 `127.0.0.1:8765/mc-ai`,插件开一个 agent 回合,再把回复贴回玩家聊天栏。mod **1.1.0** 起还支持附件:`/ai screenshot` 截游戏画面、`/ai file <路径>` 读玩家本机的文件。
package/client.js CHANGED
@@ -415,8 +415,8 @@ window.__ModuleLoader__.load({
415
415
  h("option", { value: "auto" }, "有玩家时开启(默认)"),
416
416
  h("option", { value: "on" }, "常开启"),
417
417
  h("option", { value: "off" }, "常关闭"))),
418
- h(Field, { label: "转发到哪些群", hint: "群 openid,逗号分隔。不知道的话在群里 @ 小铜 问" },
419
- h(TextInput, { value: form.bridge.groups, placeholder: "FC73DE60… ", onChange: (x) => patchBridge("groups", x) })),
418
+ h(Field, { label: "转发到哪些群", hint: "群 openid,逗号分隔。不知道的话在群里 @ 小铜 问;留空 = 自动用上次记住的群,重装插件不会丢" },
419
+ h(TextInput, { value: form.bridge.groups, placeholder: "留空 = 自动(上次记住的群)", onChange: (x) => patchBridge("groups", x) })),
420
420
  h(Field, { label: "除聊天外还转发", hint: "聊天始终转发。进服/退服默认关(会刷屏),死亡消息默认开" },
421
421
  h("div", { style: { display: "flex", gap: 18, flexWrap: "wrap" } },
422
422
  h(Toggle, { label: "玩家加入(默认关)", value: form.bridge.events.join, onChange: (x) => patchBridgeEvent("join", x) }),
package/index.js CHANGED
@@ -188,7 +188,7 @@ const DESCRIPTION = [
188
188
  '- vote-status:查看投票进度(可带编号)',
189
189
  '- export-data:把 ops\\data(绑定、投票、服主名单、口令)打成 zip,arg 为目标路径,仅服主',
190
190
  '- import-data:从 zip 恢复 ops\\data,arg 为 zip 路径,仅服主',
191
- '- bridge-groups:列出机器人加入的 QQ 群(群名 + 群 openid),配置群服互通时用来填 groups,仅服主',
191
+ '- bridge-groups:列出机器人加入的 QQ 群(群名 + 群 openid),配置群服互通时用来填 groups;QQ 接口列不出来时回退到本地记录/最近捕获的群,仅服主',
192
192
  '',
193
193
  '玩家可以改服务器目录下除敏感区(ops\\data、world、白名单、eula、jar/exe/dll、密钥)之外的文件:kubejs 配方、config/defaultconfigs 配置、server.properties 等,write/edit 直接放行;改之前先备份,改完按需 reload。',
194
194
  '玩家不能改 kubejs 目录以外的任何文件。',
@@ -722,6 +722,75 @@ export function apply(ctx, config) {
722
722
  panel: (liveConfig && liveConfig.panel) || {},
723
723
  })
724
724
 
725
+ // ── 群服互通的目标群:配置 → 上次记住 → 本地捕获(qq-keys.txt)三层兜底 ──
726
+ // 插件配置存在 profile 的 cordis.patch.yml 里;重装/升级插件时 DSH 会重建这条配置行,
727
+ // 用户填的 bridge.groups 会丢。群 openid 本身可以本地记住,所以这里做持久化 + 自动恢复,
728
+ // 避免「重装一次插件,群服互通就哑了」。
729
+ const BRIDGE_GROUPS_FILE = join(opsDir, 'data', 'bridge-groups.json')
730
+ function readBridgeGroupList(list) {
731
+ return Array.isArray(list) ? list.map((x) => String(x || '').trim()).filter(Boolean) : []
732
+ }
733
+ function rememberBridgeGroups(groups) {
734
+ const list = [...new Set(readBridgeGroupList(groups))]
735
+ if (!list.length) return
736
+ try {
737
+ mkdirSync(join(opsDir, 'data'), { recursive: true })
738
+ writeFileSync(BRIDGE_GROUPS_FILE, JSON.stringify({ at: new Date().toISOString(), groups: list }, null, 2) + '\n', 'utf8')
739
+ } catch (error) { }
740
+ }
741
+ function loadRememberedBridgeGroups() {
742
+ try {
743
+ const doc = JSON.parse(readFileSync(BRIDGE_GROUPS_FILE, 'utf8'))
744
+ return readBridgeGroupList(Array.isArray(doc) ? doc : doc && doc.groups)
745
+ } catch (error) { return [] }
746
+ }
747
+ function loadCapturedBridgeGroups(limit = 3) {
748
+ // qqbot 的 inbound.js 抓到群消息时会把 openid 记进 ops/data/qq-keys.txt(每行「时间 group OPENID」)
749
+ try {
750
+ const text = readFileSync(join(opsDir, 'data', 'qq-keys.txt'), 'utf8')
751
+ const seen = []
752
+ for (const line of text.split(/\r?\n/)) {
753
+ const match = /\bgroup\s+([0-9A-Za-z]{16,64})\b/.exec(line)
754
+ if (!match) continue
755
+ const openid = match[1]
756
+ const index = seen.indexOf(openid)
757
+ if (index !== -1) seen.splice(index, 1)
758
+ seen.push(openid)
759
+ }
760
+ return seen.slice(-limit).reverse()
761
+ } catch (error) { return [] }
762
+ }
763
+ let bridgeGroupsState = { groups: [], source: 'none' }
764
+ let lastBridgeGroupsLog = ''
765
+ function resolveBridgeGroups(rawBridge) {
766
+ const configured = readBridgeGroupList(rawBridge && rawBridge.groups)
767
+ if (configured.length) {
768
+ rememberBridgeGroups(configured)
769
+ bridgeGroupsState = { groups: configured, source: 'config' }
770
+ } else {
771
+ const remembered = loadRememberedBridgeGroups()
772
+ if (remembered.length) {
773
+ bridgeGroupsState = { groups: remembered, source: 'remembered' }
774
+ } else {
775
+ const captured = loadCapturedBridgeGroups()
776
+ if (captured.length) {
777
+ rememberBridgeGroups(captured)
778
+ bridgeGroupsState = { groups: captured, source: 'captured' }
779
+ } else {
780
+ bridgeGroupsState = { groups: [], source: 'none' }
781
+ }
782
+ }
783
+ }
784
+ const key = bridgeGroupsState.source + ':' + bridgeGroupsState.groups.join(',')
785
+ if (key !== lastBridgeGroupsLog) {
786
+ lastBridgeGroupsLog = key
787
+ try {
788
+ appendFileSync(join(opsDir, 'data', 'bridge.log'), new Date().toISOString() + ' [bridge] 群目标:' + (bridgeGroupsState.groups.join(', ') || '(空)') + '(来源:' + bridgeGroupsState.source + ')\n')
789
+ } catch (error) { }
790
+ }
791
+ return bridgeGroupsState
792
+ }
793
+
725
794
  // ── 群服互通:游戏聊天 → QQ 群(不经过 AI,不产生 token)──
726
795
  // 常驻创建、常驻运行:是否真的转发由 liveConfig.bridge.enabled 决定,
727
796
  // 这样在面板里打开开关立刻生效,不用再重启一次。
@@ -734,17 +803,24 @@ export function apply(ctx, config) {
734
803
  serverDir,
735
804
  appId,
736
805
  appSecret,
737
- readConfig: () => (liveConfig && liveConfig.bridge) || {},
806
+ readConfig: () => {
807
+ const raw = (liveConfig && liveConfig.bridge) || {}
808
+ const resolved = resolveBridgeGroups(raw)
809
+ return Object.assign({}, raw, { groups: resolved.groups, groupsSource: resolved.source })
810
+ },
738
811
  log: (m) => {
739
812
  try { appendFileSync(join(opsDir, 'data', 'bridge.log'), new Date().toISOString() + ' ' + m + '\n') } catch { }
740
813
  },
741
814
  })
742
815
  ctx.effect(() => {
816
+ resolveBridgeGroups((liveConfig && liveConfig.bridge) || {})
743
817
  void bridge.start()
744
818
  const tick = setInterval(() => {
819
+ resolveBridgeGroups((liveConfig && liveConfig.bridge) || {})
745
820
  writeBridgeState(serverDir, Object.assign(
746
821
  { appId: appId ? appId.slice(0, 3) + '***' : '', hasSecret: !!appSecret },
747
822
  bridge.status(),
823
+ { groups: bridgeGroupsState.groups, groupsSource: bridgeGroupsState.source },
748
824
  ))
749
825
  }, 10000)
750
826
  if (tick.unref) tick.unref()
@@ -1065,10 +1141,20 @@ export function apply(ctx, config) {
1065
1141
  try {
1066
1142
  const groups = await new QqApi({ appId, appSecret }).listGroups()
1067
1143
  if (!groups.length) return { ok: true, text: '机器人还没加入任何群(或者没有「群管理」权限,拿不到群列表)。' }
1144
+ rememberBridgeGroups(groups.map((g) => g.openid))
1068
1145
  return { ok: true, text: groups.map((g) => g.name + '\n ' + g.openid).join('\n') }
1069
1146
  } catch (error) {
1070
1147
  const message = error && error.message ? error.message : String(error)
1071
- return { ok: false, text: '查群列表失败:' + message + '\n(需要 AppID/AppSecret,以及开放平台的「群管理」权限)' }
1148
+ const local = [...new Set([...loadRememberedBridgeGroups(), ...loadCapturedBridgeGroups()])]
1149
+ if (local.length) {
1150
+ return {
1151
+ ok: true,
1152
+ text: 'QQ 接口不支持直接列群(' + message + '),改用本地记录到的群 openid:\n'
1153
+ + local.join('\n')
1154
+ + '\n\n填到「群服互通 → 转发到哪些群」即可;留空也会自动用这些群。',
1155
+ }
1156
+ }
1157
+ return { ok: false, text: '查群列表失败:' + message + '\n(需要 AppID/AppSecret,以及开放平台的「群管理」权限;也可以让群友在群里 @ 一次机器人来捕获群 openid)' }
1072
1158
  }
1073
1159
  }
1074
1160
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-mc-server-ops",
3
- "version": "0.6.0",
3
+ "version": "0.6.1",
4
4
  "description": "在 DeepSeek Harness 里托管 Minecraft 服务器的插件:状态/启停/日志/白名单/投票授权,静态命令拦截,本地/Pterodactyl 可插拔适配器,游戏聊天直通 QQ 群(不经过 AI、不耗 token),把人设注入 QQ 会话,并让游戏内玩家用 /ai 和「小铜」对话(配套 Forge mod)。需要先安装 QQ 机器人插件。",
5
5
  "type": "module",
6
6
  "main": "./index.js",