gabrielmoreira 飞书多维表格分析与回写
目标：通过已配置的飞书应用机器人读取用户明确指定的多维表格，将读取结果接入当前会话的 DuckDB/SQL 数据源，再用项目现有分析、图表和报告能力完成任务；仅在用户明确提出写入时回写或创建飞书表格。
工作流程
- 先确认用户给出了飞书多维表格链接或
app_token。不得猜测企业中的表格、目录、table_id或record_id。 - 若链接不含
?table=...，先调用list_feishu_bitable_tables，展示可访问的数据表并请用户选择；只有在用户已经明确指定某张表时，才继续读取。 - 调用
load_feishu_bitable。它会把最多 500 条记录作为本会话的 SQL 数据源接入；读取结果中_feishu_record_id仅用于之后明确的逐条更新，不是业务指标。 - 读取后先调用
get_schema，再用query_data、run_analysis和图表工具基于实际列名与实际结果分析。不得编造数值、字段或结论。 - 在对话中先给出简洁的证据、结论与限制。用户要求正式报告时，走既有
propose_report_outline→ 用户确认 →export_report流程。
写回规则
append_feishu_bitable_records：仅在用户明确要求把哪些结果写入一张已有表时调用。必须使用目标表已存在的字段名，并在调用后交付返回的链接。update_feishu_bitable_record：仅在用户明确要求修改指定记录时调用。record_id必须来自本次或之前的真实读取结果，绝不猜测。create_feishu_bitable：仅在用户明确要求创建新表时调用。先说明拟创建的表名、列和示例记录；字段保持简短明确。一次最多写入 500 条初始记录，并按 100 条安全分批提交；成功后交付真实返回的链接。- 不要因为完成分析就自动写回；读取和分析默认只读。若用户说“把结果写回去”但没有目标表或字段映射，先提出最小必要澄清。
结果表建议
需要输出分析好的新表时，优先建立一张清晰的结果表，例如：指标、结果、同比/环比、结论、证据/口径。所有数据必须来自实际工具结果；无法验证的项应标注为待确认。
权限与错误
应用机器人必须同时拥有访问目标多维表格的权限以及所需的读取/写入权限。遇到飞书返回的权限或资源错误时，如实返回错误码与下一步配置建议；不得伪造表格链接、表 ID 或“已创建/已写入”的结果。