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？

[![FARS 评测](https://followagents.com/badge/tgyd-helige-pi.svg?lang=zh)](https://followagents.com/zh/agents/tgyd-helige-pi)

<a href="https://followagents.com/zh/agents/tgyd-helige-pi"><img src="https://followagents.com/badge/tgyd-helige-pi.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.1.2-beta.91 2026-11-07
   发布说明摘录

   Summary Compared with the previous beta, this release makes @amaster.ai/pi-telemetry traces more complete and readable in Langfuse and Phoenix, with clearer launch context, bounded generation ordinals, and compatible display tool definitions. Telemetry also exposes redacted provider HTTP headers and protects context metadata while labeling auxiliary calls and preserving failure status. CI model workflows move to OpenAI Responses with integration coverage retained. Highlights …

   在 GitHub 查看 ↗
2. v0.1.2-beta.90 2026-11-06
   发布说明摘录

   Summary This beta hardens failure handling across the tool packages and expands @amaster.ai/pi-telemetry with a Phoenix backend layered over shared OpenTelemetry spans. Compared with the previous beta, errors that were previously swallowed now surface with their original causes, and telemetry exports behave more predictably under load and at shutdown. Highlights …

   在 GitHub 查看 ↗
3. v0.1.2-beta.89 2026-11-05
   发布说明摘录

   Summary Compared with the previous release, this update is a narrow reliability fix focused on @amaster.ai/pi-browser-use. Browser-use session connection and server handling now retry unreachable loopback ports, giving local browser automation a better chance to recover when a port is temporarily unavailable. The remaining published extension packages are part of the release set, but the supplied changes are limited to browser-use and its tests. Highlights …

   在 GitHub 查看 ↗

常见问题