# @evref-bl/pharo-agent 中文文档

规范地址：https://npmcn.com/package/%40evref-bl/pharo-agent/

版本：0\.18\.0
npm 元数据更新时间：2026-11-13T21:53:31.403Z
中文译文更新时间：2026-11-14T02:43:23.749Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40evref-bl/pharo-agent
原文对照：https://npmcn.com/package/%40evref-bl/pharo-agent/?lang=original
项目主页：https://github.com/Evref-BL/pharo-agent-plugin#readme
源码仓库：https://github.com/Evref-BL/pharo-agent-plugin

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

- 包体积（解压后）：85.8 kB，23 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.12\.0
- 运行依赖：3 个
- 首次发布：2026-10-16T14:38:56.025Z
- 最新版本发布：2026-11-13T21:53:31.014Z
- 近 30 天下载量：6882（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：44（近 12 个月 44 个）

## 中文简介

终端-第一Pharo集成编码代理.

## 安装

```sh
npm install @evref-bl/pharo-agent
```

也可以使用：`pnpm add @evref-bl/pharo-agent`、`yarn add @evref-bl/pharo-agent`、`bun add @evref-bl/pharo-agent`

## README

# 法罗剂

`pharo-agent` 给一个编码代理 自己的Pharo 发射器。 它能看见 启动器提供的模板,从中创建图像,开始并阻止它们, 和工作在它开始的: 课程,方法,发送者,测试, 重新构思 批评 以及Pharo IDE的其余工作 关于macOS和 Linux 也可以作为文件读取并编辑图像的来源.

它与克洛德代码,Codex和OpenCode合作.

## 它的构成

此插件为胶体 。 有三个项目进行这项工作,每个项目都对其 拥有 :

