# @dbx-tools/shared-teams 中文文档

规范地址：https://npmcn.com/package/%40dbx-tools/shared-teams/

版本：0\.9\.144
npm 元数据更新时间：2026-10-20T04:39:51.654Z
中文译文更新时间：2026-11-12T03:43:29.908Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40dbx-tools/shared-teams
原文对照：https://npmcn.com/package/%40dbx-tools/shared-teams/?lang=original
项目主页：https://github.com/reggie-db/dbx-tools#readme
源码仓库：https://github.com/reggie-db/dbx-tools

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

- 包体积（解压后）：79.3 kB，13 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-07-27T17:57:26.502Z
- 最新版本发布：2026-10-20T04:39:51.330Z
- 近 30 天下载量：3033（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：261（近 12 个月 261 个）

## 中文简介

浏览器安全适应卡和两个小组的瓶子框架活动计划

## 安装

```sh
npm install @dbx-tools/shared-teams
```

也可以使用：`pnpm add @dbx-tools/shared-teams`、`yarn add @dbx-tools/shared-teams`、`bun add @dbx-tools/shared-teams`

## README

# @dbx-tools/ 共享团队

验证微软团队的适应卡和瓶子框架活动有效载荷 浏览器和服务器代码. 它定义了共享的Zod计划,推断类型, 附加辅助器和常数。 这个 [@dbx-工具/团队](https://npmcn.com/package/node/teams) 服务器包构建这些有效载荷,以及 [@dbx-tools/ui-teams (英语)](https://npmcn.com/package/ui/teams) 让他们.

## 快开始

```ts
import { card } from "@dbx-tools/shared-teams";

const spec = card.cardSpecSchema.parse({
  title: "Deployment succeeded",
  text: "The API service rolled out cleanly.",
});
```

利用这些合同和建筑商:

-   高级别 `CardSpec` 合同:小的、方便模型的词汇是一个模型 草案(标题、字幕、文本、事实、联系行动)而不是手写 原始适配卡JSON.
-   `AdaptiveCard` 用于编译的可调适卡 1.5文档的封装方案 `adaptivecards` 变相器消耗 团队接受.
-   `CardResult` 构建响应的计划返回到模型或浏览器中.
-   `Activity` 对话终点合同: Bot 框架信封 a 团队频道交换,与 `CardAttachment` 标记卡为 `application/vnd.microsoft.card.adaptive`,加上 `toCardAttachment` 编号 : `cardsOf` 帮助双方使用此附件 同样的。 未知的活动区得到保留而不是剥去 因为一个真实的频道发送远不止这个软件包读取.
-   避免JSON Schema限制的模型/工具友好计划 一些服务端点的问题( 无数组) `minItems`) (中文(简体) ).

## 验证卡片字段

```ts
import { card, type CardSpec } from "@dbx-tools/shared-teams";

const spec: CardSpec = card.cardSpecSchema.parse({
  title: "Deployment succeeded",
  subtitle: "prod • 2m ago",
  text: "The **api** service rolled out cleanly.",
  facts: [
    { title: "Version", value: "1.4.2" },
    { title: "Owner", value: "alice" },
  ],
  actions: [{ title: "View run", url: "https://example.com/runs/42" }],
});
```

Spec schema是故意小的 所以一个模型产生有效的输入 而不是免费卡 JSON 制造者会拒绝.

## 验证已编译的卡片

```ts
const result = card.cardResultSchema.parse(await response.json());
// result.card is a full Adaptive Card document ready to render or post to Teams.
```

`adaptiveCardSchema` 验证通用信封字段 : `type`, (中文(简体) ), `$schema`, (中文(简体) ), `version`,以及 `body`。在 [@dbx-工具/团队](https://npmcn.com/package/node/teams) 定义内部的确切元素形状 `body` 财务报告和审定财务报表 `actions`。 。 。 .

## 运行时边界

此软件包不渲染出卡, 运行代理, 验证 Microsoft Bot 框架 或贴给团队。 使用 [@dbx-工具/团队](https://npmcn.com/package/node/teams) 这些 服务器操作和 [@dbx-tools/ui-teams (英语)](https://npmcn.com/package/ui/teams) 用于反应 翻译.

## 软件包出口

-   `card`数字 : `cardFactSchema`, (中文(简体) ), `cardActionSchema`, (中文(简体) ), `cardSpecSchema`, (中文(简体) ), `adaptiveCardSchema`, (中文(简体) ), `cardResultSchema`,则 `ADAPTIVE_CARD_VERSION` 编号 : `ADAPTIVE_CARD_SCHEMA_URL` 常数和平方推断类型: `CardFact`, (中文(简体) ), `CardAction`, (中文(简体) ), `CardSpec`, (中文(简体) ), `AdaptiveCard`,以及 `CardResult`。 。 。 .
-   `teamsActivity`数字 : `activitySchema`, (中文(简体) ), `activityRequestSchema`, (中文(简体) ), `activityResponseSchema`, (中文(简体) ), `cardAttachmentSchema`, (中文(简体) ), `channelAccountSchema`, (中文(简体) ), `conversationAccountSchema`,则 `ADAPTIVE_CARD_CONTENT_TYPE` 编号 : `ACTIVITY_TYPES` 常数 `toCardAttachment` 编号 : `cardsOf` 帮助者,和 页:1 `Activity`, (中文(简体) ), `ActivityRequest`, (中文(简体) ), `ActivityResponse`, (中文(简体) ), `CardAttachment`, (中文(简体) ), `ChannelAccount`, (中文(简体) ), `ConversationAccount`,以及 `ActivityType` 类型.

故意避免阵列 `.min()` 限制,使其可以再利用 作为JSON为拒绝的终点服务的模型/工具 `minItems`。 。 。 .

## 常见问题

### @dbx-tools/shared-teams 是什么？

浏览器安全适应卡和两个小组的瓶子框架活动计划

### 如何安装 @dbx-tools/shared-teams？

在项目目录运行 npm install @dbx-tools/shared-teams，或使用 pnpm add / yarn add / bun add。

### @dbx-tools/shared-teams 支持 TypeScript 吗？

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

### @dbx-tools/shared-teams 支持 ESM 还是 CommonJS？

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

### @dbx-tools/shared-teams 可以商用吗？

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

### @dbx-tools/shared-teams 的下载量有多少？

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

### @dbx-tools/shared-teams 还在维护吗？

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