1.0

xyzw_web_helper-main开源源码更新/LOCAL_TOKEN_CHANGES.md

@@ -0,0 +1,155 @@
+# 本地Token存储重构说明
+
+本次重构完全移除了所有API接口请求，改为使用本地存储管理用户认证和游戏角色token。
+
+## 主要变更
+
+### 1. 新增文件
+
+#### `/src/stores/localTokenManager.js`
+- 完整的本地token管理系统
+- 支持用户认证token和游戏角色token管理
+- 内置WebSocket连接管理
+- 支持token导入/导出、过期清理等功能
+
+#### `/src/components/TokenManager.vue`
+- Token管理界面组件
+- 可视化显示所有token状态
+- 支持WebSocket连接控制
+- 提供批量操作功能
+
+### 2. 修改的文件
+
+#### `/src/stores/auth.js`
+- **移除**: 所有`api.auth.*`调用
+- **新增**: 本地认证逻辑，模拟用户登录
+- **集成**: localTokenStore进行token管理
+
+#### `/src/stores/gameRoles.js`
+- **移除**: 所有`api.gameRoles.*`调用
+- **新增**: 本地角色管理，自动生成游戏token
+- **集成**: 角色选择时自动建立WebSocket连接
+
+#### `/src/views/DailyTasks.vue`
+- **移除**: `api.dailyTasks.*`调用
+- **新增**: 本地模拟任务数据生成
+- **集成**: 通过WebSocket执行任务（模拟）
+
+#### `/src/views/Profile.vue`
+- **新增**: TokenManager组件，提供token管理界面
+
+## 核心功能
+
+### 用户认证
+```javascript
+// 本地认证，无需API调用
+const result = await authStore.login({ username, password })
+```
+
+### 游戏角色管理
+```javascript
+// 添加角色时自动生成游戏token
+const result = await gameRolesStore.addGameRole(roleData)
+// 自动生成: roleId, gameToken, wsUrl
+```
+
+### WebSocket连接
+```javascript
+// 选择角色时自动建立WebSocket连接
+gameRolesStore.selectRole(role)
+// 使用本地存储的token建立连接
+
+// 手动控制连接
+localTokenStore.createWebSocketConnection(roleId, token, wsUrl)
+localTokenStore.closeWebSocketConnection(roleId)
+```
+
+### Token管理
+```javascript
+// 添加游戏token
+localTokenStore.addGameToken(roleId, tokenData)
+
+// 获取token
+const tokenData = localTokenStore.getGameToken(roleId)
+
+// 导出所有token
+const backup = localTokenStore.exportTokens()
+
+// 导入token
+localTokenStore.importTokens(backupData)
+```
+
+## 数据结构
+
+### 游戏Token数据结构
+```javascript
+{
+  token: "game_token_xxx",      // 游戏token
+  roleId: "role_xxx",           // 角色ID
+  roleName: "角色名称",          // 角色名称
+  server: "服务器名",            // 服务器
+  wsUrl: "wss://game.xxx/ws",   // WebSocket URL
+  createdAt: "2024-01-01T00:00:00Z",
+  lastUsed: "2024-01-01T00:00:00Z",
+  isActive: true
+}
+```
+
+### WebSocket连接状态
+```javascript
+{
+  connection: WebSocket,        // WebSocket连接对象
+  status: "connected",          // 连接状态
+  roleId: "role_xxx",          // 关联角色ID
+  connectedAt: "2024-01-01T00:00:00Z"
+}
+```
+
+## 使用说明
+
+### 1. 登录
+- 用户名/密码任意输入即可本地认证
+- 自动生成用户token并保存
+
+### 2. 添加游戏角色
+- 填写角色信息后自动生成：
+  - 角色ID
+  - 游戏token
+  - WebSocket连接URL
+
+### 3. 管理Token
+- 访问"个人设置"页面查看Token管理器
+- 可以查看、编辑、删除、导出/导入token
+- 可以手动控制WebSocket连接
+
+### 4. 执行任务
+- 选择角色后自动建立WebSocket连接
+- 执行任务通过WebSocket发送指令（模拟）
+- 所有操作记录保存在本地
+
+## 优势
+
+1. **完全离线**: 无需任何服务器接口
+2. **数据安全**: 所有数据存储在本地
+3. **功能完整**: 保留原有所有功能
+4. **易于扩展**: 模块化设计，便于添加新功能
+5. **WebSocket支持**: 内置完整的WebSocket连接管理
+
+## 注意事项
+
+1. Token与配置已持久化到浏览器 IndexedDB（库：原生 API，自实现封装）
+2. 首次初始化会自动从 localStorage 迁移到 IndexedDB（若 DB 为空）
+3. 清除站点数据会同时清除 IndexedDB，建议定期导出备份
+4. WebSocket连接使用模拟URL，需要根据实际情况修改
+
+## 持久化实现说明（IndexedDB）
+
+- 存储结构：
+  - `kv` 表：保存 `userToken`
+  - `gameTokens` 表：按 `roleId` 分条存储 token 记录
+- 读写方式：
+  - Store 内存态与 UI 同步，写操作异步持久化到 DB（不阻塞界面）
+  - `initTokenManager()` 异步加载 DB 数据并填充内存态
+- 兼容迁移：
+  - 若 DB 为空且 localStorage 有旧数据，则一次性迁移至 DB
+  - 迁移后仍保留 localStorage 数据以避免意外数据丢失（可后续手动清理）