# Circow 开发者文档 · 概览

> 本页是 Circow 开发者文档的入口。AI 友好索引见 [llms.txt](https://circow.cn/docs/llms.txt)，全文单文件版见 [llms-full.txt](https://circow.cn/docs/llms-full.txt)。

## Circow 是什么

Circow（圈牛）是一个「AI 员工」平台。用户在平台上创建并编排 **工作流（Flow）**——每个 Flow 就是一个 AI 员工，拥有自己的系统提示词、模型、工具（Skill / MCP）与会话记忆。员工可以通过网页端、桌面客户端（Windows / macOS）、移动端、微信客服、HTTP API 等多种渠道被使用。

开发者中心（登录后 `https://app.circow.cn/flow_app/developers`）提供与本文档相同的内容，并附带只对登录用户有效的交互工具（API Key 管理、Deep Link URL 生成器、工作流 ID 列表）。

## 术语

| 术语 | 含义 |
| --- | --- |
| Flow / 工作流 / 员工 | 一个可被调用的 AI 员工。有唯一 UUID（`flowId`）。API、Deep Link 都以它为目标 |
| Session / 会话 | 一次多轮对话。由 `session_id` 标识，续传即可保留上下文 |
| API Key | 与某个 Flow 绑定的密钥，形如 `fk_xxx`。在开发者中心「API 集成」栏目创建，明文只显示一次 |
| Skill | 本机能力扩展：一个目录，含 `SKILL.md`（告诉 AI 何时、如何用）+ CLI 工具实现。在桌面客户端内运行 |
| MCP Server | 按 Model Context Protocol 实现的工具服务进程，由桌面客户端拉起并托管 |
| 市场 | 官方技能 / MCP / 员工模板市场。Skill 与 MCP 可发布上架，用户一键安装 |
| 桌面客户端 | Windows / macOS 客户端。国内版下载 https://circow.cn/download ，海外版 https://circow.com/download |
| 区域版本 | 国内版（cn，域名 circow.cn / app.circow.cn）与海外版（global，域名 circow.com / app.circow.com）账号与数据互相独立 |

## 四种接入方式如何选

| 你想要 | 用 | 文档 |
| --- | --- | --- |
| 从自己的服务端 / 自动化平台（n8n、Zapier、内部服务）调用员工 | HTTP API | [api.md](https://circow.cn/docs/api.md) |
| 从本机软件、快捷方式、网页链接一键拉起桌面客户端进入某个员工 | Deep Link | [deep-link.md](https://circow.cn/docs/deep-link.md) |
| 让员工在用户电脑上多一项本机能力（操作文件、调本地程序、访问内网） | Skill | [skills.md](https://circow.cn/docs/skills.md) |
| 用标准 MCP 协议提供一组工具给员工调用（可复用现成 MCP 生态） | MCP Server | [mcp.md](https://circow.cn/docs/mcp.md) |
| 把做好的员工交付给最终用户（微信、API、桌面…） | 发布渠道 | [channels.md](https://circow.cn/docs/channels.md) |

## AI 优先的开发方式

Skill 与 MCP 的推荐创建路径不是手写，而是**直接在桌面客户端的聊天中让 AI 来做**：说「帮我创建一个 skill」或「创建一个 MCP」，内置的 `skill-manager` / `mcp-manager` 技能会完成脚手架、绑定与发布。本文档中的规范供手写与排障参考。

## 规划中

调用日志与用量统计 · Webhook 回调 · OpenAPI 规范导出 · 网页嵌入组件（iframe / JS Widget）。