cursor-feedback 1.2.0 → 2.0.1

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.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)
+
+
+### Features
+
+* 飞书通知打通、通知设置重构与多窗口配置同步 ([fcd536e](https://github.com/jianger666/cursor-feedback-extension/commit/fcd536e295ea2a97250e2eb5c77dec6897e51d60))
+
 ## [1.2.0](https://github.com/jianger666/cursor-feedback-extension/compare/v1.1.1...v1.2.0) (2026-06-12)
 
 

package/README.md

@@ -6,13 +6,13 @@
 [![Open VSX Downloads](https://img.shields.io/open-vsx/dt/jianger666/cursor-feedback)](https://open-vsx.org/extension/jianger666/cursor-feedback)
 [![npm](https://img.shields.io/npm/v/cursor-feedback)](https://www.npmjs.com/package/cursor-feedback)
 
-**One Cursor conversation, unlimited AI interactions** - Save your monthly request quota! An interactive feedback tool for Cursor that enables unlimited interactions within a single conversation through MCP (Model Context Protocol).
+**One conversation, unlimited AI interactions** - If you're on a per-request plan, it saves your monthly quota; plus it bridges your agent tool with Feishu (Lark) — when AI asks for feedback, it's pushed to Feishu and you can reply from your phone. An interactive feedback tool built on MCP (Model Context Protocol).
 
 ![Demo](./demo.gif)
 
 ## 💡 Why Cursor Feedback?
 
-If you're on Cursor's 500 requests/month plan, every conversation counts. With Cursor Feedback:
+If you're on Cursor's 500 requests/month plan or another coding plan, every conversation counts. With Cursor Feedback:
 
 - **One conversation, unlimited interactions** - Keep chatting without consuming extra quota
 - **Human-in-the-loop workflow** - AI waits for your feedback before proceeding
@@ -26,6 +26,7 @@ If you're on Cursor's 500 requests/month plan, every conversation counts. With C
 - 📁 **File Support** - Select files/folders to share paths with AI
 - 📝 **Markdown Rendering** - Full Markdown support for AI summaries
 - ⏱️ **Auto-retry on Timeout** - 5-minute default timeout, AI automatically re-requests
+- 🔔 **Feishu (Lark) Bridge** - When AI requests feedback, the summary is pushed to Feishu so you can reply right from your phone
 - 🌍 **Multi-language** - Supports English, Simplified Chinese, Traditional Chinese
 - 🔒 **Project Isolation** - Multiple windows work independently
 
@@ -115,7 +116,7 @@ Interactive feedback collection tool.
 
 | Parameter | Type | Default | Description |
 |-----------|------|---------|-------------|
-| `project_directory` | string | `.` | Absolute path of project directory (for multi-window isolation) |
+| `project_directory` | string | required | Absolute path of the project workspace you are currently in (the open workspace; for multi-window isolation) |
 | `summary` | string | `I have completed the task you requested.` | AI work summary (supports Markdown) |
 | `timeout` | number | `300` | Timeout in seconds (default 5 minutes) |
 
@@ -150,13 +151,14 @@ Available languages:
 - `zh-CN` - Simplified Chinese (简体中文)
 - `en` - English
 
-### System Notifications
+### Notification Settings
 
-When AI requests feedback while the IDE window is **not focused** (e.g. you switched to another app), the extension sends a native system notification (macOS / Windows / Linux), so you won't miss the request and let it time out.
+Click the "Notification settings" icon at the top of the feedback panel to configure in-app and Feishu notifications, or adjust them in VS Code settings:
 
 | Setting | Type | Default | Description |
 |---------|------|---------|-------------|
-| `cursorFeedback.systemNotification` | boolean | `true` | Show a system notification when AI requests feedback and the IDE is not focused |
+| `cursorFeedback.systemNotification` | boolean | `true` | In-app notifications (main switch): automatically show the feedback panel when AI requests feedback. When off, this window stays fully silent — no panel, no focus stealing, and nothing pushed here |
+| `cursorFeedback.osNotification` | boolean | `true` | Notify when in background (sub-option): fire a native system notification only when the IDE window is not focused. When off, nothing pops even if you switch away (the panel still shows) |
 | `cursorFeedback.notificationSound` | boolean | `true` | Play a sound with the system notification |
 
 > macOS note: notifications are sent via `osascript`. If you don't see them, allow notifications for "Script Editor" in System Settings → Notifications.
@@ -195,7 +197,38 @@ Custom timeout (optional, default 5 minutes):
 | Environment Variable | Default | Description |
 |---------------------|---------|-------------|
 | `MCP_FEEDBACK_TIMEOUT` | `300` | Timeout in seconds (default 5 minutes) |
-| `MCP_AUTO_RETRY` | `true` | Whether AI should auto-retry on timeout. Set to `false` to disable |
+| `MCP_AUTO_RETRY` | `true` | Whether AI should auto-retry on timeout. Set to `false` to disable. Also toggleable via the "Keep-waiting" switch in the panel (priority: panel > env > default) |
+
+### Feishu Notifications
+
+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`:
+
+```json
+{
+  "mcpServers": {
+    "cursor-feedback": {
+      "command": "npx",
+      "args": ["-y", "cursor-feedback@latest"],
+      "env": {
+        "FEISHU_APP_ID": "cli_xxxxxxxx",
+        "FEISHU_APP_SECRET": "your_app_secret"
+      }
+    }
+  }
+}
+```
+
+| Environment Variable | Default | Description |
+|---------------------|---------|-------------|
+| `FEISHU_APP_ID` | - | Feishu app App ID (e.g. `cli_xxxxxxxx`) |
+| `FEISHU_APP_SECRET` | - | Feishu app App Secret |
+| `FEISHU_ENABLED` | `true` | Whether to push feedback to Feishu. Set to `false` to disable |
+| `FEISHU_ACK` | `true` | Whether to react with a "Get" emoji after you reply. Set to `false` to disable |
+
+> Priority: **panel config (when credentials are filled) > env here > default**. The panel wins when App ID/Secret are filled; otherwise it falls back to env. You still need to send the bot one message in Feishu to complete binding.
 
 ## 🏗️ Architecture
 

package/README_CN.md

@@ -6,13 +6,13 @@
 [![Open VSX Downloads](https://img.shields.io/open-vsx/dt/jianger666/cursor-feedback)](https://open-vsx.org/extension/jianger666/cursor-feedback)
 [![npm](https://img.shields.io/npm/v/cursor-feedback)](https://www.npmjs.com/package/cursor-feedback)
 
-**一次 Cursor 对话，无限 AI 交互** - 节省你的月度请求配额！通过 MCP（Model Context Protocol）实现一次对话内无限交互的交互式反馈工具。
+**一次对话，无限 AI 交互** - 如果你是按次计费的用户，它能帮你省下月度请求配额；还能把你的 Agent 工具和飞书打通——AI 请求反馈时推到飞书，你在手机上就能回。基于 MCP（Model Context Protocol）的交互式反馈工具。
 
 ![Demo](./demo.gif)
 
 ## 💡 为什么选择 Cursor Feedback？
 
-如果你使用的是 Cursor 的 500次/月 计划，每次对话都很珍贵。使用 Cursor Feedback：
+如果你使用的是 Cursor 的 500次/月 计划或其它 coding plan，每次对话都很珍贵。使用 Cursor Feedback：
 
 - **一次对话，无限交互** - 持续聊天而不消耗额外配额
 - **人机协作工作流** - AI 等待你的反馈后再继续
@@ -28,6 +28,7 @@
 - 📁 **文件支持** - 支持选择文件/文件夹，将路径告诉 AI 让其读取
 - 📝 **Markdown 渲染** - AI 摘要支持完整的 Markdown 格式
 - ⏱️ **超时自动重试** - 默认 5 分钟超时，超时后 AI 会自动重新请求反馈
+- 🔔 **飞书打通** - AI 请求反馈时把摘要推送到飞书，你直接在手机上回复，不用守在电脑前
 - 🌍 **多语言支持** - 支持简体中文、繁体中文和英文
 - 🔒 **项目隔离** - 多窗口同时使用时，各项目互不干扰
 
@@ -117,7 +118,7 @@ npm install -g cursor-feedback
 
 | 参数 | 类型 | 默认值 | 描述 |
 |------|------|--------|------|
-| `project_directory` | string | `.` | 项目目录的绝对路径（用于多窗口项目隔离） |
+| `project_directory` | string | 必填 | 当前所在项目空间的根目录绝对路径（你打开的工作区；用于多窗口隔离） |
 | `summary` | string | `I have completed the task you requested.` | AI 工作摘要（支持 Markdown） |
 | `timeout` | number | `300` | 超时时间（秒），默认 5 分钟 |
 
@@ -152,13 +153,14 @@ npm install -g cursor-feedback
 - `zh-CN` - 简体中文
 - `en` - English
 
-### 系统通知
+### 通知设置
 
-当 AI 请求反馈而 IDE 窗口**未聚焦**时（比如您切去做别的事了），插件会发送系统原生通知（macOS / Windows / Linux），避免错过反馈请求导致超时。
+在反馈面板顶部点「通知设置」图标即可配置插件通知与飞书通知，也可在 VS Code 设置里调整：
 
 | 设置 | 类型 | 默认值 | 描述 |
 |------|------|--------|------|
-| `cursorFeedback.systemNotification` | boolean | `true` | AI 请求反馈且 IDE 未聚焦时弹出系统通知 |
+| `cursorFeedback.systemNotification` | boolean | `true` | 插件通知（主开关）：AI 请求反馈时自动弹出反馈面板。关闭后本窗口完全静默——不弹面板、不抢焦点、也不推送消息到本窗口 |
+| `cursorFeedback.osNotification` | boolean | `true` | 切到后台时提醒（子项）：IDE 窗口未聚焦时才弹系统原生通知。关闭后即使切走也不弹（面板照常弹出） |
 | `cursorFeedback.notificationSound` | boolean | `true` | 系统通知附带提示音 |
 
 > macOS 说明：通知通过 `osascript` 发送。如果看不到通知，请在 系统设置 → 通知 中允许"脚本编辑器"（Script Editor）发送通知。
@@ -199,7 +201,38 @@ npm install -g cursor-feedback
 | `MCP_FEEDBACK_TIMEOUT` | `300` | 超时时间（秒），默认 5 分钟 |
 | `MCP_AUTO_RETRY` | `true` | 超时后是否提示 AI 自动重试。设为 `false` 可禁用自动重试指示 |
 
-> **超时机制**：如果用户在超时时间内没有响应，AI 会收到超时通知。默认情况下，返回消息会包含重试指示，AI 会自动重新调用 feedback 工具继续等待。如果您不希望 AI 自动重试，可以设置 `MCP_AUTO_RETRY=false`。
+> **超时续期**：超时后默认返回续期提示，AI 会自动再次调用 feedback 继续等待；不想自动续期可设 `MCP_AUTO_RETRY=false`。也可在反馈面板顶部「超时续期」开关随时切换（优先级：面板 > env > 默认开）。
+
+### 飞书通知配置
+
+两种方式都行——但都要先在飞书后台把机器人配好：开启机器人能力、申请权限、配置**事件订阅**（长连接方式 + `im.message.receive_v1` 事件）。完整步骤见[飞书配置教程](./docs/feishu-setup.md)：
+
+- **用 Cursor**：在插件面板顶部「通知设置」图标里填飞书凭证。
+- **用其他 MCP host**（没有这个插件面板的 Agent 工具）：在 `mcp.json` 的 `env` 里配置：
+
+```json
+{
+  "mcpServers": {
+    "cursor-feedback": {
+      "command": "npx",
+      "args": ["-y", "cursor-feedback@latest"],
+      "env": {
+        "FEISHU_APP_ID": "cli_xxxxxxxx",
+        "FEISHU_APP_SECRET": "your_app_secret"
+      }
+    }
+  }
+}
+```
+
+| 环境变量 | 默认值 | 描述 |
+|---------|--------|------|
+| `FEISHU_APP_ID` | - | 飞书应用 App ID（形如 `cli_xxxxxxxx`） |
+| `FEISHU_APP_SECRET` | - | 飞书应用 App Secret |
+| `FEISHU_ENABLED` | `true` | 是否推送反馈到飞书，设 `false` 关闭 |
+| `FEISHU_ACK` | `true` | 收到你的回复后是否回「Get」表情回执，设 `false` 关闭 |
+
+> 优先级：**插件面板（填了凭证）> 这里的 env > 默认**。面板里填了 App ID/Secret 就以面板为准；没填则回退到 env。首次仍需在飞书里给机器人发一条消息完成绑定。
 
 ## 🏗️ 架构