TuringPlanetFACTORY 图灵工厂
开始构建
TOOLS FOR WHAT COMES NEXT

让想法
开工。

Agent、工具、工作流，或一段可复用的基础设施。
这里提供你需要的工具，做成什么，由你决定。

开始构建 在浏览器中试用
你的代码 · 你的仓库 · 你的决定
一套共享工具，无限种用法
AGENTS/MCP/WORKFLOWS/INFRASTRUCTURE
01 / THE TOOLBOX

按需取用，组合成你的方式。

从第一行代码，到维护一项长期运行的服务。每一件工具，都有自己的用途。

完整技术文档

开源工具：直接使用模板和 CI 规则无需加入平台。

平台服务：先申请接入AI 审查、更新服务与托管有接入条件。 查看条件 →

01 / SCAFFOLD
开源模板 · 无需入会

从一个能跑的起点开始

生成属于你的 Python 项目。FastAPI、MCP、测试和部署配置已经就位，把精力留给自己的逻辑。

可在本地独立运行、自行部署。

查看模板源码
agent-templatePython · FastAPI · MCP
02 / QUALITY
开源 CI · 无需入会

让检查成为日常

按版本引用安装、测试、lint 和安全检查。自动检查决定门禁，AI 审查提供建议。

可独立引用规则；平台 AI 审查需另行接入。

查看 CI 规则
policiesCI · Review · Versioned
03 / MAINTENANCE
成员专用 · 需批准

把维护接入工作流

管理成员与部署配置，模板更新以 Pull Request 送达。查看差异、运行检查，再由你决定合并。

成员配置仓库不公开，需要管理员授予访问权限。

查看接入条件
agent-registryGitHub App · Sync · PR
04 / CONNECTIVITY
公开源码 · 平台基础设施

一个入口，连接多种能力

通过统一 MCP 入口连接平台托管的 Agent，让不同工具进入你熟悉的 AI 客户端。

源码可查看；共享入口仅提供平台已接入的能力。

查看网关源码
fleet-gatewayMCP · Tools · Gateway
05 / INFRASTRUCTURE
公开源码 · 托管需批准

给服务一条对外的路

为获批托管的服务提供子域名路由。共享入口，独立服务，通过平台内部网络转发。

查看路由实现不等于获得平台域名或托管资源。

查看路由源码
fleet-routerRouting · HTTPS · Hosting
06 / OPERATIONS
公开源码 · 成员服务

把重复工作交给工具

连接注册、平台 AI 审查与服务管理。通过 GitHub 工作流调用，把操作留在已有的协作环境里。

平台注册、AI 审查和管理操作需获批接入。

查看服务源码
fleet-servicesRegister · AI Review · Operations
02 / HOW IT WORKS

共享机制， 独立创造。

平台提供模板和规则，你的代码留在自己的仓库。三个动作，把工具接入你已有的工作方式。

01
COPY

复制一次，开始自己的项目

从 agent-template 生成独立仓库，包含 /api、/mcp 和起步测试。之后的业务逻辑，由你掌握。

02
REFERENCE

引用规则，让检查持续运行

通过 policies@vN 引用指定版本的工作流，在你的 CI 中运行检查。AI 审查提供建议，不替你做决定。

03
SYNC

接收更新，按自己的节奏合并

加入舰队后，模板更新以 PR 送到你的仓库。你检查变更、解决冲突，决定什么时候采用。

03 / GET YOUR HANDS ON IT

从你现在的位置，开始。

创建一个新 Agent，接入已有项目，或把重复工作交给平台。

可以只取用一件工具。 加入平台，始终是可选的。

查看 Agent Legion 原站 ↗

准备好 Git · Python ≥3.11, <4、Copier ↗、Poetry ↗

01

生成自己的仓库

新建项目时 adopt_mode 选 No；仅本地试用时，加入舰队也选 No。回答项目名等配置问题，平台接入可稍后申请。

SCAFFOLD
copier copy --trust gh:turingplanet/agent-template ./my-agent
02

安装依赖，运行测试

INSTALL & TEST
cd my-agent && poetry install && poetry run pytest

确认 pytest 显示测试通过，再继续连接。若依赖安装或测试报错，先解决该错误；之后可修改 api/ 和 mcp_server/ 加入业务逻辑。

03

连接本地 MCP

先安装并登录 Claude Code，再在 my-agent 目录运行以下命令。

