# @agent-native/dispatch 中文文档

规范地址：https://npmcn.com/package/%40agent-native/dispatch/

版本：0\.42\.4
npm 元数据更新时间：2026-11-10T20:54:28.775Z
中文译文更新时间：2026-11-10T21:57:43.212Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：9.3 MB，1768 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：45 个
- peer 依赖：react \>=19\.2\.7，react-dom \>=19\.2\.7，react-router \>=8，@agent-native/core \>=0\.227\.0-0
- 首次发布：2026-05-04T23:45:16.266Z
- 最新版本发布：2026-11-10T20:54:28.377Z
- 近 30 天下载量：33278（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：1116（近 12 个月 1116 个）

## 中文简介

调度——代理本地应用程序的工作空间控制平面. 空地,集成地,目的地,预定工作,以及跨应用代表团,作为一包出货.

## 安装

```sh
npm install @agent-native/dispatch
```

也可以使用：`pnpm add @agent-native/dispatch`、`yarn add @agent-native/dispatch`、`bun add @agent-native/dispatch`

## README

# @ agent- native/ 发送

调度是代理 - Native工作空间控制平面和单独的产品. 这不是工具包能力模块.

代理本地应用程序的工作空间控制平面——金库,集成, 目的地 交叉应用工作空间资源 反复出现的"梦想"报告工作, 和跨应用程序代表团, 以单一的快递包运.

权力 `dispatch` 模板。 规定:

-   **Drizzle 计划** - 目的地、身份链接、链接标志、批准 请求、审计活动、梦想报告/建议、金库秘密/赠款/ 请求/审计、工作空间资源/赠款
-   **服务器层** —— 说 `setupDispatch(config)` + 认证的硝基插件, 集成、代理聊天、数据库和核心路由
-   **行动** - ~90岁 `defineAction` 模块(故障赠款/请求、工作空间) 资源赠款、目的地、梦想工作、提供者-api目录/文件/ 请求, 黑线上下文, 连接代理发现, 审计/批准, 作为代理工具+ HTTP 端点消耗的平台消息,以及更多
-   **路线** 完全回放路由器 7 `RouteConfig[]` (聊天,综述,应用, 保险库 整合 代理 工作空间 通讯 目的地, 身份、批准、自动化、审计、设置、梦想、扩展、, .) 被挤入消费者的 `app/routes.ts`
-   **反应组件** —— 说 `DispatchShell`, (中文(简体) ), `Layout`编号 :`NavContent`, (中文(简体) ), `CreateAppPopover`编号 :`CreateAppFlow`, (中文(简体) ), `AppKeysPopover`,加满分 阴影/ 依地 `components/ui/*` 原始设定. `SimpleAgentsPanel` 实值 也导出将共享代理管理器嵌入到另一个工作空间 UI 中 .
-   **样式** —— 说 `dispatch.css` 尾风层

## 安装

```bash
pnpm add @agent-native/dispatch
```

对等依赖 `@agent-native/core` (单位:千美元)`>=0.8.0`, (中文(简体) ), `react`编号 :`react-dom` (单位:千美元)`>=19.2.7`),以及 `react-router` (单位:千美元)`>=8`) (中文(简体) ).

## 编曲

模板 `app/routes.ts`数字 :

```ts
import { type RouteConfig } from "@react-router/dev/routes";
import { dispatchRoutes } from "@agent-native/dispatch/routes";

export default [
  ...localRoutes, // consumer's own routes win on collision
  ...dispatchRoutes, // dispatch fills in everything else
] satisfies RouteConfig;
```

