---
layout: home

hero:
  name: q-code 文档
  text: 小黄鸭的内部说明书
  tagline: 用简洁页面说明 q-code 的用法、架构、测试和维护边界。
  image:
    src: /q-code-duck-round-512.png
    alt: q-code 小黄鸭
  actions:
    - theme: brand
      text: 快速开始
      link: /guide/getting-started
    - theme: alt
      text: 看仓库地图
      link: /development/repository-map

features:
  - title: 使用
    details: 安装、配置、CLI、TUI 和常用命令放在指南里。
    link: /guide/getting-started
    linkText: 进入指南
  - title: 理解
    details: Agent Loop、工具、上下文、SubAgent 和会话流程放在架构里。
    link: /architecture/overview
    linkText: 看架构
  - title: 开发
    details: 目录边界、测试策略、文档同步规则放在开发区。
    link: /development/repository-map
    linkText: 开始开发
  - title: 查表
    details: 命令、目录、安全边界等短信息放在参考区。
    link: /reference/commands
    linkText: 打开参考
---
