cortico 0.1.0

package/src/worlds/minecraft/window.ts

@@ -0,0 +1,96 @@
+/**
+ * 观察者客户端那扇窗:有没有出来、改标题。
+ *
+ * 走 Windows PowerShell + user32(见 client-window.ps1),不引第三方原生依赖。
+ * 认哪扇窗一律按 `ownerPid`:同一台机器上还有人自己玩的那份客户端,
+ * 除了进程没有第二个凭据分得开她的窗口和别人的窗口。标题改成账号名是给 OBS 认的。
+ */
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import type { Logger } from '../../core/types.ts';
+
+const SCRIPT = fileURLToPath(new URL('./client-window.ps1', import.meta.url));
+
+interface ScriptOutput {
+  ok?: boolean;
+  error?: string;
+  title?: string;
+}
+
+function runScript(args: string[], timeoutMs: number): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const proc = spawn(
+      'powershell.exe',
+      ['-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-File', SCRIPT, ...args],
+      { windowsHide: true },
+    );
+    let out = '';
+    let err = '';
+    const timer = setTimeout(() => {
+      try { proc.kill(); } catch { /* 已退出 */ }
+      reject(new Error(`窗口探测超时 ${timeoutMs}ms`));
+    }, timeoutMs);
+    proc.stdout.on('data', (c: Buffer) => { out += c.toString(); });
+    proc.stderr.on('data', (c: Buffer) => { err += c.toString(); });
+    proc.on('error', (e) => { clearTimeout(timer); reject(e); });
+    proc.on('close', (code) => {
+      clearTimeout(timer);
+      if (code !== 0 && !out.trim()) reject(new Error(`powershell code=${code} ${err.slice(-300)}`));
+      else resolve(out);
+    });
+  });
+}
+
+function parseLast(raw: string): ScriptOutput | null {
+  const line = raw.trim().split(/\r?\n/).filter(Boolean).pop() ?? '';
+  try {
+    return JSON.parse(line) as ScriptOutput;
+  } catch {
+    return null;
+  }
+}
+
+/** 客户端就绪判定:进程名下出现了一扇可见窗口。非 Windows 一律 false。 */
+export async function findWindow(opts: { ownerPid: number; log?: Logger }): Promise<boolean> {
+  if (process.platform !== 'win32') return false;
+  let raw: string;
+  try {
+    raw = await runScript(['-OwnerPid', String(opts.ownerPid)], 15_000);
+  } catch (err) {
+    opts.log?.warn(`窗口探测失败: ${(err as Error).message}`);
+    return false;
+  }
+  const parsed = parseLast(raw);
+  if (!parsed) {
+    opts.log?.warn(`窗口探测输出看不懂: ${raw.trim().slice(-200)}`);
+    return false;
+  }
+  if (!parsed.ok && parsed.error && parsed.error !== 'no-window') opts.log?.warn(`窗口探测: ${parsed.error}`);
+  return parsed.ok === true;
+}
+
+/** 按进程改窗口标题。给 OBS 按标题区分两份客户端;失败不抛。 */
+export async function setWindowTitle(opts: {
+  ownerPid: number;
+  title: string;
+  log?: Logger;
+}): Promise<boolean> {
+  if (process.platform !== 'win32' || !opts.title) return false;
+  let raw: string;
+  try {
+    raw = await runScript(['-OwnerPid', String(opts.ownerPid), '-SetTitle', opts.title], 8_000);
+  } catch (err) {
+    opts.log?.warn(`窗口标题未改成 ${opts.title}: ${(err as Error).message}`);
+    return false;
+  }
+  const parsed = parseLast(raw);
+  if (!parsed) {
+    opts.log?.warn(`窗口标题输出看不懂: ${raw.trim().slice(-200)}`);
+    return false;
+  }
+  if (parsed.ok) return true;
+  if (parsed.error && parsed.error !== 'no-window') {
+    opts.log?.warn(`窗口标题未改成 ${opts.title}: ${parsed.error}`);
+  }
+  return false;
+}

package/src/worlds/minecraft/works.ts

