Skip to content

Latest commit

 

History

History
319 lines (264 loc) · 14 KB

CHANGELOG.md

File metadata and controls

319 lines (264 loc) · 14 KB

更新日志 AAA石山代码批发

本文档记录本项目的所有重要变更。

格式基于 Keep a Changelog， 版本号遵循扩展的语义化版本规范（x.y.z 格式）。

[2.1.0] - 2026-03-14

feat

  • 新增成就列表
    • 新增命令 :成就列表，支持成就分类分组与等级展示
    • 新增成就列表渲染模板（resources/achieve/*）
  • 便签扩展显示
    • 便签新增成就数量、通行证等级与徽章展示（按 display 优先）
  • 地区建设展示增强
    • 地图探索统计新增装备制造模板、维修灵感点
    • 地区总调度券与聚落调度券进度条展示
    • 统计图标改为专用图标资源

changed

  • 便签不再调用体力接口
    • 移除理智/活跃度展示与相关请求
  • 地区建设/帝江号接口适配
    • 适配 /api/endfield/domain 新结构（collections/levels 计数兼容、charNameMap/officerAvatarMap）
    • 适配 /api/endfield/spaceship 新结构（rooms、roomName、avatarUrl、lastReportTs）
  • 体力展示补充
    • 理智卡片新增每周事务（weeklyMission）显示

docs

  • 帮助菜单更新
    • 新增 :成就列表 说明

[2.0.9] - 2026-03-12

changed

  • 签到逻辑与缓存匹配调整
    • 签到缓存统一使用 平台ID:role:{roleId} 标识
    • :签到 按缓存命中优先返回； :强制签到 仅在 force=true 时生效
    • 签到代码结构整理，减少重复逻辑
    • :全部签到 增加 Redis 可用性检查
  • 登录后干员列表适配
    • 登录后自动发送干员列表优先使用 game_role_id
    • 新建绑定时补充 game_role_id 透传
  • 本地卡池数据补全
    • game_banners.yaml 增加常驻武器池读取（不包含常驻角色）
  • Wiki 干员解析优化
    • 干员详情按 能力扩延 / 战斗技能 / 天赋阵列 / 干员潜能 分段输出
    • 表格内容改为行文本输出，支持多等级与材料消耗解析
  • 全服抽卡统计独立与样式重构
    • 全服统计独立为 gachaGlobal 模块，数据渲染结构调整
    • 统计卡片结构重排（全服概览 / 干员&武器 / 分池统计）
    • 过滤 unknown 区域分组，排名空项不再显示
  • 全服统计卡池信息适配
    • 当前池/UP 信息支持 gacha.banner_info.source 读取（backend_api / local_file）
    • 本地 game_banners.yaml 补全分期 UP 名称
    • 当前池统计拆分为「限定池统计 / 武器池统计」

[2.0.8] - 2026-03-11

changed

  • 干员面板与列表链路优化
    • 面板同步列表优先使用 panel/chars 返回的 game_role_id 对齐 friend/detail
    • 干员名称合并统一以 card/detail 中文名为准，提升匹配稳定性
  • 绑定信息与存储整理
    • 绑定信息新增 game_role_id 透传与存储
    • 移除 data/operator.yaml 本地干员映射依赖
  • 清理旧兼容与冗余逻辑
    • 移除旧格式 notify_list 兼容转换
    • 移除旧版抽卡角色选择逻辑与多余等待键
    • 移除 endfield_binding 旧链路回退

fix

  • 干员列表合并显示异常
    • 修复展柜角色绿色高亮匹配不稳定的问题

docs

  • Guoba 配置文案补全
    • guoba/message/* 补全各模块提示文案配置项

[2.0.7] - 2026-03-08

feat

  • 签到当日缓存与状态查询
    • 新增 ENDFIELD:ATTENDANCE_SIGNED:YYYY-MM-DD 当日签到缓存，命中后跳过重复签到请求
    • 签到缓存按日自动过期（次日刷新）
    • 新增管理员命令 :签到缓存状态，可查看今日缓存账号数、TTL 与缓存键
  • Redis 定向清理增强
    • 新增管理员命令 :redis清理账号，支持批量提取 QQ 并清理 ENDFIELD:USER:<QQ>
    • 支持多行 QQ(昵称) 文本输入，自动去重并输出清理结果

changed

  • 签到任务统计口径优化
    • 报告新增“总计用户 / 总计账号”分离展示
    • “总计账号”改为按绑定账号数统计，不再等同于用户数
    • 报告细化为“执行前已签 / 缓存命中 / 实际请求 / 本次新签 / 执行后已签”

fix

  • 干员面板同步异常提示修复
    • 修复 panel_sync_status=failed 时可能出现“请求失败 成功”的错误文案
    • 面板同步失败或超时时自动降级为实时数据渲染，避免 :更新面板 直接失败
  • Redis 清理白名单更新
    • 增加 ENDFIELD:ATTENDANCE_SIGNED: 前缀，避免签到缓存被误删

docs

  • 帮助菜单更新
    • 新增管理员命令 :签到缓存状态、:redis清理、:redis清理账号

[2.0.6] - 2026-03-07

feat

  • 抽卡卡池信息来源可配置
    • 新增 gacha.banner_info.source 配置，支持 backend_api / local_file
    • 新增本地卡池数据文件支持（data/game_banners.yaml）用于 UP 信息解析
  • 锅巴新增抽卡配置项
    • 新增「卡池信息数据源」可视化配置，并完善默认值与兜底校验

changed

  • 抽卡多角色参数链路对齐
    • refreshLocalGachaCacheFromCloud 支持按 role_id + server_id 刷新缓存
    • 抽卡统计/记录/同步状态请求统一支持 role_id + server_id 参数透传
  • 抽卡代码结构整理
    • 新增 note 数据安全获取与头像解析公共方法，减少重复逻辑
    • 全服统计流程提炼公共辅助方法（期数匹配、时间格式化、排名/分布构建）
    • 清理部分冗余判断与重复构建逻辑
  • 绑定列表样式微调
    • bind-list 宽度从 520px 调整至 560px
    • 绑定信息项改为不换行，优化 bilibili服 展示

fix

  • 签到汇总在群聊内隐藏失败账号明细
    • 手动在群内触发 :全部签到 时，仅展示统计结果，不再附带失败账号列表
  • 公告长图清晰度修复
    • 调整公告列表/详情页模板与样式，修复长图片展示模糊问题

docs

  • 接口文档更新
    • 同步更新 API.md 与 MaaEnd-API.md 抽卡相关接口说明与参数描述

[2.0.5] - 2026-03-03

feat

  • 抽卡本地缓存
    • 新增 plugins/endfield-plugin/data/gacha 本地缓存目录
    • 同步完成后自动拉取并落盘抽卡记录与统计数据
    • :抽卡记录、:抽卡分析 优先读取本地缓存，降低频繁云端请求
  • redisClean
    • 增加 ENDFIELD:ANNOUNCEMENT_LAST_SEEN

changed

  • 干员面板同步流程重构
    • :更新面板 接入角色面板同步 API：/api/panel/sync、/api/panel/sync/status、/api/panel/chars
    • 命令流程调整为：触发同步 -> 轮询状态 -> 拉取同步角色列表 -> 合并到干员列表渲染
    • 同步角色优先展示：展柜同步角色按返回顺序置顶，其余干员保留原列表展示
  • 命令合并
    • 将原 :干员列表 更新入口合并为 :更新面板，统一通过同步后列表返回
  • 抽卡命令与同步流程调整
    • :抽卡记录 命令支持 :同步抽卡记录 与 :更新抽卡记录 触发同步
    • :抽卡记录、:抽卡分析 在无记录时改为自动发起同步
    • 抽卡同步请求参数调整为 account_uid + server_id，与最新 API 文档保持一致
  • 授权绑定列表展示优化
    • 授权账号列表改为基于 /api/v1/authorization/clients/:client_id/users/:platform_id 全量展开
    • 修复同一 framework_token 下多角色仅显示一条的问题
    • 授权账号等级展示以授权接口返回为准，避免被 note 数据覆盖
  • 公告推送去重
    • 新增公告“已处理签名”缓存，非新公告不渲染不发送
    • 推送失败为 Unknown Channel 时自动移除失效群订阅，避免重复报错
  • 多角色防串号参数对齐
    • note、stamina、spaceship、card/detail、card/char 相关调用统一显式透传 roleId + serverId
    • 覆盖 area、note、operator、gacha、stamina、enduid 等模块，减少默认角色回退导致的数据串号
  • 帝江号建设展示调整
    • 派驻干员卡片新增信赖等级标签（trustLevelName）
    • 数值展示改为 心情(moodPercent) 与 信赖(trustPercent)
    • 移除卡片中的“体力原始值 / 好感原始值”显示，界面信息更聚焦
  • 理智卡片干员图来源调整
    • stamina 背景干员图改为从 card/detail 的 illustrationUrl 随机选取
    • 不再使用 note.chars 的头像字段作为理智卡干员图

fix

  • 授权登录输出优化
    • 移除 :授权登陆 过程中“授权状态接口响应(JSON)”聊天回显
    • 移除授权状态完整 JSON 日志输出，避免冗余与敏感信息泄露风险
  • 抽卡缓存与同步稳定性
    • 修复同步后偶发空记录写入缓存的问题，增加完成后短重试机制
    • 修复同步链路变量引用问题，确保缓存写入角色 ID 正确
  • 仓库忽略规则
    • 更新 .gitignore，忽略 data/**/*.json 本地缓存文件，保留 .gitkeep
  • 绑定列表授权账号头像
    • :绑定列表 中授权账号不再跳过 note 拉取，按各自 roleId/serverId 获取头像
    • 修复授权多角色场景下仅部分账号显示头像的问题

