esdoc.org

是什么

ESDoc 是一个面向 JavaScript 的 API 文档生成器，目标是让文档维护更舒适，并生成易理解的文档。它从源码中的 doc comment 与类似 JSDoc 的标签读取信息，生成 HTML 文档，并支持覆盖率、lint、测试代码和手册集成。正文标注 License 为 MIT，可通过 npm 安装使用。

核心能力与生态

它的核心定位偏向 ES2015+：支持 ES Class 与 ES Module，能够根据 class 语法自动识别继承、方法、成员和覆盖关系，减少手写标签负担；也会根据 export 形式展示 import 用法。需要注意的是，ESDoc 明确不支持 prototype base codes、function base codes 和 CommonJS。标准功能主要通过 esdoc-standard-plugin 提供，包括发布 HTML、文档覆盖率、文档 lint、测试代码引用、手册集成、搜索和简单类型推断。插件架构是其重要特点，Plugin API 可在配置、代码、AST、文档、发布内容等阶段介入；但 Data Format 仍标注 TODO。Flow、TypeScript、JSX React、Markdown 发布等在正文中属于 PoC 级插件。

定价与自托管

正文没有商业定价或付款信息。使用方式是安装 esdoc 与 esdoc-standard-plugin，配置 source/destination 后在本地生成 docs/index.html，因此适合纳入 CI 或项目构建流程，也天然支持自托管静态文档。

优缺点与适合谁

优点是配置简洁、ES Module/Class 友好、覆盖率和 lint 有助于治理文档质量，并能把测试与手册整合到同一文档站。缺点是生态边界明显：CommonJS 和传统原型写法项目不适合；搜索实现被描述为较朴素，规模变大可能有性能隐患；类型推断也只说明支持简单 primitive values。变更记录最新为 2018 年，服务支持和维护活跃度需要使用者自行评估。它更适合 ES2015+ JavaScript 库、SDK 和前端/Node 项目；若项目以 TypeScript 或 CommonJS 为主，应优先比较 JSDoc 等替代方案。

中国访问

正文未提供中国大陆访问、镜像、支付或托管可用性信息，判定为未知。由于工具可通过 npm 安装并本地生成文档，实际可用性更多取决于 npm 源与项目网络环境。