Skip to content

v0.1.15

Choose a tag to compare

@github-actions github-actions released this 21 Aug 06:35
· 7 commits to main since this release
v0.1.15
db6b5d1

新增

  • HTTP 新增 GET /cat:对象内容以原始字节流输出(非 JSON,二进制安全),
    range 查询参数(0-1023,与 CLI --range 同义)或标准 Range 请求头均可,
    响应透传 Content-Type/Content-Length,范围读取返回 206 + Content-Range
  • MCP 新增 cat 工具(工具列表现为 5 个:ls/stat/cat/presign/find):读取对象内容,
    UTF-8 文本放 text 字段、二进制放 base64 字段(二选一),单次上限 16MiB——
    更大的对象提示改用 CLI oss cat 或 HTTP GET /cat
  • 原始 /cat 路由同样支持公共连接参数(query 方式)与 X-Oss-Ak/Sk/Token/Profile 凭证头,
    错误沿用统一 {"error":"..."} + 状态码映射
  • README(中/英)与 serve/mcp 帮助同步 cat 的用法说明与示例

内部

  • cat 命令抽出 catTarget 核心,CLI 输出、HTTP 原始流、MCP 工具三条路径共用

v0.1.15 — cat over HTTP/MCP: raw byte stream with range reads

New

  • New HTTP GET /cat: object content as a raw byte stream (not JSON, binary-safe);
    range query param (0-1023, same syntax as CLI --range) or a standard Range
    header, with Content-Type/Content-Length passed through and 206 +
    Content-Range on range reads
  • New MCP cat tool (5 tools now: ls/stat/cat/presign/find): reads object content;
    UTF-8 text goes into the text field, binary into base64 (one of the two), capped
    at 16MiB per call — larger objects point to the CLI oss cat or HTTP GET /cat
  • The raw /cat route supports the common connection params (query) and the
    X-Oss-Ak/Sk/Token/Profile credential headers, with the standard
    {"error":"..."} body and status-code mapping
  • README (zh/en) and the serve/mcp help document the cat usage with examples

Internals

  • The cat command now shares a catTarget core across the CLI stream, the HTTP
    raw route and the MCP tool