HTTP 內容協商與解壓縮

urllib / http_request 從不設定 Accept-Encoding,也從不解碼 Content-Encoding 回應,因此 會壓縮的伺服器回傳的內文是原始的;也沒有 quality-value 解析器。本功能加入 Accept / Accept-Encoding 建構器、q-value 解析器,以及 gzip / deflate 解碼。

純標準函式庫(gzip / zlib);不匯入 PySide6。刻意排除 Brotli(非標準函式庫)。每個函式皆為 純函式,因此在 CI 中完全具決定性。

無頭 API

from je_auto_control import (
    build_accept, build_accept_encoding, negotiated_call,
    parse_quality_values, decode_body, build_call,
)

call = negotiated_call(
    build_call(url),
    accept=build_accept([("application/json", 1.0), ("text/html", 0.8)]),
    accept_encoding=build_accept_encoding(),
)
# ... 執行呼叫,然後:
body = decode_body(response["headers"], raw_bytes)

ranked = parse_quality_values("text/html;q=0.8, application/json")
# [("application/json", 1.0), ("text/html", 0.8)]

build_accept 把媒體型別或 (type, q) 配對轉成 Accept 標頭;``build_accept_encoding`` 預設 gzip, deflate。parse_quality_values 把 Accept / Accept-Encoding 標頭解析成依品質排序的 (token, q) 配對(同分維持順序)。decode_body 依 Content-Encoding``(``gzip / deflate,含 raw deflate,以及 identity)解壓回應內文,不支援者拋出 ValueError。negotiated_call 把協商標頭 加到 build_call dict。

執行器命令

AC_decode_body 依 headers 解碼 base64 的 body_base64 回傳 {body_base64, text}; AC_parse_quality_values 回傳 {values}。兩者皆以 MCP 工具(ac_decode_body / ac_parse_quality_values)以及 Script Builder 中 Data 分類下的命令提供。