cursor-feedback 2.0.0 → 2.0.2

package/.cursor/skills/releasing/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: releasing
+description: 发布 cursor-feedback 新版本到 npm / Open VSX / VS Code Marketplace。当用户要发版、发布新版本、出包、上线、release、publish 时使用。
+---
+
+# 发布 cursor-feedback 新版本
+
+发版用 `standard-version` 升级版本号，发布由 GitHub Actions（`.github/workflows/release.yml`，推送 `v*.*.*` tag 触发）自动完成三个渠道。**不要手动 `npm publish` / `vsce publish`。**
+
+## 发版步骤
+
+```
+- [ ] 1. 改动已 commit，且遵循 conventional commits（feat: / fix: / chore:）
+- [ ] 2. 升级版本：npm run release:patch（或 release:minor / release:major）
+- [ ] 3. 推送：git push --follow-tags origin main
+- [ ] 4. 验证三渠道发布成功
+```
+
+- **第 2 步**：`standard-version` 自动升级 `package.json` 版本、按 commit 生成 CHANGELOG、打 `vX.Y.Z` tag。
+- **第 3 步**：推送 tag 后 GitHub Actions 自动发布，去仓库 Actions 页看进度。
+
+## 两个发布渠道
+
+| 渠道 | 认证 | 说明 |
+| --- | --- | --- |
+| npm | OIDC Trusted Publishing | 免 token、永不过期（已在 npmjs 配 trusted publisher）|
+| Open VSX | `OVSX_PAT` secret | Cursor / Windsurf / VSCodium 用户从这装 |
+
+`OVSX_PAT` 在 GitHub 仓库 `Settings → Secrets and variables → Actions` 配置。
+
+## 硬约束（踩过的坑，别再犯）
+
+- **禁止给 `package.json` 加 `files` 字段**：会与 `.vscodeignore` 冲突，导致 `vsce package` 直接失败。npm 包瘦身只用 `.npmignore`，VS Code 打包只用 `.vscodeignore`，两者各管各的、互不影响。
+- `pre-push` hook 会校验 `package.json` 的 version 已写入 `CHANGELOG.md`，没写会被拦下。
+
+## 验证发布
+
+```bash
+npm view cursor-feedback version
+curl -s https://open-vsx.org/api/jianger666/cursor-feedback | grep -o '"version":"[^"]*"'
+```
+
+两个版本号都应等于刚发的版本。

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 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.0.2](https://github.com/jianger666/cursor-feedback-extension/compare/v2.0.1...v2.0.2) (2026-06-20)
+
+
+### Bug Fixes
+
+* **feishu:** 消息没送到时引用回复提示，去除虚假「已收到」回执 ([52b107d](https://github.com/jianger666/cursor-feedback-extension/commit/52b107d27ee146dcc10ba1a3aa77d18f3f51bb3c))
+
+### [2.0.1](https://github.com/jianger666/cursor-feedback-extension/compare/v2.0.0...v2.0.1) (2026-06-20)
+
+
+### Bug Fixes
+
+* **feishu:** 卡片标题与引导语去掉 Cursor 绑定改为通用文案 ([07857fa](https://github.com/jianger666/cursor-feedback-extension/commit/07857fa07b972c2a7c621c76fadf33870ddbdb61))
+
+
+### Code Refactoring
+
+* 发版指引从 rule 改为 skill ([5854980](https://github.com/jianger666/cursor-feedback-extension/commit/58549801b93c37262cca793ceb238d84d2806f2d))
+
+
+### Chores
+
+* **ci:** 移除 VS Code Marketplace 发布渠道 ([d58fec1](https://github.com/jianger666/cursor-feedback-extension/commit/d58fec19f9285c6705cb3aebe3aae1e4fc595986))
+
+
+### Documentation
+
+* **feishu:** 删掉与开头重复的结尾段 ([bdc9c61](https://github.com/jianger666/cursor-feedback-extension/commit/bdc9c61fa86c9a268d54d2b777ecc1b11cfb849b))
+* **feishu:** 精简事件订阅步骤描述 ([770a486](https://github.com/jianger666/cursor-feedback-extension/commit/770a4869b475a2466c99357b2e8f146582d9e57d))
+* **feishu:** 补充事件订阅（长连接）配置步骤 ([47f5656](https://github.com/jianger666/cursor-feedback-extension/commit/47f5656373bec44ff6d3274c7c46b7bc6fa105b3))
+* 添加发版流程 rule 供后续 AI 参考 ([e6986a4](https://github.com/jianger666/cursor-feedback-extension/commit/e6986a49d54b279fe28e14d1733342b20b64bbf6))
+
 ## [2.0.0](https://github.com/jianger666/cursor-feedback-extension/compare/v1.1.1...v2.0.0) (2026-06-20)
 
 

package/README.md

@@ -201,7 +201,7 @@ Custom timeout (optional, default 5 minutes):
 
 ### Feishu Notifications
 
-Either way works (see the [Feishu setup guide](./docs/feishu-setup.md)):
+Either way works — but you first need to set up the bot in the Feishu console: enable the bot, grant permissions, and turn on **event subscription** (long-connection mode + the `im.message.receive_v1` event). Full walkthrough in the [Feishu setup guide](./docs/feishu-setup.md):
 
 - **On Cursor**: fill in Feishu credentials via the "Notification settings" icon at the top of the panel.
 - **On other MCP hosts** (agent tools without this panel): configure through `env` in `mcp.json`:

package/README_CN.md

@@ -205,7 +205,7 @@ npm install -g cursor-feedback
 
 ### 飞书通知配置
 
-两种方式都行（详见[飞书配置教程](./docs/feishu-setup.md)）：
+两种方式都行——但都要先在飞书后台把机器人配好：开启机器人能力、申请权限、配置**事件订阅**（长连接方式 + `im.message.receive_v1` 事件）。完整步骤见[飞书配置教程](./docs/feishu-setup.md)：
 
 - **用 Cursor**：在插件面板顶部「通知设置」图标里填飞书凭证。
 - **用其他 MCP host**（没有这个插件面板的 Agent 工具）：在 `mcp.json` 的 `env` 里配置：

package/dist/feishu.js

@@ -583,6 +583,27 @@ class FeishuBridge {
             flog('飞书回执失败: ' + e);
         }
     }
+    /**
+     * 回复（引用）某条消息：用飞书 reply 接口让回执挂在原消息下，用户一眼看出是哪条。
+     * messageId 缺失或调用失败时回退普通发送，保证提示一定送达。
+     */
+    async replyToMessage(messageId, chatId, text) {
+        if (!this.client || !chatId)
+            return;
+        if (messageId) {
+            try {
+                await this.client.im.v1.message.reply({
+                    path: { message_id: messageId },
+                    data: { content: JSON.stringify({ text }), msg_type: 'text' },
+                });
+                return;
+            }
+            catch (e) {
+                flog('飞书回复消息失败，回退普通发送: ' + e);
+            }
+        }
+        await this.replyText(chatId, text);
+    }
     /**
      * 给某条消息加 Get 表情作为「轻回执」：不产生新消息、不产生未读。
      * 失败（如该消息类型不支持表情）时回退文字回执，保证用户知道已收到。
@@ -637,7 +658,7 @@ class FeishuBridge {
             config: { wide_screen_mode: true },
             header: {
                 template: 'carmine',
-                title: { tag: 'plain_text', content: `Cursor 反馈请求 · ${projectName}` },
+                title: { tag: 'plain_text', content: `Feedback 请求 · ${projectName}` },
             },
             body: {
                 elements: [
@@ -646,7 +667,7 @@ class FeishuBridge {
                     {
                         tag: 'markdown',
                         text_size: 'notation',
-                        content: '直接「回复」本条消息把反馈发回 Cursor（多窗口时请回复对应卡片）',
+                        content: '直接「回复」本条消息把反馈发回即可（多窗口时请回复对应卡片）',
                     },
                 ],
             },

package/dist/mcp-server.js

@@ -90,6 +90,8 @@ class McpFeedbackServer {
          * 暂存后等下一轮 pending 一注册立即兑现，避免回复石沉大海（修复用户反馈的竞态 bug）。
          */
         this.stashedInbound = null;
+        /** 暂存过期提示定时器：到点仍未被认领则「回复」那条消息告知没送到，避免静默丢弃 */
+        this.stashExpiryTimer = null;
         // 最近一次被飞书回复 resolve 的请求：供插件端精确区分「飞书回复」与「超时」，
         // 避免超时续期（request 也会短暂为 null）被误判成飞书回复而错误重置面板。
         this.lastFeishuResolved = null;
@@ -403,9 +405,11 @@ class McpFeedbackServer {
             if (globalCount === 0) {
                 // 抢跑兜底：此刻全局无人等待，但很可能 AI 正要发起下一轮（卡片还没注册）。
                 // 暂存到收到消息的本实例，等下一轮 pending 注册时立即兑现。
+                // 关键：此刻没有任何 AI 在等待，绝不能给「✅ 已收到」回执——那是虚假承诺，会让用户
+                // 误以为消息已被接收（实则 AI 这轮可能已结束、永远不会来认领，消息石沉大海）。
+                // 回执只在「真正送达某个等待中的请求」时给（见 tryConsumeStash → submitFromFeishu）。
                 this.stashedInbound = { text, chatId, images, files, at: Date.now(), messageId };
-                // 轻回执：先给消息加 ✅ 表情（无未读）；兑现到具体任务时不再重复回执
-                this.feishu.reactDone(messageId || undefined, chatId);
+                this.armStashExpiryNotice();
             }
             else if (globalCount === 1) {
                 if (localPending.length === 1) {
@@ -565,6 +569,27 @@ class McpFeedbackServer {
             this.tryConsumeStash(requestId);
         });
     }
+    /**
+     * 暂存「无主消息」后，启动过期提示定时器：到 STASH_TTL_MS 仍没被 AI 认领，就「回复」
+     * 那条消息明确告知没送到、引导重发（不再静默丢弃，也不给虚假回执）。
+     * 每来一条无主消息都重置，避免连发时多个定时器并存。
+     */
+    armStashExpiryNotice() {
+        if (this.stashExpiryTimer)
+            clearTimeout(this.stashExpiryTimer);
+        this.stashExpiryTimer = setTimeout(() => {
+            this.stashExpiryTimer = null;
+            const stash = this.stashedInbound;
+            if (!stash)
+                return; // 已被 tryConsumeStash 兑现
+            this.stashedInbound = null;
+            // 引用回复（锚定到最近这条，方便定位）。文案不带「这条/都/重复」等数量词——
+            // 单条已断、多条全丢、第一条已送达后续丢，三种场景下数量词总有一种会误导。
+            // 且引导「待 AI 回复后再重发」：AI 只有重新调起 feedback（即回复）时才会等待接收，
+            // 此刻立即重发仍会落空。
+            this.feishu.replyToMessage(stash.messageId, stash.chatId, '⚠️ 消息未能送达 AI（它可能正忙于上一轮任务，或这轮对话已结束）。需要的话请待 AI 回复后重新发送一次。');
+        }, McpFeedbackServer.STASH_TTL_MS);
+    }
     /**
      * 抢跑暂存兑现：若存在近期「无主」飞书消息，立即作为指定请求的回复提交。
      * 超过 STASH_TTL_MS 的暂存视为与当前任务无关，直接丢弃。
@@ -574,12 +599,19 @@ class McpFeedbackServer {
         if (!stash)
             return;
         this.stashedInbound = null;
+        // 已被 AI 认领，取消「没送到」提示定时器
+        if (this.stashExpiryTimer) {
+            clearTimeout(this.stashExpiryTimer);
+            this.stashExpiryTimer = null;
+        }
         if (Date.now() - stash.at > McpFeedbackServer.STASH_TTL_MS) {
             debugLog('Stashed inbound expired, dropped');
             return;
         }
         debugLog(`Consuming stashed inbound for request: ${requestId}`);
-        this.submitFromFeishu(requestId, stash.text, stash.chatId, stash.images, stash.files);
+        // 真正送达某个等待中的请求时，才给「✅ 送达回执」（传 messageId 触发 reactDone）。
+        // 暂存阶段不再预先回执，避免「没人接却假装已收到」误导用户。
+        this.submitFromFeishu(requestId, stash.text, stash.chatId, stash.images, stash.files, stash.messageId);
     }
     /**
      * 处理获取系统信息请求
@@ -1118,8 +1150,9 @@ class McpFeedbackServer {
     }
 }
 McpFeedbackServer.PORT_SCAN_RANGE = 20; // 与插件端扫描范围保持一致
-/** 抢跑暂存有效期：超过则视为与当前任务无关，丢弃 */
-McpFeedbackServer.STASH_TTL_MS = 8000;
+/** 抢跑暂存有效期：覆盖「AI 刚结束、正要调下一轮 feedback」的竞态间隙（通常 1-3s）。
+ *  取 5s——太长会把已脱离语境的旧消息硬塞进很久后才出现的新一轮，造成上下文错乱（像答非所问）。 */
+McpFeedbackServer.STASH_TTL_MS = 5000;
 /**
  * 「我的窗口」判定为已关闭的空闲阈值：本实例曾被自己窗口插件轮询，但超过此时长没再收到
  *（只剩别的窗口在扫端口）→ 视为我的窗口已关、本实例是僵尸：不再上报 pending，避免污染全局计数。

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.0.0",
+  "version": "2.0.2",
   "icon": "icon.png",
   "author": "jianger666",
   "license": "MIT",