@myskyline_ai/ccdebug 0.2.6 → 0.2.8

package/dist/cli.js

@@ -76,13 +76,15 @@ ${exports.colors.yellow}选项:${exports.colors.reset}
   --serve, --log, -l  启动站点，查看claude code日志
   --run-with         将后续所有参数传递给 Claude 进程
   --claude-path      指定 Claude 二进制文件或cli.js的路径
+  --trace            启用HTTP请求跟踪（默认不跟踪）
   --version, -v      显示版本信息
   --help, -h         显示此帮助信息
 
 ${exports.colors.yellow}模式:${exports.colors.reset}
   ${exports.colors.green}交互式日志:${exports.colors.reset}
-  ccdebug   启动带流量日志的 Claude
-  ccdebug --run-with -p "请按要求工作" --verbose  使用特定命令运行 Claude
+  ccdebug               启动 Claude（不进行跟踪）
+  ccdebug --trace       启动 Claude 并跟踪 HTTP 请求
+  ccdebug --trace --run-with -p "请按要求工作" --verbose  使用特定命令运行 Claude 并跟踪请求
 
   ${exports.colors.green}Web 服务器:${exports.colors.reset}
   ccdebug --serve                            启动站点，查看claude code日志
@@ -97,7 +99,7 @@ ${exports.colors.yellow}模式:${exports.colors.reset}
 
 ${exports.colors.yellow}输出:${exports.colors.reset}
   cc标准日志: ${exports.colors.green}.claude-trace/cclog/*.jsonl${exports.colors.reset}
-  cc跟踪日志: ${exports.colors.green}.claude-trace/tracelog/*.jsonl${exports.colors.reset}
+  cc跟踪日志: ${exports.colors.green}.claude-trace/tracelog/*.jsonl${exports.colors.reset} ${exports.colors.yellow}(仅在--trace参数下创建)${exports.colors.reset}
 
 更多信息请访问: https://github.com/myskyline_ai/ccdebug
 `);
@@ -319,8 +321,8 @@ function getLoaderPath() {
     return loaderPath;
 }
 // Scenario 1: No args -> launch node with interceptor and absolute path to claude
-async function runClaudeWithInterception(claudeArgs = [], includeAllRequests = false, openInBrowser = false, customClaudePath, logBaseName) {
-    log("启动 Claude 并记录流量日志", "blue");
+async function runClaudeWithInterception(claudeArgs = [], includeAllRequests = false, openInBrowser = false, customClaudePath, logBaseName, enableTrace = false) {
+    log("启动 Claude", "blue");
     if (claudeArgs.length > 0) {
         log(`Claude 参数: ${claudeArgs.join(" ")}`, "blue");
     }
@@ -329,7 +331,12 @@ async function runClaudeWithInterception(claudeArgs = [], includeAllRequests = f
     let child;
     if (isNodeScript(claudePath)) {
         // Node.js 脚本方式：使用原有的 --require 方式
-        log("使用 Node.js 拦截方法", "blue");
+        if (enableTrace) {
+            log("使用 Node.js 拦截方法（已启用跟踪）", "blue");
+        }
+        else {
+            log("使用 Node.js 启动 Claude（未启用跟踪）", "blue");
+        }
         const loaderPath = getLoaderPath();
         const spawnArgs = ["--require", loaderPath, claudePath, ...claudeArgs];
         child = (0, child_process_1.spawn)("node", spawnArgs, {
@@ -338,6 +345,7 @@ async function runClaudeWithInterception(claudeArgs = [], includeAllRequests = f
                 NODE_OPTIONS: "--no-deprecation",
                 CLAUDE_TRACE_INCLUDE_ALL_REQUESTS: includeAllRequests ? "true" : "false",
                 CLAUDE_TRACE_OPEN_BROWSER: openInBrowser ? "true" : "false",
+                CLAUDE_TRACE_ENABLED: enableTrace ? "true" : "false",
                 ...(logBaseName ? { CLAUDE_TRACE_LOG_NAME: logBaseName } : {}),
             },
             stdio: "inherit",
@@ -350,8 +358,7 @@ async function runClaudeWithInterception(claudeArgs = [], includeAllRequests = f
         log("⚠️  警告: 检测到原生二进制文件", "yellow");
         log("CCDebug 无法拦截来自 Claude Code 原生二进制版本的 API 请求，调试功能将无法工作", "yellow");
         log("要使用 CCDebug 的完整调试功能，请改用 NPM 版本的 Claude Code。", "yellow");
-        console.log("");
-        log("正在启动 Claude（不进行 API 拦截）...", "blue");
+        log("启动 Claude（不进行 API 拦截）...", "blue");
         console.log("");
         // 给用户一点时间阅读提示信息
         await new Promise(resolve => setTimeout(resolve, 500));
@@ -366,7 +373,12 @@ async function runClaudeWithInterception(claudeArgs = [], includeAllRequests = f
     }
     // Node.js 模式显示成功消息
     if (isNodeScript(claudePath)) {
-        log("流量日志记录器启动成功", "green");
+        if (enableTrace) {
+            log("流量日志记录器启动成功", "green");
+        }
+        else {
+            log("Claude 启动成功（未启用跟踪）", "green");
+        }
         console.log("");
     }
     // Handle child process events
@@ -588,6 +600,8 @@ async function main() {
         showHelp();
         process.exit(0);
     }
+    // Check for trace flag
+    const enableTrace = claudeTraceArgs.includes("--trace");
     // Check for include all requests flag
     const includeAllRequests = claudeTraceArgs.includes("--include-all-requests");
     // Check for no-open flag (inverted logic - open by default)
@@ -665,7 +679,7 @@ async function main() {
         return;
     }
     // Scenario 1: No args (or claude with args) -> launch claude with interception
-    await runClaudeWithInterception(claudeArgs, includeAllRequests, openInBrowser, customClaudePath, logBaseName);
+    await runClaudeWithInterception(claudeArgs, includeAllRequests, openInBrowser, customClaudePath, logBaseName, enableTrace);
 }
 main().catch((error) => {
     const err = error;

package/dist/interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../src/interceptor.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,iBAAiB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC/C;AAED,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,MAAM,GAAE,iBAAsB;IA6C1C,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,sBAAsB;YAgChB,aAAa;YAKb,gBAAgB;YAsBhB,iBAAiB;IAwBxB,aAAa,IAAI,IAAI;IAKrB,eAAe,IAAI,IAAI;IA0FvB,kBAAkB,IAAI,IAAI;IA8CjC,OAAO,CAAC,oBAAoB;IAuE5B,OAAO,CAAC,mBAAmB;YAab,2BAA2B;YAiB3B,cAAc;YASd,YAAY;IAcnB,OAAO,IAAI,IAAI;IA4CtB,OAAO,CAAC,mBAAmB;IA0C3B,OAAO,CAAC,aAAa;IA4DrB,OAAO,CAAC,6BAA6B;IAkB9B,QAAQ;;;;;;CAQf;AAQD,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,mBAAmB,CA8BrF;AAED,wBAAgB,SAAS,IAAI,mBAAmB,GAAG,IAAI,CAEtD"}
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../src/interceptor.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,iBAAiB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC/C;AAED,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,MAAM,GAAE,iBAAsB;IAmE1C,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,sBAAsB;YAgChB,aAAa;YAKb,gBAAgB;YAsBhB,iBAAiB;IAwBxB,aAAa,IAAI,IAAI;IAKrB,eAAe,IAAI,IAAI;IA+FvB,kBAAkB,IAAI,IAAI;IAmDjC,OAAO,CAAC,oBAAoB;IAuE5B,OAAO,CAAC,mBAAmB;YAab,2BAA2B;YAiB3B,cAAc;YAcd,YAAY;IAmBnB,OAAO,IAAI,IAAI;IAiDtB,OAAO,CAAC,mBAAmB;IA+C3B,OAAO,CAAC,aAAa;IAiErB,OAAO,CAAC,6BAA6B;IAuB9B,QAAQ;;;;;;CAQf;AAQD,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,mBAAmB,CA8BrF;AAED,wBAAgB,SAAS,IAAI,mBAAmB,GAAG,IAAI,CAEtD"}

package/dist/interceptor.js

@@ -14,6 +14,26 @@ class ClaudeTrafficLogger {
     constructor(config = {}) {
         this.pendingRequests = new Map();
         this.pairs = [];
+        // 检查是否启用了跟踪
+        const traceEnabled = process.env.CLAUDE_TRACE_ENABLED === "true";
+        if (!traceEnabled) {
+            // 如果未启用跟踪，则不初始化日志记录器
+            this.config = {
+                logDirectory: ".claude-trace",
+                enableRealTimeHTML: false,
+                logLevel: "info",
+                ...config,
+            };
+            // 不创建目录和文件
+            this.traceHomeDir = "";
+            this.traceLogDir = "";
+            this.traceLogFile = "";
+            this.ccLogDir = "";
+            this.ccLogFile = "";
+            this.htmlFile = "";
+            this.htmlGenerator = new html_generator_1.HTMLGenerator();
+            return;
+        }
         this.config = {
             logDirectory: ".claude-trace",
             enableRealTimeHTML: false,
@@ -154,6 +174,10 @@ class ClaudeTrafficLogger {
         this.instrumentNodeHTTP();
     }
     instrumentFetch() {
+        // 检查是否启用了跟踪
+        if (!this.traceLogFile) {
+            return;
+        }
         if (!global.fetch) {
             // Silent - fetch not available
             return;
@@ -226,6 +250,10 @@ class ClaudeTrafficLogger {
         // Silent initialization
     }
     instrumentNodeHTTP() {
+        // 检查是否启用了跟踪
+        if (!this.traceLogFile) {
+            return;
+        }
         try {
             const http = require("http");
             const https = require("https");
@@ -352,6 +380,10 @@ class ClaudeTrafficLogger {
         }
     }
     async writePairToLog(pair) {
+        // 检查是否启用了跟踪
+        if (!this.traceLogFile) {
+            return;
+        }
         try {
             const jsonLine = JSON.stringify(pair) + "\n";
             fs_1.default.appendFileSync(this.traceLogFile, jsonLine);
@@ -361,6 +393,10 @@ class ClaudeTrafficLogger {
         }
     }
     async generateHTML() {
+        // 检查是否启用了跟踪
+        if (!this.htmlFile) {
+            return;
+        }
         try {
             const includeAllRequests = process.env.CLAUDE_TRACE_INCLUDE_ALL_REQUESTS === "true";
             await this.htmlGenerator.generateHTML(this.pairs, this.htmlFile, {
@@ -375,6 +411,10 @@ class ClaudeTrafficLogger {
         }
     }
     cleanup() {
+        // 检查是否启用了跟踪
+        if (!this.traceLogFile) {
+            return;
+        }
         console.log("Cleaning up orphaned requests...");
         for (const [, requestData] of this.pendingRequests.entries()) {
             const orphanedPair = {
@@ -413,6 +453,10 @@ class ClaudeTrafficLogger {
         // }
     }
     getSessionIdFromLog() {
+        // 检查是否启用了跟踪
+        if (!this.traceLogFile) {
+            return '';
+        }
         // Check if log file exists
         if (!fs_1.default.existsSync(this.traceLogFile)) {
             console.log("获取sessionId错误：Log file does not exist");
@@ -447,6 +491,10 @@ class ClaudeTrafficLogger {
         return sessionMatch[1];
     }
     copyCClogFile(sessionId) {
+        // 检查是否启用了跟踪
+        if (!this.ccLogDir) {
+            return;
+        }
         //将当前会话对应的cc日志文件，拷贝到.claude-trace/cclog目录
         try {
             // 创建LogFileManager实例
@@ -497,6 +545,10 @@ class ClaudeTrafficLogger {
         }
     }
     renameTraceLogFileBySessionId(sessionId) {
+        // 检查是否启用了跟踪
+        if (!this.traceLogFile) {
+            return;
+        }
         try {
             const logDir = path_1.default.dirname(this.traceLogFile);
             const newLogFile = path_1.default.join(logDir, `${sessionId}.jsonl`);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@myskyline_ai/ccdebug",
-	"version": "0.2.6",
+	"version": "0.2.8",
 	"description": "跟踪记录CC请求，可针对特定请求反复调试验证，以更直观的时间线形式展示CC日志",
 	"publishConfig": {
 		"access": "public"