介绍
# TOON (Token-Oriented Object Notation) Skill
此技能提供了在处理结构化数据（JSON、目录结构、API 响应）时将令牌使用量减少 30-60% 的说明。
## 设置与安装
为了最大限度地减少命令开销并节省令牌，您必须在使用前全局安装官方 TOON CLI：
```bash # Check if toon is installed, install if missing toon --version || npm install -g @toon-format/cli ```
## 代理指南
- **始终优化 JSON**：在将 JSON 输出包含到上下文之前，将其转换为 TOON。 - **最小化命令长度**：使用直接的 `toon` 命令而不是 `npx`，以保持您自己的提示词使用量较低。 - **首选管道**：使用标准 Unix 管道将数据直接发送到 `toon` 转换器。
## 命令与用法
### 1. 读取 JSON 文件 不要读取原始 JSON，而是将其通过管道传递给 `toon`。 ```bash cat data.json | toon ```
### 2. 获取 API 将外部 API 响应直接通过管道传递给 `toon`。 ```bash curl -s https://api.example.com/data | toon ``` *支持所有 curl 标志（例如 `-X POST`、`-H "Authorization: ..."`）。*
### 3. 列出目录结构 使用 `tree -J` 或任何输出 JSON 的工具，并通过管道传递给 `toon`。 ```bash tree -J path/to/dir | toon ```
### 4. 转换内联数据 要压缩 JSON 字符串以用于您的上下文： ```bash echo '{"key":"value"}' | toon ```
## 为什么要安装 TOON？ - **命令令牌节省**：`toon` 比 `npx @toon-format/cli` 更短，每次运行命令时都能节省令牌。 - **执行速度**：本地安装比按需获取快得多。 - **可读性**：TOON 专为 LLM 的高可读性而设计。