oh-langfuse 0.1.77 → 0.1.79

package/scripts/opencode-langfuse-setup.mjs

@@ -1,1604 +1,1697 @@
-import fs from "node:fs";
-import path from "node:path";
-import os from "node:os";
-import { spawn, spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { parseJsonRelaxed, stripBom } from "./json-utils.mjs";
-import { shouldSuppressAgentLogLine } from "./log-filter-utils.mjs";
-import { writeRuntimeInstallRecord } from "./runtime-state-utils.mjs";
-import { resolveOpencodeCli } from "./resolve-opencode-cli.mjs";
-
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { spawn, spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { parseJsonRelaxed, stripBom } from "./json-utils.mjs";
+import { shouldSuppressAgentLogLine } from "./log-filter-utils.mjs";
+import { writeRuntimeInstallRecord } from "./runtime-state-utils.mjs";
+import { resolveOpencodeCli } from "./resolve-opencode-cli.mjs";
+
 const USER_ID_PATTERN = /^[a-z](?:\d{8}|wx\d{7})$/;
 const USER_ID_PATTERN_TEXT = "^[a-z](?:\\d{8}|wx\\d{7})$";
 const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const packageJson = JSON.parse(fs.readFileSync(path.join(rootDir, "package.json"), "utf8"));
+const DEFAULT_LANGFUSE_BASE_URL = "https://metrics.openharmonyinsight.cn";
+const LEGACY_LANGFUSE_BASE_URLS = new Set([
+  "http://120.46.221.227:3000",
+  "https://120.46.221.227:3000",
+]);
+
+function normalizeLegacyBaseUrl(baseUrl) {
+  const value = String(baseUrl || "").trim().replace(/\/+$/, "");
+  return LEGACY_LANGFUSE_BASE_URLS.has(value) ? DEFAULT_LANGFUSE_BASE_URL : baseUrl;
+}
 
 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 = {};
-  for (const raw of argv) {
-    if (!raw.startsWith("--")) continue;
-    const eq = raw.indexOf("=");
-    if (eq === -1) {
-      args[raw.slice(2)] = true;
-    } else {
-      args[raw.slice(2, eq)] = raw.slice(eq + 1);
-    }
-  }
-  return args;
-}
-
-function ensureDir(p) {
-  fs.mkdirSync(p, { recursive: true });
-}
-
-function readJsonIfExists(p) {
-  if (!fs.existsSync(p)) return null;
-  const txt = stripBom(fs.readFileSync(p, "utf8"));
-  if (!txt.trim()) return null;
-  return parseJsonRelaxed(txt, p);
-}
-
-function writeJsonPretty(p, obj) {
-  fs.writeFileSync(p, JSON.stringify(obj, null, 2) + os.EOL, "utf8");
-}
-
-const colorEnabled = process.stdout.isTTY && process.env.NO_COLOR !== "1";
-const ansi = (code) => (colorEnabled ? `\x1b[${code}m` : "");
-const colors = {
-  reset: ansi(0),
-  bold: ansi(1),
-  cyan: ansi(36),
-  green: ansi(32),
-  yellow: ansi(33),
-  dim: ansi(2)
-};
-
-function paint(text, ...styles) {
-  if (!colorEnabled) return String(text);
-  return `${styles.join("")}${text}${colors.reset}`;
-}
-
-function printCommandHint(label, command) {
-  console.log(paint(label, colors.yellow, colors.bold));
-  console.log(`${paint(">", colors.green, colors.bold)} ${paint(command, colors.cyan, colors.bold)}`);
-}
-
-function isObject(x) {
-  return x && typeof x === "object" && !Array.isArray(x);
-}
-
-function deepMerge(target, src) {
-  if (!isObject(target) || !isObject(src)) return src;
-  const out = { ...target };
-  for (const [k, v] of Object.entries(src)) {
-    if (isObject(v) && isObject(out[k])) out[k] = deepMerge(out[k], v);
-    else out[k] = v;
-  }
-  return out;
-}
-
-function mergePluginList(existing, name) {
-  let arr = [];
-  if (Array.isArray(existing)) arr = [...existing];
-  else if (typeof existing === "string" && existing.trim()) arr = [existing];
-  if (!arr.includes(name)) arr.push(name);
-  return arr;
-}
-
-function removePlugins(existing, names) {
-  const removeSet = new Set(names);
-  if (Array.isArray(existing)) return existing.filter((x) => !removeSet.has(x));
-  if (typeof existing === "string") return removeSet.has(existing) ? [] : [existing];
-  return [];
-}
-
-function psQuote(s) {
-  return `'${String(s).replace(/'/g, "''")}'`;
-}
-
-function cmdQuote(s) {
-  return `"${String(s).replace(/"/g, '""')}"`;
-}
-
-function cmdSetValue(s) {
-  return String(s).replace(/"/g, '""');
-}
-
-function writeLangfusePluginUserConfig({ userId }) {
-  const home = os.homedir();
-  const dir = path.join(home, ".config", "opencode-plugin-langfuse");
-  const p = path.join(dir, "config.json");
-  ensureDir(dir);
-  const obj = { usrid: userId, userId };
-  writeJsonPretty(p, obj);
-  return p;
-}
-
-function getPatchedLangfuseDistIndexJs() {
-  // This replaces opencode-plugin-langfuse/dist/index.js to inject userId into spans.
-  // It is intentionally self-contained (no extra build steps).
-  return [
-    'import { LangfuseSpanProcessor } from "@langfuse/otel";',
-    'import { configureGlobalLogger, LogLevel } from "@langfuse/core";',
-    'import { promises as fs } from "node:fs";',
-    'import os from "node:os";',
-    'import path from "node:path";',
-    'import { execFileSync } from "node:child_process";',
-    'import { NodeSDK } from "@opentelemetry/sdk-node";',
-    'import { trace } from "@opentelemetry/api";',
-    "",
-    "const USER_CONFIG_PATH = path.join(",
-    "  os.homedir(),",
-    '  ".config",',
-    '  "opencode-plugin-langfuse",',
-    '  "config.json"',
-    ");",
-    "",
-    "const readConfiguredUserId = async () => {",
-    "  try {",
-    '    const content = await fs.readFile(USER_CONFIG_PATH, "utf8");',
-    "    // tolerate UTF-8 BOM",
-    "    const txt = content.charCodeAt(0) === 0xfeff ? content.slice(1) : content;",
-    "    const parsed = JSON.parse(txt);",
-    "    const userId =",
-    '      typeof parsed.userId === "string"',
-    "        ? parsed.userId.trim()",
-    '        : typeof parsed.usrid === "string"',
-    "          ? parsed.usrid.trim()",
-    "          : \"\";",
-    "    return userId || undefined;",
-    "  } catch {",
-    "    return undefined;",
-    "  }",
-    "};",
-    "",
-    "const showNoisyLogs = /^(1|true|yes|on)$/i.test(String(process.env.OH_LANGFUSE_SHOW_LOGS || process.env.LANGFUSE_SHOW_LOGS || process.env.OH_LANGFUSE_SHOW_WARN || process.env.LANGFUSE_SHOW_WARN || ''));",
-    "if (!showNoisyLogs) {",
-    "  process.env.LANGFUSE_LOG_LEVEL = 'NONE';",
-    "  configureGlobalLogger({ level: LogLevel.NONE });",
-    "}",
-    "",
-    "const createUserIdSpanProcessor = (userId) => ({",
-    "  onStart: (span) => {",
-    '    span.setAttribute("langfuse.user.id", userId);',
-    '    span.setAttribute("user.id", userId);',
-    '    span.setAttribute("ai.telemetry.metadata.userId", userId);',
-    '    span.setAttribute("oh.langfuse.source", "opencode");',
-    '    span.setAttribute("oh.langfuse.user_id", userId);',
-    '    span.setAttribute("oh.langfuse.metrics_schema_version", "1.1");',
-    '    span.setAttribute("langfuse.trace.metadata.langfuse_user_id", userId);',
-    '    span.setAttribute("langfuse.observation.metadata.langfuse_user_id", userId);',
-    '    span.setAttribute("langfuse.metadata.langfuse_user_id", userId);',
-    '    span.setAttribute("langfuse.observation.metadata.source", "opencode");',
-    '    span.setAttribute("langfuse.observation.metadata.agent", "opencode");',
-    '    span.setAttribute("langfuse.observation.metadata.user_id", userId);',
-    '    span.setAttribute("langfuse.observation.metadata.metrics_schema_version", "1.1");',
-    "  },",
-    "  onEnd: (span) => {",
-    '    if (typeof span.setAttribute !== "function") return;',
-    '    span.setAttribute("langfuse.user.id", userId);',
-    '    span.setAttribute("user.id", userId);',
-    '    span.setAttribute("ai.telemetry.metadata.userId", userId);',
-    '    span.setAttribute("oh.langfuse.source", "opencode");',
-    '    span.setAttribute("oh.langfuse.user_id", userId);',
-    '    span.setAttribute("oh.langfuse.metrics_schema_version", "1.1");',
-    '    span.setAttribute("langfuse.trace.metadata.langfuse_user_id", userId);',
-    '    span.setAttribute("langfuse.observation.metadata.langfuse_user_id", userId);',
-    '    span.setAttribute("langfuse.metadata.langfuse_user_id", userId);',
-    '    span.setAttribute("langfuse.observation.metadata.source", "opencode");',
-    '    span.setAttribute("langfuse.observation.metadata.agent", "opencode");',
-    '    span.setAttribute("langfuse.observation.metadata.user_id", userId);',
-    '    span.setAttribute("langfuse.observation.metadata.metrics_schema_version", "1.1");',
-    "  },",
-    "  forceFlush: async () => {},",
-    "  shutdown: async () => {},",
-    "});",
-    "",
-    "const metricNumber = (value) => {",
-    '  if (typeof value === "number") return Number.isFinite(value) && value >= 0 ? value : undefined;',
-    '  if (typeof value === "string" && value.trim().startsWith("{")) {',
-    "    try {",
-    "      const parsed = JSON.parse(value);",
-    "      return metricNumber(parsed.intValue ?? parsed.doubleValue ?? parsed.value);",
-    "    } catch {",
-    "      return undefined;",
-    "    }",
-    "  }",
-    "  const n = Number(value);",
-    "  return Number.isFinite(n) && n >= 0 ? n : undefined;",
-    "};",
-    "",
-    "const writeSpanAttribute = (span, key, value) => {",
-    "  if (value === undefined || value === null) return;",
-    '  if (typeof span.setAttribute === "function") {',
-    "    span.setAttribute(key, value);",
-    "    return;",
-    "  }",
-    '  if (span.attributes && typeof span.attributes === "object") {',
-    "    span.attributes[key] = value;",
-    "  }",
-    "};",
-    "",
-    "const writeMetric = (span, key, value) => writeSpanAttribute(span, `langfuse.observation.metadata.${key}`, value);",
-    "",
-    "const emptyRepoContext = (cwd = '', cwdSource = 'unavailable', available = false, error = '', isGitRepo = false) => ({",
-    "  cwd: String(cwd || ''),",
-    "  cwd_source: cwdSource || 'unavailable',",
-    "  git_context_available: Boolean(available),",
-    "  git_context_error: error || '',",
-    "  is_git_repo: Boolean(isGitRepo),",
-    "  git_root: '',",
-    "  git_remote: '',",
-    "  git_remote_host: '',",
-    "  git_repo_owner: '',",
-    "  git_repo_name: '',",
-    "  git_repo_slug: '',",
-    "  git_branch: '',",
-    "  git_commit: '',",
-    "});",
-    "",
-    "const sanitizeGitRemote = (remote) => {",
-    "  const empty = { git_remote: '', git_remote_host: '', git_repo_owner: '', git_repo_name: '', git_repo_slug: '' };",
-    "  const raw = String(remote || '').trim();",
-    "  if (!raw) return empty;",
-    "  try {",
-    "    let host = '';",
-    "    let parts = [];",
-    "    if (raw.includes('://')) {",
-    "      const parsed = new URL(raw);",
-    "      host = parsed.hostname;",
-    "      parts = parsed.pathname.replace(/^\\/+|\\/+$/g, '').split('/').filter(Boolean);",
-    "    } else {",
-    "      const scp = raw.match(/^[^@]+@([^:]+):(.+)$/);",
-    "      if (scp) {",
-    "        host = scp[1];",
-    "        parts = scp[2].replace(/^\\/+|\\/+$/g, '').split('/').filter(Boolean);",
-    "      } else {",
-    "        const parsed = new URL(`ssh://${raw}`);",
-    "        host = parsed.hostname;",
-    "        parts = parsed.pathname.replace(/^\\/+|\\/+$/g, '').split('/').filter(Boolean);",
-    "      }",
-    "    }",
-    "    if (!host || parts.length < 2) return empty;",
-    "    const owner = parts[parts.length - 2];",
-    "    const repo = parts[parts.length - 1].replace(/\\.git$/i, '');",
-    "    if (!owner || !repo) return empty;",
-    "    const slug = `${owner}/${repo}`;",
-    "    return { git_remote: `${host}/${slug}`, git_remote_host: host, git_repo_owner: owner, git_repo_name: repo, git_repo_slug: slug };",
-    "  } catch {",
-    "    return empty;",
-    "  }",
-    "};",
-    "",
-    "const runGit = (cwd, args) => {",
-    "  try {",
-    "    const stdout = execFileSync('git', ['-C', cwd, ...args], { encoding: 'utf8', timeout: 500, stdio: ['ignore', 'pipe', 'ignore'] });",
-    "    return { ok: true, stdout: String(stdout || '').trim(), error: '' };",
-    "  } catch (error) {",
-    "    if (error && error.code === 'ETIMEDOUT') return { ok: false, stdout: '', error: 'timeout' };",
-    "    if (error && error.code === 'ENOENT') return { ok: false, stdout: '', error: 'git_unavailable' };",
-    "    return { ok: false, stdout: '', error: 'git_error' };",
-    "  }",
-    "};",
-    "",
-    "const repoContextCache = new Map();",
-    'const collectRepoContext = (cwd, cwdSource = "process") => {',
-    "  const cwdText = String(cwd || '').trim();",
-    "  if (!cwdText) return emptyRepoContext('', 'unavailable', false, 'missing_cwd');",
-    "  const now = Date.now();",
-    "  const cached = repoContextCache.get(cwdText);",
-    "  if (cached && now - cached.time <= 30000) return { ...cached.context, cwd_source: cwdSource || cached.context.cwd_source };",
-    "  let context = emptyRepoContext(cwdText, cwdSource, false, '', false);",
-    "  const inside = runGit(cwdText, ['rev-parse', '--is-inside-work-tree']);",
-    "  if (!inside.ok) {",
-    "    const reason = ['timeout', 'git_unavailable'].includes(inside.error) ? inside.error : '';",
-    "    context = reason ? emptyRepoContext(cwdText, cwdSource, false, reason, false) : emptyRepoContext(cwdText, cwdSource, true, '', false);",
-    "    repoContextCache.set(cwdText, { time: now, context });",
-    "    return context;",
-    "  }",
-    "  if (inside.stdout.toLowerCase() !== 'true') {",
-    "    context = emptyRepoContext(cwdText, cwdSource, true, '', false);",
-    "    repoContextCache.set(cwdText, { time: now, context });",
-    "    return context;",
-    "  }",
-    "  context = emptyRepoContext(cwdText, cwdSource, true, '', true);",
-    "  const root = runGit(cwdText, ['rev-parse', '--show-toplevel']);",
-    "  if (!root.ok && ['timeout', 'git_unavailable'].includes(root.error)) {",
-    "    context.git_context_available = false;",
-    "    context.git_context_error = root.error;",
-    "    repoContextCache.set(cwdText, { time: now, context });",
-    "    return context;",
-    "  }",
-    "  context.git_root = root.stdout || '';",
-    "  const remote = runGit(cwdText, ['config', '--get', 'remote.origin.url']);",
-    "  if (remote.ok && remote.stdout) {",
-    "    const sanitized = sanitizeGitRemote(remote.stdout);",
-    "    context = { ...context, ...sanitized };",
-    "    if (!sanitized.git_remote) context.git_context_error = 'remote_parse_failed';",
-    "  } else if (['timeout', 'git_unavailable'].includes(remote.error)) {",
-    "    context.git_context_available = false;",
-    "    context.git_context_error = remote.error;",
-    "  }",
-    "  const branch = runGit(cwdText, ['branch', '--show-current']);",
-    "  if (branch.ok) context.git_branch = branch.stdout || '';",
-    "  const commit = runGit(cwdText, ['rev-parse', '--short', 'HEAD']);",
-    "  if (commit.ok) context.git_commit = commit.stdout || '';",
-    "  repoContextCache.set(cwdText, { time: now, context });",
-    "  return context;",
-    "};",
-    "",
-    "const writeRepoContextMetrics = (span, context) => {",
-    "  const repoContext = context || {};",
-    "  writeSpanAttribute(span, 'langfuse.observation.metadata.cwd', repoContext.cwd);",
-    "  writeSpanAttribute(span, 'langfuse.observation.metadata.cwd_source', repoContext.cwd_source);",
-    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_context_available', repoContext.git_context_available);",
-    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_context_error', repoContext.git_context_error);",
-    "  writeSpanAttribute(span, 'langfuse.observation.metadata.is_git_repo', repoContext.is_git_repo);",
-    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_root', repoContext.git_root);",
-    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_remote', repoContext.git_remote);",
-    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_remote_host', repoContext.git_remote_host);",
-    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_repo_owner', repoContext.git_repo_owner);",
-    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_repo_name', repoContext.git_repo_name);",
-    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_repo_slug', repoContext.git_repo_slug);",
-    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_branch', repoContext.git_branch);",
-    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_commit', repoContext.git_commit);",
-    "};",
-    "",
-    "const writeOpencodeMetricAttributes = (span, userId) => {",
-    "  const attrs = span.attributes ?? {};",
-    '  writeSpanAttribute(span, "oh.langfuse.source", "opencode");',
-    '  writeSpanAttribute(span, "oh.langfuse.metrics_schema_version", "1.1");',
-    '  if (userId) writeSpanAttribute(span, "oh.langfuse.user_id", userId);',
-    '  writeMetric(span, "source", "opencode");',
-    '  writeMetric(span, "agent", "opencode");',
-    '  writeMetric(span, "metrics_schema_version", "1.1");',
-    '  if (userId) writeMetric(span, "user_id", userId);',
-    '  const hasModel = attrs["ai.model.id"] || attrs["ai.model.provider"] || attrs["gen_ai.request.model"];',
-    '  const isTool = attrs["ai.toolCall.name"] || attrs["ai.toolCall.id"];',
-    "  if (!hasModel || isTool) return false;",
-    '  const provider = attrs["ai.model.provider"] || attrs["gen_ai.system"] || "";',
-    '  const modelId = attrs["ai.model.id"] || attrs["gen_ai.request.model"] || attrs["ai.response.model"] || "";',
-    '  const model = provider && modelId ? `${provider}/${modelId}` : provider || modelId || undefined;',
-    '  writeMetric(span, "model", model);',
-    "  return true;",
-    "};",
-    "",
-    "const createMetricsSpanProcessor = (userId) => ({",
-    "  onStart: (span) => {",
-    "    writeOpencodeMetricAttributes(span, userId);",
-    "  },",
-    "  onEnd: (span) => {",
-    "    writeOpencodeMetricAttributes(span, userId);",
-    "  },",
-    "  forceFlush: async () => {},",
-    "  shutdown: async () => {},",
-    "});",
-    "",
-    "const eventPayload = (event) => event?.properties ?? event?.data ?? event?.payload ?? event?.body ?? event ?? {};",
-    "const eventPart = (event) => {",
-    "  const payload = eventPayload(event);",
-    "  return payload.part ?? payload.properties?.part ?? payload.data?.part ?? payload.payload?.part ?? event?.part ?? event?.data?.part ?? event?.payload?.part ?? payload;",
-    "};",
-    "const pickEventString = (...values) => {",
-    "  for (const value of values) {",
-    '    if (typeof value === "string" && value.trim()) return value.trim();',
-    "  }",
-    '  return "";',
-    "};",
-    "const countOpencodeToolActivity = (event) => {",
-    "  const payload = eventPayload(event);",
-    "  const part = eventPart(event);",
-    "  const eventType = pickEventString(event?.name, event?.type, payload?.name, payload?.type);",
-    "  const partType = pickEventString(part?.type);",
-    "  const toolName = pickEventString(part?.tool, part?.toolName, part?.name, payload?.tool, payload?.toolName, payload?.name);",
-    "  const callId = pickEventString(part?.callID, part?.callId, payload?.callID, payload?.callId, part?.id);",
-    "  const status = pickEventString(part?.state?.status, part?.status, payload?.state?.status, payload?.status).toLowerCase();",
-    "  const hasToolInput = part?.state?.input !== undefined || part?.input !== undefined || payload?.input !== undefined;",
-    "  const hasToolOutput = part?.state?.output !== undefined || part?.output !== undefined || payload?.output !== undefined;",
-    "  const isToolCall = eventType === 'tool_use' || eventType === 'tool_result' || partType === 'tool' || partType === 'tool_use' || Boolean(toolName) || hasToolInput;",
-    "  const isToolResult = eventType === 'tool_result' || status === 'completed' || status === 'success' || hasToolOutput;",
-    "  return {",
-    "    toolCallCount: isToolCall ? 1 : 0,",
-    "    toolResultCount: isToolCall && isToolResult ? 1 : 0,",
-    "    toolCallId: callId || '',",
-    "  };",
-    "};",
-    "const tokenMetricsFromPart = (part) => {",
-    "  const tokens = part?.tokens ?? part?.usage ?? {};",
-    "  return {",
-    "    input: metricNumber(tokens.input ?? tokens.input_tokens ?? tokens.inputTokens),",
-    "    output: metricNumber(tokens.output ?? tokens.output_tokens ?? tokens.outputTokens),",
-    "    total: metricNumber(tokens.total ?? tokens.total_tokens ?? tokens.totalTokens),",
-    "    cacheRead: metricNumber(tokens.cache?.read ?? tokens.cacheRead ?? tokens.cache_read_tokens ?? tokens.cachedInputTokens),",
-    "    reasoning: metricNumber(tokens.reasoning ?? tokens.reasoning_tokens ?? tokens.reasoningTokens),",
-    "  };",
-    "};",
-    "const OBSERVATION_TEXT_LIMIT = 20000;",
-    "const limitObservationText = (text) => {",
-    "  const normalized = typeof text === 'string' ? text.trim() : '';",
-    "  if (!normalized) return '';",
-    "  return normalized.length > OBSERVATION_TEXT_LIMIT ? `${normalized.slice(0, OBSERVATION_TEXT_LIMIT)}\\n...[truncated]` : normalized;",
-    "};",
-    "const textFromContent = (value, depth = 0) => {",
-    "  if (depth > 6 || value === null || value === undefined) return '';",
-    "  if (typeof value === 'string') return value.trim();",
-    "  if (Array.isArray(value)) return value.map((item) => textFromContent(item, depth + 1)).filter(Boolean).join('\\n').trim();",
-    "  if (typeof value !== 'object') return '';",
-    "  for (const key of ['text', 'content', 'prompt', 'message', 'input', 'output', 'parts']) {",
-    "    const text = textFromContent(value[key], depth + 1);",
-    "    if (text) return text;",
-    "  }",
-    "  return '';",
-    "};",
-    "const promptFromArgv = () => {",
-    "  const args = process.argv.slice(2);",
-    "  if (!args.includes('run')) return '';",
-    "  for (let i = args.length - 1; i >= 0; i -= 1) {",
-    "    const arg = args[i];",
-    "    if (typeof arg === 'string' && arg.trim() && !arg.startsWith('-')) return arg.trim();",
-    "  }",
-    "  return '';",
-    "};",
-    "",
-    "const normalizeSkillNames = (names) => {",
-    "  if (!Array.isArray(names)) return [];",
-    "  const out = [];",
-    "  const seen = new Set();",
-    "  for (const raw of names) {",
-    "    const name = String(raw || '').trim();",
-    "    if (!name || seen.has(name)) continue;",
-    "    seen.add(name);",
-    "    out.push(name);",
-    "  }",
-    "  return out;",
-    "};",
-    "const skillNamespace = (name) => String(name || '').includes(':') ? String(name).split(':', 1)[0] : '';",
-    "const skillAgentPath = (detectedBy) => {",
-    "  if (detectedBy === 'tool_call') return 'opencode_skill_tool';",
-    "  if (detectedBy === 'slash_command') return 'opencode_slash_prompt';",
-    "  if (detectedBy === 'natural_language_request') return 'opencode_prompt_skill_name';",
-    "  if (detectedBy === 'skill_file_path') return 'skill_file_path';",
-    "  return detectedBy || 'metadata';",
-    "};",
-    "const skillInvocationMode = (detectedBy) => {",
-    "  if (detectedBy === 'slash_command') return 'explicit_request';",
-    "  if (detectedBy === 'natural_language_request') return 'implicit_request';",
-    "  if (detectedBy === 'tool_call' || detectedBy === 'plugin_event') return 'implicit';",
-    "  return 'detected';",
-    "};",
-    "const skillEventType = (detectedBy) => (detectedBy === 'slash_command' || detectedBy === 'natural_language_request') ? 'requested' : (detectedBy === 'tool_call' || detectedBy === 'plugin_event' ? 'invoked' : 'detected');",
-    "const skillIdSegment = (name) => String(name || 'unknown').trim().replace(/[^A-Za-z0-9_.:-]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 96) || 'unknown';",
-    "",
-    "const escapeRegExp = (value) => String(value).replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');",
-    "const normalizeExplicitSkillCommand = (value) => {",
-    "  const command = pickEventString(value).replace(/^\\/+/, '').trim();",
-    "  if (!command) return '';",
-    "  return command.split(/\\s+/, 1)[0];",
-    "};",
-    "",
-    "const collectStrings = (value, out = []) => {",
-    "  if (value == null) return out;",
-    "  if (typeof value === 'string') {",
-    "    out.push(value);",
-    "    return out;",
-    "  }",
-    "  if (typeof value === 'number' || typeof value === 'boolean') return out;",
-    "  if (Array.isArray(value)) {",
-    "    for (const item of value) collectStrings(item, out);",
-    "    return out;",
-    "  }",
-    "  if (typeof value === 'object') {",
-    "    for (const [key, item] of Object.entries(value)) {",
-    "      out.push(key);",
-    "      collectStrings(item, out);",
-    "    }",
-    "  }",
-    "  return out;",
-    "};",
-    "",
-    "const collectExplicitSkillUsages = (value, out = []) => {",
-    "  if (value == null) return out;",
-    "  if (Array.isArray(value)) {",
-    "    for (const item of value) collectExplicitSkillUsages(item, out);",
-    "    return out;",
-    "  }",
-    "  if (typeof value !== 'object') return out;",
-    "  const command = normalizeExplicitSkillCommand(value.command ?? value.commandName ?? value.promptCommand ?? value.properties?.command ?? value.properties?.commandName);",
-    "  if (command) {",
-    "    const callId = pickEventString(value.commandID, value.commandId, value.id);",
-    "    out.push({ name: command, skill_namespace: skillNamespace(command), detected_by: 'slash_command', skill_call_id: callId });",
-    "  }",
-    "  const toolName = pickEventString(value.tool, value.toolName, value.name).toLowerCase();",
-    "  const input = value.input ?? value.state?.input ?? value.properties?.input;",
-    "  if (toolName === 'skill' && input && typeof input === 'object' && !Array.isArray(input)) {",
-    "    const skill = pickEventString(input.skill_name, input.skill, input.name);",
-    "    const callId = pickEventString(value.callID, value.callId, value.id, value.toolCallID, value.toolCallId);",
-    "    if (skill) out.push({ name: skill, skill_namespace: skillNamespace(skill), detected_by: 'tool_call', skill_call_id: callId });",
-    "  }",
-    "  for (const item of Object.values(value)) collectExplicitSkillUsages(item, out);",
-    "  return out;",
-    "};",
-    "",
-    "const detectPromptSkillRequests = (haystack, skills) => {",
-    "  const text = String(haystack || '');",
-    "  if (!text.trim()) return [];",
-    "  const out = [];",
-    "  for (const skillName of skills) {",
-    "    const escaped = escapeRegExp(skillName);",
-    "    const pattern = new RegExp(`(?:请\\\\s*)?(?:使用|调用|启用|采用)\\\\s*[\\\"'“”‘’]?${escaped}(?=$|[\\\\s,，。；;:：、])|\\\\b(?:use|invoke|run|apply)\\\\s+[\\\"']?${escaped}(?=$|[\\\\s,，。；;:：])`, 'i');",
-    "    if (pattern.test(text)) out.push({ name: skillName, skill_namespace: skillNamespace(skillName), detected_by: 'natural_language_request', skill_call_id: '' });",
-    "  }",
-    "  return out;",
-    "};",
-    "",
-    "const detectOpencodeSkillUsages = (source, knownSkills = []) => {",
-    "  const skills = normalizeSkillNames(knownSkills);",
-    "  if (skills.length === 0) return [];",
-    "  const found = [];",
-    "  const explicitSeen = new Set();",
-    "  const explicit = [];",
-    "  for (const usage of collectExplicitSkillUsages(source).filter((item) => skills.includes(item.name))) {",
-    "    if (usage.skill_call_id) {",
-    "      const key = `call:${usage.skill_call_id}`;",
-    "      if (explicitSeen.has(key)) continue;",
-    "      explicitSeen.add(key);",
-    "    } else if (usage.detected_by === 'slash_command') {",
-    "      const key = `command:${usage.name}`;",
-    "      if (explicitSeen.has(key)) continue;",
-    "      explicitSeen.add(key);",
-    "    }",
-    "    explicit.push(usage);",
-    "  }",
-    "  found.push(...explicit);",
-    "  const haystack = collectStrings(source).join('\\n');",
-    "  const promptSeen = new Set(explicit.map((usage) => usage.name));",
-    "  for (const usage of detectPromptSkillRequests(haystack, skills)) {",
-    "    if (promptSeen.has(usage.name)) continue;",
-    "    promptSeen.add(usage.name);",
-    "    found.push(usage);",
-    "  }",
-    "  const pathSeen = new Set();",
-    "  for (const match of haystack.matchAll(/(?:^|[\"'\\s])(?:[A-Za-z]:)?[^\"'\\n\\r]*[\\\\/]+([^\\\\/\"'\\n\\r]+)[\\\\/]+SKILL\\.md(?=$|[\"'\\s])/gi)) {",
-    "    const skillName = match[1];",
-    "    if (!skills.includes(skillName) || explicit.some((usage) => usage.name === skillName) || pathSeen.has(skillName)) continue;",
-    "    pathSeen.add(skillName);",
-    "    found.push({ name: skillName, skill_namespace: skillNamespace(skillName), detected_by: 'skill_file_path', skill_call_id: '' });",
-    "  }",
-    "  return found;",
-    "};",
-    "const uniqueSkillNames = (usages) => normalizeSkillNames((usages || []).map((usage) => usage.name));",
-    "const dedupeSkillUsages = (usages) => {",
-    "  const out = [];",
-    "  const seen = new Set();",
-    "  for (const usage of usages || []) {",
-    "    const key = usage.skill_call_id ? `call:${usage.skill_call_id}` : `${usage.name}:${usage.detected_by}`;",
-    "    if (seen.has(key)) continue;",
-    "    seen.add(key);",
-    "    out.push(usage);",
-    "  }",
-    "  return out;",
-    "};",
-    "const buildSkillUseEvents = (interactionId, skillUsages) => {",
-    "  const usages = dedupeSkillUsages(skillUsages);",
-    "  const total = usages.length;",
-    "  return usages.map((usage, index) => {",
-    "    const skillName = String(usage.name || '').trim();",
-    "    const detectedBy = String(usage.detected_by || 'metadata');",
-    "    const invocationMode = skillInvocationMode(detectedBy);",
-    "    return {",
-    "      skill_use_id: `${interactionId}:skill:${index + 1}:${skillIdSegment(skillName)}`,",
-    "      skill_use_index: index + 1,",
-    "      skill_use_count_in_interaction: total,",
-    "      skill_event_type: skillEventType(detectedBy),",
-    "      skill_trigger: invocationMode,",
-    "      skill_invocation_mode: invocationMode,",
-    "      skill_agent_path: skillAgentPath(detectedBy),",
-    "      skill_name: skillName,",
-    "      skill_use_count: 1,",
-    "      skill_namespace: usage.skill_namespace || skillNamespace(skillName),",
-    "      detected_by: detectedBy,",
-    "      ...(usage.skill_call_id ? { skill_call_id: usage.skill_call_id } : {}),",
-    "    };",
-    "  }).filter((event) => event.skill_name);",
-    "};",
-    "",
-    "const collectKnownSkillNames = async () => {",
-    "  const dirs = [",
-    "    path.join(process.cwd(), '.opencode', 'skill'),",
-    "    path.join(process.cwd(), '.opencode', 'skills'),",
-    "    path.join(os.homedir(), '.config', 'opencode', 'skill'),",
-    "    path.join(os.homedir(), '.config', 'opencode', 'skills'),",
-    "    path.join(os.homedir(), '.opencode', 'skill'),",
-    "    path.join(os.homedir(), '.opencode', 'skills'),",
-    "  ];",
-    "  const names = new Set();",
-    "  for (const dir of dirs) {",
-    "    try {",
-    "      const entries = await fs.readdir(dir, { withFileTypes: true });",
-    "      for (const entry of entries) {",
-    "        if (!entry.isDirectory() || entry.name.startsWith('.')) continue;",
-    "        try {",
-    "          await fs.access(path.join(dir, entry.name, 'SKILL.md'));",
-    "          names.add(entry.name);",
-    "        } catch {",
-    "          // Ignore helper folders that are not OpenCode skills.",
-    "        }",
-    "      }",
-    "    } catch {",
-    "      // Optional skill directories are allowed to be absent.",
-    "    }",
-    "  }",
-    "  return [...names];",
-    "};",
-    "",
-    "export const LangfusePlugin = async ({ client }) => {",
-    "  const publicKey = process.env.LANGFUSE_PUBLIC_KEY;",
-    "  const secretKey = process.env.LANGFUSE_SECRET_KEY;",
-    '  const baseUrl = process.env.LANGFUSE_BASEURL ?? "https://cloud.langfuse.com";',
-    '  const environment = process.env.LANGFUSE_ENVIRONMENT ?? "development";',
-    "",
-    "  const userIdFromConfig = await readConfiguredUserId();",
-    "  const userIdEnv = process.env.LANGFUSE_USER_ID?.trim();",
-    "  const userId = userIdEnv || userIdFromConfig;",
-    "",
-    "  const log = (level, message) => {",
-    "    if ((level === 'warn' || level === 'error') && !showNoisyLogs) return;",
-    '    client.app.log({ body: { service: "langfuse-otel", level, message } });',
-    "  };",
-    "",
-    "  if (!publicKey || !secretKey) {",
-    '    log("warn", "Missing LANGFUSE_PUBLIC_KEY or LANGFUSE_SECRET_KEY - tracing disabled");',
-    "    return {};",
-    "  }",
-    "",
-    "  const processor = new LangfuseSpanProcessor({ publicKey, secretKey, baseUrl, environment });",
-    "  const spanProcessors = [processor, createMetricsSpanProcessor(userId)];",
-    "  if (userId) spanProcessors.push(createUserIdSpanProcessor(userId));",
-    "",
-    "  const sdk = new NodeSDK({ spanProcessors });",
-    "  const sdkStartPromise = Promise.resolve().then(() => sdk.start()).catch((err) => {",
-    '    log("warn", `OTEL SDK start failed: ${err?.message ?? err}`);',
-    "  });",
-    "  const getMetricsTracer = () => trace.getTracer('oh-langfuse-opencode-metrics');",
-    "  const knownSkillNames = await collectKnownSkillNames();",
-    "  const startupSkillUsages = detectOpencodeSkillUsages(process.argv.join('\\n'), knownSkillNames);",
-    "  const startupPromptText = limitObservationText(promptFromArgv());",
-    "  const messageTextById = new Map();",
-    "  const messageInputById = new Map();",
-    "  const lastUserTextBySessionId = new Map();",
-    "  const skillUsagesByMessageId = new Map();",
-    "  const skillUsagesBySessionId = new Map();",
-    "  const startupSkillSessionIds = new Set();",
-    "  const toolCallIdsByMessageId = new Map();",
-    "  const toolCallIdsBySessionId = new Map();",
-    "  const toolResultIdsByMessageId = new Map();",
-    "  const toolResultIdsBySessionId = new Map();",
-    "  const emittedMessageIds = new Set();",
-    "",
-    '  log("info", `OTEL tracing initialized -> ${baseUrl}`);',
-    '  if (userId) log("info", `LANGFUSE userId configured -> ${userId}`);',
-    '  if (knownSkillNames.length) log("info", `OpenCode skills discovered -> ${knownSkillNames.length}`);',
-    "",
-    "  let shutdownStarted = false;",
-    "  const flush = async (reason) => {",
-    "    try {",
-    '      log("info", `Flushing OTEL spans on ${reason}`);',
-    "      await sdkStartPromise;",
-    "      await processor.forceFlush();",
-    "    } catch (error) {",
-    '      log("warn", `OTEL forceFlush failed on ${reason}: ${error?.message ?? error}`);',
-    "    }",
-    "  };",
-    "  const shutdown = async (reason) => {",
-    "    if (shutdownStarted) return;",
-    "    shutdownStarted = true;",
-    "    try {",
-    '      log("info", `Shutting down OTEL SDK on ${reason}`);',
-    "      await sdkStartPromise;",
-    "      await sdk.shutdown();",
-    "    } catch (error) {",
-    '      log("warn", `OTEL shutdown failed on ${reason}: ${error?.message ?? error}`);',
-    "    }",
-    "  };",
-    "  process.once('beforeExit', async () => {",
-    "    await flush('process.beforeExit');",
-    "    await shutdown('process.beforeExit');",
-    "  });",
-    "  const originalExit = process.exit.bind(process);",
-    "  process.exit = ((code) => {",
-    "    void shutdown('process.exit').finally(() => originalExit(code));",
-    "  });",
-    "",
-    "  const rememberSkillUsages = (map, key, usages) => {",
-    "    if (!key || !usages.length) return;",
-    "    let list = map.get(key);",
-    "    if (!list) {",
-    "      list = [];",
-    "      map.set(key, list);",
-    "    }",
-    "    const seen = new Set(list.map((usage) => usage.skill_call_id ? `call:${usage.skill_call_id}` : `${usage.name}:${usage.detected_by}`));",
-    "    for (const usage of usages) {",
-    "      const key = usage.skill_call_id ? `call:${usage.skill_call_id}` : `${usage.name}:${usage.detected_by}`;",
-    "      if (seen.has(key)) continue;",
-    "      seen.add(key);",
-    "      list.push(usage);",
-    "    }",
-    "  };",
-    "  const rememberToolActivity = (map, key, activity, kind) => {",
-    "    if (!key || !activity?.[kind]) return;",
-    "    let set = map.get(key);",
-    "    if (!set) {",
-    "      set = new Set();",
-    "      map.set(key, set);",
-    "    }",
-    "    set.add(activity.toolCallId || `${kind}:${set.size + 1}`);",
-    "  };",
-    "  const recordInteractionMetric = async (event) => {",
-    "    const payload = eventPayload(event);",
-    "    const part = eventPart(event);",
-    "    const partType = part?.type ?? '';",
-    "    const sessionId = pickEventString(part?.sessionID, part?.sessionId, payload?.sessionID, payload?.sessionId, payload?.session?.id, event?.sessionID, event?.sessionId);",
-    "    const messageId = pickEventString(part?.messageID, part?.messageId, payload?.messageID, payload?.messageId, payload?.message?.id, event?.messageID, event?.messageId);",
-    "    const role = pickEventString(part?.role, payload?.role, payload?.message?.role, event?.role).toLowerCase();",
-    "    const eventText = textFromContent(part) || textFromContent(payload?.message) || textFromContent(payload);",
-    "    if (eventText && role === 'user') {",
-    "      const inputText = limitObservationText(eventText);",
-    "      if (messageId) messageInputById.set(messageId, inputText);",
-    "      if (sessionId) lastUserTextBySessionId.set(sessionId, inputText);",
-    "      return;",
-    "    }",
-    "    if (sessionId && startupSkillUsages.length && !startupSkillSessionIds.has(sessionId)) {",
-    "      startupSkillSessionIds.add(sessionId);",
-    "      rememberSkillUsages(skillUsagesBySessionId, sessionId, startupSkillUsages);",
-    "    }",
-    "    const skillDetectionSources = [part, payload, part?.state?.input, part?.input, payload?.input, part?.state?.metadata, payload?.metadata, part?.state?.file, part?.file];",
-    "    const eventSkillUsages = detectOpencodeSkillUsages(skillDetectionSources, knownSkillNames);",
-    "    rememberSkillUsages(skillUsagesByMessageId, messageId, eventSkillUsages);",
-    "    rememberSkillUsages(skillUsagesBySessionId, sessionId, eventSkillUsages);",
-    "    const toolActivity = countOpencodeToolActivity(event);",
-    "    rememberToolActivity(toolCallIdsByMessageId, messageId, toolActivity, 'toolCallCount');",
-    "    rememberToolActivity(toolCallIdsBySessionId, sessionId, toolActivity, 'toolCallCount');",
-    "    rememberToolActivity(toolResultIdsByMessageId, messageId, toolActivity, 'toolResultCount');",
-    "    rememberToolActivity(toolResultIdsBySessionId, sessionId, toolActivity, 'toolResultCount');",
-    "    if (eventText && messageId && (role === 'assistant' || partType === 'text')) {",
-    "      messageTextById.set(messageId, limitObservationText(eventText));",
-    "      const textSkillUsages = detectOpencodeSkillUsages(eventText, knownSkillNames);",
-    "      rememberSkillUsages(skillUsagesByMessageId, messageId, textSkillUsages);",
-    "      rememberSkillUsages(skillUsagesBySessionId, sessionId, textSkillUsages);",
-    "      return;",
-    "    }",
-    "    if (partType !== 'step-finish' || !messageId || emittedMessageIds.has(messageId)) return;",
-    "    emittedMessageIds.add(messageId);",
-    "    const tokenMetrics = tokenMetricsFromPart(part);",
-    "    const total = tokenMetrics.total ?? (tokenMetrics.input !== undefined && tokenMetrics.output !== undefined ? tokenMetrics.input + tokenMetrics.output : undefined);",
-    "    const tokenAvailable = [tokenMetrics.input, tokenMetrics.output, total, tokenMetrics.cacheRead, tokenMetrics.reasoning].some((value) => value !== undefined);",
-    "    await sdkStartPromise;",
-    "    const span = getMetricsTracer().startSpan('OpenCode Agent Turn');",
-    "    const text = messageTextById.get(messageId) || '';",
-    "    const inputText = messageInputById.get(messageId) || lastUserTextBySessionId.get(sessionId) || startupPromptText || '';",
-    "    const skillUsages = dedupeSkillUsages([...(skillUsagesByMessageId.get(messageId) ?? []), ...(skillUsagesBySessionId.get(sessionId) ?? [])]);",
-    "    const interactionId = `opencode:${userId || \"unknown\"}:${sessionId || \"unknown\"}:${messageId}`;",
-    "    const skillUseEvents = buildSkillUseEvents(interactionId, skillUsages);",
-    "    const skillNames = uniqueSkillNames(skillUsages);",
-    "    const skillNamesAll = skillUseEvents.map((event) => event.skill_name);",
-    "    const skillInvocationModes = skillUseEvents.map((event) => event.skill_invocation_mode).filter(Boolean);",
-    "    const skillAgentPaths = skillUseEvents.map((event) => event.skill_agent_path).filter(Boolean);",
-    "    const toolCallCount = Math.max(new Set([...(toolCallIdsByMessageId.get(messageId) ?? []), ...(toolCallIdsBySessionId.get(sessionId) ?? [])]).size, skillUseEvents.length);",
-    "    const toolResultCount = Math.max(new Set([...(toolResultIdsByMessageId.get(messageId) ?? []), ...(toolResultIdsBySessionId.get(sessionId) ?? [])]).size, skillUseEvents.length);",
-    '    span.setAttribute("oh.langfuse.source", "opencode");',
-    '    span.setAttribute("oh.langfuse.user_id", userId || "");',
-    '    span.setAttribute("oh.langfuse.metrics_schema_version", "1.1");',
-    '    span.setAttribute("langfuse.observation.metadata.source", "opencode");',
-    '    span.setAttribute("langfuse.observation.metadata.agent", "opencode");',
-    '    span.setAttribute("langfuse.observation.metadata.user_id", userId || "");',
-    '    span.setAttribute("langfuse.observation.metadata.session_id", sessionId || "unknown");',
-    '    span.setAttribute("langfuse.observation.metadata.interaction_id", interactionId);',
-    '    span.setAttribute("langfuse.observation.metadata.metrics_schema_version", "1.1");',
-    '    span.setAttribute("langfuse.observation.metadata.interaction_count", 1);',
-    '    span.setAttribute("langfuse.observation.metadata.user_message_count", 1);',
-    '    span.setAttribute("langfuse.observation.metadata.assistant_message_count", 1);',
-    '    span.setAttribute("langfuse.observation.metadata.token_metrics_available", tokenAvailable);',
-    '    span.setAttribute("langfuse.observation.metadata.tool_call_count", toolCallCount);',
-    '    span.setAttribute("langfuse.observation.metadata.tool_result_count", toolResultCount);',
-    '    span.setAttribute("langfuse.observation.metadata.skill_use_count", skillUseEvents.length);',
-    '    span.setAttribute("langfuse.observation.metadata.unique_skill_count", skillNames.length);',
-    '    span.setAttribute("langfuse.observation.metadata.repeated_skill_count", Math.max(0, skillUseEvents.length - skillNames.length));',
-    '    if (skillNames.length) span.setAttribute("langfuse.observation.metadata.skill_names", skillNames);',
-    '    if (skillNames.length) span.setAttribute("langfuse.observation.metadata.skill_names_csv", skillNames.join(","));',
-    '    if (skillNamesAll.length) span.setAttribute("langfuse.observation.metadata.skill_names_all", skillNamesAll);',
-    '    if (skillInvocationModes.length) span.setAttribute("langfuse.observation.metadata.skill_invocation_modes", skillInvocationModes);',
-    '    if (skillAgentPaths.length) span.setAttribute("langfuse.observation.metadata.skill_agent_paths", skillAgentPaths);',
-    '    if (tokenMetrics.input !== undefined) span.setAttribute("langfuse.observation.metadata.input_tokens", tokenMetrics.input);',
-    '    if (tokenMetrics.output !== undefined) span.setAttribute("langfuse.observation.metadata.output_tokens", tokenMetrics.output);',
-    '    if (total !== undefined) span.setAttribute("langfuse.observation.metadata.total_tokens", total);',
-    '    if (tokenMetrics.cacheRead !== undefined) span.setAttribute("langfuse.observation.metadata.cache_read_tokens", tokenMetrics.cacheRead);',
-    '    if (tokenMetrics.reasoning !== undefined) span.setAttribute("langfuse.observation.metadata.reasoning_tokens", tokenMetrics.reasoning);',
-    '    if (inputText) span.setAttribute("langfuse.observation.input", inputText);',
-    '    if (inputText) span.setAttribute("langfuse.trace.input", inputText);',
-    '    if (inputText) span.setAttribute("input.value", inputText);',
-    '    if (text) span.setAttribute("langfuse.observation.output", text);',
-    '    if (text) span.setAttribute("langfuse.trace.output", text);',
-    '    if (text) span.setAttribute("output.value", text);',
-    '    if (inputText) span.setAttribute("langfuse.observation.metadata.input_text_preview", inputText.slice(0, 512));',
-    '    if (text) span.setAttribute("langfuse.observation.metadata.output_text_preview", text.slice(0, 512));',
-    '    writeRepoContextMetrics(span, collectRepoContext(process.cwd(), "process"));',
-    "    span.end();",
-    "    messageTextById.delete(messageId);",
-    "    messageInputById.delete(messageId);",
-    "    skillUsagesByMessageId.delete(messageId);",
-    "    skillUsagesBySessionId.delete(sessionId);",
-    "    toolCallIdsByMessageId.delete(messageId);",
-    "    toolCallIdsBySessionId.delete(sessionId);",
-    "    toolResultIdsByMessageId.delete(messageId);",
-    "    toolResultIdsBySessionId.delete(sessionId);",
-    "  };",
-    "",
-    "  return {",
-    "    config: async (config) => {",
-    "      if (!config.experimental?.openTelemetry) {",
-    '        log("warn", "OpenTelemetry experimental feature is disabled in Opencode config - tracing disabled");',
-    "      }",
-    "    },",
-    "    event: async ({ event }) => {",
-    "      const eventType = pickEventString(event?.name, event?.type, eventPayload(event)?.name, eventPayload(event)?.type);",
-    "      await recordInteractionMetric(event);",
-    '      if (eventType === "session.idle" || eventType === "message.updated" || eventType === "message.part.updated" || eventType === "session.updated" || eventType === "session.idle.1" || eventType === "message.updated.1" || eventType === "message.part.updated.1" || eventType === "session.updated.1") {',
-    "        await flush(eventType);",
-    "      }",
-    '      if (eventType === "server.instance.disposed") {',
-    "        await shutdown('server.instance.disposed');",
-    "      }",
-    "    },",
-    "  };",
-    "};",
-    ""
-  ].join(os.EOL);
-}
-
-function patchDistIndexJs(distIndexPath) {
-  const code = getPatchedLangfuseDistIndexJs();
-  ensureDir(path.dirname(distIndexPath));
-  fs.writeFileSync(distIndexPath, code + os.EOL, "utf8");
-}
-
-function syncPluginPackageToLocalPlugins({ pkgDir, pluginDest, pluginsDir }) {
-  ensureDir(pluginsDir);
-  if (fs.existsSync(pluginDest)) {
-    fs.rmSync(pluginDest, { recursive: true, force: true });
-  }
-  fs.cpSync(pkgDir, pluginDest, { recursive: true });
-}
-
-function writeWindowsLauncherCmd(opencodeDir, { publicKey, secretKey, baseUrl, userId }) {
-  if (process.platform !== "win32") return null;
-  const p = path.join(opencodeDir, "launch-opencode-langfuse.cmd");
-  writeWindowsUpdateCheckScript(opencodeDir);
-  const cmd = ["@echo off", "REM Auto-generated by scripts/opencode-langfuse-setup.mjs"];
-  cmd.push(`set LANGFUSE_PUBLIC_KEY=${publicKey}`);
-  cmd.push(`set LANGFUSE_SECRET_KEY=${secretKey}`);
-  cmd.push(`set LANGFUSE_BASEURL=${baseUrl}`);
-  if (userId) cmd.push(`set LANGFUSE_USER_ID=${userId}`);
-  cmd.push('powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0oh-langfuse-opencode-update-check.ps1"');
-  cmd.push('if exist "%USERPROFILE%\\.opencode\\bin\\opencode.exe" (');
-  cmd.push('  "%USERPROFILE%\\.opencode\\bin\\opencode.exe" %*');
-  cmd.push("  exit /b");
-  cmd.push(")");
-  cmd.push("opencode %*");
-  fs.writeFileSync(p, cmd.join("\r\n") + "\r\n", "utf8");
-  return p;
-}
-
-function shQuote(s) {
-  return `'${String(s).replace(/'/g, "'\"'\"'")}'`;
-}
-
-function autoUpdateRuntimePath() {
-  return path.join(rootDir, "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", "--registry=https://registry.npmjs.org/", "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/opencode-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/opencode-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 windowsGitPathBootstrap() {
-  return [
-    "for /f \"delims=\" %%G in ('where.exe git.exe 2^>nul') do (",
-    "  set \"OH_LANGFUSE_GIT_EXE=%%G\"",
-    "  set \"npm_config_git=%%G\"",
-    "  set \"PATH=%%~dpG;%PATH%\"",
-    "  goto :oh_langfuse_git_ready",
-    ")",
-    ":oh_langfuse_git_ready"
-  ];
-}
-
+
+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 = {};
+  for (const raw of argv) {
+    if (!raw.startsWith("--")) continue;
+    const eq = raw.indexOf("=");
+    if (eq === -1) {
+      args[raw.slice(2)] = true;
+    } else {
+      args[raw.slice(2, eq)] = raw.slice(eq + 1);
+    }
+  }
+  return args;
+}
+
+function ensureDir(p) {
+  fs.mkdirSync(p, { recursive: true });
+}
+
+function readJsonIfExists(p) {
+  if (!fs.existsSync(p)) return null;
+  const txt = stripBom(fs.readFileSync(p, "utf8"));
+  if (!txt.trim()) return null;
+  return parseJsonRelaxed(txt, p);
+}
+
+function writeJsonPretty(p, obj) {
+  fs.writeFileSync(p, JSON.stringify(obj, null, 2) + os.EOL, "utf8");
+}
+
+const colorEnabled = process.stdout.isTTY && process.env.NO_COLOR !== "1";
+const ansi = (code) => (colorEnabled ? `\x1b[${code}m` : "");
+const colors = {
+  reset: ansi(0),
+  bold: ansi(1),
+  cyan: ansi(36),
+  green: ansi(32),
+  yellow: ansi(33),
+  dim: ansi(2)
+};
+
+function paint(text, ...styles) {
+  if (!colorEnabled) return String(text);
+  return `${styles.join("")}${text}${colors.reset}`;
+}
+
+function printCommandHint(label, command) {
+  console.log(paint(label, colors.yellow, colors.bold));
+  console.log(`${paint(">", colors.green, colors.bold)} ${paint(command, colors.cyan, colors.bold)}`);
+}
+
+function isObject(x) {
+  return x && typeof x === "object" && !Array.isArray(x);
+}
+
+function deepMerge(target, src) {
+  if (!isObject(target) || !isObject(src)) return src;
+  const out = { ...target };
+  for (const [k, v] of Object.entries(src)) {
+    if (isObject(v) && isObject(out[k])) out[k] = deepMerge(out[k], v);
+    else out[k] = v;
+  }
+  return out;
+}
+
+function mergePluginList(existing, name) {
+  let arr = [];
+  if (Array.isArray(existing)) arr = [...existing];
+  else if (typeof existing === "string" && existing.trim()) arr = [existing];
+  if (!arr.includes(name)) arr.push(name);
+  return arr;
+}
+
+function removePlugins(existing, names) {
+  const removeSet = new Set(names);
+  if (Array.isArray(existing)) return existing.filter((x) => !removeSet.has(x));
+  if (typeof existing === "string") return removeSet.has(existing) ? [] : [existing];
+  return [];
+}
+
+function psQuote(s) {
+  return `'${String(s).replace(/'/g, "''")}'`;
+}
+
+function cmdQuote(s) {
+  return `"${String(s).replace(/"/g, '""')}"`;
+}
+
+function cmdSetValue(s) {
+  return String(s).replace(/"/g, '""');
+}
+
+function writeLangfusePluginUserConfig({ userId }) {
+  const home = os.homedir();
+  const dir = path.join(home, ".config", "opencode-plugin-langfuse");
+  const p = path.join(dir, "config.json");
+  ensureDir(dir);
+  const obj = { usrid: userId, userId };
+  writeJsonPretty(p, obj);
+  return p;
+}
+
+export function getPatchedLangfuseDistIndexJs() {
+  // This replaces opencode-plugin-langfuse/dist/index.js to inject userId into spans.
+  // It is intentionally self-contained (no extra build steps).
+  return [
+    'import { LangfuseSpanProcessor } from "@langfuse/otel";',
+    'import { configureGlobalLogger, LogLevel } from "@langfuse/core";',
+    'import fs, { promises as fsPromise } from "node:fs";',
+    'import os from "node:os";',
+    'import path from "node:path";',
+    'import { execFileSync } from "node:child_process";',
+    'import { NodeSDK } from "@opentelemetry/sdk-node";',
+    'import { trace } from "@opentelemetry/api";',
+    "",
+    "const USER_CONFIG_PATH = path.join(",
+    "  os.homedir(),",
+    '  ".config",',
+    '  "opencode-plugin-langfuse",',
+    '  "config.json"',
+    ");",
+    "",
+    "const readConfiguredUserId = async () => {",
+    "  try {",
+    '    const content = await fsPromise.readFile(USER_CONFIG_PATH, "utf8");',
+    "    // tolerate UTF-8 BOM",
+    "    const txt = content.charCodeAt(0) === 0xfeff ? content.slice(1) : content;",
+    "    const parsed = JSON.parse(txt);",
+    "    const userId =",
+    '      typeof parsed.userId === "string"',
+    "        ? parsed.userId.trim()",
+    '        : typeof parsed.usrid === "string"',
+    "          ? parsed.usrid.trim()",
+    "          : \"\";",
+    "    return userId || undefined;",
+    "  } catch {",
+    "    return undefined;",
+    "  }",
+    "};",
+    "",
+    "const showNoisyLogs = /^(1|true|yes|on)$/i.test(String(process.env.OH_LANGFUSE_SHOW_LOGS || process.env.LANGFUSE_SHOW_LOGS || process.env.OH_LANGFUSE_SHOW_WARN || process.env.LANGFUSE_SHOW_WARN || ''));",
+    "if (!showNoisyLogs) {",
+    "  process.env.LANGFUSE_LOG_LEVEL = 'NONE';",
+    "  configureGlobalLogger({ level: LogLevel.NONE });",
+    "}",
+    "",
+    "const createUserIdSpanProcessor = (userId) => ({",
+    "  onStart: (span) => {",
+    '    span.setAttribute("langfuse.user.id", userId);',
+    '    span.setAttribute("user.id", userId);',
+    '    span.setAttribute("ai.telemetry.metadata.userId", userId);',
+    '    span.setAttribute("oh.langfuse.source", "opencode");',
+    '    span.setAttribute("oh.langfuse.user_id", userId);',
+    '    span.setAttribute("oh.langfuse.metrics_schema_version", "1.1");',
+    '    span.setAttribute("langfuse.trace.metadata.langfuse_user_id", userId);',
+    '    span.setAttribute("langfuse.observation.metadata.langfuse_user_id", userId);',
+    '    span.setAttribute("langfuse.metadata.langfuse_user_id", userId);',
+    '    span.setAttribute("langfuse.observation.metadata.source", "opencode");',
+    '    span.setAttribute("langfuse.observation.metadata.agent", "opencode");',
+    '    span.setAttribute("langfuse.observation.metadata.user_id", userId);',
+    '    span.setAttribute("langfuse.observation.metadata.metrics_schema_version", "1.1");',
+    "  },",
+    "  onEnd: (span) => {",
+    '    if (typeof span.setAttribute !== "function") return;',
+    '    span.setAttribute("langfuse.user.id", userId);',
+    '    span.setAttribute("user.id", userId);',
+    '    span.setAttribute("ai.telemetry.metadata.userId", userId);',
+    '    span.setAttribute("oh.langfuse.source", "opencode");',
+    '    span.setAttribute("oh.langfuse.user_id", userId);',
+    '    span.setAttribute("oh.langfuse.metrics_schema_version", "1.1");',
+    '    span.setAttribute("langfuse.trace.metadata.langfuse_user_id", userId);',
+    '    span.setAttribute("langfuse.observation.metadata.langfuse_user_id", userId);',
+    '    span.setAttribute("langfuse.metadata.langfuse_user_id", userId);',
+    '    span.setAttribute("langfuse.observation.metadata.source", "opencode");',
+    '    span.setAttribute("langfuse.observation.metadata.agent", "opencode");',
+    '    span.setAttribute("langfuse.observation.metadata.user_id", userId);',
+    '    span.setAttribute("langfuse.observation.metadata.metrics_schema_version", "1.1");',
+    "  },",
+    "  forceFlush: async () => {},",
+    "  shutdown: async () => {},",
+    "});",
+    "",
+    "const metricNumber = (value) => {",
+    '  if (typeof value === "number") return Number.isFinite(value) && value >= 0 ? value : undefined;',
+    '  if (typeof value === "string" && value.trim().startsWith("{")) {',
+    "    try {",
+    "      const parsed = JSON.parse(value);",
+    "      return metricNumber(parsed.intValue ?? parsed.doubleValue ?? parsed.value);",
+    "    } catch {",
+    "      return undefined;",
+    "    }",
+    "  }",
+    "  const n = Number(value);",
+    "  return Number.isFinite(n) && n >= 0 ? n : undefined;",
+    "};",
+    "",
+    "const writeSpanAttribute = (span, key, value) => {",
+    "  if (value === undefined || value === null) return;",
+    '  if (typeof span.setAttribute === "function") {',
+    "    span.setAttribute(key, value);",
+    "    return;",
+    "  }",
+    '  if (span.attributes && typeof span.attributes === "object") {',
+    "    span.attributes[key] = value;",
+    "  }",
+    "};",
+    "",
+    "const writeMetric = (span, key, value) => writeSpanAttribute(span, `langfuse.observation.metadata.${key}`, value);",
+    "",
+    "const emptyRepoContext = (cwd = '', cwdSource = 'unavailable', available = false, error = '', isGitRepo = false) => ({",
+    "  cwd: String(cwd || ''),",
+    "  cwd_source: cwdSource || 'unavailable',",
+    "  git_context_available: Boolean(available),",
+    "  git_context_error: error || '',",
+    "  is_git_repo: Boolean(isGitRepo),",
+    "  git_root: '',",
+    "  git_remote: '',",
+    "  git_remote_host: '',",
+    "  git_repo_owner: '',",
+    "  git_repo_name: '',",
+    "  git_repo_slug: '',",
+    "  git_branch: '',",
+    "  git_commit: '',",
+    "});",
+    "",
+    "const sanitizeGitRemote = (remote) => {",
+    "  const empty = { git_remote: '', git_remote_host: '', git_repo_owner: '', git_repo_name: '', git_repo_slug: '' };",
+    "  const raw = String(remote || '').trim();",
+    "  if (!raw) return empty;",
+    "  try {",
+    "    let host = '';",
+    "    let parts = [];",
+    "    if (raw.includes('://')) {",
+    "      const parsed = new URL(raw);",
+    "      host = parsed.hostname;",
+    "      parts = parsed.pathname.replace(/^\\/+|\\/+$/g, '').split('/').filter(Boolean);",
+    "    } else {",
+    "      const scp = raw.match(/^[^@]+@([^:]+):(.+)$/);",
+    "      if (scp) {",
+    "        host = scp[1];",
+    "        parts = scp[2].replace(/^\\/+|\\/+$/g, '').split('/').filter(Boolean);",
+    "      } else {",
+    "        const parsed = new URL(`ssh://${raw}`);",
+    "        host = parsed.hostname;",
+    "        parts = parsed.pathname.replace(/^\\/+|\\/+$/g, '').split('/').filter(Boolean);",
+    "      }",
+    "    }",
+    "    if (!host || parts.length < 2) return empty;",
+    "    const owner = parts[parts.length - 2];",
+    "    const repo = parts[parts.length - 1].replace(/\\.git$/i, '');",
+    "    if (!owner || !repo) return empty;",
+    "    const slug = `${owner}/${repo}`;",
+    "    return { git_remote: `${host}/${slug}`, git_remote_host: host, git_repo_owner: owner, git_repo_name: repo, git_repo_slug: slug };",
+    "  } catch {",
+    "    return empty;",
+    "  }",
+    "};",
+    "",
+    "const runGit = (cwd, args) => {",
+    "  try {",
+    "    const stdout = execFileSync('git', ['-C', cwd, ...args], { encoding: 'utf8', timeout: 500, stdio: ['ignore', 'pipe', 'ignore'] });",
+    "    return { ok: true, stdout: String(stdout || '').trim(), error: '' };",
+    "  } catch (error) {",
+    "    if (error && error.code === 'ETIMEDOUT') return { ok: false, stdout: '', error: 'timeout' };",
+    "    if (error && error.code === 'ENOENT') return { ok: false, stdout: '', error: 'git_unavailable' };",
+    "    return { ok: false, stdout: '', error: 'git_error' };",
+    "  }",
+    "};",
+    "",
+    "const repoContextCache = new Map();",
+    'const DISK_CACHE_TTL = 1000 * 60 * 15; // 15 minutes — covers typical conversations',
+    'const cwdToCacheKey = (cwd) => {',
+    "  const text = String(cwd || '').trim();",
+    "  if (!text) return '';",
+    "  return Buffer.from(text, 'utf8').toString('base64url').replace(/[^A-Za-z0-9_-]/g, '_');",
+    '};',
+    '',
+    'const getDiskCachePath = (cwd) => {',
+    '  const key = cwdToCacheKey(cwd);',
+    "  if (!key) return '';",
+    "  const dir = path.join(os.homedir(), '.opencode', 'langfuse-cache');",
+    "  return path.join(dir, `git-context-${key}.json`);",
+    '};',
+    '',
+    'const readDiskCache = (cachePath) => {',
+    '  try {',
+    "    if (!fs.existsSync(cachePath)) return null;",
+    "    const raw = fs.readFileSync(cachePath, 'utf8');",
+    '    const parsed = JSON.parse(raw);',
+    '    if (parsed && typeof parsed === \'object\' && parsed.time && parsed.context) return parsed;',
+    '  } catch {}',
+    '  return null;',
+    '};',
+    '',
+    'const writeDiskCache = (cachePath, payload) => {',
+    '  try {',
+    '    if (!cachePath) return;',
+    '    const dir = path.dirname(cachePath);',
+    "    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });",
+    '    fs.writeFileSync(cachePath, JSON.stringify(payload));',
+    '  } catch {}',
+    '};',
+    '',
+    'const isCacheValid = (parsed) => parsed && typeof parsed === \'object\' && parsed.time && parsed.context && Date.now() - parsed.time <= DISK_CACHE_TTL;',
+    '',
+    'const collectRepoContext = (cwd, cwdSource = "process") => {',
+    "  const cwdText = String(cwd || '').trim();",
+    "  if (!cwdText) return emptyRepoContext('', 'unavailable', false, 'missing_cwd');",
+    '  const now = Date.now();',
+    '  const memCached = repoContextCache.get(cwdText);',
+    '  if (memCached && now - memCached.time <= 30000) return { ...memCached.context, cwd_source: cwdSource || memCached.context.cwd_source };',
+    '  const cachePath = getDiskCachePath(cwdText);',
+    '  let staleFallback = null;',
+    '  const diskCached = cachePath ? readDiskCache(cachePath) : null;',
+    '  if (diskCached && diskCached.context && diskCached.cwd === cwdText) {',
+    '    if (isCacheValid(diskCached)) {',
+    '      repoContextCache.set(cwdText, diskCached);',
+    '      return { ...diskCached.context, cwd_source: cwdSource || diskCached.context.cwd_source };',
+    '    }',
+    '    staleFallback = diskCached;',
+    '  }',
+    "  let context = emptyRepoContext(cwdText, cwdSource, false, '', false);",
+    "  const inside = runGit(cwdText, ['rev-parse', '--is-inside-work-tree']);",
+    '  if (!inside.ok) {',
+    "    const reason = ['timeout', 'git_unavailable'].includes(inside.error) ? inside.error : '';",
+    "    context = reason ? emptyRepoContext(cwdText, cwdSource, false, reason, false) : emptyRepoContext(cwdText, cwdSource, true, '', false);",
+    '    repoContextCache.set(cwdText, { time: now, context });',
+    '    if (staleFallback && staleFallback.context) return { ...staleFallback.context, cwd_source: cwdSource || staleFallback.context.cwd_source };',
+    '    return context;',
+    '  }',
+    "  if (inside.stdout.toLowerCase() !== 'true') {",
+    "    context = emptyRepoContext(cwdText, cwdSource, true, '', false);",
+    '    repoContextCache.set(cwdText, { time: now, context });',
+    '    return context;',
+    '  }',
+    "  context = emptyRepoContext(cwdText, cwdSource, true, '', true);",
+    "  const root = runGit(cwdText, ['rev-parse', '--show-toplevel']);",
+    "  if (!root.ok && ['timeout', 'git_unavailable'].includes(root.error)) {\n    context.git_context_available = false;\n    context.git_context_error = root.error;\n    repoContextCache.set(cwdText, { time: now, context });",
+    '    if (staleFallback && staleFallback.context) return { ...staleFallback.context, cwd_source: cwdSource || staleFallback.context.cwd_source };',
+    '    return context;',
+    '  }',
+"  context.git_root = root.stdout || '';",
+  "  let sanitized = { git_remote: '', git_remote_host: '', git_repo_owner: '', git_repo_name: '', git_repo_slug: '' };",
+  "  let remoteError = '';",
+  "  for (const name of ['origin', 'gitcode', 'upstream']) {",
+  "    const r = runGit(cwdText, ['config', '--get', `remote.${name}.url`]);",
+  "    if (r.ok && r.stdout) {",
+  "      sanitized = sanitizeGitRemote(r.stdout);",
+  "      if (sanitized.git_remote) break;",
+  "      sanitized = { git_remote: '', git_remote_host: '', git_repo_owner: '', git_repo_name: '', git_repo_slug: '' };",
+  "    } else if (['timeout', 'git_unavailable'].includes(r.error)) {",
+  "      remoteError = r.error;",
+  "    }",
+  "  }",
+  "  if (!sanitized.git_remote) {",
+  "    const list = runGit(cwdText, ['remote']);",
+  "    if (list.ok && list.stdout) {",
+  "      const first = (list.stdout.split(/\\r?\\n/).find(l => l.trim()) || '').trim();",
+  "      if (first) {",
+  "        const r = runGit(cwdText, ['config', '--get', `remote.${first}.url`]);",
+  "        if (r.ok && r.stdout) sanitized = sanitizeGitRemote(r.stdout);",
+  "      }",
+  "    }",
+  "  }",
+  "  if (sanitized.git_remote) {",
+  "    context = { ...context, ...sanitized };",
+  "  } else if (['timeout', 'git_unavailable'].includes(remoteError)) {",
+  "    context.git_context_available = false;",
+  "    context.git_context_error = remoteError;",
+  "  }",
+    "  const branch = runGit(cwdText, ['branch', '--show-current']);",
+    "  if (branch.ok) context.git_branch = branch.stdout || '';",
+    "  const commit = runGit(cwdText, ['rev-parse', '--short', 'HEAD']);",
+    "  if (commit.ok) context.git_commit = commit.stdout || '';",
+    '  const payload = { time: now, cwd: cwdText, context };',
+    '  repoContextCache.set(cwdText, payload);',
+    '  if (cachePath) writeDiskCache(cachePath, payload);',
+    '  return context;',
+    '};',
+    '',
+    "const writeRepoContextMetrics = (span, context) => {",
+    "  const repoContext = context || {};",
+    "  writeSpanAttribute(span, 'langfuse.observation.metadata.cwd', repoContext.cwd);",
+    "  writeSpanAttribute(span, 'langfuse.observation.metadata.cwd_source', repoContext.cwd_source);",
+    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_context_available', repoContext.git_context_available);",
+    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_context_error', repoContext.git_context_error);",
+    "  writeSpanAttribute(span, 'langfuse.observation.metadata.is_git_repo', repoContext.is_git_repo);",
+    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_root', repoContext.git_root);",
+    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_remote', repoContext.git_remote);",
+    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_remote_host', repoContext.git_remote_host);",
+    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_repo_owner', repoContext.git_repo_owner);",
+    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_repo_name', repoContext.git_repo_name);",
+    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_repo_slug', repoContext.git_repo_slug);",
+    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_branch', repoContext.git_branch);",
+    "  writeSpanAttribute(span, 'langfuse.observation.metadata.git_commit', repoContext.git_commit);",
+    "};",
+    "",
+    "const writeOpencodeMetricAttributes = (span, userId) => {",
+    "  const attrs = span.attributes ?? {};",
+    '  writeSpanAttribute(span, "oh.langfuse.source", "opencode");',
+    '  writeSpanAttribute(span, "oh.langfuse.metrics_schema_version", "1.1");',
+    '  if (userId) writeSpanAttribute(span, "oh.langfuse.user_id", userId);',
+    '  writeMetric(span, "source", "opencode");',
+    '  writeMetric(span, "agent", "opencode");',
+    '  writeMetric(span, "metrics_schema_version", "1.1");',
+    '  if (userId) writeMetric(span, "user_id", userId);',
+    '  const hasModel = attrs["ai.model.id"] || attrs["ai.model.provider"] || attrs["gen_ai.request.model"];',
+    '  const isTool = attrs["ai.toolCall.name"] || attrs["ai.toolCall.id"];',
+    "  if (!hasModel || isTool) return false;",
+    '  const provider = attrs["ai.model.provider"] || attrs["gen_ai.system"] || "";',
+    '  const modelId = attrs["ai.model.id"] || attrs["gen_ai.request.model"] || attrs["ai.response.model"] || "";',
+    '  const model = provider && modelId ? `${provider}/${modelId}` : provider || modelId || undefined;',
+    '  writeMetric(span, "model", model);',
+    "  return true;",
+    "};",
+    "",
+    "const createMetricsSpanProcessor = (userId) => ({",
+    "  onStart: (span) => {",
+    "    writeOpencodeMetricAttributes(span, userId);",
+    "  },",
+    "  onEnd: (span) => {",
+    "    writeOpencodeMetricAttributes(span, userId);",
+    "  },",
+    "  forceFlush: async () => {},",
+    "  shutdown: async () => {},",
+    "});",
+    "",
+    "const eventPayload = (event) => event?.properties ?? event?.data ?? event?.payload ?? event?.body ?? event ?? {};",
+    "const eventPart = (event) => {",
+    "  const payload = eventPayload(event);",
+    "  return payload.part ?? payload.properties?.part ?? payload.data?.part ?? payload.payload?.part ?? event?.part ?? event?.data?.part ?? event?.payload?.part ?? payload;",
+    "};",
+    "const pickEventString = (...values) => {",
+    "  for (const value of values) {",
+    '    if (typeof value === "string" && value.trim()) return value.trim();',
+    "  }",
+    '  return "";',
+    "};",
+    "const countOpencodeToolActivity = (event) => {",
+    "  const payload = eventPayload(event);",
+    "  const part = eventPart(event);",
+    "  const eventType = pickEventString(event?.name, event?.type, payload?.name, payload?.type);",
+    "  const partType = pickEventString(part?.type);",
+    "  const toolName = pickEventString(part?.tool, part?.toolName, part?.name, payload?.tool, payload?.toolName, payload?.name);",
+    "  const callId = pickEventString(part?.callID, part?.callId, payload?.callID, payload?.callId, part?.id);",
+    "  const status = pickEventString(part?.state?.status, part?.status, payload?.state?.status, payload?.status).toLowerCase();",
+    "  const hasToolInput = part?.state?.input !== undefined || part?.input !== undefined || payload?.input !== undefined;",
+    "  const hasToolOutput = part?.state?.output !== undefined || part?.output !== undefined || payload?.output !== undefined;",
+    "  const isToolCall = eventType === 'tool_use' || eventType === 'tool_result' || partType === 'tool' || partType === 'tool_use' || Boolean(toolName) || hasToolInput;",
+    "  const isToolResult = eventType === 'tool_result' || status === 'completed' || status === 'success' || hasToolOutput;",
+    "  return {",
+    "    toolCallCount: isToolCall ? 1 : 0,",
+    "    toolResultCount: isToolCall && isToolResult ? 1 : 0,",
+    "    toolCallId: callId || '',",
+    "  };",
+    "};",
+    "const tokenMetricsFromPart = (part) => {",
+    "  const tokens = part?.tokens ?? part?.usage ?? {};",
+    "  return {",
+    "    input: metricNumber(tokens.input ?? tokens.input_tokens ?? tokens.inputTokens),",
+    "    output: metricNumber(tokens.output ?? tokens.output_tokens ?? tokens.outputTokens),",
+    "    total: metricNumber(tokens.total ?? tokens.total_tokens ?? tokens.totalTokens),",
+    "    cacheRead: metricNumber(tokens.cache?.read ?? tokens.cacheRead ?? tokens.cache_read_tokens ?? tokens.cachedInputTokens),",
+    "    reasoning: metricNumber(tokens.reasoning ?? tokens.reasoning_tokens ?? tokens.reasoningTokens),",
+    "  };",
+    "};",
+    "const OBSERVATION_TEXT_LIMIT = 20000;",
+    "const limitObservationText = (text) => {",
+    "  const normalized = typeof text === 'string' ? text.trim() : '';",
+    "  if (!normalized) return '';",
+    "  return normalized.length > OBSERVATION_TEXT_LIMIT ? `${normalized.slice(0, OBSERVATION_TEXT_LIMIT)}\\n...[truncated]` : normalized;",
+    "};",
+    "const textFromContent = (value, depth = 0) => {",
+    "  if (depth > 6 || value === null || value === undefined) return '';",
+    "  if (typeof value === 'string') return value.trim();",
+    "  if (Array.isArray(value)) return value.map((item) => textFromContent(item, depth + 1)).filter(Boolean).join('\\n').trim();",
+    "  if (typeof value !== 'object') return '';",
+    "  for (const key of ['text', 'content', 'prompt', 'message', 'input', 'output', 'parts']) {",
+    "    const text = textFromContent(value[key], depth + 1);",
+    "    if (text) return text;",
+    "  }",
+    "  return '';",
+    "};",
+    "const promptFromArgv = () => {",
+    "  const args = process.argv.slice(2);",
+    "  if (!args.includes('run')) return '';",
+    "  for (let i = args.length - 1; i >= 0; i -= 1) {",
+    "    const arg = args[i];",
+    "    if (typeof arg === 'string' && arg.trim() && !arg.startsWith('-')) return arg.trim();",
+    "  }",
+    "  return '';",
+    "};",
+    "",
+    "const normalizeSkillNames = (names) => {",
+    "  if (!Array.isArray(names)) return [];",
+    "  const out = [];",
+    "  const seen = new Set();",
+    "  for (const raw of names) {",
+    "    const name = String(raw || '').trim();",
+    "    if (!name || seen.has(name)) continue;",
+    "    seen.add(name);",
+    "    out.push(name);",
+    "  }",
+    "  return out;",
+    "};",
+    "const skillNamespace = (name) => String(name || '').includes(':') ? String(name).split(':', 1)[0] : '';",
+    "const skillAgentPath = (detectedBy) => {",
+    "  if (detectedBy === 'tool_call') return 'opencode_skill_tool';",
+    "  if (detectedBy === 'slash_command') return 'opencode_slash_prompt';",
+    "  if (detectedBy === 'natural_language_request') return 'opencode_prompt_skill_name';",
+    "  if (detectedBy === 'skill_file_path') return 'skill_file_path';",
+    "  return detectedBy || 'metadata';",
+    "};",
+    "const skillInvocationMode = (detectedBy) => {",
+    "  if (detectedBy === 'slash_command') return 'explicit_request';",
+    "  if (detectedBy === 'natural_language_request') return 'implicit_request';",
+    "  if (detectedBy === 'tool_call' || detectedBy === 'plugin_event') return 'implicit';",
+    "  return 'detected';",
+    "};",
+    "const skillEventType = (detectedBy) => (detectedBy === 'slash_command' || detectedBy === 'natural_language_request') ? 'requested' : (detectedBy === 'tool_call' || detectedBy === 'plugin_event' ? 'invoked' : 'detected');",
+    "const skillIdSegment = (name) => String(name || 'unknown').trim().replace(/[^A-Za-z0-9_.:-]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 96) || 'unknown';",
+    "",
+    "const escapeRegExp = (value) => String(value).replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');",
+    "const normalizeExplicitSkillCommand = (value) => {",
+    "  const command = pickEventString(value).replace(/^\\/+/, '').trim();",
+    "  if (!command) return '';",
+    "  return command.split(/\\s+/, 1)[0];",
+    "};",
+    "",
+    "const collectStrings = (value, out = []) => {",
+    "  if (value == null) return out;",
+    "  if (typeof value === 'string') {",
+    "    out.push(value);",
+    "    return out;",
+    "  }",
+    "  if (typeof value === 'number' || typeof value === 'boolean') return out;",
+    "  if (Array.isArray(value)) {",
+    "    for (const item of value) collectStrings(item, out);",
+    "    return out;",
+    "  }",
+    "  if (typeof value === 'object') {",
+    "    for (const [key, item] of Object.entries(value)) {",
+    "      out.push(key);",
+    "      collectStrings(item, out);",
+    "    }",
+    "  }",
+    "  return out;",
+    "};",
+    "",
+    "const collectExplicitSkillUsages = (value, out = []) => {",
+    "  if (value == null) return out;",
+    "  if (Array.isArray(value)) {",
+    "    for (const item of value) collectExplicitSkillUsages(item, out);",
+    "    return out;",
+    "  }",
+    "  if (typeof value !== 'object') return out;",
+    "  const command = normalizeExplicitSkillCommand(value.command ?? value.commandName ?? value.promptCommand ?? value.properties?.command ?? value.properties?.commandName);",
+    "  if (command) {",
+    "    const callId = pickEventString(value.commandID, value.commandId, value.id);",
+    "    out.push({ name: command, skill_namespace: skillNamespace(command), detected_by: 'slash_command', skill_call_id: callId });",
+    "  }",
+    "  const toolName = pickEventString(value.tool, value.toolName, value.name).toLowerCase();",
+    "  const input = value.input ?? value.state?.input ?? value.properties?.input;",
+    "  if (toolName === 'skill' && input && typeof input === 'object' && !Array.isArray(input)) {",
+    "    const skill = pickEventString(input.skill_name, input.skill, input.name);",
+    "    const callId = pickEventString(value.callID, value.callId, value.id, value.toolCallID, value.toolCallId);",
+    "    if (skill) out.push({ name: skill, skill_namespace: skillNamespace(skill), detected_by: 'tool_call', skill_call_id: callId });",
+    "  }",
+    "  for (const item of Object.values(value)) collectExplicitSkillUsages(item, out);",
+    "  return out;",
+    "};",
+    "",
+    "const detectPromptSkillRequests = (haystack, skills) => {",
+    "  const text = String(haystack || '');",
+    "  if (!text.trim()) return [];",
+    "  const out = [];",
+    "  for (const skillName of skills) {",
+    "    const escaped = escapeRegExp(skillName);",
+    "    const pattern = new RegExp(`(?:请\\\\s*)?(?:使用|调用|启用|采用)\\\\s*[\\\"'“”‘’]?${escaped}(?=$|[\\\\s,，。；;:：、])|\\\\b(?:use|invoke|run|apply)\\\\s+[\\\"']?${escaped}(?=$|[\\\\s,，。；;:：])`, 'i');",
+    "    if (pattern.test(text)) out.push({ name: skillName, skill_namespace: skillNamespace(skillName), detected_by: 'natural_language_request', skill_call_id: '' });",
+    "  }",
+    "  return out;",
+    "};",
+    "",
+    "const detectOpencodeSkillUsages = (source, knownSkills = []) => {",
+    "  const skills = normalizeSkillNames(knownSkills);",
+    "  if (skills.length === 0) return [];",
+    "  const found = [];",
+    "  const explicitSeen = new Set();",
+    "  const explicit = [];",
+    "  for (const usage of collectExplicitSkillUsages(source).filter((item) => skills.includes(item.name))) {",
+    "    if (usage.skill_call_id) {",
+    "      const key = `call:${usage.skill_call_id}`;",
+    "      if (explicitSeen.has(key)) continue;",
+    "      explicitSeen.add(key);",
+    "    } else if (usage.detected_by === 'slash_command') {",
+    "      const key = `command:${usage.name}`;",
+    "      if (explicitSeen.has(key)) continue;",
+    "      explicitSeen.add(key);",
+    "    }",
+    "    explicit.push(usage);",
+    "  }",
+    "  found.push(...explicit);",
+    "  const haystack = collectStrings(source).join('\\n');",
+    "  const promptSeen = new Set(explicit.map((usage) => usage.name));",
+    "  for (const usage of detectPromptSkillRequests(haystack, skills)) {",
+    "    if (promptSeen.has(usage.name)) continue;",
+    "    promptSeen.add(usage.name);",
+    "    found.push(usage);",
+    "  }",
+    "  const pathSeen = new Set();",
+    "  for (const match of haystack.matchAll(/(?:^|[\"'\\s])(?:[A-Za-z]:)?[^\"'\\n\\r]*[\\\\/]+([^\\\\/\"'\\n\\r]+)[\\\\/]+SKILL\\.md(?=$|[\"'\\s])/gi)) {",
+    "    const skillName = match[1];",
+    "    if (!skills.includes(skillName) || explicit.some((usage) => usage.name === skillName) || pathSeen.has(skillName)) continue;",
+    "    pathSeen.add(skillName);",
+    "    found.push({ name: skillName, skill_namespace: skillNamespace(skillName), detected_by: 'skill_file_path', skill_call_id: '' });",
+    "  }",
+    "  return found;",
+    "};",
+    "const uniqueSkillNames = (usages) => normalizeSkillNames((usages || []).map((usage) => usage.name));",
+    "const dedupeSkillUsages = (usages) => {",
+    "  const out = [];",
+    "  const seen = new Set();",
+    "  for (const usage of usages || []) {",
+    "    const key = usage.skill_call_id ? `call:${usage.skill_call_id}` : `${usage.name}:${usage.detected_by}`;",
+    "    if (seen.has(key)) continue;",
+    "    seen.add(key);",
+    "    out.push(usage);",
+    "  }",
+    "  return out;",
+    "};",
+    "const buildSkillUseEvents = (interactionId, skillUsages) => {",
+    "  const usages = dedupeSkillUsages(skillUsages);",
+    "  const total = usages.length;",
+    "  return usages.map((usage, index) => {",
+    "    const skillName = String(usage.name || '').trim();",
+    "    const detectedBy = String(usage.detected_by || 'metadata');",
+    "    const invocationMode = skillInvocationMode(detectedBy);",
+    "    return {",
+    "      skill_use_id: `${interactionId}:skill:${index + 1}:${skillIdSegment(skillName)}`,",
+    "      skill_use_index: index + 1,",
+    "      skill_use_count_in_interaction: total,",
+    "      skill_event_type: skillEventType(detectedBy),",
+    "      skill_trigger: invocationMode,",
+    "      skill_invocation_mode: invocationMode,",
+    "      skill_agent_path: skillAgentPath(detectedBy),",
+    "      skill_name: skillName,",
+    "      skill_use_count: 1,",
+    "      skill_namespace: usage.skill_namespace || skillNamespace(skillName),",
+    "      detected_by: detectedBy,",
+    "      ...(usage.skill_call_id ? { skill_call_id: usage.skill_call_id } : {}),",
+    "    };",
+    "  }).filter((event) => event.skill_name);",
+    "};",
+    "",
+    "const collectKnownSkillNames = async () => {",
+    "  const dirs = [",
+    "    path.join(process.cwd(), '.opencode', 'skill'),",
+    "    path.join(process.cwd(), '.opencode', 'skills'),",
+    "    path.join(os.homedir(), '.config', 'opencode', 'skill'),",
+    "    path.join(os.homedir(), '.config', 'opencode', 'skills'),",
+    "    path.join(os.homedir(), '.opencode', 'skill'),",
+    "    path.join(os.homedir(), '.opencode', 'skills'),",
+    "  ];",
+    "  const names = new Set();",
+    "  for (const dir of dirs) {",
+    "    try {",
+    "      const entries = await fsPromise.readdir(dir, { withFileTypes: true });",
+    "      for (const entry of entries) {",
+    "        if (!entry.isDirectory() || entry.name.startsWith('.')) continue;",
+    "        try {",
+    "          await fsPromise.access(path.join(dir, entry.name, 'SKILL.md'));",
+    "          names.add(entry.name);",
+    "        } catch {",
+    "          // Ignore helper folders that are not OpenCode skills.",
+    "        }",
+    "      }",
+    "    } catch {",
+    "      // Optional skill directories are allowed to be absent.",
+    "    }",
+    "  }",
+    "  return [...names];",
+    "};",
+    "",
+    "export const LangfusePlugin = async ({ client }) => {",
+    "  const publicKey = process.env.LANGFUSE_PUBLIC_KEY;",
+    "  const secretKey = process.env.LANGFUSE_SECRET_KEY;",
+    '  const baseUrl = process.env.LANGFUSE_BASEURL ?? "https://metrics.openharmonyinsight.cn";',
+    '  const environment = process.env.LANGFUSE_ENVIRONMENT ?? "development";',
+    "",
+    "  const userIdFromConfig = await readConfiguredUserId();",
+    "  const userIdEnv = process.env.LANGFUSE_USER_ID?.trim();",
+    "  const userId = userIdEnv || userIdFromConfig;",
+    "",
+    "  const log = (level, message) => {",
+    "    if ((level === 'warn' || level === 'error') && !showNoisyLogs) return;",
+    '    client.app.log({ body: { service: "langfuse-otel", level, message } });',
+    "  };",
+    "",
+    "  if (!publicKey || !secretKey) {",
+    '    log("warn", "Missing LANGFUSE_PUBLIC_KEY or LANGFUSE_SECRET_KEY - tracing disabled");',
+    "    return {};",
+    "  }",
+    "",
+    "  const processor = new LangfuseSpanProcessor({ publicKey, secretKey, baseUrl, environment });",
+    "  const spanProcessors = [processor, createMetricsSpanProcessor(userId)];",
+    "  if (userId) spanProcessors.push(createUserIdSpanProcessor(userId));",
+    "",
+    "  const sdk = new NodeSDK({ spanProcessors });",
+    "  const sdkStartPromise = Promise.resolve().then(() => sdk.start()).catch((err) => {",
+    '    log("warn", `OTEL SDK start failed: ${err?.message ?? err}`);',
+    "  });",
+    "  const getMetricsTracer = () => trace.getTracer('oh-langfuse-opencode-metrics');",
+    "  const knownSkillNames = await collectKnownSkillNames();",
+    "  const startupSkillUsages = detectOpencodeSkillUsages(process.argv.join('\\n'), knownSkillNames);",
+    "  const startupPromptText = limitObservationText(promptFromArgv());",
+    "  const messageTextById = new Map();",
+    "  const messageInputById = new Map();",
+    "  const lastUserTextBySessionId = new Map();",
+    "  const skillUsagesByMessageId = new Map();",
+    "  const skillUsagesBySessionId = new Map();",
+    "  const startupSkillSessionIds = new Set();",
+    "  const toolCallIdsByMessageId = new Map();",
+    "  const toolCallIdsBySessionId = new Map();",
+    "  const toolResultIdsByMessageId = new Map();",
+    "  const toolResultIdsBySessionId = new Map();",
+    "  const emittedMessageIds = new Set();",
+    "",
+    '  log("info", `OTEL tracing initialized -> ${baseUrl}`);',
+    '  if (userId) log("info", `LANGFUSE userId configured -> ${userId}`);',
+    '  if (knownSkillNames.length) log("info", `OpenCode skills discovered -> ${knownSkillNames.length}`);',
+    "",
+    "  let shutdownStarted = false;",
+    "  const flush = async (reason) => {",
+    "    try {",
+    '      log("info", `Flushing OTEL spans on ${reason}`);',
+    "      await sdkStartPromise;",
+    "      await processor.forceFlush();",
+    "    } catch (error) {",
+    '      log("warn", `OTEL forceFlush failed on ${reason}: ${error?.message ?? error}`);',
+    "    }",
+    "  };",
+    "  const shutdown = async (reason) => {",
+    "    if (shutdownStarted) return;",
+    "    shutdownStarted = true;",
+    "    try {",
+    '      log("info", `Shutting down OTEL SDK on ${reason}`);',
+    "      await sdkStartPromise;",
+    "      await sdk.shutdown();",
+    "    } catch (error) {",
+    '      log("warn", `OTEL shutdown failed on ${reason}: ${error?.message ?? error}`);',
+    "    }",
+    "  };",
+    "  process.once('beforeExit', async () => {",
+    "    await flush('process.beforeExit');",
+    "    await shutdown('process.beforeExit');",
+    "  });",
+    "  const originalExit = process.exit.bind(process);",
+    "  process.exit = ((code) => {",
+    "    void shutdown('process.exit').finally(() => originalExit(code));",
+    "  });",
+    "",
+    "  const rememberSkillUsages = (map, key, usages) => {",
+    "    if (!key || !usages.length) return;",
+    "    let list = map.get(key);",
+    "    if (!list) {",
+    "      list = [];",
+    "      map.set(key, list);",
+    "    }",
+    "    const seen = new Set(list.map((usage) => usage.skill_call_id ? `call:${usage.skill_call_id}` : `${usage.name}:${usage.detected_by}`));",
+    "    for (const usage of usages) {",
+    "      const key = usage.skill_call_id ? `call:${usage.skill_call_id}` : `${usage.name}:${usage.detected_by}`;",
+    "      if (seen.has(key)) continue;",
+    "      seen.add(key);",
+    "      list.push(usage);",
+    "    }",
+    "  };",
+    "  const rememberToolActivity = (map, key, activity, kind) => {",
+    "    if (!key || !activity?.[kind]) return;",
+    "    let set = map.get(key);",
+    "    if (!set) {",
+    "      set = new Set();",
+    "      map.set(key, set);",
+    "    }",
+    "    set.add(activity.toolCallId || `${kind}:${set.size + 1}`);",
+    "  };",
+    "  const recordInteractionMetric = async (event) => {",
+    "    const payload = eventPayload(event);",
+    "    const part = eventPart(event);",
+    "    const partType = part?.type ?? '';",
+    "    const sessionId = pickEventString(part?.sessionID, part?.sessionId, payload?.sessionID, payload?.sessionId, payload?.session?.id, event?.sessionID, event?.sessionId);",
+    "    const messageId = pickEventString(part?.messageID, part?.messageId, payload?.messageID, payload?.messageId, payload?.message?.id, event?.messageID, event?.messageId);",
+    "    const role = pickEventString(part?.role, payload?.role, payload?.message?.role, event?.role).toLowerCase();",
+    "    const eventText = textFromContent(part) || textFromContent(payload?.message) || textFromContent(payload);",
+    "    if (eventText && role === 'user') {",
+    "      const inputText = limitObservationText(eventText);",
+    "      if (messageId) messageInputById.set(messageId, inputText);",
+    "      if (sessionId) lastUserTextBySessionId.set(sessionId, inputText);",
+    "      return;",
+    "    }",
+    "    if (sessionId && startupSkillUsages.length && !startupSkillSessionIds.has(sessionId)) {",
+    "      startupSkillSessionIds.add(sessionId);",
+    "      rememberSkillUsages(skillUsagesBySessionId, sessionId, startupSkillUsages);",
+    "    }",
+    "    const skillDetectionSources = [part, payload, part?.state?.input, part?.input, payload?.input, part?.state?.metadata, payload?.metadata, part?.state?.file, part?.file];",
+    "    const eventSkillUsages = detectOpencodeSkillUsages(skillDetectionSources, knownSkillNames);",
+    "    rememberSkillUsages(skillUsagesByMessageId, messageId, eventSkillUsages);",
+    "    rememberSkillUsages(skillUsagesBySessionId, sessionId, eventSkillUsages);",
+    "    const toolActivity = countOpencodeToolActivity(event);",
+    "    rememberToolActivity(toolCallIdsByMessageId, messageId, toolActivity, 'toolCallCount');",
+    "    rememberToolActivity(toolCallIdsBySessionId, sessionId, toolActivity, 'toolCallCount');",
+    "    rememberToolActivity(toolResultIdsByMessageId, messageId, toolActivity, 'toolResultCount');",
+    "    rememberToolActivity(toolResultIdsBySessionId, sessionId, toolActivity, 'toolResultCount');",
+    "    if (eventText && messageId && (role === 'assistant' || partType === 'text')) {",
+    "      messageTextById.set(messageId, limitObservationText(eventText));",
+    "      const textSkillUsages = detectOpencodeSkillUsages(eventText, knownSkillNames);",
+    "      rememberSkillUsages(skillUsagesByMessageId, messageId, textSkillUsages);",
+    "      rememberSkillUsages(skillUsagesBySessionId, sessionId, textSkillUsages);",
+    "      return;",
+    "    }",
+    "    if (partType !== 'step-finish' || !messageId || emittedMessageIds.has(messageId)) return;",
+    "    emittedMessageIds.add(messageId);",
+    "    const tokenMetrics = tokenMetricsFromPart(part);",
+    "    const total = tokenMetrics.total ?? (tokenMetrics.input !== undefined && tokenMetrics.output !== undefined ? tokenMetrics.input + tokenMetrics.output : undefined);",
+    "    const tokenAvailable = [tokenMetrics.input, tokenMetrics.output, total, tokenMetrics.cacheRead, tokenMetrics.reasoning].some((value) => value !== undefined);",
+    "    await sdkStartPromise;",
+    "    const span = getMetricsTracer().startSpan('OpenCode Agent Turn');",
+    "    const text = messageTextById.get(messageId) || '';",
+    "    const inputText = messageInputById.get(messageId) || lastUserTextBySessionId.get(sessionId) || startupPromptText || '';",
+    "    const skillUsages = dedupeSkillUsages([...(skillUsagesByMessageId.get(messageId) ?? []), ...(skillUsagesBySessionId.get(sessionId) ?? [])]);",
+    "    const interactionId = `opencode:${userId || \"unknown\"}:${sessionId || \"unknown\"}:${messageId}`;",
+    "    const skillUseEvents = buildSkillUseEvents(interactionId, skillUsages);",
+    "    const skillNames = uniqueSkillNames(skillUsages);",
+    "    const skillNamesAll = skillUseEvents.map((event) => event.skill_name);",
+    "    const skillInvocationModes = skillUseEvents.map((event) => event.skill_invocation_mode).filter(Boolean);",
+    "    const skillAgentPaths = skillUseEvents.map((event) => event.skill_agent_path).filter(Boolean);",
+    "    const toolCallCount = Math.max(new Set([...(toolCallIdsByMessageId.get(messageId) ?? []), ...(toolCallIdsBySessionId.get(sessionId) ?? [])]).size, skillUseEvents.length);",
+    "    const toolResultCount = Math.max(new Set([...(toolResultIdsByMessageId.get(messageId) ?? []), ...(toolResultIdsBySessionId.get(sessionId) ?? [])]).size, skillUseEvents.length);",
+    '    span.setAttribute("oh.langfuse.source", "opencode");',
+    '    span.setAttribute("oh.langfuse.user_id", userId || "");',
+    '    span.setAttribute("oh.langfuse.metrics_schema_version", "1.1");',
+    '    span.setAttribute("langfuse.observation.metadata.source", "opencode");',
+    '    span.setAttribute("langfuse.observation.metadata.agent", "opencode");',
+    '    span.setAttribute("langfuse.observation.metadata.user_id", userId || "");',
+    '    span.setAttribute("langfuse.observation.metadata.session_id", sessionId || "unknown");',
+    '    span.setAttribute("langfuse.observation.metadata.interaction_id", interactionId);',
+    '    span.setAttribute("langfuse.observation.metadata.metrics_schema_version", "1.1");',
+    '    span.setAttribute("langfuse.observation.metadata.interaction_count", 1);',
+    '    span.setAttribute("langfuse.observation.metadata.user_message_count", 1);',
+    '    span.setAttribute("langfuse.observation.metadata.assistant_message_count", 1);',
+    '    span.setAttribute("langfuse.observation.metadata.token_metrics_available", tokenAvailable);',
+    '    span.setAttribute("langfuse.observation.metadata.tool_call_count", toolCallCount);',
+    '    span.setAttribute("langfuse.observation.metadata.tool_result_count", toolResultCount);',
+    '    span.setAttribute("langfuse.observation.metadata.skill_use_count", skillUseEvents.length);',
+    '    span.setAttribute("langfuse.observation.metadata.unique_skill_count", skillNames.length);',
+    '    span.setAttribute("langfuse.observation.metadata.repeated_skill_count", Math.max(0, skillUseEvents.length - skillNames.length));',
+    '    if (skillNames.length) span.setAttribute("langfuse.observation.metadata.skill_names", skillNames);',
+    '    if (skillNames.length) span.setAttribute("langfuse.observation.metadata.skill_names_csv", skillNames.join(","));',
+    '    if (skillNamesAll.length) span.setAttribute("langfuse.observation.metadata.skill_names_all", skillNamesAll);',
+    '    if (skillInvocationModes.length) span.setAttribute("langfuse.observation.metadata.skill_invocation_modes", skillInvocationModes);',
+    '    if (skillAgentPaths.length) span.setAttribute("langfuse.observation.metadata.skill_agent_paths", skillAgentPaths);',
+    '    if (tokenMetrics.input !== undefined) span.setAttribute("langfuse.observation.metadata.input_tokens", tokenMetrics.input);',
+    '    if (tokenMetrics.output !== undefined) span.setAttribute("langfuse.observation.metadata.output_tokens", tokenMetrics.output);',
+    '    if (total !== undefined) span.setAttribute("langfuse.observation.metadata.total_tokens", total);',
+    '    if (tokenMetrics.cacheRead !== undefined) span.setAttribute("langfuse.observation.metadata.cache_read_tokens", tokenMetrics.cacheRead);',
+    '    if (tokenMetrics.reasoning !== undefined) span.setAttribute("langfuse.observation.metadata.reasoning_tokens", tokenMetrics.reasoning);',
+    '    if (inputText) span.setAttribute("langfuse.observation.input", inputText);',
+    '    if (inputText) span.setAttribute("langfuse.trace.input", inputText);',
+    '    if (inputText) span.setAttribute("input.value", inputText);',
+    '    if (text) span.setAttribute("langfuse.observation.output", text);',
+    '    if (text) span.setAttribute("langfuse.trace.output", text);',
+    '    if (text) span.setAttribute("output.value", text);',
+    '    if (inputText) span.setAttribute("langfuse.observation.metadata.input_text_preview", inputText.slice(0, 512));',
+    '    if (text) span.setAttribute("langfuse.observation.metadata.output_text_preview", text.slice(0, 512));',
+    '    writeRepoContextMetrics(span, collectRepoContext(process.cwd(), "process"));',
+    "    span.end();",
+    "    messageTextById.delete(messageId);",
+    "    messageInputById.delete(messageId);",
+    "    skillUsagesByMessageId.delete(messageId);",
+    "    skillUsagesBySessionId.delete(sessionId);",
+    "    toolCallIdsByMessageId.delete(messageId);",
+    "    toolCallIdsBySessionId.delete(sessionId);",
+    "    toolResultIdsByMessageId.delete(messageId);",
+    "    toolResultIdsBySessionId.delete(sessionId);",
+    "  };",
+    "",
+    "  return {",
+    "    config: async (config) => {",
+    "      if (!config.experimental?.openTelemetry) {",
+    '        log("warn", "OpenTelemetry experimental feature is disabled in Opencode config - tracing disabled");',
+    "      }",
+    "    },",
+    "    event: async ({ event }) => {",
+    "      const eventType = pickEventString(event?.name, event?.type, eventPayload(event)?.name, eventPayload(event)?.type);",
+    "      await recordInteractionMetric(event);",
+    '      if (eventType === "session.idle" || eventType === "message.updated" || eventType === "message.part.updated" || eventType === "session.updated" || eventType === "session.idle.1" || eventType === "message.updated.1" || eventType === "message.part.updated.1" || eventType === "session.updated.1") {',
+    "        await flush(eventType);",
+    "      }",
+    '      if (eventType === "server.instance.disposed") {',
+    "        await shutdown('server.instance.disposed');",
+    "      }",
+    "    },",
+    "  };",
+    "};",
+    ""
+  ].join(os.EOL);
+}
+
+export function patchDistIndexJs(distIndexPath) {
+  const code = getPatchedLangfuseDistIndexJs();
+  ensureDir(path.dirname(distIndexPath));
+  fs.writeFileSync(distIndexPath, code + os.EOL, "utf8");
+}
+
+function syncPluginPackageToLocalPlugins({ pkgDir, pluginDest, pluginsDir }) {
+  ensureDir(pluginsDir);
+  if (fs.existsSync(pluginDest)) {
+    fs.rmSync(pluginDest, { recursive: true, force: true });
+  }
+  fs.cpSync(pkgDir, pluginDest, { recursive: true });
+}
+
+function writeWindowsLauncherCmd(opencodeDir, { publicKey, secretKey, baseUrl, userId }) {
+  if (process.platform !== "win32") return null;
+  const p = path.join(opencodeDir, "launch-opencode-langfuse.cmd");
+  writeWindowsUpdateCheckScript(opencodeDir);
+  const cmd = ["@echo off", "REM Auto-generated by scripts/opencode-langfuse-setup.mjs"];
+  cmd.push(`set LANGFUSE_PUBLIC_KEY=${publicKey}`);
+  cmd.push(`set LANGFUSE_SECRET_KEY=${secretKey}`);
+  cmd.push(`set LANGFUSE_BASEURL=${baseUrl}`);
+  if (userId) cmd.push(`set LANGFUSE_USER_ID=${userId}`);
+  cmd.push('powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0oh-langfuse-opencode-update-check.ps1"');
+  cmd.push('if exist "%USERPROFILE%\\.opencode\\bin\\opencode.exe" (');
+  cmd.push('  "%USERPROFILE%\\.opencode\\bin\\opencode.exe" %*');
+  cmd.push("  exit /b");
+  cmd.push(")");
+  cmd.push("opencode %*");
+  fs.writeFileSync(p, cmd.join("\r\n") + "\r\n", "utf8");
+  return p;
+}
+
+function shQuote(s) {
+  return `'${String(s).replace(/'/g, "'\"'\"'")}'`;
+}
+
+function autoUpdateRuntimePath() {
+  return path.join(rootDir, "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", "--registry=https://registry.npmjs.org/", "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/opencode-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/opencode-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 windowsGitPathBootstrap() {
+  return [
+    "for /f \"delims=\" %%G in ('where.exe git.exe 2^>nul') do (",
+    "  set \"OH_LANGFUSE_GIT_EXE=%%G\"",
+    "  set \"npm_config_git=%%G\"",
+    "  set \"PATH=%%~dpG;%PATH%\"",
+    "  goto :oh_langfuse_git_ready",
+    ")",
+    ":oh_langfuse_git_ready"
+  ];
+}
+
 function writeWindowsUpdateCheckScript(dir) {
-  if (process.platform !== "win32") return null;
-  ensureDir(dir);
-  const p = path.join(dir, "oh-langfuse-opencode-update-check.ps1");
-  const ps = [
-    "$ErrorActionPreference = 'SilentlyContinue'",
-    "$statePath = Join-Path $env:USERPROFILE '.config\\oh-langfuse\\runtime.json'",
-    "if (-not (Test-Path -LiteralPath $statePath)) { exit 0 }",
-    "$state = Get-Content -LiteralPath $statePath -Raw | ConvertFrom-Json",
-    "$installed = $state.targets.opencode.packageVersion",
-    "$meta = Invoke-RestMethod -UseBasicParsing -Uri 'https://registry.npmjs.org/oh-langfuse' -TimeoutSec 3",
-    "$latest = $meta.'dist-tags'.latest",
-    "if ($installed -and $latest -and ([version]$latest -gt [version]$installed)) {",
-    "  Write-Host \"[INFO] oh-langfuse opencode runtime update available: $installed -> $latest\"",
-    "  Write-Host '[INFO] Close OpenCode and run: npx oh-langfuse@latest update opencode'",
-    "}",
-    ""
-  ].join("\r\n");
-  fs.writeFileSync(p, "\ufeff" + ps, "utf8");
+  if (process.platform !== "win32") return null;
+  ensureDir(dir);
+  const p = path.join(dir, "oh-langfuse-opencode-update-check.ps1");
+  const ps = [
+    "$ErrorActionPreference = 'SilentlyContinue'",
+    "$statePath = Join-Path $env:USERPROFILE '.config\\oh-langfuse\\runtime.json'",
+    "if (-not (Test-Path -LiteralPath $statePath)) { exit 0 }",
+    "$state = Get-Content -LiteralPath $statePath -Raw | ConvertFrom-Json",
+    "$installed = $state.targets.opencode.packageVersion",
+    "$meta = Invoke-RestMethod -UseBasicParsing -Uri 'https://registry.npmjs.org/oh-langfuse' -TimeoutSec 3",
+    "$latest = $meta.'dist-tags'.latest",
+    "if ($installed -and $latest -and ([version]$latest -gt [version]$installed)) {",
+    "  Write-Host \"[INFO] oh-langfuse opencode runtime update available: $installed -> $latest\"",
+    "  Write-Host '[INFO] Close OpenCode and run: npx oh-langfuse@latest update opencode'",
+    "}",
+    ""
+  ].join("\r\n");
+  fs.writeFileSync(p, "\ufeff" + ps, "utf8");
   return p;
 }
 
-function writeOpencodeCommandShim(opencodeDir, { publicKey, secretKey, baseUrl, userId, realOpencodeCli }) {
-  const shimDir = path.join(opencodeDir, "bin");
-  ensureDir(shimDir);
-  if (process.platform === "win32") {
-    const shim = path.join(shimDir, "opencode.cmd");
-    const cmd = ["@echo off", "REM Auto-generated by scripts/opencode-langfuse-setup.mjs"];
-    cmd.push("set OH_LANGFUSE_OPENCODE_SHIM=1");
-    cmd.push(`set LANGFUSE_PUBLIC_KEY=${publicKey}`);
-    cmd.push(`set LANGFUSE_SECRET_KEY=${secretKey}`);
-    cmd.push(`set LANGFUSE_BASEURL=${baseUrl}`);
-    if (userId) cmd.push(`set LANGFUSE_USER_ID=${userId}`);
-    cmd.push(...windowsGitPathBootstrap());
-    cmd.push(windowsAutoUpdateCommand("opencode"));
-    cmd.push(`set "OH_LANGFUSE_REAL_OPENCODE=${cmdSetValue(realOpencodeCli)}"`);
-    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");
-    cmd.push(")");
-    cmd.push('if exist "%USERPROFILE%\\.opencode\\bin\\opencode.exe" (');
-    cmd.push('  call "%USERPROFILE%\\.opencode\\bin\\opencode.exe" %*');
-    cmd.push("  exit /b");
-    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");
-    cmd.push(")");
-    cmd.push('if exist "%APPDATA%\\npm\\node_modules\\opencode-ai\\node_modules\\opencode-windows-x64-baseline\\bin\\opencode.exe" (');
-    cmd.push('  call "%APPDATA%\\npm\\node_modules\\opencode-ai\\node_modules\\opencode-windows-x64-baseline\\bin\\opencode.exe" %*');
-    cmd.push("  exit /b");
-    cmd.push(")");
-    cmd.push('if exist "%APPDATA%\\npm\\node_modules\\opencode-windows-x64\\bin\\opencode.exe" (');
-    cmd.push('  call "%APPDATA%\\npm\\node_modules\\opencode-windows-x64\\bin\\opencode.exe" %*');
-    cmd.push("  exit /b");
-    cmd.push(")");
-    cmd.push('if exist "%APPDATA%\\npm\\node_modules\\opencode-windows-x64-baseline\\bin\\opencode.exe" (');
-    cmd.push('  call "%APPDATA%\\npm\\node_modules\\opencode-windows-x64-baseline\\bin\\opencode.exe" %*');
-    cmd.push("  exit /b");
-    cmd.push(")");
-    cmd.push('if exist "%USERPROFILE%\\.opencode\\bin\\opencode.cmd" (');
-    cmd.push('  call "%USERPROFILE%\\.opencode\\bin\\opencode.cmd" %*');
-    cmd.push("  exit /b");
-    cmd.push(")");
-    cmd.push('if exist "%APPDATA%\\npm\\opencode.cmd" (');
-    cmd.push('  call "%APPDATA%\\npm\\opencode.cmd" %*');
-    cmd.push("  exit /b");
-    cmd.push(")");
-    cmd.push('for /f "delims=" %%O in (\'where.exe opencode 2^>nul\') do (');
-    cmd.push('  if /I not "%%~fO"=="%~f0" (');
-    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");
-    cmd.push("    )");
-    cmd.push("  )");
-    cmd.push(")");
-    cmd.push("echo [ERROR] OpenCode CLI not found. Install OpenCode CLI first. 1>&2");
-    cmd.push("echo Try: npm install -g opencode-ai@latest 1>&2");
-    cmd.push("echo Then run: npx oh-langfuse@latest update opencode 1>&2");
-    cmd.push("exit /b 127");
-    fs.writeFileSync(shim, cmd.join("\r\n") + "\r\n", "utf8");
-    return { shim, shimDir };
-  }
-
-  const shim = path.join(shimDir, "opencode");
-  const quotedRealOpencodeCli = shQuote(realOpencodeCli);
-  const lines = [
-    "#!/usr/bin/env sh",
-    "# Auto-generated by scripts/opencode-langfuse-setup.mjs",
-    "set -eu",
-    "export OH_LANGFUSE_OPENCODE_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("opencode"),
-    `OH_LANGFUSE_REAL_OPENCODE=${quotedRealOpencodeCli}`,
-    "OH_LANGFUSE_BROKEN_OPENCODE=",
-    "try_opencode_candidate() {",
-    '  candidate="$1"',
-    "  shift",
-    '  if [ -x "$candidate" ]; then',
-    '    if "$candidate" --version >/dev/null 2>&1; then exec "$candidate" "$@"; fi',
-    '    OH_LANGFUSE_BROKEN_OPENCODE="$candidate"',
-    "  fi",
-    "}",
-    'try_opencode_candidate "$HOME/.opencode/bin/opencode" "$@"',
-    'try_opencode_candidate "$OH_LANGFUSE_REAL_OPENCODE" "$@"',
-    'if command -v opencode >/dev/null 2>&1; then',
-    '  resolved="$(command -v opencode)"',
-    '  if [ "$resolved" != "$0" ]; then try_opencode_candidate "$resolved" "$@"; fi',
-    "fi",
-    'if [ -n "$OH_LANGFUSE_BROKEN_OPENCODE" ]; then',
-    '  echo "[ERROR] OpenCode CLI was found but failed to start: $OH_LANGFUSE_BROKEN_OPENCODE" >&2',
-    '  echo "Try: npm install -g opencode-ai@latest --registry=https://registry.npmjs.org/" >&2',
-    '  echo "Then run: npx --registry=https://registry.npmjs.org/ -y oh-langfuse@latest update opencode --npmRegistry=https://registry.npmjs.org/" >&2',
-    "  exit 127",
-    "fi",
-    'echo "[ERROR] OpenCode CLI not found. Install OpenCode CLI first." >&2',
-    'echo "Try: npm install -g opencode-ai@latest" >&2',
-    'echo "Then run: npx oh-langfuse@latest update opencode" >&2',
-    "exit 127",
-    ""
-  ].filter(Boolean);
-  fs.writeFileSync(shim, lines.join("\n"), "utf8");
-  fs.chmodSync(shim, 0o755);
-  return { shim, shimDir };
-}
-
-function writeUnixLauncherSh(opencodeDir, { publicKey, secretKey, baseUrl, userId }) {
-  if (process.platform === "win32") return null;
-  const p = path.join(opencodeDir, "launch-opencode-langfuse.sh");
-  const lines = [
-    "#!/usr/bin/env sh",
-    "# Auto-generated by scripts/opencode-langfuse-setup.mjs",
-    "set -eu",
-    `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("opencode"),
-    'if [ -x "$HOME/.opencode/bin/opencode" ]; then',
-    '  exec "$HOME/.opencode/bin/opencode" "$@"',
-    "fi",
-    'exec opencode "$@"',
-    ""
-  ].filter(Boolean);
-  fs.writeFileSync(p, lines.join("\n"), "utf8");
-  fs.chmodSync(p, 0o755);
-  return p;
-}
-
-function getNpmExecutable() {
-  if (process.platform === "win32") {
-    const beside = path.join(path.dirname(process.execPath), "npm.cmd");
-    if (fs.existsSync(beside)) return beside;
-  }
-  return process.platform === "win32" ? "npm.cmd" : "npm";
-}
-
-/** 与 node.exe 同目录下的 npm-cli.js（避免 Windows 上直接 spawn `*.cmd` 出现 EINVAL）。 */
-function getNpmCliJsPath() {
-  return path.join(path.dirname(process.execPath), "node_modules", "npm", "bin", "npm-cli.js");
-}
-
-/** @returns {{ status: number | null, stdout: string, stderr: string, error?: Error }} */
-function runNpmCapture(npmArgs) {
-  const cliJs = getNpmCliJsPath();
-  if (fs.existsSync(cliJs)) {
-    return spawnSync(process.execPath, [cliJs, ...npmArgs], {
-      encoding: "utf8",
-      windowsHide: true,
-      maxBuffer: 10 * 1024 * 1024
-    });
-  }
-  const npmExe = getNpmExecutable();
-  const useShell = process.platform === "win32" && /\.(cmd|bat)$/i.test(npmExe);
-  return spawnSync(npmExe, npmArgs, {
-    encoding: "utf8",
-    shell: useShell,
-    windowsHide: true,
-    maxBuffer: 10 * 1024 * 1024
-  });
-}
-
-function printNpmDiagnostics() {
-  try {
-    const nodeV = spawnSync(process.execPath, ["-v"], { encoding: "utf8" });
-    console.error("诊断：node 版本 =", (nodeV.stdout || "").trim(), "exit =", nodeV.status);
-  } catch (_) {}
-  const cliJs = getNpmCliJsPath();
-  console.error("诊断：npm 入口 =", fs.existsSync(cliJs) ? `node + ${cliJs}` : getNpmExecutable());
+function readRealOpencodeFromManagedShim(shimPath) {
   try {
-    const npmVersion = runNpmCapture(["-v"]);
-    console.error(
-      "诊断：npm 版本 =",
-      (npmVersion.stdout || "").trim(),
-      "exit =",
-      npmVersion.status,
-      npmVersion.error || ""
-    );
-  } catch (e) {
-    console.error("诊断：无法执行 npm -v：", e?.message || e);
-  }
-  try {
-    const reg = runNpmCapture(["config", "get", "registry"]);
-    console.error("诊断：npm registry =", (reg.stdout || "").trim());
-    if (reg.stderr) console.error(reg.stderr);
-  } catch (_) {}
-}
-
-/**
- * 重置终端状态，防止子进程异常退出后遗留 ANSI 转义序列。
- */
-function resetTerminalState() {
-  if (process.stdout.isTTY) {
-    // \x1b[0m    - 重置所有颜色和属性
-    // \x1b[?25h  - 显示光标（防止 npm 隐藏光标后未恢复）
-    // \x1b[r     - 重置滚动区域
-    process.stdout.write('\x1b[0m\x1b[?25h\x1b[r');
-  }
-}
-
-function runNpmInstallCapture(npmArgs, options = {}) {
-  return new Promise((resolve) => {
-    const cliJs = getNpmCliJsPath();
-    const npmExe = getNpmExecutable();
-    const command = fs.existsSync(cliJs) ? process.execPath : npmExe;
-    const args = fs.existsSync(cliJs) ? [cliJs, ...npmArgs] : npmArgs;
-    const useShell = process.platform === "win32" && !fs.existsSync(cliJs) && /\.(cmd|bat)$/i.test(npmExe);
-    const timeoutMs = options.timeoutMs ?? 600000; // 默认 10 分钟超时
-
-    const child = spawn(command, args, {
-      encoding: "utf8",
-      shell: useShell,
-      windowsHide: true,
-      timeout: timeoutMs
-    });
-    let stdout = "";
-    let stderr = "";
-    const started = Date.now();
-    const timer = setInterval(() => {
-      const secs = Math.round((Date.now() - started) / 1000);
-      console.error(`npm install still running (${secs}s). Slow networks can take a few minutes...`);
-    }, 15000);
-    child.stdout?.on("data", (chunk) => {
-      const text = String(chunk);
-      stdout += text;
-      process.stdout.write(text);
-    });
-    child.stderr?.on("data", (chunk) => {
-      const text = String(chunk);
-      stderr += text;
-      const filtered = text
-        .split(/(\r?\n)/)
-        .filter((part) => part === "\n" || part === "\r\n" || !shouldSuppressAgentLogLine(part))
-        .join("");
-      if (filtered) process.stderr.write(filtered);
-    });
-    child.on("error", (error) => {
-      clearInterval(timer);
-      resetTerminalState();
-      resolve({ status: null, stdout, stderr, error });
-    });
-    child.on("close", (status) => {
-      clearInterval(timer);
-      if (status !== 0) {
-        resetTerminalState();
-      }
-      resolve({ status, stdout, stderr });
-    });
-    child.on("timeout", () => {
-      clearInterval(timer);
-      console.error("");
-      console.error(`npm install timed out after ${Math.round(timeoutMs / 1000)}s, killing process...`);
-      resetTerminalState();
-      child.kill('SIGTERM');
-    });
-  });
-}
-
-function npmInstallLooksLikeMissingVersion(result) {
-  const text = `${result?.stdout || ""}\n${result?.stderr || ""}\n${result?.error?.message || ""}`.toLowerCase();
-  return text.includes("etarget") || text.includes("notarget") || text.includes("no matching version found");
-}
-
-function isOfficialNpmRegistry(registry) {
-  return /^https?:\/\/registry\.npmjs\.org\/?$/i.test(String(registry || "").trim());
-}
-
-const OFFICIAL_NPM_REGISTRY = "https://registry.npmjs.org/";
-const DEFAULT_NPM_REGISTRY = "https://registry.npmmirror.com/";
-
-function isChinaNetwork() {
-  const tz = Intl.DateTimeFormat().resolvedOptions().timeZone || "";
-  return tz.includes("Shanghai") || tz.includes("Chongqing") || tz.includes("Harbin");
-}
-
-async function checkInstalledVersion(opencodeDir, pkgName) {
-  const pkgJsonPath = path.join(opencodeDir, "node_modules", pkgName, "package.json");
-  if (!fs.existsSync(pkgJsonPath)) return null;
-  try {
-    const txt = stripBom(fs.readFileSync(pkgJsonPath, "utf8"));
-    if (!txt.trim()) return null;
-    const installed = parseJsonRelaxed(txt, pkgJsonPath);
-    return installed?.version || null;
+    if (!shimPath || !fs.existsSync(shimPath)) return "";
+    const text = fs.readFileSync(shimPath, "utf8");
+    const cmdMatch = text.match(/set\s+"OH_LANGFUSE_REAL_OPENCODE=([^"]+)"/i);
+    if (cmdMatch?.[1] && fs.existsSync(cmdMatch[1])) return path.resolve(cmdMatch[1]);
+    const shMatch = text.match(/^OH_LANGFUSE_REAL_OPENCODE=(?:"([^"]+)"|'([^']+)'|([^\r\n]+))/m);
+    const candidate = shMatch?.[1] || shMatch?.[2] || shMatch?.[3];
+    if (candidate && fs.existsSync(candidate.trim())) return path.resolve(candidate.trim());
   } catch {
-    return null;
+    // Best effort only; setup can still fall back to ordinary CLI discovery.
   }
+  return "";
 }
 
-async function runNpmInstallOrThrow({ opencodeDir, pkgName = "opencode-plugin-langfuse", npmRegistry = "" }) {
-  const installedVersion = await checkInstalledVersion(opencodeDir, pkgName);
-  const currentVersion = packageJson.version;
-
-  if (installedVersion === currentVersion) {
-    console.log(`插件版本 ${currentVersion} 已安装，跳过 npm install ...`);
-    return;
-  }
-
-  if (installedVersion) {
-    console.log(`插件版本 ${installedVersion} 已安装，升级到 ${currentVersion} ...`);
-  }
-
-  const isOfficial = npmRegistry && isOfficialNpmRegistry(npmRegistry);
-  const effectiveRegistry = npmRegistry || (isChinaNetwork() ? DEFAULT_NPM_REGISTRY : OFFICIAL_NPM_REGISTRY);
-
-  const npmArgs = [
-    "install", pkgName, "--prefix", opencodeDir,
-    "--package-lock=false", "--no-save",
-    "--audit=false", "--fund=false",
-    "--prefer-offline",
-    "--registry", effectiveRegistry
-  ];
-
-  const cliJs = getNpmCliJsPath();
-  console.log(`使用 npm：${fs.existsSync(cliJs) ? `node ${cliJs}` : getNpmExecutable()}`);
-  console.log(`使用 npm registry：${effectiveRegistry}`);
-  console.log("Installing OpenCode Langfuse plugin. This can take a few minutes on slow networks...");
-
-  let r = await runNpmInstallCapture(npmArgs, { timeoutMs: 600000 });
-
-  if (!r.error && r.status !== 0 && npmInstallLooksLikeMissingVersion(r) && !isOfficialNpmRegistry(effectiveRegistry)) {
-    console.error("");
-    console.error(`npm registry appears to be missing a package version. Retrying with ${OFFICIAL_NPM_REGISTRY} ...`);
-    const retryArgs = [
-      "install", pkgName, "--prefix", opencodeDir,
-      "--package-lock=false", "--no-save",
-      "--audit=false", "--fund=false",
-      "--prefer-offline",
-      "--registry", OFFICIAL_NPM_REGISTRY
-    ];
-    r = await runNpmInstallCapture(retryArgs, { timeoutMs: 600000 });
-    if (!r.error && r.status === 0) return;
-  }
-
-  if (!r.error && r.status === 0) return;
-
-  printNpmDiagnostics();
-  const npmLabel = fs.existsSync(cliJs) ? `node ${cliJs}` : getNpmExecutable();
-  throw new Error(
-    `执行 ${npmLabel} ${npmArgs.join(" ")} 失败（exit=${r.status}${r.error ? ` ${r.error.message}` : ""}）。` +
-      `见 README「常见问题」或设置 OPENCODE_SKIP_PLUGIN_INSTALL=1 后重试。`
+function writeOpencodeCommandShim(opencodeDir, { publicKey, secretKey, baseUrl, userId, realOpencodeCli }) {
+  const shimDir = path.join(opencodeDir, "bin");
+  ensureDir(shimDir);
+  if (process.platform === "win32") {
+    const shim = path.join(shimDir, "opencode.cmd");
+    const cmd = ["@echo off", "REM Auto-generated by scripts/opencode-langfuse-setup.mjs"];
+    cmd.push("set OH_LANGFUSE_OPENCODE_SHIM=1");
+    cmd.push(`set LANGFUSE_PUBLIC_KEY=${publicKey}`);
+    cmd.push(`set LANGFUSE_SECRET_KEY=${secretKey}`);
+    cmd.push(`set LANGFUSE_BASEURL=${baseUrl}`);
+    if (userId) cmd.push(`set LANGFUSE_USER_ID=${userId}`);
+    cmd.push(...windowsGitPathBootstrap());
+    cmd.push(windowsAutoUpdateCommand("opencode"));
+    cmd.push(`set "OH_LANGFUSE_REAL_OPENCODE=${cmdSetValue(realOpencodeCli)}"`);
+    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");
+    cmd.push(")");
+    cmd.push('if exist "%USERPROFILE%\\.opencode\\bin\\opencode.exe" (');
+    cmd.push('  call "%USERPROFILE%\\.opencode\\bin\\opencode.exe" %*');
+    cmd.push("  exit /b");
+    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");
+    cmd.push(")");
+    cmd.push('if exist "%APPDATA%\\npm\\node_modules\\opencode-ai\\node_modules\\opencode-windows-x64-baseline\\bin\\opencode.exe" (');
+    cmd.push('  call "%APPDATA%\\npm\\node_modules\\opencode-ai\\node_modules\\opencode-windows-x64-baseline\\bin\\opencode.exe" %*');
+    cmd.push("  exit /b");
+    cmd.push(")");
+    cmd.push('if exist "%APPDATA%\\npm\\node_modules\\opencode-windows-x64\\bin\\opencode.exe" (');
+    cmd.push('  call "%APPDATA%\\npm\\node_modules\\opencode-windows-x64\\bin\\opencode.exe" %*');
+    cmd.push("  exit /b");
+    cmd.push(")");
+    cmd.push('if exist "%APPDATA%\\npm\\node_modules\\opencode-windows-x64-baseline\\bin\\opencode.exe" (');
+    cmd.push('  call "%APPDATA%\\npm\\node_modules\\opencode-windows-x64-baseline\\bin\\opencode.exe" %*');
+    cmd.push("  exit /b");
+    cmd.push(")");
+    cmd.push('if exist "%USERPROFILE%\\.opencode\\bin\\opencode.cmd" (');
+    cmd.push('  call "%USERPROFILE%\\.opencode\\bin\\opencode.cmd" %*');
+    cmd.push("  exit /b");
+    cmd.push(")");
+    cmd.push('if exist "%APPDATA%\\npm\\opencode.cmd" (');
+    cmd.push('  call "%APPDATA%\\npm\\opencode.cmd" %*');
+    cmd.push("  exit /b");
+    cmd.push(")");
+    cmd.push('for /f "delims=" %%O in (\'where.exe opencode 2^>nul\') do (');
+    cmd.push('  if /I not "%%~fO"=="%~f0" (');
+    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");
+    cmd.push("    )");
+    cmd.push("  )");
+    cmd.push(")");
+    cmd.push("echo [ERROR] OpenCode CLI not found. Install OpenCode CLI first. 1>&2");
+    cmd.push("echo Try: npm install -g opencode-ai@latest 1>&2");
+    cmd.push("echo Then run: npx oh-langfuse@latest update opencode 1>&2");
+    cmd.push("exit /b 127");
+    fs.writeFileSync(shim, cmd.join("\r\n") + "\r\n", "utf8");
+    return { shim, shimDir };
+  }
+
+  const shim = path.join(shimDir, "opencode");
+  const quotedRealOpencodeCli = shQuote(realOpencodeCli);
+  const lines = [
+    "#!/usr/bin/env sh",
+    "# Auto-generated by scripts/opencode-langfuse-setup.mjs",
+    "set -eu",
+    "export OH_LANGFUSE_OPENCODE_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("opencode"),
+    `OH_LANGFUSE_REAL_OPENCODE=${quotedRealOpencodeCli}`,
+    "OH_LANGFUSE_BROKEN_OPENCODE=",
+    "try_opencode_candidate() {",
+    '  candidate="$1"',
+    "  shift",
+    '  if [ -x "$candidate" ]; then',
+    '    if "$candidate" --version >/dev/null 2>&1; then exec "$candidate" "$@"; fi',
+    '    OH_LANGFUSE_BROKEN_OPENCODE="$candidate"',
+    "  fi",
+    "}",
+    'try_opencode_candidate "$HOME/.opencode/bin/opencode" "$@"',
+    'try_opencode_candidate "$OH_LANGFUSE_REAL_OPENCODE" "$@"',
+    'if command -v opencode >/dev/null 2>&1; then',
+    '  resolved="$(command -v opencode)"',
+    '  if [ "$resolved" != "$0" ]; then try_opencode_candidate "$resolved" "$@"; fi',
+    "fi",
+    'if [ -n "$OH_LANGFUSE_BROKEN_OPENCODE" ]; then',
+    '  echo "[ERROR] OpenCode CLI was found but failed to start: $OH_LANGFUSE_BROKEN_OPENCODE" >&2',
+    '  echo "Try: npm install -g opencode-ai@latest --registry=https://registry.npmjs.org/" >&2',
+    '  echo "Then run: npx --registry=https://registry.npmjs.org/ -y oh-langfuse@latest update opencode --npmRegistry=https://registry.npmjs.org/" >&2',
+    "  exit 127",
+    "fi",
+    'echo "[ERROR] OpenCode CLI not found. Install OpenCode CLI first." >&2',
+    'echo "Try: npm install -g opencode-ai@latest" >&2',
+    'echo "Then run: npx oh-langfuse@latest update opencode" >&2',
+    "exit 127",
+    ""
+  ].filter(Boolean);
+  fs.writeFileSync(shim, lines.join("\n"), "utf8");
+  fs.chmodSync(shim, 0o755);
+  return { shim, shimDir };
+}
+
+function writeUnixLauncherSh(opencodeDir, { publicKey, secretKey, baseUrl, userId }) {
+  if (process.platform === "win32") return null;
+  const p = path.join(opencodeDir, "launch-opencode-langfuse.sh");
+  const lines = [
+    "#!/usr/bin/env sh",
+    "# Auto-generated by scripts/opencode-langfuse-setup.mjs",
+    "set -eu",
+    `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("opencode"),
+    'if [ -x "$HOME/.opencode/bin/opencode" ]; then',
+    '  exec "$HOME/.opencode/bin/opencode" "$@"',
+    "fi",
+    'exec opencode "$@"',
+    ""
+  ].filter(Boolean);
+  fs.writeFileSync(p, lines.join("\n"), "utf8");
+  fs.chmodSync(p, 0o755);
+  return p;
+}
+
+function getNpmExecutable() {
+  if (process.platform === "win32") {
+    const beside = path.join(path.dirname(process.execPath), "npm.cmd");
+    if (fs.existsSync(beside)) return beside;
+  }
+  return process.platform === "win32" ? "npm.cmd" : "npm";
+}
+
+/** 与 node.exe 同目录下的 npm-cli.js（避免 Windows 上直接 spawn `*.cmd` 出现 EINVAL）。 */
+function getNpmCliJsPath() {
+  return path.join(path.dirname(process.execPath), "node_modules", "npm", "bin", "npm-cli.js");
+}
+
+/** @returns {{ status: number | null, stdout: string, stderr: string, error?: Error }} */
+function runNpmCapture(npmArgs) {
+  const cliJs = getNpmCliJsPath();
+  if (fs.existsSync(cliJs)) {
+    return spawnSync(process.execPath, [cliJs, ...npmArgs], {
+      encoding: "utf8",
+      windowsHide: true,
+      maxBuffer: 10 * 1024 * 1024
+    });
+  }
+  const npmExe = getNpmExecutable();
+  const useShell = process.platform === "win32" && /\.(cmd|bat)$/i.test(npmExe);
+  return spawnSync(npmExe, npmArgs, {
+    encoding: "utf8",
+    shell: useShell,
+    windowsHide: true,
+    maxBuffer: 10 * 1024 * 1024
+  });
+}
+
+function printNpmDiagnostics() {
+  try {
+    const nodeV = spawnSync(process.execPath, ["-v"], { encoding: "utf8" });
+    console.error("诊断：node 版本 =", (nodeV.stdout || "").trim(), "exit =", nodeV.status);
+  } catch (_) {}
+  const cliJs = getNpmCliJsPath();
+  console.error("诊断：npm 入口 =", fs.existsSync(cliJs) ? `node + ${cliJs}` : getNpmExecutable());
+  try {
+    const npmVersion = runNpmCapture(["-v"]);
+    console.error(
+      "诊断：npm 版本 =",
+      (npmVersion.stdout || "").trim(),
+      "exit =",
+      npmVersion.status,
+      npmVersion.error || ""
+    );
+  } catch (e) {
+    console.error("诊断：无法执行 npm -v：", e?.message || e);
+  }
+  try {
+    const reg = runNpmCapture(["config", "get", "registry"]);
+    console.error("诊断：npm registry =", (reg.stdout || "").trim());
+    if (reg.stderr) console.error(reg.stderr);
+  } catch (_) {}
+}
+
+/**
+ * 重置终端状态，防止子进程异常退出后遗留 ANSI 转义序列。
+ */
+function resetTerminalState() {
+  if (process.stdout.isTTY) {
+    // \x1b[0m    - 重置所有颜色和属性
+    // \x1b[?25h  - 显示光标（防止 npm 隐藏光标后未恢复）
+    // \x1b[r     - 重置滚动区域
+    process.stdout.write('\x1b[0m\x1b[?25h\x1b[r');
+  }
+}
+
+function runNpmInstallCapture(npmArgs, options = {}) {
+  return new Promise((resolve) => {
+    const cliJs = getNpmCliJsPath();
+    const npmExe = getNpmExecutable();
+    const command = fs.existsSync(cliJs) ? process.execPath : npmExe;
+    const args = fs.existsSync(cliJs) ? [cliJs, ...npmArgs] : npmArgs;
+    const useShell = process.platform === "win32" && !fs.existsSync(cliJs) && /\.(cmd|bat)$/i.test(npmExe);
+    const timeoutMs = options.timeoutMs ?? 600000; // 默认 10 分钟超时
+
+    const child = spawn(command, args, {
+      encoding: "utf8",
+      shell: useShell,
+      windowsHide: true,
+      timeout: timeoutMs
+    });
+    let stdout = "";
+    let stderr = "";
+    const started = Date.now();
+    const timer = setInterval(() => {
+      const secs = Math.round((Date.now() - started) / 1000);
+      console.error(`npm install still running (${secs}s). Slow networks can take a few minutes...`);
+    }, 15000);
+    child.stdout?.on("data", (chunk) => {
+      const text = String(chunk);
+      stdout += text;
+      process.stdout.write(text);
+    });
+    child.stderr?.on("data", (chunk) => {
+      const text = String(chunk);
+      stderr += text;
+      const filtered = text
+        .split(/(\r?\n)/)
+        .filter((part) => part === "\n" || part === "\r\n" || !shouldSuppressAgentLogLine(part))
+        .join("");
+      if (filtered) process.stderr.write(filtered);
+    });
+    child.on("error", (error) => {
+      clearInterval(timer);
+      resetTerminalState();
+      resolve({ status: null, stdout, stderr, error });
+    });
+    child.on("close", (status) => {
+      clearInterval(timer);
+      if (status !== 0) {
+        resetTerminalState();
+      }
+      resolve({ status, stdout, stderr });
+    });
+    child.on("timeout", () => {
+      clearInterval(timer);
+      console.error("");
+      console.error(`npm install timed out after ${Math.round(timeoutMs / 1000)}s, killing process...`);
+      resetTerminalState();
+      child.kill('SIGTERM');
+    });
+  });
+}
+
+function npmInstallLooksLikeMissingVersion(result) {
+  const text = `${result?.stdout || ""}\n${result?.stderr || ""}\n${result?.error?.message || ""}`.toLowerCase();
+  return text.includes("etarget") || text.includes("notarget") || text.includes("no matching version found");
+}
+
+function isOfficialNpmRegistry(registry) {
+  return /^https?:\/\/registry\.npmjs\.org\/?$/i.test(String(registry || "").trim());
+}
+
+const OFFICIAL_NPM_REGISTRY = "https://registry.npmjs.org/";
+const DEFAULT_NPM_REGISTRY = "https://registry.npmmirror.com/";
+
+function isChinaNetwork() {
+  const tz = Intl.DateTimeFormat().resolvedOptions().timeZone || "";
+  return tz.includes("Shanghai") || tz.includes("Chongqing") || tz.includes("Harbin");
+}
+
+async function checkInstalledVersion(opencodeDir, pkgName) {
+  const pkgJsonPath = path.join(opencodeDir, "node_modules", pkgName, "package.json");
+  if (!fs.existsSync(pkgJsonPath)) return null;
+  try {
+    const txt = stripBom(fs.readFileSync(pkgJsonPath, "utf8"));
+    if (!txt.trim()) return null;
+    const installed = parseJsonRelaxed(txt, pkgJsonPath);
+    return installed?.version || null;
+  } catch {
+    return null;
+  }
+}
+
+async function runNpmInstallOrThrow({ opencodeDir, pkgName = "opencode-plugin-langfuse", npmRegistry = "" }) {
+  const installedVersion = await checkInstalledVersion(opencodeDir, pkgName);
+  const currentVersion = packageJson.version;
+
+  if (installedVersion === currentVersion) {
+    console.log(`插件版本 ${currentVersion} 已安装，跳过 npm install ...`);
+    return;
+  }
+
+  if (installedVersion) {
+    console.log(`插件版本 ${installedVersion} 已安装，升级到 ${currentVersion} ...`);
+  }
+
+  const isOfficial = npmRegistry && isOfficialNpmRegistry(npmRegistry);
+  const effectiveRegistry = npmRegistry || (isChinaNetwork() ? DEFAULT_NPM_REGISTRY : OFFICIAL_NPM_REGISTRY);
+
+  const npmArgs = [
+    "install", pkgName, "--prefix", opencodeDir,
+    "--package-lock=false", "--no-save",
+    "--audit=false", "--fund=false",
+    "--prefer-offline",
+    "--registry", effectiveRegistry
+  ];
+
+  const cliJs = getNpmCliJsPath();
+  console.log(`使用 npm：${fs.existsSync(cliJs) ? `node ${cliJs}` : getNpmExecutable()}`);
+  console.log(`使用 npm registry：${effectiveRegistry}`);
+  console.log("Installing OpenCode Langfuse plugin. This can take a few minutes on slow networks...");
+
+  let r = await runNpmInstallCapture(npmArgs, { timeoutMs: 600000 });
+
+  if (!r.error && r.status !== 0 && npmInstallLooksLikeMissingVersion(r) && !isOfficialNpmRegistry(effectiveRegistry)) {
+    console.error("");
+    console.error(`npm registry appears to be missing a package version. Retrying with ${OFFICIAL_NPM_REGISTRY} ...`);
+    const retryArgs = [
+      "install", pkgName, "--prefix", opencodeDir,
+      "--package-lock=false", "--no-save",
+      "--audit=false", "--fund=false",
+      "--prefer-offline",
+      "--registry", OFFICIAL_NPM_REGISTRY
+    ];
+    r = await runNpmInstallCapture(retryArgs, { timeoutMs: 600000 });
+    if (!r.error && r.status === 0) return;
+  }
+
+  if (!r.error && r.status === 0) return;
+
+  printNpmDiagnostics();
+  const npmLabel = fs.existsSync(cliJs) ? `node ${cliJs}` : getNpmExecutable();
+  throw new Error(
+    `执行 ${npmLabel} ${npmArgs.join(" ")} 失败（exit=${r.status}${r.error ? ` ${r.error.message}` : ""}）。` +
+      `见 README「常见问题」或设置 OPENCODE_SKIP_PLUGIN_INSTALL=1 后重试。`
+  );
+}
+
+function setWindowsUserEnv({ publicKey, secretKey, baseUrl }) {
+  const cmd = [
+    "$ErrorActionPreference = 'Stop';",
+    `[Environment]::SetEnvironmentVariable('LANGFUSE_PUBLIC_KEY', ${psQuote(publicKey)}, 'User');`,
+    `[Environment]::SetEnvironmentVariable('LANGFUSE_SECRET_KEY', ${psQuote(secretKey)}, 'User');`,
+    `[Environment]::SetEnvironmentVariable('LANGFUSE_BASEURL', ${psQuote(baseUrl)}, 'User');`
+].join(" ");
+  const r = spawnSync("powershell", ["-NoProfile", "-Command", cmd], { stdio: "inherit", encoding: "utf8" });
+  if (r.status !== 0) {
+    throw new Error("写入用户级环境变量失败。");
+  }
+}
+
+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 r = spawnSync("powershell", ["-NoProfile", "-Command", cmd], { stdio: "inherit", encoding: "utf8" });
+  if (r.status !== 0) {
+    throw new Error("写入用户 PATH 失败：无法把 OpenCode Langfuse shim 加入 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 getShellConfigPath() {
+  const shell = process.env.SHELL || "/bin/bash";
+  if (shell.includes("zsh")) {
+    return path.join(os.homedir(), ".zshrc");
+  }
+  return path.join(os.homedir(), ".bashrc");
+}
+
+function updateShellConfig({ publicKey, secretKey, baseUrl, userId, pathPrepend = "" }) {
+  const configPath = getShellConfigPath();
+  const marker = "# === Langfuse OpenCode Setup ===";
+  const endMarker = "# === End Langfuse OpenCode Setup ===";
+
+  let content = "";
+  if (fs.existsSync(configPath)) {
+    content = fs.readFileSync(configPath, "utf8");
+  }
+
+  // 移除旧的配置块
+  const startIdx = content.indexOf(marker);
+  if (startIdx !== -1) {
+    const endIdx = content.indexOf(endMarker, startIdx);
+    if (endIdx !== -1) {
+      content = content.slice(0, startIdx) + content.slice(endIdx + endMarker.length);
+    }
+  }
+
+  // 构建新的配置块
+  const envBlock = [
+    "",
+    marker,
+    `export LANGFUSE_PUBLIC_KEY="${publicKey}"`,
+    `export LANGFUSE_SECRET_KEY="${secretKey}"`,
+    `export LANGFUSE_BASEURL="${baseUrl}"`,
+    userId ? `export LANGFUSE_USER_ID="${userId}"` : null,
+    pathPrepend ? `export PATH="${pathPrepend}:$PATH"` : null,
+    endMarker,
+    ""
+  ].filter(Boolean).join("\n");
+
+  // 追加到文件末尾
+  content = content.trimEnd() + "\n" + envBlock + "\n";
+  fs.writeFileSync(configPath, content, "utf8");
+
+  return configPath;
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  const setEnv = !args["no-set-env"];
+  const skipPluginInstall =
+    !!(args["skip-plugin-install"] || args.skipNpmInstall || process.env.OPENCODE_SKIP_PLUGIN_INSTALL);
+
+  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 baseUrl = normalizeLegacyBaseUrl(
+    args.langfuseBaseUrl || process.env.LANGFUSE_BASEURL || DEFAULT_LANGFUSE_BASE_URL
   );
-}
-
-function setWindowsUserEnv({ publicKey, secretKey, baseUrl }) {
-  const cmd = [
-    "$ErrorActionPreference = 'Stop';",
-    `[Environment]::SetEnvironmentVariable('LANGFUSE_PUBLIC_KEY', ${psQuote(publicKey)}, 'User');`,
-    `[Environment]::SetEnvironmentVariable('LANGFUSE_SECRET_KEY', ${psQuote(secretKey)}, 'User');`,
-    `[Environment]::SetEnvironmentVariable('LANGFUSE_BASEURL', ${psQuote(baseUrl)}, 'User');`
-].join(" ");
-  const r = spawnSync("powershell", ["-NoProfile", "-Command", cmd], { stdio: "inherit", encoding: "utf8" });
-  if (r.status !== 0) {
-    throw new Error("写入用户级环境变量失败。");
-  }
-}
-
-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 r = spawnSync("powershell", ["-NoProfile", "-Command", cmd], { stdio: "inherit", encoding: "utf8" });
-  if (r.status !== 0) {
-    throw new Error("写入用户 PATH 失败：无法把 OpenCode Langfuse shim 加入 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 getShellConfigPath() {
-  const shell = process.env.SHELL || "/bin/bash";
-  if (shell.includes("zsh")) {
-    return path.join(os.homedir(), ".zshrc");
-  }
-  return path.join(os.homedir(), ".bashrc");
-}
-
-function updateShellConfig({ publicKey, secretKey, baseUrl, userId, pathPrepend = "" }) {
-  const configPath = getShellConfigPath();
-  const marker = "# === Langfuse OpenCode Setup ===";
-  const endMarker = "# === End Langfuse OpenCode Setup ===";
-
-  let content = "";
-  if (fs.existsSync(configPath)) {
-    content = fs.readFileSync(configPath, "utf8");
-  }
-
-  // 移除旧的配置块
-  const startIdx = content.indexOf(marker);
-  if (startIdx !== -1) {
-    const endIdx = content.indexOf(endMarker, startIdx);
-    if (endIdx !== -1) {
-      content = content.slice(0, startIdx) + content.slice(endIdx + endMarker.length);
-    }
-  }
-
-  // 构建新的配置块
-  const envBlock = [
-    "",
-    marker,
-    `export LANGFUSE_PUBLIC_KEY="${publicKey}"`,
-    `export LANGFUSE_SECRET_KEY="${secretKey}"`,
-    `export LANGFUSE_BASEURL="${baseUrl}"`,
-    userId ? `export LANGFUSE_USER_ID="${userId}"` : null,
-    pathPrepend ? `export PATH="${pathPrepend}:$PATH"` : null,
-    endMarker,
-    ""
-  ].filter(Boolean).join("\n");
-
-  // 追加到文件末尾
-  content = content.trimEnd() + "\n" + envBlock + "\n";
-  fs.writeFileSync(configPath, content, "utf8");
-
-  return configPath;
-}
-
-async function main() {
-  const args = parseArgs(process.argv.slice(2));
-
-  const setEnv = !args["no-set-env"];
-  const skipPluginInstall =
-    !!(args["skip-plugin-install"] || args.skipNpmInstall || process.env.OPENCODE_SKIP_PLUGIN_INSTALL);
-
-  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 baseUrl =
-    args.langfuseBaseUrl || process.env.LANGFUSE_BASEURL || "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 npmRegistry = args.npmRegistry || process.env.OPENCODE_NPM_REGISTRY || "";
-
-  const home = os.homedir();
-  const opencodeDir = path.join(home, ".config", "opencode");
-  const pluginsDir = path.join(opencodeDir, "plugins");
-  const pkgDir = path.join(opencodeDir, "node_modules", "opencode-plugin-langfuse");
-  const pkgJsonPath = path.join(pkgDir, "package.json");
-  const pluginDest = path.join(pluginsDir, "opencode-plugin-langfuse");
-  const opencodeJsonPath = path.join(opencodeDir, "opencode.json");
-
-  ensureDir(opencodeDir);
-
-  console.log(`OpenCode 配置目录：${opencodeDir}`);
-
-  if (skipPluginInstall && fs.existsSync(pkgJsonPath)) {
-    console.log(`已跳过 npm install（--skip-plugin-install 且已存在）：${pkgDir}`);
-  } else {
-    console.log("安装 npm 包：opencode-plugin-langfuse …");
-    await runNpmInstallOrThrow({ opencodeDir, npmRegistry });
-  }
-
-  if (!fs.existsSync(pkgJsonPath)) {
-    throw new Error(
-      `未找到已安装包目录：${pkgDir}。请先解决上方 npm 报错，或手动在此目录执行 npm install opencode-plugin-langfuse。`
-    );
-  }
-
-  const existing = readJsonIfExists(opencodeJsonPath) ?? {};
-  // Patch the official plugin to inject userId and make behavior consistent.
-  const distIndexInNodeModules = path.join(pkgDir, "dist", "index.js");
-  if (fs.existsSync(distIndexInNodeModules)) {
-    patchDistIndexJs(distIndexInNodeModules);
-  }
-
-  console.log("Syncing plugin into ~/.config/opencode/plugins/ ...");
-  syncPluginPackageToLocalPlugins({ pkgDir, pluginDest, pluginsDir });
-  console.log(`Plugin ready at: ${pluginDest}`);
-
-  const distIndexInPlugins = path.join(pluginDest, "dist", "index.js");
-  if (fs.existsSync(distIndexInPlugins)) {
-    patchDistIndexJs(distIndexInPlugins);
-  }
-
-  // Write plugin user config to support userId injection.
-  if (userId) {
-    const cfg = writeLangfusePluginUserConfig({ userId });
-    console.log(`已更新：${cfg}`);
-  }
-
-  const langfusePluginPath = "./plugins/opencode-plugin-langfuse";
-  const basePlugins = removePlugins(existing.plugin, [
-    "opencode-plugin-langfuse-userid",
-    "opencode-plugin-langfuse",
-    langfusePluginPath
-  ]);
-  const desired = {
-    experimental: {
-      openTelemetry: true
-    },
-    plugin: mergePluginList(basePlugins, langfusePluginPath)
-  };
-  const merged = deepMerge(existing, desired);
-  writeJsonPretty(opencodeJsonPath, merged);
-  let realOpencodeCli = resolveOpencodeCli(args.cmd);
-  const shimDir = path.join(opencodeDir, "bin");
+  const userId = normalizeUserId(args.userId || args.userid || "");
+  if (!userId || typeof userId !== "string") {
+    throw new Error("缺少参数：--userId=你的工号");
+  }
+  assertValidUserId(userId);
+  const npmRegistry = args.npmRegistry || process.env.OPENCODE_NPM_REGISTRY || "";
+
+  const home = os.homedir();
+  const opencodeDir = path.join(home, ".config", "opencode");
+  const pluginsDir = path.join(opencodeDir, "plugins");
+  const pkgDir = path.join(opencodeDir, "node_modules", "opencode-plugin-langfuse");
+  const pkgJsonPath = path.join(pkgDir, "package.json");
+  const pluginDest = path.join(pluginsDir, "opencode-plugin-langfuse");
+  const opencodeJsonPath = path.join(opencodeDir, "opencode.json");
+
+  ensureDir(opencodeDir);
+
+  console.log(`OpenCode 配置目录：${opencodeDir}`);
+
+  if (skipPluginInstall && fs.existsSync(pkgJsonPath)) {
+    console.log(`已跳过 npm install（--skip-plugin-install 且已存在）：${pkgDir}`);
+  } else {
+    console.log("安装 npm 包：opencode-plugin-langfuse …");
+    await runNpmInstallOrThrow({ opencodeDir, npmRegistry });
+  }
+
+  if (!fs.existsSync(pkgJsonPath)) {
+    throw new Error(
+      `未找到已安装包目录：${pkgDir}。请先解决上方 npm 报错，或手动在此目录执行 npm install opencode-plugin-langfuse。`
+    );
+  }
+
+  const existing = readJsonIfExists(opencodeJsonPath) ?? {};
+  // Patch the official plugin to inject userId and make behavior consistent.
+  const distIndexInNodeModules = path.join(pkgDir, "dist", "index.js");
+  if (fs.existsSync(distIndexInNodeModules)) {
+    patchDistIndexJs(distIndexInNodeModules);
+  }
+
+  console.log("Syncing plugin into ~/.config/opencode/plugins/ ...");
+  syncPluginPackageToLocalPlugins({ pkgDir, pluginDest, pluginsDir });
+  console.log(`Plugin ready at: ${pluginDest}`);
+
+  const distIndexInPlugins = path.join(pluginDest, "dist", "index.js");
+  if (fs.existsSync(distIndexInPlugins)) {
+    patchDistIndexJs(distIndexInPlugins);
+  }
+
+  // Write plugin user config to support userId injection.
+  if (userId) {
+    const cfg = writeLangfusePluginUserConfig({ userId });
+    console.log(`已更新：${cfg}`);
+  }
+
+  const langfusePluginPath = "./plugins/opencode-plugin-langfuse";
+  const basePlugins = removePlugins(existing.plugin, [
+    "opencode-plugin-langfuse-userid",
+    "opencode-plugin-langfuse",
+    langfusePluginPath
+  ]);
+  const desired = {
+    experimental: {
+      openTelemetry: true
+    },
+    plugin: mergePluginList(basePlugins, langfusePluginPath)
+  };
+  const merged = deepMerge(existing, desired);
+  writeJsonPretty(opencodeJsonPath, merged);
+  let realOpencodeCli = resolveOpencodeCli(args.cmd);
+  const shimDir = path.join(opencodeDir, "bin");
   if (realOpencodeCli) {
     const relativeToShim = path.relative(path.resolve(shimDir), path.resolve(realOpencodeCli));
     if (relativeToShim && !relativeToShim.startsWith("..") && !path.isAbsolute(relativeToShim)) {
-      realOpencodeCli = "";
+      realOpencodeCli = readRealOpencodeFromManagedShim(realOpencodeCli);
     }
   }
-  console.log(`已更新：${opencodeJsonPath}`);
-
-  const launcher = writeWindowsLauncherCmd(opencodeDir, { publicKey, secretKey, baseUrl, userId });
-  if (launcher) {
-    console.log(`已生成快捷启动脚本（含 LANGFUSE 环境变量）：${launcher}`);
-    console.log("若不从当前终端启动，也可双击或用该脚本启动 OpenCode（避免插件读不到密钥）。");
-  }
-  const unixLauncher = writeUnixLauncherSh(opencodeDir, { publicKey, secretKey, baseUrl, userId });
-  if (unixLauncher) {
-    console.log(`已生成启动脚本（含 LANGFUSE 环境变量）：${unixLauncher}`);
-    printCommandHint("如果新终端仍读不到环境变量，可运行：", unixLauncher);
-  }
-
-  let opencodeShim = null;
-  if (realOpencodeCli) {
-    opencodeShim = writeOpencodeCommandShim(opencodeDir, { publicKey, secretKey, baseUrl, userId, realOpencodeCli });
-    console.log(`OpenCode command shim ready: ${opencodeShim.shim}`);
-    console.log(`Real OpenCode CLI: ${realOpencodeCli}`);
-  } else {
-    console.log("OpenCode CLI not found; skipped opencode command shim.");
-  }
-
-  let shellConfigPathWritten = "";
-  if (setEnv) {
-    if (process.platform === "win32") {
-      console.log("写入用户级环境变量：LANGFUSE_PUBLIC_KEY / LANGFUSE_SECRET_KEY / LANGFUSE_BASEURL …");
-      setWindowsUserEnv({ publicKey, secretKey, baseUrl: baseUrl });
-      if (userId) {
-        const cmd = [
-          "$ErrorActionPreference = 'Stop';",
-          `[Environment]::SetEnvironmentVariable('LANGFUSE_USER_ID', ${psQuote(userId)}, 'User');`
-        ].join(" ");
-        spawnSync("powershell", ["-NoProfile", "-Command", cmd], { stdio: "inherit", encoding: "utf8" });
-      }
-      if (opencodeShim?.shimDir) {
-        prependWindowsUserPath(opencodeShim.shimDir);
-        console.log(`已将 OpenCode Langfuse shim 加入用户 PATH：${opencodeShim.shimDir}`);
-      }
-      console.log("提示：新开一个终端后环境变量才会对应用生效。");
-    } else {
-      console.log("正在写入环境变量到 shell 配置文件 …");
-      const configPath = updateShellConfig({ publicKey, secretKey, baseUrl, userId, pathPrepend: opencodeShim?.shimDir || "" });
-      shellConfigPathWritten = configPath;
-      console.log(`已更新：${configPath}`);
-
-      // 自动 source 配置文件
-      console.log("正在 source 配置文件使环境变量生效 …");
-      const r = spawnSync("bash", ["-c", `source "${configPath}" && env | grep -E '^LANGFUSE_'`], {
-        encoding: "utf8",
-        stdio: "pipe"
-      });
-      if (r.status === 0) {
-        console.log("环境变量已生效：");
-        console.log(r.stdout);
-      } else {
-        printCommandHint("提示：环境变量已写入配置文件，请运行以下命令使其生效：", `source ${configPath}`);
-      }
-    }
-  }
-
-  console.log(paint("完成。", colors.green, colors.bold));
-  const runtimeState = writeRuntimeInstallRecord("opencode", {
-    packageName: packageJson.name,
-    packageVersion: packageJson.version,
-  });
-  console.log(`Runtime version recorded: ${runtimeState}`);
-  printCommandHint("可运行以下命令校验：", "npx oh-langfuse@latest check opencode");
-  if (process.platform !== "win32") {
-    console.log("");
-    console.log("Important for WSL/Linux:");
-    console.log("This installer wrote LANGFUSE_* to your shell rc file, but it cannot update an already-open parent shell.");
-    if (shellConfigPathWritten) {
-      printCommandHint("Before starting OpenCode from this same terminal, run:", `source ${shellConfigPathWritten}`);
-    }
-    if (unixLauncher) {
-      printCommandHint("Or start OpenCode with the generated launcher:", unixLauncher);
-    }
-    console.log("Opening a new WSL terminal also loads the variables for normal shell setups.");
-  }
-}
-
-try {
-  await main();
-} catch (e) {
-  console.error(e?.message || String(e));
-  process.exit(1);
-}
+  console.log(`已更新：${opencodeJsonPath}`);
+
+  const launcher = writeWindowsLauncherCmd(opencodeDir, { publicKey, secretKey, baseUrl, userId });
+  if (launcher) {
+    console.log(`已生成快捷启动脚本（含 LANGFUSE 环境变量）：${launcher}`);
+    console.log("若不从当前终端启动，也可双击或用该脚本启动 OpenCode（避免插件读不到密钥）。");
+  }
+  const unixLauncher = writeUnixLauncherSh(opencodeDir, { publicKey, secretKey, baseUrl, userId });
+  if (unixLauncher) {
+    console.log(`已生成启动脚本（含 LANGFUSE 环境变量）：${unixLauncher}`);
+    printCommandHint("如果新终端仍读不到环境变量，可运行：", unixLauncher);
+  }
+
+  let opencodeShim = null;
+  if (realOpencodeCli) {
+    opencodeShim = writeOpencodeCommandShim(opencodeDir, { publicKey, secretKey, baseUrl, userId, realOpencodeCli });
+    console.log(`OpenCode command shim ready: ${opencodeShim.shim}`);
+    console.log(`Real OpenCode CLI: ${realOpencodeCli}`);
+  } else {
+    console.log("OpenCode CLI not found; skipped opencode command shim.");
+  }
+
+  let shellConfigPathWritten = "";
+  if (setEnv) {
+    if (process.platform === "win32") {
+      console.log("写入用户级环境变量：LANGFUSE_PUBLIC_KEY / LANGFUSE_SECRET_KEY / LANGFUSE_BASEURL …");
+      setWindowsUserEnv({ publicKey, secretKey, baseUrl: baseUrl });
+      if (userId) {
+        const cmd = [
+          "$ErrorActionPreference = 'Stop';",
+          `[Environment]::SetEnvironmentVariable('LANGFUSE_USER_ID', ${psQuote(userId)}, 'User');`
+        ].join(" ");
+        spawnSync("powershell", ["-NoProfile", "-Command", cmd], { stdio: "inherit", encoding: "utf8" });
+      }
+      if (opencodeShim?.shimDir) {
+        prependWindowsUserPath(opencodeShim.shimDir);
+        console.log(`已将 OpenCode Langfuse shim 加入用户 PATH：${opencodeShim.shimDir}`);
+      }
+      console.log("提示：新开一个终端后环境变量才会对应用生效。");
+    } else {
+      console.log("正在写入环境变量到 shell 配置文件 …");
+      const configPath = updateShellConfig({ publicKey, secretKey, baseUrl, userId, pathPrepend: opencodeShim?.shimDir || "" });
+      shellConfigPathWritten = configPath;
+      console.log(`已更新：${configPath}`);
+
+      // 自动 source 配置文件
+      console.log("正在 source 配置文件使环境变量生效 …");
+      const r = spawnSync("bash", ["-c", `source "${configPath}" && env | grep -E '^LANGFUSE_'`], {
+        encoding: "utf8",
+        stdio: "pipe"
+      });
+      if (r.status === 0) {
+        console.log("环境变量已生效：");
+        console.log(r.stdout);
+      } else {
+        printCommandHint("提示：环境变量已写入配置文件，请运行以下命令使其生效：", `source ${configPath}`);
+      }
+    }
+  }
+
+  console.log(paint("完成。", colors.green, colors.bold));
+  const runtimeState = writeRuntimeInstallRecord("opencode", {
+    packageName: packageJson.name,
+    packageVersion: packageJson.version,
+  });
+  console.log(`Runtime version recorded: ${runtimeState}`);
+  printCommandHint("可运行以下命令校验：", "npx oh-langfuse@latest check opencode");
+  if (process.platform !== "win32") {
+    console.log("");
+    console.log("Important for WSL/Linux:");
+    console.log("This installer wrote LANGFUSE_* to your shell rc file, but it cannot update an already-open parent shell.");
+    if (shellConfigPathWritten) {
+      printCommandHint("Before starting OpenCode from this same terminal, run:", `source ${shellConfigPathWritten}`);
+    }
+    if (unixLauncher) {
+      printCommandHint("Or start OpenCode with the generated launcher:", unixLauncher);
+    }
+    console.log("Opening a new WSL terminal also loads the variables for normal shell setups.");
+  }
+}
+
+if (!process.env.OH_LANGFUSE_REGEN_DIST) {
+  try {
+    await main();
+  } catch (e) {
+    console.error(e?.message || String(e));
+    process.exit(1);
+  }
+}