cortico 0.1.0

package/src/worlds/minecraft/console/access.ts

@@ -0,0 +1,218 @@
+/**
+ * 面板 `access` —— 权限与作弊。
+ *
+ * 专用服务器没有单人存档里那个「开作弊」勾选框。同一件事在这里是两半:**谁在
+ * ops.json 里**(能不能下 /tp、/gamemode、/spectate 这类指令),以及
+ * `op-permission-level`(op 拿到第几级,4 才够全部指令)。所以这一屏的主体是一份
+ * 名单,而不是一个开关。
+ *
+ * 吃这份名单的是 **bot 与人在游戏里打的命令**:mc_escape 的 /tp、把玩家传送到她
+ * 旁边、摄像机附身——服务器由 World 托管时它们走控制台 stdin(天生 4 级,不看名单),
+ * 外部起的服务器上就只剩这条退路。
+ *
+ * 时机与「存档与玩法」同一条规则,只是这里有两份都只在启动时读的文件:停机时改
+ * 文件;跑着且是托管的,名单能走控制台 op/deop 当场生效(服务端自己写回文件),
+ * server.properties 那几项一概要停机;外部起的跑着时什么都改不了。
+ */
+
+import type {
+  ConsolePanelContext,
+  ConsolePanel,
+} from '../../../web/shared/client-panel.ts';
+import {
+  errText,
+  msgLine,
+  type MinecraftAccessMember,
+  type MinecraftAccessState,
+} from './client.ts';
+
+const DESC =
+  '专用服没有「开作弊」那个勾选框:能不能下 /tp、/gamemode 全看名字在不在管理员'
+  + '名单(ops.json)里。她的 mc_escape、把你传送到她旁边、摄像机附身都吃这份名单'
+  + '——服务器由本 World 托管时它们走控制台,不吃;外部起的服务器上就只剩这条路。';
+
+/** 三个有名有姓的身份 + 名单里别的名字 */
+const ROLE_ZH: Record<MinecraftAccessMember['role'], { label: string; note: string }> = {
+  bot: { label: '她', note: '游戏内账号(worlds.minecraft.username)' },
+  camera: { label: '摄像机', note: '观察者客户端账号' },
+  player: { label: '玩家', note: '你自己进服那份客户端' },
+  other: { label: '其他', note: '名单里已有的名字' },
+};
+
+const LEVELS = [
+  { value: '1', label: '1 级 · 绕过出生点保护' },
+  { value: '2', label: '2 级 · 大部分单人作弊指令' },
+  { value: '3', label: '3 级 · 加上封禁踢人' },
+  { value: '4', label: '4 级 · 全部(含 /stop)' },
+];
+
+export const accessPanel: ConsolePanel = {
+  mount(ctx: ConsolePanelContext) {
+    const { ui, root } = ctx;
+
+    // -----------------------------------------------------------------------
+    // 卡一:管理员名单
+    // -----------------------------------------------------------------------
+    const card = ui.sheet({ title: '权限与作弊', en: 'cheats & permissions', desc: DESC });
+    const s = card.body;
+    root.appendChild(card.el);
+
+    const msg = msgLine(ctx);
+    s.appendChild(msg.el);
+
+    const stateBox = ui.h('div');
+    s.append(ui.section('当前'), stateBox);
+
+    const list = ui.table({ head: ['名字', '身份', '作弊权限', ''] });
+    s.append(ui.section('管理员名单', 'ops.json;服务器只在启动时读它'), list.el);
+
+    const addName = ui.input({ placeholder: '游戏名' });
+    const btnAdd = ui.button('授权', { size: 'sm' });
+    const addBar = ui.actions();
+    addBar.append(ui.field('另外授权一个名字', addName), ui.h('span', 'grow'), btnAdd);
+    s.append(addBar);
+
+    // -----------------------------------------------------------------------
+    // 卡二:服务器权限项(server.properties)
+    // -----------------------------------------------------------------------
+    const propCard = ui.sheet({
+      title: '服务器权限项',
+      en: 'permission properties',
+      desc: '写在 server.properties 里,服务器只在启动时读一次——这几项都要停机改,下次启动生效。',
+    });
+    const p = propCard.body;
+    root.appendChild(propCard.el);
+
+    const levelSel = ui.select({ options: LEVELS });
+    const cmdBlockIn = ui.checkbox('命令方块可用');
+    const flightIn = ui.checkbox('允许飞行(不踢)');
+    const onlineIn = ui.checkbox('正版验证');
+    const whiteIn = ui.checkbox('白名单');
+    const btnApply = ui.button('应用', { size: 'sm', variant: 'primary' });
+    const propForm = ui.h('div', 'mc-form');
+    propForm.append(ui.field('op 权限等级', levelSel));
+    const propBar = ui.actions();
+    propBar.append(cmdBlockIn.el, flightIn.el, onlineIn.el, whiteIn.el, ui.h('span', 'grow'), btnApply);
+    const propNote = ui.h('div', 'pagedesc',
+      '正版验证开着时她、摄像机、玩家这三个离线账号都进不来;白名单开着则名单外的进不来。');
+    p.append(propForm, propBar, propNote);
+
+    // -----------------------------------------------------------------------
+
+    let cur: MinecraftAccessState | null = null;
+
+    function memberRow(m: MinecraftAccessMember, st: MinecraftAccessState): void {
+      const role = ROLE_ZH[m.role];
+      const who = ui.h('span', null, role.label);
+      who.title = role.note;
+      const btn = ui.button(m.op ? '收回' : '授权', { size: 'sm', variant: m.op ? 'plain' : 'primary' });
+      btn.disabled = !st.configured || (st.live && !st.hosted);
+      btn.addEventListener('click', () => {
+        void act(() => ctx.invoke<MinecraftAccessState>('setOp', [m.name, !m.op]), m.op ? '收回中…' : '授权中…');
+      }, { signal: ctx.signal });
+      list.addRow([
+        { text: m.name, cls: 'mono' },
+        who,
+        m.op ? ui.pill(`有 · ${m.level} 级`, 'on') : ui.pill('没有', 'off'),
+        btn,
+      ]);
+    }
+
+    function render(st: MinecraftAccessState | null): void {
+      if (ctx.signal.aborted) return;
+      cur = st;
+      if (!st) {
+        msg.say('权限设置不可用', true);
+        stateBox.replaceChildren(ui.placeholder('读不到服务器目录里的 ops.json'));
+        list.clear('—');
+        return;
+      }
+      stateBox.replaceChildren(ui.kv([
+        {
+          k: '服务器',
+          v: ui.pill(
+            st.live ? (st.hosted ? '运行中(本 World 托管)' : '运行中(外部)') : '已停机',
+            st.live ? 'on' : 'plain',
+          ),
+        },
+        {
+          k: '自动授权',
+          v: st.autoOp
+            ? ui.pill('开 · 每次启动前补齐名单', 'on')
+            : ui.pill('关 · 只按名单现状来', 'off'),
+        },
+        { k: '服务器目录', v: st.serverDir || '(未配置)' },
+      ]));
+
+      list.clear();
+      if (!st.members.length) list.clear('名单是空的');
+      else for (const m of st.members) memberRow(m, st);
+
+      levelSel.value = String(st.settings.opPermissionLevel);
+      cmdBlockIn.setChecked(st.settings.enableCommandBlock);
+      flightIn.setChecked(st.settings.allowFlight);
+      onlineIn.setChecked(st.settings.onlineMode);
+      whiteIn.setChecked(st.settings.whiteList);
+
+      const stopped = !st.live;
+      const off = !st.configured;
+      addName.disabled = btnAdd.disabled = off || (st.live && !st.hosted);
+      levelSel.disabled = cmdBlockIn.input.disabled = off || !stopped;
+      flightIn.input.disabled = onlineIn.input.disabled = off || !stopped;
+      whiteIn.input.disabled = btnApply.disabled = off || !stopped;
+
+      msg.say(st.detail || (st.live && !st.hosted
+        ? '服务器是外部起的,没有控制台可用:名单与这几项都要先停机才改得了'
+        : st.live
+          ? '服务器跑着:名单走控制台当场生效,下面那几项要先停机'
+          : ''));
+    }
+
+    const refresh = (): Promise<void> =>
+      ctx.invoke<MinecraftAccessState>('state').then(render, () => render(null));
+
+    /** 一次动作:置灰两颗钮 → 调服务端 → 拿回来的新状态重画(先解锁再重画)。 */
+    async function act(fn: () => Promise<MinecraftAccessState>, working: string): Promise<void> {
+      msg.say(working);
+      const lock = ui.disable(btnAdd, btnApply);
+      let next: MinecraftAccessState | null = null;
+      try {
+        next = await fn();
+      } catch (err) {
+        if (!ctx.signal.aborted) msg.say(`操作失败: ${errText(err)}`, true);
+      } finally {
+        lock.dispose();
+      }
+      if (next) render(next);
+    }
+
+    btnAdd.addEventListener('click', () => {
+      const name = addName.value.trim();
+      if (!name) {
+        msg.say('先写个游戏名', true);
+        return;
+      }
+      void act(async () => {
+        const next = await ctx.invoke<MinecraftAccessState>('setOp', [name, true]);
+        addName.value = '';
+        return next;
+      }, '授权中…');
+    }, { signal: ctx.signal });
+
+    btnApply.addEventListener('click', () => {
+      if (cur?.live) {
+        msg.say('这几项服务器只在启动时读,要先把它停下来', true);
+        return;
+      }
+      void act(() => ctx.invoke<MinecraftAccessState>('apply', [{
+        opPermissionLevel: Number(levelSel.value),
+        enableCommandBlock: cmdBlockIn.checked,
+        allowFlight: flightIn.checked,
+        onlineMode: onlineIn.checked,
+        whiteList: whiteIn.checked,
+      }]), '应用中…');
+    }, { signal: ctx.signal });
+
+    void refresh();
+  },
+};

