@directus/ai

中文文档
1.4.0发布于 2026/10/28MITES Module零依赖构建来源已验证近 30 天下载 15.7万

Directus AI的共享AI类型和模型定义

中文使用文档
文档目录5 节
  1. 概览
  2. 添加新模式
  3. 1. 联合国. packages/ai/src/models.ts
  4. 2. 联合国. packages/system-data/src/fields/settings.yaml
  5. 3. 默认允许的模型(可选)

@ directus/ai (英语)

Directus AI特征的共享AI类型和模型定义.

概览

此套件包含:

  • AI 提供者、模型和工具的类型定义
  • 具有能力和定价的默认模型定义
  • 用于构建自定义模型定义的辅助功能

添加新模式

当在现有提供者中添加新模型时,更新这些文件:

1. 联合国. packages/ai/src/models.ts

将模型添加到 DEFAULT_AI_MODELS数字 :

{
  provider: 'openai',
  model: 'gpt-6',
  name: 'GPT-6',
  limit: { context: 500_000, output: 100_000 },
  cost: { input: 2.0, output: 8.0 },
  attachment: true,
  reasoning: true,
}

2. 联合国. packages/system-data/src/fields/settings.yaml

将模型添加到适当的位置 ai_*_allowed_models 选项 :

- field: ai_openai_allowed_models
  options:
    choices:
      # ... existing models
      - text: GPT-6
        value: gpt-6

3. 默认允许的模型(可选)

如果默认启用新模式,请添加到 DEFAULT_ALLOWED_MODELS 内 packages/ai/src/models.ts这个 适用于每个安装 ai_*_allowed_models 设置仍然 null (从未定制),所以没有迁移 需要帮助.

版本与发布记录

@directus/ai 共发布 8 个版本,首次发布于 2026/02/06;过去 12 个月发布了 8 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.4.0latest2026/10/2815 天前
1.3.22026/06/115 个月前
1.3.2-rc.0canary2026/05/295 个月前
1.3.12026/03/257 个月前
1.3.02026/03/118 个月前
1.2.02026/03/058 个月前

关于 @directus/ai 的常见问题

@directus/ai 是什么?

Directus AI的共享AI类型和模型定义

如何安装 @directus/ai?

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

@directus/ai 支持 TypeScript 吗?

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

@directus/ai 支持 ESM 还是 CommonJS?

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

@directus/ai 可以商用吗?

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

@directus/ai 的下载量有多少?

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

@directus/ai 还在维护吗?

最新版本 1.4.0 发布于 2026/10/28(15 天前);至今共发布 8 个版本,其中过去 12 个月发布了 8 个;首次发布于 2026/02/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。