diff --git a/AGENTS.md b/AGENTS.md
index 02308b0..b34d8b5 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -39,8 +39,11 @@ Dashboard → UsageDetail（图表） → UsageOverview（总统计）
 
 **桌面小组件（Widget）**：
 - 显示 OpenCode Go 三个用量窗口（5h/本周/本月）+ 进度条 + 重置时间 + DeepSeek 余额
-- 右上角刷新按钮（后台广播 → `WidgetRefreshReceiver` → EntryPoints 获取 `RefreshBalanceUseCase`）
+- 右上角 ↻ 手动刷新按钮（后台广播 → `WidgetRefreshReceiver` → EntryPoints 获取 `RefreshBalanceUseCase`）
 - 进度条颜色按百分比动态变化（<50% 草莓粉 / 50-80% 暖橙 / >80% 玫红）
+- **MIUI Widget 适配**：`miuiWidget` 标识 → 可拖入负一屏；`miui.appwidget.action.APPWIDGET_UPDATE` 曝光刷新（划到即触发，20s 冷却）；`@android:id/background` 根布局 ID（系统统一裁切圆角）
+- **自动刷新**：`onUpdate()` 内缓存为空或超过 5 分钟冷却时自动发送 `WidgetRefreshReceiver` 广播
+- **一键添桌面**：Dashboard 顶部栏 + 按钮 → `requestPinAppWidget`（有 fallback 到 `ACTION_APPWIDGET_PICK`）
 
 ## RemoteViews 兼容性红线
 
@@ -83,6 +86,11 @@ Widget 刷新按钮：
   ↻ → PendingIntent.getBroadcast() → WidgetRefreshReceiver
     → EntryPoints → RefreshBalanceUseCase(DEEPSEEK + OPENCODE_GO)
     → notifyDataChanged()
+
+MIUI 曝光刷新（用户划到负一屏/桌面）：
+  → miui.appwidget.action.APPWIDGET_UPDATE → onReceive() → onUpdate()
+    → 读缓存渲染
+    → 缓存为空/过期? → sendBroadcast(WidgetRefreshReceiver)
 ```
 
 ## 品牌色
@@ -95,4 +103,6 @@ Widget 刷新按钮：
 | 深暖文字 | `#3D2C35` |
 | 暖灰辅助 | `#8A7A82` |
 | 玫红（>80% 警示） | `#E91E63` |
-| 暖橙（50-80%） | `#FFA726` |
\ No newline at end of file
+| 暖橙（50-80%） | `#FFA726` |
+
+深色模式下文字颜色由 `inkWarm()` / `inkMuted()` composable 自动切换（定义在 `Theme.kt`），静态资源通过 `drawable-night/` / `layout-night/` 适配。
\ No newline at end of file
diff --git a/README.md b/README.md
index e23d500..44e278e 100644
--- a/README.md
+++ b/README.md
@@ -18,8 +18,10 @@ Android AI 余额查询 APP —— 统一查看 DeepSeek 和 OpenCode Go 的余
 | 📋 **详细数据** | 原始记录分页浏览，支持时间 + 模型筛选，点击查看完整字段 |
 | 🔍 **多粒度筛选** | 5小时 / 24小时 / 今天 / 昨天 / 最近7天 / 当月 / 自定义日·月·范围 |
 | 🏷️ **模型筛选** | 多选 / 单选 / 全选，动态图例自适应换行 |
-| 📱 **桌面小组件** | 不打开 APP 也能看用量，进度条颜色按百分比动态变化 |
+| 📱 **桌面小组件** | 不打开 APP 也能看用量；可拖入负一屏；划到即自动刷新（MIUI 曝光刷新） |
 | 🔄 **自动同步** | 首页下拉自动同步用量；无缓存时启动自动全量同步 |
+| 🌙 **深色模式** | 全局自适应 — App 内文字/图标/背景自动切换，小组件独立适配暗色布局 |
+| ➕ **一键添桌面** | APP 内点 + 直接添加小组件，不用去系统列表翻 |
 | ⚡ **内存缓存** | DataStore 全量 JSON 仅反序列化一次，后续操作零 IO |
 | 🎀 **雨晴粉主题** | Material Design 3 · 草莓粉 #FF85A2 · 樱粉 #FFD1DC |