feat(tools): add ReadMediaFile tool for image/video files (#661)

Signed-off-by: Richard Chien <stdrc@outlook.com>

Author: stdrc

CHANGELOG.md

@@ -11,6 +11,8 @@ Only write entries that are worth mentioning to users.
 
 ## Unreleased
 
+- Tool: Add `ReadMediaFile` tool for reading image/video files; `ReadFile` now focuses on text files only
+
 ## 0.82 (2026-01-21)
 
 - Tool: Allow `WriteFile` and `StrReplaceFile` tools to edit/write files outside the working directory when using absolute paths

docs/en/customization/agents.md

@@ -14,7 +14,7 @@ kimi --agent okabe
 
 The default agent, suitable for general use. Enabled tools:
 
-`Task`, `SetTodoList`, `Shell`, `ReadFile`, `Glob`, `Grep`, `WriteFile`, `StrReplaceFile`, `SearchWeb`, `FetchURL`
+`Task`, `SetTodoList`, `Shell`, `ReadFile`, `ReadMediaFile`, `Glob`, `Grep`, `WriteFile`, `StrReplaceFile`, `SearchWeb`, `FetchURL`
 
 ### `okabe`
 
@@ -191,13 +191,22 @@ The following are all built-in tools in Kimi CLI.
 ### `ReadFile`
 
 - **Path**: `kimi_cli.tools.file:ReadFile`
-- **Description**: Read file content. Supports text, image, and video files. For text files, max 1000 lines per read, max 2000 characters per line; for image/video files, max 80MB. Files outside working directory require absolute paths.
+- **Description**: Read text file content. Max 1000 lines per read, max 2000 characters per line. Files outside working directory require absolute paths.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `path` | string | File path |
+| `line_offset` | int | Starting line number, default 1 |
+| `n_lines` | int | Number of lines to read, default/max 1000 |
+
+### `ReadMediaFile`
+
+- **Path**: `kimi_cli.tools.file:ReadMediaFile`
+- **Description**: Read image or video files. Max file size 100MB. Only available when the model supports image/video input. Files outside working directory require absolute paths.
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
 | `path` | string | File path |
-| `line_offset` | int | Starting line number, default 1 (text files only) |
-| `n_lines` | int | Number of lines to read, default/max 1000 (text files only) |
 
 ### `Glob`
 

docs/en/release-notes/changelog.md

@@ -4,6 +4,8 @@ This page documents the changes in each Kimi CLI release.
 
 ## Unreleased
 
+- Tool: Add `ReadMediaFile` tool for reading image/video files; `ReadFile` now focuses on text files only
+
 ## 0.82 (2026-01-21)
 
 - Tool: Allow `WriteFile` and `StrReplaceFile` tools to edit/write files outside the working directory when using absolute paths

docs/zh/customization/agents.md

@@ -14,7 +14,7 @@ kimi --agent okabe
 
 默认 Agent，适合通常情况使用。启用的工具：
 
-`Task`、`SetTodoList`、`Shell`、`ReadFile`、`Glob`、`Grep`、`WriteFile`、`StrReplaceFile`、`SearchWeb`、`FetchURL`
+`Task`、`SetTodoList`、`Shell`、`ReadFile`、`ReadMediaFile`、`Glob`、`Grep`、`WriteFile`、`StrReplaceFile`、`SearchWeb`、`FetchURL`
 
 ### `okabe`
 
@@ -191,13 +191,22 @@ agent:
 ### `ReadFile`
 
 - **路径**：`kimi_cli.tools.file:ReadFile`
-- **描述**：读取文件内容。支持文本、图片和视频文件。文本文件单次最多读取 1000 行，每行最多 2000 字符；图片/视频文件最大 80MB。工作目录外的文件需使用绝对路径。
+- **描述**：读取文本文件内容。单次最多读取 1000 行，每行最多 2000 字符。工作目录外的文件需使用绝对路径。
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `path` | string | 文件路径 |
+| `line_offset` | int | 起始行号，默认 1 |
+| `n_lines` | int | 读取行数，默认/最大 1000 |
+
+### `ReadMediaFile`
+
+- **路径**：`kimi_cli.tools.file:ReadMediaFile`
+- **描述**：读取图片或视频文件。文件最大 100MB。仅当模型支持图片/视频输入时可用。工作目录外的文件需使用绝对路径。
 
 | 参数 | 类型 | 说明 |
 |------|------|------|
 | `path` | string | 文件路径 |
-| `line_offset` | int | 起始行号，默认 1（仅适用于文本文件） |
-| `n_lines` | int | 读取行数，默认/最大 1000（仅适用于文本文件） |
 
 ### `Glob`
 

docs/zh/release-notes/changelog.md

@@ -4,6 +4,8 @@
 
 ## 未发布
 
+- Tool：添加 `ReadMediaFile` 工具用于读取图片/视频文件；`ReadFile` 现在仅用于读取文本文件
+
 ## 0.82 (2026-01-21)
 
 - Tool：`WriteFile` 和 `StrReplaceFile` 工具支持使用绝对路径编辑/写入工作目录外的文件

klips/klip-12-wire-initialize-external-tools.md

@@ -1,7 +1,7 @@
 ---
 Author: "@stdrc"
 Updated: 2026-01-14
-Status: Draft
+Status: Implemented
 ---
 
 # KLIP-12: Wire 初始化协商与外部工具调用

src/kimi_cli/acp/AGENTS.md

@@ -82,6 +82,7 @@
 - When the client advertises `fs.readTextFile` / `fs.writeTextFile`, `ACPKaos` routes
   reads and writes through ACP `fs/*` methods.
 - `ReadFile` uses `KaosPath.read_lines`, which `ACPKaos` implements via ACP reads.
+- `ReadMediaFile` uses `KaosPath.read_bytes` to load image/video payloads through ACP reads.
 - `WriteFile` uses `KaosPath.read_text/write_text/append_text` and still generates diffs
   and approvals in the tool layer.
 

src/kimi_cli/agents/default/agent.yaml

@@ -12,6 +12,7 @@ agent:
     - "kimi_cli.tools.todo:SetTodoList"
     - "kimi_cli.tools.shell:Shell"
     - "kimi_cli.tools.file:ReadFile"
+    - "kimi_cli.tools.file:ReadMediaFile"
     - "kimi_cli.tools.file:Glob"
     - "kimi_cli.tools.file:Grep"
     - "kimi_cli.tools.file:WriteFile"

src/kimi_cli/agents/okabe/agent.yaml

@@ -9,6 +9,7 @@ agent:
     - "kimi_cli.tools.todo:SetTodoList"
     - "kimi_cli.tools.shell:Shell"
     - "kimi_cli.tools.file:ReadFile"
+    - "kimi_cli.tools.file:ReadMediaFile"
     - "kimi_cli.tools.file:Glob"
     - "kimi_cli.tools.file:Grep"
     - "kimi_cli.tools.file:WriteFile"

src/kimi_cli/tools/__init__.py

@@ -51,6 +51,10 @@ def extract_key_argument(json_content: str | streamingjson.Lexer, tool_name: str
             if not isinstance(curr_args, dict) or not curr_args.get("path"):
                 return None
             key_argument = _normalize_path(str(curr_args["path"]))
+        case "ReadMediaFile":
+            if not isinstance(curr_args, dict) or not curr_args.get("path"):
+                return None
+            key_argument = _normalize_path(str(curr_args["path"]))
         case "Glob":
             if not isinstance(curr_args, dict) or not curr_args.get("pattern"):
                 return None