From 990ab81722baf94f9ed1ed052efe866b61aa7bc3 Mon Sep 17 00:00:00 2001
From: kuekhaoyang <kuekhaoyang@Gmail.com>
Date: Sun, 21 Dec 2025 21:20:59 +0800
Subject: [PATCH] feat: clarify local password protection settings scope and
 behavior in UI.

---
 README.md                                | 16 ++++++++++------
 components/settings/PasswordSettings.tsx |  2 +-
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 2d9d48e..6f96cc3 100644
--- a/README.md
+++ b/README.md
@@ -111,19 +111,23 @@
 - **Client Components**：复杂交互和状态管理
 ### 🔒 访问控制
 
-- **环境级密码**：通过设置环境变量启用全局访问密码
-- **永久授权**：输入一次密码即可永久访问，无需重复验证
-- **本地管理**：支持在应用设置中添加多个自定义访问密码
+KVideo 提供两个层级的访问保护：
+
+1.  **全局访问保护 (Global)**: 通过设置环境变量 `ACCESS_PASSWORD` 启用。所有访问该实例的用户都必须输入此密码。适用于保护私有部署的实例。
+2.  **本地设备锁 (Local)**: 在应用设置中手动开启。仅在当前浏览器/设备生效，用于防止他人直接操作你的设备。
+
+> [!TIP]
+> **永久授权**: 为了更好的平衡安全与体验，无论哪种密码，只要在当前设备输入正确一次，即可实现永久访问，无需每次进入都重新输入。
 
 ---
 
-## ⚙️ 环境配置
+## ⚙️ 环境配置 (全局保护)
 
-如果需要为你的 KVideo 实例添加访问控制，可以设置以下环境变量：
+如果需要为你的 KVideo 实例添加**全局访问密码**，请设置以下环境变量：
 
 | 变量名 | 必填 | 默认值 | 说明 |
 |------|------|------|------|
-| `ACCESS_PASSWORD` | 否 | - | 设置后，所有访问者必须输入此密码才能使用应用。 |
+| `ACCESS_PASSWORD` | 否 | - | 设置后，任何设备访问该实例都需要先进行身份验证。 |
 
 ### 如何设置环境变量
 
diff --git a/components/settings/PasswordSettings.tsx b/components/settings/PasswordSettings.tsx
index 7db988a..fe2c5ff 100644
--- a/components/settings/PasswordSettings.tsx
+++ b/components/settings/PasswordSettings.tsx
@@ -38,7 +38,7 @@ export function PasswordSettings({
     };
 
     return (
-        <SettingsSection title="访问控制" description="为应用启用密码保护功能。">
+        <SettingsSection title="本地访问控制 (本设备)" description="仅为此浏览器/设备启用密码保护。此设置不会同步，且不影响全局环境变量密码。">
             <div className="space-y-6">
                 <div className="flex items-center justify-between">
                     <label className="text-sm font-medium text-[var(--text-color)]">