JKVideo/CONTRIBUTING.md

贡献指南 · Contributing Guide

感谢你考虑为 JKVideo 做贡献！

---

开发环境搭建

推荐方式：Dev Build（完整功能）

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）

npm install
npx expo start

适合开发 UI 组件、导航、弹幕列表等不依赖原生视频解码的功能。

Web 端

npx expo start --web

Web 端图片防盗链需要本地代理，在单独终端启动：

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
• 功能建议：提交 Feature Request
• 使用问题：优先在 Discussions 提问