# @aglyn/plugins-ai 中文文档

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

版本：1\.19\.0
npm 元数据更新时间：2026-11-07T13:59:15.386Z
中文译文更新时间：2026-11-05T23:06:42.556Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：30.3 MB，1581 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：17 个
- peer 依赖：next ^16\.3\.3，react ^19\.2\.8，firebase ^13\.0\.0，@mui/material ^9\.3\.1，firebase-admin ^14\.3\.0，@mui/x-data-grid ^9\.12\.0
- 首次发布：2026-09-20T23:53:03.351Z
- 最新版本发布：2026-11-07T13:59:15.049Z
- 近 30 天下载量：9880（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：162（近 12 个月 162 个）

## 中文简介

Aglyn的AI插件:在座助手,Besigner复制助手,基因建筑和自动化工作,以及周围的用量和访问控制. 它是供应商-通用的:每个特性都与供应商合同和供应商交谈

## 安装

```sh
npm install @aglyn/plugins-ai
```

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

## README

# @aglyn/plugins-ai (英语)

Aglyn的AI插件:在座助手,Besigner复制助手,基因建筑和自动化工作,以及周围的用量和访问控制. 这是供应商-通用的:每个特性都与供应商合同交谈,而供应商的特性仅生活在 `src/lib/providers`。如果运行 Aglyn 控制台并想要其中的 AI 特性,则安装它;它是一个第一当事方插件,而不是一个独立的库.

> 从Aglyn monorepo出版到npm. 随后的版本 [语义版本](https://semver.org/)。 。 。 .

## 安装

```
npm install @aglyn/plugins-ai
```

同伴依赖性 : `react`, (中文(简体) ), `next`, (中文(简体) ), `@mui/material`, (中文(简体) ), `@mui/x-data-grid`, (中文(简体) ), `firebase`,以及 `firebase-admin` 用于服务器条目.

## 里面有什么东西

**在一个出版的网站上.** 没什么 该插件没有站点注册员,而租户运行时间加载它没有服务器表面,因此任何为已公布站点服务的东西都无法到达提供者. 任务构建(一页,一组件,一窗体)被保存为普通Aglyn文档.

**控制台** (单位:千美元)`registerAiConsole`,则 `console` 财务报告和审定财务报表 `staff` 书记官长 `plugins.config.json`) (中文(简体) ). 插件没有添加导航项 。 所有东西都通过控制台外壳和其他插件主机的区域挂载,所以没有控制台页面导入它:

