# 0g-aura 中文文档

规范地址：https://npmcn.com/package/0g-aura/

版本：0\.4\.31
npm 元数据更新时间：2026-06-08T17:14:16.584Z
中文译文更新时间：2026-10-31T12:45:08.951Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/0g-aura
原文对照：https://npmcn.com/package/0g-aura/?lang=original

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

- 包体积（解压后）：605 kB，73 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：5 个
- 首次发布：2026-03-17T22:30:00.648Z
- 最新版本发布：2026-05-24T20:29:31.418Z
- 已发布版本数：48（近 12 个月 48 个）

## 中文简介

0G计算上的分散式AI编码代理

## 安装

```sh
npm install 0g-aura
```

也可以使用：`pnpm add 0g-aura`、`yarn add 0g-aura`、`bun add 0g-aura`

## README

# 0 g-aura

去中心化的AI编码代理由 [0克计算](https://0g.ai/)． 描述您想要构建，编辑或修复的内容- aura将来自可验证GPU提供商的响应流式传输，并将文件更改直接应用于您的项目。

## 安装

```bash
npm install -g 0g-aura
```

或者使用npx（不安装）：

```bash
npx 0g-aura
```

或者本地克隆和链接：

```bash
git clone <repo-url>
cd 0g-aura
npm install
npm run build
npm link
```

## 设置

```bash
aura init
```

这将引导您交互式地完成钱包设置：

1.  **创建一个新钱包** 或者 **导入现有私钥**
2.  选择保存位置(`./.env` 或者 `~/.aura/.env` 为全球)
3.  自动检查A0GI余额

你需要A0GI令牌来支付去中心化计算。把它们放在 [portal.0g.ai](https://portal.0g.ai/).

## 使用

```bash
# Start in current directory with default model
aura

# Choose a model
aura -m deepseek-chat-v3-0324

# Target a specific project directory
aura -d ./my-project

# Skip apply confirmations
aura --no-confirm
```

在TUI中，键入提示符并按Enter。光环将:

1.  阅读项目文件了解上下文
2.  实时地从一个0G计算提供商处流式传输响应
3.  展示不同的修改建议
4.  写文件前请确认

## CLI旗帜

| 国旗 | 描述 |
| --- | --- |
| `-m, --model <name>` | 要使用的模型(默认： `GLM-5-FP8`） |
| `-d, --dir <path>` | 项目目录（默认：cwd） |
| `--no-confirm` | 未经确认应用更改 |
| `-V, --version` | 显示版本 |
| `-h, --help` | 显示帮助 |

## 削减命令

| 命令 | 描述 |
| --- | --- |
| `/help` | 显示所有命令 |
| `/model <name>` | 切换AI模型 |
| `/add <path>` | 向提示上下文添加一个文件 |
| `/remove <path|all>` | 从上下文中删除文件 |
| `/files` | 显示检测到的项目树 |
| `/status` | 检查0G计算连通性 |
| `/balance` | 检查钱包余额 |
| `/undo` | 还原最后应用的文件更改 |
| `/export [file]` | 保存对话以降低价格 |
| `/cost` | 显示会话令牌使用情况 |
| `/clear` | 清晰的谈话记录 |
| `/quit` | 退出 |

## 键盘快捷键

| 关键 | 行动 |
| --- | --- |
| `Enter` | 发送提示/确认申请 |
| `Esc` | 清除输入/拒绝应用 |
| `Up/Down` | 回忆以前的提示 |
| `Shift+Up/Down` | 滚动的谈话 |
| `PageUp/PageDown` | 滚动速度 |
| `Home/End` | 跳转到最旧/最新 |
| `Ctrl+C` | 退出 |

## 模型

| 模型 | 描述 |
| --- | --- |
| `GLM-5-FP8` | 默认，快速通用 |
| `deepseek-chat-v3-0324` | DeepSeek v3 |
| `gpt-oss-120b` | 120 b开源 |
| `qwen3-vl-30b-a3b-instruct` | Qwen3多通道 |

## 配置

| 环境变量 | 默认的 | 描述 |
| --- | --- | --- |
| `ZG_PRIVATE_KEY` | _(必需)_ | 0G钱包私钥 |
| `ZG_RPC_URL` | `https://evmrpc.0g.ai` | 0G RPC端点 |
| `ZG_AUTO_DISCOVER_PROVIDER` | `true` | 自动发现计算提供商 |
| `ZG_PROVIDER_ADDRESS` | \- - - - - - | 锁定一个特定的提供者（跳过发现） |

配置是从 `./.env` 首先,然后 `~/.aura/.env` 作为候选。运行 `aura init` 去创造一个。

## 它是如何工作的

Aura连接到 [0G分散式计算网络](https://0g.ai/) 通过 `@0glabs/0g-serving-broker` SDK。当您发送提示时：

1.  **上下文组装** -扫描你的项目树和读取密钥文件（自动令牌预算管理）
2.  **供应商发现** -找到一个可用的GPU提供商服务于你选择的模型（或使用一个固定的地址）
3.  **流推理** -将您的对话+项目上下文发送给提供商并实时流式响应
4.  **解析** -从模型输出中提取文件更改和shell命令
5.  **应用** -显示diff预览，然后写入文件并在确认后运行命令(使用 `/undo` 支持)

所有推理都运行在分散的、可验证的GPU提供商上——不需要集中的API密钥，只需要一个带有A0GI令牌的0G钱包。

## 许可证

麻省理工学院

## 常见问题

### 0g-aura 是什么？

0G计算上的分散式AI编码代理

### 如何安装 0g-aura？

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

### 0g-aura 支持 TypeScript 吗？

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

### 0g-aura 支持 ESM 还是 CommonJS？

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

### 0g-aura 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### 0g-aura 可以商用吗？

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

### 0g-aura 还在维护吗？

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