parse_hip_offline
Parse Houdini .hip/.hiplc/.hipnc files offline to inspect nodes, connections, postits, and netboxes without launching Houdini.
Instructions
离线 best-effort 解析 .hip/.hiplc/.hipnc（bridge-local，无 Houdini 连接）。
本工具 **不建立 Houdini TCP 连接、不 import hou**，直接在 bridge 进程
内按真实 legacy cpio/odc entry 流式读取 archive（magic 070707、76 字节
header），best-effort 提取节点 type、def comment/position/connections、
可选 parm 序列化原始值、postit 文本与 netbox label，并对不可信输入施加
file/entry/section/total/node 五类硬限额（``max_depth`` 仅裁输出树）。
与 ``serialize_scene`` / ``get_node_info`` 互补：那两个面向**在线** Houdini
连接的实时节点树查询；本工具面向**离线**文件审计（如查看一个 .hip 里
有哪些节点/连线，而不必启动 Houdini）。
参数说明：
- file_path: ``.hip``/``.hiplc``/``.hipnc`` 文件路径；其他扩展名返回
``unsupported_extension``。
- include_params: 可选，True 时每节点附 ``parameters``（archive 中序列化
的原始 parm 文本，**不求值、不比较默认、不保证动画/表达式完整**）。
- max_depth: 可选，输出 ``structure`` 树深度，clamp 到 ``[1,64]``；
flat ``nodes``/``connections`` 不受影响。
返回统一 envelope：``status``（success/error）、``file_path``、
``save_version``（从 ``.variables`` 的 ``_HIP_SAVEVERSION`` 明确提取，
不可得为 null）、``nodes``（flat）、``connections``、``postits``、
``netboxes``、``structure``（depth-clipped 树）、``metadata``（含
complete_entries/bytes_consumed/trailer_seen/duplicate_entries/
skipped_sections/limits）。error 形如
``error:{code,message,details}`` 并尽可能附 partial（trailer_seen=false，
不含截断 body）。error code：unsupported_extension / invalid_archive /
corrupt_archive / truncated_archive / resource_limit_exceeded /
hip_not_found / hip_io_error。success 与 error-partial 均**过**
``apply_response_cap``。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ctx | Yes | ||
| file_path | Yes | ||
| max_depth | No | ||
| include_params | No |