cortico-world-hearthstone 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # 变更记录
 
+## 0.3.1
+
+**装完就能用：自己把炉石的 Power 日志打开**
+
+上一版只自动关掉了日志大小上限，**没管日志开没开** —— 而炉石的 Power 日志默认是关的，
+开关在用户目录：`%LOCALAPPDATA%\Blizzard\Hearthstone\log.config`。新机器上这个文件
+压根不存在，很多人也从没建过。
+
+症状很坑：`Power.log` 照样存在、照样能读、照样能监听，但里面只有几行错误，
+一行对局数据都没有。**它不报错**，所以看起来像「她一句话都不说」。实测新机器上是
+6 行 `SubSpellController ... Failed to load spell prefab`，`CREATE_GAME` 一次都没有。
+
+现在启动时检查 `[Power]` 段，缺了就补上（`LogLevel=1`、`FilePrinting=true`）：
+
+- 只动 `[Power]` 这一段，画质、分辨率、账号缓存那些一个字节都不碰
+- 改之前留 `log.config.bak`，备份失败就不改
+- 先写临时文件再改名，免得炉石正好启动读到半截配置（半截 ini 会被整段忽略，等于没开）
+- 补完要**重启一次炉石**才生效
+
+**状态灯不再说谎**
+
+日志文件在、但一行对局数据都没有时，以前照样亮绿灯写「已连上日志」。现在分两种情况：
+
+| 情况 | 灯 | 说什么 |
+|---|---|---|
+| 配置是这次才补的（还没重启炉石） | 红 | 「Power 日志之前没开，配置已经补好，重启一次炉石就生效」 |
+| 配置本来就开着，只是还没进对局 | 绿 | 「文件在，但里面还没有对局数据——炉石刚启动，或还没进对局」 |
+
+工具回执也直说原因，不再拿「现在没有进行中的对局」糊过去 —— 那句话会把正在打的人
+带进「我明明在打」的死胡同。
+
 ## 0.3.0
 
 首个公开发布版本。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortico-world-hearthstone",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "description": "Cortico World: 陪打炉石 —— 读对局日志,知道双方的血量、场面、手牌与水晶,在关键节点开口。只看不动游戏,不代打。需要先打开炉石的 Power 日志。",
   "author": {

package/src/log-config.ts

@@ -23,6 +23,7 @@
  * 所以唯一的正解是在它启动之前把上限关掉 —— 代价只是最后重启一次炉石。
  */
 import { copyFileSync, existsSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
 import { basename, dirname, join } from 'node:path';
 
 /** 炉石默认的日志上限（KB）。 */
@@ -237,3 +238,175 @@ export function describeLimit(before: number | null): string {
   if (before === -1) return '已经关掉上限';
   return `${before}KB`;
 }
+
+/* ------------------------------------------------------------------ */
+/* 另一件事：让炉石真的往 Power.log 里写对局数据                       */
+/* ------------------------------------------------------------------ */
+
+/**
+ * 炉石的 Power 日志默认是**关的**。
+ *
+ * `Power.log` 文件会存在（炉石启动时自己建），但里面只有错误行 —— 新机器上实测是
+ * 6 行 `SubSpellController ... Failed to load spell prefab`，`CREATE_GAME` 一次都没有。
+ * 开关在**用户目录**，不在安装目录：
+ *
+ *     %LOCALAPPDATA%\Blizzard\Hearthstone\log.config
+ *     [Power]
+ *     LogLevel=1
+ *     FilePrinting=true
+ *
+ * 没有这个文件就不写 GameState，扩展读到的永远是个空壳。
+ *
+ * 更麻烦的是它**不报错**：文件在、能读、能监听，就是没有内容。用户看到的是「她一句话不说」，
+ * 而不是「日志没开」。所以这层自己补上 —— 装完即用，不能让用户去翻 ini。
+ *
+ * 只动 `[Power]` 这一段，别的段一个字节都不碰；编码走 latin1 逐字节保真。
+ */
+export interface PowerLogResult {
+  configPath: string;
+  /** 动手之前这个文件存在吗。 */
+  existed: boolean;
+  /** 动手之前的状态。 */
+  before: 'ok' | 'incomplete' | 'absent';
+  /** 这次有没有真的写文件。 */
+  changed: boolean;
+  /** 没改成功的原因。 */
+  problem?: string;
+  backup?: string;
+}
+
+/** 炉石日志配置的位置（用户目录，与安装目录无关）。 */
+export function logConfigPath(): string {
+  const local = process.env.LOCALAPPDATA ?? join(homedir(), 'AppData', 'Local');
+  return join(local, 'Blizzard', 'Hearthstone', 'log.config');
+}
+
+/** `[Power]` 段里这两项齐了，炉石才把对局写进文件。 */
+const POWER_WANT: ReadonlyArray<readonly [string, string]> = [
+  ['LogLevel', '1'],
+  ['FilePrinting', 'true'],
+];
+
+/** 读一遍配置，判断 `[Power]` 段够不够用。 */
+export function powerLoggingState(text: string): 'ok' | 'incomplete' {
+  const seen = new Map<string, string>();
+  let section = '';
+  for (const raw of text.split(/\r?\n/)) {
+    const line = raw.trim();
+    if (!line || line.startsWith('#') || line.startsWith(';')) continue;
+    const sec = /^\[(.+)\]$/.exec(line);
+    if (sec) {
+      section = sec[1].trim().toLowerCase();
+      continue;
+    }
+    const eq = line.indexOf('=');
+    if (eq < 0 || section !== 'power') continue;
+    seen.set(line.slice(0, eq).trim().toLowerCase(), line.slice(eq + 1).trim().toLowerCase());
+  }
+  return POWER_WANT.every(([k, v]) => seen.get(k.toLowerCase()) === v) ? 'ok' : 'incomplete';
+}
+
+/**
+ * 把 `[Power]` 段补成能用的样子，其余原样：
+ * 已有的键只改值，缺的键插在该段末尾，整段都没有就在文件末尾补一段。
+ */
+export function patchPowerLogging(text: string): { text: string; changed: boolean } {
+  if (powerLoggingState(text) === 'ok') return { text, changed: false };
+  const eol = text.includes('\r\n') ? '\r\n' : '\n';
+  const lines = text.length ? text.split(/\r?\n/) : [];
+
+  let section = '';
+  let powerAt = -1;
+  let lastInPower = -1;
+  const have = new Set<string>();
+
+  for (let i = 0; i < lines.length; i += 1) {
+    const line = lines[i].trim();
+    if (!line || line.startsWith('#') || line.startsWith(';')) continue;
+    const sec = /^\[(.+)\]$/.exec(line);
+    if (sec) {
+      section = sec[1].trim().toLowerCase();
+      if (section === 'power') powerAt = i;
+      continue;
+    }
+    const eq = line.indexOf('=');
+    if (eq < 0 || section !== 'power') continue;
+    lastInPower = i;
+    const key = line.slice(0, eq).trim().toLowerCase();
+    const want = POWER_WANT.find(([k]) => k.toLowerCase() === key);
+    if (!want) continue;
+    have.add(key);
+    if (line.slice(eq + 1).trim().toLowerCase() !== want[1]) {
+      lines[i] = `${lines[i].slice(0, eq)}=${want[1]}`;
+    }
+  }
+
+  const missing = POWER_WANT.filter(([k]) => !have.has(k.toLowerCase()));
+  if (powerAt >= 0) {
+    const at = (lastInPower >= 0 ? lastInPower : powerAt) + 1;
+    lines.splice(at, 0, ...missing.map(([k, v]) => `${k}=${v}`));
+    return { text: lines.join(eol), changed: true };
+  }
+
+  const block = ['[Power]', ...POWER_WANT.map(([k, v]) => `${k}=${v}`)];
+  const tail = text.length && !text.endsWith('\n') ? eol : '';
+  const gap = text.length ? eol : '';
+  return { text: `${text}${tail}${gap}${block.join(eol)}${eol}`, changed: true };
+}
+
+/**
+ * 确保炉石会把对局写进 `Power.log`。
+ *
+ * 与 `ensureLogSizeUnlimited` 同一套谨慎标准：先备份，写的时候先临时文件再改名 ——
+ * 免得炉石正好启动读到半截配置（半截 ini 会让它整段忽略，等于没开）。
+ */
+export function ensurePowerLogging(configPath = logConfigPath()): PowerLogResult {
+  const existed = existsSync(configPath);
+  const text = readText(configPath);
+  const base: PowerLogResult = {
+    configPath,
+    existed,
+    before: text === null ? 'absent' : powerLoggingState(text),
+    changed: false,
+  };
+  if (text === null && existed) return { ...base, problem: 'log.config 读不出来（权限或格式）' };
+
+  const patched = patchPowerLogging(text ?? '');
+  if (!patched.changed) return base;
+
+  let backup: string | undefined;
+  if (text !== null) {
+    const bak = `${configPath}.bak`;
+    if (!existsSync(bak)) {
+      try {
+        copyFileSync(configPath, bak);
+        backup = bak;
+      } catch {
+        return { ...base, problem: '备份 log.config 失败，没敢改' };
+      }
+    } else {
+      backup = bak;
+    }
+  }
+
+  try {
+    const tmp = `${configPath}.tmp`;
+    writeFileSync(tmp, patched.text, 'latin1');
+    renameSync(tmp, configPath);
+  } catch (error) {
+    return { ...base, backup, problem: `写不进去（${(error as Error).message}）` };
+  }
+
+  return { ...base, changed: true, backup };
+}
+
+/** 供诊断文案用：一句话交代日志开没开。 */
+export function describePowerLogging(result: PowerLogResult): string {
+  if (result.problem) return `开不起来：${result.problem}`;
+  if (result.changed) {
+    return result.before === 'absent'
+      ? '之前没有 log.config，已建好（重启炉石后生效）'
+      : '之前 [Power] 段不全，已补齐（重启炉石后生效）';
+  }
+  return 'Power 日志已开着';
+}

package/src/world.ts

@@ -21,7 +21,10 @@ import { PowerLogTail, describeSearch, looksLikePowerLog, resolvePowerLog } from
 import { PowerLogParser, renderSnapshot, type ActionRecord, type GameSnapshot, type SideState, type TurnPoint } from './parser.ts';
 import { detectAlerts, endMarker, endText, faceOf, lethalText, startText, surpriseAlerts, toneOf } from './alerts.ts';
 import { panelAdvice, panelAskText, panelStatus, type PanelAdvice, type PanelStatus } from './panel.ts';
-import { describeLimit, ensureLogSizeUnlimited, installDirFromLog } from './log-config.ts';
+import {
+  describeLimit, describePowerLogging, ensureLogSizeUnlimited, ensurePowerLogging, installDirFromLog,
+  logConfigPath, type PowerLogResult,
+} from './log-config.ts';
 import { advise, buildModelPrompt, renderAdvice } from './advice.ts';
 import { askModel, pickKey, type LlmConfig } from './llm.ts';
 import { composeTurnEvent, settleTurnWatermark, shouldAnnounceTurn } from './turn-event.ts';
@@ -289,6 +292,13 @@ export class HearthstoneWorld implements World {
   private readonly parser = new PowerLogParser(nowIso);
   private tail: PowerLogTail | null = null;
   private status: WatchStatus = { phase: 'no-log', path: null, note: '还没开始读日志。' };
+  /**
+   * start() 时处理 log.config 的结果。
+   *
+   * 补过（changed=true）就说明这次还没重启过炉石 —— 在用户重启之前，
+   * 日志里不可能有对局数据，这时亮红灯是**如实报告**，不是误报。
+   */
+  private powerLog: PowerLogResult | null = null;
   private chain: Promise<void> = Promise.resolve();
   private lastSnapshot: GameSnapshot | null = null;
   private announcedStart = false;
@@ -372,6 +382,15 @@ export class HearthstoneWorld implements World {
   async start(host: WorldHost): Promise<void> {
     this.host = host;
     this.log = host.log;
+    // Power 日志默认是**关的**：开关在用户目录的 log.config 里，很多人从来没建过。
+    // 没开的时候炉石只往 Power.log 写错误行，扩展读到的是个空壳——而且不报错，
+    // 用户只会看到「她一句话不说」。和上面关日志上限是同一类事：装完即用，别让人翻 ini。
+    this.powerLog = ensurePowerLogging();
+    if (this.powerLog.problem) {
+      this.log?.warn(`炉石的 Power 日志开关没能处理:${this.powerLog.problem}`);
+    } else {
+      this.log?.info(`Power 日志:${describePowerLogging(this.powerLog)}`);
+    }
     this.parser.setHistoryLimit(this.opts.cfg.historySize);
     this.tail = new PowerLogTail({
       getPath: () => resolvePowerLog({ logPath: this.cfg.logPath, installDir: this.cfg.installDir }),
@@ -457,12 +476,28 @@ export class HearthstoneWorld implements World {
     // 用快照判,不要用 parser.inGame —— 后者只表示「日志里有过一局」,
     // 那局已经打完它也是 true,于是灯一直亮成「进行中」,她也会以为自己还在牌桌上。
     const s = this.parser.snapshot();
+    if (s) {
+      this.status = {
+        phase: s.ended ? 'ended' : 'in-game',
+        path,
+        note: s.ended ? '这局已经结束。' : `第 ${s.turn} 回合。`,
+      };
+      return;
+    }
+    // 文件在、却一行对局数据都没有:要么炉石刚启动还没进对局,要么 Power 日志根本没开。
+    // 这两种必须分开 —— 前者一开打就恢复,后者得重启炉石,红灯不能乱亮。
+    // 判据用 powerLog.changed:配置是这次才补上的,那就一定还没重启过,亮红灯是如实报告。
+    if (looksLikePowerLog(path)) {
+      this.status = { phase: 'watching', path, note: '已连上日志。' };
+      return;
+    }
+    const waitingRestart = this.powerLog?.changed === true;
     this.status = {
-      phase: s ? (s.ended ? 'ended' : 'in-game') : 'watching',
+      phase: waitingRestart ? 'no-log' : 'watching',
       path,
-      note: s
-        ? (s.ended ? '这局已经结束。' : `第 ${s.turn} 回合。`)
-        : (looksLikePowerLog(path) ? '已连上日志。' : '文件在,但里面还没有对局数据——炉石可能刚启动,或 Power 日志没开全。'),
+      note: waitingRestart
+        ? 'Power 日志之前没开,配置已经补好,重启一次炉石就生效。'
+        : '文件在,但里面还没有对局数据——炉石刚启动,或还没进对局。',
     };
   }
 
@@ -1225,6 +1260,16 @@ export class HearthstoneWorld implements World {
         '要让她看得到,得先打开炉石的日志:在 %LOCALAPPDATA%\\Blizzard\\Hearthstone\\log.config 里写 [Power] 段(LogLevel=1、FilePrinting=true),然后重启炉石。装到别的盘的话,在设置里填一下「炉石安装目录」。',
       ].join('\n');
     }
+    // 日志文件在、但里面没有对局数据:最常见的原因不是「没在打」,是 Power 日志压根没开。
+    // 这时候只说「现在没有进行中的对局」等于把用户往「我明明在打」的死胡同里带。
+    if (this.powerLog?.changed) {
+      const where = this.powerLog.configPath || logConfigPath();
+      return [
+        `现在看不到对局:日志在 ${this.status.path},但里面一行对局数据都没有。`,
+        `原因是炉石的 Power 日志之前没开。已经补好 ${where}([Power] 段:LogLevel=1、FilePrinting=true),**重启一次炉石就生效**。`,
+        '之前已经打的对局补不回来 —— 那段时间炉石根本没往文件里写。',
+      ].join('\n');
+    }
     return `现在没有进行中的对局。日志在:${this.status.path}。${this.status.note}`;
   }