@@ -0,0 +1,179 @@
+/**
+ * 按维度与坐标持久化已完成成果，跨任务保留。
+ * 寻路禁止在登记格头顶垫脚；显式挖掘与放置仍执行，并在回执中报告涉及的成果数量。
+ */
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+
+/** 登记的三类。`blueprint` 是完工蓝图占的格,`farmland` 是锄成的耕地,`crop` 是种下的作物 */
+type WorkKind = 'blueprint' | 'farmland' | 'crop';
+
+const WORK_KIND_ZH: Record<WorkKind, string> = {
+  blueprint: '建成的蓝图', farmland: '耕地', crop: '作物',
+};
+
+interface WorkCell {
+  kind: WorkKind;
+  /** 登记那一刻这一格是什么(蓝图记材料名、耕地记 farmland、作物记作物方块名) */
+  block: string;
+  /** 蓝图记图名,别的为 null */
+  site: string | null;
+  /** 登记时刻(epoch ms) */
+  at: number;
+}
+
+/** 落盘形状:维度 → "x,y,z" → 一格 */
+type WorksFile = Record<string, Record<string, WorkCell>>;
+
+const WORK_KINDS = new Set<string>(['blueprint', 'farmland', 'crop']);
+
+export function cellKey(x: number, y: number, z: number): string {
+  return `${x},${y},${z}`;
+}
+
+function parseFile(raw: string): WorksFile {
+  let data: unknown;
+  try {
+    data = JSON.parse(raw);
+  } catch {
+    return {};
+  }
+  if (typeof data !== 'object' || data === null) return {};
+  const out: WorksFile = {};
+  for (const [dim, cells] of Object.entries(data as Record<string, unknown>)) {
+    if (typeof cells !== 'object' || cells === null) continue;
+    const kept: Record<string, WorkCell> = {};
+    for (const [key, v] of Object.entries(cells as Record<string, unknown>)) {
+      const c = v as Partial<WorkCell>;
+      if (!WORK_KINDS.has(String(c.kind)) || typeof c.block !== 'string') continue;
+      kept[key] = {
+        kind: c.kind as WorkKind,
+        block: c.block,
+        site: typeof c.site === 'string' ? c.site : null,
+        at: typeof c.at === 'number' ? c.at : 0,
+      };
+    }
+    if (Object.keys(kept).length > 0) out[dim] = kept;
+  }
+  return out;
+}
+
+export function loadWorks(file: string | null): WorksFile {
+  if (!file || !existsSync(file)) return {};
+  try {
+    const raw = readFileSync(file, 'utf8').trim();
+    return raw ? parseFile(raw) : {};
+  } catch {
+    return {};
+  }
+}
+
+export interface WorkHit extends WorkCell {
+  x: number;
+  y: number;
+  z: number;
+}
+
+export class WorksBook {
+  private works: WorksFile;
+
+  constructor(private readonly file: string | null) {
+    this.works = loadWorks(file);
+  }
+
+  /** 登记一格。同一格重登(耕地被踩回去又锄一遍)覆盖旧的,时刻跟着刷新 */
+  note(dimension: string, x: number, y: number, z: number, cell: Omit<WorkCell, 'at'>, now = Date.now()): void {
+    const dim = (this.works[dimension] ??= {});
+    dim[cellKey(x, y, z)] = { ...cell, at: now };
+    this.save();
+  }
+
+  /** 一批一起登记(蓝图完工):只落一次盘 */
+  noteMany(
+    dimension: string,
+    cells: ReadonlyArray<{ x: number; y: number; z: number } & Omit<WorkCell, 'at'>>,
+    now = Date.now(),
+  ): void {
+    if (cells.length === 0) return;
+    const dim = (this.works[dimension] ??= {});
+    for (const c of cells) {
+      dim[cellKey(c.x, c.y, c.z)] = { kind: c.kind, block: c.block, site: c.site, at: now };
+    }
+    this.save();
+  }
+
+  at(dimension: string, x: number, y: number, z: number): WorkCell | null {
+    return this.works[dimension]?.[cellKey(x, y, z)] ?? null;
+  }
+
+  has(dimension: string, x: number, y: number, z: number): boolean {
+    return this.at(dimension, x, y, z) !== null;
+  }
+
+  /** 这一批格子里哪些在登记上;按传入顺序返回 */
+  inCells(
+    dimension: string,
+    cells: ReadonlyArray<{ x: number; y: number; z: number }>,
+  ): WorkHit[] {
+    const dim = this.works[dimension];
+    if (!dim) return [];
+    const out: WorkHit[] = [];
+    for (const c of cells) {
+      const hit = dim[cellKey(c.x, c.y, c.z)];
+      if (hit) out.push({ ...hit, x: c.x, y: c.y, z: c.z });
+    }
+    return out;
+  }
+
+  /** 撤销一格的登记:她把它拆了/挖了,登记不该留着骗下一次 */
+  forget(dimension: string, x: number, y: number, z: number): void {
+    const dim = this.works[dimension];
+    if (!dim?.[cellKey(x, y, z)]) return;
+    delete dim[cellKey(x, y, z)];
+    if (Object.keys(dim).length === 0) delete this.works[dimension];
+    this.save();
+  }
+
+  count(dimension?: string): number {
+    if (dimension !== undefined) return Object.keys(this.works[dimension] ?? {}).length;
+    return Object.values(this.works).reduce((n, d) => n + Object.keys(d).length, 0);
+  }
+
+  stat(): string {
+    const n = this.count();
+    if (!this.file || !existsSync(this.file)) return n === 0 ? '(无文件)' : `${n} 格(未落盘)`;
+    const kb = (statSync(this.file).size / 1024).toFixed(1);
+    return `${n} 格 / ${kb}KB`;
+  }
+
+  clear(): string {
+    const n = this.count();
+    this.works = {};
+    if (this.file) {
+      mkdirSync(dirname(this.file), { recursive: true });
+      writeFileSync(this.file, '{}\n', 'utf8');
+    }
+    return n === 0 ? '成果登记是空的' : `成果登记已清空(${n} 格)`;
+  }
+
+  private save(): void {
+    if (!this.file) return;
+    mkdirSync(dirname(this.file), { recursive: true });
+    writeFileSync(this.file, `${JSON.stringify(this.works)}\n`, 'utf8');
+  }
+}
+
+/**
+ * 「这一框里有你 N 格登记的耕地/作物」那句。按类别合并计数,各报最早那一笔的时刻;
+ * 一格都没有返回 null(不出这一行)。
+ */
+export function worksNote(hits: readonly WorkHit[], clock: (ms: number) => string): string | null {
+  if (hits.length === 0) return null;
+  const byKind = new Map<WorkKind, { n: number; at: number }>();
+  for (const h of hits) {
+    const cur = byKind.get(h.kind);
+    if (cur) { cur.n++; cur.at = Math.min(cur.at, h.at); } else byKind.set(h.kind, { n: 1, at: h.at });
+  }
+  const bits = [...byKind].map(([kind, v]) => `${v.n} 格${WORK_KIND_ZH[kind]}(记于 ${clock(v.at)})`);
+  return `这一框里有你${bits.join('、')}`;
+}