CLI
查阅 you-agent-factory 的命令分组、一次运行如何选定工厂、所有命令共用的全局参数，以及完整的已发布 CLI 约定在哪里。
安装
用适用于你操作系统的官方发布入口安装 you 命令行工具，并在首次运行前配置提供方。安装页面收录了各操作系统的命令、提供方配置步骤，以及打包工厂的安装。命令
按你想做的事挑选命令组，并确认它是否需要已有工厂主机在监听。启动类命令会创建运行时。会话、工作和提交类命令访问已经存在的运行时。其余命令读写本地状态。| 命令组 | 用途 | 是否需要工厂已在运行？ |
|---|---|---|
| you init | 配置默认提供方与模型，或从内置目录安装一个打包工厂。 | 不需要 |
| you run | 加载工厂并运行引擎。默认按批处理；加上 --continuously 可在空闲时保持存活。 | 不需要 — 它本身就会启动运行时。 |
| you server | 校验并提供 ./factory/factory.json 中的当前工厂，就绪后打开一次仪表盘。 | 不需要 — 它本身就会启动运行时。 |
| you factory list / create / update / delete | 在一次一个工厂根目录的范围内，管理已持久化的具名工厂。 | 不需要 |
| you factory config validate / expand / flatten | 在不持久化的情况下校验定义，或在单文件与拆分布局之间互相转换。 | 不需要 |
| you session list / show / create / delete / pause / resume / dispatches | 管理主机上的工厂会话，并读取其持久化的派发记录。 | 需要 |
| you submit / you submit batch | 向活动会话提交一条工作，或整体更新一个规范请求批次。 | 需要 |
| you work list / show / move / visualize | 检查并移动工作条目。可视化批次文件时读取的是本地 JSON。 | 需要，visualize 除外 |
| you workers list / acp add / acp delete | 查看可选的工作单元集成，并配置 Agent Client Protocol 提供方。 | 不需要 |
| you models list / inspect / pull / invoke | 读取已发现的模型及其就绪状态，把本地模型拉入托管缓存，或直接调用其中一个。 | 需要，invoke 除外 |
| you mcp serve | 为 MCP 宿主通过 stdio 启动 Factory Session 的 Model Context Protocol 服务器。 | 不需要 |
| you serve acp | 为编辑器通过 stdio 把 you-agent-factory 托管为 Agent Client Protocol 智能体。 | 不需要 |
| you docs / you docs <topic> | 从已安装的二进制文件中打印随附的参考 Markdown。 | 不需要 |