扩展安装指南
Pi 原生扩展可以提供智能体工具、交互命令和技能。本文介绍 pi-mono-figma 和 pi-agent-browser-native;它们是可选安装包,不是 Wenext-Pi 自带依赖。workflow.json.plugins.enable 选择的是随 Wenext-Pi 构建的生命周期插件,例如 quality-web、debug,不要把这两个 npm 包名填入该字段。
安装位置与管理
使用已安装的 wenext-pi 管理扩展,无需再单独安装一份 Pi CLI:
wenext-pi install npm:pi-mono-figma
wenext-pi install npm:pi-agent-browser-native
wenext-pi list默认声明保存在 ~/.pi/agent/settings.json 的 packages 字段,PI_CODING_AGENT_DIR 可改变目录。list 显示声明及本地安装位置,不代表认证或浏览器环境已经可用。不要用新的 settings.json 覆盖已有模型与推理强度设置。
需要固定版本时,在源后加版本号,例如 wenext-pi install npm:pi-mono-figma@0.2.2。需要仅在当前项目使用时,从项目根执行 wenext-pi install --local npm:pi-mono-figma,声明写入 .pi/settings.json,在 Pi 信任该项目后加载。
wenext-pi update npm:pi-mono-figma
wenext-pi update npm:pi-agent-browser-native
wenext-pi update --extensions
wenext-pi config
wenext-pi remove npm:pi-mono-figma上面的命令依次用于更新单个扩展、更新全部扩展、选择要加载的包资源和移除扩展,按需执行。管理项目级声明时,在 install、remove 或 config 命令上使用 --local。仅更新扩展时使用明确的包源或 --extensions;不带目标的 update 是 Pi 自身更新入口。
安装或更新后完整退出并重启 Wenext-Pi。浏览器扩展的已加载 JavaScript 可能被缓存,不能只依靠 /reload 获取新版本。
Figma
pi-mono-figma 提供 figma_* 原生工具和 Figma 技能,通过 REST API 读取设计上下文、布局、文字、组件和资源,支持渲染节点供视觉对照。它按链接中的文件与节点定位,不会自动获知 Figma 桌面端当前选中的图层。
安装并重启后,在 Wenext-Pi 交互界面执行:
/figma-auth --force按本地遮蔽输入提示填写 Figma Personal Access Token。Token 需要文件内容读取权限,所属账号也必须能访问目标文件;插件会保存认证,不需要把 Token 发给智能体。也可通过启动进程的 FIGMA_TOKEN 环境变量提供凭据。
随后提供具体节点链接并描述需求,例如:“读取这个 Figma 节点,先展示渲染图和布局信息,再分析页面实现。”认证过期时重新执行 /figma-auth --force;文件不可访问时核对账号权限、链接和节点 ID。
浏览器
pi-agent-browser-native 注册 agent_browser 工具,供智能体导航、读取页面、点击、填写表单和截图。它不捆绑上游 agent-browser 程序;需要在启动 Wenext-Pi 的同一环境安装并确保 PATH 可见:
npm install -g agent-browser
agent-browser install
agent-browser --version
wenext-pi install npm:pi-agent-browser-nativeagent-browser install 下载浏览器。平台依赖与安装选项见 agent-browser 官方安装文档。已核对的扩展 0.6.10 要求稳定版 agent-browser >= 0.35.0,推荐 0.37.0;升级后的要求以所装版本的说明为准。录屏另需 ffmpeg,普通页面读取和截图不要求安装录屏依赖。
重启 Wenext-Pi 后输入:“用 agent_browser 打开 https://example.com,获取交互快照并截图。”agent_browser 是智能体工具名,不是终端命令;是否加载成功以工具可用性和实际调用结果为准。
若工具未出现或无法启动,可运行扩展的诊断命令:
npm exec --package pi-agent-browser-native -- pi-agent-browser-doctorPi 包安装通常不会把 pi-agent-browser-doctor 加入终端 PATH,因此这里通过 npm exec 调用;该命令可能下载诊断包,需要与待排查扩展保持版本一致,必要时指定 --package pi-agent-browser-native@0.6.10。它检查扩展环境与依赖,实际页面打开和截图仍需另行验证。
若提示找不到 agent-browser,先在启动 Wenext-Pi 的同一终端运行 agent-browser --version;切换 Node 版本后,全局 npm 命令所在目录也可能改变。若扩展被禁用,用 wenext-pi config 检查资源选择。浏览器会话和高级配置见扩展上游说明。