# Hacktoberfest 2025：与 Dodo Payments 一起构建账单与支付的未来

> 加入 Dodo Payments，参加 Hacktoberfest 2025：为 Billing SDK、Storefront、Customer Portal、适配器和文档贡献力量，并赢取专属周边。
- **Author**: Ayush Agarwal
- **Published**: 2025-09-29
- **Category**: Resources
- **URL**: https://dodopayments.com/blogs/zh/hacktoberfest-2025-dodo-payments

---

十月属于开源社区。今年 Hacktoberfest，我们邀请开发者、写作者和设计师一起助力 Dodo Payments 生态的发展。你可以参与我们的 [Billing SDK](https://billingsdk.com/)、[Customer Portal](https://github.com/dodopayments/dodo-customer-portal)、[Storefront](https://github.com/dodopayments/dodo-store-front)、框架适配器、插件、开发者示例和[文档](https://docs.dodopayments.com/introduction)。无论你是提交一行修复代码，还是开发一个全新的适配器，你的贡献都将助力全球成千上万的 SaaS 和 AI 产品。

贡献可以很小，也可以很大；可以是实验性的，也可以达到生产级别。每一项改进----更清晰的文档、一个新示例，或是 SDK 辅助工具中的一个 bug 修复----都会降低使用 [Dodo Payments](https://dodopayments.com/) 构建产品的团队的接入门槛。

## Hacktoberfest 项目：Billing SDK、Customer Portal、Storefront、无缝接入、Checkout 示例和文档

Dodo Payments 让 SaaS、AI 和数字业务更轻松地在全球发布和扩展：包括[订阅、一次性收费](https://dodopayments.com/blogs/one-time-vs-subscription-saas-pricing)、[按用量计费](https://dodopayments.com/blogs/implement-usage-based-billing)和按结果计费、税务处理、支付方式、结账流程等。在 Hacktoberfest 期间，我们将重点完善底层能力、示例和文档，让开发者体验更好、更高效：

> 我们为那些深夜独自开发的开发者设计了 Dodo 的 API。如果你需要一整个支付工程师团队才能完成接入，那就是我们的工作没有做好。
>
> \- Ayush Agarwal，Dodo Payments 联合创始人兼 CPTO

- **Billing SDK：**现代化、类型安全的客户端库和辅助工具，让团队能够快速、符合各语言习惯地接入 Dodo。

- **Customer Portal：**面向商户的管理门户，用于管理订阅、发票、许可证密钥和账单资料。

- **Storefront：**面向客户的商店，用于展示产品并将结账流程交给 Dodo；基于 Next.js、shadcn/ui 和 Tailwind 构建。

- **无缝接入与插件：**适用于热门框架、CLI 和工具链的即插即用集成。

- **Checkout 示例：**真实、可直接复制粘贴的示例，展示一次性收费、订阅和按量计费流程。

- **文档与指南：**简洁友好的文档和迁移指南，帮助开发者和运营人员降低使用门槛。

### 代码仓库（可选一个或多个）

- Billing SDK： [https://github.com/dodopayments/billingsdk](https://github.com/dodopayments/billingsdk)

- Customer Portal： [https://github.com/dodopayments/dodo-customer-portal](https://github.com/dodopayments/dodo-customer-portal)

- Storefront： [https://github.com/dodopayments/dodo-store-front](https://github.com/dodopayments/dodo-store-front)

- 文档： [https://github.com/dodopayments/dodo-docs](https://github.com/dodopayments/dodo-docs)

- 框架适配器： [https://github.com/dodopayments/dodo-adapters](https://github.com/dodopayments/dodo-adapters)

- Checkout 示例： [https://github.com/dodopayments/dodo-checkout-demo](https://github.com/dodopayments/dodo-checkout-demo)

- Dodo Payments Migrate： [https://github.com/dodopayments/dodo-migrate](https://github.com/dodopayments/dodo-migrate)

## 奖励：Hacktoberfest 贡献者可获得 Dodo "Tracks" 周边

主要贡献者将获得限量版 Dodo "Tracks" 周边礼包，包括 T 恤、帽子和贴纸。我们很快会在社交媒体和本文中分享设计预览。

包含 T 恤、帽子和贴纸的 Dodo Tracks Hacktoberfest 周边礼包

### 我们如何选择获奖者（透明且公平）

- **影响力：**开发者或商户能否立即使用这项贡献？

- **完整性：**是否包含测试、文档和示例？

- **协作：**贡献者是否能及时回应评审，并积极参与讨论？

- **范围：**多次小型 PR 或一次范围明确的大型 PR，都会被计入。

我们还会维护名人堂，并在各个渠道公开感谢贡献者。\[周边预览将发布在代码仓库和我们的社交媒体渠道中。\]

## 入门问题与高影响力贡献方向

**1) billingsdk**

- 为最近新增的 API 字段添加类型安全的方法或枚举。

- 改进重试/退避和幂等性辅助工具。

- 添加与框架无关的示例（Node/TS、Python、Go、PHP）。

- 强化错误类型和 SDK 异常处理。

- 改进 tree-shake 能力并减小构建包体积。

- 添加 CI 检查（lint、类型检查、测试）和覆盖率徽章。

**2) dodo-customer-portal**

- 通过乐观更新和无障碍设计，改进订阅操作体验（升级/取消）。

- 添加完善的发票下载状态处理（加载、重试）和错误边界。

- 扩展 `next-intl` 消息覆盖范围，并添加基础区域设置测试。

- 在列表视图中添加许可证密钥筛选和搜索功能。

**3) dodo-store-front**

- 使用骨架屏和 Next/Image WebP 资源，优化产品网格的 LCP。

- 改进 SEO/OG 元数据和社交分享图片。

- 强化产品卡片和数量控件的无障碍体验及键盘导航。

- 优化 Shadcn UI（焦点状态、分页、空状态），并添加加载回退界面。

**4) dodo-adapters**

- 创建新的适配器：Astro、Remix、Nuxt、SvelteKit、Flask、FastAPI、Laravel。

- 为 Webhook 和会话处理添加适合 SSR 的辅助工具和中间件。

- 为每个框架提供包含身份验证和结账接入的示例应用。

- 为每个框架版本编写迁移说明。

**5) dodo-checkout-demo**

- 扩展示例，展示一次性收费、订阅和按用量计费流程。

- 添加多币种和本地支付方式切换选项。

- 改进 UI/UX 和无障碍体验（a11y）。

- 添加 Docker Compose，实现一条命令启动本地环境。

- 添加种子数据和 Playground 模式，方便快速测试。

**6) dodo-migrate**

- 添加从 [Stripe](https://dodopayments.com/blogs/stripe-billing-dodo-payments)、[Paddle](https://dodopayments.com/blogs/paddle-alternatives)、[Lemon Squeezy](https://dodopayments.com/blogs/top-5-alternatives-to-lemon-squeezy) 等平台导入/迁移的脚本。

- 为常见账单模型提供标准化和映射辅助工具。

- 添加检查清单以及 dry-run/diff 模式。

- 添加单元测试和大型示例数据集（已匿名化）。

**💡提示：**我们会在各个代码仓库中使用 `hacktoberfest`、`good first issue` 和 `help wanted` 标签标记问题。如果你有想法，请先提交 issue，我们会帮助你明确范围。

## 如何参与：贡献的 5 个简单步骤

**选择代码仓库并查找 issue**

从上方列出的代码仓库中选择一个（Billing SDK、文档、适配器、Checkout 示例、接入蓝图或 dodo-migrate），然后浏览开放中的 issue。查找带有 **hacktoberfest**、good first issue 或 help wanted 等标签的问题。

2. **认领 issue 并说明你的方案。**

发表评论，说明你将负责处理该问题，并用 1-2 句话概述计划，让维护者确认范围。

3. **Fork -> 创建分支 -> 在本地运行。**

创建 Feature/<short-name> 分支，然后按照代码仓库 README 中的说明安装并启动项目。

4. **实现代码或编写文档，并添加测试。**

提交聚焦明确的 commit，遵循 CONTRIBUTING.md，并至少包含一项测试或一段文档示例。

5. **使用模板提交 PR。**

使用 PR 模板，关联 issue，说明你做了哪些修改以及如何测试。

### 如果你遇到困难

在 issue 中发表评论，或在 **#hacktoberfest** 讨论串中留言，维护者会提供帮助。

## 本地设置与贡献规范

每个代码仓库都包含 README，其中说明前置要求和本地运行步骤。

- 使用约定式提交 **(**`feat:` **、**`fix:` **、**`docs:` **、**`chore:` **、**`refactor:` **)**。

- 推送前运行 lint、类型检查和测试。

- 添加或扩展单元测试，并为每项功能至少包含一段文档示例。

- 保持 PR 聚焦；大型功能也欢迎，但请按逻辑拆分。

- 遵守代码仓库的许可证和行为准则。

## Hacktoberfest 2025 时间线与重要日期

**2025 年 10 月 1 日至 31 日（当地时间）：**Hacktoberfest 贡献期。

- **11 月上旬：**周边选择与名人堂更新。

- **11 月中旬：**开始寄送周边。

随着项目推进，我们会在代码仓库和社区渠道中发布更新。

## 社区与支持

- 我们的 Discord 服务器设有专门的 `#hacktoberfest` 讨论串（详情请参阅各代码仓库的 README）。加入链接 - [https://discord.gg/dodo-payments-1305511580854779984](https://discord.gg/dodo-payments-1305511580854779984)

- 维护者办公时间；具体安排将在 issue/Discussions 中公布。

- 如需提交安全相关报告，请遵循各代码仓库中的 `SECURITY.md`。

## 准备好了吗？立即开始：在本次 Hacktoberfest 为 Dodo Payments 贡献力量

Hacktoberfest 是改进数百万开发者所依赖的基础组件的最佳时机。选择一个代码仓库，认领一个 issue，然后开始提交 PR。

🔗 再次附上链接：

- [https://github.com/dodopayments/billingsdk](https://github.com/dodopayments/billingsdk)

- [https://github.com/dodopayments/dodo-customer-portal](https://github.com/dodopayments/dodo-customer-portal)

- [https://github.com/dodopayments/dodo-store-front](https://github.com/dodopayments/dodo-store-front)

- [https://github.com/dodopayments/dodo-docs](https://github.com/dodopayments/dodo-docs)

- [https://github.com/dodopayments/dodo-adapters](https://github.com/dodopayments/dodo-adapters)

- [https://github.com/dodopayments/dodo-checkout-demo](https://github.com/dodopayments/dodo-checkout-demo)

- [https://github.com/dodopayments/dodo-migrate](https://github.com/dodopayments/dodo-migrate)

PR 和名人堂见！

## 常见问题

### 哪些 Dodo Payments 代码仓库最适合首次参加 Hacktoberfest 的贡献者？

文章建议从各代码仓库中标有 `hacktoberfest`、`good first issue` 或 `help wanted` 标签的问题开始，例如 Billing SDK、文档、适配器和 Checkout 示例。这些问题通常范围更明确，更容易上手，同时仍然能为生态带来实际价值。

### 非代码贡献也可以计入本次 Hacktoberfest 活动吗？

可以。公告明确邀请写作者和设计师参与，同时将文档、示例和 UX 改进列为高影响力贡献方向。

### Dodo Payments 如何决定谁能获得 Hacktoberfest 周边？

周边选择将根据贡献的影响力、完整性、评审过程中的协作质量以及贡献范围决定。我们公布这些标准，是为了确保选择过程透明且公平。

### Pull request 中应包含哪些内容，才能提高被接受的机会？

请遵循代码仓库模板，关联 issue，说明修改内容，并提供清晰的测试或验证步骤。文章还强调，推送前应运行 lint、类型检查和测试。

### 如果贡献过程中遇到阻碍，我可以在哪里获得帮助？

你可以直接在 issue 中发表评论，或使用文章中提到的专门 `#hacktoberfest` Discord 讨论串。维护者也会在 issue 和讨论中分享办公时间安排。
---
- [More Resources articles](https://dodopayments.com/blogs/category/resources)
- [All articles](https://dodopayments.com/blogs)