@rsdoctor/docs 1.0.0 → 1.0.1-beta.0

package/docs/en/_meta.json

@@ -11,7 +11,7 @@
   },
   {
     "text": "Blog",
-    "link": "/blog/release/release-note-0_4",
+    "link": "/blog/release/release-note-1_0",
     "activeMatch": "/blog/"
   }
 ]

package/docs/en/blog/release/_meta.json

@@ -1 +1 @@
-["release-note-0_4", "release-note-0_3", "release-note-0_1"]
+["release-note-1_0", "release-note-0_4", "release-note-0_3", "release-note-0_1"]

package/docs/en/blog/release/release-note-0_1.mdx

@@ -1,4 +1,10 @@
-# Rsdoctor v0.1 release note
+---
+published_at: 2024-01-24 08:00:00
+---
+
+_January 24, 2024_
+
+# Announcing Rsdoctor 0.1
 
 <picture>
   <img
@@ -8,13 +14,13 @@
   />
 </picture>
 
-We are excited to announce the release of [Rsdoctor](https://rsdoctor.dev/) v0.1!
+We are excited to announce the release of [Rsdoctor](https://rsdoctor.dev/) 0.1!
 
-Rsdoctor is a one-stop build analysis tool for Rspack and Webpack. It allows for detailed analysis of the build process and bundles, making the build process more visual and transparent.
+Rsdoctor is a one-stop build analyzer for Rspack and Webpack. It allows for detailed analysis of the build process and bundles, making the build process more visual and transparent.
 
 ## 📌 Position
 
-**Rsdoctor** is a build analysis tool for analyzing projects built with [Rspack](https://www.rspack.dev/) and [Webpack](https://webpack.js.org/). It supports analysis of projects such as [Rsbuild](https://rsbuild.dev/), [Create React App](https://create-react-app.dev/), [Modern.js](https://modernjs.dev/), and more.
+**Rsdoctor** is a build analyzer for analyzing projects built with [Rspack](https://www.rspack.dev/) and [Webpack](https://webpack.js.org/). It supports analysis of projects such as [Rsbuild](https://rsbuild.dev/), [Create React App](https://create-react-app.dev/), [Modern.js](https://modernjs.dev/), and more.
 
 ![Position](https://assets.rspack.dev/others/assets/rsdoctor/rsdoctor-position.png)
 

package/docs/en/blog/release/release-note-0_3.mdx

@@ -1,8 +1,14 @@
-# Rsdoctor v0.2-0.3 release note
+---
+published_at: 2024-06-02 08:00:00
+---
 
-Rsdoctor v0.3 has been released!
+_June 02, 2024_
 
-The new features of Rsdoctor v0.3 include:
+# Announcing Rsdoctor 0.3
+
+Rsdoctor 0.3 has been released!
+
+The new features of Rsdoctor 0.3 include:
 
 - Custom Extension Rules: Users can customize their own rule checks through the interface.
 - Support for Banner Plugin: Added support for the Banner Plugin, which adds template wrapping to the bundled code, allowing analysis of code changes.

package/docs/en/blog/release/release-note-0_4.mdx

@@ -1,8 +1,14 @@
-# Rsdoctor v0.4 release note
+---
+published_at: 2024-10-09 08:00:00
+---
 
-Rsdoctor v0.4 is now released!
+_October 09, 2024_
 
-The new features of Rsdoctor v0.4 include:
+# Announcing Rsdoctor 0.4
+
+Rsdoctor 0.4 is now released!
+
+The new features of Rsdoctor 0.4 include:
 
 - **Brief Mode**: Outputs a single HTML file, ideal for CI processes.
 - **Bundle Diff**: Compare and analyze changes between two build artifacts.
@@ -10,7 +16,7 @@ The new features of Rsdoctor v0.4 include:
 
 ## Brief mode
 
-In Rsdoctor v0.4, a new **Brief mode** has been added, designed specifically for CI/CD scenarios. Brief mode consolidates the data report into a single HTML page, making it convenient for users to view historical build data in CI/CD and other scenarios. The main features of Brief mode are:
+In Rsdoctor 0.4, a new **Brief mode** has been added, designed specifically for CI/CD scenarios. Brief mode consolidates the data report into a single HTML page, making it convenient for users to view historical build data in CI/CD and other scenarios. The main features of Brief mode are:
 
 - **Single report file**: Previously, Rsdoctor output multiple report data and `Manifest.json`, which was inconvenient for CDN upload and sharing. Brief mode outputs a single report, making it convenient for use in CI processes.
 - **Easy to configure**: Enable by configuring the [mode.brief](/config/options/options#mode) option in the Rsdoctor plugin.
@@ -55,7 +61,7 @@ Plans to support Bundle Diff Action on GitHub to simplify degradation monitoring
 
 <Badge text="Version: 0.4.5" type="warning" />
 
-Support for loader analysis for Vue projects has been added in Rsdoctor v0.4.
+Support for loader analysis for Vue projects has been added in Rsdoctor 0.4.
 
 <img src="https://assets.rspack.dev/others/assets/rsdoctor/vue-loader.png" />
 

package/docs/en/blog/release/release-note-1_0.mdx

@@ -0,0 +1,185 @@
+---
+published_at: 2025-03-19 08:00:00
+---
+
+_March 19, 2025_
+
+# Announcing Rsdoctor 1.0
+
+We are excited to announce the official release of **Rsdoctor 1.0**!
+
+After a year of development and testing, we are proud to introduce **Rsdoctor 1.0** — a build analyzer tailored for the [Rspack](https://rspack.dev/) ecosystem and fully compatible with the [webpack](https://webpack.js.org/) ecosystem.
+
+Rsdoctor is committed to being a one-stop, intelligent build analyzer that makes the build process transparent, predictable, and optimizable through visualization and smart analysis, helping development teams precisely identify bottlenecks, optimize performance, and improve engineering quality.
+
+<video
+  src="https://assets.rspack.dev/others/assets/rsdoctor/rsdoctor-1.0-ui.mp4"
+  style={{
+    width: '100%',
+    height: 'auto',
+    maxHeight: '50vh',
+    objectFit: 'cover',
+    display: 'block',
+  }}
+  autoPlay={true}
+  muted={true}
+  controls={true}
+  loop={true}
+  playsInline
+/>
+
+## Why Rsdoctor
+
+In the field of build analysis, the community already has some mature tools, such as [webpack-bundle-analyzer](https://github.com/webpack-contrib/webpack-bundle-analyzer) for visualizing bundles, and [Statoscope](https://github.com/statoscope/statoscope/) for comprehensive resource analysis. In addition, [speed-measure-webpack-plugin](https://github.com/stephencookdev/speed-measure-webpack-plugin) can be used to analyze the execution time of plugins and loaders, and locate build performance bottlenecks.
+
+However, these tools still have some shortcomings, such as lack of detailed display of build details, lack of comprehensive build problem analysis capabilities, incompatibility with Rspack, and lack of build warning scanning capabilities.
+
+In summary, community tools have the following areas for improvement:
+
+1. **Lack of detail**: Traditional tools cannot delve into the details and changes of the build process, and to view the compilation details of a loader, developers often need to set breakpoints for step-by-step debugging.
+2. **Functional limitations**: Current analyser typically only display bundle data, lacking build scanning capabilities, unable to proactively provide optimization suggestions, and do not support custom scanning rules.
+3. **Support for Rspack**: Existing tools do not fully support Rspack, for example, they cannot analyze Rspack's [builtin loader](https://rspack.dev/guide/features/builtin-swc-loader) of Rspack.
+
+### Birth of Rsdoctor
+
+Based on the above situation, we decided to develop a build analyzer focused on the Rspack ecosystem — **Rsdoctor**.
+
+We designed an intuitive user interface for Rsdoctor, and Rsdoctor extends the **loader profiling capability** by combining the advantages of multiple tools to more deeply analyze the loader behavior in the compilation phase, **built-in the scanning and detection rules for artifacts and compilation**, and supports user **custom rules**.
+
+Rsdoctor not only supports Rspack and webpack, but also supports all tools and frameworks based on Rspack or webpack, such as: [Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor), [Rspeedy (Lynx)](https://lynxjs.org/rspeedy/), [Storybook](https://github.com/rspack-contrib/storybook-rsbuild), [Next.js](https://nextjs.org/), [Nuxt](https://nuxt.com/), [Re.Pack](https://re-pack.dev/), [Modern.js](https://modernjs.dev/), [Rsbuild](https://rsbuild.dev/), [Rspress](https://rspress.dev/) and [Rslib](https://lib.rsbuild.dev/).
+
+Rsdoctor can be used to:
+
+- **As a build analyzer**: Help developers understand every aspect of the build process, and provide detailed compilation and bundle analysis.
+- **As an extensible analysis tool**: Allow developers to customize analysis rules according to project requirements, and achieve targeted optimization of the build process.
+
+## Who is using
+
+Rsdoctor has been widely used within ByteDance, helping developers efficiently analyze and solve various problems in the build process.
+
+Since its open source in 2024, Rsdoctor's npm weekly downloads has exceeded **100k**. In the community, Rsdoctor has been integrated into frameworks such as [Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor) and [Lynx](https://lynxjs.org/rspeedy/use-rsdoctor.html). In addition, Rsdoctor has also been adopted by large projects such as [Sentry](https://github.com/getsentry/sentry/pull/63865), [NocoBase](https://github.com/nocobase/nocobase/blob/main/packages/core/build/src/buildPlugin.ts#L493) and [Grafana](https://github.com/grafana/grafana/pull/94729).
+
+In the future, Rsdoctor will continue to provide first-class support for all tools in the **Rstack** (`Rspack stack` abbreviation) ecosystem:
+
+<img
+  style={{ borderRadius: 12 }}
+  src="https://assets.rspack.dev/rstack/rstack-overview.png"
+/>
+
+## Typical use cases
+
+Rsdoctor offers a rich set of features, detailed content can be found in the [Feature Navigation](/guide/start/features). Here are some typical use cases that demonstrate how Rsdoctor effectively solves common build problems:
+
+### 1. "Why is the build speed too slow?"
+
+During the build process, if you find that the compilation speed is too slow, you can use the [Loader Timeline](/guide/usage/loaders-timeline) to view the time consumption of loader execution, and understand the compilation time consumption of each file by each loader. This way, you can find loaders with excessive time consumption.
+
+<img
+  style={{ borderRadius: 12 }}
+  src="https://assets.rspack.dev/rsdoctor/assets/loader-timeline-overall-v1-0.png"
+/>
+
+### 2. "Outputs are not as expected?"
+
+During the build, there may be problems where the outputs do not match expectations, such as runtime exceptions or style errors. The [Loader Details](/guide/usage/loaders-analysis) page of Rsdoctor can help you examine the changes made by the loader to a specific file before and after compilation.
+
+<img
+  style={{ borderRadius: 12 }}
+  src="https://assets.rspack.dev/rsdoctor/assets/babel-import-errors-v1-0.png"
+/>
+
+### 3. "How to split the chunks reasonably?"
+
+We can use the [Bundle Analysis](/guide/usage/bundle-size) page to look at the modules tree of a particular artifact to see what modules the chunk contains, and then use the [splitChunks](https://rspack.dev/zh/plugins/webpack/split-chunks-plugin) configuration of Rspack to split the chunks appropriately.
+
+<img
+  style={{ borderRadius: 12 }}
+  src="https://assets.rspack.dev/rsdoctor/assets/bundle-size-overall-v1-0.png"
+/>
+
+### 4. "How to analyze the reasons for the increase in bundle size?"
+
+When a certain version is launched, if the performance of the online page deteriorates due to the increase in the size of the artifact, you can use the [Bundle Diff](/guide/usage/bundle-diff) feature of Rsdoctor to compare the details of the bundles of two commits, as well as the changes in the npm packages they depend on.
+
+<img
+  style={{ borderRadius: 12 }}
+  src="https://assets.rspack.dev/rsdoctor/assets/bundle-diff-assets-v1-0.png"
+/>
+
+### 5. "Why is a certain module bundled?"
+
+During the build process, if you want to know why a certain module file is bundled into the artifact, you can click on the `Module Graph` icon behind the module in the Modules tree on the [Artifact Analysis](/guide/usage/bundle-size) page to view the upstream dependency relationship of the module.
+
+<img
+  style={{ width: 700, margin: 'auto', borderRadius: 12 }}
+  src="https://assets.rspack.dev/rsdoctor/assets/module-analysis-tree-v1-0.png"
+/>
+
+## What's new in 1.0
+
+### 🎨 Brand new UI
+
+In version 1.0, we have comprehensively optimized the user interface of Rsdoctor, making it more clear, elegant, and easy to navigate. The new design is dedicated to improving the user experience, making information display more intuitive and efficient.
+
+### 🚀 Faster analysis
+
+In large projects, enabling Rsdoctor can increase the overall build time. To solve this problem, we rewrote the time-consuming data processing logic in Rsdoctor in Rust, and integrated it into Rspack.
+
+This optimization effectively improves the build analysis performance of Rsdoctor, and reduces the overall analysis time by more than **20%**. In the future, we will continue to native more modules to further improve the analysis efficiency.
+
+This optimization can be enabled through the [enableNativePlugin](/config/options/options#enablenativeplugin) option:
+
+```ts
+new RsdoctorRspackPlugin({
+  experiments: {
+    enableNativePlugin: true,
+  },
+});
+```
+
+### 🔍 Module searching
+
+- **Search Module Capability**: In the `Bundle Size` page, we have added a module search function. Users can quickly locate and view the `Assets` where the module is located by entering the module name, making it more convenient to analyze the reference relationship and size of the module. [Details](/guide/usage/bundle-size#%E6%A8%A1%E5%9D%97%E6%90%9C%E7%B4%A2%E5%8A%9F%E8%83%BD)
+
+<img
+  style={{ width: '80%', margin: 'auto', borderRadius: 12 }}
+  src="https://assets.rspack.dev/rsdoctor/assets/search-modules-v1-0.png"
+/>
+
+### 🛠️ New scanning rules
+
+- [Duplicate packages detecting](/guide/rules/rules#e1002-cross-chunks-package): Added a rule for detecting duplicate packages across chunks, which can scan for duplicate packages in different `chunks`. These duplicate packages may cause redundant code in the build.
+- [ECMA version checking](/guide/rules/rules#e1004-ecma-version-check): Enhanced the ECMA version detection rule, used to detect incompatible advanced syntax.
+
+```ts
+new RsdoctorRspackPlugin({
+  linter: {
+    rules: {
+      'ecma-version-check': [
+        'Warn',
+        {
+          ecmaVersion: 2015,
+        },
+      ],
+    },
+  },
+});
+```
+
+## How to use 1.0
+
+- If you are using any tool or framework based on Rspack or webpack, you can refer to the [Quick Start](/guide/start/quick-start) to start using Rsdoctor.
+- If you are using Rsdoctor 0.4 or earlier, please note that 1.0 contains a few incompatible updates:
+  - The `reportCodeType` and `reportDir` configuration items in the plugin configuration have been moved to [output](/config/options/options#reportcodetype).
+
+> Welcome to give a star 🌟 to the [Rsdoctor GitHub](https://github.com/web-infra-dev/rsdoctor) repository.
+
+## Next steps
+
+- **AI powered analysis**: The build analysis data collected by Rsdoctor is very rich, but there may be a certain learning curve for new users. Therefore, we will integrate AI capabilities into Rsdoctor to help users quickly extract key information from massive data, provide intelligent optimization suggestions, and reduce the threshold of build analysis.
+- **CI proactive monitoring**: Rsdoctor will extend its capabilities in CI environments by introducing [Rsdoctor CI Action](https://github.com/web-infra-dev/rsdoctor/discussions/491), based on the existing [Bundle Diff](/guide/usage/bundle-diff) feature. This will provide automated monitoring of bundle sizes and alerts for performance issues to ensure quality.
+- **Further Native**: Due to the implementation of Rspack in Rust and the use of a multi-threaded architecture, the current analysis of the built-in loader of Rspack by Rsdoctor is not accurate enough. We plan to optimize the analysis mechanism based on [Rspack Native Plugin](/config/options/options#enablenativeplugin), and provide more accurate loader performance data and compilation behavior insights.
+
+**Finally, thank you to all the developers who have contributed to Rsdoctor ❤️**:
+
+[@9aoy](https://github.com/9aoy)、[@bin1357](https://github.com/bin1357)、[@cairon666](https://github.com/cairon666)、[@cclap2020](https://github.com/cclap2020)、[@charpeni](https://github.com/charpeni)、[@chenjiahan](https://github.com/chenjiahan)、[@ChuHoMan](https://github.com/ChuHoMan)、[@cnryb](https://github.com/cnryb)、[@Gehbt](https://github.com/Gehbt)、[@gezhicui](https://github.com/gezhicui)、[@HigherOrderLogic](https://github.com/HigherOrderLogic)、[@iamleniac](https://github.com/iamleniac)、[@inottn](https://github.com/inottn)、[@jkzing](https://github.com/jkzing)、[@KyrieLii](https://github.com/KyrieLii)、[@kwonoj](https://github.com/kwonoj)、[@LingyuCoder](https://github.com/LingyuCoder)、[@nanianlisao](https://github.com/nanianlisao)、[@nhducit](https://github.com/nhducit)、[@NickBolles](https://github.com/NickBolles)、[@nyqykk](https://github.com/nyqykk)、[@puppet-666](https://github.com/puppet-666)、[@SoonIter](https://github.com/SoonIter)、[@sudhakar-s](https://github.com/sudhakar-s)、[@Timeless0911](https://github.com/Timeless0911)、[@tinywaves](https://github.com/tinywaves)、[@trueLoving](https://github.com/trueLoving)、[@wChenonly](https://github.com/wChenonly)、[@zllkjc](https://github.com/zllkjc)。

package/docs/en/config/options/options.mdx

@@ -287,7 +287,7 @@ type ISupport = {
 #### banner
 
 :::danger
-When enabling the analysis of BannerPlugin, Rsdoctor should not be used in production versions.
+`supports.banner` option is only used for debugging, do not use it in production.
 :::
 
 - default: false.

package/docs/en/guide/start/intro.mdx

@@ -1,22 +1,35 @@
 # Introduction
 
-## 💡 What is Rsdoctor?
-
-- Rsdoctor is a one-stop tool for diagnosing and analyzing the build process and build artifacts.
-- Rsdoctor is a tool that supports Rspack and webpack build analysis.
-- Rsdoctor is an analysis tool that can display the time-consuming and behavioral details of the compilation.
-- Rsdoctor is a tool that provides bundle diff and other anti-degradation capabilities simultaneously.
+Rsdoctor is a build analyzer tailored for the [Rspack](https://rspack.dev/) ecosystem and fully compatible with the [webpack](https://webpack.js.org/) ecosystem.
+
+Rsdoctor is committed to being a one-stop, intelligent build analyzer that makes the build process transparent, predictable, and optimizable through visualization and smart analysis, helping development teams precisely identify bottlenecks, optimize performance, and improve engineering quality.
+
+Rsdoctor supports all tools and frameworks based on Rspack or webpack, such as: [Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor), [Rspeedy (Lynx)](https://lynxjs.org/rspeedy/), [Storybook](https://github.com/rspack-contrib/storybook-rsbuild), [Next.js](https://nextjs.org/), [Nuxt](https://nuxt.com/), [Re.Pack](https://re-pack.dev/), [Modern.js](https://modernjs.dev/), [Rsbuild](https://rsbuild.dev/), [Rspress](https://rspress.dev/) and [Rslib](https://lib.rsbuild.dev/).
+
+<video
+  src="https://assets.rspack.dev/others/assets/rsdoctor/rsdoctor-1.0-ui.mp4"
+  style={{
+    width: '100%',
+    height: 'auto',
+    maxHeight: '50vh',
+    objectFit: 'cover',
+    display: 'block',
+  }}
+  autoPlay={true}
+  muted={true}
+  controls={true}
+  loop={true}
+  playsInline
+/>
 
 ## 🔥 Features
 
 - **Compilation Visualization**: Rsdoctor visualizes the compilation behavior and time consumption, making it easy to view build issues.
 - **Multiple Analysis Capabilities**: Rsdoctor supports build artifact, build-time analysis, and anti-degradation capabilities:
   - Build artifact support for resource lists and module dependencies, etc.
-  - Build-time analysis supports Loader, Plugin, and Resolver building process analysis, including Rspack's builtin loaders.
+  - Build-time analysis supports Loader, Plugin, and Resolver building process analysis.
   - Build rules support duplicate package detection and ES Version Check, etc.
-  - Currently, bundle diff capabilities are also available.
 - **Support Custom Rules**: In addition to built-in build scan rules, Rsdoctor also supports users adding custom component scan rules based on the build data of Rsdoctor.
-- **Framework-Independent**: Rsdoctor support all projects built on Rspack or webpack.
 
 ## 🛠️ Introduction
 

package/docs/en/guide/start/quick-start-shared.mdx

@@ -114,7 +114,7 @@ export default nextConfig;
 
 - **Options:** The plugin provides some configuration options, please refer to [Options](../../config/options/options).
 
-#### 📢 Note for Next.js Projects
+#### 📢 Note for Next.js projects
 
 Since Next.js closes the terminal service after the `build` execution is completed, the report page server run by Rsdoctor during the build process will also be shut down. At this point, you can reopen the report page using [@rsdoctor/cli](/guide/start/cli) without having to execute the build operation again.
 

package/docs/en/guide/usage/bundle-size.mdx

@@ -141,7 +141,7 @@ Click the **"Bundle Analyzer Graph"** button on the **"Bundle Size"** page to vi
 ## Supports BannerPlugin
 
 :::danger
-When enabling the BannerPlugin analysis, do not use Rsdoctor in the production version.
+`supports.banner` option is only used for debugging, do not use it in production.
 :::
 
 Both Rspack and webpack support the [BannerPlugin](https://www.rspack.dev/plugins/webpack/banner-plugin#bannerplugin), which is a built-in plugin that allows you to add specific content at the top or bottom of the generated chunks.

package/docs/zh/_meta.json

@@ -11,7 +11,7 @@
   },
   {
     "text": "博客",
-    "link": "/blog/release/release-note-0_4",
+    "link": "/blog/release/release-note-1_0",
     "activeMatch": "/blog/"
   }
 ]

package/docs/zh/blog/release/_meta.json

@@ -1 +1 @@
-["release-note-0_4", "release-note-0_3", "release-note-0_1"]
+["release-note-1_0", "release-note-0_4", "release-note-0_3", "release-note-0_1"]

package/docs/zh/blog/release/release-note-0_1.mdx

@@ -1,4 +1,10 @@
-# Rsdoctor v0.1 发布公告
+---
+published_at: 2024-01-24 08:00:00
+---
+
+_January 24, 2024_
+
+# Rsdoctor 0.1 发布公告
 
 <picture>
   <img
@@ -8,7 +14,7 @@
   />
 </picture>
 
-我们很高兴地宣布 [Rsdoctor](https://rsdoctor.dev/) v0.1 发布了！
+我们很高兴地宣布 [Rsdoctor](https://rsdoctor.dev/) 0.1 发布了！
 
 Rsdoctor 是一个针对 Rspack 和 webpack 的一站式构建分析工具，可以对构建时和构建产物进行详细分析，让构建过程变得可视化和透明。
 
@@ -117,6 +123,6 @@ Rsdoctor 的一些实现参考了社区中杰出的项目，对他们表示感
 
 - 借鉴了 [bundle-stats](https://github.com/relative-ci/bundle-stats/tree/master/packages/cli#readme) 对产物关系的分析逻辑。
 - 借鉴了 [webpack-bundle-analyzer](https://github.com/webpack-contrib/webpack-bundle-analyzer) 对产物模块拆解及分析逻辑。
-- [Statoscope](https://github.com/statoscope/statoscope/blob/master/README.md)是一个优秀的构建产物分析工具，Rsdoctor 在构建产物分析方面受到了它的启发。
+- [Statoscope](https://github.com/statoscope/statoscope/blob/master/README.md) 是一个优秀的构建产物分析工具，Rsdoctor 在构建产物分析方面受到了它的启发。
 - [Webpack 团队和社区](https://github.com/webpack/webpack/blob/main/README.md) 创建了一个优秀的打包工具和丰富的生态。
 - [vite-plugin-inspect](https://github.com/antfu/vite-plugin-inspect) 启发了 Rsdoctor 对构建过程分析的探索。

package/docs/zh/blog/release/release-note-0_3.mdx

@@ -1,8 +1,14 @@
-# Rsdoctor v0.2-0.3 发布公告
+---
+published_at: 2024-06-02 08:00:00
+---
 
-Rsdoctor v0.3 已经发布啦!
+_June 02, 2024_
 
-Rsdoctor v0.3 的新特性有:
+# Rsdoctor 0.3 发布公告
+
+Rsdoctor 0.3 已经发布啦!
+
+Rsdoctor 0.3 的新特性有:
 
 - 自定义拓展规则：用户可以通过接口定制特有的规则检查。
 - 支持 Banner Plugin：增加了对 Banner Plugin 的支持，该插件会对产物代码添加模板包裹，因此 Rsdoctor 支持了变化后产物代码的分析。

package/docs/zh/blog/release/release-note-0_4.mdx

@@ -1,8 +1,14 @@
-# Rsdoctor v0.4 发布公告
+---
+published_at: 2024-10-09 08:00:00
+---
 
-Rsdoctor v0.4 已经发布啦!
+_October 09, 2024_
 
-Rsdoctor v0.4 的新特性有:
+# Rsdoctor 0.4 发布公告
+
+Rsdoctor 0.4 已经发布啦!
+
+Rsdoctor 0.4 的新特性有:
 
 - **Brief 模式**: 输出单个报告文件，适用于 CI 流程。
 - **Bundle Diff**: 对比和分析两次构建产物的变化。
@@ -10,7 +16,7 @@ Rsdoctor v0.4 的新特性有:
 
 ## Brief report
 
-在 Rsdoctor v0.4 中，新增了 **Brief 模式**，专为 CI/CD 场景设计。Brief 模式将数据报告整合到一个 HTML 页面中，方便用户在 CI/CD 及其他场景下查看历史构建数据。以下是 Brief 模式的主要特点：
+在 Rsdoctor 0.4 中，新增了 **Brief 模式**，专为 CI/CD 场景设计。Brief 模式将数据报告整合到一个 HTML 页面中，方便用户在 CI/CD 及其他场景下查看历史构建数据。以下是 Brief 模式的主要特点：
 
 - **单个报告文件**：之前 Rsdoctor 输出的多个报告数据与 `Manifest.json`，不方便进行 CDN 上传和共享，Brief 模式输出单一报告方便 CI 流程中使用。
 - **易于配置**：通过配置 Rsdoctor 插件的 [mode.brief](/config/options/options#mode) 选项即可开启 Brief 模式。

package/docs/zh/blog/release/release-note-1_0.mdx

@@ -0,0 +1,183 @@
+---
+published_at: 2025-03-19 08:00:00
+---
+
+_March 19, 2025_
+
+# Rsdoctor 1.0 发布公告
+
+我们很高兴地宣布 **Rsdoctor 1.0** 已经正式发布！
+
+在经过一年的迭代与验证后，我们正式推出 **Rsdoctor 1.0** —— 一款为 [Rspack](https://rspack.dev/) 生态量身打造的构建分析工具，同时也完全兼容 [webpack](https://webpack.js.org/) 生态。
+
+Rsdoctor 致力于成为一站式、智能化的构建分析工具，通过可视化与智能分析，使整个构建流程变得透明、可预测和可优化，从而帮助开发团队精准定位瓶颈、优化性能并提升工程质量。
+
+<video
+  src="https://assets.rspack.dev/others/assets/rsdoctor/rsdoctor-1.0-ui.mp4"
+  style={{
+    width: '100%',
+    height: 'auto',
+    maxHeight: '50vh',
+    objectFit: 'cover',
+    display: 'block',
+  }}
+  autoPlay={true}
+  muted={true}
+  controls={true}
+  loop={true}
+  playsInline
+/>
+
+## 为什么是 Rsdoctor
+
+在构建分析领域，社区已有一些成熟的工具，如用于产物体积可视化的 [webpack-bundle-analyzer](https://github.com/webpack-contrib/webpack-bundle-analyzer)、提供资源全面分析的 [Statoscope](https://github.com/statoscope/statoscope/)。此外，[speed-measure-webpack-plugin](https://github.com/stephencookdev/speed-measure-webpack-plugin) 可以用于分析插件与 loader 的执行时间，定位构建性能瓶颈。
+
+然而，这些工具依然存在一些不足，例如缺乏细粒度的构建细节展示、不具备全方位的构建问题分析能力、不兼容 Rspack、以及缺少构建预警扫描功能。
+
+总结来说，社区工具有以下可改进的方面：
+
+1. **分析不够深入**：传统工具无法深入探索构建过程的细节和变化。例如，如果想要查看某个 loader 编译细节，开发者常常需要手动设置断点逐步调试。
+2. **功能局限性**：现有的分析工具通常只展示产物数据，缺乏构建扫描功能，无法主动提供优化建议，也不支持自定义检查规则。
+3. **Rspack 支持**：现有工具对 Rspack 的支持不够全面，例如无法分析 Rspack 的 [内置 loader](https://rspack.dev/guide/features/builtin-swc-loader) 。
+
+### Rsdoctor 的诞生
+
+根据以上现状，我们决定为 Rspack 生态开发一个专注于构建分析的工具 —— **Rsdoctor**。
+
+我们为 Rsdoctor 设计了直观的用户界面，将构建数据可视化。同时，Rsdoctor 在结合多种工具的基础上，额外扩展了 loader 分析能力以更深入 loader 的编译行为，内置了产物及编译的扫描和检测规则，并支持用户自定义规则。
+
+Rsdoctor 不仅支持 Rspack 和 webpack，也支持所有基于 Rspack 或 webpack 的工具和框架，例如：[Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor)、[Rspeedy (Lynx)](https://lynxjs.org/rspeedy/)、[Storybook](https://github.com/rspack-contrib/storybook-rsbuild)、[Next.js](https://nextjs.org/)、[Nuxt](https://nuxt.com/)、[Re.Pack](https://re-pack.dev/)、[Modern.js](https://modernjs.dev/)、[Rsbuild](https://rsbuild.dev/)、[Rspress](https://rspress.dev/) 和 [Rslib](https://lib.rsbuild.dev/) 等。
+
+Rsdoctor 可以被用于：
+
+- **作为一个构建分析工具**：帮助开发者深入了解构建过程中的每一个环节，提供详细的编译和产物分析。
+- **作为一个可扩展的分析工具**：允许开发者根据项目需求自定义分析规则，实现对构建过程的有针对性的优化。
+
+## 谁在使用
+
+Rsdoctor 已在字节跳动内部得到广泛应用，帮助开发者高效分析和解决构建过程中的各类问题。
+
+自 2024 年开源以来，Rsdoctor 在 npm 上的周下载量已突破 **10 万**。在社区里，Rsdoctor 已被集成到 [Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor) 和 [Lynx](https://lynxjs.org/rspeedy/use-rsdoctor.html) 等框架中。此外，Rsdoctor 也被 [Sentry](https://github.com/getsentry/sentry/pull/63865)、[NocoBase](https://github.com/nocobase/nocobase/blob/main/packages/core/build/src/buildPlugin.ts#L493) 和 [Grafana](https://github.com/grafana/grafana/pull/94729) 等大型项目所采用。
+
+未来 Rsdoctor 将持续为 **Rstack**（`Rspack stack` 的缩写）生态的所有工具提供一流的支持：
+
+<img
+  style={{ borderRadius: 12 }}
+  src="https://assets.rspack.dev/rstack/rstack-overview.png"
+/>
+
+## 常见应用场景
+
+Rsdoctor 提供了丰富的功能，详细内容可参考 [功能导航](/guide/start/features)。以下是几个典型应用场景，展示了 Rsdoctor 如何有效解决常见的构建问题：
+
+### 1. 「构建速度太慢？」
+
+在构建过程中，如果发现编译速度过慢，可以通过 [Loader 时序图](/guide/usage/loaders-timeline) 查看 loader 执行的时间开销，以及每个文件的编译时间开销，从而对性能不足的 loader 进行针对性优化。
+
+<img
+  style={{ borderRadius: 12 }}
+  src="https://assets.rspack.dev/rsdoctor/assets/loader-timeline-overall-v1-0.png"
+/>
+
+### 2. 「构建结果与预期不符？」
+
+在构建过程中，可能会遇到编译结果与预期不符的问题，例如出现运行时异常或样式错误等问题。Rsdoctor 的 [Loader Details](/guide/usage/loaders-analysis) 页面可以帮助你检查 loader 对特定文件的编译前后变化。
+
+<img
+  style={{ borderRadius: 12 }}
+  src="https://assets.rspack.dev/rsdoctor/assets/babel-import-errors-v1-0.png"
+/>
+
+### 3.「如何合理分包？」
+
+我们可以通过 [产物分析](/guide/usage/bundle-size) 页面查看某个产物的 Modules 树来查看该产物资源包含了哪些 Modules，进而通过 Rspack 的 [splitChunks](https://rspack.dev/zh/plugins/webpack/split-chunks-plugin) 配置来进行合理的分包。
+
+<img
+  style={{ borderRadius: 12 }}
+  src="https://assets.rspack.dev/rsdoctor/assets/bundle-size-overall-v1-0.png"
+/>
+
+### 4.「如何分析产物增大原因？」
+
+当某个版本上线后，由于产物体积增大导致线上页面性能出现劣化，可以通过 Rsdoctor 的 [Bundle Diff](/guide/usage/bundle-diff) 功能来对比两次 commit 的产物细节，以及依赖的 npm 包变化。
+
+<img
+  style={{ borderRadius: 12 }}
+  src="https://assets.rspack.dev/rsdoctor/assets/bundle-diff-assets-v1-0.png"
+/>
+
+### 5.「某个模块为什么会被打包？」
+
+构建过程中，如果想要知道某个模块文件为什么会被打包到产物中，则可以在 [产物分析](/guide/usage/bundle-size) 页面中的 Modules 树图中点击该模块后面的 `Module Graph` 图标，查看该模块的上游依赖模块关系。
+
+<img
+  style={{ width: 700, margin: 'auto', borderRadius: 12 }}
+  src="https://assets.rspack.dev/rsdoctor/assets/module-analysis-tree-v1-0.png"
+/>
+
+## 1.0 新特性
+
+### 🎨 UI 界面升级
+
+在 1.0 版本中，我们全面优化了 Rsdoctor 的用户界面，使其更加清晰、优雅和易于导航。新的设计致力于改善用户体验，并让信息展示更加直观和高效。
+
+### 🚀 分析效率提升
+
+在大型项目中，启用 Rsdoctor 会导致整体构建时间增加。为解决这一问题，我们将 Rsdoctor 中耗时较长的数据处理逻辑使用 Rust 重写，并集成到 Rspack 中。这一优化有效提升了 Rsdoctor 的构建分析性能，整体分析时间减少了 20% 以上。后续我们将继续将更多模块原生化来进一步提升分析效率。
+
+这一优化可以通过 [enableNativePlugin](/config/options/options#enablenativeplugin) 选项开启：
+
+```ts
+new RsdoctorRspackPlugin({
+  experiments: {
+    enableNativePlugin: true,
+  },
+});
+```
+
+### 🔍 模块搜索功能
+
+在 `Bundle Size` 页面中，我们新增了 [模块搜索功能](/guide/usage/bundle-size#%E6%A8%A1%E5%9D%97%E6%90%9C%E7%B4%A2%E5%8A%9F%E8%83%BD)。用户可以通过输入模块名称来快速定位和查看模块所在的 chunk，从而更方便地分析模块的引用关系和大小。
+
+<img
+  style={{ width: '80%', margin: 'auto', borderRadius: 12 }}
+  src="https://assets.rspack.dev/rsdoctor/assets/search-modules-v1-0.png"
+/>
+
+### 🛠️ 新增扫描规则
+
+- [重复包检测](/guide/rules/rules#e1002-cross-chunks-package)：新增了跨 chunks 的重复包检测规则，该规则能够扫描不同 chunks 中的重复包。这些重复包可能导致产物体积增大。
+- [ECMA 版本检测](/guide/rules/rules#e1004-ecma-version-check)：增强了 ECMA 版本检测规则，用于检测不兼容的高级语法。
+
+```ts
+new RsdoctorRspackPlugin({
+  linter: {
+    rules: {
+      'ecma-version-check': [
+        'Warn',
+        {
+          ecmaVersion: 2015,
+        },
+      ],
+    },
+  },
+});
+```
+
+## 如何使用 1.0
+
+- 如果你在使用任何基于 Rspack 或 webpack 的工具或框架，可以参考 [快速开始](/guide/start/quick-start) 来开始使用 Rsdoctor。
+- 如果你在使用 Rsdoctor 0.4 或更早的版本，请留意 1.0 包含少量不兼容更新：
+  - 插件配置中的 `reportCodeType` 和 `reportDir` 配置项移动到 [output](/config/options/options#reportcodetype) 下。
+
+> 欢迎为 [Rsdoctor GitHub](https://github.com/web-infra-dev/rsdoctor) 仓库点亮一颗 Star 🌟。
+
+## 下一步
+
+- **AI 智能分析**：Rsdoctor 收集的构建分析数据非常丰富，但对新用户而言可能存在一定的学习成本。为此，我们将整合 AI 能力到 Rsdoctor 中，帮助用户从海量数据中快速提取关键信息，提供智能优化建议，从而降低构建分析的门槛。
+- **CI 主动防劣化**：基于现有的 [Bundle Diff](/guide/usage/bundle-diff) 功能，Rsdoctor 将拓展 CI 环境下的主动防劣化能力，推出 [Rsdoctor CI Action](https://github.com/web-infra-dev/rsdoctor/discussions/491)，实现自动化的产物体积监控和性能劣化预警，为工程质量提供保障。
+- **进一步原生化**：由于 Rspack 基于 Rust 实现且采用多线程架构，当前 Rsdoctor 对 Rspack 内置 loader 的分析不够精确。我们计划在 [Rspack Native Plugin](/config/options/options#enablenativeplugin) 的基础上优化分析机制，提供更准确的 loader 性能数据和编译行为洞察。
+
+**最后，感谢所有为 Rsdoctor 贡献过的开发者 ❤️**：
+
+[@9aoy](https://github.com/9aoy)、[@bin1357](https://github.com/bin1357)、[@cairon666](https://github.com/cairon666)、[@cclap2020](https://github.com/cclap2020)、[@charpeni](https://github.com/charpeni)、[@chenjiahan](https://github.com/chenjiahan)、[@ChuHoMan](https://github.com/ChuHoMan)、[@cnryb](https://github.com/cnryb)、[@Gehbt](https://github.com/Gehbt)、[@gezhicui](https://github.com/gezhicui)、[@HigherOrderLogic](https://github.com/HigherOrderLogic)、[@iamleniac](https://github.com/iamleniac)、[@inottn](https://github.com/inottn)、[@jkzing](https://github.com/jkzing)、[@KyrieLii](https://github.com/KyrieLii)、[@kwonoj](https://github.com/kwonoj)、[@LingyuCoder](https://github.com/LingyuCoder)、[@nanianlisao](https://github.com/nanianlisao)、[@nhducit](https://github.com/nhducit)、[@NickBolles](https://github.com/NickBolles)、[@nyqykk](https://github.com/nyqykk)、[@puppet-666](https://github.com/puppet-666)、[@SoonIter](https://github.com/SoonIter)、[@sudhakar-s](https://github.com/sudhakar-s)、[@Timeless0911](https://github.com/Timeless0911)、[@tinywaves](https://github.com/tinywaves)、[@trueLoving](https://github.com/trueLoving)、[@wChenonly](https://github.com/wChenonly)、[@zllkjc](https://github.com/zllkjc)。

package/docs/zh/config/options/options.mdx

@@ -286,7 +286,7 @@ type ISupport = {
 #### banner
 
 :::danger
-开启 BannerPlugin 分析时，请勿在生产版本中使用 Rsdoctor。
+`supports.banner` 分析仅用于调试，请勿将其用于生产。
 :::
 
 - **类型：** `boolean`

package/docs/zh/guide/start/intro.mdx

@@ -1,11 +1,26 @@
 # 介绍
 
-## 💡 什么是 Rsdoctor？
-
-- Rsdoctor 是一个面向构建过程与构建产物提供诊断和分析的一站式工具。
-- Rsdoctor 是一个支持 Rspack 及 webpack 构建分析工具。
-- Rsdoctor 是一个可以展示编译耗时及编译行为细节的分析工具。
-- Rsdoctor 是一个提供 Bundle Diff 等防劣化能力的工具。
+Rsdoctor 是一款为 [Rspack](https://rspack.dev/) 生态量身打造的构建分析工具，同时也完全兼容 [webpack](https://webpack.js.org/) 生态。
+
+Rsdoctor 致力于成为一站式、智能化的构建分析工具，通过可视化与智能分析，使整个构建流程变得透明、可预测和可优化，从而帮助开发团队精准定位瓶颈、优化性能并提升工程质量。
+
+Rsdoctor 支持所有基于 Rspack 或 webpack 的工具和框架，例如：[Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor)、[Rspeedy (Lynx)](https://lynxjs.org/rspeedy/)、[Storybook](https://github.com/rspack-contrib/storybook-rsbuild)、[Next.js](https://nextjs.org/)、[Nuxt](https://nuxt.com/)、[Re.Pack](https://re-pack.dev/)、[Modern.js](https://modernjs.dev/)、[Rsbuild](https://rsbuild.dev/)、[Rspress](https://rspress.dev/) 和 [Rslib](https://lib.rsbuild.dev/) 等。
+
+<video
+  src="https://assets.rspack.dev/others/assets/rsdoctor/rsdoctor-1.0-ui.mp4"
+  style={{
+    width: '100%',
+    height: 'auto',
+    maxHeight: '50vh',
+    objectFit: 'cover',
+    display: 'block',
+  }}
+  autoPlay={true}
+  muted={true}
+  controls={true}
+  loop={true}
+  playsInline
+/>
 
 ## 🔥 特性
 
@@ -13,10 +28,8 @@
 - **多种分析能力**：支持构建产物、构建时分析能力：
   - 构建产物支持资源列表及模块依赖等。
   - 构建时分析支持 Loader、Plugin、Resolver 构建过程分析。
-  - 支持分析 Rspack 的 builtin loaders。
   - 构建规则支持重复包检测及 ES Version Check 检查等。
 - **支持自定义规则**：除了内置构建扫描规则外，还支持用户根据 Rsdoctor 的构建数据添加自定义构建扫描规则。
-- **框架无关**：支持所有基于 Rspack 或 webpack 构建的项目。
 
 ## 🛠️ 功能介绍
 

package/docs/zh/guide/usage/bundle-size.mdx

@@ -132,7 +132,7 @@
 ## 支持 BannerPlugin
 
 :::danger
-开启 BannerPlugin 分析时，请勿在生产版本中使用 Rsdoctor。
+`supports.banner` 选项仅用于调试，请勿将其用于生产。
 :::
 
 由于 Rspack 和 webpack 都支持 [BannerPlugin](https://www.rspack.dev/plugins/webpack/banner-plugin#bannerplugin)，BannerPlugin 是可在生成的 chunk 顶部或尾部添加一段指定的内容的内置插件。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsdoctor/docs",
-  "version": "1.0.0",
+  "version": "1.0.1-beta.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/web-infra-dev/rsdoctor",
@@ -19,9 +19,9 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@rspress/plugin-rss": "2.0.0-alpha.3",
+    "@rspress/plugin-rss": "2.0.0-alpha.5",
     "@types/node": "^16",
-    "@types/react": "^18.3.18",
+    "@types/react": "^18.3.19",
     "@types/react-dom": "^18.3.5",
     "react": "18.3.1",
     "react-dom": "18.3.1",
@@ -30,12 +30,12 @@
     "rspress-plugin-font-open-sans": "^1.0.0",
     "rspress-plugin-sitemap": "^1.1.1",
     "typescript": "^5.2.2",
-    "@rsdoctor/types": "1.0.0"
+    "@rsdoctor/types": "1.0.1-beta.0"
   },
   "dependencies": {
     "@rstack-dev/doc-ui": "1.7.3",
-    "react-markdown": "^9.0.3",
-    "rspress": "2.0.0-alpha.3"
+    "react-markdown": "^9.1.0",
+    "rspress": "2.0.0-alpha.5"
   },
   "scripts": {
     "dev": "rspress dev",