fidget.nvim 配置升级指南：从旧版迁移到 v1.4

配置迁移概述

fidget.nvim 从旧版升级到 v1.4 版本后，配置结构发生了显著变化。这些变化主要是为了支持更细粒度的配置选项和扩展插件的功能范围，使其不仅限于 LSP 进度通知，还能作为 vim.notify 的后端等更多用途。

新旧配置项对照

文本显示相关配置

• 旧版 text.spinner 对应新版 progress.display.progress_icon，可以使用内置的动画模式如 "dots_negative"
• text.done 迁移为 progress.display.done_icon
• text.commenced 和 text.completed 合并为 progress.display.format_message

定时器相关配置

• timer.spinner_rate 改为 notification.poll_rate，控制渲染频率
• timer.fidget_decay 替换为 notification.configs 中的 ttl 参数
• timer.task_decay 对应 progress.display.done_ttl

窗口显示配置

• window.relative 保持相同路径 notification.window.relative
• window.blend 改为 notification.window.winblend
• window.border 路径变为 notification.window.border

调试配置

• debug.logging 改为 logger.level，可设置为 INFO 或 DEBUG
• debug.strict 选项已被弃用

最佳实践建议

1. 加载时机：不再建议仅在 LSP 附加时加载插件，因为现在它承担了更多功能。如果确实需要优化启动时间，可以考虑使用 "VeryLazy" 事件。

2. 错误处理：直接使用 require 而不需要 pcall 包装，因为依赖项应该是确定存在的。如果确实缺失，应该让错误直接抛出以便及时发现配置问题。

3. 动画自定义：虽然当前版本对自定义动画的支持接口不够友好，但开发者正在改进这一功能。建议暂时使用内置的动画模式。

配置示例

以下是一个符合 v1.4 版本的配置示例：

local fidget = require("fidget")
local icons = require("your_icons_module")

fidget.setup({
  progress = {
    display = {
      progress_icon = { pattern = "dots_negative" },
      done_icon = icons.ui.Check,
      format_message = function(msg)
        return string.format("%s %s", icons.ui.CircleSmall, msg)
      end,
      done_ttl = 3000,
    }
  },
  notification = {
    window = {
      relative = "editor",
      winblend = 0,
      border = "rounded",
    },
    poll_rate = 200,
    configs = {
      default = {
        ttl = 3000,
      }
    }
  },
  logger = {
    level = "INFO",
  }
})

升级注意事项

1. 新版配置更加模块化，将不同功能区的配置分离，提高了灵活性但增加了配置复杂度。

2. 动画系统的配置方式有所改变，开发者正在重构这一部分，后续版本可能会有进一步改进。

3. 错误处理策略应该调整，直接暴露问题比静默失败更有利于维护稳定的配置。

通过以上调整，用户可以充分利用 fidget.nvim v1.4 的新特性，同时保持原有的功能体验。虽然迁移过程需要投入时间，但新版本提供的扩展性和灵活性将为后续使用带来更多可能性。