oh-langfuse 0.1.34 → 0.1.36

package/README.md

@@ -2,7 +2,7 @@
 
 `oh-langfuse` 是用于给 Claude Code、OpenCode 和 Codex 配置 Langfuse 追踪的命令行工具。它提供交互式安装向导，也支持 `setup` / `check` 直接命令，方便在用户机器上安装、修复和校验配置。
 
-当前 npm 版本：`0.1.34`
+当前 npm 版本：`0.1.36`
 
 ## 能做什么
 
@@ -40,7 +40,7 @@ npx oh-langfuse@latest check codex
 
 OpenCode 生成的 `launch-opencode-langfuse.*` 会在启动 agent 前执行一次更新检测：如果 npm 上的 `oh-langfuse@latest` 高于本机 runtime 版本，会提示是否更新；用户确认后才会运行 `npx oh-langfuse@latest update opencode`。Claude Code 和 Codex 也会生成对应 launcher：
 
-OpenCode setup 还会生成 `~/.config/opencode/bin/opencode` / `opencode.cmd` 命令包装器，并把该目录写入用户 PATH。新开终端后直接运行 `opencode`，也会先检测 `oh-langfuse` runtime 是否需要更新，再转发到真实 OpenCode CLI。
+OpenCode setup 还会生成 `~/.config/opencode/bin/opencode` / `opencode.cmd` 命令包装器，并把该目录写入用户 PATH。新开终端后直接运行 `opencode`，会先检测 `oh-langfuse` runtime 是否需要更新，再转发到真实 OpenCode CLI。为了避免 Windows 下在 agent 启动链路里嵌套运行 npm installer 导致启动崩溃，`opencode` 命令只做检测和提示；需要更新时请关闭 agent 后运行提示中的 `npx oh-langfuse@latest update opencode`。
 
 - `~/.claude/launch-claude-langfuse.cmd` / `~/.claude/launch-claude-langfuse.sh`
 - `~/.codex/launch-codex-langfuse.cmd` / `~/.codex/launch-codex-langfuse.sh`
@@ -55,22 +55,23 @@ npx oh-langfuse@latest auto-update codex
 
 ## Skill 使用量统计
 
-工具会为每次识别到的 skill 使用额外写入一条 observation：
+工具会为每次识别到的 skill 使用额外写入一条通用 observation，skill 名称放在 metadata 中：
 
 ```text
-Skill Use / <skill_name>
+Observation Name: Skill Use
+metadata.skill_name: <skill_name>
+metadata.skill_use_count: 1
 ```
 
-Dashboard 中统计各 skill 使用量可配置：
+Dashboard 中统计全部 skill 使用量可配置：
 
 ```text
 View: Observations
 Metric: Count
-Filter: Observation Name contains Skill Use /
-Breakdown Dimension: Observation Name
+Filter: Observation Name equals Skill Use
 ```
 
-`AI Interaction` 仍然保留 `skill_use_count`、`skill_names`、`skill_names_json` 和 `skill_names_csv`，用于查看单次交互的效率汇总。为避免极端情况下产生过多 observation，OpenCode 每次交互最多记录 20 个去重后的 skill 使用事件。
+如果当前 Langfuse Dashboard 支持 metadata 维度，可用 `metadata.skill_name` 做 Breakdown 来看各 skill 使用量；否则可用 Metrics API 或导出数据按 `metadata.skill_name` 聚合。`AI Interaction` 仍然保留 `skill_use_count`、`skill_names`、`skill_names_json` 和 `skill_names_csv`，用于查看单次交互的效率汇总。为避免极端情况下产生过多 observation，OpenCode 每次交互最多记录 20 个去重后的 skill 使用事件。
 
 本地开发运行：
 

package/codex_langfuse_notify.py

