---
title: "智能体大文件下载前先检查网络 · Kilobat 实用技巧"
url: "https://kilobat.app/zh-hans/guides/recipes/check-network-before-download.html"
description: "让 AI 智能体在 Mac 上下载模型、镜像或依赖之前，先检查网络是否按流量计费、低数据模式、VPN、丢包和电池状态。"
---

实用技巧

# 智能体下载大文件前先检查网络

智能体可以询问 Kilobat 现在是否适合大文件传输。Kilobat 大约两秒内给出一行建议。

App 和 CLI 中免费 · 核查日期：2026年10月29日

## 在 App 中

1. 打开 Wi-Fi 菜单。按流量计费的网络会显示“已连接 · 按流量计费”。
2. 要更改 Kilobat 对某个网络的处理方式，将其“数据计费”设为“自动”“按流量计费”或“不限流量”。

## 使用 CLI

1. 以 JSON 格式读取网络状况。

   ```
   kilobat conditions --json
   ```

   输出 `metered`、`osMetered`、`lowDataMode`、`vpn`、`internetLatencyMs`、`internetLossPercent`、`power` 和一行 `advice`，例如“Good conditions: online, unmetered, on power.”（状况良好：在线、不限流量、已接电源。）
2. 如果网络按流量计费，先询问用户。之后速度测试最多只使用你给定的数据预算。

   ```
   kilobat speedtest --budget-mb 10
   ```
3. 下载期间让 Mac 保持唤醒。

   ```
   kilobat awake -- huggingface-cli download org/model
   ```

## 通过 MCP

用 `claude mcp add kilobat -- kilobat mcp` 连接一次 MCP 服务器。其他客户端参阅[文档](https://kilobat.app/zh-hans/docs.html#agents)。之后智能体就可以调用这些工具。会更改设置的工具会提示智能体先征求你的同意。

| 工具与参数 | 作用 |
|---|---|
| `get_conditions` | 按流量计费、低数据模式、VPN、延迟、丢包、电池和发热状态，以及 `advice`。 |
| `get_updaters` | 当前网络上更新程序是否已暂停。 |
| `run_speedtest` `{"budget_mb": 10}` | 会消耗数据。在按流量计费的网络上，智能体必须先询问你。 |
| `keep_awake` `{"minutes": 60, "reason": "Downloading the model"}` | 下载期间阻止闲置睡眠。 |

## 须知

- `metered` 是 Kilobat 依据的状态，`osMetered` 是 macOS 的判断。`meteredSource` 的值为 `macOS` 或 `you`。
- 延迟为 `null` 表示 ping 没有收到回应，并不能证明互联网已断开。
- Kilobat 的智能体技能会让智能体在按流量计费的网络上进行大文件传输前先征求同意。

## 参考资料

- [Kilobat 文档：AI 智能体与 MCP](https://kilobat.app/zh-hans/docs.html#agents)
- [Kilobat 技能：mac-agent-runs](https://github.com/seifip/kilobat-skills/tree/main/skills/mac-agent-runs)
- [Kilobat llms.txt：CLI 和 MCP 参考](https://kilobat.app/llms.txt)

参考资料核查于 2026年10月29日。man 手册页为 macOS 自带版本；在“终端”中用 `man <name>` 打开。

## 相关指南

- [在 Mac 上使用低数据模式](https://kilobat.app/zh-hans/guides/low-data-mode-mac.html): 低数据模式让 macOS 和 App 在某个 Wi-Fi 网络上减少流量消耗。
- [让 Mac 将网络视为按流量计费](https://kilobat.app/zh-hans/guides/metered-network-mac.html): macOS 会将某些连接标记为高成本，例如 iPhone 个人热点。
- [让 Mac 保持唤醒，直到下载完成](https://kilobat.app/zh-hans/guides/recipes/keep-mac-awake-download.html): 传输进行期间，Kilobat 会让 Mac 保持唤醒。
- [Mac 上 Homebrew 或 npm 下载失败](https://kilobat.app/zh-hans/guides/homebrew-npm-download-fails.html): Homebrew 通过 curl 和 Git 下载。