package/src/worlds/minecraft/console/client.ts

@@ -0,0 +1,244 @@
+/**
+ * Minecraft World 的浏览器插件 —— 挂载 / 皮肤 / 存档与玩法 / 权限与作弊 /
+ * World 日志五个面板。
+ *
+ * 这个文件只做两件事:**装配**(把五个面板接到局部 id 上)与**共享 helper**
+ * (各面板都要的一行回执、错误措辞,以及服务端各方法的返回形状)。
+ * 面板本体各在自己的文件里。
+ *
+ * 与外界的依赖只有一条:`client-panel.ts` 里的类型与 `toDisposable`。没有
+ * import 控制台内部模块,没有 `fetch`,没有 `document.body`,没有 `window.__*`
+ * ——数据面一律走 `ctx.invoke` / `ctx.invokeBinary`,DOM 一律用 `ctx.ui` 的原语,
+ * 定时器一律走 `ctx.interval`,ObjectURL 一律交给 `ctx.own`。
+ *
+ * `style.css` 是本 provider 自己的样式:只放 `ctx.ui` 没有对应原语的那几块
+ * (挂载行状态词的配色、并排表单、保留换行的正文段、图片预览),用 `mc-` 前缀
+ * 避开控制台的通用 class。
+ *
+ * **服务端那边的 panel id 与方法名一个字都没改。** 挂载面板管的是三条链路
+ * (游戏服务器 / 观察者客户端 / 玩家客户端),它们各自的 `state` / `start` / `stop`
+ * 早就在那儿了;这里只是在方法名前面缀上是哪一条(`server.state`、`client.start`),
+ * 好让三条链路共处一个局部 id。
+ */
+
+import type {
+  ConsoleClientBundle,
+  ConsolePanelContext,
+} from '../../../web/shared/client-panel.ts';
+import './style.css';
+import { accessPanel } from './access.ts';
+import { skinPanel } from './skin.ts';
+import { mountPanel } from './mount.ts';
+import { worldPanel } from './world.ts';
+import { logPanel } from './log.ts';
+
+// ---------------------------------------------------------------------------
+// 共享类型:服务端 `MinecraftWorld.invokePanel` 各方法的返回形状
+// ---------------------------------------------------------------------------
+
+/** 三条链路共有的那几项。托管进程没起时 `pid` 为 null,外部起的照样可能就绪。 */
+interface MinecraftLaneCommon {
+  /** `stopped` / `starting` / `running` / `error` */
+  phase: string;
+  detail: string | null;
+  pid: number | null;
+}
+
+/** `mount.server.*` */
+export interface MinecraftServerState extends MinecraftLaneCommon {
+  address: string;
+  /** 端口当下可连(外部自己起的服务器也算) */
+  reachable: boolean;
+  serverDir: string;
+  configured: boolean;
+}
+
+/** `mount.client.*`。客户端没有可探的端口,判据是"窗口出来了没"。 */
+export interface MinecraftClientState extends MinecraftLaneCommon {
+  enabled: boolean;
+  windowReady: boolean;
+  gameDir: string;
+  versionId: string;
+  username: string;
+  configured: boolean;
+  command: string | null;
+}
+
+interface MinecraftGameSettings {
+  gamemode: string;
+  difficulty: string;
+  hardcore: boolean;
+  pvp: boolean;
+  spawnMonsters: boolean;
+  /** 空 = 随机 */
+  levelSeed: string;
+  levelName: string;
+  /** 世界类型;只在世界第一次生成时起作用 */
+  levelType: string;
+  /** 生成器细则 JSON(超平坦层配方 / 单群系名) */
+  generatorSettings: string;
+  generateStructures: boolean;
+  allowNether: boolean;
+  spawnProtection: number;
+  viewDistance: number;
+  simulationDistance: number;
+  maxWorldSize: number;
+}
+
+/** 存档目录的 level.dat 自述;读不出来的项为 null */
+interface MinecraftLevelDatInfo {
+  levelName: string | null;
+  lastPlayed: number | null;
+  seed: string | null;
+  gameType: number | null;
+  difficulty: number | null;
+  hardcore: boolean | null;
+  version: string | null;
+  /** flat / amplified / large_biomes / normal */
+  generator: string | null;
+  dayTime: number | null;
+}
+
+export interface MinecraftWorldInfo {
+  name: string;
+  /** 目录里有 level.dat = 已经生成过 */
+  generated: boolean;
+  /** 最后活跃(ISO):优先 level.dat 的 LastPlayed,退回文件 mtime */
+  modified: string | null;
+  sizeBytes: number;
+  /** 已生成的附属维度:nether / the_end */
+  dimensions: string[];
+  info: MinecraftLevelDatInfo | null;
+}
+
+/** `world.state` */
+export interface MinecraftWorldState {
+  configured: boolean;
+  serverDir: string;
+  /** 服务器跑着(含外部起的):只有难度与默认游戏模式能热改 */
+  live: boolean;
+  /** 由 World 托管;只有托管进程提供控制台 stdin */
+  hosted: boolean;
+  worlds: MinecraftWorldInfo[];
+  settings: MinecraftGameSettings;
+  /** 超平坦层配方的常用预设(服务端那一份词表) */
+  flatPresets: ReadonlyArray<{ id: string; label: string; note: string; json: string }>;
+  /** 世界类型的中文词表(同上) */
+  levelTypes: ReadonlyArray<{ value: string; label: string; note: string }>;
+  detail: string | null;
+}
+
+/** `access.state` 名单里的一位 */
+export interface MinecraftAccessMember {
+  name: string;
+  /** bot=她自己 / camera=观察者摄像机 / player=人的客户端 / other=名单里别的名字 */
+  role: 'bot' | 'camera' | 'player' | 'other';
+  op: boolean;
+  /** 名单里那条的权限等级;不在名单里为 0 */
+  level: number;
+}
+
+/** `access.state` */
+export interface MinecraftAccessState {
+  configured: boolean;
+  serverDir: string;
+  /** 服务器跑着(含外部起的) */
+  live: boolean;
+  /** 由 World 托管:跑着的时候名单也能经控制台 op/deop 当场改 */
+  hosted: boolean;
+  /** worlds.minecraft.local.cheats:每次启动前把三个名字补进名单 */
+  autoOp: boolean;
+  members: MinecraftAccessMember[];
+  settings: {
+    opPermissionLevel: number;
+    enableCommandBlock: boolean;
+    allowFlight: boolean;
+    onlineMode: boolean;
+    whiteList: boolean;
+  };
+  detail: string | null;
+}
+
+/** `skin.state` 里某个角色选着的那张 */
+interface MinecraftSkinInfo {
+  width: number;
+  height: number;
+  bytes: number;
+  /** 选中的时刻(ISO) */
+  at: string;
+}
+
+/** `skin.state` 里的一个角色:她自己,或人那份客户端 */
+export interface MinecraftSkinRole {
+  role: 'bot' | 'player';
+  /** 皮肤按这个账号名铺进游戏目录 */
+  username: string;
+  /** 选着的那张;null = 没选 */
+  skin: MinecraftSkinInfo | null;
+  /** 两份游戏目录里此刻铺着的正是这张 */
+  installed: { camera: boolean; player: boolean };
+}
+
+/** `skin.state` */
+export interface MinecraftSkinState {
+  roles: MinecraftSkinRole[];
+  dirs: { camera: string; player: string };
+  /** CustomSkinLoader 装了没:没装则皮肤铺得再对也不会被读 */
+  mod: { camera: boolean; player: boolean };
+  /** 客户端正跑着:换了皮肤要它重进一次服务器才刷新 */
+  live: { camera: boolean; player: boolean };
+  detail: string | null;
+}
+
+/** `log.entries` 的一条 */
+export interface MinecraftLogEntry {
+  seq: number;
+  ts: string;
+  lane: string;
+  event: string;
+  msg: string;
+  taskId?: number;
+  durMs?: number;
+}
+
+// ---------------------------------------------------------------------------
+// 共享 helper
+// ---------------------------------------------------------------------------
+
+/** 错误 → 一句人话。`ConsoleInvokeError` 带的就是服务端的中文措辞。 */
+export function errText(err: unknown): string {
+  return err instanceof Error ? err.message : String(err);
+}
+
+/** 一行回执(`.msgline`),三个面板都有一条。`say(null)` 清空。 */
+export interface MinecraftMsgLine {
+  el: HTMLDivElement;
+  say(text?: string | null, bad?: boolean): void;
+}
+
+export function msgLine(ctx: ConsolePanelContext, cls?: string): MinecraftMsgLine {
+  const el = ctx.ui.msgline('');
+  if (cls) el.classList.add(cls);
+  return {
+    el,
+    say(text, bad) {
+      el.textContent = text ?? '';
+      el.classList.toggle('bad', bad === true);
+    },
+  };
+}
+
+// ---------------------------------------------------------------------------
+
+const bundle: ConsoleClientBundle = {
+  // 键是**局部** panel id,与服务端 `console().panels[].id` 一一对应。
+  panels: {
+    mount: mountPanel,
+    skin: skinPanel,
+    world: worldPanel,
+    access: accessPanel,
+    log: logPanel,
+  },
+};
+
+export default bundle;

