# @agentrific/server 中文文档

规范地址：https://npmcn.com/package/%40agentrific/server/

版本：0\.14\.0
npm 元数据更新时间：2026-10-23T17:34:55.148Z
中文译文更新时间：2026-11-06T22:27:41.356Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40agentrific/server
原文对照：https://npmcn.com/package/%40agentrific/server/?lang=original
项目主页：https://agentrific.com/
源码仓库：https://github.com/devular/agentrific

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

- 包体积（解压后）：13 MB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.16
- 运行依赖：21 个
- 首次发布：2026-10-01T15:47:23.981Z
- 最新版本发布：2026-10-23T17:34:54.894Z
- 近 30 天下载量：2254（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 26 个）

## 中文简介

长期编码剂自备控制平面

## 安装

```sh
npm install @agentrific/server
```

也可以使用：`pnpm add @agentrific/server`、`yarn add @agentrific/server`、`bun add @agentrific/server`

## README

# 代理服务器

在您的计算机或服务器上运行编码代理,并从代理iOS和Android应用中控制它们. 开始工作,跟踪进度,发送指令并审查您的电话结果,同时代理人员运行在自己的机器上.

此软件包安装代理服务器和 `agentrific` 用于macOS和Linux的命令行工具. 移动应用程序连接到您的服务器;您的寄存器、模型账户和代理程序都留在机器上。 配对设备可以断开并重新连接而无需结束运行的代理会话.

有了代理,你可以:

-   在您的 Git 仓库中管理任务和代理会话 .
-   在独立的 Git 工作树中运行编码任务 .
-   跟踪现场进展 并发送后续指令 从您的手机.
-   附加图像和文件以给出代理上下文 .
-   与同一服务器对等多个设备,并在需要时取消访问.

学习更多 [(原始内容存档于2019-10-21). agentrific.com](https://agentrific.com/)。 。 。 .

## 安装和启动

你需要22.19节节点 或更新,基特,和 [Pi](https://pi.dev/) 将运行你的特工。 安装 Pi并使用运行服务器的同一 OS 账户连接您的模型账户 。 见 [模式设置指南](https://agentrific.com/docs/pi-model-setup)。 。 。 .

OpenTunnel被捆绑并是默认的HTTPS连接,没有单独的隧道二进制或账户. 或者在服务器和电话上安装分级,或 `cloudflared` 在服务器上。 也可以使用已有的HTTPS隧道或倒置代理. 代理不为您安装这些工具 。 见 [连接设置指南](https://agentrific.com/docs/secure-server-setup#choose-an-https-connection)。 。 。 .

```sh
npm install -g @agentrific/server
agentrific init
agentrific start
```

服务器默认为端口 4318 并将其配置和状态存储于 `~/.agentrific`。其初始项目文件夹是 `~/projects`; 您可以在应用程序的服务器设置中选择一个不同的文件夹 .

## 克劳德代码

如果 Claude 代码在服务器的 OS 账户下安装并登录, Agentrific 将自动添加 a **克劳德代码** 模式连接。 运行 `claude auth login` 如果需要登录,请刷新模型列表。 服务器检查 `PATH`, (中文(简体) ), `~/.local/bin/claude` 财务报告和审定财务报表 `~/.claude/local/claude`;它还尊重 `CLAUDE_CONFIG_DIR`。 。 。 .

类似管道,此连接使用 `pi-claude-agent-sdk` 和克洛德特工SDK的孩子 和你们现有的CLI登录 Pi仍然拥有工具,任务历史和代理执行. SDK提供相容的克洛德可执行文件并处理证书刷新;Agentrific不将证书复制到Pi或发送给客户. 继承克洛德/Anthropic环境配置仍然适用.

当未保存默认时,一个已准备好的克洛德代码连接就成为使用其目录中的第一个Sonnet模型进行新会话的默认. 保存已保存的默认和已存在的会话选择 。 安装但未经认证的模型似乎无法使用登录指导 。 设定 `AGENTRIFIC_CLAUDE_CODE=off` 在启动服务器以禁用发现之前.

开发运行在开始前会编译桥梁. 其CLI-login和会话-同位素的适应被编译为已出版的套件,因此npm安装不依赖于只工作空间的Yarn补丁.

## 连接您的手机

在iOS或Android上打开代理应用程序. 在服务器终端中,接受默认的 OpenTunnel 连接,或选择 Tailscale Service, Cloudflare 隧道,或现有的 HTTPS 端点,然后按 **页:1** 以显示对齐的 QR 代码。 在应用程序中扫描并输入单独打印的六位数PIN.

在网络应用程序中已经对齐了吗? 打开 **设置 ~ 对等设备** 生成 QR 代码,并为另一个设备分离 PIN。 邀请书在五分钟后过期,可使用一次。 服务器必须配置一个公开的 HTTPS URL(`AGENTRIFIC_PUBLIC_URL`; 更改后重新启动。 仅与可信任的设备共享邀请: 配对允许作为服务器主机用户的运行代理访问 .

一旦对齐,选择一个工程,创建任务并启动代理. 服务器运行工作, 流程会返回您的设备 。 远程连接使用 HTTPS; 您的手机必须能够到达配置的服务器地址 .

见 [服务器设置和配对指南](https://agentrific.com/docs/secure-server-setup) 用于连接选项和配置.

## 有用命令

```sh
agentrific --help          # Show commands and options
agentrific start --connection local # Start without a public phone connection
agentrific status         # Show server status
agentrific pair           # Print a fresh pairing QR code and PIN
agentrific devices        # List paired devices
agentrific update --check # Check for a newer server release
```

## 访问和权限

设备在访问服务器命令和事件前必须配对. 用服务器用户权限执行编码代理,所以在账户下运行服务器,只访问您打算使用的寄存器和证书.

## 常见问题

### @agentrific/server 是什么？

长期编码剂自备控制平面

### 如何安装 @agentrific/server？

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

### @agentrific/server 支持 TypeScript 吗？

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

### @agentrific/server 支持 ESM 还是 CommonJS？

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

### @agentrific/server 需要什么版本的 Node\.js？

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

### @agentrific/server 可以商用吗？

@agentrific/server 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @agentrific/server 的下载量有多少？

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

### @agentrific/server 还在维护吗？

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