Etherpad-lite 后端重构方案：迈向模块化架构的第一步

现状分析

Etherpad-lite 作为一款开源的实时协作编辑器，其当前的后端架构存在一些值得优化的设计问题。核心问题集中在插件系统的实现方式上：

1. 非标准的模块管理：项目根目录下存在 node_modules 文件夹却没有对应的 package.json 文件，这种设计违背了 Node.js 生态的常规实践
2. 循环依赖问题：项目自身被当作一个插件(ep_etherpad-lite)来处理，同时又依赖自身，形成了不合理的循环引用
3. 插件安装机制：通过符号链接和特殊的环境变量(ETHERPAD_PLUGINS)来管理插件，这种方式不够直观且维护困难

重构方案

多包单仓库(Monorepo)架构

建议采用多包单仓库(monorepo)的方式重构项目结构，具体方案如下：

1. 顶层项目：保留 bin 目录和基础配置文件，包含一个标准的 package.json
2. 核心模块：将原来的 src 目录重构为独立的 ep_etherpad-lite 包，包含自己的 package.json
3. 依赖管理：使用 pnpm workspaces 来管理包之间的依赖关系

结构示例

- package.json (顶层项目配置)
- bin (保留原有脚本)
- ...
- ep_etherpad-lite/ (原src目录)
    - package.json (核心模块配置)
    - ... (原有代码结构)

技术优势

1. 符合标准实践：采用标准的 npm/pnpm 工作区管理方式，与其他 Node.js 项目保持一致
2. 清晰的依赖关系：通过 package.json 明确定义依赖，避免隐式的符号链接
3. 更好的开发体验：
   • 可以方便地通过 npm link 测试本地插件
   • 插件管理更加透明和可控
4. 为未来扩展奠定基础：这种结构为后续可能的模块拆分(如分离服务器脚手架和插件系统)提供了良好的起点

实施路径

1. 初步重构：建立基本的 monorepo 结构，保持现有功能不变
2. 依赖整理：清理现有的非标准依赖管理方式
3. 插件系统优化：逐步改进插件加载机制
4. 模块拆分：在稳定后考虑进一步的功能模块分离

预期收益

这一重构将使 Etherpad-lite 的代码结构更加清晰，降低新贡献者的入门门槛，同时为未来的功能扩展和技术升级提供更灵活的基础架构。特别是对于需要定制插件的企业用户，这种标准化的模块管理方式将显著提升开发体验。