-   助理,从控制台码头抽出`consoleDock`)和一个供应商在Besigner复制助理的每个控制台页面周围挂起外壳,控制器在 `besignerToolbar` 财务报告和审定财务报表 `besignerInspector` 插槽 .
-   控制台上栏的AI工作指标(`consoleTopBar`:工作空间的工作正在做什么,以及通往他们的道路.
-   网站页面列表及其组件,布局,模板,表单,电子邮件模板,产品,主题,SIO,自动化和函数与变量页面上的"与AI相创建"入站点和卡片(C`hostScreens`, (中文(简体) ), `hostComponents`, (中文(简体) ), `hostLayouts`, (中文(简体) ), `hostTemplates`, (中文(简体) ), `hostForms`, (中文(简体) ), `hostEmailTemplates`, (中文(简体) ), `productsCreate`, (中文(简体) ), `hostTheme`, (中文(简体) ), `hostSeo`, (中文(简体) ), `seoFields`, (中文(简体) ), `hostAutomations`, (中文(简体) ), `automationEditor`, (中文(简体) ), `automationRun`, (中文(简体) ), `hostLogic`, (中文(简体) ), `logicFunctionEditor`, (中文(简体) ), `logicReferenceIssue`, (中文(简体) ), `hostFirstRun`, (中文(简体) ), `orgSites`) (中文(简体) ).
-   其他插件主机区的卡片:产品复制、进口和产品枢纽(`productEditor`, (中文(简体) ), `productImport`, (中文(简体) ), `productsHub`,记录深刻见解、电子邮件草稿和导入列匹配(`recordInsights`, (中文(简体) ), `recordEmail`, (中文(简体) ), `importMapping`),A/B测试变体和结果(`experimentVariants`, (中文(简体) ), `experimentResult`),在"营销"页面上翻版和新翻版(`overlayEditor`, (中文(简体) ), `hostOverlays`),从有关其"运动"部分的简介中总结出来的一场运动`hostCampaigns`),其转换部分和竞选报告用文字表示的数字(`marketingInsights`),并且从描述中起草的漏斗并解释了其结果(`funnelsCreate`, (中文(简体) ), `funnelInsight`) (中文(简体) ).
-   使用和获取:记帐信用卡和使用卡(`orgBillingUsage`),每名会员的卡和列(`orgMember`, (中文(简体) ), `orgMembersListColumn`, (中文(简体) ), `hostMembers`工作人员卡、栏和一页`staffOrg`, (中文(简体) ), `staffUser`, (中文(简体) ), `staffOrgsListColumn`, (中文(简体) ), `staffOrgUsageColumn`) (中文(简体) ).

**服务器** (单位:千美元)`registerAiConsoleApi`,则 `consoleApi` 登记员,出口自 `@aglyn/plugins-ai/server`) (中文(简体) ). 它登记了第一当事方供应商、各种工作类型以及根据《公约》提供的路线 `ai` 财务报告和审定财务报表 `assist` 前缀为 `registerPluginApiRoute`数字 :

-   助理: `assist/chat`, (中文(简体) ), `assist/feedback`, (中文(简体) ), `assist/edit-applied`, (中文(简体) ), `ai/assist`。 。 。 .
-   工作: `ai/jobs`, (中文(简体) ), `ai/jobs/batch`, (中文(简体) ), `ai/jobs/:jobId/cancel`, (中文(简体) ), `ai/jobs/:jobId/resume`, (中文(简体) ), `ai/jobs/:jobId/events`计划的工作节拍, `ai/insights/:jobId`, (中文(简体) ), `ai/crm/:jobId`, (中文(简体) ), `ai/seo/apply`, (中文(简体) ), `ai/experiments/versions`, (中文(简体) ), `ai/generate/component`。 。 。 .
-   使用和获取: `ai/usage`, (中文(简体) ), `ai/allotments`, (中文(简体) ), `ai/models`, (中文(简体) ), `ai/host-permissions`, (中文(简体) ), `ai/billing/credits`, (中文(简体) ), `ai/billing/overage`。 。 。 .
-   工作人员: `ai/admin/org`, (中文(简体) ), `ai/admin/orgs-spend`, (中文(简体) ), `ai/admin/user`, (中文(简体) ), `ai/admin/signals`, (中文(简体) ), `ai/admin/overage`, (中文(简体) ), `ai/admin/credits`。 。 。 .

**申报.** 3个光线条目 核心在任何表面负载之前读取:

-   `registerAiDeclarations` (单位:千美元)`@aglyn/plugins-ai/declarations`,也从 `.`: 插件的应享权利,其配置方案及其活动代码. 同上,注:.
-   `registerAiServerDeclarations` (单位:千美元)`@aglyn/plugins-ai/declarations.server`:平台事件订阅,账户时代扫描一个人的AI用法,以及用法提醒贡献者.
-   `aiSubprocessors` (单位:千美元)`@aglyn/plugins-ai/subprocessors`:第三方托管已注册的提供者向子处理器目录发送数据.

**来源布局 `src/lib`**

