知识工作者与开发者长期依赖 Markdown 沉淀技术文档、学习笔记与产品说明。传统阅读器多停留在「渲染展示」，难以覆盖划线笔记、百科答疑、生词积累与文档导航等学习闭环。随着 AI 能力下沉到本地与私有化部署场景，文档阅读正在从静态浏览演进为「可读、可问、可记、可导航」的智能学习体验。
企业内训、开源社区、工具平台与个人知识库对「多项目统一阅读 + AI 辅助理解」存在持续需求：一方面需要兼容本地目录与在线 URL；另一方面希望在不打断阅读流的前提下完成释义、问答与复习。Markdown Reader 定位于该交叉领域，将阅读器、笔记系统与 AI 助手整合为同一产品形态，具备清晰的产品演进空间与复用价值（如组件化输出、iframe 嵌套对接）。
在工具平台化趋势下，版本化部署、能力注册与微服务对接已成为标配。本项目已融入该生态（数据库微服务、AI 服务、TTS、本地文件 API 等），便于作为平台内的标准阅读组件持续迭代，行业前景稳健且与开发者工具、在线教育赛道高度契合。
Markdown Reader 是一款面向本地与在线 Markdown 的阅读与学习工具，核心能力包括：
- **多项目文档管理**：导入本地目录或在线 URL，左侧项目树浏览，支持目录大纲与全屏沉浸阅读。
- **单文档独立页**：提供纯净阅读页，支持 iframe 嵌套与 `md-reader` 命令行一键打开。
- **富文本渲染**：支持 Markdown、Mermaid 图表，以及相对路径本地图片的可访问转换；正文链接可选择当前页或新窗口打开。
- **JSON 正文提取**：在线接口返回 JSON 时，可配置并记忆 Markdown 字段路径，自动提取正文渲染。
- **划线笔记与媒体收藏**：正文与百科回复均可划线、记笔记、收藏图表，并回溯到来源会话。
- **AI 百科问答**：选中文本多轮问答，回复支持 SVG/Mermaid 渲染与异常修复；提问树自动整理为记忆树。
- **释义与生词本**：选词释义、发音（Piper TTS）、标签化解释策略，生词持久化便于复习。
- **智能排序与智能秘书**：项目树 AI 排序；按阅读需求生成导航思维导图，在文件树与智能秘书间切换。
- **组件复用**：阅读核心提炼为本地 npm 组件，供其他项目复用。
**我负责的具体任务**：前端整体架构与页面实现（主阅读台、单文档页）、侧边栏与阅读器交互、Pinia 状态与服务层对接（本地文件 / AI / TTS / Mermaid 修复）、数据库版本脚本与产品能力注册相关脚本维护、Vite 版本化构建与代理访问路由适配，以及各迭代功能（笔记百科、生词本、智能秘书等）的落地与回归修复。
**技术栈与架构**：Vue 3 + Vite + Pinia + Vue Router + Element Plus；markdown-it 渲染，Mermaid 图表；通过 axios 对接 model-data-server、AI、Piper TTS、本地文件等微服务。分层为页面层 → 组件层 → 服务层 → 数据持久化；路由 basename 按直接访问 / 代理访问动态判定，构建输出固定版本目录以便平台代理。
**难点与亮点**：
1. **代理与路由共存**：同一构建需同时支持完整 tools-hub-workspace 路径与代理短路径，避免空白页。
2. **学习闭环**：把划线、百科、提问树、释义生词本串成可复习的数据模型，而不仅是聊天流水。
3. **智能导航**：文档量大时用 AI 基于摘要生成思维导图导航，缓解传统文件夹树难找文档的问题。
4. **可复用边界**：将 Markdown 展示提炼为独立组件，降低跨项目重复建设成本。
评论