init

CONTRIBUTING.md

@@ -0,0 +1,96 @@
+# 贡献指南 · Contributing Guide
+
+感谢你考虑为 JKVideo 做贡献！
+
+---
+
+## 开发环境搭建
+
+### 推荐方式：Dev Build（完整功能）
+
+```bash
+git clone https://github.com/你的用户名/JKVideo.git
+cd JKVideo
+npm install
+npx expo run:android   # 需要连接 Android 设备或启动模拟器
+```
+
+Dev Build 支持 DASH 原生播放（react-native-video），是开发视频播放功能的必选方式。
+
+### Expo Go 模式（快速验证 UI）
+
+```bash
+npm install
+npx expo start
+```
+
+适合开发 UI 组件、导航、弹幕列表等不依赖原生视频解码的功能。
+
+### Web 端
+
+```bash
+npx expo start --web
+```
+
+Web 端图片防盗链需要本地代理，在单独终端启动：
+
+```bash
+node scripts/proxy.js   # 监听 localhost:3001
+```
+
+---
+
+## 提交规范（Conventional Commits）
+
+请遵循以下格式：
+
+```
+<type>(<scope>): <描述>
+
+[可选正文]
+```
+
+| type | 含义 |
+|---|---|
+| `feat` | 新功能 |
+| `fix` | Bug 修复 |
+| `refactor` | 重构（不改变功能） |
+| `docs` | 文档更新 |
+| `chore` | 构建脚本、依赖更新等 |
+| `style` | 代码格式（不影响逻辑） |
+| `perf` | 性能优化 |
+
+示例：
+
+```
+feat(danmaku): 添加弹幕字体大小设置
+fix(player): 修复 DASH MPD 解析在 Android 12 上崩溃的问题
+docs: 更新 README 快速开始步骤
+```
+
+---
+
+## PR 提交流程
+
+1. Fork 本仓库并创建功能分支：`git checkout -b feat/your-feature`
+2. 在本地完成开发并测试
+3. 提交符合规范的 commit
+4. 发起 Pull Request，填写模板中的说明
+5. 等待 Code Review
+
+---
+
+## 注意事项
+
+- **禁止**在代码中硬编码任何账号信息（SESSDATA、uid 等）
+- **不接受**涉及自动化批量操作、绕过平台反爬的 PR
+- 新增功能请优先开 Issue 讨论，避免重复劳动
+- 涉及 API 参数变更时，请同步更新 `services/api.ts` 中的注释
+
+---
+
+## 问题反馈
+
+- Bug 报告：[提交 Issue](https://github.com/你的用户名/JKVideo/issues/new?template=bug_report.yml)
+- 功能建议：[提交 Feature Request](https://github.com/你的用户名/JKVideo/issues/new?template=feature_request.yml)
+- 使用问题：优先在 [Discussions](https://github.com/你的用户名/JKVideo/discussions) 提问