# @factory/cli 中文文档

规范地址：https://npmcn.com/package/%40factory/cli/

版本：1\.12\.1
npm 元数据更新时间：2026-11-14T06:56:33.034Z
中文译文更新时间：2026-11-14T08:26:09.904Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40factory/cli
原文对照：https://npmcn.com/package/%40factory/cli/?lang=original
项目主页：https://github.com/Factory-AI/factory#readme
源码仓库：https://github.com/Factory-AI/factory

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

- 包体积（解压后）：25.8 kB，5 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.0\.0
- 运行依赖：0 个
- 首次发布：2025-08-07T16:28:31.885Z
- 最新版本发布：2026-11-14T06:56:32.793Z
- 近 30 天下载量：115956（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：283（近 12 个月 280 个）

## 中文简介

工厂Droid CLI - AI动力软件工程代理

## 安装

```sh
npm install @factory/cli
```

也可以使用：`pnpm add @factory/cli`、`yarn add @factory/cli`、`bun add @factory/cli`

## README

# @ factory/ cli (英语)

> 权力 [工厂](https://factory.ai/) 在您的终端

## 安装

```bash
npm install -g @factory/cli
```

如果 `droid` 在安装后找不到命令, 您的 npm 全局 bin 目录可能不在您的 PATH 中 。 运行以下来修正它 :

```bash
# For zsh (macOS default)
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

# For bash (Linux)
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

# For bash (macOS)
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bash_profile && source ~/.bash_profile

# For fish
echo 'fish_add_path "$(npm prefix -g)/bin"' >> ~/.config/fish/config.fish && source ~/.config/fish/config.fish
```

在 Windows 上, 在 PowerShell 中运行 :

```powershell
[Environment]::SetEnvironmentVariable('Path', $env:PATH + ';' + (npm prefix -g), 'User')
```

然后重新启动您的终端 .

然后导航到您的项目并启动机器人 CLI :

```bash
cd /path/to/your/project
droid
```

你现在与工厂的开发代理 连接在你的终端.

> **快取小费 :** 新闻 `!` 切换 bash 模式, 直接运行 shell 命令而无需 AI 解释 。 新闻 `Esc` 以返回到正常模式.

## 机器人给你的工作流程带来了什么

-   **端到端特性开发**:从规划到实施到测试 - 机器人处理整个开发生命周期,同时通过透明的审查工作流程来控制您.
-   **深密码库理解**: 利用贵组织在储存库、文件和问题追踪方面的共享知识,提供了解具体情况的援助,并随着时间的推移加以改进.
-   **工程系统一体化**:直接连接到您现有的工具——与Jira,Notion,Slack的本土融合,以及更多的工具——所以开发工作与您的团队进程保持同步.
-   **生产准备自动化**: 开发期间或CI/CD管道中在当地部署相同的工作流程,企业安全和合规自第一天起内置.

## 为什么队伍选择工厂

-   **为企业建造**:就地部署选项,SOC-2合规,以及空载环境.
-   **你的工具,强化**: 在您现有的终端、 IDE 和开发环境中工作.
-   **透明和可控**:每个决定的机器人都是可见和可审查的. 你用我们本地的 diff 浏览器和批准工作流程 来全面监督代码的更改.
-   **示范灵活性**:不锁入单一AI供应商. 工厂允许您将任务引导到每个工作的最佳模式,同时在整个组织中保持一贯的行为和记忆.

## 文档

-   [快速启动指南](https://docs.factory.ai/cli/getting-started/quickstart)
-   [常用案例](https://docs.factory.ai/cli/getting-started/common-use-cases)
-   [IDE 整合](https://docs.factory.ai/cli/configuration/ide-integrations)
-   [配置](https://docs.factory.ai/cli/configuration/settings)
-   [AGENTS.md 指南](https://docs.factory.ai/cli/configuration/agents-md)
-   [CLI 参考](https://docs.factory.ai/reference/cli-reference)

## 完整文档索引

获取完整的文档索引 : [https://docs.factory.ai/llms.txt](https://docs.factory.ai/llms.txt)

## 常见问题

### @factory/cli 是什么？

工厂Droid CLI - AI动力软件工程代理

### 如何安装 @factory/cli？

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

### @factory/cli 支持 TypeScript 吗？

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

### @factory/cli 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @factory/cli 需要什么版本的 Node\.js？

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

### @factory/cli 可以商用吗？

@factory/cli 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @factory/cli 的下载量有多少？

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

### @factory/cli 还在维护吗？

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