dvcrn 飞书进程反馈技能
实时任务处理进度反馈系统，为飞书任务提供完整的状态追踪。
核心功能
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
配置选项
通过环境变量配置：
| 变量名 | 说明 | 默认值 |
|---|---|---|
FEISHU_POLL_INTERVAL |
轮询间隔（毫秒） | 5000 |
FEISHU_MAX_RETRIES |
最大重试次数 | 3 |
FEISHU_RETRY_DELAY |
重试延迟（毫秒） | 1000 |
FEISHU_MAX_CONCURRENT |
最大并发进程数 | 5 |
FEISHU_PROCESS_TIMEOUT |
进程超时（毫秒） | 300000 |
FEISHU_TASK_DELAY |
子任务处理延迟（毫秒） | 500 |
FEISHU_VERBOSE |
启用详细日志 | false |
示例：
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
错误：网络连接失败
请联系管理员或重试
任务类型识别
自动识别任务类型并采用相应处理策略：
| 类型 | 关键词 | 图标 | 处理策略 |
|---|---|---|---|
| create | 创建、build、create | 🛠️ | 设计→创建→验证 |
| analyze | 分析、analyze | 🔍 | 收集→分析→结论 |
| calculate | 计算、calculate | 🧮 | 准备→计算→验证 |
| query | 查询、search、find | 🔎 | 构建→搜索→整理 |
| simple | 其他 | ⚙️ | 直接处理 |
日志文件
技能运行产生以下日志文件：
.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（前台运行时）
关闭时会：
- 停止接收新任务
- 等待当前任务完成（最多 30 秒）
- 保存状态
- 发送通知消息
扩展开发
添加自定义任务处理器
编辑 scripts/process_task.js 中的 executeSubtask() 函数：
async function executeSubtask(subtask, index, total) {
// 根据任务类型调用不同处理器
if (subtask.includes('Excel')) {
return await handleExcelTask(subtask);
} else if (subtask.includes('分析')) {
return await handleAnalysisTask(subtask);
}
// ...
}
集成飞书 API
在 scripts/listener.js 的 getLatestMessage() 中集成飞书开放平台 API：
async function getLatestMessage() {
const response = await fetch('https://open.feishu.cn/open-apis/im/v1/messages', {
headers: { 'Authorization': `Bearer ${ACCESS_TOKEN}` }
});
return await response.json();
}
故障排查
监听器未启动
# 检查 Node.js 版本
node --version # 需要 v14+
# 检查依赖
ls -la scripts/
# 手动启动测试
node scripts/listener.js
消息未发送
- 检查 OpenClaw 飞书通道配置
- 查看
.listener.log错误信息 - 测试手动发送：
openclaw message send --channel feishu --message "test"
任务处理超时
- 增加超时时间：
export FEISHU_PROCESS_TIMEOUT=600000 - 减少并发数：
export FEISHU_MAX_CONCURRENT=3 - 查看详细日志：
export FEISHU_VERBOSE=true
依赖
- Node.js v14+
- OpenClaw 飞书通道
- 飞书应用权限（im:message）
版本历史
v1.0.0 (2026-03-10)
- 初始版本
- 基础监听和反馈功能
- 任务类型识别
- 错误重试机制
- 状态持久化
许可证
MIT License
作者
Carl Zhao
支持
遇到问题？
- 查看日志文件：
.listener.log和.tasks.log - 提交 Issue 到项目仓库
- 联系 OpenClaw 社区