Claude Code 安装与登录指南 ↗
LOCAL MCP
claude mcp add my-agent -- poetry -C "$(pwd)" run python "$(pwd)/mcp_server/server.py"
claude mcp get my-agent

成功检查：在 Claude Code 输入 /mcp 查看连接状态，再请求「用 my-agent 的 tool_say_hi 打个招呼」。添加配置成功不等于服务已连接。本地使用 stdio，不会同时打开 API 网页。

查看模板与部署指南
ACCESS / MEMBER SERVICES

先申请，获批后再接入。

独立使用模板和 CI 不需要申请。以下流程只针对平台服务。

01

说明你的接入需求

准备 GitHub 用户名、项目仓库链接，以及需要的服务：模板更新、AI 审查或托管。

发送接入申请邮件

会打开你的邮件客户端，请确认内容并发送。如果没有邮件客户端，也可手动发送到：

申请邮箱
info@turingplanet.org
02

等待管理员确认

管理员确认服务范围、仓库权限和接入方式后，再进行授权。提交申请不代表获批；托管资源需单独确认。

03

获批后，为指定仓库授权

由仓库拥有者安装 fleet-migration-bot，仅选择需要接入的仓库。随后按管理员指引完成登记；安装 App 不等于完成成员注册。

已获批准：打开 GitHub App

成功检查：收到成员接入确认后，在项目 PR 中使用 /review help 查看服务响应与额度。若未生效，联系管理员确认登记与仓库权限。

04 / TRY THE CONNECTION

先在浏览器里， 试一次。

无需安装或加入平台。在浏览器中体验 API，展开 GET /api/say_hi，点击 Try it out → Execute，无需填写参数。成功时应看到 HTTP 200 和 JSON 响应。

在浏览器中体验 API
MCP / CONNECTION

使用 Claude Code？先安装并登录，然后在你的项目目录运行： 安装指南 ↗

CLAUDE CODE
claude mcp add --transport http legion-demo https://agent-demo.turingplanet.ai/mcp
claude mcp get legion-demo

添加后在 Claude Code 输入 /mcp 查看连接状态，再请求「使用 legion-demo 的 tool_say_hi 打个招呼」。如果连接失败，请检查网络及服务状态。 连接排查 ↗

/mcp

给 AI 客户端调用

/api

给普通 HTTP 调用

连接整个舰队的 MCP 入口

共享入口的可用工具取决于平台配置。托管自己的 Agent 或使用成员服务，请先申请接入。 查看接入条件 →

FLEET MCP
claude mcp add --transport http fleet https://mcp.agents.turingplanet.ai/mcp
05 / BUILT ON YOUR TERMS

工具是共享的，决定是你的。

代码归你

模板生成独立仓库。你选择如何修改、使用和部署，也可以始终独立运行。

更新由你决定

规则按版本引用，模板更新以 PR 送达。没有强制升级，更新不会自动合并。

机制可以看清

核心模板与工具源码可查；成员配置仅向授权成员开放。AI 提供建议，确定性检查决定门禁。

GOOD TO KNOW

开始之前， 你可能想知道。

阅读完整文档
一定要做成一个完整产品吗？

不需要。Factory 提供可按需使用的工具和基础设施。你可以开发 Agent、连接一个 MCP 工具、改进 CI，或完成一项基础设施工作。做什么、做到哪一步，由你决定。

一定要注册或加入舰队吗？

不需要。你可以独立使用模板、运行测试和自行部署。加入舰队是可选的，用于接入模板更新、平台 AI 审查，以及经管理员批准的托管服务。

模板更新会覆盖我的代码吗？

更新机器人通过 copier update 生成 PR，以三方合并保留你的修改；冲突需要你检查和解决。没有合并 PR，当前代码就不会改变。

AI 审查会阻止我合并吗？

AI 审查只提供评论建议。门禁由安装、测试、lint 和安全扫描等确定性检查决定。平台审查有每周额度，可用 /review help 查看。

我的服务会部署在哪里？

你可以自行部署。模板提供 Railway 配置；也可以申请平台托管，经管理员批准后获得专属的 agents.turingplanet.ai 子域名。Factory 网站是这些工具与文档的入口。

Factory 和 Universe 有什么关系？

Factory 提供工具和基础设施，支持创造与日常技术工作。Universe 是发现作品、认识创造者的地方。你可以用 Factory 做出作品，也可以只用它完成一项工作。

THE NEXT THING IS YOURS

不必等一切就绪。
从一个工具开始。

让想法开工