-   [棱镜](https://github.com/Evref-BL/PLexus) 驱动 Pharo 发射器。 这个 创建、列表、启动、停止和删除图像,并将 MCP 调用转发到 每个服务器运行.
-   [Pharo 的 MCP 软件](https://github.com/Evref-BL/MCP) 是那个服务器 有用吗 通过Pharo自己的编译器, 重构器, SUnit, Iceberg 和 Epicea 比较 而非补丁导出文本, 它维护 Pharo 指导一个工程 获得.
-   [法罗-图像-fs](https://github.com/Evref-BL/pharo-image-fs) 现场项目 图像源作为文件系统,所以普通文件工具编辑图像 自己来.

插件标出每个版本的一个版本, 因此一个工程得到一组 一起测试,并给特工一个指令表面 在批量.

## 所需资源

-   节点22.12或后.
-   [Pharo 发射器](https://pharo-project.github.io/pharo-launcher/),这是 图片和模板来自何处.
-   作为文件编辑源 : macOS, 不需要更多, 或者 Linux 与 FUSE 3 (中文(简体) ) `fuse3` 软件包,默认安装在大多数分布图上). 它的守护进程是下载给你的。 当投影无法挂起时, 图像 首先是Pharo的工具和警告 而不是失败.

在 Pharo 版本上, 被绑定的 MCP 不加载, 创建图像失败 包含负载本身的错误,除非您自己的负载脚本带来工具 在另一种方式.

## 设置

在克洛德码中,将其安装为插件:

```text
/plugin marketplace add Evref-BL/pharo-agent-plugin
/plugin install pharo-agent@evref-bl
```

然后请代理在项目中启用 Pharo 工具化. 插件带有一个 设置完成它的技能,并宣布 `pharo` MCP 服务器, 所以运行 图像工具到达聊天时没有手工配置任何内容 . [主机](https://npmcn.com/package/%40evref-bl/pharo-agent/docs/hosts.md) 涵盖每个项目而不是每个地方的功能.

任何主机都可以运行CLI取而代之. 在项目目录中,一次:

```sh
npx --yes @evref-bl/pharo-agent init --host <claude|codex|opencode>
```

## 经纪人得到什么

**出发者.** `image templates` 每个安装模板的名称 提供. `image create <name> --template <template>` 绘制图像 图像工具在里面, `image start <name>` 开始, `image stop <name>` 杀人 它,和 `image delete <name>` 删除它。 一个工程可以拥有像 它喜欢——每个Pharo版本一个,每个主题一个,一个丢掉——然后跑 - 立即执行; `image list` 说哪些存在,哪些运行. [图像](https://npmcn.com/package/%40evref-bl/pharo-agent/docs/images.md) 还有其他的.

**每个运行图像的工具 .** 类别、方法、发送者、测试和 宣传评价; 更完整的目录,如成套资料, 数据库, 更改历史和调试器, 会被搜索而不是列出, 所以 它的图谋远离特工的背景 工具属于图像,所以 存在与否取决于图像装入了什么. [工具](https://npmcn.com/package/%40evref-bl/pharo-agent/docs/tools.md) 既涵盖两者,又服务于不同于图像的MCP.

**源作为文件,关于macOS和Linux.** 启动一个图像将它的出处挂载在下面 `.pharo-agent/mounts`。在那里编辑的文件被编译成活的图像 : 文件和工具是两个图像的视图,而不是导出和导出 图像。 设置 `PHARO_AGENT_PROJECTION=off` 在环境中开始图像 没有安装任何东西.

**指导代理人.** 设置一个项目 写一个法罗指南在里面, 和主机指南中指向该指南的有条件行 Pharo只工作,所以Pharo指示不要与无关的聊天. 指南 及其所指内容由MCP项目维护,并从 释放此插件针 . [主机](https://npmcn.com/package/%40evref-bl/pharo-agent/docs/hosts.md) 列出它拥有的路径.

**一种报告阻碍它的方式.** 插件的反馈技能有: 代理人员回头看谈话中, 工具呼叫失败, 误导它或 并起草供工具维护者使用的问题。 它提供 自己在Pharo的结尾工作 在那里发生,搜索现有的 并只归档你批准的草案.

## 升级后刷新

提升插件的安装方式, 然后再次运行设置命令 在项目中,命名同一个主机。 重写生成的向导和 从模板中复制的新版本针.

图像、运行时状态和设置都保留下来,除此之外的任何内容也保留下来 屏蔽插件标记为自己的; `--mount-root` 只更改挂载根. 生成和复制的文件被覆盖, 因此要保持项目专用 给他们指示 更新一个工程的升级, 既不是安装 插件或运行中的图像中的代码; [图像](https://npmcn.com/package/%40evref-bl/pharo-agent/docs/images.md) 覆盖 图像侧.

## 进一步阅读

`pharo-agent --help` 给出命令概览,以及 `--help` 执行命令 给出其选项、默认和示例。 帮助在项目设定前工作 起来.

-   [主机](https://npmcn.com/package/%40evref-bl/pharo-agent/docs/hosts.md) ——设置写作,并安装为插件.
-   [图像](https://npmcn.com/package/%40evref-bl/pharo-agent/docs/images.md) 图像是什么,模板和类别, 开始和停止,数个图像一次.
-   [工具](https://npmcn.com/package/%40evref-bl/pharo-agent/docs/tools.md) - 广告的表面, 寻找其余的, stdio 捆绑,并服务不同的MCP.

## 常见问题

### @evref-bl/pharo-agent 是什么？

终端-第一Pharo集成编码代理\.

### 如何安装 @evref-bl/pharo-agent？

在项目目录运行 npm install @evref-bl/pharo-agent，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 pharo-agent，可以用 npx pharo-agent 直接运行。

### @evref-bl/pharo-agent 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/evref-bl\_\_pharo-agent 是否存在。

### @evref-bl/pharo-agent 支持 ESM 还是 CommonJS？

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

### @evref-bl/pharo-agent 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.12\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @evref-bl/pharo-agent 可以商用吗？

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

### @evref-bl/pharo-agent 的下载量有多少？

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

### @evref-bl/pharo-agent 还在维护吗？

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