oh-langfuse 0.1.53 → 0.1.55

package/scripts/codex-langfuse-setup.mjs

@@ -1,24 +1,24 @@
 import fs from "node:fs";
 import fsp from "node:fs/promises";
 import path from "node:path";
-import os from "node:os";
-import { execFileSync, spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { writeRuntimeInstallRecord } from "./runtime-state-utils.mjs";
-
-const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const USER_ID_PATTERN = /^[a-z](?:\d{8}|wx\d{7})$/;
-const USER_ID_PATTERN_TEXT = "^[a-z](?:\\d{8}|wx\\d{7})$";
-
-function normalizeUserId(v) {
-  return String(v || "").trim();
-}
-
-function assertValidUserId(userId) {
-  if (!USER_ID_PATTERN.test(normalizeUserId(userId))) {
-    throw new Error(`工号格式不正确：--userId 必须匹配 ${USER_ID_PATTERN_TEXT}，例如 h00613222 或 hwx1234567`);
-  }
-}
+import os from "node:os";
+import { execFileSync, spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { writeRuntimeInstallRecord } from "./runtime-state-utils.mjs";
+
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const USER_ID_PATTERN = /^[a-z](?:\d{8}|wx\d{7})$/;
+const USER_ID_PATTERN_TEXT = "^[a-z](?:\\d{8}|wx\\d{7})$";
+
+function normalizeUserId(v) {
+  return String(v || "").trim();
+}
+
+function assertValidUserId(userId) {
+  if (!USER_ID_PATTERN.test(normalizeUserId(userId))) {
+    throw new Error(`工号格式不正确：--userId 必须匹配 ${USER_ID_PATTERN_TEXT}，例如 h00613222 或 hwx1234567`);
+  }
+}
 
 function parseArgs(argv) {
   const args = {};
@@ -65,297 +65,341 @@ function pythonExecutableInVenv(venvDir) {
     : path.join(venvDir, "bin", "python");
 }
 
-function shQuote(s) {
-  return `'${String(s).replace(/'/g, "'\"'\"'")}'`;
-}
-
-function psQuote(s) {
-  return `'${String(s).replace(/'/g, "''")}'`;
-}
-
-function cmdQuote(s) {
-  return `"${String(s).replace(/"/g, '""')}"`;
-}
-
-function autoUpdateRuntimePath() {
-  return path.join(packageRoot, "scripts", "auto-update-runtime.mjs");
-}
-
-function autoUpdateHelperDir() {
-  return path.join(os.homedir(), ".config", "oh-langfuse", "bin");
-}
-
-function writeAutoUpdateHelper(target) {
-  const helperDir = autoUpdateHelperDir();
-  ensureDir(helperDir);
-  const runtimePath = autoUpdateRuntimePath();
-  const fallbackArgs = ["-y", "oh-langfuse@latest", "auto-update", target, "--skip-check", "--startup-status"];
-
-  if (process.platform === "win32") {
-    const helper = path.join(helperDir, `oh-langfuse-auto-update-${target}.cmd`);
-    const lines = [
-      "@echo off",
-      "REM Auto-generated by scripts/codex-langfuse-setup.mjs",
-      `if exist ${cmdQuote(runtimePath)} (`,
-      `  call ${cmdQuote(process.execPath)} ${cmdQuote(runtimePath)} ${target} --skip-check --startup-status %*`,
-      ") else (",
-      `  call npx.cmd ${fallbackArgs.map(cmdQuote).join(" ")} %*`,
-      ")",
-      "exit /b 0",
-      ""
-    ];
-    fs.writeFileSync(helper, lines.join(os.EOL), "utf8");
-    return helper;
-  }
-
-  const helper = path.join(helperDir, `oh-langfuse-auto-update-${target}`);
-  const lines = [
-    "#!/usr/bin/env sh",
-    "# Auto-generated by scripts/codex-langfuse-setup.mjs",
-    "set +e",
-    `if [ -f ${shQuote(runtimePath)} ]; then`,
-    `  ${shQuote(process.execPath)} ${shQuote(runtimePath)} ${shQuote(target)} --skip-check --startup-status "$@"`,
-    "else",
-    `  npx ${fallbackArgs.map(shQuote).join(" ")} "$@"`,
-    "fi",
-    "exit 0",
-    ""
-  ];
-  fs.writeFileSync(helper, lines.join("\n"), "utf8");
-  fs.chmodSync(helper, 0o755);
-  return helper;
-}
-
-function windowsAutoUpdateCommand(target) {
-  return `call ${cmdQuote(writeAutoUpdateHelper(target))}`;
-}
-
-function unixAutoUpdateCommand(target) {
-  return `${shQuote(writeAutoUpdateHelper(target))} || true`;
-}
-
-function isPathInsideDir(candidate, dir) {
-  if (!candidate || !dir) return false;
-  const relative = path.relative(path.resolve(dir), path.resolve(candidate));
-  return relative === "" || (relative && !relative.startsWith("..") && !path.isAbsolute(relative));
-}
-
-function existingCliCandidate(candidate, shimDir) {
-  if (!candidate || isPathInsideDir(candidate, shimDir)) return "";
+function pythonCanImport(pythonCmd, moduleName) {
   try {
-    return fs.existsSync(candidate) ? candidate : "";
+    execFileSync(pythonCmd, ["-c", `import ${moduleName}`], { stdio: "ignore" });
+    return true;
   } catch {
-    return "";
+    return false;
   }
 }
 
-function listCliCandidatesFromPath(target) {
-  const cmd = process.platform === "win32" ? "where.exe" : "which";
-  const args = process.platform === "win32" ? [target] : ["-a", target];
-  const result = spawnSync(cmd, args, { encoding: "utf8", windowsHide: true });
-  if (result.status !== 0) return [];
-  const candidates = String(result.stdout || "")
-    .split(/\r?\n/)
-    .map((line) => line.trim())
-    .filter(Boolean);
-  return process.platform === "win32" ? sortWindowsCliCandidates(candidates) : candidates;
-}
-
-function sortWindowsCliCandidates(candidates) {
-  const extPriority = (candidate) => {
-    const ext = path.extname(String(candidate || "")).toLowerCase();
-    if (ext === ".cmd" || ext === ".bat" || ext === ".exe") return 0;
-    return 1;
-  };
-  return [...candidates].sort((a, b) => extPriority(a) - extPriority(b));
-}
-
-function resolveAgentCli({ target, preferred = "", shimDir = "" }) {
-  const appData = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
-  const candidates = [
-    preferred,
-    process.platform === "win32" ? path.join(appData, "npm", `${target}.cmd`) : "",
-    process.platform === "win32" ? path.join(appData, "npm", `${target}.exe`) : "",
-    process.platform === "win32" ? path.join(appData, "npm", target) : "",
-    ...listCliCandidatesFromPath(target)
+function runPipInstallWithFallback({ pythonCmd, pipIndexUrl }) {
+  const attempts = [
+    { command: pythonCmd, args: ["-m", "pip", "install", "--user", "-U", "langfuse", "-i", pipIndexUrl] },
+    { command: "pip3", args: ["install", "--user", "-U", "langfuse", "-i", pipIndexUrl] },
+    { command: "pip", args: ["install", "--user", "-U", "langfuse", "-i", pipIndexUrl] }
   ];
-  for (const candidate of candidates) {
-    const found = existingCliCandidate(candidate, shimDir);
-    if (found) return found;
-  }
-  return "";
-}
-
-function prependWindowsUserPath(dir) {
-  if (process.platform !== "win32") return false;
-  const cmd = [
-    "$ErrorActionPreference = 'Stop';",
-    `$dir = ${psQuote(dir)};`,
-    "$current = [Environment]::GetEnvironmentVariable('Path', 'User');",
-    "$parts = @();",
-    "if ($current) { $parts = $current -split ';' | Where-Object { $_ -and $_.Trim() } }",
-    "$exists = $false;",
-    "foreach ($part in $parts) { if ([string]::Equals($part.TrimEnd('\\'), $dir.TrimEnd('\\'), [StringComparison]::OrdinalIgnoreCase)) { $exists = $true } }",
-    "if (-not $exists) {",
-    "  $next = (@($dir) + $parts) -join ';';",
-    "  [Environment]::SetEnvironmentVariable('Path', $next, 'User');",
-    "}"
-  ].join(" ");
-  const result = spawnSync("powershell", ["-NoProfile", "-Command", cmd], { stdio: "inherit", windowsHide: true });
-  if (result.status !== 0) throw new Error("Failed to prepend Codex Langfuse shim to the user PATH.");
 
-  const currentParts = String(process.env.PATH || "").split(path.delimiter);
-  const normalized = dir.replace(/[\\/]+$/, "").toLowerCase();
-  if (!currentParts.some((part) => part && part.replace(/[\\/]+$/, "").toLowerCase() === normalized)) {
-    process.env.PATH = `${dir}${path.delimiter}${process.env.PATH || ""}`;
-  }
-  return true;
-}
-
-function writeAgentCommandShim({ baseDir, target, executable, realCli, publicKey, secretKey, baseUrl, userId }) {
-  if (!realCli) return null;
-  const shimDir = path.join(baseDir, "bin");
-  ensureDir(shimDir);
-  if (process.platform === "win32") {
-    const shim = path.join(shimDir, `${executable}.cmd`);
-    const envPrefix = `OH_LANGFUSE_${target.toUpperCase()}_SHIM`;
-    const content = [
-      "@echo off",
-      "REM Auto-generated by scripts/codex-langfuse-setup.mjs",
-      `set ${envPrefix}=1`,
-      `set LANGFUSE_PUBLIC_KEY=${publicKey}`,
-      `set LANGFUSE_SECRET_KEY=${secretKey}`,
-      `set LANGFUSE_BASEURL=${baseUrl}`,
-      userId ? `set LANGFUSE_USER_ID=${userId}` : null,
-      windowsAutoUpdateCommand(target),
-      `call ${cmdQuote(realCli)} %*`,
-      "exit /b %ERRORLEVEL%",
-      ""
-    ].filter(Boolean).join(os.EOL);
-    fs.writeFileSync(shim, content, "utf8");
-    return { shim, shimDir };
+  const errors = [];
+  for (const attempt of attempts) {
+    try {
+      console.log(`Trying Python package install: ${attempt.command} ${attempt.args.join(" ")}`);
+      execFileSync(attempt.command, attempt.args, { stdio: "inherit" });
+      return;
+    } catch (error) {
+      errors.push(`${attempt.command}: ${error?.message || error}`);
+    }
   }
 
-  const shim = path.join(shimDir, executable);
-  const lines = [
-    "#!/usr/bin/env sh",
-    "# Auto-generated by scripts/codex-langfuse-setup.mjs",
-    "set -eu",
-    `export OH_LANGFUSE_${target.toUpperCase()}_SHIM=1`,
-    `export LANGFUSE_PUBLIC_KEY=${shQuote(publicKey)}`,
-    `export LANGFUSE_SECRET_KEY=${shQuote(secretKey)}`,
-    `export LANGFUSE_BASEURL=${shQuote(baseUrl)}`,
-    userId ? `export LANGFUSE_USER_ID=${shQuote(userId)}` : null,
-    unixAutoUpdateCommand(target),
-    `exec ${shQuote(realCli)} "$@"`,
-    ""
-  ].filter(Boolean);
-  fs.writeFileSync(shim, lines.join("\n"), "utf8");
-  fs.chmodSync(shim, 0o755);
-  return { shim, shimDir };
+  throw new Error(
+    `Failed to install langfuse with system Python/pip. Tried python -m pip, pip3, and pip. Last errors: ${errors.join(" | ")}`
+  );
 }
 
-function createAgentLauncher({ baseDir, target, executable }) {
-  if (process.platform === "win32") {
-    const launcher = path.join(baseDir, `launch-${target}-langfuse.cmd`);
-    const content = [
-      "@echo off",
-      windowsAutoUpdateCommand(target),
-      `${executable} %*`,
-      ""
-    ].join(os.EOL);
-    fs.writeFileSync(launcher, content, "utf8");
-    return launcher;
+function installLangfuseWithSystemPython({ pythonCmd, pipIndexUrl }) {
+  console.log("Python venv is unavailable; falling back to system Python user install for langfuse.");
+  runPipInstallWithFallback({ pythonCmd, pipIndexUrl });
+  if (!pythonCanImport(pythonCmd, "langfuse")) {
+    throw new Error("langfuse was installed with pip, but python3 still cannot import it. Install python3-venv and rerun setup, for example: sudo apt install python3-venv");
   }
-
-  const launcher = path.join(baseDir, `launch-${target}-langfuse.sh`);
-  const content = [
-    "#!/usr/bin/env sh",
-    "set -eu",
-    unixAutoUpdateCommand(target),
-    `exec ${shQuote(executable)} "$@"`,
-    ""
-  ].join("\n");
-  fs.writeFileSync(launcher, content, "utf8");
-  fs.chmodSync(launcher, 0o755);
-  return launcher;
+  return pythonCmd;
 }
+
+function shQuote(s) {
+  return `'${String(s).replace(/'/g, "'\"'\"'")}'`;
+}
 
-function createOrUpdateLangfuseVenv({ baseDir, pipIndexUrl = "https://pypi.tuna.tsinghua.edu.cn/simple" }) {
+function psQuote(s) {
+  return `'${String(s).replace(/'/g, "''")}'`;
+}
+
+function cmdQuote(s) {
+  return `"${String(s).replace(/"/g, '""')}"`;
+}
+
+function autoUpdateRuntimePath() {
+  return path.join(packageRoot, "scripts", "auto-update-runtime.mjs");
+}
+
+function autoUpdateHelperDir() {
+  return path.join(os.homedir(), ".config", "oh-langfuse", "bin");
+}
+
+function writeAutoUpdateHelper(target) {
+  const helperDir = autoUpdateHelperDir();
+  ensureDir(helperDir);
+  const runtimePath = autoUpdateRuntimePath();
+  const fallbackArgs = ["-y", "oh-langfuse@latest", "auto-update", target, "--skip-check", "--startup-status"];
+
+  if (process.platform === "win32") {
+    const helper = path.join(helperDir, `oh-langfuse-auto-update-${target}.cmd`);
+    const lines = [
+      "@echo off",
+      "REM Auto-generated by scripts/codex-langfuse-setup.mjs",
+      `if exist ${cmdQuote(runtimePath)} (`,
+      `  call ${cmdQuote(process.execPath)} ${cmdQuote(runtimePath)} ${target} --skip-check --startup-status %*`,
+      ") else (",
+      `  call npx.cmd ${fallbackArgs.map(cmdQuote).join(" ")} %*`,
+      ")",
+      "exit /b 0",
+      ""
+    ];
+    fs.writeFileSync(helper, lines.join(os.EOL), "utf8");
+    return helper;
+  }
+
+  const helper = path.join(helperDir, `oh-langfuse-auto-update-${target}`);
+  const lines = [
+    "#!/usr/bin/env sh",
+    "# Auto-generated by scripts/codex-langfuse-setup.mjs",
+    "set +e",
+    `if [ -f ${shQuote(runtimePath)} ]; then`,
+    `  ${shQuote(process.execPath)} ${shQuote(runtimePath)} ${shQuote(target)} --skip-check --startup-status "$@"`,
+    "else",
+    `  npx ${fallbackArgs.map(shQuote).join(" ")} "$@"`,
+    "fi",
+    "exit 0",
+    ""
+  ];
+  fs.writeFileSync(helper, lines.join("\n"), "utf8");
+  fs.chmodSync(helper, 0o755);
+  return helper;
+}
+
+function windowsAutoUpdateCommand(target) {
+  return `call ${cmdQuote(writeAutoUpdateHelper(target))}`;
+}
+
+function unixAutoUpdateCommand(target) {
+  return `${shQuote(writeAutoUpdateHelper(target))} || true`;
+}
+
+function isPathInsideDir(candidate, dir) {
+  if (!candidate || !dir) return false;
+  const relative = path.relative(path.resolve(dir), path.resolve(candidate));
+  return relative === "" || (relative && !relative.startsWith("..") && !path.isAbsolute(relative));
+}
+
+function existingCliCandidate(candidate, shimDir) {
+  if (!candidate || isPathInsideDir(candidate, shimDir)) return "";
+  try {
+    return fs.existsSync(candidate) ? candidate : "";
+  } catch {
+    return "";
+  }
+}
+
+function listCliCandidatesFromPath(target) {
+  const cmd = process.platform === "win32" ? "where.exe" : "which";
+  const args = process.platform === "win32" ? [target] : ["-a", target];
+  const result = spawnSync(cmd, args, { encoding: "utf8", windowsHide: true });
+  if (result.status !== 0) return [];
+  const candidates = String(result.stdout || "")
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean);
+  return process.platform === "win32" ? sortWindowsCliCandidates(candidates) : candidates;
+}
+
+function sortWindowsCliCandidates(candidates) {
+  const extPriority = (candidate) => {
+    const ext = path.extname(String(candidate || "")).toLowerCase();
+    if (ext === ".cmd" || ext === ".bat" || ext === ".exe") return 0;
+    return 1;
+  };
+  return [...candidates].sort((a, b) => extPriority(a) - extPriority(b));
+}
+
+function resolveAgentCli({ target, preferred = "", shimDir = "" }) {
+  const appData = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
+  const candidates = [
+    preferred,
+    process.platform === "win32" ? path.join(appData, "npm", `${target}.cmd`) : "",
+    process.platform === "win32" ? path.join(appData, "npm", `${target}.exe`) : "",
+    process.platform === "win32" ? path.join(appData, "npm", target) : "",
+    ...listCliCandidatesFromPath(target)
+  ];
+  for (const candidate of candidates) {
+    const found = existingCliCandidate(candidate, shimDir);
+    if (found) return found;
+  }
+  return "";
+}
+
+function prependWindowsUserPath(dir) {
+  if (process.platform !== "win32") return false;
+  const cmd = [
+    "$ErrorActionPreference = 'Stop';",
+    `$dir = ${psQuote(dir)};`,
+    "$current = [Environment]::GetEnvironmentVariable('Path', 'User');",
+    "$parts = @();",
+    "if ($current) { $parts = $current -split ';' | Where-Object { $_ -and $_.Trim() } }",
+    "$exists = $false;",
+    "foreach ($part in $parts) { if ([string]::Equals($part.TrimEnd('\\'), $dir.TrimEnd('\\'), [StringComparison]::OrdinalIgnoreCase)) { $exists = $true } }",
+    "if (-not $exists) {",
+    "  $next = (@($dir) + $parts) -join ';';",
+    "  [Environment]::SetEnvironmentVariable('Path', $next, 'User');",
+    "}"
+  ].join(" ");
+  const result = spawnSync("powershell", ["-NoProfile", "-Command", cmd], { stdio: "inherit", windowsHide: true });
+  if (result.status !== 0) throw new Error("Failed to prepend Codex Langfuse shim to the user PATH.");
+
+  const currentParts = String(process.env.PATH || "").split(path.delimiter);
+  const normalized = dir.replace(/[\\/]+$/, "").toLowerCase();
+  if (!currentParts.some((part) => part && part.replace(/[\\/]+$/, "").toLowerCase() === normalized)) {
+    process.env.PATH = `${dir}${path.delimiter}${process.env.PATH || ""}`;
+  }
+  return true;
+}
+
+function writeAgentCommandShim({ baseDir, target, executable, realCli, publicKey, secretKey, baseUrl, userId }) {
+  if (!realCli) return null;
+  const shimDir = path.join(baseDir, "bin");
+  ensureDir(shimDir);
+  if (process.platform === "win32") {
+    const shim = path.join(shimDir, `${executable}.cmd`);
+    const envPrefix = `OH_LANGFUSE_${target.toUpperCase()}_SHIM`;
+    const content = [
+      "@echo off",
+      "REM Auto-generated by scripts/codex-langfuse-setup.mjs",
+      `set ${envPrefix}=1`,
+      `set LANGFUSE_PUBLIC_KEY=${publicKey}`,
+      `set LANGFUSE_SECRET_KEY=${secretKey}`,
+      `set LANGFUSE_BASEURL=${baseUrl}`,
+      userId ? `set LANGFUSE_USER_ID=${userId}` : null,
+      windowsAutoUpdateCommand(target),
+      `call ${cmdQuote(realCli)} %*`,
+      "exit /b %ERRORLEVEL%",
+      ""
+    ].filter(Boolean).join(os.EOL);
+    fs.writeFileSync(shim, content, "utf8");
+    return { shim, shimDir };
+  }
+
+  const shim = path.join(shimDir, executable);
+  const lines = [
+    "#!/usr/bin/env sh",
+    "# Auto-generated by scripts/codex-langfuse-setup.mjs",
+    "set -eu",
+    `export OH_LANGFUSE_${target.toUpperCase()}_SHIM=1`,
+    `export LANGFUSE_PUBLIC_KEY=${shQuote(publicKey)}`,
+    `export LANGFUSE_SECRET_KEY=${shQuote(secretKey)}`,
+    `export LANGFUSE_BASEURL=${shQuote(baseUrl)}`,
+    userId ? `export LANGFUSE_USER_ID=${shQuote(userId)}` : null,
+    unixAutoUpdateCommand(target),
+    `exec ${shQuote(realCli)} "$@"`,
+    ""
+  ].filter(Boolean);
+  fs.writeFileSync(shim, lines.join("\n"), "utf8");
+  fs.chmodSync(shim, 0o755);
+  return { shim, shimDir };
+}
+
+function createAgentLauncher({ baseDir, target, executable }) {
+  if (process.platform === "win32") {
+    const launcher = path.join(baseDir, `launch-${target}-langfuse.cmd`);
+    const content = [
+      "@echo off",
+      windowsAutoUpdateCommand(target),
+      `${executable} %*`,
+      ""
+    ].join(os.EOL);
+    fs.writeFileSync(launcher, content, "utf8");
+    return launcher;
+  }
+
+  const launcher = path.join(baseDir, `launch-${target}-langfuse.sh`);
+  const content = [
+    "#!/usr/bin/env sh",
+    "set -eu",
+    unixAutoUpdateCommand(target),
+    `exec ${shQuote(executable)} "$@"`,
+    ""
+  ].join("\n");
+  fs.writeFileSync(launcher, content, "utf8");
+  fs.chmodSync(launcher, 0o755);
+  return launcher;
+}
+
+function createOrUpdateLangfuseVenv({ baseDir, pipIndexUrl = "https://pypi.tuna.tsinghua.edu.cn/simple" }) {
   const venvDir = path.join(baseDir, "langfuse-venv");
   const pythonCmd = process.platform === "win32" ? "python" : "python3";
   const venvPython = pythonExecutableInVenv(venvDir);
 
   if (!fs.existsSync(venvPython)) {
     console.log(`Creating Python virtual environment: ${venvDir}`);
-    try {
-      execFileSync(pythonCmd, ["-m", "venv", venvDir], { stdio: "inherit" });
-    } catch (e) {
-      if (process.platform !== "win32") {
-        throw new Error("Failed to create Python venv. Please install python3-venv first, for example: sudo apt install python3-venv");
-      }
-      throw new Error("Failed to create Python venv. Please confirm Python venv support is available.");
-    }
+    try {
+      execFileSync(pythonCmd, ["-m", "venv", venvDir], { stdio: "inherit" });
+    } catch (e) {
+      if (process.platform !== "win32") {
+        return installLangfuseWithSystemPython({ pythonCmd, pipIndexUrl });
+      }
+      throw new Error("Failed to create Python venv. Please confirm Python venv support is available.");
+    }
   }
 
   console.log("Installing/updating Python package in venv: langfuse");
   try {
     execFileSync(
       venvPython,
-      ["-m", "pip", "install", "-U", "langfuse", "-i", pipIndexUrl],
+      ["-m", "pip", "install", "-U", "langfuse", "-i", pipIndexUrl],
       { stdio: "inherit" }
     );
   } catch (e) {
+    if (process.platform !== "win32") {
+      return installLangfuseWithSystemPython({ pythonCmd, pipIndexUrl });
+    }
     throw new Error(`Failed to install langfuse in venv: ${venvPython} -m pip install -U langfuse -i ${pipIndexUrl}`);
   }
 
   return venvPython;
 }
 
-function updateCodexNotify(configPath, notifyCommand) {
-  let content = fs.existsSync(configPath) ? fs.readFileSync(configPath, "utf8") : "";
-  content = stripBom(content);
+function updateCodexNotify(configPath, notifyCommand) {
+  let content = fs.existsSync(configPath) ? fs.readFileSync(configPath, "utf8") : "";
+  content = stripBom(content);
   if (fs.existsSync(configPath)) {
     const backupPath = `${configPath}.bak-${Date.now()}`;
     fs.copyFileSync(configPath, backupPath);
     console.log(`Backed up existing Codex config: ${backupPath}`);
-  }
-  const lines = content.split(/\r?\n/);
-  const notifyLine = `notify = ${tomlArray(notifyCommand)}`;
-  let inTopLevel = true;
-  let replaced = false;
-  let inserted = false;
-  const next = [];
-
-  for (const line of lines) {
-    if (/^\s*\[/.test(line)) {
-      if (!replaced && !inserted) {
-        while (next.length && next[next.length - 1].trim() === "") next.pop();
-        next.push(notifyLine, "");
-        inserted = true;
-      }
-      inTopLevel = false;
-    }
-    if (inTopLevel && /^\s*notify\s*=/.test(line)) {
-      if (!replaced) next.push(notifyLine);
-      replaced = true;
-      continue;
-    }
+  }
+  const lines = content.split(/\r?\n/);
+  const notifyLine = `notify = ${tomlArray(notifyCommand)}`;
+  let inTopLevel = true;
+  let replaced = false;
+  let inserted = false;
+  const next = [];
+
+  for (const line of lines) {
+    if (/^\s*\[/.test(line)) {
+      if (!replaced && !inserted) {
+        while (next.length && next[next.length - 1].trim() === "") next.pop();
+        next.push(notifyLine, "");
+        inserted = true;
+      }
+      inTopLevel = false;
+    }
+    if (inTopLevel && /^\s*notify\s*=/.test(line)) {
+      if (!replaced) next.push(notifyLine);
+      replaced = true;
+      continue;
+    }
     next.push(line);
-  }
-
-  if (!replaced && !inserted) {
-    while (next.length && next[next.length - 1].trim() === "") next.pop();
-    next.push(notifyLine, "");
-  }
+  }
+
+  if (!replaced && !inserted) {
+    while (next.length && next[next.length - 1].trim() === "") next.pop();
+    next.push(notifyLine, "");
+  }
 
   fs.writeFileSync(configPath, next.join(os.EOL), "utf8");
 }
 
-async function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const rootDir = packageRoot;
-  const packageJson = JSON.parse(fs.readFileSync(path.join(rootDir, "package.json"), "utf8"));
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const rootDir = packageRoot;
+  const packageJson = JSON.parse(fs.readFileSync(path.join(rootDir, "package.json"), "utf8"));
 
   const publicKey =
     args.publicKey || process.env.LANGFUSE_PUBLIC_KEY || "pk-lf-da0c90a7-6e93-4eb7-bb86-c1047c8d187d";
@@ -368,12 +412,12 @@ async function main() {
     process.env.LANGFUSE_BASEURL ||
     process.env.LANGFUSE_HOST ||
     "http://120.46.221.227:3000";
-  const userId = normalizeUserId(args.userId || args.userid || "");
-  if (!userId || typeof userId !== "string") {
-    throw new Error("缺少参数：--userId=你的工号");
-  }
-  assertValidUserId(userId);
-  const pipIndexUrl = args.pipIndexUrl || process.env.LANGFUSE_PIP_INDEX_URL || "https://pypi.tuna.tsinghua.edu.cn/simple";
+  const userId = normalizeUserId(args.userId || args.userid || "");
+  if (!userId || typeof userId !== "string") {
+    throw new Error("缺少参数：--userId=你的工号");
+  }
+  assertValidUserId(userId);
+  const pipIndexUrl = args.pipIndexUrl || process.env.LANGFUSE_PIP_INDEX_URL || "https://pypi.tuna.tsinghua.edu.cn/simple";
 
   if (!publicKey || !secretKey) {
     throw new Error("Missing Langfuse keys: provide --publicKey and --secretKey or set LANGFUSE_PUBLIC_KEY/LANGFUSE_SECRET_KEY.");
@@ -404,49 +448,49 @@ async function main() {
   });
 
   const pythonCmd = process.platform === "win32" ? "python" : "python3";
-  const notifyPython = args["skip-pip-install"]
-    ? pythonCmd
-    : createOrUpdateLangfuseVenv({ baseDir: codexHome, pipIndexUrl });
-  updateCodexNotify(configPath, [notifyPython, destHook]);
-  const codexShimDir = path.join(codexHome, "bin");
-  const realCodexCli = resolveAgentCli({ target: "codex", preferred: args.cmd || "", shimDir: codexShimDir });
-  const directShim = writeAgentCommandShim({
-    baseDir: codexHome,
-    target: "codex",
-    executable: "codex",
-    realCli: realCodexCli,
-    publicKey,
-    secretKey,
-    baseUrl,
-    userId
-  });
-  if (directShim?.shimDir) {
-    prependWindowsUserPath(directShim.shimDir);
-  }
-  const agentLauncher = createAgentLauncher({
-    baseDir: codexHome,
-    target: "codex",
-    executable: realCodexCli ? cmdQuote(realCodexCli) : "codex"
-  });
-
-  console.log(`Updated Codex notify hook: ${configPath}`);
-  console.log(`Installed hook script: ${destHook}`);
-  console.log(`Wrote Langfuse config: ${path.join(langfuseDir, "config.json")}`);
-  console.log(`Agent launcher with update check: ${agentLauncher}`);
-  if (directShim) {
-    console.log(`Direct Codex command shim ready: ${directShim.shim}`);
-    console.log(`Real Codex CLI: ${realCodexCli}`);
-  } else {
-    console.log("Codex CLI not found; skipped direct codex command shim.");
-  }
-  const runtimeState = writeRuntimeInstallRecord("codex", {
-    packageName: packageJson.name,
-    packageVersion: packageJson.version,
-  });
-  console.log(`Runtime version recorded: ${runtimeState}`);
-
-  console.log("Done. Restart Codex so the updated notify command is loaded.");
-}
+  const notifyPython = args["skip-pip-install"]
+    ? pythonCmd
+    : createOrUpdateLangfuseVenv({ baseDir: codexHome, pipIndexUrl });
+  updateCodexNotify(configPath, [notifyPython, destHook]);
+  const codexShimDir = path.join(codexHome, "bin");
+  const realCodexCli = resolveAgentCli({ target: "codex", preferred: args.cmd || "", shimDir: codexShimDir });
+  const directShim = writeAgentCommandShim({
+    baseDir: codexHome,
+    target: "codex",
+    executable: "codex",
+    realCli: realCodexCli,
+    publicKey,
+    secretKey,
+    baseUrl,
+    userId
+  });
+  if (directShim?.shimDir) {
+    prependWindowsUserPath(directShim.shimDir);
+  }
+  const agentLauncher = createAgentLauncher({
+    baseDir: codexHome,
+    target: "codex",
+    executable: realCodexCli ? cmdQuote(realCodexCli) : "codex"
+  });
+
+  console.log(`Updated Codex notify hook: ${configPath}`);
+  console.log(`Installed hook script: ${destHook}`);
+  console.log(`Wrote Langfuse config: ${path.join(langfuseDir, "config.json")}`);
+  console.log(`Agent launcher with update check: ${agentLauncher}`);
+  if (directShim) {
+    console.log(`Direct Codex command shim ready: ${directShim.shim}`);
+    console.log(`Real Codex CLI: ${realCodexCli}`);
+  } else {
+    console.log("Codex CLI not found; skipped direct codex command shim.");
+  }
+  const runtimeState = writeRuntimeInstallRecord("codex", {
+    packageName: packageJson.name,
+    packageVersion: packageJson.version,
+  });
+  console.log(`Runtime version recorded: ${runtimeState}`);
+
+  console.log("Done. Restart Codex so the updated notify command is loaded.");
+}
 
 main().catch((err) => {
   console.error(err?.message || String(err));