admin/xyzw_web_helper

Fork 0

Files

kirin 90094ccd5a 1.0

2025-10-17 20:56:50 +08:00

11 KiB

Raw Blame History

v2.1.1 完整更新总结

📅 更新完成时间

2025-10-12 18:00

🎯 更新目标

将开源项目 v2.1.1 的核心功能集成到本地项目中，包括：

✅ Logger 日志系统
✅ 月度任务系统（钓鱼+竞技场补齐）
✅ 身份卡系统（10阶段位）
✅ 俱乐部信息系统（含盐场战绩）

📁 文件清单

新增文件（8个）

src/utils/logger.js - 日志系统核心
src/utils/clubBattleUtils.js - 俱乐部战斗工具函数
src/components/IdentityCard.vue - 身份卡组件
src/components/ClubInfo.vue - 俱乐部信息组件
src/components/ClubBattleRecords.vue - 俱乐部盐场战绩组件
MD说明文件夹/月度任务系统集成记录.md - 月度任务修复记录
MD说明文件夹/v2.1.1完整更新总结.md - 本文档

修改文件（6个）

src/stores/tokenStore.js - 集成 logger 系统
src/stores/batchTaskStore.js - 添加月度任务日志开关
src/components/BatchTaskPanel.vue - 添加月度任务日志控制 UI
src/components/GameStatus.vue - 集成所有新功能
src/utils/gameCommands.js - 添加新命令定义
src/utils/xyzwWebSocket.js - 注册新命令及响应映射

✨ 功能详解

【阶段1】Logger 日志系统

核心文件：src/utils/logger.js

功能：

5个日志级别：ERROR, WARN, INFO, DEBUG, VERBOSE
动态级别控制：logger.setLevel('DEBUG')
分类日志管理：logger.createLogger('WebSocket')
浏览器控制台全局调试工具

集成点：

tokenStore.js：WebSocket 日志使用 tokenLogger
未来可扩展到所有模块的结构化日志

【阶段2】月度任务系统

核心文件：src/components/GameStatus.vue (月度任务卡片)

功能：

刷新进度：
- 显示钓鱼 320 次、竞技场 240 次进度
- 计算完成百分比和差额
- 自动计算剩余天数
钓鱼补齐：
- 优先使用普通鱼竿（免费）
- 普通鱼竿不足时使用金鱼竿
- 支持下拉菜单选择补齐次数
竞技场补齐：
- 检查体力（每次5点）
- 自动匹配对手 → 战斗
- 贪心策略尽可能多完成
一键完成：
- 同时补齐钓鱼和竞技场
- 自动刷新进度

新增命令（6个）：

activity_get - 获取月度活动信息
fishing_fish - 钓鱼
arena_matchopponent - 匹配对手
arena_battle - 竞技场战斗
monthlyactivity_receivereward - 领取月度奖励
对应的 5 个 *resp 响应映射

日志控制：

批量自动化面板新增 "月度任务日志" 开关
batchTaskStore.logConfig.monthlyTask

重要修复（详见 月度任务系统集成记录.md）：

✅ 命令注册缺失
✅ 响应映射缺失（activity_getresp 等）
✅ WebSocket 连接时序问题
✅ Store 属性访问错误

【阶段3】身份卡系统

核心文件：src/components/IdentityCard.vue

功能：

10阶段位系统（基于战力）：
- 🌱 初出茅庐 (0-100万)
- ⚔️ 小有名气 (100万-1千万)
- 🗡️ 出入江湖 (1千万-1亿)
- 🏹 纵横四方 (1亿-5亿)
- ⚡ 盖世豪杰 (5亿-20亿)
- 👑 一方枭雄 (20亿-40亿)
- 🔱 睥睨江湖 (40亿-60亿)
- ⚜️ 独霸天下 (60亿-90亿)
- 💎 不世之尊 (90亿-150亿)
- 🌟 无极至尊 (150亿+)
资源展示（9种资源）：
- 金币、金砖
- 普通鱼竿、金鱼竿
- 珍珠、招募令、精铁、彩玉、进阶石
智能解析：
- 支持数组、对象、多层级数据结构
- 自动回退到旧字段（fishing.normalRod 等）
UI特性：
- 嵌入式模式（GameStatus 顶部）
- 弹窗式模式（未来扩展）
- 段位渐变背景 + 炫光动画
- 头像容错机制（5个默认头像）

