v0.4.1

v0.4.1

Highlights (EN)

• Windows: disable the Unix-style “permissive permissions (0666)” config warning (it does not reflect NTFS ACLs and was often a false positive, especially under Task Scheduler).
• Docs: add Task Scheduler troubleshooting + optional icacls example for tightening config directory access.
• Maintenance: keep golang.org/x/sys as a direct dependency to avoid module resolution issues.

亮点 (中文)

• Windows：禁用类 Unix 的配置文件权限告警 “permissive permissions (0666)”（该值不代表 NTFS ACL，常为误报，尤其在任务计划程序下）。
• 文档：补充任务计划程序常见权限/找不到配置排查，并给出可选的 icacls 配置目录权限收紧示例。
• 维护：将 golang.org/x/sys 保持为直接依赖，避免模块解析/依赖问题。

v0.4.0

v0.4.0

Highlights (EN)

• Add clipal update: self-update from GitHub Releases with checksums.txt SHA256 verification; Windows uses a helper to replace an in-use .exe.
• Fix SSE “hang” scenarios: fail over to the next provider when an upstream produces no response body bytes for upstream_idle_timeout (default 3m).
• Improve shutdown robustness: avoid misleading “all providers failed” logs when the request context is already canceled; harden config watcher shutdown concurrency.

亮点 (中文)

• 新增 clipal update：从 GitHub Releases 自更新，并使用 checksums.txt 做 SHA256 校验；Windows 通过 helper 进程自动替换占用中的 .exe。
• 修复 SSE 卡死场景：上游在 upstream_idle_timeout（默认 3m）内没有任何 body 字节时自动切换到下一个 provider。
• 停机与并发健壮性增强：请求已取消时不再产生误导性的 “all providers failed” 日志；配置热重载 watcher 的 stop 逻辑更安全。

Notes

• clipal update 默认使用 lansespirit/Clipal 的 /releases/latest；预发布版本（如 v0.4.0-rc.1）不会成为 latest。
• Windows 更新可能需要确保没有其他进程仍在占用 clipal.exe（例如 service/task 正在运行）。

v0.3.0

What's New in v0.3.0

🔔 桌面系统通知（跨平台）

• 新增 notifications 配置：
  • enabled：开启/关闭通知
  • min_level：默认 error（更克制，避免刷屏）
  • provider_switch：provider 发生切换时提示
• 通知内容简约：
  • Provider 切换：<client>: <from> → <to> (reason status)
  • 日志通知：clipal ERROR / clipal WARN + 单行摘要

🛡️ 可靠性与安全性增强

• 去重与限流：30s 去重窗口 + 每分钟最多 6 条
• 长时间运行稳定：去重表定期清理，避免内存持续增长
• 防卡死：通知发送超时后进入冷却并自动恢复；退出时有超时兜底
• 脱敏：通知内容对常见 token/key（Bearer、sk-*、api_key、URL token 等）自动替换为 [redacted]

---

Full Changelog: v0.2.0...v0.3.0

v0.2.0

What's New in v0.2.0

🔒 安全与稳定性增强

• 配置解析加固 - 改进 YAML 配置文件解析的健壮性
• 请求限制优化 - 新增 max_request_body_bytes 配置项，可自定义请求体大小上限（默认 32 MiB）

📝 日志系统改进

• 滚动文件日志 - 支持按天自动滚动日志文件
• 日志保留策略 - 新增 log_retention_days 配置项控制日志保留天数
• 灵活输出控制 - 新增 log_stdout 配置项，后台运行时可关闭 stdout 输出

🧠 Claude Code 专项优化

• count_tokens 路由稳定性 - 新增 ignore_count_tokens_failover 选项
  • 开启后 /v1/messages/count_tokens 的失败不会触发 provider 切换
  • 保持主会话 provider 不变，有助于维护 context cache

📚 文档更新

• 新增各平台详细部署文档（macOS / Linux / Windows）
• 改进 README 快速开始指南

---

Full Changelog: v0.1.0...v0.2.0

v0.1.0

Full Changelog: https://github.com/lansespirit/Clipal/commits/v0.1.0