# echo-agent 中文文档

规范地址：https://npmcn.com/package/echo-agent/

版本：0\.5\.0
npm 元数据更新时间：2026-11-03T12:38:51.607Z
中文译文更新时间：2026-11-03T13:34:22.927Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/echo-agent
原文对照：https://npmcn.com/package/echo-agent/?lang=original
项目主页：https://github.com/echo-yiyi/echo-agent#readme
源码仓库：https://github.com/echo-yiyi/echo-agent

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：9 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：3 个
- 首次发布：2026-08-31T12:17:32.748Z
- 最新版本发布：2026-11-03T12:38:51.107Z
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

Echo总代理：官方CLI和交互式TUI。同一代理通过Unix管道以交互方式运行。程序集位于@echo-agent/base中，终端shell位于@echo-agent/tui中。需要面包。

## 安装

```sh
npm install echo-agent
```

也可以使用：`pnpm add echo-agent`、`yarn add echo-agent`、`bun add echo-agent`

## README

# echo-agent

Echo总代理：官方CLI和交互式TUI。同一代理以交互方式运行 并通过Unix管道。

> **需要 [包子](https://bun.sh/)。** 可执行文件是带有 `#!/usr/bin/env bun` shebang，并且包出口只在Bun下解决。Node不支持此操作 包中。如果您希望运行时作为Node上的库，请使用 [`@echo-agent/core`](https://www.npmjs.com/package/@echo-agent/core) 相反，那艘船 编译的JavaScript，并由一个发布测试覆盖，该测试将tarball安装到 清理项目并使用Node运行它。

> **状态: `0.x`。** 直到 `1.0`，小版本可能包含破坏性更改。

## 运行它

```bash
bun add -g echo-agent
MOONSHOT_API_KEY=sk-... echo-agent
```

或者运行一次而不安装： `bunx echo-agent`。

在终端中，这将打开交互式UI。对于重定向的stdin，每个输入行是一个回合； 模型文本转到标准输出，操作输出转到标准输出。

```bash
printf 'Introduce yourself in one sentence.\n' |
  MOONSHOT_API_KEY=sk-... echo-agent
```

查看每个选项 `--help`． 选择具有以下内容的提供者 `--provider` 重写它的默认值 模型与 `--model`;默认的提供者是Kimi。

| 提供者 | 凭据环境变量 |
| --- | --- |
| `kimi` | `MOONSHOT_API_KEY` 或 `ECHO_LLM_API_KEY` |
| `deepseek` | `DEEPSEEK_API_KEY` |
| `openai` | `OPENAI_API_KEY` 或 `ECHO_LLM_API_KEY` |
| `zai` | `ZAI_CODING_CN_API_KEY`， `ZHIPU_API_KEY`,或 `ECHO_LLM_API_KEY` |
| `minimax` | `MINIMAX_API_KEY` 或 `ECHO_LLM_API_KEY` |

## 这个包裹是什么？

这是 **一般** 代理：它不知道具体的产品，也不提供文件或shell工具。 它的发射部件来自 `@echo-agent/base` 它的末端壳层来自 `@echo-agent/tui`。 [`@echo-agent/coding`](https://www.npmjs.com/package/@echo-agent/coding) 是否创建了兄弟产品 从相同的两个包中取出，而不是放在这个包的顶部。

完整的文档、运行时API和两种产品的布局都在 [库的自述](https://github.com/echo-yiyi/echo-agent#readme)。

## 许可证

麻省理工学院。看到 [许可证](https://github.com/echo-yiyi/echo-agent/blob/main/LICENSE)。

## 常见问题

### echo-agent 是什么？

Echo总代理：官方CLI和交互式TUI。同一代理通过Unix管道以交互方式运行。程序集位于@echo-agent/base中，终端shell位于@echo-agent/tui中。需要面包。

### 如何安装 echo-agent？

在项目目录运行 npm install echo-agent，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 echo-agent，可以用 npx echo-agent 直接运行。

### echo-agent 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/echo-agent 是否存在。

### echo-agent 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### echo-agent 可以商用吗？

echo-agent 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### echo-agent 还在维护吗？

最新版本 0\.5\.0 发布于 2026/11/03（今天）；至今共发布 6 个版本，其中过去 12 个月发布了 6 个；首次发布于 2026/08/31。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。