@a16njs/models

中文文档
1.1.1发布于 2026/08/21AGPL-3.0TypeScriptES Module构建来源已验证近 30 天下载 2017

A16n 的定义和插件接口

中文使用文档
文档目录9 节
  1. 稳定
  2. 安装
  3. 使用量
  4. 出口
  5. 类型
  6. 插件接口
  7. 警告
  8. 帮助者
  9. 文档

@a16njs/ 型号

npm version codecov

A16n 的定义和插件接口类型 .

稳定

截止 1.0.0,导出类型和 A16nPlugin 界面是稳定的,并遵循语义化的版本:打破对公共API的修改来撞倒主要版本.

安装

npm install @a16njs/models

使用量

import {
  CustomizationType,
  type A16nPlugin,
  type AgentCustomization,
  type GlobalPrompt,
  isGlobalPrompt,
  createId,
} from '@a16njs/models';

出口

类型

  • CustomizationType - 定制类型的数字(GlobalPrompt、SimpleAgentSkill、AgentSkillIO、文件规则、AgentIgnore、ManualPrompt)
  • AgentCustomization - 所有定制的基本接口
  • GlobalPrompt - 总是应用的提示
  • SimpleAgentSkill - 通过描述触发背景
  • AgentSkillIO - 具有资源/档案的复杂技能
  • FileRule - 按文件模式触发
  • AgentIgnore - 忽略图案
  • ManualPrompt - 用户提示的提示(例如, /command),存储于 .cursor/skills/ 或者说 .claude/skills/ 与 disable-model-invocation: true

插件接口

  • A16nPlugin - 插件必须执行的接口
  • DiscoveryResult - 发现定制产品的结果
  • EmitResult - 排放定制产品的结果
  • WrittenFile - 有关书面文件的信息

警告

  • WarningCode - 警告代码数字(Merged、近似、跳过、覆盖)
  • Warning - 警告结构

帮助者

  • isGlobalPrompt(item) - 全球Prompt的护卫类型
  • isSimpleAgentSkill(item) - 简易代理技能的型式警卫
  • isAgentSkillIO(item) - 特工SkillIO的防守类型
  • isFileRule(item) - 文件规则的护卫类型
  • isAgentIgnore(item) - 特工Ignore的防守类型
  • isManualPrompt(item) - 手动Prompt的护卫类型
  • createId(type, sourcePath) - 创建独特的ID

文档

备有文件全文 https://texarkanine.github.io/a16n/ 模特儿。 。 。 .

版本与发布记录

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

版本发布日期距今
1.1.1latest2026/08/212 个月前
1.1.02026/07/273 个月前
1.0.02026/06/144 个月前
0.14.12026/06/144 个月前
0.14.02026/06/134 个月前
0.13.02026/04/226 个月前

关于 @a16njs/models 的常见问题

@a16njs/models 是什么?

A16n 的定义和插件接口

如何安装 @a16njs/models?

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

@a16njs/models 支持 TypeScript 吗?

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

@a16njs/models 支持 ESM 还是 CommonJS?

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

@a16njs/models 需要什么版本的 Node.js?

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

@a16njs/models 可以商用吗?

@a16njs/models 使用 AGPL-3.0 许可。最严格的 Copyleft:除分发外,通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括,不构成法律意见,请以许可原文为准。

@a16njs/models 的下载量有多少?

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

@a16njs/models 还在维护吗?

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