@mottyjs/settings

中文文档
0.2.0发布于 2026/11/02Apache-2.0TypeScriptES Module构建来源已验证

在代码中定义的motty的类型设置:默认值,由主机提供的覆盖。

中文使用文档

@mottyjs /设置

Motty SDK的插件。 settings(groups) 在代码中定义一个motty的设置,每组a 模式,其每个值都有默认值。使用它们的部分从上下文中读出它们, 主机可以覆盖任何子集。一个错误的覆盖在开始时失败,尽管一个是异步模式 reject只写入stderr,因为mount立即返回,并且在第一次请求时写入Workers。

模式是任何标准模式验证器。这个例子使用了zod,而这个包没有 安装:

bun add @mottyjs/settings zod
import { settings, type Settings } from "@mottyjs/settings";

用zod定义的两个组,以及读取其中一个的部分:

import { motty } from "@mottyjs/core";
import { settings, type Settings } from "@mottyjs/settings";
import { z } from "zod";

const probability = z.number().min(0).max(1);

export const tuning = settings({
  offTopic: z.object({
    onTopicProbability: probability.default(0.1),
  }),
  structured: z.object({
    smallProbability: probability.default(0.7),
  }),
});

export type Tuning = Settings<typeof tuning>;

export const offTopic = motty({ name: "off-topic" })
  .use(tuning)
  .beforeHandle(({ settings }) => {
    console.log(settings.offTopic.onTopicProbability);
  });

SDK作为一个整体在 根的自述,以及其设计背后的原因 ARCHITECTURE.md.

版本与发布记录

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

版本发布日期距今
0.2.0latest2026/11/021 天前
0.1.12026/10/1321 天前
0.1.02026/10/1222 天前
0.0.0-stage2026/10/1222 天前

关于 @mottyjs/settings 的常见问题

@mottyjs/settings 是什么?

在代码中定义的motty的类型设置:默认值,由主机提供的覆盖。

如何安装 @mottyjs/settings?

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

@mottyjs/settings 支持 TypeScript 吗?

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

@mottyjs/settings 支持 ESM 还是 CommonJS?

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

@mottyjs/settings 可以商用吗?

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

@mottyjs/settings 还在维护吗?

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