# @genesislcap/foundation-ai 中文文档

规范地址：https://npmcn.com/package/%40genesislcap/foundation-ai/

版本：15\.96\.2
npm 元数据更新时间：2026-11-16T09:26:55.159Z
中文译文更新时间：2026-11-16T09:10:51.349Z
软件包许可：SEE LICENSE IN license\.txt

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

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

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

- 包体积（解压后）：1.7 MB，137 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：3 个
- 首次发布：2026-02-27T13:15:04.723Z
- 最新版本发布：2026-11-16T09:26:54.920Z
- 近 30 天下载量：39641（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：852（近 12 个月 852 个）

## 中文简介

创世纪基金会 AI - 提供者不可知AI配置和共享公用事业

## 安装

```sh
npm install @genesislcap/foundation-ai
```

也可以使用：`pnpm add @genesislcap/foundation-ai`、`yarn add @genesislcap/foundation-ai`、`bun add @genesislcap/foundation-ai`

## README

# 创世纪基金会

[![lerna](https://img.shields.io/badge/maintained%20with-lerna-cc00ff.svg)](https://lerna.js.org/) [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](https://www.typescriptlang.org/)

## [API 文档](https://npmcn.com/package/%40genesislcap/foundation-ai/docs/api/index.md)

提供者不可知的人工智能配置和共享公用事业。 配置一次 app 靴子; 通过依赖性注射使用 .

> **Beta - 不用于生产**  
> 这个包在β. 不用于生产。 API表面和行为可能改变. 它只用于评价和发展.

**支助提供者:**

-   **开放AI** – 响应 API,通过您的服务器代理( P)`serverEndpoint`或直接与 `apiKey` 在信任的背景中。 见 [开放AI](https://npmcn.com/package/%40genesislcap/foundation-ai/#readme-openai)。 。 。 .
-   **Chrome 内置AI** - 快速API / 双子纳米( 无 API 键; Chrome 138+)

每个供应商都暴露出能力,例如: `interpretCriteria` (自然语言到结构化标准). 未来的能力(如汇总)会作为同一界面上的可选方法被添加.

* * *

## 地物旗帜

AI的特性是 **默认禁用**通过 URL 参数或环境变量启用它们 :

**URL 参数** — 附录 `?feature.ai` 到任何 URL( 用于不重建测试) :

```
https://your-app.com/?feature.ai
```

**环境变量** 设置 `GENX_ENABLE_AI=true` 在你的应用软件 `.env` 没有 URL 参数而永久启用的文件 :

```
GENX_ENABLE_AI=true
```

当国旗被关闭时:

-   `createAIProvider()` 财务报告和审定财务报表 `getAIProvider()` 返回一个不开放提供者
-   `resolveAIConfig()` 返回时 `null`
-   AI组件(例如:. `*-ai-criteria-search`, (中文(简体) ), `*-ai-indicator`不提供

您可以在程序上检查旗帜 :

```ts
import { isAIFeatureEnabled, AI_FEATURE_FLAG } from '@genesislcap/foundation-ai';

if (isAIFeatureEnabled()) {
  // AI features are enabled
}
```

* * *

## 安装

添加 `@genesislcap/foundation-ai` 作为依赖。 运行 `npm run bootstrap` 在改变依赖关系之后.

```json
{
  "dependencies": {
    "@genesislcap/foundation-ai": "latest"
  }
}
```

* * *

## 配置

### 1\. 解析配置(Chrome-First或OpenAI)

使用 `resolveAIConfig` 更喜欢Chrome在可用时,以云提供商为倒置. 论云 配置它返回时没有端点, 所以添加您的代理 `serverEndpoint` 在创建提供者之前:

```ts
import { createAIProvider, resolveAIConfig, AIProvider } from '@genesislcap/foundation-ai';

const resolved = await resolveAIConfig({
  provider: 'openai', // default model: gpt-6-luna
  preferChrome: true,
});
const aiConfig =
  resolved && 'providerType' in resolved && resolved.providerType === 'openai'
    ? { ...resolved, serverEndpoint: '/gwf/ai-service/api/openai/chat' }
    : resolved;
```

### 2\. DI的注册提供商

将提供者注册在 app 靴子(例如 `main.ts`:

```ts
import { Registration } from '@microsoft/fast-foundation';

this.container.register(
  Registration.instance(AIProvider, createAIProvider(aiConfig)),
);
```

配置一次; 所有组件使用 `getAIProvider()` 接受同样的情况.

### 3\. 组件用途

```ts
import { getAIProvider } from '@genesislcap/foundation-ai';

const aiProvider = getAIProvider();
if (aiProvider?.interpretCriteria) {
  const result = await aiProvider.interpretCriteria(input, { fields: fieldMetadata });
}
```

* * *

## 开放AI

`OpenAIAIConfig` (单位:千美元)`providerType: 'openai'`) 建立一个 `OpenAIProvider` 打开 `OpenAITransport`标准, 快速和聊天,在反应API上。 支持的模型是 `SUPPORTED_OPENAI_MODEL_IDS`; 默认为 `gpt-6-luna`。 。 。 .

-   **服务器代理( 建议) :** 设定 `serverEndpoint` 到您的代理路线。 运输站 回复请求机构; 代理添加 API 密钥, 调用 `https://api.openai.com/v1/responses` 财务报告和审定财务报表 返回响应。 钥匙留在服务器上 。 没有默认终点 。 创世纪创建 ai- service 挂载一个在 `/api/openai/chat` (在门后), `/gwf/ai-service/api/openai/chat`) (中文(简体) ).
-   **直接 :** 设定 `apiKey` 运输公司也叫OpenAI公司 只在信任的背景中使用, 因为 键在客户端.

没有 `serverEndpoint` 也没有 `apiKey`,一个请求抛出.

### 代理服务器发送错误代码

Anthropic、双子座和OpenAI 运输读取 `code` 从代理JSON的错误机构, `{ "code": "…", "error": "…" }`, (中文(简体) ), 无论情况如何,你都要依此行事

-   `NO_API_KEY`, (中文(简体) ), `BAD_API_KEY`, (中文(简体) ), `KEY_UNREADABLE`, (中文(简体) ), `MODEL_NOT_ALLOWED`, (中文(简体) ), `BAD_REQUEST`, (中文(简体) ), `FALLBACKS_NOT_SUPPORTED` 财务报告和审定财务报表 `REQUEST_TOO_LARGE` 是配置错误。 请求没有经过重审 `AIServiceError` 被抛出.
-   `VENDOR_UNREACHABLE` 重审了它的地位 `AIServiceError` 如果它仍然失败, 会被扔出.
-   任何其他代码都按其状态处理,如前.
-   401或403携带创世纪路由器的NAK(`MESSAGE_TYPE: 'MSG_NACK'`,一个 `ERROR` 列表),或为空 机构,是应用程序的路由器,在代理运行前拒绝请求,没有会话,也没有 对 它会扔 `AIServiceError` 与 `SIGNED_OUT` 或者说 `ACCESS_DENIED`从 `AI_SERVICE_ACCESS_REFUSALS`, (中文(简体) ), 这些不是代理发送的代码。 任何其他无代号的401或403由它的状态处理.
-   413个没有 `code` 而空出或非JSON体是代理前的大小盖. 它会扔 `AIServiceError` 与 `REQUEST_TOO_LARGE`,而且没有经过重审.
-   `AIServiceError.message` 持有的供应商,地位和代码。 代理是属于自己的 `error` 文本打开 `detail`,并登录到控制台.

`AI_SERVICE_ERROR_CODES` 列出他们 `DEFAULT_AI_SERVICE_ERROR_MESSAGES` 拥有助理告诉用户的内容 每一个。 这个 `error` 文本只用于控制台。 一个代理应该使用这些常数而不是重复它们.

* * *

## 手动选择提供者

强迫特定提供者而不是使用 `resolveAIConfig`数字 :

```ts
// OpenAI through your server proxy
Registration.instance(AIProvider, createAIProvider({
  providerType: 'openai',
  model: 'gpt-6-luna',
  serverEndpoint: '/gwf/ai-service/api/openai/chat',
}));

// Chrome only (when available)
Registration.instance(AIProvider, createAIProvider({
  providerType: 'chrome',
}));
```

* * *

## Chrome内置AI(Prompt API /双子座纳诺)

Chrome供应商使用 [提示 API](https://developer.chrome.com/docs/ai/prompt-api) 与双子座纳诺. 它运行在设备上;没有API密钥,也没有数据发送到外部服务.

### 生产(部署的应用程序)

Chrome 内置的AI 在一个 **原产地审判**。对于生产领域,用户有 **没有** 需要启用任何旗帜 :

1.  [滚动您的域](https://developer.chrome.com/origintrials/#/view_trial/2533837740349325313) 在快速API原产地审判中.
2.  在您的应用程序中添加原产地试验符( meta tag 或头) .
3.  当您的应用程序调用时, 模型下载被触发 `LanguageModel.create()` 从用户手势(例如AI指示"安装模型"按钮).

### 地方发展(当地东道主)

用于测试 `localhost`,启用这些克罗姆旗帜:

-   `chrome://flags/#optimization-guide-on-device-model` → **已启用**
-   `chrome://flags/#prompt-api-for-gemini-nano` → **已启用**

更换旗后重启克罗姆.

### 硬件和系统要求

-   **操作员:** Windows 10/11, macOS 13+, Linux, 或 ChromeOS (Chromebook Plus) (中文(简体) )
-   **存储 :** 至少22GB免费(用于模型下载)
-   **GPU : (韩语)** >4 GB VRAM,或 **CPU : (中文(简体) )** 16GB 内存和4+ 核心
-   **网络 :** 仅用于初始模型下载的未计量连接; 推断运行离线

见 [Chrome 的快速 API 文件](https://developer.chrome.com/docs/ai/prompt-api) 满足全部需求.

* * *

## 语音对文本

软件包包括用于语音输入的Web Speech API工具:

```ts
import { isSpeechRecognitionAvailable, startSpeechRecognition } from '@genesislcap/foundation-ai';

if (isSpeechRecognitionAvailable()) {
  const stop = startSpeechRecognition(
    (transcript, isFinal) => { /* handle transcript */ },
    () => { /* on error */ },
  );
  // Call stop() to end recording
}
```

* * *

## 许可证

该项目提供前端依赖性,并使用特许部件。 开发期间需要许可证。 联系人 [创世纪全球](https://genesis.global/contact-us/) 详细情况.

### 许可组件

创世纪低码平台

## 常见问题

### @genesislcap/foundation-ai 是什么？

创世纪基金会 AI - 提供者不可知AI配置和共享公用事业

### 如何安装 @genesislcap/foundation-ai？

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

### @genesislcap/foundation-ai 支持 TypeScript 吗？

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

### @genesislcap/foundation-ai 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @genesislcap/foundation-ai 需要什么版本的 Node\.js？

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

### @genesislcap/foundation-ai 可以商用吗？

@genesislcap/foundation-ai 使用 SEE LICENSE IN license\.txt 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @genesislcap/foundation-ai 的下载量有多少？

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

### @genesislcap/foundation-ai 还在维护吗？

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

