@aliou/pi-neuralwatt

中文文档
0.19.1发布于 2026/11/05MITTypeScriptES Module构建来源已验证近 30 天下载 2176

banner

中文使用文档
文档目录14 节
  1. 安装
  2. 获取 API 密钥
  3. 配置证书
  4. 安装扩展
  5. 使用量
  6. API 表面
  7. 配额命令
  8. 配额警告
  9. 图书馆的使用
  10. 设置
  11. 模型列表
  12. 发展
  13. 所需资源
  14. 链接

banner

Pi 神经瓦扩展

添加的 Pi 扩展 神经瓦 作为模型提供者,通过OpenAI兼容的与能透明度相匹配的API,使您获得开源模型.

安装

获取 API 密钥

报名 这里 要获取 API 密钥(参考链接).

配置证书

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

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

或设置环境变量 :

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

安装扩展

# 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

配额警告

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

图书馆的使用

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

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

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 强制刷新.

发展

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,锁文件检查,以及更改器检查. 释放使用情况 更改。 。 。 .

所需资源

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

版本与发布记录

@aliou/pi-neuralwatt 共发布 52 个版本,首次发布于 2026/04/20;过去 12 个月发布了 52 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.19.1latest2026/11/052 天前
0.19.02026/11/044 天前
0.18.12026/11/025 天前
0.18.02026/10/1127 天前
0.17.02026/10/1028 天前
0.16.32026/10/071 个月前

关于 @aliou/pi-neuralwatt 的常见问题

如何安装 @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 和提交记录判断。