ronds_ai 0.1.24 → 0.1.26

package/README.md

@@ -174,30 +174,34 @@ Codex 输出示例：
 
 ### `analyze`
 
-从 Claude Code 的会话 transcript 增量生成 Langfuse 轨迹：
+从 Claude Code 的会话 transcript 生成一次性会话摘要：
 
 ```bash
 ronds_ai analyze claude
 ```
 
-该命令用于 `Stop` 和 `SessionEnd` Hook，会由 `hooks deploy` 自动安装（project 或 user scope，未用 `--tool` 排除 claude 时）。它会在 Langfuse 中记录：
+该命令仅用于 `SessionEnd` Hook，会由 `hooks deploy` 自动安装（project 或 user scope，未用 `--tool` 排除 claude 时）。它只上报：
 
-- 每个对话 Turn 的根 Span
-- 每次 Assistant 消息对应的 LLM Generation 和 Token usage
-- Tool 调用的输入、输出和时间
-- Skill 标签及可选的 Skill 注入内容
-- 一层 Subagent 的 Generation 和 Tool 轨迹
+- 会话起止时间与有效用户轮数
+- Skill 名称及调用次数
+- 首轮输入的最多 150 个字符预览
+- repo、branch、worker_id 和 Git 身份
 
-行为与 Langfuse Claude Observability Plugin 一致，只采集 transcript 中的 `text`、`tool_use` 和 `tool_result`，不上传 `thinking` block。状态和日志保存在 `~/.ronds_ai/analyze/`。
+扫描采用流式 JSONL 读取，内存不会随 transcript 大小增长，不上传逐轮内容或代码。
+
+每次 Hook 调用仅生成一条会话级结构化快照；网络失败时写入有界队列，后续 Hook 最多补发少量旧快照。内部部署仅保留用户、会话、项目目录等必要定位字段。
+
+运行期间只写一个轻量 active 标记，结束时一次性转换为 `~/.ronds_ai/analyze/` 下的待补传 spool。网络失败不会影响 Hook 主流程，并按 5、15、60 分钟退避补传；平台按 `diagnostic_event_id` 幂等去重。可选配置：
+
+- `ANALYZE_DIAGNOSTICS_URL`：覆盖诊断事件上报地址
+- `ANALYZE_DIAGNOSTICS_TOKEN`：诊断入口的 Bearer Token
+- `ANALYZE_DIAGNOSTICS_TIMEOUT_MS`：单次补传超时，默认 `400`
 
-Langfuse 连接信息已内置，Trace 的 `userId` 优先使用当前项目的 `git user.email`，读取不到时回退到当前操作系统用户名。可选配置：
+会话入口地址默认为本机 API，也可按部署环境覆盖：
 
-- `CC_LANGFUSE_DEBUG=true`：启用详细日志
-- `CC_LANGFUSE_MAX_CHARS=<正整数>`：单个文本字段的最大字符数，默认 `20000`
-- `CC_LANGFUSE_SKILL_TAGS=false`：关闭 `skill:<name>` 标签
-- `CC_LANGFUSE_CAPTURE_SKILL_CONTENT=true`：把 Skill 注入内容写入 Tool 输出
+- `AI_USAGE_SESSIONS_URL`：会话摘要 API 地址
 
-`hooks deploy` 会自动把以下条目写入 Claude Code 的 hooks 配置；如需手动配置可参考。注意停用其他 Langfuse Claude 插件以避免重复上传：
+`hooks deploy` 会自动把以下条目写入 Claude Code 的 hooks 配置：
 
 ```json
 {
@@ -236,29 +240,33 @@ Node.js 低于 20 或安装时使用了 `--omit=optional` 时，只有 `analyze`
 ronds_ai doctor <tool>
 ```
 
-支持的 `tool`：
-
-- `claude`
+支持的 `tool`：
+
+- `analyze`
+- `claude`
 - `codex`
 - `cursor`
 - `hermes`
 
 示例：
 
