feat: 功能

frontend/utils/README.md

@@ -0,0 +1,108 @@
+# 全局工具模块 (Monorepo Utils)
+
+此目录包含可在 monorepo 各个应用中复用的全局工具函数。
+
+## 📁 目录结构
+
+```
+utils/
+├── token-manager.js  # Token 统一管理工具
+└── README.md         # 本文件
+```
+
+## 🚀 使用方式
+
+### Token 管理 (`token-manager.js`)
+
+在应用中使用全局 token 管理工具：
+
+```javascript
+// 导入 token 管理工具
+import { 
+  getToken, 
+  setToken, 
+  clearAllTokens,
+  getAuthHeader 
+} from '@gold/utils/token-manager'
+
+// 获取 token
+const token = getToken()
+
+// 设置 token
+setToken({
+  accessToken: 'xxx',
+  refreshToken: 'yyy'
+})
+
+// 获取 Authorization Header
+const header = getAuthHeader() // Bearer xxx
+
+// 清空所有 token
+clearAllTokens()
+```
+
+## 📝 API 说明
+
+### Token 管理函数
+
+#### `getToken()`
+获取访问令牌（按优先级读取）
+
+**返回值：** `string` - token 字符串或空字符串
+
+#### `getAccessToken()`
+获取访问令牌（别名，兼容旧代码）
+
+**返回值：** `string` - token 字符串或空字符串
+
+#### `getRefreshToken()`
+获取刷新令牌
+
+**返回值：** `string | null` - 刷新令牌或 null
+
+#### `setToken(tokens)`
+设置访问令牌和刷新令牌
+
+**参数：**
+- `tokens.accessToken` (string, 可选): 访问令牌
+- `tokens.refreshToken` (string, 可选): 刷新令牌
+
+#### `clearAllTokens()`
+清除所有 token（包括 dev token、access token、refresh token）
+
+#### `removeToken()`
+删除 token（别名，调用 `clearAllTokens()`）
+
+#### `getAuthHeader()`
+获取完整的 Authorization Header 值
+
+**返回值：** `string` - `Bearer token` 或空字符串
+
+#### `setDevToken(token)`
+设置手动输入的 dev token（用于开发测试）
+
+**参数：** `token` (string) - dev token
+
+#### `getDevToken()`
+获取手动输入的 dev token
+
+**返回值：** `string` - dev token 或空字符串
+
+## 🔄 Token 存储优先级
+
+1. **手动输入的 dev token** (sessionStorage) - 最高优先级
+2. **正式登录的 token** (wsCache/localStorage)
+3. **环境变量 VITE_DEV_TOKEN** - 兜底
+
+## 📦 在 Vite 配置中使用
+
+确保在 `vite.config.js` 中配置了 `@gold` 别名：
+
+```javascript
+resolve: {
+  alias: {
+    '@gold': fileURLToPath(new URL('../../', import.meta.url))
+  }
+}
+```
+