# @agentproto/apps 中文文档

规范地址：https://npmcn.com/package/%40agentproto/apps/

版本：0\.27\.0
npm 元数据更新时间：2026-11-05T17:46:38.262Z
中文译文更新时间：2026-11-06T02:39:03.092Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40agentproto/apps
原文对照：https://npmcn.com/package/%40agentproto/apps/?lang=original
项目主页：https://agentproto.sh/docs/aip-53
源码仓库：https://github.com/agentproto/ts

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

- 包体积（解压后）：5.1 MB，205 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：@mastra/core \>=1\.0\.0
- 首次发布：2026-07-19T14:39:18.026Z
- 最新版本发布：2026-11-05T17:46:37.890Z
- 近 30 天下载量：6240（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：50（近 12 个月 50 个）

## 中文简介

@agentproto/apps——现成的Agentprotoapps(代理团队+他们的工作流程)的家,以@agentproto/app宣布. 导入一个团队( 代码小组, 内容小组, ) , 并使用您主机中的任何代理/ 工作流程 : 通过 MastraAgents () 进行中

## 安装

```sh
npm install @agentproto/apps
```

也可以使用：`pnpm add @agentproto/apps`、`yarn add @agentproto/apps`、`bun add @agentproto/apps`

## README

# @ agentproto/ apps (签名)

