oh-langfuse 0.1.72 → 0.1.74

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-langfuse",
-  "version": "0.1.72",
+  "version": "0.1.74",
   "private": false,
   "type": "module",
   "description": "Use npm scripts to configure Claude Code / OpenCode / Codex with Langfuse tracing.",

package/scripts/codex-langfuse-check.mjs

@@ -38,8 +38,8 @@ function findLatestSession(sessionsDir) {
   return latest;
 }
 
-function commandOk(cmd, args) {
-  const r = spawnSync(cmd, args, { encoding: "utf8" });
+function commandOk(cmd, args, env = process.env) {
+  const r = spawnSync(cmd, args, { encoding: "utf8", env });
   return { ok: !r.error && r.status === 0, detail: (r.stdout || r.stderr || "").trim() };
 }
 
@@ -63,8 +63,22 @@ function readCodexShimTarget(codexHome) {
 function venvPython(codexHome) {
   return process.platform === "win32"
     ? path.join(codexHome, "langfuse-venv", "Scripts", "python.exe")
-    : path.join(codexHome, "langfuse-venv", "bin", "python");
-}
+    : path.join(codexHome, "langfuse-venv", "bin", "python");
+}
+
+function fallbackPythonCommand() {
+  return process.platform === "win32" ? "python" : "python3";
+}
+
+function isolatedPythonPath(codexHome) {
+  return path.join(codexHome, "langfuse-python");
+}
+
+function langfuseImportOk(hookPython, fallbackTarget) {
+  if (fs.existsSync(hookPython)) return commandOk(hookPython, ["-c", "import langfuse; print('langfuse ok')"]);
+  const env = { ...process.env, PYTHONPATH: process.env.PYTHONPATH ? `${fallbackTarget}${path.delimiter}${process.env.PYTHONPATH}` : fallbackTarget };
+  return commandOk(fallbackPythonCommand(), ["-c", "import langfuse; print('langfuse ok')"], env);
+}
 
 function configHasNotify(configText) {
   const firstSection = configText.search(/^\s*\[/m);
@@ -84,10 +98,11 @@ function main() {
   const sessionsDir = path.join(codexHome, "sessions");
   const latestSession = findLatestSession(sessionsDir);
   const langfuseConfig = readJsonIfExists(langfuseConfigPath);
-  const configText = fs.existsSync(configPath) ? stripBom(fs.readFileSync(configPath, "utf8")) : "";
+  const configText = fs.existsSync(configPath) ? stripBom(fs.readFileSync(configPath, "utf8")) : "";
   const hookPython = venvPython(codexHome);
+  const fallbackTarget = isolatedPythonPath(codexHome);
   const python = commandOk(process.platform === "win32" ? "python" : "python3", ["--version"]);
-  const langfuseImport = commandOk(hookPython, ["-c", "import langfuse; print('langfuse ok')"]);
+  const langfuseImport = langfuseImportOk(hookPython, fallbackTarget);
   const codexShimTarget = readCodexShimTarget(codexHome);
   const codexShimUsesWindowsApps = !!codexShimTarget && isWindowsAppsPath(codexShimTarget);
 
@@ -138,7 +153,13 @@ function main() {
     codexShimTarget || "not installed",
     "Run setup/update again with a fixed oh-langfuse version; WindowsApps Codex paths cannot be called directly."
   );
-  addResult(results, "Langfuse venv Python", fs.existsSync(hookPython), hookPython, "Run setup again; on Linux install python3-venv if venv creation fails.");
+  addResult(
+    results,
+    "Langfuse hook Python",
+    fs.existsSync(hookPython) || fs.existsSync(fallbackTarget),
+    fs.existsSync(hookPython) ? hookPython : `${fallbackPythonCommand()} with PYTHONPATH=${fallbackTarget}`,
+    "Run setup again; on Linux the installer can fall back to an isolated PYTHONPATH target."
+  );
   addResult(
     results,
     "Python langfuse package",

package/scripts/codex-langfuse-setup.mjs

@@ -68,46 +68,63 @@ function pythonExecutableInVenv(venvDir) {
     : path.join(venvDir, "bin", "python");
 }
 
-function pythonCanImport(pythonCmd, moduleName) {
-  try {
-    execFileSync(pythonCmd, ["-c", `import ${moduleName}`], { stdio: "ignore", encoding: "utf8", env: { ...process.env, PYTHONUTF8: "1" } });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-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] }
-  ];
-
-  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", encoding: "utf8", env: { ...process.env, PYTHONUTF8: "1" } });
-      return;
-    } catch (error) {
-      errors.push(`${attempt.command}: ${error?.message || error}`);
-    }
-  }
-
-  throw new Error(
-    `Failed to install langfuse with system Python/pip. Tried python -m pip, pip3, and pip. Last errors: ${errors.join(" | ")}`
-  );
-}
-
-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");
-  }
-  return pythonCmd;
-}
+function pythonEnv(extraPythonPath = "") {
+  const env = { ...process.env, PYTHONUTF8: "1" };
+  if (extraPythonPath) {
+    env.PYTHONPATH = process.env.PYTHONPATH ? `${extraPythonPath}${path.delimiter}${process.env.PYTHONPATH}` : extraPythonPath;
+  }
+  return env;
+}
+
+function pythonCanImport(pythonCmd, moduleName, extraPythonPath = "") {
+  try {
+    execFileSync(pythonCmd, ["-c", `import ${moduleName}`], { stdio: "ignore", encoding: "utf8", env: pythonEnv(extraPythonPath) });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function installLangfuseIntoTargetDir({ pythonCmd, baseDir, pipIndexUrl }) {
+  const targetDir = path.join(baseDir, "langfuse-python");
+  ensureDir(targetDir);
+  console.log(`Installing Python package into isolated target: ${targetDir}`);
+  execFileSync(
+    pythonCmd,
+    ["-m", "pip", "install", "--target", targetDir, "--upgrade", "langfuse", "-i", pipIndexUrl],
+    { stdio: "inherit", encoding: "utf8", env: pythonEnv() }
+  );
+  if (!pythonCanImport(pythonCmd, "langfuse", targetDir)) {
+    throw new Error(`langfuse was installed into ${targetDir}, but ${pythonCmd} still cannot import it with PYTHONPATH.`);
+  }
+  return { python: pythonCmd, pythonPath: targetDir };
+}
+
+function runPipInstallWithFallback({ pythonCmd, baseDir, pipIndexUrl }) {
+  const attempts = [
+    () => installLangfuseIntoTargetDir({ pythonCmd, baseDir, pipIndexUrl }),
+    () => installLangfuseIntoTargetDir({ pythonCmd: "python3", baseDir, pipIndexUrl }),
+    () => installLangfuseIntoTargetDir({ pythonCmd: "python", baseDir, pipIndexUrl })
+  ];
+
+  const errors = [];
+  for (const attempt of attempts) {
+    try {
+      return attempt();
+    } catch (error) {
+      errors.push(error?.message || String(error));
+    }
+  }
+
+  throw new Error(
+    `Failed to install langfuse into isolated Python target. Last errors: ${errors.join(" | ")}`
+  );
+}
+
+function installLangfuseWithSystemPython({ pythonCmd, baseDir, pipIndexUrl }) {
+  console.log("Python venv is unavailable; falling back to isolated PYTHONPATH install for langfuse.");
+  return runPipInstallWithFallback({ pythonCmd, baseDir, pipIndexUrl });
+}
 
 function shQuote(s) {
   return `'${String(s).replace(/'/g, "'\"'\"'")}'`;
@@ -348,13 +365,13 @@ function createOrUpdateLangfuseVenv({ baseDir, pipIndexUrl = "https://pypi.tuna.
   if (!fs.existsSync(venvPython)) {
     console.log(`Creating Python virtual environment: ${venvDir}`);
     try {
-      execFileSync(pythonCmd, ["-m", "venv", venvDir], { stdio: "inherit", encoding: "utf8", env: { ...process.env, PYTHONUTF8: "1" } });
-    } 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.");
-    }
+      execFileSync(pythonCmd, ["-m", "venv", venvDir], { stdio: "inherit", encoding: "utf8", env: { ...process.env, PYTHONUTF8: "1" } });
+    } catch (e) {
+      if (process.platform !== "win32") {
+        return installLangfuseWithSystemPython({ pythonCmd, baseDir, 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");
@@ -363,16 +380,31 @@ function createOrUpdateLangfuseVenv({ baseDir, pipIndexUrl = "https://pypi.tuna.
       venvPython,
       ["-m", "pip", "install", "-U", "langfuse", "-i", pipIndexUrl],
       { stdio: "inherit", encoding: "utf8", env: { ...process.env, PYTHONUTF8: "1" } }
-    );
-  } 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;
-}
+    );
+  } catch (e) {
+    if (process.platform !== "win32") {
+      return installLangfuseWithSystemPython({ pythonCmd, baseDir, pipIndexUrl });
+    }
+    throw new Error(`Failed to install langfuse in venv: ${venvPython} -m pip install -U langfuse -i ${pipIndexUrl}`);
+  }
+
+  if (!pythonCanImport(venvPython, "langfuse")) {
+    if (process.platform !== "win32") {
+      return installLangfuseWithSystemPython({ pythonCmd, baseDir, pipIndexUrl });
+    }
+    throw new Error(`langfuse was installed in venv, but cannot be imported by ${venvPython}`);
+  }
+
+  return { python: venvPython, pythonPath: "" };
+}
+
+function codexNotifyCommand({ python, pythonPath = "", hookPath }) {
+  if (pythonPath && process.platform !== "win32") {
+    const script = `if [ -n "\${PYTHONPATH:-}" ]; then export PYTHONPATH=${shQuote(pythonPath)}:"$PYTHONPATH"; else export PYTHONPATH=${shQuote(pythonPath)}; fi; exec ${shQuote(python)} ${shQuote(hookPath)}`;
+    return ["sh", "-c", script];
+  }
+  return [python, hookPath];
+}
 
 function updateCodexNotify(configPath, notifyCommand) {
   let content = fs.existsSync(configPath) ? fs.readFileSync(configPath, "utf8") : "";
@@ -473,11 +505,11 @@ async function main() {
     userId,
   });
 
-  const pythonCmd = process.platform === "win32" ? "python" : "python3";
-  const notifyPython = args["skip-pip-install"]
-    ? pythonCmd
-    : createOrUpdateLangfuseVenv({ baseDir: codexHome, pipIndexUrl });
-  updateCodexNotify(configPath, [notifyPython, destHook]);
+  const pythonCmd = process.platform === "win32" ? "python" : "python3";
+  const notifyRuntime = args["skip-pip-install"]
+    ? { python: pythonCmd, pythonPath: "" }
+    : createOrUpdateLangfuseVenv({ baseDir: codexHome, pipIndexUrl });
+  updateCodexNotify(configPath, codexNotifyCommand({ python: notifyRuntime.python, pythonPath: notifyRuntime.pythonPath, hookPath: destHook }));
   const codexShimDir = path.join(codexHome, "bin");
   const realCodexCli = resolveAgentCli({ target: "codex", preferred: args.cmd || "", shimDir: codexShimDir });
   const directShim = writeAgentCommandShim({

package/scripts/langfuse-check.mjs

@@ -14,11 +14,19 @@ function addResult(results, item, ok, detail, fix = "") {
   results.push({ item, ok, detail, fix });
 }
 
-function pythonExecutableInVenv(claudeDir) {
-  return process.platform === "win32"
-    ? path.join(claudeDir, "langfuse-venv", "Scripts", "python.exe")
-    : path.join(claudeDir, "langfuse-venv", "bin", "python");
-}
+function pythonExecutableInVenv(claudeDir) {
+  return process.platform === "win32"
+    ? path.join(claudeDir, "langfuse-venv", "Scripts", "python.exe")
+    : path.join(claudeDir, "langfuse-venv", "bin", "python");
+}
+
+function fallbackPythonCommand() {
+  return process.platform === "win32" ? "python" : "python3";
+}
+
+function isolatedPythonPath(claudeDir) {
+  return path.join(claudeDir, "langfuse-python");
+}
 
 function launcherPath(hooksDir) {
   return process.platform === "win32"
@@ -63,13 +71,18 @@ function pathExists(p) {
   return typeof p === "string" && p.length > 0 && fs.existsSync(p);
 }
 
-function checkPythonLangfuseImport(pythonPath) {
-  if (!pathExists(pythonPath)) return { ok: false, detail: "python executable missing" };
-  const result = spawnSync(pythonPath, ["-c", "import langfuse; print('OK')"], {
-    encoding: "utf8",
-    timeout: 15000,
-    windowsHide: true
-  });
+function checkPythonLangfuseImport(pythonPath, extraPythonPath = "") {
+  if (!pathExists(pythonPath) && pythonPath !== "python3" && pythonPath !== "python") return { ok: false, detail: "python executable missing" };
+  const env = { ...process.env };
+  if (extraPythonPath) {
+    env.PYTHONPATH = process.env.PYTHONPATH ? `${extraPythonPath}${path.delimiter}${process.env.PYTHONPATH}` : extraPythonPath;
+  }
+  const result = spawnSync(pythonPath, ["-c", "import langfuse; print('OK')"], {
+    encoding: "utf8",
+    timeout: 15000,
+    windowsHide: true,
+    env
+  });
   if (result.status === 0) return { ok: true, detail: "OK" };
   const err = `${result.stderr || result.stdout || result.error?.message || "unknown error"}`.trim();
   return { ok: false, detail: err || "import failed" };
@@ -80,10 +93,11 @@ function main() {
   const claudeDir = path.join(userHome, ".claude");
   const hooksDir = path.join(claudeDir, "hooks");
   const settingsPath = path.join(claudeDir, "settings.json");
-  const pyPath = path.join(hooksDir, "langfuse_hook.py");
-  const expectedLauncher = launcherPath(hooksDir);
-  const expectedPython = pythonExecutableInVenv(claudeDir);
-  const logPath = path.join(claudeDir, "state", "langfuse_hook.log");
+  const pyPath = path.join(hooksDir, "langfuse_hook.py");
+  const expectedLauncher = launcherPath(hooksDir);
+  const expectedPython = pythonExecutableInVenv(claudeDir);
+  const fallbackTarget = isolatedPythonPath(claudeDir);
+  const logPath = path.join(claudeDir, "state", "langfuse_hook.log");
 
   const results = [];
 
@@ -138,22 +152,26 @@ function main() {
     "Run setup again. Claude Code should execute the generated Python hook command."
   );
 
-  addResult(
-    results,
-    "hook python executable",
-    pathExists(expectedPython),
-    expectedPython,
-    "Run setup again to recreate the Python venv."
-  );
-
-  const importCheck = checkPythonLangfuseImport(expectedPython);
-  addResult(
-    results,
-    "python package langfuse",
-    importCheck.ok,
-    importCheck.detail,
-    `Run: ${expectedPython} -m pip install -U langfuse`
-  );
+  addResult(
+    results,
+    "hook python executable",
+    pathExists(expectedPython) || fs.existsSync(fallbackTarget),
+    pathExists(expectedPython) ? expectedPython : `${fallbackPythonCommand()} with PYTHONPATH=${fallbackTarget}`,
+    "Run setup again to recreate the Python venv."
+  );
+
+  const importCheck = pathExists(expectedPython)
+    ? checkPythonLangfuseImport(expectedPython)
+    : checkPythonLangfuseImport(fallbackPythonCommand(), fallbackTarget);
+  addResult(
+    results,
+    "python package langfuse",
+    importCheck.ok,
+    importCheck.detail,
+    pathExists(expectedPython)
+      ? `Run: ${expectedPython} -m pip install -U langfuse`
+      : "Run setup again to install langfuse into the isolated PYTHONPATH target."
+  );
 
   addResult(results, "hook log path", true, logPath);
 

package/scripts/langfuse-setup.mjs

@@ -340,68 +340,87 @@ function pythonExecutableInVenv(venvDir) {
     : path.join(venvDir, "bin", "python");
 }
 
-function pythonCanImport(pythonCmd, moduleName) {
-  try {
-    execFileSync(pythonCmd, ["-c", `import ${moduleName}`], { stdio: "ignore", encoding: "utf8", env: { ...process.env, PYTHONUTF8: "1" } });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-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] }
-  ];
-
-  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", encoding: "utf8", env: { ...process.env, PYTHONUTF8: "1" } });
-      return;
-    } catch (error) {
-      errors.push(`${attempt.command}: ${error?.message || error}`);
-    }
-  }
-
-  throw new Error(
-    `Failed to install langfuse with system Python/pip. Tried python -m pip, pip3, and pip. Last errors: ${errors.join(" | ")}`
-  );
-}
-
-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");
-  }
-  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);
+function pythonEnv(extraPythonPath = "") {
+  const env = { ...process.env, PYTHONUTF8: "1" };
+  if (extraPythonPath) {
+    env.PYTHONPATH = process.env.PYTHONPATH ? `${extraPythonPath}${path.delimiter}${process.env.PYTHONPATH}` : extraPythonPath;
+  }
+  return env;
+}
+
+function pythonCanImport(pythonCmd, moduleName, extraPythonPath = "") {
+  try {
+    execFileSync(pythonCmd, ["-c", `import ${moduleName}`], { stdio: "ignore", encoding: "utf8", env: pythonEnv(extraPythonPath) });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function installLangfuseIntoTargetDir({ pythonCmd, baseDir, pipIndexUrl }) {
+  const targetDir = path.join(baseDir, "langfuse-python");
+  ensureDir(targetDir);
+  console.log(`Installing Python package into isolated target: ${targetDir}`);
+  execFileSync(
+    pythonCmd,
+    ["-m", "pip", "install", "--target", targetDir, "--upgrade", "langfuse", "-i", pipIndexUrl],
+    { stdio: "inherit", encoding: "utf8", env: pythonEnv() }
+  );
+  if (!pythonCanImport(pythonCmd, "langfuse", targetDir)) {
+    throw new Error(`langfuse was installed into ${targetDir}, but ${pythonCmd} still cannot import it with PYTHONPATH.`);
+  }
+  return { python: pythonCmd, pythonPath: targetDir };
+}
+
+function runPipInstallWithFallback({ pythonCmd, baseDir, pipIndexUrl }) {
+  const attempts = [
+    () => installLangfuseIntoTargetDir({ pythonCmd, baseDir, pipIndexUrl }),
+    () => installLangfuseIntoTargetDir({ pythonCmd: "python3", baseDir, pipIndexUrl }),
+    () => installLangfuseIntoTargetDir({ pythonCmd: "python", baseDir, pipIndexUrl })
+  ];
+
+  const errors = [];
+  for (const attempt of attempts) {
+    try {
+      return attempt();
+    } catch (error) {
+      errors.push(error?.message || String(error));
+    }
+  }
+
+  throw new Error(
+    `Failed to install langfuse into isolated Python target. Last errors: ${errors.join(" | ")}`
+  );
+}
+
+function installLangfuseWithSystemPython({ pythonCmd, baseDir, pipIndexUrl }) {
+  console.log("Python venv is unavailable; falling back to isolated PYTHONPATH install for langfuse.");
+  return runPipInstallWithFallback({ pythonCmd, baseDir, pipIndexUrl });
+}
+
+async function createHookLauncher({ hooksDir, hookPython, hookPythonPath = "", pyPath }) {
+  if (process.platform === "win32") {
+    const launcher = path.join(hooksDir, "run-langfuse-hook.cmd");
+    const content = [
+      "@echo off",
+      hookPythonPath ? `set PYTHONPATH=${hookPythonPath};%PYTHONPATH%` : null,
+      `${cmdQuote(hookPython)} ${cmdQuote(pyPath)}`,
+      ""
+    ].filter(Boolean).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;
+    return launcher;
+  }
+
+  const launcher = path.join(hooksDir, "run-langfuse-hook.sh");
+  const content = [
+    "#!/usr/bin/env sh",
+    hookPythonPath ? `if [ -n "\${PYTHONPATH:-}" ]; then export PYTHONPATH=${shQuote(hookPythonPath)}:"$PYTHONPATH"; else export PYTHONPATH=${shQuote(hookPythonPath)}; fi` : null,
+    `exec ${shQuote(hookPython)} ${shQuote(pyPath)}`,
+    ""
+  ].filter(Boolean).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" }) {
@@ -412,13 +431,13 @@ function createOrUpdateLangfuseVenv({ baseDir, pipIndexUrl = "https://pypi.tuna.
   if (!fs.existsSync(venvPython)) {
     console.log(`Creating Python virtual environment: ${venvDir}`);
     try {
-      execFileSync(pythonCmd, ["-m", "venv", venvDir], { stdio: "inherit", encoding: "utf8", env: { ...process.env, PYTHONUTF8: "1" } });
-    } 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.");
-    }
+      execFileSync(pythonCmd, ["-m", "venv", venvDir], { stdio: "inherit", encoding: "utf8", env: { ...process.env, PYTHONUTF8: "1" } });
+    } catch (e) {
+      if (process.platform !== "win32") {
+        return installLangfuseWithSystemPython({ pythonCmd, baseDir, 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");
@@ -427,16 +446,23 @@ function createOrUpdateLangfuseVenv({ baseDir, pipIndexUrl = "https://pypi.tuna.
       venvPython,
       ["-m", "pip", "install", "-U", "langfuse", "-i", pipIndexUrl],
       { stdio: "inherit", encoding: "utf8", env: { ...process.env, PYTHONUTF8: "1" } }
-    );
-  } 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;
-}
+    );
+  } catch (e) {
+    if (process.platform !== "win32") {
+      return installLangfuseWithSystemPython({ pythonCmd, baseDir, pipIndexUrl });
+    }
+    throw new Error(`Failed to install langfuse in venv: ${venvPython} -m pip install -U langfuse -i ${pipIndexUrl}`);
+  }
+
+  if (!pythonCanImport(venvPython, "langfuse")) {
+    if (process.platform !== "win32") {
+      return installLangfuseWithSystemPython({ pythonCmd, baseDir, pipIndexUrl });
+    }
+    throw new Error(`langfuse was installed in venv, but cannot be imported by ${venvPython}`);
+  }
+
+  return { python: venvPython, pythonPath: "" };
+}
 
 async function main() {
   const args = parseArgs(process.argv.slice(2));
@@ -517,8 +543,9 @@ async function main() {
   if (nextPyText !== pyText) {
     await fsp.writeFile(pyPath, nextPyText, "utf8");
   }
-  const hookPython = createOrUpdateLangfuseVenv({ baseDir: claudeDir, pipIndexUrl });
-  const hookLauncher = await createHookLauncher({ hooksDir, hookPython, pyPath });
+  const hookRuntime = createOrUpdateLangfuseVenv({ baseDir: claudeDir, pipIndexUrl });
+  const hookPython = hookRuntime.python;
+  const hookLauncher = await createHookLauncher({ hooksDir, hookPython, hookPythonPath: hookRuntime.pythonPath, pyPath });
   const claudeShimDir = path.join(claudeDir, "bin");
   const realClaudeCli = resolveAgentCli({ target: "claude", preferred: args.cmd || "", shimDir: claudeShimDir });
   const directShim = writeAgentCommandShim({

package/scripts/opencode-langfuse-setup.mjs

@@ -1007,7 +1007,8 @@ function writeOpencodeCommandShim(opencodeDir, { publicKey, secretKey, baseUrl,
     cmd.push(...windowsGitPathBootstrap());
     cmd.push(windowsAutoUpdateCommand("opencode"));
     cmd.push(`set "OH_LANGFUSE_REAL_OPENCODE=${cmdSetValue(realOpencodeCli)}"`);
-    cmd.push('if exist "%OH_LANGFUSE_REAL_OPENCODE%" (');
+    cmd.push('echo "%OH_LANGFUSE_REAL_OPENCODE%" | findstr /I "\\node_modules\\opencode-ai\\bin\\opencode.exe" >nul');
+    cmd.push('if errorlevel 1 if exist "%OH_LANGFUSE_REAL_OPENCODE%" (');
     cmd.push('  call "%OH_LANGFUSE_REAL_OPENCODE%" %*');
     cmd.push("  exit /b %ERRORLEVEL%");
     cmd.push(")");
@@ -1023,10 +1024,6 @@ function writeOpencodeCommandShim(opencodeDir, { publicKey, secretKey, baseUrl,
     cmd.push('  call "%APPDATA%\\npm\\opencode.cmd" %*');
     cmd.push("  exit /b %ERRORLEVEL%");
     cmd.push(")");
-    cmd.push('if exist "%APPDATA%\\npm\\node_modules\\opencode-ai\\bin\\opencode.exe" (');
-    cmd.push('  call "%APPDATA%\\npm\\node_modules\\opencode-ai\\bin\\opencode.exe" %*');
-    cmd.push("  exit /b %ERRORLEVEL%");
-    cmd.push(")");
     cmd.push('if exist "%APPDATA%\\npm\\node_modules\\opencode-ai\\node_modules\\opencode-windows-x64\\bin\\opencode.exe" (');
     cmd.push('  call "%APPDATA%\\npm\\node_modules\\opencode-ai\\node_modules\\opencode-windows-x64\\bin\\opencode.exe" %*');
     cmd.push("  exit /b %ERRORLEVEL%");
@@ -1045,8 +1042,11 @@ function writeOpencodeCommandShim(opencodeDir, { publicKey, secretKey, baseUrl,
     cmd.push(")");
     cmd.push('for /f "delims=" %%O in (\'where.exe opencode 2^>nul\') do (');
     cmd.push('  if /I not "%%~fO"=="%~f0" (');
-    cmd.push('    call "%%O" %*');
-    cmd.push("    exit /b %ERRORLEVEL%");
+    cmd.push('    echo %%~fO | findstr /I "\\node_modules\\opencode-ai\\bin\\opencode.exe" >nul');
+    cmd.push("    if errorlevel 1 (");
+    cmd.push('      call "%%O" %*');
+    cmd.push("      exit /b %ERRORLEVEL%");
+    cmd.push("    )");
     cmd.push("  )");
     cmd.push(")");
     cmd.push("echo [ERROR] OpenCode CLI not found. Install OpenCode CLI first. 1>&2");

package/scripts/resolve-opencode-cli.mjs

@@ -3,18 +3,28 @@ import path from "node:path";
 import os from "node:os";
 import { spawnSync } from "node:child_process";
 import { listSystemCliCandidates } from "./cli-detection-utils.mjs";
-
-/**
+
+function isKnownBrokenWindowsOpencodeCandidate(candidate) {
+  if (process.platform !== "win32") return false;
+  const normalized = String(candidate || "").replace(/\//g, "\\").toLowerCase();
+  return normalized.endsWith("\\node_modules\\opencode-ai\\bin\\opencode.exe");
+}
+
+function usableCandidate(candidate) {
+  return candidate && !isKnownBrokenWindowsOpencodeCandidate(candidate) && fs.existsSync(candidate);
+}
+
+/**
  * OpenCode CLI 的官方安装脚本默认会把二进制放到 ~/.opencode/bin；
  * npm 全局安装则可能出现在 %AppData%\npm\opencode.cmd；PATH 也可能只认识 `opencode`。
  * @param {string|undefined} preferred --cmd=xxx 或可执行文件路径
  * @returns {string|null} 可执行的绝对路径，或仅在 PATH 中解析到则用 `opencode`
  */
 export function resolveOpencodeCli(preferred) {
-  if (typeof preferred === "string" && preferred.trim()) {
-    const p = preferred.trim();
-    if (fs.existsSync(p)) return path.resolve(p);
-  }
+  if (typeof preferred === "string" && preferred.trim()) {
+    const p = preferred.trim();
+    if (usableCandidate(p)) return path.resolve(p);
+  }
 
   const home = os.homedir();
 
@@ -30,7 +40,6 @@ export function resolveOpencodeCli(preferred) {
     if (process.env.APPDATA) {
       candidates.push(path.join(process.env.APPDATA, "npm", "opencode.cmd"));
       candidates.push(path.join(process.env.APPDATA, "npm", "opencode"));
-      candidates.push(path.join(process.env.APPDATA, "npm", "node_modules", "opencode-ai", "bin", "opencode.exe"));
       candidates.push(path.join(process.env.APPDATA, "npm", "node_modules", "opencode-ai", "node_modules", "opencode-windows-x64", "bin", "opencode.exe"));
       candidates.push(path.join(process.env.APPDATA, "npm", "node_modules", "opencode-ai", "node_modules", "opencode-windows-x64-baseline", "bin", "opencode.exe"));
       candidates.push(path.join(process.env.APPDATA, "npm", "node_modules", "opencode-windows-x64", "bin", "opencode.exe"));
@@ -42,17 +51,17 @@ export function resolveOpencodeCli(preferred) {
     candidates.push(path.join(home, ".local", "bin", "opencode"));
     candidates.push(...listSystemCliCandidates("opencode"));
   }
-
-  for (const c of candidates) {
-    if (c && fs.existsSync(c)) return c;
-  }
+
+  for (const c of candidates) {
+    if (usableCandidate(c)) return c;
+  }
 
   if (process.platform === "win32") {
     const r = spawnSync("where.exe", ["opencode"], { encoding: "utf8", windowsHide: true });
     if (r.status === 0 && r.stdout) {
-      const line = r.stdout.trim().split(/\r?\n/)[0]?.trim();
-      if (line && fs.existsSync(line)) return line;
-    }
+      const line = r.stdout.trim().split(/\r?\n/)[0]?.trim();
+      if (usableCandidate(line)) return line;
+    }
   } else {
     const r = spawnSync("which", ["opencode"], { encoding: "utf8" });
     if (r.status === 0 && r.stdout) {