模板 `server/plugins/*.ts` (每个导出都保存在自己的文件中 所以Nitro 自动加载:

```ts
// server/plugins/setup-dispatch.ts
import { setupDispatch } from "@agent-native/dispatch/server";
export default setupDispatch({ auth: { googleOnly: true } });

// server/plugins/auth.ts
export { dispatchAuthPlugin as default } from "@agent-native/dispatch/server";

// server/plugins/integrations.ts
export { dispatchIntegrationsPlugin as default } from "@agent-native/dispatch/server";

// server/plugins/agent-chat.ts
export { dispatchAgentChatPlugin as default } from "@agent-native/dispatch/server";

// server/plugins/db.ts
export { dispatchDbPlugin as default } from "@agent-native/dispatch/server";

// server/plugins/core-routes.ts
export { dispatchCoreRoutesPlugin as default } from "@agent-native/dispatch/server";
```

模板 `server/db/schema.ts`数字 :

```ts
export * from "@agent-native/dispatch/db";
```

`@agent-native/dispatch/actions` 大部分不需要手动导入 消费者: `import "@agent-native/dispatch/server"` (由插件驱动) 副作用登记员通过 `registerPackageActions`,框架的 `autoDiscoverActions` 合并 在消费者在当地之后 `actions/` 目录。 丢出同名词 消费者自己的文件 `actions/` 以覆盖任何单一动作.

## 出口

| 子路径 | 这是什么 |
| --- | --- |
| `.` | 仅共享配置类型 —— `DispatchConfig`, (中文(简体) ), `DispatchAuthConfig`, (中文(简体) ), `DispatchIntegrationsConfig`。当需要类型时,不绘制服务器/客户端代码. |
| `./routes` | `dispatchRoutes` 方案 `RouteConfig[]` 覆盖每个调度页面(聊天、概览、度量衡、操作、应用、金库、集成、代理、工作空间、通讯、目的地、身份、批准、自动化、审计、设置、梦想、扩展、线程调试、团队、以及工作空间-应用全面路线). |
| `./routes/pages/*` | 单个编译的页面模块上方的路径(例如:. `./routes/pages/vault.js`) (中文(简体) ). 通常不直接进口. |
| `./server` | `setupDispatch(config)` 加硝基插件集 : `dispatchAuthPlugin`, (中文(简体) ), `dispatchIntegrationsPlugin`, (中文(简体) ), `dispatchAgentChatPlugin`, (中文(简体) ), `dispatchDbPlugin`, (中文(简体) ), `dispatchCoreRoutesPlugin`。导入此模块还输入所有调度动作. |
| `./shared/feature-flags` | 违约 `DISPATCH_WORKSPACE_SSO_FLAG` 定义用于安全瞄准浏览器工作空间的签名. |
| `./shared/workspace-sso` | 精确的第一当事方工作空间SSO起源和由调度和身份中心共享的添加剂自定义注册解析器. |
| `./server/lib/thread-link-preview` | `loadThreadLinkPreview(threadId)` ——只用于服务器的帮助器(阅读请求上下文并检查线程所有权),用于构建共享线程URL的链接-预览元数据. |
| `./actions` | `dispatchActions` 平起平起的名称 `ActionEntry` 每个调度行动的地图(故障、工作空间资源、目的地、梦想工作、提供者-api目录/文件/请求、连接代理人、审计、批准、平台信息等等). |
| `./db` | `getDb()` 编号 : `db()`滴水龙头 `schema` 名称空间, 调度表导出( N)`dispatchDestinations`, (中文(简体) ), `dispatchIdentityLinks`, (中文(简体) ), `dispatchLinkTokens`, (中文(简体) ), `dispatchApprovalRequests`, (中文(简体) ), `dispatchAuditEvents`, (中文(简体) ), `dispatchDreams`, (中文(简体) ), `dispatchDreamProposals`, (中文(简体) ), `vaultSecrets`, (中文(简体) ), `vaultGrants`, (中文(简体) ), `vaultRequests`, (中文(简体) ), `vaultAuditLog`, (中文(简体) ), `workspaceResources`, (中文(简体) ), `workspaceResourceGrants`),和迁移. |
| `./lib/thread-link-preview` | 服务器后面的异形助手 上面一个.. `extractThreadPreviewImageUrl`, (中文(简体) ), `buildThreadLinkPreviewMeta`,则 `ThreadLinkPreview` 类型。 从客户端代码导入安全 . |
| `./components` | 用于自定义布局的 Escape-hatch UI 部件 : `DispatchShell`, (中文(简体) ), `Layout`编号 :`NavContent` (单位:千美元) `DispatchExtensionConfig`编号 :`DispatchNavIcon`编号 :`DispatchNavItem`编号 :`DispatchNavSection` 类型), `CreateAppPopover`编号 :`CreateAppFlow`, (中文(简体) ), `AppKeysPopover`。大多数消费者只需要 `dispatchRoutes` 绝不直接从这里进口. |
| `./components/ui/*` | Shadcn/ui原始设定 调度局自己的UI是建立在(`button`, (中文(简体) ), `dialog`, (中文(简体) ), `dropdown-menu`, (中文(简体) ), `card`, (中文(简体) ), `command`, (中文(简体) ), `calendar`, (中文(简体) ), `chart`,...),每个文件都输出,这样消费者就可以再用一个原始的而不用拉入其他的. |
| `./styles/dispatch.css` | 有调度专用风格的尾风层. 在消费者的全球CSS条目中导入一次. |

构成导出布局的主机可以标出其桌面和移动 一起导航而无需执行调度 :

```tsx
import { Layout } from "@agent-native/dispatch/components";

<Layout brandName="Acme Workspace" brandIcon={<AcmeMark />}>
  {children}
</Layout>;
```

## 校验社区模板分支

