> For the complete documentation index, see [llms.txt](https://tinyhumans.gitbook.io/openhuman/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools/system-and-utilities.md).

# 系统与实用工具

通用工具家族。代理在完善任务时会用到的小而精的工具。

## 该家族中的工具

| 工具                  | 功能                                                                                |
| ------------------- | --------------------------------------------------------------------------------- |
| `shell`             | 运行 shell 命令。输出受限，并捕获退出码。                                                          |
| `node_exec`         | 运行一段 Node.js 代码片段——适合一次性脚本编写。                                                     |
| `npm_exec`          | 运行一个 `npm`/`pnpm`/`yarn` 脚本。                                                      |
| `python_exec`       | 运行一段 Python 3 代码片段或 `.py` 脚本——用于一次性的 Python 脚本编写。                                 |
| `current_time`      | 获取任意时区的当前时间，并提供格式化选项。                                                             |
| `schedule`          | 一次性“在时间 T 执行一次”——对于重复任务，请参见 [Cron](/openhuman/zh/gong-neng/native-tools/cron.md). |
| `pushover`          | 向你的设备发送推送通知。                                                                      |
| `insert_sql_record` | 向代理的结构化工作区 SQL 存储中追加一行。                                                           |
| `lsp`               | 查询语言服务器（定义、引用、诊断）。                                                                |
| `workspace_state`   | 检查当前工作区——打开的文件、最近的编辑、环境。                                                          |
| `proxy_config`      | 读取或修改出站请求的代理配置。                                                                   |
| `tool_stats`        | 自我反思——本次会话中使用了哪些工具，以及使用频率。                                                        |

## 适用场景

* 工作流中不适合更丰富工具家族的部分。
* “直接运行这个命令，然后告诉我它输出了什么。”
* 具备时间感知的行为（“用户现在那边几点了？”），而无需把时区假设写死到提示词中。
* 让代理 *通知你* 当它完成一个长时间运行的任务时。

## 另请参阅

* [Coder](/openhuman/zh/gong-neng/native-tools/coder.md) ——对于大量涉及文件系统的工作，优先使用专用工具，而不是 `shell`.
* [Cron 与调度](/openhuman/zh/gong-neng/native-tools/cron.md) ——适用于任何重复性任务。