> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockx.chaintable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 欢迎使用 BlockX

> BlockX 文档中心

这里是 BlockX 的产品与开发者文档。BlockX 是一个面向链上数据的函数执行框架：接收 task、扫描触发数据、并行执行轻量 Python 函数，再把结果写回 BlockDB。

<Columns cols={2}>
  <Card title="架构总览" icon="layers" href="/architecture/overview">
    系统由哪些组件构成、一个 task 如何流动、三条设计原则。
  </Card>

  <Card title="Task 生命周期" icon="route" href="/architecture/task-lifecycle">
    从 ReserveWorkerSlot 到 TaskResult 的端到端时序与状态。
  </Card>

  <Card title="仓库结构" icon="folder-tree" href="/architecture/repository-layout">
    什么在哪、为什么这么放、想改 X 该看哪个目录。
  </Card>

  <Card title="组件说明" icon="boxes" href="/components/worker">
    Worker、Coordinator、Call 执行、IO、Plugin、Python Executor 等逐个展开。
  </Card>

  <Card title="本地开发" icon="terminal" href="/development/getting-started">
    环境准备、构建、测试命令与常见问题。
  </Card>

  <Card title="贡献流程" icon="git-pull-request" href="/development/contributing">
    spec-first 的工作方式、代码约定、commit 与 PR 规范。
  </Card>
</Columns>

<Tip>
  第一次接触这个项目？按 [架构总览](/architecture/overview) 末尾的"建议阅读顺序"读一遍，再进入你要改的组件页。
</Tip>