docs: 完善仓库文档(README / LICENSE / CONTRIBUTING / CHANGELOG / Issue 与 PR 模板)
- README.md: 仓库门面,含特性、API 文档、快速开始、部署、目录结构、协议 - LICENSE: MIT,约束代码 - ASSET_LICENSE.md: CC BY-NC-SA 4.0,约束表情包素材 - CONTRIBUTING.md: 投稿流程、commit 与分支规范、PR 自检清单 - CHANGELOG.md: Keep a Changelog 格式,1.0.0 首发条目 - .gitignore: 补充 macOS/Windows/IDE/Python/日志等忽略项 - .github/ISSUE_TEMPLATE/: bug / feature / question 三个模板 - .github/PULL_REQUEST_TEMPLATE.md: 含素材来源声明与自检清单
This commit is contained in:
56
.github/ISSUE_TEMPLATE/bug_report.md
vendored
Normal file
56
.github/ISSUE_TEMPLATE/bug_report.md
vendored
Normal file
@@ -0,0 +1,56 @@
|
||||
---
|
||||
name: 🐛 Bug 报告
|
||||
about: 报告一个让你遇到问题的 bug(前端 / API / 构建 / 素材缺失等)
|
||||
title: '[Bug] '
|
||||
labels: bug
|
||||
assignees: ''
|
||||
---
|
||||
|
||||
## 描述
|
||||
|
||||
简洁清晰地描述这个 bug 是什么。
|
||||
|
||||
## 复现步骤
|
||||
|
||||
1. 打开 `https://meme.smyhub.com/...`
|
||||
2. 点击 `...`
|
||||
3. 选择 `...`
|
||||
4. 看到 `...` 而预期是 `...`
|
||||
|
||||
## 预期行为
|
||||
|
||||
你**期望**发生什么。
|
||||
|
||||
## 实际行为
|
||||
|
||||
实际发生了什么?错误信息、控制台报错、网络请求等。
|
||||
|
||||
## 截图 / 录屏
|
||||
|
||||
如果有的话,附上(拖拽到下面即可)。
|
||||
|
||||
## 环境
|
||||
|
||||
- 浏览器 / 版本:例如 Chrome 125.0 / Safari 17.5 / Firefox 127
|
||||
- 操作系统:例如 Windows 11 / macOS 14 / iOS 17 / Android 14
|
||||
- 设备:例如 PC / iPhone 14 / 小米 14
|
||||
- 页面 URL:例如 https://meme.smyhub.com/#白色小人
|
||||
- 影响的素材路径(如果是某张图坏了):例如 `白色小人/123.webp`
|
||||
|
||||
## 浏览器控制台
|
||||
|
||||
> 打开 DevTools(F12)→ Console 标签,把相关报错贴上来。
|
||||
|
||||
```
|
||||
// 在此粘贴
|
||||
```
|
||||
|
||||
## 额外信息
|
||||
|
||||
任何其他可能有用的上下文。
|
||||
|
||||
## 检查清单
|
||||
|
||||
- [ ] 我已经搜索过 [已有 Issue](https://github.com/shumengya/meme-api/issues?q=is%3Aissue) 确认没人提过
|
||||
- [ ] 如果是素材问题,确认是仓库里 / 站点上都看不到,而不是我本地缓存
|
||||
- [ ] 我没有在 Issue 里包含任何个人敏感信息
|
||||
35
.github/ISSUE_TEMPLATE/feature_request.md
vendored
Normal file
35
.github/ISSUE_TEMPLATE/feature_request.md
vendored
Normal file
@@ -0,0 +1,35 @@
|
||||
---
|
||||
name: 💡 功能建议
|
||||
about: 对图库 / API / 构建流程提出改进建议
|
||||
title: '[Feature] '
|
||||
labels: enhancement
|
||||
assignees: ''
|
||||
---
|
||||
|
||||
## 这个功能解决什么问题?
|
||||
|
||||
简要说明痛点或动机。例如:
|
||||
- "我每次都要手动选 HTML 宽度 240,希望有记忆"
|
||||
- "想在手机端把图片长按保存"
|
||||
|
||||
## 你想要的方案
|
||||
|
||||
描述你心中的实现方式。可以包括:
|
||||
- UI 截图 / 草图
|
||||
- 交互流程
|
||||
- 对哪些 API / 文件有影响
|
||||
|
||||
## 备选方案
|
||||
|
||||
有没有考虑过别的做法?各自的优缺点?
|
||||
|
||||
## 额外信息
|
||||
|
||||
- 影响的页面 / API:例如 `https://meme.smyhub.com/`、`/memes.json`
|
||||
- 是否愿意自己提 PR:是 / 否 / 待定
|
||||
- 关联 Issue(如果有):#123
|
||||
|
||||
## 检查清单
|
||||
|
||||
- [ ] 我已经搜索过 [已有 Issue](https://github.com/shumengya/meme-api/issues?q=is%3Aissue) 确认没人提过
|
||||
- [ ] 我愿意按 [CONTRIBUTING.md](../../CONTRIBUTING.md) 提一个 PR(可选)
|
||||
34
.github/ISSUE_TEMPLATE/question.md
vendored
Normal file
34
.github/ISSUE_TEMPLATE/question.md
vendored
Normal file
@@ -0,0 +1,34 @@
|
||||
---
|
||||
name: ❓ 提问 / 求助
|
||||
about: 不知道怎么用 / 需要帮助
|
||||
title: '[Question] '
|
||||
labels: question
|
||||
assignees: ''
|
||||
---
|
||||
|
||||
## 我想做什么
|
||||
|
||||
简述你想达到的目的。
|
||||
|
||||
## 我已经试过的
|
||||
|
||||
- 看了 README 里的「...」部分
|
||||
- 搜了 Issues,没找到
|
||||
- ...
|
||||
|
||||
## 困惑点
|
||||
|
||||
具体卡在哪?
|
||||
|
||||
## 截图 / 代码
|
||||
|
||||
如果方便,附上相关截图或代码片段。
|
||||
|
||||
## 环境
|
||||
|
||||
- 浏览器 / 设备
|
||||
- 访问的 URL
|
||||
|
||||
## 检查清单
|
||||
|
||||
- [ ] 我已经搜索过 [已有 Issue](https://github.com/shumengya/meme-api/issues?q=is%3Aissue) 确认没人提过
|
||||
Reference in New Issue
Block a user