oh-langfuse 0.1.53 → 0.1.55

package/scripts/langfuse-setup.mjs

@@ -1,26 +1,26 @@
 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 packageJson = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8"));
-
-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 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 packageJson = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8"));
+
+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 = {};
@@ -132,271 +132,315 @@ function normalizeWinPathForClaude(p) {
   return p.replace(/\\/g, "/");
 }
 
-function quoteCommandArg(s) {
-  return `"${String(s).replace(/"/g, '\\"')}"`;
-}
-
-function cmdQuote(s) {
-  return `"${String(s).replace(/"/g, '""')}"`;
-}
-
-function hookCommandForClaude({ launcher, hookPython, pyPath }) {
-  if (process.platform !== "win32") return launcher;
-  return `${cmdQuote(hookPython)} ${cmdQuote(pyPath)}`;
-}
-
-function shQuote(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/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/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 quoteCommandArg(s) {
+  return `"${String(s).replace(/"/g, '\\"')}"`;
+}
+
+function cmdQuote(s) {
+  return `"${String(s).replace(/"/g, '""')}"`;
+}
+
+function hookCommandForClaude({ launcher, hookPython, pyPath }) {
+  if (process.platform !== "win32") return launcher;
+  return `${cmdQuote(hookPython)} ${cmdQuote(pyPath)}`;
+}
+
+function shQuote(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/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/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 [];
+  return String(result.stdout || "")
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean);
+}
+
+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 Claude 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/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/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 pythonExecutableInVenv(venvDir) {
+  return process.platform === "win32"
+    ? path.join(venvDir, "Scripts", "python.exe")
+    : path.join(venvDir, "bin", "python");
 }
 
-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 [];
-  return String(result.stdout || "")
-    .split(/\r?\n/)
-    .map((line) => line.trim())
-    .filter(Boolean);
-}
-
-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 Claude 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 || ""}`;
+  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}`);
+    }
   }
-  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/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/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;
-}
-
-function pythonExecutableInVenv(venvDir) {
-  return process.platform === "win32"
-    ? path.join(venvDir, "Scripts", "python.exe")
-    : path.join(venvDir, "bin", "python");
+  return pythonCmd;
 }
 
 async function createHookLauncher({ hooksDir, hookPython, pyPath }) {
-  if (process.platform === "win32") {
-    const launcher = path.join(hooksDir, "run-langfuse-hook.cmd");
-    const content = [
-      "@echo off",
-      `${cmdQuote(hookPython)} ${cmdQuote(pyPath)}`,
-      ""
-    ].join(os.EOL);
-    await fsp.writeFile(launcher, content, "utf8");
-    return launcher;
-  }
-
-  const launcher = path.join(hooksDir, "run-langfuse-hook.sh");
-  const content = [
-    "#!/usr/bin/env sh",
-    `exec ${shQuote(hookPython)} ${shQuote(pyPath)}`,
-    ""
-  ].join("\n");
-  await fsp.writeFile(launcher, content, "utf8");
-  fs.chmodSync(launcher, 0o755);
-  return launcher;
-}
+  if (process.platform === "win32") {
+    const launcher = path.join(hooksDir, "run-langfuse-hook.cmd");
+    const content = [
+      "@echo off",
+      `${cmdQuote(hookPython)} ${cmdQuote(pyPath)}`,
+      ""
+    ].join(os.EOL);
+    await fsp.writeFile(launcher, content, "utf8");
+    return launcher;
+  }
+
+  const launcher = path.join(hooksDir, "run-langfuse-hook.sh");
+  const content = [
+    "#!/usr/bin/env sh",
+    `exec ${shQuote(hookPython)} ${shQuote(pyPath)}`,
+    ""
+  ].join("\n");
+  await fsp.writeFile(launcher, content, "utf8");
+  fs.chmodSync(launcher, 0o755);
+  return launcher;
+}
 
