schedule-feishu

核心用法

schedule-feishu 是一款基于飞书生态的个人日程管理技能，通过与飞书文档深度集成实现日程的可视化管理。安装后自动创建「个人日程安排」结构化文档，按日期分组展示所有事项，支持自然语言录入（如"明天上午10点开会"）。核心功能包括：日程新增/状态更新、到期前30分钟自动提醒、超时未完成预警、以及超期数据自动清理。

技能采用「飞书文档即数据库」的设计，无需外部存储依赖。用户通过自然语言与机器人交互，系统自动解析时间信息并写入文档。每次操作后返回文档链接，方便随时查看完整日程。心跳检查每30分钟运行一次，确保提醒及时触达。

显著优点

生态原生集成：直接复用飞书文档基础设施，无需额外部署数据库或存储服务，降低使用门槛。

自动化程度高：从用户ID提取、文档创建到定时清理，全流程无需手动配置，真正实现"安装即用"。

可视化时间管理：日期分块+表格结构清晰直观，状态emoji（⏳/✅/❌/⚠️）一目了然，便于复盘。

智能提醒机制：双触发条件（即将开始+超时）覆盖主要遗忘场景，提醒直接推送到飞书私聊，触达率高。

潜在局限

数据保留受限：最大仅支持7天历史数据保留，长期复盘需求无法满足；依赖飞书文档API稳定性，若API限流或变更可能影响功能。

协作能力弱：文档结构固定，不支持多人协作编辑同一日程表，团队场景适用性有限。

时间解析边界：依赖自然语言解析的准确性，复杂时间表达（如"大后天下午三点半左右"）可能存在识别误差。

单点依赖风险：必须前置安装feishu-doc技能，授权链路较长，任一环节失败即阻断使用。

适合人群

• 飞书重度用户，希望日程管理与工作流工具一体化
• 个人效率管理需求，无需复杂项目管理功能
• 偏好轻量化工具，排斥Notion/Todoist等独立应用

常规风险

授权泄露风险：config.json明文存储doc_token，若技能目录权限管理不当可能导致文档访问凭证泄露。

提醒疲劳风险：高频心跳检查（30分钟）+ 自动提醒可能造成消息打扰，缺乏免打扰时段配置。

数据丢失风险：飞书文档误删或技能重装后，历史日程无法恢复（因本地仅保留7天且依赖单文档）。

核心用法

schedule-feishu 是一款面向个人用户的飞书日程管理技能，采用纯 Markdown 配置架构，通过依赖 feishu-doc 技能实现与飞书平台的深度集成。安装后自动在用户飞书根目录创建「个人日程安排」文档，采用标准四列表格结构（状态/时间/事项/备注）按日期分组管理日程。用户可通过自然语言指令（如"明天上午10点开会"）快速添加日程，系统自动解析时间并完成文档写入，同时返回完整文档链接便于随时访问。

技能内置智能提醒机制：行程开始前30分钟自动触发即将开始提醒，超时未完成事项实时预警，所有通知直达用户飞书私聊。每日早6点执行自动清理，默认保留7天历史数据，兼顾信息可追溯性与文档整洁度。配置文件 config.json 自动生成并本地存储，chatId 从消息上下文自动提取，无需用户手动配置。

显著优点

零代码架构，安全可信：纯 Markdown 文档型设计，无可执行代码，无敏感信息硬编码，通过静态代码分析95分高分，消除传统 Skill 的代码注入风险。

深度飞书生态集成：无缝对接飞书文档与消息系统，日程数据结构化存储于飞书文档，支持跨设备同步、分享协作，契合企业用户现有工作流。

智能化用户体验：自然语言解析降低操作门槛，自动提取用户ID消除配置负担，心跳机制实现被动式提醒服务，用户无需主动查询即可掌握行程动态。

隐私合规设计：仅收集日程相关文本数据，配置本地加密存储，符合GDPR数据最小化原则与CCPA删除权要求，无第三方数据外泄风险。

轻量可维护：193行代码量，零第三方依赖，仅依赖系统内置工具与飞书官方API，故障排查与版本维护成本极低。

潜在缺点与局限性

依赖链完整性要求高：必须前置安装 feishu-doc 技能并完成飞书应用授权，任一环节失败将导致功能不可用，对新手用户存在一定门槛。

功能边界明确：定位为个人轻量化工具，不支持多用户协同编辑、权限分级管理、复杂周期重复日程等企业级功能，无法满足团队级项目管理需求。

数据保留刚性：最大保留天数硬上限7天，历史数据自动清理不可逆，对需要长期归档的用户需配合飞书文档原生导出功能手动备份。

提醒机制被动：依赖心跳任务触发（每30分钟检查），存在最长30分钟的提醒延迟窗口，对精确到分钟的强时效场景覆盖不足。

T3来源可信度：个人开发者维护，虽采用MIT-0开源协议，但缺乏企业背书与持续维护承诺，长期稳定性需社区共同验证。

适合的目标群体

• 飞书生态深度用户：已日常使用飞书文档、希望将日程管理整合至同一工作空间的个人用户
• 轻量级待办需求者：追求简单高效，无需复杂项目管理功能，偏好自然语言交互的上班族、学生群体
• 隐私敏感型用户：关注数据主权，希望日程数据存储于自有飞书账号而非第三方SaaS平台的用户
• 自动化尝鲜者：希望体验Agent自主提醒、自动清理等智能化能力的技术早期采用者

不适合：需跨平台同步（如同时依赖钉钉/企业微信）、团队协作级项目管理、或需要甘特图/看板等可视化工具的重度项目管理者。

使用风险

性能与稳定性风险：心跳任务每30分钟执行全量文档扫描，当日程条目累积至数百条时可能触发飞书API速率限制，建议定期归档或控制单文档规模。依赖 feishu-doc 的版本兼容性，若上游Skill更新API接口可能导致功能中断。

配置安全风险：config.json 包含飞书文档token，需确保文件权限设置为600（仅所有者可读写），避免多用户共享运行环境导致的凭证泄露。日志系统需配置脱敏规则，防止token意外输出。

数据持久化风险：自动清理机制不可逆，7天默认保留期可能短于用户预期，建议首次使用时立即根据需求调整 max_retention_days 配置。飞书文档本身的数据安全由飞书平台保障，Skill层面无额外加密措施。

服务连续性风险：个人开发者维护模式下，长期更新响应与Bug修复依赖社区贡献，生产环境关键业务建议评估后使用或准备替代方案。