@godspeedai/cognate-profile

中文文档
0.10.0发布于 2026/11/16Apache-2.0ES Module构建来源已验证近 30 天下载 3422

定义Profile:可重复使用的应用程序组成,用于选择和配置没有新内核概念的组件(spec §29).

中文使用文档
文档目录6 节
  1. 安装
  2. 快开始
  3. 类型保证
  4. 限制
  5. 相关软件包
  6. 许可证

@ godspideai/ cognate- profile( 缩写)

钴应用的申报成分: defineProfile 指定已注册组件的顺序选择及其配置,以及 resolveProfile 将选择变成贡献。 配置文件不添加内核概念——它们只选择和配置已经注册的软件包.

何时使用此软件包 : 您正在定义一个可重复使用的应用程序组成(“ profile” ),或者将配置解析结果建构登记册。 现成简介包括: @godspeedai/cognate-profile-harness 财务报告和审定财务报表 @godspeedai/cognate-profile-copilot。 。 。 .

安装

bun add @godspeedai/cognate-profile

要求数 阿宝 >= 1.4.0.

快开始

import { defineProfile, resolveProfile } from "@godspeedai/cognate-profile";
import type { ComponentEntry } from "@godspeedai/cognate-profile";

// A registry: entries a package provides, each producing one contribution.
const registry: ComponentEntry<string[]>[] = [
  {
    name: "sessions",
    package: "@godspeedai/cognate-runtime-bun",
    supported: true,
    contribute: () => ["sessions"],
  },
  {
    name: "agents",
    package: "@godspeedai/cognate-runtime-bun",
    supported: true,
    contribute: (options) => [`agents:${JSON.stringify(options ?? null)}`],
  },
];

// Validate and freeze the profile. Names must be unique and non-empty.
const profile = defineProfile({
  name: "research-workbench",
  description: "Sessions plus a bounded agent pool",
  components: ["sessions", "agents"],
  options: { agents: { max: 2 } },
});

const resolved = resolveProfile(profile, registry);
resolved.contributions; // [{ name: "sessions", ... }, { name: "agents", contribution: 'agents:{"max":2}' }]
resolved.unresolved; // every requested name that could not be included, with a reason

resolveProfile 将配置文件的组件按顺序排列,调用 contribute(profile.options[name]) 仅用于支持的条目。 报告姓名不明,原因不明 "unknown component"; 标出条目 supported: false 报告本身的理由。 没有什么是默默地放弃的.

类型保证

  • defineProfile 返回深冻 ProfileDefinition: 定义后组件列表和选项不能被变异, 而验证错误抛出 ProfileError 定义时间,而不是解析时间.
  • ResolvedProfile 分离 contributions (按配置顺序,每个标记其源包) unresolved (要求但缺席,每个都有原因),所以一个组成可以确切地显示它运行的是什么,以及为什么缺少任何东西.
  • ComponentEntry.supported: false 明确记录一个无法读取的组件,并有可人阅读的 reason。 。 。 .

限制

  • 纯粹的数据:这个软件包验证和解决了——它没有挂载什么,没有开始什么,自己也不知道登记。 打电话者拥有什么 contribute 返回,以及解析后的捐款情况.
  • 选项与此软件包不透明;它们被传递到每个条目的 contribute 无所未有.

许可证

阿帕奇 - 2.0

版本与发布记录

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

版本发布日期距今
0.10.0latest2026/11/16今天
0.9.22026/11/152 天前
0.9.12026/11/143 天前
0.9.02026/11/0610 天前
0.8.02026/10/2720 天前
0.7.12026/10/2523 天前

关于 @godspeedai/cognate-profile 的常见问题

@godspeedai/cognate-profile 是什么?

定义Profile:可重复使用的应用程序组成,用于选择和配置没有新内核概念的组件(spec §29).

如何安装 @godspeedai/cognate-profile?

在项目目录运行 npm install @godspeedai/cognate-profile,或使用 pnpm add / yarn add / bun add。

@godspeedai/cognate-profile 支持 TypeScript 吗?

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

@godspeedai/cognate-profile 支持 ESM 还是 CommonJS?

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

@godspeedai/cognate-profile 可以商用吗?

@godspeedai/cognate-profile 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@godspeedai/cognate-profile 的下载量有多少?

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

@godspeedai/cognate-profile 还在维护吗?

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