# Manyfold

面向普通用户的产品指南，覆盖创建、配置和使用 Manyfold。

- [Manyfold 文档](https://docs.manyfold.ai/zh/docs/): 运行、连接并编排 AI agent。可以先在一个 sandbox 里启动一个托管 agent，或者注册你自己的电脑，让 agent 在你的代码仓库里工作。

## 开始

了解产品、安装 mf，并创建第一个 Agent。

- [快速开始](https://docs.manyfold.ai/zh/docs/getting-started/): 了解 Manyfold 的能力，以及创建第一个 Agent 的最短路径。
- [安装 CLI](https://docs.manyfold.ai/zh/docs/install/): 安装、登录、更新并验证 mf CLI。
- [创建第一个 Agent](https://docs.manyfold.ai/zh/docs/create-agent/): 为新 Agent 选择框架、运行模式、模型提供方和工作区。

## 构建

给 Agent 配置 workspace、模型和运行位置，然后用终端驱动它。

- [使用工作区](https://docs.manyfold.ai/zh/docs/workspace/): 使用聊天、文件、终端会话、用量、skills 和可恢复会话。
- [Profile 和环境](https://docs.manyfold.ai/zh/docs/profiles/): 隔离不同 Manyfold 环境的 credential 和 local daemon。
- [模型提供方](https://docs.manyfold.ai/zh/docs/model-providers/): 连接 Anthropic、OpenAI、Google Gemini、OpenRouter 或托管模型额度。
- [Manyfold 与 Agent framework](https://docs.manyfold.ai/zh/docs/agent-tools/): 它们并不是同一层的产品。先分清「模型」、「执行工作的 Agent framework」、「管理与协作平台」和「执行位置」，就能知道它们如何搭配。
- [选择运行环境](https://docs.manyfold.ai/zh/docs/choose-a-runtime/): 比较 stateful sandbox、自有电脑与 cloud computer，并选出适合的一种。
- [如何在自己的电脑运行 AI Agent](https://docs.manyfold.ai/zh/docs/run-agents-on-your-computer/): 在 macOS、Linux 或 Windows 上连接你的电脑，让 Manyfold 在本地 Workspace、工具链和网络环境中运行 Agent。
- [注册 Self-owned computer](https://docs.manyfold.ai/zh/docs/local-daemons/): 把自己的笔记本、台式机或 homelab 接入 Manyfold 作为运行环境。
- [自托管](https://docs.manyfold.ai/zh/docs/self-hosting/): 在自己的基础设施上运行完整的 Manyfold 栈——安装、升级、备份与运维契约。
- [自托管部署的 CLI 与 daemon](https://docs.manyfold.ai/zh/docs/self-hosting-cli/): 让 mf CLI 指向你自己的 Manyfold 部署、把机器注册成运行环境，并保持两边版本同步。
- [Manyfold 与 Cloudflare](https://docs.manyfold.ai/zh/docs/deployment/): Manyfold 不取代 Cloudflare、Vercel 或其他部署平台。它管理 Agent；部署平台承载面向用户的应用。两者通过 API 连接，形成从 Agent 工作到生产应用的清晰边界。
- [部署 Cloudflare Worker](https://docs.manyfold.ai/zh/docs/deployment/cloudflare-worker/): 这个流程部署的不是 Manyfold 本身，而是一个部署在 Cloudflare 的应用。该应用安全地连接 Manyfold Agent，并把 Agent 能力带入你的产品体验。
- [启动 Cloudflare 应用](https://docs.manyfold.ai/zh/docs/deployment/cloudflare-app/): 这个 launch flow 同时建立应用与开发 Agent：应用部署到 Cloudflare，Agent 连接 GitHub 代码库，在清晰的权限边界内持续修改、提交和推进工作。
- [Manyfold CLI](https://docs.manyfold.ai/zh/docs/cli/): 使用 mf 在终端中管理 Agent、runtime、channel、文件和 automation。
- [用 mf 编写脚本](https://docs.manyfold.ai/zh/docs/scripting/): 在脚本和 CI 中使用 JSON、稳定 exit code、profile 和安全 credential。
- [用 CLI 管理 Agent](https://docs.manyfold.ai/zh/docs/cli/agents/): 通过 mf 创建、查看、更新、删除和配置 Manyfold Agent。
- [用 CLI 管理 Runtime](https://docs.manyfold.ai/zh/docs/cli/runtimes/): 查看 runtime、管理托管 Agent，并控制 runtime UI。
- [用 CLI 管理 Automation](https://docs.manyfold.ai/zh/docs/cli/automations/): 创建 schedule、暂停 job、立即触发并查看 automation history。
- [备份和恢复 Agent](https://docs.manyfold.ai/zh/docs/cli/backups/): 使用 mf 创建 snapshot、恢复 Agent state 并跟踪 restore operation。
- [用 CLI 管理 Skill](https://docs.manyfold.ai/zh/docs/cli/skills/): 使用 mf 发现、安装、创建、分享、导出和分发 Agent skill。
- [用 CLI 查询用量](https://docs.manyfold.ai/zh/docs/cli/usage/): 查询 token/cost summary、time series、event、session 和 top Agent。
- [用 CLI 调用 peer Agent](https://docs.manyfold.ai/zh/docs/cli/a2a/): 使用 mf 发现可调用 peer、发送 A2A 工作并恢复 long-running task。

## 连接

把 Agent 接入团队已经在使用的工具，以及你自己的应用。

- [连接渠道](https://docs.manyfold.ai/zh/docs/channels/): 将 Agent 连接到受支持的聊天与工作跟踪渠道。
- [Telegram](https://docs.manyfold.ai/zh/docs/channels/telegram/): 将 Telegram bot 连接到 Manyfold Agent。
- [Slack](https://docs.manyfold.ai/zh/docs/channels/slack/): 将 Slack app 连接到 Manyfold Agent。
- [Lark 和飞书](https://docs.manyfold.ai/zh/docs/channels/lark/): 将 Lark 或飞书自定义 app 连接到 Manyfold Agent。
- [Discord](https://docs.manyfold.ai/zh/docs/channels/discord/): 将 Discord bot 连接到 Manyfold Agent。
- [Matrix](https://docs.manyfold.ai/zh/docs/channels/matrix/): 将 Matrix bot 账号连接到 Manyfold Agent。
- [WeChat](https://docs.manyfold.ai/zh/docs/channels/weixin/): 通过腾讯 iLink 网关把个人微信 bot 连接到 Manyfold Agent。
- [LINE](https://docs.manyfold.ai/zh/docs/channels/line/): 把 LINE 官方账号连接到 Manyfold Agent。
- [WhatsApp](https://docs.manyfold.ai/zh/docs/channels/whatsapp/): 扫码把一个 WhatsApp 号码关联到 Manyfold Agent。
- [Linear](https://docs.manyfold.ai/zh/docs/channels/linear/): 把 Manyfold Agent 安装成 Linear 工作区成员。
- [GitHub](https://docs.manyfold.ai/zh/docs/channels/github/): 在 GitHub issue 和 PR 里 @mention Manyfold Agent。
- [切换会话](https://docs.manyfold.ai/zh/docs/channels/session-switching/): 在同一个渠道里并行运行多个会话，通过 slash 命令在它们之间切换。
- [从 Agent 主动发送](https://docs.manyfold.ai/zh/docs/channels/agent-send/): 让 Agent 通过已绑定渠道主动发送消息和显式 workspace 文件。
- [Manyfold Automations 是什么？](https://docs.manyfold.ai/zh/docs/automations/): 让 Agent 按照计划或工作流条件自动执行重复任务，把结果交付到 workspace、渠道或其他团队入口。
- [创建和管理 Automation](https://docs.manyfold.ai/zh/docs/automations/create/): 从 Automations 页面创建一个可重复执行的 Agent 任务，再按需要修改时间、模型、渠道，或暂停和立即运行。
- [Manyfold A2A 是什么？](https://docs.manyfold.ai/zh/docs/a2a/): A2A 是 Agent-to-Agent 的协作入口：让一个 Agent 在授权、范围和任务状态都清楚的前提下调用另一个 Agent。
- [配置 A2A 权限](https://docs.manyfold.ai/zh/docs/a2a/permissions/): 通过 Manyfold UI 开启 Agent、授权 callers 和 targets，并在委派任务前确认调用路径可达。
- [设计 Multi-Agent 工作流](https://docs.manyfold.ai/zh/docs/a2a/workflows/): 让一个 Agent 负责规划和整合，再将研究、实现、审查等边界清晰的工作委派给专门的 peer Agents。
- [通过 API 与 Agent 通信](https://docs.manyfold.ai/zh/docs/api-chat/): 使用 OpenAI 兼容的 Chat Completions API 与 Manyfold Agent 对话。
- [通过 API 读取对话](https://docs.manyfold.ai/zh/docs/api-conversations/): 列出并回读你用 OpenAI 兼容 v1 API 创建的对话。
- [通过 A2A 调用 Agent](https://docs.manyfold.ai/zh/docs/api-a2a/): 让外部 client 或 SDK 通过 A2A 协议调用 Manyfold 上的 Agent。

## 参考

查阅 API 与 CLI 的确切形状，以及这份文档的机器可读版本。

- [CLI 命令参考](https://docs.manyfold.ai/zh/docs/cli/reference/): 搜索完整的 mf command tree、argument 和 option。
- [mf auth](https://docs.manyfold.ai/zh/docs/cli/reference/auth/): Authenticate and manage capabilities for the current identity
- [mf setup](https://docs.manyfold.ai/zh/docs/cli/reference/setup/): One-command onboarding: sign in, register this machine as a daemon, start it
- [mf login](https://docs.manyfold.ai/zh/docs/cli/reference/login/): Authenticate this machine with Manyfold
- [mf whoami](https://docs.manyfold.ai/zh/docs/cli/reference/whoami/): Print the currently authenticated user
- [mf agent](https://docs.manyfold.ai/zh/docs/cli/reference/agent/): Manage agents
- [mf automations](https://docs.manyfold.ai/zh/docs/cli/reference/automations/): Manage scheduled automations
- [mf backups](https://docs.manyfold.ai/zh/docs/cli/reference/backups/): Manage agent backups and restores
- [mf channels](https://docs.manyfold.ai/zh/docs/cli/reference/channels/): Manage agent channels (Telegram, Lark, Slack, etc.)
- [mf files](https://docs.manyfold.ai/zh/docs/cli/reference/files/): Read/write files on an agent runtime
- [mf connections](https://docs.manyfold.ai/zh/docs/cli/reference/connections/): List the connections linked to this agent (or, for a user, your account)
- [mf model-config](https://docs.manyfold.ai/zh/docs/cli/reference/model-config/): Read/update agent model configuration
- [mf runtime](https://docs.manyfold.ai/zh/docs/cli/reference/runtime/): Manage agent runtimes (the sprite/pod shell)
- [mf skills](https://docs.manyfold.ai/zh/docs/cli/reference/skills/): Manage installed agent skills
- [mf usage](https://docs.manyfold.ai/zh/docs/cli/reference/usage/): Read token + cost usage statistics
- [mf a2a](https://docs.manyfold.ai/zh/docs/cli/reference/a2a/): Talk to A2A servers and manage this agent exposure and callers
- [mf daemon](https://docs.manyfold.ai/zh/docs/cli/reference/daemon/): Local daemon for Manyfold agents (claude-code / codex / gemini-cli)
- [mf profile](https://docs.manyfold.ai/zh/docs/cli/reference/profile/): Inspect and manage CLI profiles (ADR-0014)
- [mf update](https://docs.manyfold.ai/zh/docs/cli/reference/update/): Update the mf CLI to the latest version
- [mf version](https://docs.manyfold.ai/zh/docs/cli/reference/version/): Show the installed version, update channel and build metadata
- [mf help](https://docs.manyfold.ai/zh/docs/cli/reference/help/): display help for a command; --agent prints the agent operations guide
- [常见问题](https://docs.manyfold.ai/zh/docs/faq/): 关于 Agent、运行模式、模型提供方、渠道和安全性的常见问题。

## API 参考

- [API Reference](https://docs.manyfold.ai/zh/api-reference/): 面向开发者的 Manyfold API 速查，用于把 Agent 接入外部应用、脚本和 OpenAI 兼容 SDK。
- [更新日志](https://docs.manyfold.ai/zh/changelog/): 查看 Manyfold Web、API、CLI 和 Agent runtime 的新功能、改进与修复。
- [状态](https://docs.manyfold.ai/zh/status/): Manyfold 服务状态。
- [问 Manyfold](https://docs.manyfold.ai/zh/support/): 就 Manyfold 提问，从文档中获得答案。

## Full text

- [Complete documentation, single file](https://docs.manyfold.ai/zh/llms-full.txt): every page above, concatenated.

Any documentation URL also serves markdown by appending .md, for example
https://docs.manyfold.ai/zh/docs/getting-started.md