Pi 运行时扩展包

这个 Agent 能做什么，适合哪些场景？

Pi 是一组面向 Pi 运行时应用的共享 TypeScript 包，采用 monorepo 组织，全部为 ESM-only 并以 @amaster.ai 作用域发布。仓库分为两层：@amaster.ai/pi-shared 与 @amaster.ai/pi-storage 提供运行时类型契约和持久化适配器；其余为扩展包，每个包通过 ./extension 子路径入口注册 Pi 运行时扩展，由宿主应用按需加载。扩展覆盖 IM 工作区（Lark/Feishu、WeCom、DingTalk）、浏览器与桌面自动化、持久记忆、Langfuse/OpenTelemetry 遥测、Cron 定时任务、图像与视频生成、Web 检索、安全策略等。宿主应用需要自行提供 HTTP 路由、鉴权、模型运行时、部署配置和产品 UI；README 明确说明与 pi2dsh 和 dsh-pi-host 两种宿主加载模型配合使用。运行要求为 Node.js >=24 与 pnpm 10.18.3，代码以 Apache-2.0 授权。

每个扩展包在 ./extension 子路径导出扩展入口，宿主应用 setup 阶段将其传入 Pi 运行时即可注册 LLM 可调用工具。核心侧，loadPiSettings 读取设置，createRuntimeStorage 创建存储，JsonRuntimeStorage 与 MySQL/Prisma 适配器持久化 session、transcript、event、memory、artifact、subagent 和定时任务。pi-browser-use 封装 chrome-devtools-mcp 并暴露 browser_ 前缀工具；pi-computer-use 提供跨平台桌面自动化；pi-web-access 负责搜索、URL 正文抽取和图片检索；pi-memory 把策展记忆（MEMORY.md、USER.md）以刷新后的提示快照注入系统提示；pi-security 基于资源做策略判定与工具授权；pi-task-scheduler 用 Cron 管理定时任务；pi-telemetry 通过 createLangfuseExporter 和 createOtelExporter 输出运行时遥测；pi-goal 从对话推导目标并迭代执行直到条件满足。工作区侧，pi-lark 经 lark-cli、pi-wecom 经 wecom-cli、pi-dingtalk 经 dws CLI 调用日历、文档、表格、邮件、审批等能力；pi-image-gen 接入 OpenAI gpt-image、Google Nano Banana、阿里 Qwen-Image、OpenRouter 与自定义 provider；pi-video-gen 支持无损拼接与混合时间线，并内置 LGPL/GPL FFmpeg 运行时。

1. 宿主应用开发者希望一次性获得会话、事件、artifact 和定时任务的持久化能力，同时保留自有 HTTP 路由与前端，直接安装 pi-shared 与 pi-storage。
2. 团队把 Pi Agent 接入飞书/Lark 办公场景，需要日历、云文档、多维表格、任务和 IM 技能，用 pi-lark 通过 lark-cli 调用。
3. 运维或研发想在 Agent 中执行网页检索、URL 正文抽取和浏览器操作，组合 pi-web-access 与 pi-browser-use 完成自动化流程。
4. 需要长期个人化行为的助理场景，用 pi-memory 把 MEMORY.md/USER.md 注入系统提示，避免每轮重述背景。
5. 合规或安全敏感团队要求工具调用前做资源级授权判定，接入 pi-security 的策略引擎与工具授权。
6. 内容生产团队借助 pi-image-gen 与 pi-video-gen，在多个图像 provider 间切换，并把片段、字幕、TTS 和 BGM 合成为成片。

如何安装或部署这个 Agent？

环境要求 Node.js >=24 与 pnpm 10.18.3；README 建议用 Corepack：

corepack enable
corepack install -g [email protected]
pnpm install

本地完整校验：pnpm run pr-check；常用命令：pnpm build、pnpm typecheck、pnpm test。pi-storage 使用 Prisma schema（packages/storage/prisma/schema.prisma），可用 pnpm --filter @amaster.ai/pi-storage prisma:generate 生成客户端，根目录的 build 与 typecheck 会在编译前自动生成。作为依赖使用时按需安装：

pnpm add @amaster.ai/pi-shared @amaster.ai/pi-storage

README 未给出各 IM/图像/视频 provider 的凭据申请步骤，需参考各包自身 README。

如何使用这个 Agent？

在宿主应用中从根入口或子路径导入，例如：

import { createRuntimeStorage } from "@amaster.ai/pi-storage";
import { JsonRuntimeStorage } from "@amaster.ai/pi-storage/json";
import { loadPiSettings } from "@amaster.ai/pi-shared/settings";
import { createLangfuseExporter } from "@amaster.ai/pi-telemetry/langfuse";
import { createOtelExporter } from "@amaster.ai/pi-telemetry/otel";
import memoryExtension from "@amaster.ai/pi-memory/extension";

扩展包通过 ./extension 子路径注册自身，宿主应用在 setup 阶段把扩展传给 Pi 运行时。宿主加载模型有两种：pi2dsh 会发现在 DSH profile 中显式安装的 Pi 包；dsh-pi-host 按自身 extensions 列表中的包名加载。宿主需自行提供 HTTP 路由、鉴权、模型运行时与部署配置，README 未给出可直接运行的最小示例。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题