Conversation
1. **实现原理**：使用 remark 处理 MDX 源文件 2. **局限性**：不支持 React Hooks、自定义组件等动态内容的渲染 3. **定位**：仅作为 `ssg: false` 场景下的备选方案，建议优先使用 SSG-MD
…SG 和 SSG-MD 功能"。
✅ Deploy Preview for rspress-v2 ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
There was a problem hiding this comment.
Pull request overview
This PR enhances the documentation for the @rspress/plugin-llms plugin by adding explanatory notes about its implementation principles and appropriate usage scenarios. The updates clarify that the plugin uses remark to process MDX files (which limits support for React Hooks and custom components) and should only be used as a fallback when SSG/SSG-MD cannot be enabled due to SSR incompatibility.
- Added technical implementation details explaining the remark-based processing limitation
- Updated warning messages to be more specific about when plugin-llms should be used
- Improved consistency between Chinese and English documentation
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| website/docs/zh/plugin/official-plugins/llms.mdx | Added implementation details and clarified usage scenario in Chinese |
| website/docs/zh/guide/basic/ssg-md.mdx | Updated reference to plugin-llms with more specific SSR incompatibility context in Chinese |
| website/docs/en/plugin/official-plugins/llms.mdx | Added implementation details and clarified usage scenario in English |
| website/docs/en/guide/basic/ssg-md.mdx | Updated reference to plugin-llms with more specific SSR incompatibility context in English |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Rsdoctor Bundle Diff Analysis
Found 3 projects in monorepo, 3 projects with changes. 📊 Quick Summary
📋 Detailed Reports (Click to expand)📁 nodePath:
📦 Download Diff Report: node Bundle Diff 📁 node_mdPath:
📦 Download Diff Report: node_md Bundle Diff 📁 webPath:
📦 Download Diff Report: web Bundle Diff Generated by Rsdoctor GitHub Action |
Summary
Related Issue
Checklist
AI Summary
Changes Made
Updated the warning messages in both
@rspress/plugin-llmsandssg-mddocumentation (EN & ZH) to provide clearer guidance:plugin-llms documentation:
ssg: falseto "when SSG and SSG-MD features cannot be enabled due to code incompatibility with SSR"ssg-md documentation:
@rspress/plugin-llmsreference to use the same clearer description about SSR compatibilityWhy These Changes
The previous documentation simply mentioned
ssg: falsewithout explaining why users might need to use this setting. The updated documentation:This PR was written using Vibe Kanban