# @mottyjs/core 中文文档

规范地址：https://npmcn.com/package/%40mottyjs/core/

版本：0\.2\.0
npm 元数据更新时间：2026-11-01T21:53:17.865Z
中文译文更新时间：2026-11-01T22:41:37.660Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40mottyjs/core
原文对照：https://npmcn.com/package/%40mottyjs/core/?lang=original
项目主页：https://github.com/skrrt-sh/motty-sdk/tree/main/packages/core#readme
源码仓库：https://github.com/skrrt-sh/motty-sdk

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

- 包体积（解压后）：389 kB，87 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-10-11T18:51:48.748Z
- 最新版本发布：2026-11-01T21:53:17.558Z
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

motty构建器、模型调用、回退、竞争、重试和超时、错误类和类型：所有motty或插件都需要。

## 安装

```sh
npm install @mottyjs/core
```

也可以使用：`pnpm add @mottyjs/core`、`yarn add @mottyjs/core`、`bun add @mottyjs/core`

## README

# @mottyjs /核心

Motty SDK的核心：所有Motty需要工作和一个插件需要编写。它拥有 这个 `motty` 建筑工人, `model`组合子 `fallback`， `race`， `retry` 和 `timeout`， `answer`， `reroute`， `think`， `said`，错误类和类型。它没有依赖关系，只有 导入的内容最终会出现在motty's bundle中。 `said(message)` 一条信息说的是什么，是不是 之际, `text` 或者作为部分。

```sh
bun add @mottyjs/core
```

```ts
import { fallback, model, motty, race, retry, reroute } from "@mottyjs/core";
```

在没有工具的情况下回答请求的motty，使用两个小模型中的第一个来回答，以及 任何其他有强模型的，重试两次，第二个在它后面：

```ts
import { fallback, model, motty, race, retry, reroute } from "@mottyjs/core";

const luna = model("openai/gpt-6-luna");
const sol = model("openai/gpt-6.1-sol");
const haiku = model("anthropic/claude-haiku-5-5");
const sonnet = model("anthropic/claude-sonnet-5-5");

export default motty({ name: "coder" })
  .route(({ request }) => (request.tools.length === 0 ? "quick" : "standard"), {
    // A quick question still gets an answer when both small models are down
    quick: ({ prompt }) => race(luna, haiku).complete(prompt).catch(() => reroute("standard")),
    standard: ({ prompt }) => fallback(retry(sonnet, 2), sol).complete(prompt),
  });
```

一个电话可能会说 `headers` 在响应它的请求的选项中。它们只被发送 其中主机的连接允许该名称，并且不带值的头被跳过：

```ts
const session = request.headers.get("x-session");
prompt.options = { ...prompt.options, headers: { "x-session": session } };
return sonnet.complete(prompt);
```

插件通过导入路径到达主机 `@mottyjs/core/host`.

SDK作为一个整体在 [根的自述](https://github.com/skrrt-sh/motty-sdk#readme)，以及其设计背后的原因 [ARCHITECTURE.md](https://github.com/skrrt-sh/motty-sdk/blob/main/ARCHITECTURE.md).

## 常见问题

### @mottyjs/core 是什么？

motty构建器、模型调用、回退、竞争、重试和超时、错误类和类型：所有motty或插件都需要。

### 如何安装 @mottyjs/core？

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

### @mottyjs/core 支持 TypeScript 吗？

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

### @mottyjs/core 支持 ESM 还是 CommonJS？

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

### @mottyjs/core 可以商用吗？

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

### @mottyjs/core 还在维护吗？

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