⌛ 时间感知 (Time Awareness) Filter for Open WebUI

这是一个为 Open WebUI 设计的强大 Filter，旨在为您的每一次对话注入精确的时间上下文。它会自动为历史消息和当前发送的消息添加时间戳，让大语言模型能够准确理解对话发生的时间背景，从而提供更精准、更具上下文感知能力的回答。

✨ 主要功能

• 全自动时间注入：自动为对话中的所有用户消息添加时间戳。
• 零配置认证与时区：自动识别当前用户认证信息和时区，无需任何手动配置，真正实现多用户开箱即用。
• 智能格式化：
  • 在新的一天开始时，会自动显示完整的日期（[年-月-日, 星期, 时:分:秒]）。
  • 对于当天内的后续消息，则只显示简洁的时间（[时:分:秒]），增强可读性。
• 强大的兼容性：
  • 支持纯文本、图文混合、纯图片或纯文件等各类消息。
• 健壮的错误处理：在无法获取历史记录时会自动跳过注入，保证对话的正常进行。
• 实时开关：可以在 Open WebUI 界面上随时启用或禁用此 Filter。

⚙️ 配置方法

导入并启用 Filter （还需要点击“更多”，开启“全局”，这样才会显示在任何对话中）后，点击 管理员面板 > 函数 > 时间感知 右侧的齿轮图标，您会看到以下配置选项：

• api_base_url:

  • 描述: Open WebUI 后端的地址。
  • 默认值: http://127.0.0.1:8080

• date_format:

  • 描述: 日期显示格式。
  • 默认值: ISO
  • 可选值:
    • "ISO" (2025-06-13)
    • "DMY_SLASH" (13/06/2025)
    • "MDY_SLASH" (06/13/2025)
    • "DMY_DOT" (13.06.2025)

• debug_print_request:

  • 描述: 在 Open WebUI 后端日志中打印详细的调试信息，用于排查问题。
  • 默认值: False

⚠️ 注意事项

• 此 Filter 需要 httpx 库。如果您是手动部署 Open WebUI（非 Docker），请确保已安装：pip install httpx。Docker 用户无需担心，镜像已包含此库。
• 请确保 api_base_url 配置正确，以便 Filter 能够访问到 Open WebUI 的 API。

💬 反馈与贡献

如果您遇到任何问题或有改进建议，欢迎随时在 GitHub 上 提交 Issue。

📜 许可证

本项目采用 MIT 许可证。