@@ -655,7 +655,7 @@ def emit_codex_turn(
 
             for skill in skill_usages:
                 with langfuse.start_as_current_observation(
-                    name=f"Skill Use / {skill['name']}",
+                    name="Skill Use",
                     metadata={
                         "source": "codex",
                         "user_id": user_id or "",

package/langfuse_hook.py

@@ -689,7 +689,7 @@ def emit_turn(
 
             for skill in skill_usages:
                 with langfuse.start_as_current_observation(
-                    name=f"Skill Use / {skill['name']}",
+                    name="Skill Use",
                     metadata={
                         "source": "claude",
                         "user_id": user_id or "",

package/package.json

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

package/scripts/auto-update-runtime.mjs

@@ -86,6 +86,13 @@ async function main() {
   const message = installedVersion
     ? `oh-langfuse ${target} runtime update available: ${installedVersion} -> ${latest}.`
     : `oh-langfuse ${target} runtime may need update. Latest package: ${latest}.`;
+  const updateCommand = `npx oh-langfuse@latest update ${target}`;
+
+  if (args["notify-only"] || args.notifyOnly) {
+    console.log(`[INFO] ${message}`);
+    console.log(`[INFO] To update safely, close the agent and run: ${updateCommand}`);
+    return 0;
+  }
 
   if (args.yes || args.y) {
     console.log(`[INFO] ${message}`);
@@ -94,7 +101,7 @@ async function main() {
   }
 
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    console.log(`[INFO] ${message} Run: npx oh-langfuse@latest update ${target}`);
+    console.log(`[INFO] ${message} Run: ${updateCommand}`);
     return 0;
   }
 

package/scripts/opencode-langfuse-setup.mjs

@@ -468,7 +468,7 @@ function getPatchedLangfuseDistIndexJs() {
     "  };",
     "  const emitSkillUseSpans = ({ skillNames, sessionId, messageId, interactionId }) => {",
     "    for (const skillName of skillNames.slice(0, MAX_SKILL_USE_SPANS_PER_INTERACTION)) {",
-    "      const span = metricsTracer.startSpan(`Skill Use / ${skillName}`);",
+    "      const span = metricsTracer.startSpan('Skill Use');",
     '      span.setAttribute("oh.langfuse.source", "opencode");',
     '      span.setAttribute("oh.langfuse.user_id", userId || "");',
     '      span.setAttribute("oh.langfuse.metrics_schema_version", "1.0");',
@@ -595,7 +595,7 @@ function writeWindowsLauncherCmd(opencodeDir, { publicKey, secretKey, baseUrl, u
   if (userId) cmd.push(`set LANGFUSE_USER_ID=${userId}`);
   cmd.push("where npx >nul 2>nul");
   cmd.push("if %ERRORLEVEL% EQU 0 (");
-  cmd.push("  call npx -y oh-langfuse@latest auto-update opencode --skip-check");
+  cmd.push("  call npx -y oh-langfuse@latest auto-update opencode --skip-check --notify-only");
   cmd.push(")");
   cmd.push('if exist "%USERPROFILE%\\.opencode\\bin\\opencode.exe" (');
   cmd.push('  "%USERPROFILE%\\.opencode\\bin\\opencode.exe" %*');
@@ -623,7 +623,7 @@ function writeOpencodeCommandShim(opencodeDir, { publicKey, secretKey, baseUrl,
     if (userId) cmd.push(`set LANGFUSE_USER_ID=${userId}`);
     cmd.push("where npx >nul 2>nul");
     cmd.push("if %ERRORLEVEL% EQU 0 (");
-    cmd.push("  call npx -y oh-langfuse@latest auto-update opencode --skip-check");
+    cmd.push("  call npx -y oh-langfuse@latest auto-update opencode --skip-check --notify-only");
     cmd.push(")");
     cmd.push(`call ${cmdQuote(realOpencodeCli)} %*`);
     cmd.push("exit /b %ERRORLEVEL%");
@@ -642,7 +642,7 @@ function writeOpencodeCommandShim(opencodeDir, { publicKey, secretKey, baseUrl,
     `export LANGFUSE_BASEURL=${shQuote(baseUrl)}`,
     userId ? `export LANGFUSE_USER_ID=${shQuote(userId)}` : null,
     'if command -v npx >/dev/null 2>&1; then',
-    '  npx -y oh-langfuse@latest auto-update opencode --skip-check || true',
+    '  npx -y oh-langfuse@latest auto-update opencode --skip-check --notify-only || true',
     "fi",
     `exec ${shQuote(realOpencodeCli)} "$@"`,
     ""
@@ -664,7 +664,7 @@ function writeUnixLauncherSh(opencodeDir, { publicKey, secretKey, baseUrl, userI
     `export LANGFUSE_BASEURL=${shQuote(baseUrl)}`,
     userId ? `export LANGFUSE_USER_ID=${shQuote(userId)}` : null,
     'if command -v npx >/dev/null 2>&1; then',
-    '  npx -y oh-langfuse@latest auto-update opencode --skip-check || true',
+    '  npx -y oh-langfuse@latest auto-update opencode --skip-check --notify-only || true',
     "fi",
     'if [ -x "$HOME/.opencode/bin/opencode" ]; then',
     '  exec "$HOME/.opencode/bin/opencode" "$@"',
@@ -980,7 +980,14 @@ async function main() {
   };
   const merged = deepMerge(existing, desired);
   writeJsonPretty(opencodeJsonPath, merged);
-  const realOpencodeCli = resolveOpencodeCli(args.cmd);
+  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 = "";
+    }
+  }
   console.log(`已更新：${opencodeJsonPath}`);
 
   const launcher = writeWindowsLauncherCmd(opencodeDir, { publicKey, secretKey, baseUrl, userId });