@happyvertical/smrt-playbooks

中文文档
0.62.1发布于 2026/11/17MITTypeScriptES Module近 30 天下载 2.1万

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

中文使用文档
文档目录5 节
  1. 安装
  2. 快开始
  3. 这个软件包提供了什么
  4. 保证
  5. 文档

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

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

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

安装

pnpm add @happyvertical/smrt-playbooks

快开始

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 }步骤永远不会 分类本身; 分类继承自引用 操作.

文档

版本与发布记录

@happyvertical/smrt-playbooks 共发布 186 个版本,首次发布于 2026/09/02;过去 12 个月发布了 186 个版本。

版本发布日期距今
0.62.1latest2026/11/17今天
0.62.02026/11/17今天
0.61.62026/11/161 天前
0.61.52026/11/161 天前
0.61.42026/11/161 天前
0.61.32026/11/152 天前

关于 @happyvertical/smrt-playbooks 的常见问题

@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 和提交记录判断。