docs

  • 文案更新
    • gacha.no_records 改为：暂无抽卡记录，已自动开始同步记录，请稍后...
  • 帮助菜单更新
    • help.yaml 中干员查询入口由 :干员列表 调整为 :更新面板
    • 补充抽卡同步别名展示：:同步抽卡记录 / :更新抽卡记录

[2.0.4] - 2026-03-02

fix

  • 优化修复授权绑定
    • 新增按平台用户查询客户端授权的API，优化授权状态检查逻辑
    • 修复误判导致的用户授权失效的情况

[2.0.3] - 2026-03-02

Refactor

  • 消息国际化重构
    • 全面使用 getMessage 函数替代硬编码字符串，提升可维护性
    • 新增 redis_clean、gacha_simulate、maaend_device 等消息配置项
    • 在 defSet/message.yaml 中统一管理所有提示文案
    • 同步更新 guoba/message.js 配置界面支持

Changed

  • 抽卡同步体验优化

    • 优化同步提示时机：仅在确定需要同步时才显示提示信息
    • 区分首次同步与增量同步的提示文案
    • 修复多账号场景下重复提示的问题
    • 新增 fromSync、isFirstSync 参数传递同步上下文
    • 移除抽卡分析中最近6星干员数量限制，完整展示所有6星记录

  • MaaEnd 设备管理优化

    • 设备状态查询和设置提示使用模板化消息
    • 优化默认设备设置成功后的使用说明展示

  • Redis 清理功能

    • 所有错误和状态提示统一使用 getMessage 函数
    • 支持通过配置文件自定义提示文案

  • 模拟抽卡

    • 重置成功提示使用配置化消息

