339 处裸 console 之后：给扩展做一个带 scope 的日志层

export type LogLevel = 'debug' | 'info' | 'warn' | 'error';

/** 主配置在 chrome.storage.local 里的键。日志层只认这一个键，不 import 配置模块 */
const GENERAL_KEY = 'cfg:general';

const SESSION_ON_KEY = '__ext_debug';
const SESSION_SCOPE_KEY = '__ext_debug_scope';

let debugEnabled = false;         // 默认关
let sessionBackdoorOn = false;    // session 后门的本地镜像
let sessionScopeFilter: string | null = null;

/* ── 后门 ─────────────────────────────────────────────────────── */

function backdoorOn(): boolean {
  if (sessionBackdoorOn) return true;
  try {
    return localStorage.getItem(SESSION_ON_KEY) === '1';
  } catch {
    return false;   // Service Worker 没有 localStorage，走上面那个镜像
  }
}

/** 前缀匹配：填 'quick-ticket' 能盖住 'quick-ticket/fill-customer' */
function scopeAllowed(scope: string): boolean {
  let raw: string | null = sessionScopeFilter;
  if (raw === null) {
    try { raw = localStorage.getItem(SESSION_SCOPE_KEY); } catch { raw = null; }
  }
  if (!raw) return true;
  return raw.split(',').some((s) => {
    const t = s.trim();
    return t !== '' && (scope === t || scope.startsWith(t + '/'));
  });
}

/* ── 状态同步：各读一次 + 订阅变更。emit 是同步的，所以状态必须落到模块变量 ── */

void (async () => {
  try {
    const r = await chrome.storage.session.get([SESSION_ON_KEY, SESSION_SCOPE_KEY]);
    const v = r[SESSION_ON_KEY];
    sessionBackdoorOn = v === 1 || v === '1' || v === true;
    const sc = r[SESSION_SCOPE_KEY];
    sessionScopeFilter = typeof sc === 'string' && sc !== '' ? sc : null;
  } catch { /* 旧版浏览器没有 storage.session → 仅 localStorage 后门可用 */ }
})();

void (async () => {
  try {
    const r = await chrome.storage.local.get(GENERAL_KEY);
    const g = r[GENERAL_KEY] as { debugLog?: boolean } | undefined;
    if (typeof g?.debugLog === 'boolean') debugEnabled = g.debugLog;
  } catch { /* 极早期 / 受限环境 → 保持默认关 */ }
})();

try {
  chrome.storage.onChanged.addListener((changes, area) => {
    if (area === 'local' && GENERAL_KEY in changes) {
      debugEnabled = (changes[GENERAL_KEY].newValue as { debugLog?: boolean } | undefined)?.debugLog ?? false;
    }
    // 后门拨动后**即时生效**，不用重启 SW / 刷页
    if (area === 'session') {
      if (SESSION_ON_KEY in changes) {
        const v = changes[SESSION_ON_KEY].newValue;
        sessionBackdoorOn = v === 1 || v === '1' || v === true;
      }
      if (SESSION_SCOPE_KEY in changes) {
        const v = changes[SESSION_SCOPE_KEY].newValue;
        sessionScopeFilter = typeof v === 'string' && v !== '' ? v : null;
      }
    }
  });
} catch { /* 同上 */ }

function shouldEmit(level: LogLevel, scope: string): boolean {
  if (level === 'error') return true;            // ★ 恒开
  if (!debugEnabled && !backdoorOn()) return false;
  return scopeAllowed(scope);
}

/* ── 环形缓冲 ─────────────────────────────────────────────────── */

const LOG_RING_MAX = 2000;
const logRing: Array<{ t: number; level: LogLevel; scope: string; msg: string }> = [];

export function readLogRing(filter?: string) {
  const re = filter ? new RegExp(filter, 'i') : null;
  return logRing
    .filter((e) => !re || re.test(e.scope) || re.test(e.msg))
    .map((e) => ({
      at: new Date(e.t).toLocaleTimeString('zh-CN', { hour12: false })
        + '.' + String(e.t % 1000).padStart(3, '0'),
      level: e.level, scope: e.scope, msg: e.msg,
    }));
}

export function clearLogRing(): void { logRing.length = 0; }

/* ── 输出 ─────────────────────────────────────────────────────── */

function emit(level: LogLevel, scope: string, args: unknown[]): void {
  if (!shouldEmit(level, scope)) return;
  const tag = `[ext][${scope}]`;

  // 先进环形缓冲：不受 DevTools 的 Verbose 过滤和宿主的 console.clear 影响
  try {
    if (logRing.length >= LOG_RING_MAX) logRing.shift();
    logRing.push({
      t: Date.now(), level, scope,
      msg: args.map((a) => {
        if (typeof a === 'string') return a;
        try { return JSON.stringify(a); } catch { return String(a); }
      }).join(' ').slice(0, 1000),
    });
  } catch { /* 缓冲失败绝不能影响真正的日志输出 */ }

  // debug 走 console.debug：DevTools 默认折叠在 Verbose 里，不占 Info 区
  const sink = level === 'debug' ? console.debug
    : level === 'info' ? console.log
      : console[level];
  try {
    sink(tag, ...args);
  } catch { /* 有些页面会魔改 console，别让日志本身把功能打挂 */ }
}

export interface Logger {
  debug: (...args: unknown[]) => void;
  info: (...args: unknown[]) => void;
  warn: (...args: unknown[]) => void;
  /** 恒开，不受开关约束 */
  error: (...args: unknown[]) => void;
  child: (sub: string) => Logger;
}

export function createLogger(scope: string): Logger {
  return {
    debug: (...a) => emit('debug', scope, a),
    info: (...a) => emit('info', scope, a),
    warn: (...a) => emit('warn', scope, a),
    error: (...a) => emit('error', scope, a),
    child: (sub) => createLogger(`${scope}/${sub}`),
  };
}

/** 给设置页显示「当前实际生效状态」（含后门）用 */
export function isDebugLogOn(): boolean {
  return debugEnabled || backdoorOn();
}