制成的活性剂 **应用程序** —— 说 _团队_ 代理加上他们运行的工作流程, 每个声明 [`@agentproto/app`](https://npmcn.com/package/%40agentproto/app)。导入一个团队,使用任意 其代理/工作流的子集来自您的主机.

```ts
import { codeTeam } from "@agentproto/apps/code-team"

// In-process: build the team and pick the agent(s) you want.
const built = await codeTeam.toMastraAgents({ resolveModel: (ref) => registry.resolve(ref) })
built["@agentproto/reviewer"].agent   // just the reviewer, as a runnable Mastra agent

// …or use several. The record is keyed by agent id.
const { ["@agentproto/implementer"]: impl, ["@agentproto/fixer"]: fixer } = built
```

这里的应用程序是普通的 `AppHandle` —— 说 `codeTeam.agents`, (中文(简体) ), `codeTeam.workflows`, (中文(简体) ), `codeTeam.toMastraAgents(...)`, (中文(简体) ), `codeTeam.emit(dir)`没有新的东西可以学习.

## 团队

| 团队 | 导入 | 探员 | 工作流量 |
| --- | --- | --- | --- |
| `code-team` | `@agentproto/apps/code-team` | `implementer` → `reviewer` → `fixer` | `deliver-change` |
| `content-team` | `@agentproto/apps/content-team` | `researcher` → `writer` → `editor` → `illustrator` | `produce-content`, (中文(简体) ), `produce-cover` |
| `mail-triage` | `@agentproto/apps/mail-triage` | `triager` | `triage-inbox` |
| `media-viewer` | `@agentproto/apps/media-viewer` | `cataloger` | `scan-media` |
| `session-viewer` | `@agentproto/apps/session-viewer` | `narrator` | `narrate-session` |
| `ops-panel` | `@agentproto/apps/ops-panel` | `manager`, (中文(简体) ), `watchdog` | —— 说 |

每个团队都有一个文件夹 `agents/<name>.ts` (每个代理人一个自成一体的文件) ——委员会 `defineAgent` 控件 + `body`和 `workflows/<name>.ts`页:1 团队的 `index.ts`。一个新的团队是一个兄弟文件夹 + 一个再出口.

## 两种消费方式

-   **进行中** —— 说 `await team.toMastraAgents({ resolveModel })` 返回时 以 id 为键的已建代理; 带走所需的代理 . `@mastra/core` 是一个对等点 依赖,所以安装在主机中.
-   **磁盘** —— 说 `await team.emit(dir)` 写 AGENT.md / WorkFlow.md 显示从磁盘上装入工作空间的运行时间。 不需要马斯特拉.

## 装入整个目录

`@agentproto/apps` 也发运a `agentproto-apps-sync` 二进制,每发一次 将应用程序捆绑到磁盘并写出一个平面目录:

```bash
npx agentproto-apps-sync [--base-dir <dir>]
```

默认基准目录是 `~/.agentproto/apps`它写每个应用程序 显示于 `<baseDir>/<slug>/` 和摘要目录 `<baseDir>/../app-catalog.json` (这样) `~/.agentproto/app-catalog.json` 以 默认). 上面的五个内置守护进程面板是 **没有** 这部分 同步/闪电流——它们不是 `AppHandle`s,所以没有什么 `.emit(dir)`。 。 。 . 运行中的守护进程列出它们 `app_catalog` 直接( 见“ Builtin 守护进程 ” 上方的面板”,独立于此文件和 `~/.agentproto/apps.json`。 。 。 .

## 已建守护进程面板

几个 `@agentproto/runtime`MCP- Apps 中创建的守护进程部件住在这里 也作为家庭应用质量代码 **没有** `AppHandle`编号 (单位:千美元)`defineApp` 需要一个非空 `agents` 这些是纯正的 仅读取的观众/演员,没有自己的代理:

| 小组讨论会 | 导入 | MCP 工具代码 |
| --- | --- | --- |
| `sessions-panel` | `@agentproto/apps/sessions-panel` | `agentproto_sessions` |
| `agents-overview` | `@agentproto/apps/agents-overview` | `agentproto_agents_overview` |
| `bureau-sessions` | `@agentproto/apps/bureau-sessions` | `agentproto_bureau_sessions` |
| `session-story` | `@agentproto/apps/session-story` | `agentproto_session_story` |
| `live-session` | `@agentproto/apps/live-session` | `live_session` |
| `session-chat` | `@agentproto/apps/session-chat` | `agentproto_session_chat` |
| `work-board` | `@agentproto/apps/work-board` | `agentproto_work_board` |

每次出口a `make<Name>App(ops)` 生产一种 `AgnoMcpApp` - 那个 形状 `@agentproto/runtime`是因为 `mcp-apps-adapter.ts` 在守护进程上挂载 服务器. `@agentproto/runtime`是因为 `builtin-apps.ts` 以 守护进程自己的会话注册(和,用于 `work-board`)和 无条件装上它们 不 `app_install` 步骤,他们是 总是列入 `app_catalog` 下级 `category: "builtin"`. 还有一个内建 面板,终端,留在 `@agentproto/runtime` (单位:千美元)`terminal-panel-app.ts`(中文(简体) ) 它需要一个活的PTY WebSocket,而不是一个便携式工具呼叫驱动 `AgnoMcpApp`。 。 。 .

## 一般设计

团队身份 `@agentproto/…` 并依赖 **没有** 产品包 结构变化:无 `@agentproto/*` 可能导入应用程序 `@<app>/core`) (中文(简体) ). 这就是让任何主机——包括代理机——导入一个 并直接使用其代理/工作流程.

## 常见问题

### @agentproto/apps 是什么？

@agentproto/apps——现成的Agentprotoapps\(代理团队\+他们的工作流程\)的家,以@agentproto/app宣布\. 导入一个团队\( 代码小组, 内容小组, \) , 并使用您主机中的任何代理/ 工作流程 : 通过 MastraAgents \(\) 进行中

### 如何安装 @agentproto/apps？

在项目目录运行 npm install @agentproto/apps，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@mastra/core（\>=1\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 agentproto-apps-sync，可以用 npx agentproto-apps-sync 直接运行。

### @agentproto/apps 支持 TypeScript 吗？

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

### @agentproto/apps 支持 ESM 还是 CommonJS？

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

### @agentproto/apps 可以商用吗？

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

### @agentproto/apps 的下载量有多少？

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

### @agentproto/apps 还在维护吗？

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