# @agentworkforce/workload-router 中文文档

规范地址：https://npmcn.com/package/%40agentworkforce/workload-router/

版本：4\.2\.1
npm 元数据更新时间：2026-10-05T05:47:05.226Z
中文译文更新时间：2026-11-05T22:12:29.592Z
软件包许可：未声明

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

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

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

- 包体积（解压后）：116 kB，22 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-04-09T11:25:25.159Z
- 最新版本发布：2026-10-05T05:47:04.879Z
- 近 30 天下载量：13668（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：156（近 12 个月 156 个）

## 中文简介

安排和介绍劳动力代理工作量的公用事业.

## 安装

```sh
npm install @agentworkforce/workload-router
```

也可以使用：`pnpm add @agentworkforce/workload-router`、`yarn add @agentworkforce/workload-router`、`bun add @agentworkforce/workload-router`

## README

# @ agentworkforce/ workload- routter (英语)

安排和介绍劳动力代理工作量的公用事业.

## 安装

```bash
npm install @agentworkforce/workload-router
```

## 使用量

### `usePersona(intent, options?)`

虽然 `use*` 前缀, **这不是一个反应钩.** 这是一个平地 同步工厂:叫它,拿回来 `PersonaContext` 捆绑 已解决的人a 并分组安装元数据。 没有安装, 产出,或写入磁盘——运行 `install.commandString` 自己何时 你准备实现人的技能.

`usePersona` 只解决内部内置目录( e)`persona-maker` 编号 : `persona-authoring`) (中文(简体) ). 可选个人,例如: `code-reviewer` 财务报告和审定财务报表 `frontend-implementer` 通过可安装人a包和 应通过CLI/源级联装入,然后传递到 `useSelection` 或者说 `materializeSkillsFor`。 。 。 .

```ts
import { usePersona } from '@agentworkforce/workload-router';
```

#### 返回形状

```ts
const { selection, install } = usePersona('persona-authoring');
```

-   `selection`: 给定的意向/特征的解析对象。 包括 `personaId`, (中文(简体) ), `tier`, (中文(简体) ), `runtime`, (中文(简体) ), `skills`, (中文(简体) ), `inputs`, (中文(简体) ), `mount`,以及 `rationale`。 。 。 .
-   `install`: 分组安装元数据.
-   `install.plan`(笑声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) 当您读到此内容时, 没有进程运行 .
-   `install.command`: 完全安装命令作为 argv 阵列用于 `spawn`编号 :`execFile`。 。 。 .
-   `install.commandString`: 与外壳逃避字符串相同的完整安装命令.
-   `install.cleanupCommand` 编号 : `install.cleanupCommandString`(单位:千美元) `rm -rf` 提供商在安装时散开(提供商的锁被故意保存), 对于空的图案,这是空壳 `:`) (中文(简体) ). 等经纪人消耗了这些技能后再运行.

#### 示例

```ts
import { spawnSync } from 'node:child_process';
import { usePersona } from '@agentworkforce/workload-router';

const { selection, install } = usePersona('persona-authoring');

spawnSync(install.commandString, { shell: true, stdio: 'inherit' });
// hand `selection` to your harness launcher of choice.
```

## 人物形状

个人可以声明快速可见的运行时间输入 :

```jsonc
{
  "id": "release-checker",
  "intent": "release-check",
  "tags": ["release"],
  "description": "Checks release readiness.",
  "skills": [],
  "inputs": {
    "PACKAGE_NAME": {
      "description": "Package or workspace to inspect.",
      "env": "PACKAGE_NAME",
      "default": "."
    },
    "REPORT_PATH": "release-report.md"
  },
  "mount": {
    "readonlyPatterns": ["*", "!docs/**"]
  },
  "tiers": {
    "best": {
      "harness": "codex",
      "model": "openai-codex/gpt-5.3-codex",
      "systemPrompt": "Check $PACKAGE_NAME and write ${REPORT_PATH}.",
      "harnessSettings": {
        "reasoning": "high",
        "timeoutSeconds": 1200,
        "sandboxMode": "workspace-write",
        "workspaceWriteNetworkAccess": true
      }
    }
    // best-value and minimum omitted in this fragment
  }
}
```

输入键必须是env风格的大写名. 路由器验证并携带 b. 通过《公约》作出的声明 `PersonaSpec` 财务报告和审定财务报表 `PersonaSelection`; 发射器决定 如何解决和制造它们。 标准人物 kit 政策是明确的 值, env var, 默认, 然后失败 .

代码运行时间也可能设置 `harnessSettings.sandboxMode`, (中文(简体) ), `harnessSettings.approvalPolicy`, (中文(简体) ), `harnessSettings.workspaceWriteNetworkAccess`,以及 `harnessSettings.webSearch`;人物-kit 将那些地图映射到 Codex 发射旗上.

## 发展

```bash
pnpm --filter @agentworkforce/workload-router build
pnpm --filter @agentworkforce/workload-router test
```

## 常见问题

### @agentworkforce/workload-router 是什么？

安排和介绍劳动力代理工作量的公用事业\.

### 如何安装 @agentworkforce/workload-router？

在项目目录运行 npm install @agentworkforce/workload-router，或使用 pnpm add / yarn add / bun add。

### @agentworkforce/workload-router 支持 TypeScript 吗？

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

### @agentworkforce/workload-router 支持 ESM 还是 CommonJS？

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

### @agentworkforce/workload-router 可以商用吗？

@agentworkforce/workload-router 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @agentworkforce/workload-router 的下载量有多少？

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

### @agentworkforce/workload-router 还在维护吗？

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