-   `providers/`: 供应商合同(`AiProvider`),登记处(`AI_PROVIDER_CONTRACT`, (中文(简体) ), `registerAiProvider`),模型目录,路由表,以及两个适配器, `anthropic.ts` 财务报告和审定财务报表 `openai-compatible.ts`。 。 。 .
-   `runtime/`:每条路线呼叫一次运行(`runAiRequest`),出入口,答题缓存,调色板和节点-树木验证器.
-   `jobs/`:一代工作机器,其步和节奏.
-   `tools/`:工具定义 工作步骤给一个提供者.
-   `usage/` 财务报告和审定财务报表 `billing/`:每条路线的储备和记录,按成员分配,以及超龄.
-   `insights/`, (中文(简体) ), `activity/`, (中文(简体) ), `model/`:图读取器和文摘,活性代码,工作与用法塑造出卡和路由共享,不依赖任何服务器.
-   `components/`:码头,牌和员工页.

## 使用量

该插件通过 Aglyn 的插件管理器加载: 控制台生成的加载器显示导入软件包并调用在 `plugins.config.json`。在启动时,电线插件用手拨打一次的应用程序:

```ts
// console, client side
import { registerAiConsole } from '@aglyn/plugins-ai'
registerAiConsole()

// console, server side
import { registerAiConsoleApi } from '@aglyn/plugins-ai/server'
registerAiConsoleApi()
```

增一供养. 另一个插件从服务器条目中根据同一合同注册自己的适配器;第一当事方适配器仅在尚未注册供应商时自己注册,所以先前注册的其中一个不会被替换:

```ts
import { registerAiProvider, type AiProvider } from '@aglyn/plugins-ai/server'

declare const myProvider: AiProvider
registerAiProvider(myProvider, { pluginId: 'my-plugin' })
```

一个 `AiProvider` 命名带有密钥的环境变量( q)`apiKeyEnv`),自己读取`readApiKey`),列出其模式,并执行 `complete` 财务报告和审定财务报表 `stream`。平台默认提供者是指定 `AI_PROVIDER` 登记时的环境变量,否则为第一个; `AI_DEFAULT_MODEL` 覆盖每个步骤类型的模型.

## 怎样才合适

一个插件软件包( E)`scope:plugin`) (中文(简体) ). 取决于核心`@aglyn/aglyn`(a) 租户包(`@aglyn/tenant-runtime`, (中文(简体) ), `@aglyn/tenant-data-admin`, (中文(简体) ), `@aglyn/tenant-feature-instance`)和通用软件 `@aglyn/shared-*` 软件包。 它没有导入其他插件 。 当一个任务写出另一个插件的资源时,例如运动,电子邮件设计或自动化,插件在核心接合器上注册一个草稿写作器,这个则叫接合;当一个任务读出另一个插件的数字或记录时,那个插件会注册一个读取器. 核心从不导入此套件, 并且只是 `src/lib/server.*` 被宣布为具有副作用.

## 许可证

阿帕奇2.0 (英语). 资料来源: [https://github.com/aglyn/aglyn/tree/main/libs/plugins/ai (英语)](https://github.com/aglyn/aglyn/tree/main/libs/plugins/ai)

## 常见问题

### @aglyn/plugins-ai 是什么？

Aglyn的AI插件:在座助手,Besigner复制助手,基因建筑和自动化工作,以及周围的用量和访问控制\. 它是供应商-通用的:每个特性都与供应商合同和供应商交谈

### 如何安装 @aglyn/plugins-ai？

在项目目录运行 npm install @aglyn/plugins-ai，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：next（^16\.3\.3）、react（^19\.2\.8）、firebase（^13\.0\.0）、@mui/material（^9\.3\.1）、firebase-admin（^14\.3\.0）、@mui/x-data-grid（^9\.12\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aglyn/plugins-ai 支持 TypeScript 吗？

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

### @aglyn/plugins-ai 支持 ESM 还是 CommonJS？

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

### @aglyn/plugins-ai 可以商用吗？

@aglyn/plugins-ai 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aglyn/plugins-ai 的下载量有多少？

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

### @aglyn/plugins-ai 还在维护吗？

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