安装 you-agent-factory

安装 you-agent-factory 的 you 命令行工具，确认它能在 PATH 中解析，选择运行工作单元的提供方，并从内置目录安装打包工厂。

安装

已发布的安装入口会下载适用于你操作系统的 you 二进制文件并加入 PATH。它只安装命令行工具，不会启动工厂，也不会写入任何配置。

macOS / Linux

curl -fsSL https://github.com/portpowered/you-agent-factory/releases/latest/download/install.sh | sh

Windows (PowerShell)

irm https://github.com/portpowered/you-agent-factory/releases/latest/download/install.ps1 | iex

安装程序会写入二进制文件，并为新的 shell 更新 PATH。首次运行 you 之前，请打开一个新终端，或重新加载 shell 配置文件。

确认安装

打印根帮助信息，确认 shell 能解析 you，并查看顶层命令分组。

you -h

二进制文件本身还内置了可离线阅读的参考主题。打印索引即可看到无需联网就能阅读的全部主题。

you docs

选择提供方

工作单元提供方是真正执行工作的智能体或模型运行时，也就是每个工作单元背后的编码智能体或推理后端。you init 会记录默认提供方和可选的默认模型，这样工厂本身就不必再指定。不带参数运行会进入交互式提示；传入 --provider 则可在脚本或 CI 任务中非交互地完成配置。

交互式配置提供方

you init

非交互式配置提供方

you init --provider codex

提供方名称并非由本文档固定——二进制文件会报告它可以选择的全部提供方，包括运维人员添加的 Agent Client Protocol 提供方。

you workers list

安装打包工厂

打包工厂是随二进制文件一同发布的完整工作流。安装会把它的定义复制到你的具名工厂根目录，之后即可运行、阅读和修改。

you init --package @you/goal

默认情况下，打包工厂会安装到主目录下的全局具名工厂根目录。传入 --dir 可改为安装到项目本地的根目录，--format 用于选择根定义的书写格式，--replace 用于覆盖已存在的目录。列出工厂时每次只读取一个根目录，绝不合并两者，因此要查看 --package 安装的内容，请用 --dir 指向全局根目录。

you factory list --dir ~/.you-agent-factory/factories

打包工厂参考 — 所有随附工厂及其源文件

文件位置

提供方默认值属于运维设置，保存在 ~/.you-agent-factory/config.json。用 --package 安装的具名工厂会放在 ~/.you-agent-factory/factories 下，除非用 --dir 指向别处。你为某个项目自行编写的工厂则与该项目放在一起，位于 ./factory/factory.json。

常见陷阱

安装后最常见的故障是没有配置提供方：工作单元被派发后找不到运行时，运行随即结束。请在首次运行前配置提供方。其次常见的是安装程序在一个已经加载过 PATH 的 shell 中完成——在判定安装失败之前，请先打开一个新终端。

下一步

配置好提供方并安装了打包工厂之后，最有价值的下一步就是完整运行其中一个。