From 533cb84365246ca22a1c40cfcbd78c85db7f2801 Mon Sep 17 00:00:00 2001
From: eltrac <hi@eltr.ac>
Date: Mon, 26 Oct 2026 10:53:32 +0800
Subject: =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=20php2shell=20=E6=BC=8F?=
 =?UTF-8?q?=E6=B4=9E=E8=AD=A6=E5=91=8A=E5=92=8C=E8=B4=A1=E7=8C=AE=E6=8C=87?=
 =?UTF-8?q?=E5=8D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CONTRIBUTING.md | 41 +++++++++++++++++++++++++++++++++++++++++
 README.md       |  3 +++
 2 files changed, 44 insertions(+)
 create mode 100644 CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..abe96f1
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,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 做代码审查、搜集信息和提出方案
+
diff --git a/README.md b/README.md
index c98c479..d05c6a8 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,6 @@
+> [!warning]
+> 主题尚未对 8.2 以上修复了 php2shell 漏洞的 PHP 版本做适配，可能会有不兼容的情况。如果无法使用修复了漏洞 PHP 版本，建议暂时不要使用这个主题。我会在一段时间后发布新版本，你也可以阅读[贡献指南](./CONTRIBUTING.md)，提交 Pull Request 帮忙适配。
+
 ![](screenshot.png)
 
 # Theme Matcha
-- 
cgit v1.2.3