飞书进程反馈技能

实时任务处理进度反馈系统，为飞书任务提供完整的状态追踪。

核心功能

1. 自动后台监听

• 持续运行，轮询监听飞书新消息
• 智能识别任务消息（关键词：帮我、处理、创建、生成、分析等）
• 状态持久化，重启后继续处理

2. 即时确认反馈

• 收到任务后 5 秒内回复确认消息
• 包含任务 ID、类型识别、子任务数量
• 显示当前队列状态

3. 进度实时追踪

• 每个子任务处理前后发送进度更新
• 百分比格式（33%、66%、100%）
• 支持成功/失败状态标记

4. 进程隔离管理

• 每个任务独立 Node.js 进程
• 并发控制（默认最多 5 个并发）
• 超时自动终止（默认 5 分钟）
• 优雅关闭处理

5. 错误容错处理

• 自动重试机制（默认 3 次）
• 错误日志记录
• 失败任务标记通知

工作流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ 飞书消息    │ →  │ 任务识别    │ →  │ 创建进程    │
└─────────────┘    └─────────────┘    └─────────────┘
                                              ↓
┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ 完成通知    │ ←  │ 进度反馈    │ ←  │ 发送确认    │
└─────────────┘    └─────────────┘    └─────────────┘

安装方式

本地安装

# 克隆或复制技能到本地
git clone <repo-url> ~/.openclaw/skills/feishu-process-feedback

# 或使用 clawhub（发布后）
clawhub install feishu-process-feedback

启动服务

cd ~/.openclaw/skills/feishu-process-feedback
node scripts/listener.js

后台运行（推荐）

# Windows (PowerShell)
Start-Process node -ArgumentList "scripts/listener.js" -WindowStyle Hidden

# Linux/Mac (systemd 或 screen)
screen -dmS feishu-listener node scripts/listener.js

配置选项

通过环境变量配置：

示例：

export FEISHU_POLL_INTERVAL=3000
export FEISHU_MAX_CONCURRENT=10
export FEISHU_VERBOSE=true
node scripts/listener.js

反馈格式

任务确认

📋 任务收到，开始处理...
任务 ID: #1
类型：🛠️ create
共 3 个子任务
主任务：帮我创建一个 Excel 数据表...
当前队列：1 个任务

进度更新

⏳ 进度 33% - 正在处理：设计表格结构...
✅ 完成 33% - 设计表格结构...

完成通知

🎉 任务完成！
任务 ID: #1
状态：全部完成
成功：3 | 失败：0
耗时：2.45 秒
进度：100%

错误处理

⚠️ 失败 66% - 生成报告：API 超时
❌ 任务处理失败
任务 ID: #1
错误：网络连接失败
请联系管理员或重试

任务类型识别

自动识别任务类型并采用相应处理策略：

日志文件

技能运行产生以下日志文件：

• .listener.log - 监听器日志
• .tasks.log - 任务处理日志
• .listener_state.json - 状态持久化文件

位置：~/.openclaw/skills/feishu-process-feedback/

状态查看

监听器每 5 分钟自动输出状态：

==================================================
📊 FeishuListener 状态
==================================================
运行时间：2h 15m 30s
活跃进程：2/5
总任务数：47
最后消息：om_xxx
轮询间隔：5000ms
==================================================

优雅关闭

支持 SIGINT/SIGTERM 信号：

# 发送终止信号
kill -SIGTERM <pid>

# 或 Ctrl+C（前台运行时）

关闭时会：

1. 停止接收新任务
2. 等待当前任务完成（最多 30 秒）
3. 保存状态
4. 发送通知消息

扩展开发

添加自定义任务处理器