# @elsikora/ai-core 中文文档

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

版本：1\.0\.0
npm 元数据更新时间：2026-05-20T22:47:19.930Z
中文译文更新时间：2026-11-13T14:36:53.375Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：640 kB，598 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：11 个
- 首次发布：2026-05-20T22:44:43.433Z
- 最新版本发布：2026-05-20T22:47:19.737Z
- 近 30 天下载量：6084（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

ElsiKora 模块的统一 AI 运行时间

## 安装

```sh
npm install @elsikora/ai-core
```

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

## README

# @ elsikora/ ai- core (韩语)

ElsiKora软件包和CLI的统一AI运行时间.

## 这个软件包提供了什么

-   单一适配器供跨供应商生成.
-   `profile` 基于模块的运行时间配置模式.
-   第一次设置的互动配置向导 .
-   类型配置准备合同(`inspectProfile`, (中文(简体) ), `ensureProfile`) (中文(简体) ).
-   丢失或无效配置状态的失速输入出错 .

## 安装

```bash
npm install @elsikora/ai-core
```

## 配置

创建 `.elsikora/ai-core.config.js` 在您的项目中 :

```js
export default {
    modules: {
        "your-module-id": {
            model: "gpt-4o",
            provider: "openai",
            reasoning: {
                effort: "medium",
            },
            responseFormat: {
                isStrict: true,
                name: "commit_message",
                schema: {
                    type: "object",
                    properties: {
                        message: { type: "string" },
                    },
                    required: ["message"],
                },
                type: "json_schema",
            },
            retries: 3,
            shouldRepromptCredentialOnAuthenticationFailure: true,
            shouldUseParallelToolCalls: true,
            validationRetries: 3,
        },
    },
};
```

全权证书由提供方通过环境变量解决(例如: `OPENAI_API_KEY`) (中文(简体) ).

## 运行时生成选项

配置和直接生成请求接受提供者中性控制,例如 `maxTokens`, (中文(简体) ), `temperature`, (中文(简体) ), `topP`, (中文(简体) ), `topK`, (中文(简体) ), `seed`, (中文(简体) ), `stopSequences`, (中文(简体) ), `timeoutMs`, (中文(简体) ), `reasoning`, (中文(简体) ), `responseFormat`, (中文(简体) ), `tools`, (中文(简体) ), `toolChoice`, (中文(简体) ), `shouldUseParallelToolCalls`,以及 `shouldRepromptCredentialOnAuthenticationFailure`。 。 。 .

设定 `shouldRepromptCredentialOnAuthenticationFailure: true` 当交互式CLI要求替换证书时,如果当前运行时间证书,包括从环境中解决的证书,被提供者拒绝.

提供方特定选项 `providerOptions` 并且只绘制在基础设施适配器内。 实例包括 OpenAI `apiMode`, (中文(简体) ), `serviceTier`, (中文(简体) ), `textVerbosity`,以及 `shouldStore`; 安东尼 `speed`, (中文(简体) ), `serviceTier`,以及 `thinking`; 谷歌 `thinkingConfig`; AWS Bedrock guardrail和性能选项; Cerebras 推理/日志选项; Ollama 推理控制; Vercel AI Gateway 提供者选项.

## 公共适配器 API

```ts
import { AiCoreAdapter, EGenerateMode } from "@elsikora/ai-core";

const adapter = AiCoreAdapter.create();

const inspection = await adapter.inspectProfile("your-module-id");
const profile = await adapter.ensureProfile("your-module-id");

const result = await adapter.generate({
    mode: EGenerateMode.PROFILE,
    moduleId: "your-module-id",
    prompt: "Generate a concise commit message",
});
```

## 配置准备行为

-   `inspectProfile(moduleId)` 从未提示并返回已键入状态 :
    -   `ready`
    -   `missing_profile`
    -   `missing_credential`
    -   `invalid_profile`
-   `ensureProfile(moduleId)` 应用划线:
    -   缺少配置 + TTY - > 运行完整的交互式配置
    -   缺少证书 + TTY - > 仅是快速证书
    -   非 TTY 缺失状态 - > 已键入 `ProfileResolutionError`

## 输入配置文件出错

`ProfileResolutionError` 揭露:

-   `code`数字 : `missing_profile` | `missing_credential` | `invalid_profile`
-   `moduleId`
-   `provider` (当知道时)
-   `environmentVariableName` (当知道时)

## 校验脚本

-   `npm run validate:fast`
-   `npm run validate:pr`
-   `npm run validate:heavy`

## 常见问题

### @elsikora/ai-core 是什么？

ElsiKora 模块的统一 AI 运行时间

### 如何安装 @elsikora/ai-core？

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

### @elsikora/ai-core 支持 TypeScript 吗？

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

### @elsikora/ai-core 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @elsikora/ai-core 可以商用吗？

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

### @elsikora/ai-core 的下载量有多少？

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

### @elsikora/ai-core 还在维护吗？

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