# @aliou/pi-neuralwatt 中文文档

规范地址：https://npmcn.com/package/%40aliou/pi-neuralwatt/

版本：0\.19\.1
npm 元数据更新时间：2026-11-04T22:33:55.405Z
中文译文更新时间：2026-11-06T23:23:31.210Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：225 kB，51 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：typebox \*，@earendil-works/pi-ai 1\.5\.0，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \>=1\.4\.0
- 首次发布：2026-04-20T15:34:53.522Z
- 最新版本发布：2026-11-04T22:33:55.011Z
- 近 30 天下载量：2176（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：52（近 12 个月 52 个）

## 中文简介

![banner](https://assets.aliou.me/github/aliou/pi-neuralwatt/banner.png)

## 安装

```sh
npm install @aliou/pi-neuralwatt
```

也可以使用：`pnpm add @aliou/pi-neuralwatt`、`yarn add @aliou/pi-neuralwatt`、`bun add @aliou/pi-neuralwatt`

## README

![banner](https://assets.aliou.me/github/aliou/pi-neuralwatt/banner.png)

# Pi 神经瓦扩展

添加的 Pi 扩展 [神经瓦](https://portal.neuralwatt.com/auth/register?ref=NW-ALIOU-Q7MF) 作为模型提供者,通过OpenAI兼容的与能透明度相匹配的API,使您获得开源模型.

## 安装

### 获取 API 密钥

报名 [这里](https://portal.neuralwatt.com/auth/register?ref=NW-ALIOU-Q7MF) 要获取 API 密钥(参考链接).

### 配置证书

扩展使用Pi的证书存储. 将您的 API 密钥添加到 `~/.pi/agent/auth.json` (建议):

```json
{
  "neuralwatt": { "type": "api_key", "key": "your-api-key-here" }
}
```

或设置环境变量 :

```bash
export NEURALWATT_API_KEY="your-api-key-here"
```

### 安装扩展

```bash
# From npm
pi install npm:@aliou/pi-neuralwatt

# From git
pi install git:github.com/aliou/pi-neuralwatt

# Local development
pi -e ./extensions/provider/index.ts
```

## 使用量

安装后, 选择 `neuralwatt` 作为你的供应商,选择一个模型:

```
/model neuralwatt kimi-k3
```

### API 表面

神经瓦为两个API上的每个模型服务. 挑一个进去 `/neuralwatt:settings` → **API 密码** (或设置) `provider.api` 在扩展配置中 :

-   `openai-completions` (默认): OpenAI 兼容 `chat/completions` 终点.
-   `anthropic-messages`: Anthropic 兼容性 `POST /v1/messages` 端点, 源代码工具使用和思维块 .

两者使用相同的型号标识. 设置适用于 `/reload`成本、能源和配额追踪工作.

### 配额命令

检查您的 API 使用情况 :

```
/neuralwatt:quota
```

配额命令显示三个标签:

-   **订阅** (签署时):计划细节、有进度栏的能源配额、计费期
-   **贷项**: 有进度栏、会计方法的贷方余额
-   **用法密钥( K)**: 每月使用(费用、请求、信使、能量)、API密钥信息、密钥备抵、费率限制

[https://github.com/user-attachments/assets/a8994940-c467-4744-a0f2-833cb63923ff 互联网档案馆的存檔,存档日期2013-12-2](https://github.com/user-attachments/assets/a8994940-c467-4744-a0f2-833cb63923ff)

### 配额警告

启用时, 当信用或能量下降时, 扩展会通知您 。 在主动订阅的情况下,只发出能量警告起火(信用仅是点播的顶级).

## 图书馆的使用

使用 `@aliou/pi-neuralwatt/provider` 编码代理机外 :

以运行时间对等器安装库, `@earendil-works/pi-ai` 财务报告和审定财务报表 `typebox`。 。 。 .

```ts
import { InMemoryModelsStore } from "@earendil-works/pi-ai";
import { createModels } from "@earendil-works/pi-ai/models";
import createNeuralwattProvider from "@aliou/pi-neuralwatt/provider";

const models = createModels({ modelsStore: new InMemoryModelsStore() });
models.setProvider(
  createNeuralwattProvider({
    baseUrl: "https://gateway.example.com/v1",
    provenance: { referer: "https://my-app.example" },
  }),
);
await models.refresh();
```

所有选项都是可选的。 没有证书,提供者会列出并更新公共目录. `NEURALWATT_API_KEY` 或存储的证书允许键入模型。 这个 `X-NW-Conversation-ID` 标题来自每个请求 `sessionId`设置 `provenance: { enabled: false }` 停止添加 `Referer` 和对话的ID信头 对推断请求.

## 设置

配置特性为 `/neuralwatt:settings`数字 :

-   **API 密码** 选择 `openai-completions` (违约)和 `anthropic-messages`; 应用于 `/reload`
-   **API 基础 URL** ——将请求发送到不同的基础URL,例如网关;空使用神经瓦 API
-   **配额命令** - 显示/隐藏 `/neuralwatt:quota`
-   **配额警告** - 启用/取消低配额通知

提供者本身不能被禁用——它总是被装入.

## 模型列表

扩建船为内置型号列表,因此在首发时下线工作. Pi 刷新背景中来自 Neuralwat API 的目录( 当配置了 API 密钥时进行认证, 因此也会出现按键瞄准模型) 并缓存到 `~/.pi/agent/models-store.json`。 。 。 . `pi update --models` 强制刷新.

## 发展

```bash
git clone https://github.com/aliou/pi-neuralwatt.git
cd pi-neuralwatt
pnpm install
pnpm run typecheck
pnpm run lint
pnpm run test
pnpm run check:models   # compare the built-in model list with the live API
```

承诺前的钩子会运行类型检查,lint,锁文件检查,以及更改器检查. 释放使用情况 [更改](https://github.com/changesets/changesets)。 。 。 .

## 所需资源

-   Pi 编码代理 1.4 或以后
-   神经瓦 API 键( 配置于 `~/.pi/agent/auth.json` 或经由 `NEURALWATT_API_KEY`(中文(简体) )

## 链接

-   [神经瓦](https://portal.neuralwatt.com/auth/register?ref=NW-ALIOU-Q7MF)
-   [神经瓦 API 文档](https://docs.neuralwatt.com/quickstart.md)
-   [Pi 文档](https://buildwithpi.ai/)

## 常见问题

### 如何安装 @aliou/pi-neuralwatt？

在项目目录运行 npm install @aliou/pi-neuralwatt，或使用 pnpm add / yarn add / bun add。

### @aliou/pi-neuralwatt 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @aliou/pi-neuralwatt 支持 ESM 还是 CommonJS？

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

### @aliou/pi-neuralwatt 可以商用吗？

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

### @aliou/pi-neuralwatt 的下载量有多少？

根据 npm 官方下载统计，@aliou/pi-neuralwatt 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,176 次，日均约 73 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aliou/pi-neuralwatt 还在维护吗？

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