用途：这是天工知识库的教材来源检索技能，刻意限定单一来源，始终搜索 textbook，不使用 all、course 或 edu，仅适合获取教材式解释与参考材料。
主要能力：支持普通关键词查询，也支持按元数据字段过滤和数值/日期范围过滤；可指定返回结果数量并扩展相邻分块。
使用方式：前置条件为设置 tiangong-ai 所需认证环境变量；包装脚本默认使用 npx @tiangong-ai/cli@0.0.19，无需预装 CLI。可通过 TIANGONG_AI_CLI 或 TIANGONG_AI_CLI_BIN 覆盖 CLI 入口，也可选设 TIANGONG_AI_API_BASE_URL，CLI 接受 Supabase 项目根、/functions/v1 或 /rest/v1 并推导 Functions URL。普通搜索示例：./scripts/textbook_search.sh '{"query": "activated sludge process principles", "top_k": 5}'，脚本调用 npx @tiangong-ai/cli@0.0.19 education search --query <query> --sources textbook --json。需要精确 edge-function payload 时可传 request_file 或 input_file，配 dry_run 返回脱敏请求计划。
输入字段：query 或 input 为便捷查询文本；request_file 或 input_file 为原样转发的 JSON body；env_file 指定 dotenv 文件，未指定时包装脚本会从 request_file / input_file 所在目录加载 .env；filter、datefilter、topK、extK 为可选内联原始 payload 字段，其中 topK、extK 用原始 edge-function 名称控制结果数与相邻分块扩展；sources 仅接受 textbook 或默认值；dry_run 预览请求；还可提供 api_base_url、api_key、textbook_api_key、textbook_url、region、timeout、top_k、ext_k。
限制：textbook_search 不支持 getMeta；加载的 dotenv 值仅填充未设置的环境变量，显式 JSON 字段如 api_key、textbook_api_key、api_base_url 会作为 CLI 标志传递并优先。其余信息暂未提供。