智能表格筛选器

要解决的问题

在多步 AI 工作流里，腾讯文档智能表格的筛选是容易出错的环节：人工复制筛选条件、逐列核对、再导出结果，既低效又容易漏项。sheet-process 把整套筛选逻辑封装成可编排节点：给定 file_id 和筛选参数，直接产出结构化结果供下游 AI 节点消费，避免在对话里来回粘贴表格数据。

核心能力与执行流程

• 双模式触发：sheet-process 走工作流模式，输出固定 JSON；表格筛选、表格处理、表格过滤 走原子模式，引导式问答，输出格式由用户决定。两者同时出现时工作流优先。
• 分步交互执行：

1. 模式确认（仅工作流模式展示）
2. 确认 WorkBuddy 已连接腾讯文档连接器
3. 选择工作表：从 @tdoc#xxx 引用或链接提取 file_id，调 smartsheet.list_tables 列出工作表，再调 smartsheet.list_views 取默认视图的 view_id
4. 填写筛选参数：先调 smartsheet.list_fields（必须传 view_id）拿到视觉列序，用户填模板或直接用自然语言描述
5. 执行筛选并输出：调用 scripts/smartsheet_filter.py

• 模板格式校验：筛选列、关键词、取并集、输出列四项必填且长度必须一致，格式不符会回显解析结果与错误提示，并重复当前步骤。
• 自然语言快速模式：如「筛选 A 列含 X 或 Y」自动映射为 keywords=[[X,Y]]、union_mode=[True]，列可用标题或序号描述。

适用边界与注意点

• 列序依赖视图：list_fields 不传 view_id 时返回字段内部创建顺序，与表格视觉列序不一致，必须先取默认视图的 view_id。
• 组合方式固定：暂不支持跨列组合，固定 column_combine="intersection"（所有筛选列都满足才保留），需要更灵活组合请改用 smartsheet-filter。
• 强依赖连接器：需要 WorkBuddy 已连接腾讯文档，否则流程会在第 1 步中止等待。
• 输出面向下游：工作流模式的 JSON 是给下游 AI 节点消费的契约，不是给人看的报表。