feishu-agent

What problem does it solve?

将飞书 Bitable 的重复摩擦（URL/token 解析、字段映射、OAuth scope 适配、schema 获取与缓存）封装成一次调用的持久化代理，减少你在“能不能写入/该用哪个字段/权限够不够”的来回排查时间。

Core Features & Use Cases

• URL 自动解析与缓存：把飞书 Wiki / Base / Record URL 解析为 app_token、table_id、record_id，并将解析结果缓存到 EverMem（TTL 7 天）以加速后续操作。
• Schema 内省与缓存：按 base 拉取字段、类型、选项枚举，并缓存到 EverMem，避免每次都重复查询。
• Natural-language CRUD（Upsert-First）：支持自然语言的增删改查，并在写入前先查重（按唯一字段）再 PATCH/CREATE，降低重复数据与误操作风险。
• 破坏性操作确认与安全边界：对 delete 等破坏性行为要求用户确认，并避免修改字段类型导致的数据丢失。
• OAuth scope 自动映射：把人类可读的权限描述映射到 lark-cli 标准 scope，并在 permission_denied 时提示重新授权。

Quick Start

调用时请使用指令 /feishu list <表名> where <条件> 来直接查询并返回结构化结果。