Contributing

Contributing / 参与贡献

Contributions are welcome in browser media, WebCodecs, WebGPU/ONNX, timeline UX, localization, testing, documentation, and example projects.

欢迎贡献浏览器媒体、WebCodecs、WebGPU/ONNX、时间线体验、本地化、测试、文档和示例项目。

Before opening a change / 开始修改之前

1. Search Issues and Discussions.

2. Use Discussions for broad proposals and Issues for concrete, reproducible work.

3. Keep changes focused and preserve existing project behavior outside the requested scope.

4. For visual changes, include before/after screenshots. For export changes, include decoded output verification.

5. 先搜索 Issues 和 Discussions。

6. 大方向提案放在 Discussions；具体且可复现的任务放在 Issues。

7. 保持改动聚焦，不影响任务范围外的现有行为。

8. 视觉改动附前后截图；导出改动附成品解码验证。

Development workflow / 开发流程

npm install
npm run dev
npm run check

Add targeted tests for timeline math, caption/audio synchronization, geometry, export, persistence, or localization when relevant. User-visible text must use translation keys rather than hard-coded strings.

涉及时间线计算、字幕/音频同步、几何、导出、持久化或本地化时，请添加针对性测试。所有用户可见文本都应使用翻译键，避免硬编码。

Where help is most useful / 最需要帮助的方向

• Reproducible browser/media compatibility reports.

• Small fixes with regression tests.

• Translation review by native speakers.

• Verified example projects and export fixtures.

• Documentation improvements based on real user questions.

• 可复现的浏览器与媒体兼容性报告。

• 带回归测试的小型修复。

• 母语使用者参与翻译校对。

• 验证过的示例项目与导出测试素材。

• 基于真实用户问题改进文档。