健康检查：返回网关地址、只读开关、鉴权四要素就绪状态与缺失项。

列出本服务已登记的三效单据标识（formId）、中文名与默认查询字段。

未登记的单据仍可直接把 formId 传给 sx_list_query，此表只是便利。 formId 与字段标识的权威来源：星辰单据列表 → 更多 → 引入数据 → 模板管理 → 新增模板。

列出可用的 action、只读 operation 方法白名单，以及当前放行的写动作。

列表查询任意三效单据（官方 listQuery）。

form_id: 单据标识或中文别名，如 bdi_projectfile / "项目档案" fields: 字段标识，逗号分隔；分录字段写「分录标识.字段标识」， 如 "id,number,name,projectfileteam.teamstaff"；留空取默认字段 params: qParams 条件数组，叶子形如 {"childGroup": false, "qKey": "number", "qCp": "like", "qValue": "ew"} 条件组形如 {"childGroup": true, "joinKey": "or", "childCondition": [ ...叶子... ]} 顶层各项之间是 and。比较符：=,>,>=,<,<=,!=,like,likeLeft order_by: 如 "id desc,name asc" data_permission: all 全部 / self 仅制单人自己

按单据 Id 查详情（官方 getById）。attach_keys 为附件面板标识，如 ["attachmentpanel"]。

执行三效自定义方法（官方 operation）。

只读白名单：loadAppParameter, getUserPermission, getUserconfig, materialBudget, costBudget, workingHourBudget, getAttachFieldPermission, enableWorkflow, isInWorkflow。参数用 dict 传，本工具负责序列化成 官方要求的 operationParJsonStr 字符串。

把简化条件翻译成官方 qParams 数组，不发起请求，用于先验证再查询。

conditions 每项形如 {"key": "billdate", "op": ">=", "value": "2025-01-01"}； 或分组 {"join": "or", "children": [ ...同上... ]}。 返回 qParams 数组与类 SQL 的可读描述。

查询项目档案（bdi_projectfile）。keyword 对项目名称做 like 模糊匹配。

查询报销单（bdi_ex_bx）。日期形如 2025-01-01；status 为单据状态标识，如 A 暂存。

查询借款单（bdi_ex_loan）。

查询付款单（bdi_ex_pay）。只读——付款类写操作在本服务中永久禁止。

查询工时填报（bdi_fillinworkinghours）。分录标识 entryworkinghours。

查任意单据详情，form_id 支持中文别名。with_attachments=True 时带上默认附件面板。

查询费用预算（operation.costBudget）。now_bill_id 新建单据传 0。

查询物料预算（operation.materialBudget）。

查询工时预算（operation.workingHourBudget）。

查询当前用户对若干单据的权限（operation.getUserPermission）。

查询单据字段配置（operation.getUserconfig）——想知道某单据有哪些字段标识时用这个。

查工作流状态：是否启用工作流；给了 bill_id 时再查该单是否已在流程中。

获取三效系统参数（operation.loadAppParameter）。

【只组装不发送】把单据 dict 校验并序列化成官方 dataJsonStr，供人工核对。

bill 形如： {"billFormId":"bdi_fillinworkinghours","billId":"0","billNo":"", "fields":[{"fType":"text","fKey":"billno","fValue":"..."}, {"fType":"bd","fFormId":"bdi_projectfile","fKey":"projectfiles","fValue":"..."}, {"fType":"entry","fKey":"entryworkinghours", "fEntities":[{"entryId":"0","entryFields":[...]}]}]} 本工具不调用任何接口，只读环境下也可放心使用。

保存/修改单据（官方 saveOrUpdate）。默认被只读守卫拒绝，需 SX_READONLY=false 且 SX_ALLOW_WRITE_ACTIONS 含 saveOrUpdate 才会真正发送。

提交单据审批（官方 submit）。默认被只读守卫拒绝。

撤销提交（官方 unSubmit）。默认被只读守卫拒绝。

审核单据（官方 audit）。默认被只读守卫拒绝。

反审核单据（官方 unAudit）。默认被只读守卫拒绝。

删除单据（官方 delete）。默认被只读守卫拒绝。

单据下推（官方 push），如借款单下推报销单。

按单据下推传 bill_ids；按分录下推传 entry_ids + src_entry_mark（源单分录标识）。 返回的目标单据数据包在保存时需回传 pushPar。默认被只读守卫拒绝。