diff --git a/CLAUDE.md b/CLAUDE.md
index 3cf2f50..501a9a8 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -42,6 +42,9 @@ shared/
     ├── Table.tsx                   # 表格（styled thead，tbody 由调用方提供）
     ├── Toast.tsx                   # 通知条（右下角固定定位）
     ├── Pagination.tsx              # 分页（中文标签："上一页"/"下一页"）
+    ├── hooks/                     # React Hooks
+    │   ├── useDirtyTracker.ts     # 脏状态追踪（"修改后才显示保存按钮"模式）
+    │   └── index.ts               # Barrel 导出
     └── login-page.tsx              # 统一登录页（SSO + LDAP 切换，不在 barrel 中导出）
 ```
 
@@ -350,6 +353,7 @@ import LoginPage from '@shared/ui/login-page'  // 单独导入，不在 barrel 
 | Table | `headers: string[]`, `children: ReactNode` | 样式化 thead，tbody 由调用方提供 |
 | Toast | `message`, `type: 'success'|'error'|'info'`, `onClose` | 右下角固定通知条 |
 | Pagination | `page`, `totalPages`, `onPageChange` | 中文标签，totalPages <= 1 时隐藏 |
+| useDirtyTracker | `isDirty(key, item): boolean`, `markClean(key, item): void`, `removeItem(key): void` | 脏状态追踪 Hook，"修改后才显示保存按钮"模式 |
 | LoginPage | `siteName: string`, `title?: string` | 完整登录页，支持 SSO 和 LDAP 切换 |
 
 ---