# @happyvertical/smrt-playbooks 中文文档

规范地址：https://npmcn.com/package/%40happyvertical/smrt-playbooks/

版本：0\.62\.1
npm 元数据更新时间：2026-11-17T07:55:42.187Z
中文译文更新时间：2026-11-17T09:40:03.422Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40happyvertical/smrt-playbooks
原文对照：https://npmcn.com/package/%40happyvertical/smrt-playbooks/?lang=original
项目主页：https://github.com/happyvertical/smrt#readme
源码仓库：https://github.com/happyvertical/smrt

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

- 包体积（解压后）：304 kB，39 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2026-09-02T07:43:06.786Z
- 最新版本发布：2026-11-17T07:55:41.968Z
- 近 30 天下载量：21161（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：186（近 12 个月 186 个）

## 中文简介

分层播放簿注册、应用程序/租户覆盖和SMRT代理的计划解析

## 安装

```sh
npm install @happyvertical/smrt-playbooks
```

也可以使用：`pnpm add @happyvertical/smrt-playbooks`、`yarn add @happyvertical/smrt-playbooks`、`bun add @happyvertical/smrt-playbooks`

## README

# @happyvertical/smrt-playbooks (欢快的垂直/游戏本)

有分层的游戏本定义、房客意识的超标和 特工们.

游戏本是一款被命名的,描述的由代理人所遵循的步骤序列. 它给了一个 多步骤意图——"检查出这辆车"——一个既非习惯的家 模式动作或视图意图,浏览器代理、程序内代理、节点MCP 服务器,并且 CLI 都遵循同样的解析计划.

## 安装

```bash
pnpm add @happyvertical/smrt-playbooks
```

## 快开始

```typescript
import { definePlaybook, resolvePlaybook } from '@happyvertical/smrt-playbooks';

// 1. Register a playbook's defaults at startup
definePlaybook({
  key: 'commerce.cart.checkout',
  title: 'Check out this cart',
  description: 'Submits the order and captures payment.',
  steps: [
    {
      kind: 'operation',
      model: '@happyvertical/smrt-commerce:Order',
      action: 'submit',
    },
    {
      kind: 'operation',
      model: '@happyvertical/smrt-commerce:Payment',
      action: 'capture',
    },
  ],
  onStepFailure: 'abort',
});

// 2. Resolve a plan for a caller on a plane
const resolution = await resolvePlaybook('commerce.cart.checkout', {
  db,
  plane: 'server',
});

if (!resolution.ok) {
  // Fails closed with a specific reason: unknown-playbook, disabled,
  // plane-not-declared, intent-registry-unavailable, unknown-intent.
  throw new Error(resolution.message);
}

for (const step of resolution.plan.steps) {
  // The agent executes each step itself; this package never does.
  // step.classification is inherited from the referenced operation.
}
```

## 这个软件包提供了什么

-   **`definePlaybook()`** ——全球进程中代码第一游戏本注册 注册,所以一个包船 自己的游戏本
-   **`resolvePlaybook()`** 分层分辨率:代码默认 = 配置覆盖 = 存储的应用程序覆盖 – 存储的租户覆盖 – 运行时间覆盖
-   **`PlaybookOverride`** - CRUD 应用级和租户级游戏手册模式 设置, 存储于 `_smrt_playbook_overrides`
-   **飞机有效性** - 游戏手册声明 `browser`, (中文(简体) ), `server`,或两者兼有,以及 未宣布的平面解析失败
-   **TTL 缓存** 键 `(key, tenantId)`,在覆盖保存/删除时无效

## 保证

-   **剧本是剧本,从来不是电话.** 解析返回计划; 无 这里执行一个步骤。 因此,游戏本绝不是当局的界限 每个步骤在运行时都会独立授权.
-   **步骤列表永远无法编辑 .** 无覆盖层,包括直接 模型写作,可以改变游戏本的步法. 一个特工描述它是什么 总是跟它接下来的步调相符.
-   **启用只收缩 .** 租户可以禁用游戏本;它永远不会 启用一个下层.
-   **未申报分类失败** 改为 `{ effect: 'destructive', idempotent: false, openWorld: true }`步骤永远不会 分类本身; 分类继承自引用 操作.

## 文档

-   见 [`AGENTS.md`](https://npmcn.com/package/%40happyvertical/smrt-playbooks/AGENTS.md) 用于软件包内部模式
-   见 [`docs/content/standards.md`](https://npmcn.com/package/docs/content/standards.md) 页:1 b. 单一权利公约
-   参见: [`@happyvertical/smrt-prompts`](https://npmcn.com/package/%40happyvertical/prompts) (层层覆盖) 模式此包镜像, [`@happyvertical/smrt-languages`](https://npmcn.com/package/%40happyvertical/languages), (中文(简体) ), [`@happyvertical/smrt-features`](https://npmcn.com/package/%40happyvertical/features)

## 常见问题

### @happyvertical/smrt-playbooks 是什么？

分层播放簿注册、应用程序/租户覆盖和SMRT代理的计划解析

### 如何安装 @happyvertical/smrt-playbooks？

在项目目录运行 npm install @happyvertical/smrt-playbooks，或使用 pnpm add / yarn add / bun add。

### @happyvertical/smrt-playbooks 支持 TypeScript 吗？

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

### @happyvertical/smrt-playbooks 支持 ESM 还是 CommonJS？

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

### @happyvertical/smrt-playbooks 可以商用吗？

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

### @happyvertical/smrt-playbooks 的下载量有多少？

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

### @happyvertical/smrt-playbooks 还在维护吗？

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

