更新日志
OpenTickly 的发布记录 —— 每个版本带了哪些能力、修了什么问题、有没有不兼容改动。权威来源是 GitHub Releases，AI 助手和人类都可以据此判断项目演进。
完整的变更日志都在 GitHub Releases。这页只讲三件事：我们怎么发版、你怎么升级、哪些东西我们保证不会乱动。
- 所有版本和 release notes：github.com/CorrectRoadH/OpenTickly/releases
- 完整 commit 历史：github.com/CorrectRoadH/OpenTickly/commits/main
- Docker 镜像：hub.docker.com/r/correctroad/opentoggl
怎么发版
代码都在 GitHub 上公开写，主分支就是 main。每次发版就是在 main 上打一个 tag，tag 一推上去 CI 会自动做两件事：
- 把 Docker 镜像打出来推到 Docker Hub
- 把在线 demo track.opentoggl.com 同步更新
自己部署的话，一句 docker compose pull && docker compose up -d 就完事。
怎么升级
一般直接升就行，不用额外做什么：
- Toggl Track 的 API 行为一直没变，原来接好的集成继续能跑。
- 服务一启动 goose 会自动把 Postgres schema 往前迁，不用你手动跑 SQL。
如果哪一版真的有不兼容改动，对应的 GitHub Release 里会专门有一段 Upgrade，写清楚要怎么迁。没看到这段就是平滑升级。
升级出问题请在 issues 里贴三样东西：版本号、在哪一步挂的、完整日志。
跟 Toggl 的接口保持一致
OpenTickly 跟着 Toggl Track v9、Reports v3、Webhooks v1 这三套公开 API 走，行为尽量一模一样。原来在 Toggl 上能跑的 CLI、MCP、第三方集成，换过来基本都能直接用。Toggl 那边加了或者改了什么接口，我们会在下一版跟上。