package/src/worlds/minecraft/console/log.ts

@@ -0,0 +1,110 @@
+/**
+ * World 日志面板，按泳道筛选增量记录。
+ * 日志滚动与裁剪由 ui.log 管理，轮询随 ctx.interval 的面板生命周期结束。
+ * WorldConsoleDecl 仅提供 invoke；按序号每两秒拉取新增条目。
+ */
+
+import type {
+  ConsolePanelContext,
+  ConsolePanel,
+} from '../../../web/shared/client-panel.ts';
+import type { MinecraftLogEntry } from './client.ts';
+
+const DESC =
+  '一场试玩里下过的每一道令、投递出去的每一句、每一步的结局与耗时。'
+  + '同一份进运行日志(data/runs/<run>/log.jsonl,区域 worlds.minecraft.<泳道>,事后 logq 查),这里只留最近 2000 条。';
+
+/**
+ * 泳道表。与 `src/worlds/minecraft/log.ts` 的 `LANE_ZH` 同一份词表——那边是 Node
+ * 模块(读写文件),浏览器 bundle 不能 import 它,所以这里抄一份。
+ */
+const LANES: ReadonlyArray<readonly [string, string]> = [
+  ['tool', '工具'], ['event', '投递'], ['task', '任务'], ['skill', '技能'], ['craft', '合成'],
+  ['inventory', '物品'], ['path', '寻路'], ['body', '身体'], ['reflex', '反射'], ['combat', '战斗'],
+  ['link', '连接'], ['world', '世界'],
+];
+
+const LANE_ZH: Record<string, string> = Object.fromEntries(LANES);
+
+/** 内存里留多少条(与落盘那份无关;那边是完整的)。 */
+const KEEP = 2000;
+const POLL_MS = 2000;
+
+export const logPanel: ConsolePanel = {
+  mount(ctx: ConsolePanelContext) {
+    const { ui, root } = ctx;
+    const card = ui.foldSheet('log', { title: 'World 日志', en: 'module log', desc: DESC });
+    const s = card.body;
+    root.appendChild(card.el);
+
+    /** 关掉的泳道。默认一个都不关。 */
+    const off = new Set<string>();
+    const bar = ui.rowbar();
+    for (const [lane, label] of LANES) {
+      const box = ui.checkbox(label, {
+        checked: true,
+        title: `不看${label}这一类记录时把它取消勾选`,
+        onChange: (on) => {
+          if (on) off.delete(lane); else off.add(lane);
+          redraw();
+        },
+      });
+      bar.appendChild(box.el);
+    }
+    const btnEnd = ui.button('回到底部', { size: 'sm' });
+    bar.append(ui.h('span', 'grow'), btnEnd);
+    s.appendChild(bar);
+
+    const view = ui.log({ max: KEEP, maxHeight: '320px', empty: '(等待日志…)' });
+    s.appendChild(view.el);
+    btnEnd.addEventListener('click', () => view.scrollToEnd(), { signal: ctx.signal });
+
+    /** 收到过的条目(未过滤)。切泳道时按它整份重铺。 */
+    let entries: MinecraftLogEntry[] = [];
+    let lastSeq = 0;
+
+    const lineOf = (e: MinecraftLogEntry): string => {
+      const t = ctx.ui.fmt.clock(e.ts);
+      const task = e.taskId ? ` #${e.taskId}` : '';
+      const dur = e.durMs === undefined ? '' : ` (${e.durMs}ms)`;
+      return `[${t}] ${LANE_ZH[e.lane] ?? e.lane}${task} | ${e.msg}${dur}`;
+    };
+
+    const shownCount = (): number => entries.filter((e) => !off.has(e.lane)).length;
+
+    const noteCount = (): void => {
+      card.note.textContent = `${shownCount()} 条${off.size ? `(关了 ${off.size} 条泳道)` : ''}`;
+    };
+
+    /** 切泳道:整份重铺(这是唯一会重画已有行的路径,日志本身只往末尾长)。 */
+    const redraw = (): void => {
+      view.clear();
+      for (const e of entries) if (!off.has(e.lane)) view.append(lineOf(e));
+      noteCount();
+      view.scrollToEnd();
+    };
+
+    let polling = false;
+    const poll = (): void => {
+      if (polling) return;
+      polling = true;
+      void ctx.invoke<{ entries?: MinecraftLogEntry[] }>('entries', [lastSeq]).then(
+        (out) => {
+          polling = false;
+          if (ctx.signal.aborted) return;
+          const fresh = out?.entries ?? [];
+          if (fresh.length === 0) return;
+          for (const e of fresh) lastSeq = Math.max(lastSeq, e.seq);
+          entries = entries.concat(fresh).slice(-KEEP);
+          for (const e of fresh) if (!off.has(e.lane)) view.append(lineOf(e));
+          noteCount();
+        },
+        () => { polling = false; /* 下一拍再试 */ },
+      );
+    };
+
+    noteCount();
+    ctx.interval(poll, POLL_MS);
+    poll();
+  },
+};