# 系统与实用工具

全能型工具家族。代理在收尾任务时会调用的一些小巧、锋利的工具。

## 该家族中的工具

| 工具                  | 它的作用                                                                              |
| ------------------- | --------------------------------------------------------------------------------- |
| `shell`             | 运行一个 shell 命令。输出受限，并捕获退出码。                                                        |
| `node_exec`         | 运行一段 Node.js 代码片段——适用于一次性脚本编写。                                                    |
| `npm_exec`          | 运行一个 `npm`/`pnpm`/`yarn` 脚本。                                                      |
| `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 & Scheduling](/openhuman/zh/gong-neng/native-tools/cron.md) ——适用于任何需要重复执行的任务。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools/system-and-utilities.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.