# @agentworkforce/persona-kit 中文文档

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

版本：4\.2\.1
npm 元数据更新时间：2026-10-05T05:45:39.140Z
中文译文更新时间：2026-11-05T18:53:02.318Z
软件包许可：未声明

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

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

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

- 包体积（解压后）：960 kB，181 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-05-11T02:22:13.180Z
- 最新版本发布：2026-10-05T05:45:38.825Z
- 近 30 天下载量：53239（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：129（近 12 个月 129 个）

## 中文简介

Persona -kit拥有Agent Workforce的人 一个即时生命周期。 见跟踪问题 [64号](https://github.com/AgentWorkforce/workforce/issues/64)。 。 。 .

## 安装

```sh
npm install @agentworkforce/persona-kit
```

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

## README

# @ agentworkforce/ persona- kit (英语)

Persona -kit拥有Agent Workforce的人 一个即时生命周期。 见跟踪问题 [64号](https://github.com/AgentWorkforce/workforce/issues/64)。 。 。 .

## 顶级管弦乐 API

该套件暴露出两个阶段的API:a **纯计划构建器** 组成一个 persona的运行时间数据变为单一可检查值,a **副作用 执行器** 运行计划并返回一个反转每个侧的控点 效应.

### Persona JSON — 运行中的代理( 端到端)

```ts
import {
  buildPersonaSpawnPlan,
  executePersonaSpawnPlan,
  type ResolvedPersona
} from '@agentworkforce/persona-kit';
import { spawn } from 'node:child_process';

declare const persona: ResolvedPersona; // from loadPersonas() / personaCatalog

// 1. Compose a plan. Pure — no I/O, no subprocesses.
//    PlanOptions: inputValues, envOverrides, processEnv, installRoot.
//    cwd belongs to ExecuteOptions, not the plan builder.
const plan = buildPersonaSpawnPlan(persona, {
  inputValues: { TASK: 'tidy up the README' }
});

// 2. Inspect or stamp the plan if you like — it's JSON-serializable.
console.log(plan.cli, plan.args, plan.env);

// 3. Run the side effects. Returns a handle whose dispose() reverses them.
const handle = await executePersonaSpawnPlan(plan, { cwd: process.cwd() });

try {
  // 4. Spawn the harness at handle.cwd with plan.cli + plan.args + plan.env.
  await new Promise<void>((resolve, reject) => {
    const child = spawn(plan.cli, plan.args, {
      cwd: handle.cwd,
      env: plan.env,
      stdio: 'inherit'
    });
    child.on('error', reject);
    child.on('close', () => resolve());
  });
} finally {
  // 5. Tear down: removes installed skills, restores sidecar files,
  //    cleans up materialized config files, releases the mount.
  await handle.dispose();
}
```

### 计划结构

`PersonaSpawnPlan` 随心所欲,随心所欲

-   `persona` - 决心的人a(模型、用具、技能、入门、.).
-   `cli`, (中文(简体) ), `args`, (中文(简体) ), `initialPrompt` - 什么产物.
-   `env` ——有输入绑定的最后一个环境 + persona env 合并入.
-   `skills` - 纯度 `SkillMaterializationPlan` 生产 `materializeSkills`。 。 。 .
-   `mount`, (中文(简体) ), `sidecars`, (中文(简体) ), `configFiles`, (中文(简体) ), `inputs` - 已解决的部分准备就绪 执行者.

计划是 **JSON 连续** – 可用于被印入发射元数据 或通过电线发送(例如继电器) `getPersonaSpawnPlan`) (中文(简体) ).

### 分块帮助

对于想要自己的管弦乐的召唤者:

-   `applyPersonaMount(mount, options)` - 打开一个 `@relayfile/local-mount` 提供挂载策略时的沙盒, 否则不能 。 返回一个手柄 暴露绳子 `cwd`。 。 。 .
-   `runSkillInstalls(plan, options)` − 生成所生成的安装命令 以 `buildInstallArtifacts`在第一个非零退出时中止并附加 缓冲子进程输出到 `SkillInstallError`。 。 。 .
-   `writePersonaSidecars(sidecars, options)` 写作 `CLAUDE.md` 编号 : `AGENTS.md` 与还原处理语义.
-   `materializePersonaConfigFiles(configFiles, options)` - 写下绳子 配置文件(例如). `opencode.json`) 有还原处理语义.

每个助手返回形状的控点 `{ dispose(): Promise<void> }`。 。 。 . `executePersonaSpawnPlan` 编曲顺序:上 技能 侧车 - 配置文件。 如果任何步骤投出,则在LIFO中处理前手柄 在原始错误传播前排列.

### 纯低级助手

`buildInteractiveSpec`, (中文(简体) ), `materializeSkills`, (中文(简体) ), `parsePersonaFile`, (中文(简体) ), `resolvePersonaInputs`高级呼叫者如想要,可继续使用,等等 更好的控制 比计划制定者提供.

## 常见问题

### @agentworkforce/persona-kit 是什么？

Persona -kit拥有Agent Workforce的人 一个即时生命周期。 见跟踪问题 64号。 。 。 \.

### 如何安装 @agentworkforce/persona-kit？

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

### @agentworkforce/persona-kit 支持 TypeScript 吗？

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

### @agentworkforce/persona-kit 支持 ESM 还是 CommonJS？

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

### @agentworkforce/persona-kit 可以商用吗？

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

### @agentworkforce/persona-kit 的下载量有多少？

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

### @agentworkforce/persona-kit 还在维护吗？

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