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

# 贡献指南

> 欢迎各种形式的贡献

## 提交 Bug 报告

请通过 [GitHub Issues](https://github.com/kejiland/qingyu-blog/issues/new?template=bug_report.md) 提交：

* 浏览器和操作系统
* 复现步骤
* 预期 vs 实际行为
* 截图或控制台报错

## 功能建议

通过 [Feature Request](https://github.com/kejiland/qingyu-blog/issues/new?template=feature_request.md) 告诉我们。

## 贡献代码

### 开发环境

```bash theme={null}
git clone https://github.com/kejiland/qingyu-blog.git
cd qingyu-blog
```

双击 `public/index.html` 即可开始，无需安装依赖。

### PR 流程

1. Fork 仓库
2. 创建分支：`git checkout -b feature/your-feature`
3. 提交：`git commit -m "feat: add xxx"`
4. 推送：`git push origin feature/your-feature`
5. 发起 Pull Request

### Commit 规范

| 前缀          | 说明     |
| ----------- | ------ |
| `feat:`     | 新功能    |
| `fix:`      | Bug 修复 |
| `docs:`     | 文档变更   |
| `style:`    | 样式调整   |
| `refactor:` | 重构     |
| `test:`     | 测试     |
| `chore:`    | 构建/工具  |

## 翻译贡献

翻译文件位于 `public/locales/<lang>.json`，欢迎修正或添加语言。

## 文档改进

* 修正错别字或过时信息
* 添加教程或截图