发行版

🔵 包含二进制文件和文档的打包归档——无需源码即可运行。

17.1 内容说明

路径	说明
`bin/agent-os[.exe]`	统一 CLI。子命令：`serve`（HTTP 服务器 + 网站 + 组件 + API）、`bench`、`scrape`、`hook`、`route`、`tool`、`office`、`module`（`module workflow run`）、`pdf-exporter`、`mcp-fake`。子命令可通过模块扩展（注册表 `agent_os_cli`）
`bin/officecli_pdf_exporter[.exe]`	PDF 导出插件 OfficeCLI（无头 Chromium，自动下载）；`agent-os pdf-exporter` 上的轻量垫片，必须与 `agent-os` 放在一起
`bin/libduckdb.so` / `bin/duckdb.dll`	DuckDB 运行时（Linux / Windows）——必须与二进制文件放在一起
`docs/`	剧本（`agent-os-docs/`）——配置、代理、工具、钩子
`skills/`	面向代理的技能剧本（`.agents/skills/*/SKILL.md`）
`config/`	配置初始目录树（server.yaml + budgets.yaml + 演示代理 `hello-agent` 和 `mcp-demo-agent`）
`config/plugins.yaml`（可选）	启动时加载的原生插件（DLL）列表
`.env.example`	环境变量模板
`VERSION`	版本
`README.md`	归档简要说明

部分可选功能在首次使用时会自行下载其运行时（需要联网）：ONNX Runtime 和模型（security.onnx）、OfficeCLI（office_tool）、无头 Chromium（PDF 导出，browser_tool）。演示代理 mcp-demo-agent 需要 Node.js（PATH 中的 npx）。

服务器是模块化的：各项功能（docs、widget、cron、workflow、频道等）都是模块，可以启用（server.yaml → modules.enabled）并用自定义模块扩展（linked crate 或原生 DLL）。原生 DLL 放在二进制文件旁边并在 config/plugins.yaml 中列出；默认归档不包含它们。参见 20-native-plugins 和 32-building-a-module。

17.2 构建

归档由 scripts/ 中的脚本构建：

./scripts/build_distrib.sh —— Linux（distrib/agent-os-distrib-linux.zip）；
powershell -File scripts/build_distrib.ps1 —— Windows（distrib/agent-os-distrib-windows.zip）。

脚本构建 release 二进制文件，将 agent_os_docs/ 打包为 docs/、.agents/skills/ 打包为 skills/、config-starter/ 打包为 config/，外加 .env.example 和 VERSION，并计算 .sha256。

17.3 下载

归档由服务器本身提供：

URL	说明
`/distrib/agent-os-distrib-linux.zip`（+`.sha256`）	Linux
`/distrib/agent-os-distrib-windows.zip`（+`.sha256`）	Windows
`/distrib/agent-os-android.apk`（+`.sha256`）	Android

网站上设有「下载」板块（/site/download.html）。发行版文件夹路径可通过 AGENT_OS_DISTRIB_DIR 更改（默认为 distrib）。

文件以流式传输并支持断点续传（HTTP Range，响应 206）：curl -C - -O <url> 或 wget -c <url> 可继续中断的下载。

Linux 归档在每次部署时于服务器上重新构建。Windows 归档和 APK 在开发者机器上构建，并通过 scripts/deploy.sh 步骤发布（APK——如果旁边有最新的 distrib/agent-os-android.apk 构建）。

17.4 从归档快速开始

从解压后的归档根目录运行——config/ 和 .env 会相对于当前文件夹查找。

cp .env.example .env        # укажи DEEPSEEK_API_KEY
./bin/agent-os serve

copy .env.example .env
notepad .env
bin\agent-os.exe serve

本地测试器是同一二进制文件的子命令： agent-os tool <tool.yaml> '<json>'、agent-os hook <hook.yaml> user "hi"、agent-os bench --port=3001 --max=3、agent-os scrape <url>；运行工作流—— agent-os module workflow run <workflow.yaml>（原 workflow_tool）。

然后打开 http://127.0.0.1:3000/widget?model=hello-agent——带有演示代理的组件。详情参见 02-quickstart。初始配置中没有 config/web/，因此在添加网站之前 /site/ 会返回 404。