01核心痛点与需求
小型 API 项目往往同时存在 OpenAPI 规范、MCP 服务描述、Doxygen 代码注释和 Markdown 手写文档等多种异构来源，开发者需要手工拼接或维护多套工具链，才能生成一个自托管的静态文档站点。现有工具大多只专注单一格式，缺乏一站式整合能力，导致配置繁琐、样式割裂、维护成本高。
02产品解决方案
构建一个开源的静态文档生成器：通过插件化解析器统一读取 OpenAPI/Swagger、MCP 服务描述、Doxygen 注释与 Markdown 文件，自动合并为统一的导航结构与交叉引用，输出可自托管的纯静态站点。内置 AI 辅助能力，自动补全缺失的接口说明、生成示例请求与变更摘要，并提供一键部署到自有服务器的构建产物。
03变现与商业化路径
采用开源核心 + 商业增值模式：基础生成器开源免费，通过托管版 SaaS（免部署、自动同步仓库）、团队协作功能（评论、审批、版本对比）、私有化部署授权与技术支持订阅收费；同时提供企业定制集成服务。
04行动步骤
- 1访谈 10-15 位同时维护 OpenAPI、Doxygen 与 Markdown 的小型 API 项目开发者，确认整合痛点与优先级。
- 2设计统一中间表示（IR）模型，定义 OpenAPI、MCP、Doxygen、Markdown 四类解析器的输入输出契约。
- 3实现 MVP：完成四类解析器与统一导航、交叉引用、静态站点生成，支持一键构建。
- 4加入 AI 辅助模块，自动补全接口说明、生成示例与变更摘要，并支持人工校对。
- 5在 GitHub 开源发布，配套示例项目与文档，收集早期用户反馈并快速迭代。
- 6推出托管版 SaaS 与团队协作功能，建立付费转化漏斗与用户增长渠道。
- 7沉淀插件市场与模板生态，形成差异化壁垒并拓展企业客户。
05风险提示
多格式解析的边界情况复杂，维护成本高；开源竞品（Docusaurus、MkDocs）生态成熟，用户迁移意愿有限；AI 自动生成内容可能存在准确性风险，需人工校对机制；自托管用户对付费意愿较低，商业化转化存在不确定性。