| name | chatbot-mvp-distillation-zh |
| description | 将 chatgpt-vue3-light-mvp 项目蒸馏为可迁移到其他项目的中文架构指南。适用于设计或实现类似 ChatGPT 的 Web 对话产品，包括 SSE/fetch 流式响应、模型适配器契约、打字机渲染、Markdown/代码/KaTeX/Mermaid 渲染、推理过程展示，以及从本 Vue 3 MVP 迁移到其他项目的方案规划。 |
Chatbot MVP 蒸馏 zh
使用这个 Skill，把 chatgpt-vue3-light-mvp 的工程经验迁移到其他项目，而不是机械复制当前仓库代码。
源项目是一个基于 Vue 3 + Vite + TypeScript 的单轮大模型对话 MVP。它最值得复用的经验是：
- 将模型特有的流式协议和 UI 渲染解耦
- 先把不同模型的增量响应归一化为文本块，再交给界面展示
- 使用打字机缓冲区，让网络读取速度和视觉输出速度分离
- 将 Markdown、代码高亮、数学公式、Mermaid 图表和推理块组织成独立渲染管线
- 保留 Mock Stream，让其他项目在没有真实 API Key 时也能开发和验证界面
使用流程
- 先识别目标项目的前端框架、状态管理方式和 API 边界。
- 设计整体模块边界时，阅读 references/architecture.md。
- 实现 fetch/SSE/ReadableStream 流式处理时，阅读 references/streaming-sse.md。
- 增加模型供应商或统一响应格式时，阅读 references/model-adapters.md。
- 实现富文本回答渲染时，阅读 references/markdown-rendering.md。
- 在其他项目落地前，阅读 references/migration-checklist.md 做迁移检查。
输出要求
在其他项目使用这个 Skill 时：
- 先描述适配后的架构，再动代码
- 保持模型适配器和 UI 组件相互独立
- 在实现供应商之前，先定义小而稳定的流式增量契约
- 保留一条本地 Mock Stream 路径，方便开发和演示
- 明确指出目标项目和当前 Vue MVP 的差异
- 在可行时验证流式读取、停止生成、完成态、Markdown、代码块、数学公式和 Mermaid 图表
源码锚点
可以把这些文件作为源项目案例阅读：
src/views/chat.vue：输入、模型选择、reader 生命周期和停止生成行为src/store/business/index.ts：创建 reader 的 service/store 边界src/components/MarkdownPreview/transform/index.ts：SSE 与 JSON chunk 拆包src/components/MarkdownPreview/models/index.ts：模型适配器和增量响应转换src/components/MarkdownPreview/index.vue：打字机渲染和完成状态src/components/MarkdownPreview/plugins/markdown.ts：Markdown、KaTeX、Mermaid 和推理块渲染
