diff --git a/guide.md b/guide.md
index 6834c6c080..abb8e0cee2 100644
--- a/guide.md
+++ b/guide.md
@@ -49,8 +49,8 @@ Use browser ESM assets from a CDN:
   href="https://cdn.rrweb.com/replay/current/dist/style.css"
 />
 <script type="module">
-  import { record } from 'https://cdn.rrweb.com/record/current/dist/record.js';
-  import { Replayer } from 'https://cdn.rrweb.com/replay/current/dist/replay.js';
+  import { record } from 'https://cdn.rrweb.com/record/current/dist/record.min.js';
+  import { Replayer } from 'https://cdn.rrweb.com/replay/current/dist/replay.min.js';
 
   record({
     emit(event) {
@@ -61,9 +61,10 @@ Use browser ESM assets from a CDN:
 ```
 
 Use `current` for the latest stable release, or pin an exact version such as
-`https://cdn.rrweb.com/record/2.0.0/dist/record.js` and
-`https://cdn.rrweb.com/replay/2.0.0/dist/replay.js` for immutable
-production URLs.
+`https://cdn.rrweb.com/record/2.0.0/dist/record.min.js` and
+`https://cdn.rrweb.com/replay/2.0.0/dist/replay.min.js` for immutable
+production URLs. Use `.min.js` for production; the unminified `.js` sibling
+remains useful for debugging.
 
 `rrweb-player` is also available as a browser ESM asset:
 
@@ -73,7 +74,7 @@ production URLs.
   href="https://cdn.rrweb.com/rrweb-player/current/style.css"
 />
 <script type="module">
-  import rrwebPlayer from 'https://cdn.rrweb.com/rrweb-player/current/rrweb-player.js';
+  import rrwebPlayer from 'https://cdn.rrweb.com/rrweb-player/current/rrweb-player.min.js';
 </script>
 ```
 
@@ -329,7 +330,7 @@ the CDN:
   href="https://cdn.rrweb.com/replay/current/dist/style.css"
 />
 <script type="module">
-  import { Replayer } from 'https://cdn.rrweb.com/replay/current/dist/replay.js';
+  import { Replayer } from 'https://cdn.rrweb.com/replay/current/dist/replay.min.js';
 
   const events = YOUR_EVENTS;
 
@@ -338,6 +339,9 @@ the CDN:
 </script>
 ```
 
+Use `.min.js` for production; switch to the unminified `.js` sibling when
+debugging.
+
 #### Control the replayer by API
 
 ```js
@@ -410,10 +414,13 @@ Browser without bundler (ESM):
   href="https://cdn.rrweb.com/rrweb-player/current/style.css"
 />
 <script type="module">
-  import rrwebPlayer from 'https://cdn.rrweb.com/rrweb-player/current/rrweb-player.js';
+  import rrwebPlayer from 'https://cdn.rrweb.com/rrweb-player/current/rrweb-player.min.js';
 </script>
 ```
 
+Use `.min.js` for production; switch to the unminified `.js` sibling when
+debugging.
+
 Legacy direct `<script>` include (UMD fallback):
 
 ```html
diff --git a/guide.zh_CN.md b/guide.zh_CN.md
index 9ea743d457..e092ebe7df 100644
--- a/guide.zh_CN.md
+++ b/guide.zh_CN.md
@@ -47,8 +47,8 @@ import '@rrweb/all/dist/style.css';
   href="https://cdn.rrweb.com/replay/current/dist/style.css"
 />
 <script type="module">
-  import { record } from 'https://cdn.rrweb.com/record/current/dist/record.js';
-  import { Replayer } from 'https://cdn.rrweb.com/replay/current/dist/replay.js';
+  import { record } from 'https://cdn.rrweb.com/record/current/dist/record.min.js';
+  import { Replayer } from 'https://cdn.rrweb.com/replay/current/dist/replay.min.js';
 
   record({
     emit(event) {
@@ -59,8 +59,9 @@ import '@rrweb/all/dist/style.css';
 ```
 
 `current` 指向最新稳定版本；生产环境也可以固定到不可变的精确版本，例如
-`https://cdn.rrweb.com/record/2.0.0/dist/record.js` 和
-`https://cdn.rrweb.com/replay/2.0.0/dist/replay.js`。
+`https://cdn.rrweb.com/record/2.0.0/dist/record.min.js` 和
+`https://cdn.rrweb.com/replay/2.0.0/dist/replay.min.js`。生产环境请使用 `.min.js`；
+未压缩的 `.js` 同级文件仍适合调试。
 
 `rrweb-player` 也提供浏览器 ESM 资源：
 
@@ -70,7 +71,7 @@ import '@rrweb/all/dist/style.css';
   href="https://cdn.rrweb.com/rrweb-player/current/style.css"
 />
 <script type="module">
-  import rrwebPlayer from 'https://cdn.rrweb.com/rrweb-player/current/rrweb-player.js';
+  import rrwebPlayer from 'https://cdn.rrweb.com/rrweb-player/current/rrweb-player.min.js';
 </script>
 ```
 
@@ -323,7 +324,7 @@ import '@rrweb/replay/dist/style.css';
   href="https://cdn.rrweb.com/replay/current/dist/style.css"
 />
 <script type="module">
-  import { Replayer } from 'https://cdn.rrweb.com/replay/current/dist/replay.js';
+  import { Replayer } from 'https://cdn.rrweb.com/replay/current/dist/replay.min.js';
 
   const events = YOUR_EVENTS;
 
@@ -332,6 +333,8 @@ import '@rrweb/replay/dist/style.css';
 </script>
 ```
 
+生产环境请使用 `.min.js`；调试时可改用未压缩的 `.js` 同级文件。
+
 #### 使用 API 控制回放
 
 ```js
@@ -402,10 +405,12 @@ import 'rrweb-player/dist/style.css';
   href="https://cdn.rrweb.com/rrweb-player/current/style.css"
 />
 <script type="module">
-  import rrwebPlayer from 'https://cdn.rrweb.com/rrweb-player/current/rrweb-player.js';
+  import rrwebPlayer from 'https://cdn.rrweb.com/rrweb-player/current/rrweb-player.min.js';
 </script>
 ```
 
+生产环境请使用 `.min.js`；调试时可改用未压缩的 `.js` 同级文件。
+
 Legacy 直接 `<script>` 引入（UMD 兼容）：
 
 ```html
diff --git a/packages/record/README.md b/packages/record/README.md
index 67fcd7132b..7f67886696 100644
--- a/packages/record/README.md
+++ b/packages/record/README.md
@@ -22,13 +22,14 @@ browser:
 
 ```html
 <script type="module">
-  import { record } from 'https://cdn.rrweb.com/record/current/dist/record.js';
+  import { record } from 'https://cdn.rrweb.com/record/current/dist/record.min.js';
 </script>
 ```
 
 Use `current` for the latest stable release, or pin an exact version such as
-`https://cdn.rrweb.com/record/2.0.0/dist/record.js` for immutable
-production URLs.
+`https://cdn.rrweb.com/record/2.0.0/dist/record.min.js` for immutable
+production URLs. Use `.min.js` for production; the unminified `.js` sibling
+remains useful for debugging.
 
 ### 3) Legacy Direct `<script>` Include (UMD fallback)
 
diff --git a/packages/replay/README.md b/packages/replay/README.md
index a8c8a32990..9f7bdebadd 100644
--- a/packages/replay/README.md
+++ b/packages/replay/README.md
@@ -27,13 +27,14 @@ browser:
   href="https://cdn.rrweb.com/replay/current/dist/style.css"
 />
 <script type="module">
-  import { Replayer } from 'https://cdn.rrweb.com/replay/current/dist/replay.js';
+  import { Replayer } from 'https://cdn.rrweb.com/replay/current/dist/replay.min.js';
 </script>
 ```
 
 Use `current` for the latest stable release, or pin an exact version such as
-`https://cdn.rrweb.com/replay/2.0.0/dist/replay.js` for immutable
-production URLs.
+`https://cdn.rrweb.com/replay/2.0.0/dist/replay.min.js` for immutable
+production URLs. Use `.min.js` for production; the unminified `.js` sibling
+remains useful for debugging.
 
 ### 3) Legacy Direct `<script>` Include (UMD fallback)
 
diff --git a/packages/rrweb-player/README.md b/packages/rrweb-player/README.md
index 7a32c98218..5985c9b67e 100644
--- a/packages/rrweb-player/README.md
+++ b/packages/rrweb-player/README.md
@@ -27,14 +27,16 @@ import 'rrweb-player/dist/style.css';
   href="https://cdn.rrweb.com/rrweb-player/current/style.css"
 />
 <script type="module">
-  import rrwebPlayer from 'https://cdn.rrweb.com/rrweb-player/current/rrweb-player.js';
+  import rrwebPlayer from 'https://cdn.rrweb.com/rrweb-player/current/rrweb-player.min.js';
 </script>
 ```
 
 Use `current` for the latest stable release, or pin an exact version such as
-`https://cdn.rrweb.com/rrweb-player/2.0.0/rrweb-player.js` for immutable
-production URLs. See the [CDN assets docs](https://rrweb.com/docs/cloud/cdn-assets)
-for the full URL shape and catalog.
+`https://cdn.rrweb.com/rrweb-player/2.0.0/rrweb-player.min.js` for immutable
+production URLs. Use `.min.js` for production; the unminified `.js` sibling
+remains useful for debugging. See the
+[CDN assets docs](https://rrweb.com/docs/cloud/cdn-assets) for the full URL
+shape and catalog.
 
 ### 3) Legacy Direct `<script>` Include (UMD fallback)
 
diff --git a/packages/rrweb/README.md b/packages/rrweb/README.md
index c880a4a507..e97a02f8b2 100644
--- a/packages/rrweb/README.md
+++ b/packages/rrweb/README.md
@@ -67,15 +67,16 @@ import 'rrweb/dist/style.css';
   href="https://cdn.rrweb.com/replay/current/dist/style.css"
 />
 <script type="module">
-  import { record } from 'https://cdn.rrweb.com/record/current/dist/record.js';
-  import { Replayer } from 'https://cdn.rrweb.com/replay/current/dist/replay.js';
+  import { record } from 'https://cdn.rrweb.com/record/current/dist/record.min.js';
+  import { Replayer } from 'https://cdn.rrweb.com/replay/current/dist/replay.min.js';
 </script>
 ```
 
 Use `current` for the latest stable release, or pin exact versions such as
-`https://cdn.rrweb.com/record/2.0.0/dist/record.js` and
-`https://cdn.rrweb.com/replay/2.0.0/dist/replay.js` for immutable
-production URLs.
+`https://cdn.rrweb.com/record/2.0.0/dist/record.min.js` and
+`https://cdn.rrweb.com/replay/2.0.0/dist/replay.min.js` for immutable
+production URLs. Use `.min.js` for production; the unminified `.js` sibling
+remains useful for debugging.
 
 ### 3) Legacy Direct `<script>` Include (UMD fallback)