# @chirag127/ai 中文文档

规范地址：https://npmcn.com/package/%40chirag127/ai/

版本：0\.1\.0
npm 元数据更新时间：2026-08-11T04:23:53.305Z
中文译文更新时间：2026-11-09T13:41:37.007Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：7.4 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-08-11T04:23:52.824Z
- 最新版本发布：2026-08-11T04:23:53.144Z
- 近 30 天下载量：3483（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 1 个）

## 中文简介

框架-不可知的AI客户端,一个界面,两个后端. 服务器:NVIDIA NIM(OpenAI-兼容,密钥出自env NVIDIA API KEY,仅服务器侧). 客户端:Puter.js(无键,用户-auths,:免费模型). 共享聊天(消息,选择)合同.

## 安装

```sh
npm install @chirag127/ai
```

也可以使用：`pnpm add @chirag127/ai`、`yarn add @chirag127/ai`、`bun add @chirag127/ai`

## README

# @chirag127/ai (英语)

一个AI接口,两个后端. 一样 `chat(messages, opts) -> Promise<string>` 合同双方.

-   **`./server`** ——NVIDIA NIM (OpenAI-兼容). 密钥安全: 已读 `NVIDIA_API_KEY` 从洞. **只能靠服务器 永远不要向客户端运送.**
-   **`./client`** - 普特尔. 无密钥:用户通过Puter认证,没有密钥离开浏览器. `:free` 仅限模型.

框架不可知,零分解.

## 安装

```sh
npm i @chirag127/ai
```

## 服务器——NVIDIA NIM(钥匙安全)

隐藏的密钥 `NVIDIA_API_KEY` (GH 密语). 从未嵌入或发送到浏览器. 3个型号按顺序排列.

```js
import { chat } from '@chirag127/ai/server';

// NVIDIA_API_KEY in env (or pass opts.apiKey)
const reply = await chat([{ role: 'user', content: 'Explain HMAC in one line.' }]);
console.log(reply);

// pick a model (still falls back through the rest on error)
await chat('hi', { model: 'meta/llama-3.3-70b-instruct' });
```

丢弃,如果 `NVIDIA_API_KEY` 缺少。 试验型号顺序: `nvidia/llama-3.3-nemotron-super-49b-v1` → `meta/llama-3.3-70b-instruct` → `deepseek-ai/deepseek-r1`。 。 。 .

## 客户端-puter.js(无钥匙)

装入 `js.puter.com/v2` 第一次通话。 任何地方都没有密钥;用户通过Puter授权.

```js
import { chat, listFreeModels } from '@chirag127/ai/client';

const reply = await chat('Write a haiku about caching.');
console.log(reply);

// live :free catalog
console.log(await listFreeModels());
```

`:free` 已测试的模型顺序 : `nvidia/nemotron-3-super-120b-a12b:free` → `openai/gpt-oss-20b:free` → `google/gemma-4-31b-it:free`。 。 。 .

## 共享

```js
import { MODELS, toMessages } from '@chirag127/ai';
MODELS.server; // string[]
MODELS.client; // string[] (:free)
```

两个后端都接受字符串提示或 `messages` 数组( r)`{ role, content }[]`) (中文(简体) ).

## 许可证

麻省理工学院

## 常见问题

### @chirag127/ai 是什么？

框架-不可知的AI客户端,一个界面,两个后端\. 服务器:NVIDIA NIM\(OpenAI-兼容,密钥出自env NVIDIA API KEY,仅服务器侧\)\. 客户端:Puter\.js\(无键,用户-auths,:免费模型\)\. 共享聊天\(消息,选择\)合同\.

### 如何安装 @chirag127/ai？

在项目目录运行 npm install @chirag127/ai，或使用 pnpm add / yarn add / bun add。

### @chirag127/ai 支持 TypeScript 吗？

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

### @chirag127/ai 支持 ESM 还是 CommonJS？

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

### @chirag127/ai 可以商用吗？

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

### @chirag127/ai 的下载量有多少？

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

### @chirag127/ai 还在维护吗？

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