---
layout: home

hero:
  name: BitLogger
  text: MoonBit 结构化日志库
  tagline: 先完成一条可运行的日志流程，再按需扩展并查询 API。
  actions:
    - theme: brand
      text: 从示例开始
      link: /zh/examples/
    - theme: alt
      text: 扩展 Logger
      link: /zh/extend/
    - theme: alt
      text: API 参考（英文）
      link: /api/

features:
  - title: 示例优先
    details: 从控制台、文件、配置和异步四条完整流程开始，而不是从 API 文件名开始。
  - title: 按需扩展
    details: 只在基础流程需要时再加入队列、组合 Sink、格式化和跨端处理。
  - title: API 作为参考
    details: 英文 API 页面保留精确签名、契约与边界说明。
---

## 从这里开始

1. 阅读[示例](./examples/index.md)，完成从安装到运行 Logger 的全流程。
2. 当基础控制台流程需要更多能力时，阅读[扩展](./extend/index.md)。
3. 需要高频签名和边界时，查询[中文高频 API](./api/index.md)；较少使用的符号仍进入[英文完整 API 参考](../api/index.md)。