-```bash
-npx ronds_ai@latest doctor claude
+```bash
+npx ronds_ai@latest doctor analyze
+npx ronds_ai@latest doctor claude
 npx ronds_ai@latest doctor codex
 npx ronds_ai@latest doctor cursor
 npx ronds_ai@latest doctor hermes
 ```
 
-输出内容包括：
+输出内容包括：
 
 - 当前检查的工具类型
 - 当前目标目录
 - 当前目录下的 `git user.email`
 - 关键配置文件是否存在
-- 今天的最近错误日志内容
+- 今天的最近错误日志内容
+
+`doctor analyze` 还会检查 Node.js 版本、用户级 `SessionEnd` Hook、工号和 Git 用户身份，以及本地待补传会话数量。它只做只读探测，不会发送会话数据。
 
 Claude 会检查：
 
@@ -297,14 +305,14 @@ npx ronds_ai@latest hooks deploy --scope user
 默认 scope 为 `project`（项目级部署），行为：
 
 - 写入或更新 `.cursor/hooks.json`
-- 写入或更新 `.claude/settings.json`（`PostToolUse` 的 `record claude` 采集 hook，以及 `Stop`、`SessionEnd` 的 `analyze claude` Langfuse 轨迹 hook；Node 低于 20 时跳过 analyze 并在输出 `analyze` 字段说明原因）
+- 写入或更新 `.claude/settings.json`（`PostToolUse` 的 `record claude` 采集 hook，以及 `SessionEnd` 的 `analyze claude` 会话摘要 hook）
 - 清理项目内旧版 Cursor、Claude、Codex hook 脚本
 - 跳过 Codex 项目级配置部署，并在输出中说明原因
 
 `--scope user`（用户级部署），行为：
 
 - 写入或更新用户级 Cursor hook 配置
-- 写入或更新用户级 Claude hook 配置（同上：`record claude` 采集 hook + `analyze claude` 轨迹 hook）
+- 写入或更新用户级 Claude hook 配置（同上：`record claude` 采集 hook + `analyze claude` 会话摘要 hook）
 - 写入或更新系统级 `requirements.toml`（Windows: `C:\ProgramData\OpenAI\Codex\requirements.toml`，Linux / macOS: `/etc/codex/requirements.toml`），包含 `[features] hooks = true`、`[hooks]` 托管目录配置以及 `PostToolUse` 的 `apply_patch` hook
 - 清理用户目录中的旧版 hook 脚本文件
 
@@ -342,7 +350,7 @@ hooks_auto_accept: true
 - `updatedFiles`
 - `removedFiles`
 - `skipped`: 被跳过的工具及原因（仅在 project scope 下出现）
-- `analyze`: Claude Langfuse 轨迹 hook 的安装状态（`installed`、`events`、`command`；未安装时包含 `reason`）
+- `analyze`: Claude 会话摘要 hook 的安装状态（`installed`、`events`、`command`）
 
 ### Hooks Auto Sync（自动后台同步）
 
@@ -365,7 +373,7 @@ RONDS_AI_DISABLE_HOOKS_AUTO_SYNC=1
 注意：
 
 - auto-sync 只维护**用户级** hooks，不影响项目级配置
-- auto-sync 会同步维护用户级 Claude 的 `analyze claude` Langfuse 轨迹 hook
+- auto-sync 会同步维护用户级 Claude 的 `analyze claude` 会话摘要 hook
 - 后台同步失败时，错误记录到 `~/.ronds_ai/hooks_auto_sync_error.log`，不污染当前命令输出
 - 首次安装 hooks 仍建议执行 `ronds_ai hooks deploy --scope user`
 

package/bin/ronds_ai.js

@@ -62,10 +62,10 @@ const SUPPORTED_SOURCES = new Set(['claude', 'cursor', 'codex', 'hermes']);
 
 function printUsage() {
   process.stderr.write([
-    'Usage:',
-    '  ronds_ai record <tool>',
-    '  ronds_ai analyze claude',
-    '  ronds_ai check record',
+    'Usage:',
+    '  ronds_ai record <tool>',
+    '  ronds_ai analyze claude',
+    '  ronds_ai check record',
     '  ronds_ai doctor <tool>',
     '  ronds_ai hooks deploy [--scope project|user] [--tool cursor|claude|codex]',
     '  ronds_ai hooks deploy hermes',
@@ -78,11 +78,12 @@ function printUsage() {
     '  hermes',
     '',
     'Examples:',
-    '  npx ronds_ai@latest record claude',
-    '  npx ronds_ai@latest analyze claude',
+    '  npx ronds_ai@latest record claude',
+    '  npx ronds_ai@latest analyze claude',
     '  npx ronds_ai@latest record cursor',
     '  npx ronds_ai@latest check record',
-    '  npx ronds_ai@latest doctor claude',
+    '  npx ronds_ai@latest doctor claude',
+    '  npx ronds_ai@latest doctor analyze',
     '  npx ronds_ai@latest doctor cursor',
     '  npx ronds_ai@latest hooks deploy',
   '  npx ronds_ai@latest hooks deploy --scope user',
@@ -282,7 +283,7 @@ async function run() {
 
   maybeStartHooksAutoSync({ command, args });
 
-  if (command === 'record') {
+  if (command === 'record') {
     const [source] = args;
     const normalizedSource = String(source || '').trim().toLowerCase();
 
@@ -291,30 +292,30 @@ async function run() {
     }
 
     await runCodeRecord(normalizedSource);
-    return;
-  }
-
-  if (command === 'analyze') {
-    const [source] = args;
-    if (String(source || '').trim().toLowerCase() !== 'claude') {
-      throw new Error(`Unsupported analyze tool: ${source || ''}`);
-    }
-
-    // 仅在 analyze 分支中加载 Node 20+ 的可选 Langfuse 依赖，避免影响旧版 record。
-    const { runClaudeAnalyze } = require('../lib/analyze_claude');
-    await runClaudeAnalyze();
-    return;
-  }
-
-  if (command === 'doctor') {
+    return;
+  }
+
+  if (command === 'analyze') {
+    const [source] = args;
+    if (String(source || '').trim().toLowerCase() !== 'claude') {
+      throw new Error(`Unsupported analyze tool: ${source || ''}`);
+    }
+
+    // analyze 仅在 SessionEnd 生成会话级摘要，使用 Node 16 原生 API。
+    const { runClaudeAnalyze } = require('../lib/analyze_claude');
+    await runClaudeAnalyze();
+    return;
+  }
+
+  if (command === 'doctor') {
     const [tool] = args;
     const normalizedTool = String(tool || '').trim().toLowerCase();
 
-    if (!SUPPORTED_SOURCES.has(normalizedTool)) {
+    if (!SUPPORTED_SOURCES.has(normalizedTool) && normalizedTool !== 'analyze') {
       throw new Error(`Unsupported doctor tool: ${tool || ''}`);
     }
 
-    const result = runDoctor(normalizedTool, process.cwd());
+    const result = await runDoctor(normalizedTool, process.cwd());
     process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
     return;
   }
@@ -342,14 +343,28 @@ async function run() {
   throw new Error(`Unsupported command: ${command || ''}`);
 }
 
-run().catch((error) => {
+run().catch((error) => {
   if (error && error.code === 'ANALYZE_PREFLIGHT') {
-    process.stderr.write(`${error.message}\n`);
-    process.exitCode = 1;
-    return;
-  }
-
-  const [, , command, ...args] = process.argv;
+    // 旁路 analyze 错误时静默记录，避免干扰宿主 Hook。
+    try {
+      const fs = require('fs');
+      const os = require('os');
+      const path = require('path');
+      const analyzeDir = path.join(os.homedir(), '.ronds_ai', 'analyze');
+      fs.mkdirSync(analyzeDir, { recursive: true });
+      fs.appendFileSync(
+        path.join(analyzeDir, 'session_hook.log'),
+        `${new Date().toISOString()} [INFO] analyze preflight skipped: ${error.message}\n`,
+        'utf8',
+      );
+    } catch {
+      // 忽略日志写入错误
+    }
+    process.exitCode = 0;
+    return;
+  }
+
+  const [, , command, ...args] = process.argv;
   let savedPath = '';
 
   try {