@agentproto/apps

中文文档
0.27.0发布于 2026/11/06Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 6240

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

中文使用文档
文档目录5 节
  1. 团队
  2. 两种消费方式
  3. 装入整个目录
  4. 已建守护进程面板
  5. 一般设计

@ agentproto/ apps (签名)

制成的活性剂 应用程序 —— 说 团队 代理加上他们运行的工作流程, 每个声明 @agentproto/app。导入一个团队,使用任意 其代理/工作流的子集来自您的主机.

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-teamimplementer → reviewer → fixerdeliver-change
content-team@agentproto/apps/content-teamresearcher → writer → editor → illustratorproduce-content, (中文(简体) ), produce-cover
mail-triage@agentproto/apps/mail-triagetriagertriage-inbox
media-viewer@agentproto/apps/media-viewercatalogerscan-media
session-viewer@agentproto/apps/session-viewernarratornarrate-session
ops-panel@agentproto/apps/ops-panelmanager, (中文(简体) ), 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 二进制,每发一次 将应用程序捆绑到磁盘并写出一个平面目录:

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

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

已建守护进程面板

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

小组讨论会导入MCP 工具代码
sessions-panel@agentproto/apps/sessions-panelagentproto_sessions
agents-overview@agentproto/apps/agents-overviewagentproto_agents_overview
bureau-sessions@agentproto/apps/bureau-sessionsagentproto_bureau_sessions
session-story@agentproto/apps/session-storyagentproto_session_story
live-session@agentproto/apps/live-sessionlive_session
session-chat@agentproto/apps/session-chatagentproto_session_chat
work-board@agentproto/apps/work-boardagentproto_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 共发布 50 个版本,首次发布于 2026/07/19;过去 12 个月发布了 50 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.27.0latest2026/11/06今天
0.26.02026/11/042 天前
0.25.02026/11/014 天前
0.24.22026/10/279 天前
0.24.12026/10/2314 天前
0.24.02026/10/2017 天前

关于 @agentproto/apps 的常见问题

@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 和提交记录判断。