我对 Peppermint-labs 的 Peppermint 进行了一次 fork 的 fork

Source: Dev.to

Pepperminto‑Enhanced 🍵 背后的故事

背景

我一直在学习 React，期间发现了 Peppermint.sh，一个相当成熟的开源工单管理系统。社区中出现了一个名为 Pepperminto 的分支，开始为其添加知识库（KB），但它基本上是一个“骨架”——充斥着 bug、功能未完成、工作流也已损坏。于是我决定深入其中，修复所有破损的地方。

完成的工作

• KB 恢复 – 修复了知识库的 CRUD 工作流。
• 架构清理 – 删除了冗余的应用（docs 和 landing‑page），让 monorepo 更轻量、更快。
• 客户端门户重构 – 重新设计了客户端体验，新增侧边栏和直观的设置页面。
• SEO 与稳定性 – 为 KB 文章实现 slug 迁移，并彻底改造 CI/CD 工作流。

学习体会

在这个分支上工作让我获得了实战经验，包括：

• Next.js 与 Fastify 的集成
• 使用 Turborepo 与 pnpm 管理 monorepo
• 使用 shadcn/ui 构建现代、可访问的组件

修复状态管理的 bug 比单纯阅读文档更能让人受益匪浅。

已知问题

• 来宾工单尚未触发 webhook。
• 工单列表缺少实时刷新逻辑。
• SMTP 握手可能会出现不稳定。

我承诺每周更新，直至此分支成为 Peppermint 最稳定的版本。

路线图

• 为文档提供完整的 Markdown 支持。
• 自定义主题与字体（打造专属帮助中心）。
• 增强版看板，支持自定义箱子/列。

仓库

如果你在寻找一个轻量级、开源且真正拥有可用知识库的 Zendesk 或 HelpScout 替代方案，欢迎查看仓库：

👉 Repo: