FAQ

针对 you-agent-factory 常见问题的简短回答，并指向负责安装、运行工厂、编写、智能体、配置与恢复的规范文档与参考页面。

you-agent-factory 是什么？我该从哪里开始？

you-agent-factory 是让长期运行的智能体工作保持持久化的命令行工具与工作流系统。它以一个名为 you 的二进制文件安装。先读产品概览，再安装并运行一个打包工厂，然后才深入命令行细节。

用适合你机器的操作系统脚本安装，确认 shell 能解析 you，然后配置运行工作单元的提供方。完整命令都在安装页面——本页不再重复。

用 you init --package 安装一个打包工厂，然后用 you run --named 加上请求按名字运行它。普通运行是批处理模式，不会启动 HTTP 监听器，因此只有在启动运行时带上服务器、或 you server 正在运行时，you session list 才会有响应。

内置目录中随附了 15 个打包工厂，覆盖目标推进、评审循环、多数表决与锦标赛式比较、并行扇出、规划、分类、深度研究、工厂自动编写以及文本转语音。每个工厂都公布自己的参数、默认值和实际示例。

当工作流是一张工作在其中流转的拓扑，并且你想免费获得按条目持久化的状态与并发时，写图工厂。当工作流是一段过程，并且你想用普通控制流时，写 JavaScript 工厂。orchestrator 字段决定引擎；省略它即表示图。

每个工厂的拓扑位于工厂根目录下的 factory.json；诸如工作单元提供方之类的运维默认值位于 ~/.you-agent-factory/config.json。从目录安装的具名工厂位于 ~/.you-agent-factory/factories，除非你把它们指向别处。

让智能体运行 you docs agents 并读取输出。那个主题是随已安装二进制文件一同携带的智能体入门说明与命令一览，因此智能体学到的是它手边真实拥有的命令面貌，而不是一份可能过时的副本。之后它就能直接驱动命令行。

宿主会启动 you mcp serve，Factory Session 工具随之以 you.factory_session.* 的名字出现，Cursor 的第一个动态工作流循环就用这条桥接。MCP 服务器通过 stdio 通信，不会自行启动任何 HTTP 或仪表盘监听器。

在参考页面上。它们是从已安装的 @you-agent-factory/api 包投影出来的，而不是手工誊抄的。CLI 参考收录所有已发布的命令、参数与实参；API 参考渲染随附的 OpenAPI 文档本身；事件参考收录完整的事件集合与流式约定。

当安装、运行、配置、MCP 或动态工作流的步骤失败时，请打开故障排查页，那里按症状给出恢复路径并链接到负责的规范文档。日常的“怎么做”问题看本页；已经有明确故障现象时看故障排查。