当分支核查失败时,组织所有人或管理人员可以拨打 `inspect-community-builder-backup` 仅限 `branchName`。其内容为: 来自组织保存的构建器项目的备份和分支状态元数据 以显示备份是否为部分、有效、完整和当前,是否为 分支活动、存档、被删除或未知,以及它是否闲置 未倾斜变化. 它只读取现有的状态元数据;它不要求 备份、下载捆绑或验证应用程序文件. `backupPartial` 返回时 `missing` 或者说 `invalid` 当供应商旗没有时 它从来不强迫那些案件 `false`。 。 。 . 明确提供者 `invalid`编号 :`no-backup` 没有备份对象的状态为 a 类型 `status_no_backup` 失败; 其他缺失的备份对象仍然不正确 状态失败. `verificationPerformed` 总是 `false`启用 `verify-curated-community-app` 对于单独的散列核查步骤. 核查者请求捆绑下载的 URL 并可能刷新提供者备份 状态;此状态动作没有。 状态元数据仅为诊断 从未授权安装或重试 .

组织业主和管理人员可以打电话 `verify-curated-community-app` 与 `sourceId`, (中文(简体) ), `appId`,以及 `branchName` 以选中已有的构建器分支 组织配置的构建器项目。 项目选择和审查 文件指针来自调度;呼叫者无法提供另一个工程或散列.

动作使用保存的构建器连接到项目读取访问. 这个 需要一个完整的备份, 其消化和永恒的承诺 匹配闲置, 读取其"Git"捆绑前后的清洁分枝. 每一个普通文件下 `apps/<appId>` 必须与审查过的模板的确切路径和 Git blob 散列匹配; 缺少、额外、更改或链接文件无法校验。 结果包含 承诺并存档散列, 不包含文件内容或签名下载 URL .

服务器需要一个可写入的临时目录 。 核查界限包 在 JavaScript Git 读取器打开一个孤立的对象商店前解压, 从不检查或执行应用程序代码,并删除其临时文件. 或部分备份, 无法验证的身份、访问错误和大小限制都无法关闭 .

核查不安装应用程序、准许访问、更改社区实验室或 标记一个应用程序准备。 尚未安装的建构器- 模组群落仍为已禁用 已核实生成分支接受.

## 是为了什么

调度是位于单个模板之上的工作空间控制平面 应用程序 :

-   **默认** - 与请求分享工作空间秘密, 每个应用程序都有范围.
-   **工作空间资源** • 交叉应用资源(例如共用指示或 (d) 提供明确的赠款和有效文本解析.
-   **简单的代理和代理包** ——可重复使用的代理保持克洛德兼容性 Markdown/JSON 简介 at `agents/<slug>.md` 并可以在 `agents/<slug>/context/`, (中文(简体) ), `references/`,以及 `skills/<name>/SKILL.md`编辑 `import-agent-pack` 财务报告和审定财务报表 `list-agent-pack` 动作创建/读取整个包; `import-agent` 仍然是快速的单文件路径。 不安全的能力,例如: 证书、钩子、 shell 命令和本地环境设置 剥去或报告为警告。 Pack 文件是文本资源, 而不是一个 执行补助.
-   **整合和目的地** - 外出消息频道设置(Slack, 团队、Discord、Telegram、WhatsApp、电子邮件等)和目的地 队列用于发送代理输出.
-   **梦想工作** - 经常性的背景工作(`ensure-dream-job`扫描 代理线程调试历史跨连接源并生成待处理, (b) 证据支持的建议`create-dream-report`, (中文(简体) ), `list-dream-candidates`, (中文(简体) ), `apply-dream-proposal` 编号 : `reject-dream-proposal`没有额外的LLM呼叫.
-   **连接的代理和提供者 API** 发现其他工作空间应用软件 (单位:千美元)`list-connected-agents`, (中文(简体) ), `open_app`, (中文(简体) ), `ask_app`)和一个通用提供者-api 目录/文件/请求通过存储的第三方API 证书.
-   **核准和审计** - 采用共同核准请求/审计活动模式 横跨上述表面.

## 弹出

没有 `agent-native.package.json` / CLI 包生命周期接线 此软件包至今( 不同于 `@agent-native/scheduling`) (中文(简体) ). 超越自定义 `setupDispatch` 配置表面, 复制您想要拥有的文件 `node_modules/@agent-native/dispatch/src` 转换到您的软件包中 手动依赖.

## 常见问题

### @agent-native/dispatch 是什么？

调度——代理本地应用程序的工作空间控制平面\. 空地,集成地,目的地,预定工作,以及跨应用代表团,作为一包出货\.

### 如何安装 @agent-native/dispatch？

在项目目录运行 npm install @agent-native/dispatch，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=19\.2\.7）、react-dom（\>=19\.2\.7）、react-router（\>=8）、@agent-native/core（\>=0\.227\.0-0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @agent-native/dispatch 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/agent-native\_\_dispatch 是否存在。

### @agent-native/dispatch 支持 ESM 还是 CommonJS？

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

### @agent-native/dispatch 可以商用吗？

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

### @agent-native/dispatch 的下载量有多少？

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

### @agent-native/dispatch 还在维护吗？

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