-function createOrUpdateLangfuseVenv({ baseDir, pipIndexUrl = "https://pypi.tuna.tsinghua.edu.cn/simple" }) {
+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}`);
   }
 
@@ -406,25 +450,25 @@ function createOrUpdateLangfuseVenv({ baseDir, pipIndexUrl = "https://pypi.tuna.
 async function main() {
   const args = parseArgs(process.argv.slice(2));
 
-  const userId = normalizeUserId(args.userId || args.userid);
-  if (!userId || typeof userId !== "string") {
-    throw new Error("缺少参数：--userId=你的工号");
-  }
-  assertValidUserId(userId);
+  const userId = normalizeUserId(args.userId || args.userid);
+  if (!userId || typeof userId !== "string") {
+    throw new Error("缺少参数：--userId=你的工号");
+  }
+  assertValidUserId(userId);
 
-  const langfuseHost =
-    args.langfuseBaseUrl ||
-    args.langfuseHost ||
-    args.host ||
-    process.env.LANGFUSE_BASEURL ||
-    process.env.LANGFUSE_HOST ||
-    "http://120.46.221.227:3000";
+  const langfuseHost =
+    args.langfuseBaseUrl ||
+    args.langfuseHost ||
+    args.host ||
+    process.env.LANGFUSE_BASEURL ||
+    process.env.LANGFUSE_HOST ||
+    "http://120.46.221.227:3000";
 
   const publicKey =
     args.publicKey || process.env.LANGFUSE_PUBLIC_KEY || "pk-lf-da0c90a7-6e93-4eb7-bb86-c1047c8d187d";
-  const secretKey =
-    args.secretKey || process.env.LANGFUSE_SECRET_KEY || "sk-lf-0269b85d-bfdc-442c-bfa3-e737954e3315";
-  const pipIndexUrl = args.pipIndexUrl || process.env.LANGFUSE_PIP_INDEX_URL || "https://pypi.tuna.tsinghua.edu.cn/simple";
+  const secretKey =
+    args.secretKey || process.env.LANGFUSE_SECRET_KEY || "sk-lf-0269b85d-bfdc-442c-bfa3-e737954e3315";
+  const pipIndexUrl = args.pipIndexUrl || process.env.LANGFUSE_PIP_INDEX_URL || "https://pypi.tuna.tsinghua.edu.cn/simple";
   if (!publicKey || !secretKey) {
     throw new Error("缺少 Langfuse Key：请提供 --publicKey=... --secretKey=...（或设置环境变量 LANGFUSE_PUBLIC_KEY/LANGFUSE_SECRET_KEY）");
   }
@@ -434,12 +478,12 @@ async function main() {
     process.env.CC_LANGFUSE_ZIP_URL ||
     "https://gitcode.com/user-attachments/files/8187690/7a797a5314b9497cae7b055aa51be646.zip";
   const zipPath = args.zipPath || args.zippath || process.env.CC_LANGFUSE_ZIP_PATH;
-  const bundledPyPath = path.join(packageRoot, "langfuse_hook.py");
-  const pyPathArg =
-    args.pyPath ||
-    args.pypath ||
-    process.env.CC_LANGFUSE_PY_PATH ||
-    (fs.existsSync(bundledPyPath) ? bundledPyPath : "");
+  const bundledPyPath = path.join(packageRoot, "langfuse_hook.py");
+  const pyPathArg =
+    args.pyPath ||
+    args.pypath ||
+    process.env.CC_LANGFUSE_PY_PATH ||
+    (fs.existsSync(bundledPyPath) ? bundledPyPath : "");
 
   const userHome = os.homedir();
   const claudeDir = path.join(userHome, ".claude");
@@ -481,36 +525,36 @@ async function main() {
   const nextPyText = setOrReplaceUserId(pyText, userId);
   if (nextPyText !== pyText) {
     await fsp.writeFile(pyPath, nextPyText, "utf8");
-  }
-  const hookPython = createOrUpdateLangfuseVenv({ baseDir: claudeDir, pipIndexUrl });
-  const hookLauncher = await createHookLauncher({ hooksDir, hookPython, pyPath });
-  const claudeShimDir = path.join(claudeDir, "bin");
-  const realClaudeCli = resolveAgentCli({ target: "claude", preferred: args.cmd || "", shimDir: claudeShimDir });
-  const directShim = writeAgentCommandShim({
-    baseDir: claudeDir,
-    target: "claude",
-    executable: "claude",
-    realCli: realClaudeCli,
-    publicKey,
-    secretKey,
-    baseUrl: langfuseHost,
-    userId
-  });
-  if (directShim?.shimDir) {
-    prependWindowsUserPath(directShim.shimDir);
-  }
-  const agentLauncher = createAgentLauncher({
-    baseDir: claudeDir,
-    target: "claude",
-    executable: realClaudeCli ? cmdQuote(realClaudeCli) : "claude"
-  });
-
-  // 4) 合并写入 settings.json
-  const settingsPath = path.join(claudeDir, "settings.json");
-  const existing = readJsonIfExists(settingsPath) ?? {};
-
-  const desired = {
-    env: {
+  }
+  const hookPython = createOrUpdateLangfuseVenv({ baseDir: claudeDir, pipIndexUrl });
+  const hookLauncher = await createHookLauncher({ hooksDir, hookPython, pyPath });
+  const claudeShimDir = path.join(claudeDir, "bin");
+  const realClaudeCli = resolveAgentCli({ target: "claude", preferred: args.cmd || "", shimDir: claudeShimDir });
+  const directShim = writeAgentCommandShim({
+    baseDir: claudeDir,
+    target: "claude",
+    executable: "claude",
+    realCli: realClaudeCli,
+    publicKey,
+    secretKey,
+    baseUrl: langfuseHost,
+    userId
+  });
+  if (directShim?.shimDir) {
+    prependWindowsUserPath(directShim.shimDir);
+  }
+  const agentLauncher = createAgentLauncher({
+    baseDir: claudeDir,
+    target: "claude",
+    executable: realClaudeCli ? cmdQuote(realClaudeCli) : "claude"
+  });
+
+  // 4) 合并写入 settings.json
+  const settingsPath = path.join(claudeDir, "settings.json");
+  const existing = readJsonIfExists(settingsPath) ?? {};
+
+  const desired = {
+    env: {
       TRACE_TO_LANGFUSE: "true",
       LANGFUSE_PUBLIC_KEY: publicKey,
       LANGFUSE_SECRET_KEY: secretKey,
@@ -526,34 +570,34 @@ async function main() {
       Stop: [
         {
           hooks: [
-            {
-              type: "command",
-              command: hookCommandForClaude({ launcher: hookLauncher, hookPython, pyPath })
-            }
-          ]
-        }
+            {
+              type: "command",
+              command: hookCommandForClaude({ launcher: hookLauncher, hookPython, pyPath })
+            }
+          ]
+        }
       ]
     }
   };
 
   const merged = deepMerge(existing, desired);
   ensureDir(claudeDir);
-  writeJsonPretty(settingsPath, merged);
-  const runtimeState = writeRuntimeInstallRecord("claude", {
-    packageName: packageJson.name,
-    packageVersion: packageJson.version,
-  });
-  console.log(`Runtime version recorded: ${runtimeState}`);
-  console.log(`已更新：${settingsPath}`);
-  console.log(`Agent launcher with update check: ${agentLauncher}`);
-  if (directShim) {
-    console.log(`Direct Claude command shim ready: ${directShim.shim}`);
-    console.log(`Real Claude CLI: ${realClaudeCli}`);
-  } else {
-    console.log("Claude CLI not found; skipped direct claude command shim.");
-  }
-
-}
+  writeJsonPretty(settingsPath, merged);
+  const runtimeState = writeRuntimeInstallRecord("claude", {
+    packageName: packageJson.name,
+    packageVersion: packageJson.version,
+  });
+  console.log(`Runtime version recorded: ${runtimeState}`);
+  console.log(`已更新：${settingsPath}`);
+  console.log(`Agent launcher with update check: ${agentLauncher}`);
+  if (directShim) {
+    console.log(`Direct Claude command shim ready: ${directShim.shim}`);
+    console.log(`Real Claude CLI: ${realClaudeCli}`);
+  } else {
+    console.log("Claude CLI not found; skipped direct claude command shim.");
+  }
+
+}
 
 main().catch((err) => {
   console.error(err?.message || String(err));