Fixed

  • 代码规范
    • 修复 .gitignore 文件末尾缺少换行符的问题
    • 移除 .gitignore 中对 API文档.md 和 MaaEnd-API.md 的忽略规则

[2.0.2] - 2026-03-01

Fixed

  • 授权绑定参数修正
    • client_id 改为机器人自身 QQ 号（self_id），不再使用绑定者 QQ
    • 新增 platform_id 字段，传入绑定者 QQ 号，符合 API 文档规范
    • 授权轮询检查同步修正：使用机器人 ID 作为 clientId，用户 QQ 作为 userIdentifier

[2.0.1] - 2026-02-27

Changed

  • 抽卡命令优化

    • 调整同步命令为 :同步抽卡记录（原 :抽卡分析同步）
    • :抽卡记录 和 :抽卡分析 在无数据时自动执行同步
    • 改进用户体验，减少手动同步操作步骤

  • 签到任务增强

    • 新增失败账号自动重试机制（首次失败后自动重试一次）
    • 优化签到报告格式，采用更清晰的表格式展示
    • 重试间隔 3 秒，避免频繁请求
    • 记录失败原因便于排查问题

Fixed

  • 代码修复

    • 修复 gacha.js 中变量 statsData 重复声明导致的加载错误

  • 抽卡记录查询优化

    • 优化变量命名避免冲突（checkStatsData 用于检查数据，recordStatsData 用于记录统计）

  • 抽卡分析核心逻辑修复

    • 修复免费十连计入保底的问题（免费抽不再计入垫抽数）
    • 修复限定池跨期保底继承逻辑（小保底80抽、大保底120抽跨所有期数共享）
    • 修复大保底判断：付费累计≥120抽且未在120前获得UP时才触发Spark
    • 修复出UP后大保底计数重置逻辑

  • 抽卡分析展示优化

    • 限定池展示顺序按活动时间升序（熔火灼痕 → 轻飘飘的信使 → 热烈色彩）
    • 武器池排序：最新池在上，星声申领固定在最后
    • 常驻寻访内部排序：基础寻访在上、启程寻访在下
    • 限定池里程碑：60抽情报手册、120抽UP大保底、240抽代币
    • 5星保底显示：10抽内必出5星

  • 武器池分析增强

    • 新增武器池申领次数（十连）统计
    • 新增累计奖励节点提示（第10次武库箱、第18次UP武器）
    • 武器池每红花费按十连数计算
    • 武器池垫抽进度条按40抽（4次十连）为满

  • 数据准确性提升

    • 每红花费仅计付费抽数（排除免费十连）
    • 平均UP花费排除Spark记录
    • 不歪率仅在当期活跃池显示
    • 支持历史池子UP映射（从bili-wiki获取）

[1.0.0 ~ 2.0.0] - 2026-02-27之前

基础功能...

更新 CHANGELOG 的步骤

  1. 在文件顶部添加新版本条目：## [新版本号] - 发布日期或"未发布"
  2. 将当前版本内容移到新版本下
  3. 同步更新 package.json 中的 version 字段

更新类型说明

遵循 Conventional Commits 规范：

  • feat: 新功能（feature）
  • fix: 问题修复（bug fix）
  • docs: 文档更新（documentation）
  • style: 代码格式、样式调整（不影响代码运行的变动）
  • refactor: 代码重构（既不是新功能也不是 bug 修复）
  • perf: 性能优化（performance）
  • test: 测试相关（tests）
  • chore: 构建过程或辅助工具的变动
  • build: 构建系统或外部依赖的变更
  • ci: CI 配置文件和脚本的变更
  • revert: 回滚之前的 commit