blob: abe96f19266bf8f58502d3aa2001d59329b46aae (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
|
# 贡献指南
## 目录结构
```
├─assets # 前端使用的静态资源
├─includes # 可复用的 php 组件
│ ├─comments.php
│ ├─footer.php
│ ├─head.php
│ ├─header.php
│ ├─main.php
│ ├─posts.php
│ └─sidebar.php
└─libs # 内部库
├─Comments.php # 评论相关的工具函数
├─Matcha.php # 主题显示等相关的工具函数
├─Options.php # 自定义主题设置页面
└─Utils.php # 杂项工具函数
```
## Commits 和 Pull Request
1. 使用 [Scoped Commits](https://scopedcommits.com/)，这是 Linux 内核开发使用的 commit 信息编写风格，也就是先写改动的影响范围，再写具体改动内容。
2. 提交 Pull Request 前请先 `git rebase origin/master`，在本地处理完冲突再提交。
3. 单个 commit 应该能够作为版本号使用，也就是 `checkout` 到这个 commit 的时候，运行代码也不会出现问题，是自包含（self-contained）的。如果提交了多个 commit，可以考虑 `git squash` 成一个。
## LLM 使用
### 绝对禁止
1. LLM 生成的 Pull Request 描述、Issues 和 commit 信息
2. 模型生成的图像资源
3. **提交由 LLM 生成的代码**（或 Vibe code）
- 此类代码的版权状态不明，无法追溯到模型训练数据中的具体代码，以及原本代码的授权协议，模型使用者极有可能没有权利使用这些代码，这些代码也极有可能与本项目的 GPL-v3.0 协议不兼容。
4. 传播尚未自己验证过的 LLM 生成的信息
### 容许
1. 使用 LLM 做代码审查、搜集信息和提出方案
|
