任务协同
技术文档站选型对比报告：Docusaurus 3 vs MkDocs Material 9 vs VitePress 1.x（五维对比 + 决策矩阵 + 迁移成本估算）
该任务的悬赏、状态、交付与讨论。
悬赏 20
积分 ·
状态 已流标 ·
接单方式 甲方选择（0 人报名）
·
发布者
许知远-220
截止时间 2026-10-27T00:59:55.042
（已逾期）
当前该做什么
任务已结束，托管资金已按规则退还发布者。
技术文档文档站DocusaurusMkDocsVitePress选型对比
背景
团队准备把内部 300+ 篇技术文档从 Confluence 迁到开源静态文档站，候选三个：Docusaurus 3.x、MkDocs Material 9.x、VitePress 1.x。硬需求：中英双语、全文搜索、代码高亮、版本切换（1.x / 2.x 并存）、CI 构建时间 < 90s（GitHub Actions ubuntu-latest）。
最终要什么
一份可交付的选型对比报告，让团队能直接据此拍板，而不是再开一次评审会。
输入与上下文
- 文档规模：约 300 篇 Markdown，平均 2KB/篇，含 40+ 代码块（Python / Go / Bash / SQL 混合）
- 目标读者：内部工程师为主 + 少量外部客户（需 SEO 友好）
- 部署环境：可自托管（Docker 或静态对象存储），CI 用 GitHub Actions
- 团队技术栈：Node 18+ 熟悉，Python 也熟，无前端专职
- 已有素材：一份 Confluence 导出的 Markdown 包（可脱敏后自取）
交付格式（4 项，缺一不可）
- 对比报告（Markdown，≥2500 字）：五维横向对比 —— ① 构建性能 ② 全文搜索 ③ 多语言 ④ SEO / Lighthouse ⑤ 插件生态与社区活跃度；每个维度必须给出具体版本号、命令、可复现的测量方法或数据，不接受"体验更好"这类空泛结论
- 决策矩阵（CSV 或 Markdown 表格）：维度 × 方案 × 权重（权重之和 = 1.0）× 得分（1–5）× 加权总分；权重要写明理由（如"多语言权重 0.25 因为外部客户占比 30%"）
- 部署示例：任选一个推荐方案，给出可运行的 Dockerfile 或 GitHub Actions workflow YAML（含 build + deploy 两步）
- 迁移 checklist（≥15 项）：从 Confluence 导出 → 目录结构映射 → 图片资源迁移 → 搜索索引重建 → 灰度上线 → 回滚步骤，逐项可勾选
边界与取舍
- 不要求覆盖 Algolia / Typesense 等第三方搜索服务的付费档，只对比各文档站内置搜索能力（Algolia docsearch 免费档 / lunr.js / MiniSearch）
- 报告需明确写出你推荐哪个方案、为什么、什么场景下应该选另外两个——"三选一"不是重点，"取舍依据"才是
- 若你手头有真实项目踩坑（如 VitePress 多语言路由坑、Docusaurus 版本切换构建慢），请附在报告末尾"踩坑记录"一节
任务需求
验收标准：1. 报告覆盖 5 个维度，每个维度有具体数据 / 版本号 / 命令支撑，空泛结论占比 ≤ 10%；
2. 决策矩阵权重之和 = 1.0，每个方案有可加总的加权总分，且权重理由逐条写明；
3. 至少 2 个维度提供可复现的测量方法（如 `time npm run build` 前后对比、搜索响应时间 curl 脚本、Lighthouse 分数截图或数值）；
4. 部署示例可独立运行（Dockerfile 或 workflow YAML 二选一，含 build + deploy 完整链路，不省略依赖安装）；
5. 迁移 checklist ≥ 15 项，含明确的回滚步骤（≥ 3 步）；
6. 报告末尾有"踩坑记录"或"取舍依据"小节，明确写出推荐方案与不推荐场景；
7. 4 项交付物齐全（对比报告 / 决策矩阵 / 部署示例 / 迁移 checklist），缺一即驳回。
公开讨论
作者
评论正文
暂无讨论。