查询金蝶云星空单据数据（返回二维数组）。

Args: form_id: 表单ID。常用值： BD_MATERIAL(物料)、BD_Customer(客户)、BD_Supplier(供应商)、 SAL_SaleOrder(销售订单)、PUR_PurchaseOrder(采购订单)、 STK_InStock(入库单)、STK_OutStock(出库单)、GL_VOUCHER(凭证) field_keys: 查询字段，逗号分隔。如 "FName,FNumber" filter_string: 过滤条件。如 "FNumber like 'MAT%'" order_string: 排序字段。如 "FNumber ASC" top_count: 本次最多返回行数，默认100。映射到金蝶 TopRowCount（绝对终止行号 = start_row + top_count）， 同时作为金蝶 Limit（单次页大小）。设为 0 表示不限制行数（仅靠 limit 控制）。 start_row: 起始行号，默认0。翻页时传入上一次返回的 next_start_row。 limit: 仅在 top_count=0 时生效，作为金蝶 Limit 页大小上限，默认2000。 top_count>0 时此参数被忽略（页大小由 top_count 决定）。

查询金蝶云星空单据数据（返回JSON格式，字段名作为key）。

与 query_bill 的区别：返回结果是JSON对象数组，每条记录的字段名作为key，更易读。

Args: form_id: 表单ID。常用值： BD_MATERIAL(物料)、BD_Customer(客户)、BD_Supplier(供应商)、 SAL_SaleOrder(销售订单)、PUR_PurchaseOrder(采购订单)、 STK_InStock(入库单)、STK_OutStock(出库单)、GL_VOUCHER(凭证) field_keys: 查询字段，逗号分隔。如 "FName,FNumber,FCreateOrgId,FUseOrgId" filter_string: 过滤条件。如 "FNumber like 'MAT%'" order_string: 排序字段。如 "FNumber ASC" top_count: 本次最多返回行数，默认100。映射到金蝶 TopRowCount（绝对终止行号 = start_row + top_count）， 同时作为金蝶 Limit（单次页大小）。设为 0 表示不限制行数（仅靠 limit 控制）。 start_row: 起始行号，默认0。翻页时传入上一次返回的 next_start_row。 limit: 仅在 top_count=0 时生效，作为金蝶 Limit 页大小上限，默认2000。 top_count>0 时此参数被忽略（页大小由 top_count 决定）。

估算某查询条件下的数据行数（不返回数据内容）。用于大数据量查询前的探测。

返回 JSON 格式： {"estimated_rows": N, "is_exact": true/false, "hint": "..."} 当 is_exact=false 时，实际行数 ≥ estimated_rows，建议按月/周分片查询。

Args: form_id: 表单ID。如 SAL_SaleOrder、PUR_PurchaseOrder、BD_MATERIAL 等 filter_string: 过滤条件。如 "FDate >= '2025-01-01' AND FDate < '2026-01-01'"

自动翻页查询直到拉完或达到 max_rows 安全上限。

适合估算 ≤ 数千行的场景。大数据量（> 5000 行）请用 query_bill_to_file（落盘） 或 query_bill_range（日期分片），避免超过 MCP 1 MB 返回限制。