集成点：

GameStatus.vue 第一个组件，使用 <IdentityCard embedded />

【阶段4】俱乐部信息系统

核心文件：

src/components/ClubInfo.vue - 俱乐部主组件
src/components/ClubBattleRecords.vue - 盐场战绩子组件
src/utils/clubBattleUtils.js - 工具函数

功能：

俱乐部概览（Tab 1）：
- 俱乐部名称、头像、ID、等级、服务器
- 总战力、段位、成员数、红洗次数
- 会长信息
- 公告内容
成员列表（Tab 2）：
- 显示前 20 名成员（按战力排序）
- 显示头像、姓名、战力、职位（会长/副会长/成员）
盐场战绩（Tab 3）：
- 自动计算最近周六日期
- 显示所有成员的击杀、死亡、攻城数据
- 展开查看详细战斗记录（进攻/防守、胜利/失败）
- 导出战绩到剪贴板

新增命令（1个）：

legionwar_getdetails - 获取军团战详情
legionwar_getdetailsresp - 响应映射

工具函数（6个）：

getLastSaturday() - 计算最近周六
formatTimestamp() - 时间格式化
parseBattleResult() - 解析胜负
parseAttackType() - 解析进攻/防守
formatBattleRecordsForExport() - 导出格式化
copyToClipboard() - 剪贴板复制

集成点：

GameStatus.vue 中作为独立卡片，位于 CarManagement 后

🔧 技术要点

1. WebSocket 命令注册流程

// 1. gameCommands.js 定义命令结构
activity_get(ack = 0, seq = 0, params = {}) {
  return {
    ack,
    body: this.g_utils.bon.encode({ ...params }),
    cmd: "activity_get",
    seq,
    rtt: randomInt(0, 500),
    code: 0,
    time: Date.now()
  }
}

// 2. xyzwWebSocket.js 注册命令
.register("activity_get", {})

// 3. 添加响应映射（如果响应命令名不同）
responseToCommandMap = {
  'activity_getresp': 'activity_get',
  // ...
}

2. 响应映射的重要性

问题：服务器返回 activity_getresp，但 Promise 等待 activity_get，导致超时。

解决：在 responseToCommandMap 中建立映射关系。

3. WebSocket 连接时序控制

// GameStatus.vue 中的轮询检测机制
let monthTaskFetched = false
const checkAndFetchMonthly = () => {
  const status = tokenStore.getWebSocketStatus(tokenId)
  if (status === 'connected' && !monthTaskFetched) {
    monthTaskFetched = true
    setTimeout(() => fetchMonthlyActivity(), 1000)
  }
}
// 立即检查 + 定时轮询（最多5次）
checkAndFetchMonthly()
const checkInterval = setInterval(() => {
  if (checkCount++ >= 5) clearInterval(checkInterval)
  else if (status === 'connected' && !monthTaskFetched) {
    clearInterval(checkInterval)
    checkAndFetchMonthly()
  }
}, 1000)

4. 物品解析的通用策略

const getItemCount = (items, id) => {
  if (!items) return null
  // 支持数组结构：[{id/itemId, num/count/quantity}]
  if (Array.isArray(items)) { /* ... */ }
  // 支持对象结构：{ '1011': 3 } 或 { '1011': { num:3 } }
  // 支持嵌套结构：{ 'X': { itemId: 2001, quantity: 100 } }
}

📊 命令对比表

命令名称	功能	开源有	本地已有	本次新增
`activity_get`	获取月度活动	✅	❌	✅
`fishing_fish`	钓鱼	✅	❌	✅
`arena_matchopponent`	竞技场匹配	✅	❌	✅
`arena_battle`	竞技场战斗	✅	❌	✅
`monthlyactivity_receivereward`	月度领奖	✅	❌	✅
`legionwar_getdetails`	军团战详情	✅	❌	✅
`legion_getinfo`	军团信息	✅	✅	-

🎨 UI 集成位置

GameStatus.vue 组件结构

