diff --git a/README.md b/README.md
index 08cd68e..c53411d 100644
--- a/README.md
+++ b/README.md
@@ -52,7 +52,16 @@
 
 ### 方式一：npm 安装（推荐）
 
+> 包托管于 MetonaTeam 自建 Gitea 私有 npm 源（`git.metona.cn`），不在 npm 官方源发布，安装时需指定 registry。
+
 ```bash
+# 直接指定私有源安装
+npm install @metona-team/metona-editor --registry=https://git.metona.cn/api/packages/MetonaTeam/npm/
+
+# 或配置项目 .npmrc（推荐，一次配置长期生效）
+# .npmrc
+@metona-team:registry=https://git.metona.cn/api/packages/MetonaTeam/npm/
+
 npm install @metona-team/metona-editor
 ```
 
@@ -78,15 +87,12 @@ const editor = MeEditor.create('#editor', { mode: 'split' });
 ### 方式二：CDN 引入
 
 ```html
-<!-- jsDelivr CDN (推荐) -->
-<script src="https://cdn.jsdelivr.net/npm/@metona-team/metona-editor@0.4.1/dist/metona-editor.min.js"></script>
-
-<!-- unpkg CDN -->
-<script src="https://unpkg.com/@metona-team/metona-editor@0.4.1/dist/metona-editor.min.js"></script>
-
-<!-- Gitea 源 -->
+<!-- Gitea 源（私有仓库需登录，公开仓库直接可访问） -->
 <script src="https://git.metona.cn/MetonaTeam/MetonaEditor/raw/branch/master/dist/metona-editor.js"></script>
 
+<!-- 本地构建产物（下载 dist 后引入） -->
+<script src="./dist/metona-editor.min.js"></script>
+
 <div id="editor"></div>
 <script>
   const editor = MeEditor.create('#editor', { mode: 'split' });
diff --git a/site/demo.html b/site/demo.html
index 0bc9b5a..752152b 100644
--- a/site/demo.html
+++ b/site/demo.html
@@ -203,8 +203,8 @@ var demoMd=[
   '```',
   '',
   '```bash',
-  '# 安装与启动',
-  'npm install @metona-team/metona-editor',
+  '# 安装（Gitea 私有源）',
+  'npm install @metona-team/metona-editor --registry=https://git.metona.cn/api/packages/MetonaTeam/npm/',
   'npm run dev',
   '```',
   '',
diff --git a/site/docs.html b/site/docs.html
index a57a41a..92218b4 100644
--- a/site/docs.html
+++ b/site/docs.html
@@ -109,8 +109,11 @@ footer a{color:var(--accent);text-decoration:none}
 <!-- 快速入门 -->
 <section id="quickstart">
 <h2>安装与引入</h2>
-<pre><span class="c-com"># npm 安装</span>
-<span class="c-kw">npm</span> install @metona-team/metona-editor
+<pre><span class="c-com"># npm 安装（Gitea 私有源）</span>
+<span class="c-kw">npm</span> install @metona-team/metona-editor <span class="c-punc">--</span>registry<span class="c-punc">=</span>https<span class="c-punc">:</span><span class="c-punc">//</span>git<span class="c-punc">.</span>metona<span class="c-punc">.</span>cn<span class="c-punc">/</span>api<span class="c-punc">/</span>packages<span class="c-punc">/</span>MetonaTeam<span class="c-punc">/</span>npm<span class="c-punc">/</span>
+
+<span class="c-com">// 或项目 .npmrc 配置 scope 后直接安装</span>
+<span class="c-com">// @metona-team:registry=https://git.metona.cn/api/packages/MetonaTeam/npm/</span>
 
 <span class="c-com">// TypeScript / ES Module</span>
 <span class="c-kw">import</span> MeEditor <span class="c-kw">from</span> <span class="c-str">'@metona-team/metona-editor'</span><span class="c-punc">;</span>
diff --git a/site/index.html b/site/index.html
index e5a77e7..48f5db3 100644
--- a/site/index.html
+++ b/site/index.html
@@ -157,8 +157,8 @@ footer a:hover{text-decoration:underline}
     <span class="section-eyebrow">Quick Start</span>
     <h2 class="section-title">三行代码即可使用</h2>
     <p class="section-sub">npm / CDN / 本地文件 三种方式，TypeScript / ESM / CJS 全面支持。</p>
-    <div class="code-block"><span class="c-com">// 方式一：npm 安装（推荐）</span>
-<span class="c-kw">npm</span> install @metona-team/metona-editor
+    <div class="code-block"><span class="c-com">// 方式一：npm 安装（Gitea 私有源）</span>
+<span class="c-kw">npm</span> install @metona-team/metona-editor <span class="c-punc">--</span>registry<span class="c-punc">=</span>https<span class="c-punc">:</span><span class="c-punc">//</span>git<span class="c-punc">.</span>metona<span class="c-punc">.</span>cn<span class="c-punc">/</span>api<span class="c-punc">/</span>packages<span class="c-punc">/</span>MetonaTeam<span class="c-punc">/</span>npm<span class="c-punc">/</span>
 
 <span class="c-com">// ES Module / TypeScript</span>
 <span class="c-kw">import</span> MeEditor <span class="c-kw">from</span> <span class="c-str">'@metona-team/metona-editor'</span><span class="c-punc">;</span>
@@ -166,8 +166,8 @@ footer a:hover{text-decoration:underline}
 <span class="c-com">// CommonJS</span>
 <span class="c-kw">const</span> MeEditor <span class="c-punc">=</span> <span class="c-fn">require</span><span class="c-punc">(</span><span class="c-str">'@metona-team/metona-editor'</span><span class="c-punc">);</span>
 
-<span class="c-com">// 方式二：CDN 引入</span>
-<span class="c-com">&lt;script src="https://cdn.jsdelivr.net/npm/@metona-team/metona-editor@0.4.1/dist/metona-editor.min.js"&gt;&lt;/script&gt;</span>
+<span class="c-com">// 方式二：Gitea raw 引入</span>
+<span class="c-com">&lt;script src="https://git.metona.cn/MetonaTeam/MetonaEditor/raw/branch/master/dist/metona-editor.js"&gt;&lt;/script&gt;</span>
 
 <span class="c-com">// 方式三：本地文件</span>
 <span class="c-com">&lt;script src="./dist/metona-editor.min.js"&gt;&lt;/script&gt;</span>