cursor-feedback 2.5.0 → 2.6.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [2.6.0](https://github.com/jianger666/cursor-feedback-extension/compare/v2.5.0...v2.6.0) (2026-07-06)
+
+
+### Features
+
+* **diag:** server 日志落盘（按天切割/7天保留）+ 诊断包导出（端点/面板按钮/密钥脱敏/无server降级）；/help 去掉计费说明 ([91a0d67](https://github.com/jianger666/cursor-feedback-extension/commit/91a0d67346a207afdab8d2df02278c40674bfbb5))
+
 ## [2.5.0](https://github.com/jianger666/cursor-feedback-extension/compare/v2.4.1...v2.5.0) (2026-07-06)
 
 

package/README.md

@@ -291,6 +291,10 @@ Normally the server process is spawned by Cursor, so closing Cursor drops the Fe
 - **How**: the current package is copied to `~/.cursor-feedback/daemon/app` (self-contained, immune to npx cache cleanup); registered as a launchd agent on macOS (auto-restart on crash) or a logon scheduled task on Windows.
 - **Keep-awake**: while on AC power the daemon prevents system sleep (macOS `caffeinate -s`; Windows power assertion). On battery it does nothing. Lock screen never affects background processes.
 - **Typical use**: leave the machine plugged in and locked after work; `/new` from your phone anytime.
+
+### Diagnostics export
+
+Server logs are also written to `~/.cursor-feedback/logs/` (daily files, 7-day retention). Hit **Export diagnostics** in the extension's notification settings to save a single report — recent logs, environment and sanitized config (secrets are masked) — to attach to bug reports. Works even when no server is running (falls back to reading log files directly).
 - After upgrading the extension, toggle the switch off/on once to refresh the daemon's copy.
 
 ## 🏗️ Architecture

package/README_CN.md

@@ -295,6 +295,10 @@ npm install -g cursor-feedback
 - **实现**：把当前包完整拷贝到 `~/.cursor-feedback/daemon/app`（自包含，不怕 npx 缓存被清），macOS 注册 launchd（崩溃自动拉起），Windows 注册登录计划任务。
 - **防睡眠**：守护进程在接电源时自动阻止系统睡眠（macOS `caffeinate -s`；Windows 电源断言），电池供电不生效、不偷耗电。锁屏本来就不影响后台进程。
 - **典型用法**：下班插着电源锁屏走人，手机飞书随时 `/new`。
+
+### 诊断包导出
+
+server 日志会同时落盘到 `~/.cursor-feedback/logs/`（按天切割，保留 7 天）。在插件「通知设置」里点**导出诊断包**，一键保存包含最近日志、环境信息和脱敏配置（密钥打码）的报告文件，报 bug 时直接附上。即使 server 全挂了也能导（降级为直接读日志文件）。
 - 升级插件版本后重新开关一次即可更新守护进程里的拷贝。
 
 ## 🏗️ 架构

package/dist/cli-launcher.js

@@ -52,8 +52,10 @@ const child_process_1 = require("child_process");
 const fs = __importStar(require("fs"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
+const logger_js_1 = require("./logger.js");
 function clog(message) {
     console.error(`[${new Date().toISOString()}] [cli-launcher] ${message}`);
+    (0, logger_js_1.fileLog)('cli-launcher', message);
 }
 class CliLauncher {
     constructor() {

package/dist/extension.js

@@ -38,6 +38,7 @@ exports.deactivate = deactivate;
 const vscode = __importStar(require("vscode"));
 const http = __importStar(require("http"));
 const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const child_process_1 = require("child_process");
 const i18n_1 = require("./i18n");
@@ -303,6 +304,9 @@ class FeedbackViewProvider {
                 case 'toggleDaemon':
                     await this._handleToggleDaemon(!!data.payload?.enabled);
                     break;
+                case 'exportDiagnostics':
+                    await this._handleExportDiagnostics();
+                    break;
                 case 'feishuRegisterStart':
                     await this._handleFeishuRegisterStart();
                     break;
@@ -1392,6 +1396,63 @@ class FeedbackViewProvider {
             });
         }
     }
+    /**
+     * 导出诊断包：优先从活跃 server 拿完整报告（含运行时状态）；server 全挂时降级为
+     * 插件本地拼装（正好覆盖「server 起不来」这种最需要日志的场景）。存为 txt 并打开。
+     */
+    async _handleExportDiagnostics() {
+        let report = null;
+        const port = this._anyServerPort();
+        if (port) {
+            try {
+                report = await this._httpGet(`http://127.0.0.1:${port}/api/diagnostics`);
+            }
+            catch {
+                report = null;
+            }
+        }
+        if (!report) {
+            report = this._buildLocalDiagnostics();
+        }
+        const def = path.join(os.homedir(), 'Downloads', `cursor-feedback-diag-${new Date().toISOString().slice(0, 19).replace(/[T:]/g, '-')}.txt`);
+        const uri = await vscode.window.showSaveDialog({
+            defaultUri: vscode.Uri.file(def),
+            filters: { Text: ['txt'] },
+        });
+        if (!uri)
+            return;
+        await vscode.workspace.fs.writeFile(uri, Buffer.from(report, 'utf-8'));
+        const open = this._t('diagOpenAction');
+        const picked = await vscode.window.showInformationMessage(this._t('diagSaved'), open);
+        if (picked === open) {
+            await vscode.window.showTextDocument(uri);
+        }
+    }
+    /** server 全挂时的降级诊断：插件自己读日志文件 + 基本环境信息（不含 server 运行时状态） */
+    _buildLocalDiagnostics() {
+        const parts = [
+            `cursor-feedback 诊断报告（降级模式：没有活跃的 server，运行时状态缺失）  生成于 ${new Date().toISOString()}`,
+            `===== 环境 =====\nextension version: ${vscode.extensions.getExtension('jianger666.cursor-feedback')?.packageJSON?.version || '?'}\nplatform: ${process.platform} (${process.arch})\nvscode: ${vscode.version}`,
+        ];
+        try {
+            const dir = path.join(os.homedir(), '.cursor-feedback', 'logs');
+            const files = fs
+                .readdirSync(dir)
+                .filter((f) => /^\d{4}-\d{2}-\d{2}\.log$/.test(f))
+                .sort()
+                .slice(-2);
+            let text = '';
+            for (const f of files) {
+                text += `===== ${f} =====\n` + fs.readFileSync(path.join(dir, f), 'utf-8');
+            }
+            const MAX = 256 * 1024;
+            parts.push(text.length > MAX ? '…(前文截断)\n' + text.slice(text.length - MAX) : text || '（没有日志文件）');
+        }
+        catch {
+            parts.push('（没有日志文件）');
+        }
+        return parts.join('\n\n') + '\n';
+    }
     /**
      * HTTP GET 请求
      */

package/dist/feishu.js

@@ -50,8 +50,10 @@ exports.FeishuBridge = void 0;
 const fs = __importStar(require("fs"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
+const logger_js_1 = require("./logger.js");
 function flog(message) {
     console.error(`[${new Date().toISOString()}] [feishu] ${message}`);
+    (0, logger_js_1.fileLog)('feishu', message);
 }
 class FeishuBridge {
     constructor() {

package/dist/i18n/en.json

@@ -80,6 +80,11 @@
   "daemonNotSupported": "Not supported on this platform",
   "daemonFailed": "Operation failed: {error}",
   "daemonWorking": "Working…",
+  "diagLabel": "Diagnostics",
+  "diagDesc": "Export a diagnostic report (recent logs, environment and sanitized config — secrets are masked) to attach to bug reports.",
+  "diagExportBtn": "Export diagnostics",
+  "diagSaved": "Diagnostic report saved.",
+  "diagOpenAction": "Open",
   "queueSend": "Queue Message",
   "queuedTitle": "Queued messages",
   "queueModeHint": "AI is busy — messages sent now are queued and delivered when it next asks for feedback",

package/dist/i18n/index.js

@@ -171,6 +171,11 @@ function getDefaultMessages() {
         daemonNotSupported: "Not supported on this platform",
         daemonFailed: "Operation failed: {error}",
         daemonWorking: "Working…",
+        diagLabel: "Diagnostics",
+        diagDesc: "Export a diagnostic report (recent logs, environment and sanitized config — secrets are masked) to attach to bug reports.",
+        diagExportBtn: "Export diagnostics",
+        diagSaved: "Diagnostic report saved.",
+        diagOpenAction: "Open",
         queueSend: "Queue Message",
         queuedTitle: "Queued messages",
         queueModeHint: "AI is busy — messages sent now are queued and delivered when it next asks for feedback",

package/dist/i18n/zh-CN.json

@@ -80,6 +80,11 @@
   "daemonNotSupported": "当前平台暂不支持",
   "daemonFailed": "操作失败：{error}",
   "daemonWorking": "处理中…",
+  "diagLabel": "诊断信息",
+  "diagDesc": "导出诊断报告（最近日志、环境信息、脱敏后的配置——密钥不会包含在内），报 bug 时附上它。",
+  "diagExportBtn": "导出诊断包",
+  "diagSaved": "诊断报告已保存。",
+  "diagOpenAction": "打开",
   "queueSend": "排队发送",
   "queuedTitle": "排队中的消息",
   "queueModeHint": "AI 正忙，现在发送的消息会排队，等它下一轮询问时自动送达",

package/dist/logger.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fileLog = fileLog;
+exports.readRecentLogs = readRecentLogs;
+/**
+ * 落盘日志：server 侧所有日志除了打到 stderr（Cursor 的 MCP 日志），同时写入
+ * ~/.cursor-feedback/logs/YYYY-MM-DD.log，供「导出诊断包」排查用户现场问题。
+ * 设计约束：绝不能因为日志失败影响主流程（全部吞错）；日志量小，直接同步追加（崩溃不丢行）。
+ */
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/** 日志保留天数：超过的按文件名日期清理 */
+const RETENTION_DAYS = 7;
+function logsDir() {
+    return path.join(os.homedir(), '.cursor-feedback', 'logs');
+}
+/** 本地日期 YYYY-MM-DD（日志按用户本地时区的自然日切割） */
+function localDay(d = new Date()) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+}
+let cleanedForDay = '';
+/** 清理过期日志：每个进程每天最多执行一次 */
+function cleanupOldLogs(today) {
+    if (cleanedForDay === today)
+        return;
+    cleanedForDay = today;
+    try {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - RETENTION_DAYS);
+        const cutoffDay = localDay(cutoff);
+        for (const f of fs.readdirSync(logsDir())) {
+            const m = f.match(/^(\d{4}-\d{2}-\d{2})\.log$/);
+            // 文件名日期字典序即时间序；不匹配命名规则的文件不动
+            if (m && m[1] < cutoffDay) {
+                fs.rmSync(path.join(logsDir(), f), { force: true });
+            }
+        }
+    }
+    catch {
+        // 目录不存在或不可读，忽略
+    }
+}
+/** 追加一行日志到当天的文件。tag 用于区分模块（mcp / feishu / cli-launcher）。 */
+function fileLog(tag, message) {
+    try {
+        const today = localDay();
+        fs.mkdirSync(logsDir(), { recursive: true });
+        cleanupOldLogs(today);
+        const line = `[${new Date().toISOString()}] [${tag}] ${message}\n`;
+        fs.appendFileSync(path.join(logsDir(), `${today}.log`), line);
+    }
+    catch {
+        // 磁盘满/权限问题都不能影响主流程
+    }
+}
+/**
+ * 读取最近的日志尾部（今天优先，不够再补前一天），用于诊断包。
+ * 返回不超过 maxBytes 的文本。
+ */
+function readRecentLogs(maxBytes = 256 * 1024) {
+    try {
+        const files = fs
+            .readdirSync(logsDir())
+            .filter((f) => /^\d{4}-\d{2}-\d{2}\.log$/.test(f))
+            .sort()
+            .slice(-2);
+        let text = '';
+        for (const f of files) {
+            text += `===== ${f} =====\n`;
+            text += fs.readFileSync(path.join(logsDir(), f), 'utf-8');
+        }
+        return text.length > maxBytes ? '…(前文截断)\n' + text.slice(text.length - maxBytes) : text;
+    }
+    catch {
+        return '（没有日志文件）';
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/mcp-server.js

@@ -62,6 +62,7 @@ const feishu_js_1 = require("./feishu.js");
 const cli_launcher_js_1 = require("./cli-launcher.js");
 const keep_awake_js_1 = require("./keep-awake.js");
 const daemon_install_js_1 = require("./daemon-install.js");
+const logger_js_1 = require("./logger.js");
 // ⚠️ MCP stdio 协议要求 stdout 只承载 JSON-RPC 消息。第三方库（尤其飞书 SDK 的内置 logger，
 // 输出形如 "[info]: [...]"）会用 console.log/info/debug 往 stdout 打日志，一旦混入就会让
 // Cursor 端 JSON 解析失败、连接进入 failed（表现为 "Not connected"）。这里在进程最早期把这三个
@@ -74,6 +75,7 @@ console.debug = (...args) => console.error(...args);
 function debugLog(message) {
     const timestamp = new Date().toISOString();
     console.error(`[${timestamp}] ${message}`);
+    (0, logger_js_1.fileLog)('mcp', message);
 }
 // 包版本真相源：package.json（dist/mcp-server.js 的上一级目录）。读不到时兜底 0.0.0。
 const PKG_VERSION = (() => {
@@ -513,14 +515,13 @@ class McpFeedbackServer {
                 '· 默认工作目录是主目录；可在任务前指定项目：\n' +
                 '  /new /Users/me/proj 帮我修下测试\n' +
                 '  /new crm-web 帮我修下测试（项目名唯一时自动匹配到完整路径）\n' +
-                '· 非交互模式 + 强制 maxMode=false，每次会话固定只扣 1 次请求\n' +
                 '· AI 需要沟通时会发反馈卡片，直接回复即可；同时只能跑一个会话\n\n' +
                 '📁 /projects\n' +
                 '列出 Cursor 打开过的项目路径（查路径 / 复制给 /new，也可直接用项目名）\n\n' +
                 '🛑 /stop\n' +
                 '终止运行中的 CLI 会话（任何窗口拉起的都能停）\n\n' +
                 '🧠 /model [模型id]\n' +
-                '查看 / 设置会话模型（持久化；无论选什么模型都不会走 Max 计费）\n\n' +
+                '查看 / 设置会话模型（持久化）\n\n' +
                 '❓ /help\n' +
                 '看这份帮助\n\n' +
                 '💬 不带斜杠的消息照常作为反馈：回复某张卡片就送达那个请求，直接发送则给当前等待中的 AI。');
@@ -627,6 +628,64 @@ class McpFeedbackServer {
         }
         return true;
     }
+    /**
+     * 组装诊断报告（纯文本）。密钥严格脱敏：appSecret 绝不输出，appId 只留前 8 位。
+     * 每个区块独立 try/catch，单块失败不影响整包导出。
+     */
+    buildDiagnostics() {
+        const sections = [];
+        const add = (title, fn) => {
+            let body;
+            try {
+                body = fn();
+            }
+            catch (e) {
+                body = `（读取失败：${e}）`;
+            }
+            sections.push(`===== ${title} =====\n${body}`);
+        };
+        const maskId = (id) => (id.length > 8 ? id.slice(0, 8) + '***' : '***');
+        const readJson = (file) => {
+            try {
+                return JSON.parse(fs.readFileSync(path.join(os.homedir(), '.cursor-feedback', file), 'utf-8'));
+            }
+            catch {
+                return null;
+            }
+        };
+        add('环境', () => [
+            `version: ${PKG_VERSION}`,
+            `pid: ${process.pid}  uptimeSec: ${Math.round(process.uptime())}`,
+            `platform: ${process.platform} ${os.release()} (${process.arch})`,
+            `node: ${process.version}`,
+            `daemonMode: ${this.daemonMode}`,
+            `ownerWorkspace: ${this.ownerWorkspace || '(none)'}`,
+            `hasCurrentRequest: ${this.currentRequest !== null}`,
+        ].join('\n'));
+        add('飞书配置（脱敏）', () => {
+            const cfg = readJson('feishu-config.json');
+            if (!cfg)
+                return '（未配置）';
+            const safe = { ...cfg };
+            if (typeof safe.appId === 'string')
+                safe.appId = maskId(safe.appId);
+            if ('appSecret' in safe)
+                safe.appSecret = '***';
+            return JSON.stringify(safe, null, 2);
+        });
+        add('飞书绑定（appId 脱敏）', () => {
+            const bind = readJson('feishu-bind.json');
+            if (!bind)
+                return '（无）';
+            return JSON.stringify(Object.fromEntries(Object.entries(bind).map(([k, v]) => [maskId(k), v])), null, 2);
+        });
+        add('通用设置 settings.json', () => JSON.stringify(readJson('settings.json') ?? '（无）'));
+        add('CLI 设置 cli.json', () => JSON.stringify(readJson('cli.json') ?? '（无）'));
+        add('CLI 会话锁', () => JSON.stringify(readJson('cli-session.lock') ?? '（无活跃会话）'));
+        add('常驻服务状态', () => JSON.stringify((0, daemon_install_js_1.daemonStatus)(), null, 2));
+        add('最近日志（今天 + 昨天，尾部截断）', () => (0, logger_js_1.readRecentLogs)());
+        return `cursor-feedback 诊断报告  生成于 ${new Date().toISOString()}\n\n` + sections.join('\n\n') + '\n';
+    }
     /** CLI 会话结束的收尾回执：把 agent 的最终输出（尾部）发回飞书 */
     onCliSessionDone(result, chatId) {
         const mins = Math.max(1, Math.round(result.elapsedMs / 60000));
@@ -1936,6 +1995,13 @@ class McpFeedbackServer {
                         });
                         return;
                     }
+                    // 诊断包：版本/环境/配置（脱敏）/守护状态/会话锁 + 最近日志尾部，纯文本一把梭。
+                    // 插件面板「导出诊断包」按钮请求这里；轻量起见不打 zip，一个 txt 就够排查。
+                    if (req.method === 'GET' && req.url === '/api/diagnostics') {
+                        res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
+                        res.end(this.buildDiagnostics());
+                        return;
+                    }
                     // 健康检查
                     if (req.method === 'GET' && req.url === '/api/health') {
                         res.writeHead(200, { 'Content-Type': 'application/json' });

package/dist/webview/index.html

@@ -221,6 +221,15 @@
         <p id="daemonStatusText" class="feishu-modal__desc feishu-modal__desc--sub"></p>
       </div>
 
+      <!-- 区块③b：诊断信息（导出日志 + 环境 + 脱敏配置，报 bug 用） -->
+      <div class="feishu-section">
+        <span class="feishu-switch__label feishu-switch__label--strong">{{i18n.diagLabel}}</span>
+        <p class="feishu-modal__desc">{{i18n.diagDesc}}</p>
+        <div class="feishu-modal__actions">
+          <button id="diagExportBtn" class="feishu-link" type="button">{{i18n.diagExportBtn}}</button>
+        </div>
+      </div>
+
       <!-- 区块④：飞书通知（推送开关 + 凭证 + 绑定状态） -->
       <div class="feishu-section">
         <label class="feishu-switch">

package/dist/webview/script.js

@@ -243,6 +243,11 @@
     daemonStatusText.textContent = i18n.daemonWorking || 'Working…';
     vscode.postMessage({ type: 'toggleDaemon', payload: { enabled: daemonToggle.checked } });
   });
+  // ---------- 诊断包导出 ----------
+  document.getElementById('diagExportBtn').addEventListener('click', () => {
+    vscode.postMessage({ type: 'exportDiagnostics' });
+  });
+
   function updateDaemonUI(s) {
     if (!s) return;
     daemonToggle.disabled = !s.supported;

package/package.json

@@ -2,7 +2,7 @@
   "name": "cursor-feedback",
   "displayName": "Cursor Feedback",
   "description": "One Cursor conversation, unlimited AI interactions - Save your monthly request quota! Interactive feedback loop for AI chat via MCP",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "icon": "icon.png",
   "author": "jianger666",
   "license": "MIT",
@@ -147,7 +147,7 @@
     "watch": "tsc -watch -p ./",
     "lint": "eslint src --ext ts",
     "start:mcp": "node dist/mcp-server.js",
-    "test:smoke": "npm run compile && node scripts/smoke-queue.js && node scripts/smoke-dup.js && node scripts/smoke-cli-launcher.js && node scripts/smoke-daemon.js",
+    "test:smoke": "npm run compile && node scripts/smoke-queue.js && node scripts/smoke-dup.js && node scripts/smoke-cli-launcher.js && node scripts/smoke-daemon.js && node scripts/smoke-logger.js",
     "prepublishOnly": "npm run check-changelog && npm run compile",
     "check-changelog": "node scripts/check-changelog.js",
     "release": "standard-version",