飞书任务对接集成

功能概述

飞书任务对接集成技能实现了本地待办事项系统与飞书任务平台的无缝对接，提供智能化的任务管理和同步功能。

核心能力

1. 自动任务创建

• - 使用 todo任务内容 命令自动创建飞书任务
• 自动设置任务负责人和关注人
• 生成任务唯一标识符和访问链接

2. 智能时间解析

• - 支持自然语言时间表达：今天、明天、本周、下周、本月
• 支持具体时间：下午3点、晚上11点
• 自动转换为标准时间戳格式

3. 任务负责人管理

• - 自动指派任务给配置的用户
• 支持多人协作（关注人和负责人分离）
• 符合飞书任务API规范

4. 状态同步

• - 本地完成任务自动同步到飞书
• 实时获取任务完成状态
• 双向数据一致性保证

快速开始

基本使用

创建任务（自动同步到飞书）

查看任务列表

完成任务（同步到飞书）

时间表达式示例

今天截止

明天截止

本周截止

具体时间

配置说明

必要配置

json
{
appid: yourapp_id,
appsecret: yourapp_secret,
assigneeuserid: ouyouruser_id
}

获取配置信息

1. 1. App ID & Secret: 在飞书开发者后台创建应用获取
2. User ID: 用户的openid，格式为 ouxxxxxxxx

技术实现

文件结构

• - todohandler.py - 主处理器，处理todo命令
• feishutaskintegration.py - 飞书任务API集成
• feishuconfig.json - 配置文件

API集成

• - 使用飞书任务v2 API
• 正确的字段命名：members、assignee_list
• 符合飞书API规范和权限要求

故障排除

常见问题

1. 1. 任务创建失败: 检查API密钥和用户ID配置
2. 负责人设置无效: 确认用户ID格式正确（ou_开头）
3. 时间解析错误: 使用标准时间表达格式

调试信息

资源文件

scripts/

• - todohandler.py - 待办事项处理器
• feishutask_integration.py - 飞书API集成

references/

• - api_guide.md - 飞书任务API使用指南
• configuration.md - 详细配置说明

assets/

• - feishuconfigtemplate.json - 配置文件模板