├── IdentityCard (embedded) ← 新增【阶段3】
├── TeamStatus
├── DailyTaskStatus
├── TowerStatus
├── CarManagement
├── ClubInfo ← 新增【阶段4】
├── 盐罐机器人
├── 月度任务 ← 新增【阶段2】
└── 学习答题

🐛 已知问题与解决

问题1：月度任务命令超时

现象：发送 activity_get 后 10 秒超时原因：

命令未注册到 xyzwWebSocket.js
响应映射缺失

解决：

// xyzwWebSocket.js
.register("activity_get", {})

// responseToCommandMap
'activity_getresp': 'activity_get'

问题2：自动刷新失败

现象：页面加载时自动刷新月度任务失败，手动点击成功原因：1秒延迟不足，WebSocket 可能未完全连接

解决：改用轮询检测 connected 状态

问题3：Store 属性访问错误

现象：Cannot read properties of undefined (reading 'token_xxx') 原因：错误使用 tokenStore.connections 而非 tokenStore.wsConnections

解决：统一使用 tokenStore.wsConnections[tokenId]

💡 使用建议

1. 月度任务最佳实践

每天登录后点击"刷新进度"查看当前进度
使用"钓鱼补齐"和"竞技场补齐"单独补齐
或直接点击"一键完成"自动完成所有
补齐时注意资源消耗（鱼竿、体力）

2. 身份卡段位提升

定期查看战力排名，了解自己的段位
通过升级、升星、洗练等方式提升战力
目标：冲击更高段位（💎 不世之尊、🌟 无极至尊）

3. 俱乐部战绩统计

每周六日盐场战后查看战绩
导出战绩分享到群聊
分析击杀/死亡/攻城数据，优化战术

🔮 后续扩展方向

优先级 P0（强烈建议）

月度任务补齐后自动刷新进度
竞技场补齐前检查体力并提示
俱乐部战绩排序（击杀、死亡、攻城）

优先级 P1（推荐）

身份卡弹窗模式（点击右上角下落动画）
月度任务进度实时更新（不需要手动刷新）
俱乐部成员在线状态

优先级 P2（可选）

Logger 日志导出到文件
月度任务历史记录（每日完成情况）
俱乐部战绩图表可视化

📝 兼容性说明

与现有功能兼容性

✅ 不影响现有批量任务系统
✅ 不影响定时任务系统
✅ 不影响现有游戏功能（盐罐、学习答题等）
✅ 所有新增日志默认关闭，需手动开启

数据结构兼容性

✅ 身份卡支持多种数据格式（数组、对象、嵌套）
✅ 俱乐部信息兼容不同服务端字段名
✅ 月度任务支持旧版数据回退

🎉 总结

本次更新成功将开源 v2.1.1 的 4大核心功能 完整集成到本地项目，新增 7个文件、修改 6个文件、添加 7个新命令，同时修复了 4个关键问题。

所有功能已通过测试，无 Linter 错误，可直接使用。

更新完成时间：2025-10-12 18:00
参与开发：Claude Sonnet 4.5
用户确认：待测试验证

🚀 现在可以刷新页面体验全新功能！

11 KiB Raw Blame History Unescape Escape

v2.1.1 完整更新总结

📅 更新完成时间

🎯 更新目标

📁 文件清单

新增文件（8个）

修改文件（6个）

✨ 功能详解

【阶段1】Logger 日志系统

【阶段2】月度任务系统

【阶段3】身份卡系统

【阶段4】俱乐部信息系统

🔧 技术要点

1. WebSocket 命令注册流程

2. 响应映射的重要性

3. WebSocket 连接时序控制

4. 物品解析的通用策略

📊 命令对比表

🎨 UI 集成位置

GameStatus.vue 组件结构

🐛 已知问题与解决

问题1：月度任务命令超时

问题2：自动刷新失败

问题3：Store 属性访问错误

💡 使用建议

1. 月度任务最佳实践

2. 身份卡段位提升

3. 俱乐部战绩统计

🔮 后续扩展方向

优先级 P0（强烈建议）

优先级 P1（推荐）

优先级 P2（可选）

📝 兼容性说明

与现有功能兼容性

数据结构兼容性

🎉 总结

11 KiB

Raw Blame History