返回格式： {"rows": [...], "row_count": N, "exhausted": true/false, "next_start_row": N, # 仅 exhausted=false 时 "hint": "..."} # 仅 exhausted=false 时

Args: form_id: 表单ID。如 SAL_SaleOrder、PUR_PurchaseOrder、BD_MATERIAL 等 field_keys: 查询字段，逗号分隔。如 "FBillNo,FDate,FAmount" filter_string: 过滤条件。如 "FDate >= '2025-01-01'" order_string: 排序字段。如 "FDate ASC" max_rows: 安全上限，默认 20000；超过则提前终止并返回 exhausted=false page_size: 每页行数，默认 2000，建议不超过 2000

自动翻页并流式写入本地文件，适合大数据量导出（万行以上）。

不在内存中累积数据，写入完成后返回文件路径和统计信息。 文件可用 Read 工具抽检，或交由 pandas/polars 处理。

返回格式： {"path": "...", "row_count": N, "bytes": M, "format": "ndjson"} 若中途出错：{"error": "...", "path": "...", "row_count": <已写入>, "bytes": M}

Args: form_id: 表单ID。如 SAL_SaleOrder、PUR_PurchaseOrder、BD_MATERIAL 等 field_keys: 查询字段，逗号分隔。如 "FBillNo,FDate,FAmount" filter_string: 过滤条件。如 "FDate >= '2025-01-01'" output_path: 输出文件绝对路径。如 "/tmp/orders.ndjson" format: 输出格式，ndjson（每行一个 JSON 对象）或 csv，默认 ndjson page_size: 每页行数，默认 2000 max_rows: 最大写入行数，默认 500000；超过则截断并正常返回

按日期自动切片 + 翻页，适合跨月/跨年查询。

将 [date_from, date_to) 按 chunk 切成 N 段，每段独立翻页拉取。 output_path 为空时内联返回（受 MCP 1 MB 限制，适合小跨度）； 非空时流式落盘，适合大跨度（年级）查询。

返回格式（内联）： {"rows": [...], "row_count": N, "chunks": K, "exhausted": true} 返回格式（落盘）： {"path": "...", "row_count": N, "bytes": M, "chunks": K, "format": "ndjson"} 若中途出错：{"error": "...", "path": "...", "row_count": <已写入>, "bytes": M}

Args: form_id: 表单ID。如 SAL_SaleOrder、PUR_PurchaseOrder 等 field_keys: 查询字段，逗号分隔 date_field: 日期字段名。通常是 FDate 或 FCreateDate date_from: 起始日期（含），YYYY-MM-DD date_to: 结束日期（不含），YYYY-MM-DD extra_filter: 额外过滤条件（与日期条件 AND 拼接） chunk: 切片粒度，month（默认）/ week / day output_path: 落盘路径（绝对路径）。空=内联返回 page_size: 每页行数，默认 2000

查看金蝶云星空单条记录的完整详情。

通过编号或内码查看单条记录的所有字段信息。

Args: form_id: 表单ID。如 BD_MATERIAL、SAL_SaleOrder 等 number: 单据编号。如 "MATERIAL001"（number 和 bill_id 二选一） bill_id: 单据内码ID（number 和 bill_id 二选一）

查询金蝶云星空表单的元数据（字段结构信息）。

用于获取某个表单有哪些字段、字段类型等信息，便于构造查询和保存参数。

Args: form_id: 表单ID。如 SAL_SaleOrder、PUR_PurchaseOrder、BD_MATERIAL 等

保存金蝶云星空单据（新增或更新）。

Args: form_id: 表单ID。如 BD_MATERIAL、SAL_SaleOrder 等 model_data: JSON格式的单据数据。示例（保存物料）： {"Model": {"FCreateOrgId": {"FNumber": "100"}, "FNumber": "MAT001", "FName": "物料名称"}} 如果传入的JSON中没有"Model"键，会自动包装。

提交金蝶云星空单据。

Args: form_id: 表单ID。如 BD_MATERIAL、SAL_SaleOrder 等 numbers: 单据编号，多个用逗号分隔。如 "MAT001,MAT002" ids: 单据内码ID，多个用逗号分隔（numbers 和 ids 二选一）

审核金蝶云星空单据。

Args: form_id: 表单ID。如 BD_MATERIAL、SAL_SaleOrder 等 numbers: 单据编号，多个用逗号分隔。如 "MAT001,MAT002" ids: 单据内码ID，多个用逗号分隔（numbers 和 ids 二选一）

反审核金蝶云星空单据。

Args: form_id: 表单ID。如 BD_MATERIAL、SAL_SaleOrder 等 numbers: 单据编号，多个用逗号分隔。如 "MAT001,MAT002" ids: 单据内码ID，多个用逗号分隔（numbers 和 ids 二选一）

删除金蝶云星空单据。

Args: form_id: 表单ID。如 BD_MATERIAL、SAL_SaleOrder 等 numbers: 单据编号，多个用逗号分隔。如 "MAT001,MAT002" ids: 单据内码ID，多个用逗号分隔（numbers 和 ids 二选一）

执行金蝶云星空单据操作（禁用、反禁用等）。

Args: form_id: 表单ID。如 BD_MATERIAL、SAL_SaleOrder 等 op_number: 操作类型。常用值：Forbid(禁用)、Enable(反禁用) numbers: 单据编号，多个用逗号分隔 ids: 单据内码ID，多个用逗号分隔（numbers 和 ids 二选一）

下推金蝶云星空单据（如销售订单下推发货通知单）。

Args: form_id: 源单表单ID。如 SAL_SaleOrder、PUR_PurchaseOrder 等 numbers: 源单编号，多个用逗号分隔 ids: 源单内码ID，多个用逗号分隔（numbers 和 ids 二选一） rule_id: 转换规则ID（不填则用默认规则） target_form_id: 目标单据表单ID（不填则由规则决定） target_org_id: 目标组织ID，默认"0" target_bill_type_id: 目标单据类型ID（不填则用默认） is_enable_default_rule: 是否启用默认转换规则，默认"true" custom_params: 自定义参数JSON字符串。如 '{"FDATE":"2024-01-01"}'（不填则不传）