feat: bump version and add changelog.en

Signed-off-by: d0zingcat <iamtangli42@gmail.com>
2026-05-13 15:09:19 +00:00 · 2026-01-17 15:48:47 +08:00
parent d465b7388a
commit a89d61b27d
7 changed files with 281 additions and 123 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,162 +1,144 @@
-# 更新日志
+# Changelog

-本项目的所有显著变更都将记录在此文件中。
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), 
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+**CHANGELOG** | [简体中文](./CHANGELOG.zh-CN.md)
+
+## [1.3.3] - 2026-01-17
+
+### Added
+- **Multi-replica Deployment Support**: Enhanced stability for load-balanced/multi-instance environments.
+    - **Database Locking**: Introduced **Postgres Advisory Locks** in `db:migrate:deploy` script to prevent race conditions during concurrent database migrations.
+    - **Idempotency Hardening**: Verified and ensured Feishu event handling logic is idempotent, supporting safe receipt of duplicate events in multi-replica setups.

-本文件的格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
-并且本项目遵循 [语义化版本 (Semantic Versioning)](https://semver.org/lang/zh-CN/spec/v2.0.0.html)。
- 
 ## [1.3.2] - 2026-01-17

-### 新增
- **群聊搜索功能**: 在绑定群聊时新增了实时搜索功能，解决了群聊过多时难以查找的问题。
-    - **后端支持**: `GET /groups` 接口现在支持 `q` 查询参数进行模糊搜索，并提高了默认返回数量。
-    - **搜索前端**: 引入了带防抖逻辑的搜索输入框和自定义下拉列表，提升了用户体验。
+### Added
+- **Group Chat Search**: Added real-time search functionality when binding group chats, solving the difficulty of finding specific groups when many are present.
+    - **Backend Support**: `GET /groups` now supports `q` query parameter for fuzzy search and increased default return limit.
+    - **Search Frontend**: Introduced a search input with debounce logic and a custom dropdown list for better UX.

-### 变更
- **UI 优化**: 改进了 `GroupBindingsModal` 的视觉设计，使用了更现代的列表样式、状态图标和加载动画。
- **文档优化**: 将 `README.md` 拆分为英文版 (`README.md`) 和中文版 (`README.zh-CN.md`)，以更好地支持国际化。
+### Changed
+- **UI Optimization**: Improved `GroupBindingsModal` visual design with a modern list style, status icons, and loading animations.
+- **Documentation**: Split `README.md` into English (`README.md`) and Chinese (`README.zh-CN.md`) for better internationalization support.

 ## [1.3.1] - 2026-01-16

-### 新增
- **群聊绑定管理**: 增强了 Topic 与飞书群聊绑定的安全性与流程。
-    - **权限控制**: 仅 Topic 创建者或管理员允许执行群聊绑定/解绑操作。
-    - **审批流程**: 新增群聊绑定审批机制，非管理员/非信任用户的绑定请求需经过审批（`status` 追踪）。
-    - **管理员通知**: 引入 `admin-notifier.ts`，当有新的 Topic 或群聊绑定请求时，通过飞书卡片实时通知管理员。
- **信任用户系统**: 引入 `isTrusted` 标志。
-    - 信任用户创建 Topic 或绑定群聊时将自动通过审批。
-    - 管理员由于其特殊权限，默认享受自动审批。
+### Added
+- **Group Chat Binding Management**: Enhanced security and workflow for binding Topics to Feishu group chats.
+    - **Permission Control**: Only Topic creators or Admins are allowed to bind/unbind groups.
+    - **Approval Workflow**: New approval mechanism for group binding requests from non-admin/non-trusted users (tracked via `status`).
+    - **Admin Notifications**: Introduced `admin-notifier.ts` for real-time Feishu card notifications to admins upon new Topic or Binding requests.
+- **Trusted User System**: Introduced `isTrusted` flag.
+    - Trusted users' Topic and Binding requests are auto-approved.
+    - Admins skip approval by default.

-### 变更
- **数据库架构**: `topic_group_chats` 表新增了 `status` 和 `created_by` 字段，以支持审批流和权限校验。
+### Changed
+- **Database Schema**: Added `status` and `created_by` fields to `topic_group_chats` table to support approval flow and permission checks.

+## [1.3.0] - 2026-01-16

-### 新增
- **视觉品牌**: 引入了自定义图标和 Favicon。
-    - 为 "Alert Message Center" 专门设计的现代 Indigo 主题 Logo。
-    - 将 Logo 集成到登录界面和顶部导航栏，替换了通用的 Activity 图标。
+### Added
+- **Visual Branding**: Introduced custom logo and favicon.
+    - Modern Indigo theme logo designed specifically for "Alert Message Center".
+    - Integrated logo into Login screen and Header, replacing generic icons.

-### 修复
- **部署可靠性**: 修复了 Docker 环境下数据库迁移失败的问题。
-    - 在 `.gitignore` 中移除了对 `apps/server/drizzle/meta` 的忽略，确保 Drizzle 迁移日志 (`_journal.json`) 能正确打包进 Docker 镜像。
+### Fixed
+- **Deployment Reliability**: Fixed database migration failures in Docker environments by including `apps/server/drizzle/meta` in the package (un-ignored in git).

 ## [1.2.7] - 2026-01-15

-### 修复
- **数据库迁移**：修复了在 K8s 环境下执行 `db:migrate:deploy` 时由于相对路径解析失败导致的迁移中断问题。现在使用绝对路径进行稳健解析，并增加了调试日志。
+### Fixed
+- **Database Migration**: Fixed migration interruptions in K8s environments caused by relative path resolution failures. Now uses robust absolute paths with additional debug logging.

 ## [1.2.6] - 2026-01-15

-### 变更
- **用户 Token**：将用户的 `personalToken` 从 32 位 UUID 缩短为 8 位十六进制字符串，提升易用性。
- **数据库迁移**：完善了数据库迁移流程，在 `db:migrate:deploy` 中集成了存量用户 Token 的自动缩短逻辑，确保线上环境数据的一致性。
- **AI 规范**：更新了 `copilot-context.md`，明确要求 AI 在每次修改代码后必须进行代码风格和 Lint 检查。
- 
+### Changed
+- **User Tokens**: Shortened `personalToken` from 32-char UUID to 8-character hex string for better usability.
+- **Database Migration**: Integrated automated migration for existing user tokens into the deployment script.
+- **AI Conventions**: Updated `copilot-context.md` with strict requirements for style and lint checks.
+
 ## [1.2.5] - 2026-01-15

-### 修复
- **前端鲁棒性**: 修复了当数据库为空或 API 返回错误对象时页面发生崩溃（白屏）的问题。
-    - 为 `TopicsView`, `SystemLoadView` 和 `AdminView` 中的所有 API 请求增加了 `res.ok` 和 `Array.isArray` 校验。
-    - 增加了防御性逻辑，确保在数据未加载或加载失败时显示友好的提示而非崩溃。
- **Vite 环境变量**: 修复了 `TypeError: Cannot read properties of undefined (reading 'VITE_WEBHOOK_BASE_URL')`。
-    - 在 `TopicsView.tsx` 中使用可选链 (`meta.env?.`) 安全地访问 Vite 环境变量，防止由于环境未完全初始化导致的崩溃。
- **CI & 类型安全**: 修复了破坏 CI 流水的类型错误与格式问题。
-    - 运行 `biome check --write` 统一了全局代码格式。
-    - 完善了 `feishu.ts` 中的 `UserAccessTokenData` 接口定义，补充了飞书 API 返回的用户基础信息字段。
-    - 在 `auth.ts` 中增加了对 `feishuClient.getUserAccessToken` 返回值的空值校验，确保 OAuth 回调流程更健壮。
+### Fixed
+- **Frontend Resilience**: Fixed "white page" crashes when database is empty or API returns error objects.
+    - Added `res.ok` and `Array.isArray` checks to all API requests in `TopicsView`, `SystemLoadView`, and `AdminView`.
+    - Added defensive logic to show friendly messages instead of crashing.
+- **Vite Env Variables**: Fixed `TypeError` when accessing environment variables.
+    - Used optional chaining (`meta.env?.`) for safe access.
+- **CI & Type Safety**: Fixed CI-breaking type errors and formatting issues.
+    - Unified code style via `biome check --write`.
+    - Improved `UserAccessTokenData` interface and added null checks for OAuth callback.

 ## [1.2.4] - 2026-01-15

-### 变更
- **类型安全**: 全面重构了服务端与前端的代码，消除了绝大部分 `any` 类型的使用。
-    - 在 `webhook.ts`, `verify_permissions.ts`, `feishu.ts` 等核心文件中引入了显式接口。
-    - 改进了 Webhook Body 的处理逻辑，在保持灵活性的同时增强了类型校验。
-    - 修复了多处 Non-null Assertion 为更安全的可选链或显式空值检查。
- **Linting**: 严格执行 Biome 的 `noExplicitAny` 规则。
+### Changed
+- **Type Safety**: Refactored core logic to eliminate `any` types.
+    - Introduced explicit interfaces in `webhook.ts`, `verify_permissions.ts`, and `feishu.ts`.
+    - Improved Webhook body handling with better validation.
+- **Linting**: Enforced Biome's `noExplicitAny` rule.

 ## [1.2.3] - 2026-01-15

-### 新增
- **自动化数据库迁移**: 引入了自动化数据库初始化与迁移机制。
-    - 添加了 `src/db/migrate.ts` 脚本，使用 Drizzle Migrator 自动应用挂起的迁移。
-    - 更新了 `Dockerfile`，使容器启动时自动执行数据库迁移。
-    - 在 `package.json` 中新增了 `db:migrate:deploy` 脚本。
+### Added
+- **Automated DB Migrations**: Introduced automatic database initialization.
+    - Added `src/db/migrate.ts` using Drizzle Migrator.
+    - Updated `Dockerfile` to run migrations on startup.

-### 修复
- **初始化错误**: 修复了在全新环境下启动时因缺少数据库表导致的 `relation "users" does not exist` 错误。
- **迁移历史**: 清理并重新生成了初始迁移文件，确保所有表在全新部署时能正确创建。
+### Fixed
+- **Initialization Errors**: Fixed `relation "users" does not exist` on fresh installs.
+- **Migration History**: Re-generated initial migration files for clean deployments.

-## [1.2.2] - 2026-01-14
+## [1.2.2] - 2024-01-14

-### 变更
- **Linting**: 强化了 Biome 配置，启用了更严格的 `a11y` (可访问性), `suspicious` (可疑代码), `style` (代码规范) 和 `correctness` (正确性) 检查规则。
- **配置**: 配置 `noUnknownAtRules` 规则以忽略 Tailwind CSS 特有的 At-rules。
- **CI/CD**: 集成 Biome 检查到 GitHub Actions 工作流，确保在所有 Pull Request 中强制执行代码规范检查。
+### Changed
+- **Linting**: Tightened Biome configuration for `a11y`, `suspicious`, `style`, and `correctness`.
+- **CI/CD**: Integrated Biome checks into GitHub Actions.

-### 修复
- **Web 可访问性**: 为所有按钮添加了显式的 `type="button"` 以符合规范。
- **语义化/ARAI**: 修正了 `Modal` 背景的交互逻辑，将非语义化的 `div` 替换为 `<button>` 并添加了必要的键盘事件与 ARIA 属性。
- **Hook 依赖**: 在多个视图中使用了 `useCallback` 来确保 `useEffect` 依赖链的稳定性，解决了 `exhaustive-deps` 警告。
- **代码健壮性**: 修复了 `main.tsx` 中的 Non-null Assertion 并解决了 `TopicsView` 中的类型重声明冲突。
+### Fixed
+- **Accessibility**: Added `type="button"` to all buttons and improved Modal keyboard/ARIA support.
+- **Hook Dependencies**: Stabilized `useEffect` chains using `useCallback`.

-## [1.2.1] - 2026-01-14
+## [1.2.1] - 2024-01-14

-### 修复
- **WebSocket 初始化**: 修复了 `@larksuiteoapi/node-sdk` v1.56.0+ 中 WebSocket 初始化不正确的 `TypeError`。现在正确使用了 `WSClient` 类并修复了参数类型错误。
- **事件处理**: 修正了 `im.chat.member.bot.added_v1` 事件的 Payload 解析逻辑。
- **Hono 兼容性**: 修正了 `feishu-event.ts` 中 `lark.adaptDefault` 的错误用法。改为使用手动 Challenge 处理和 `eventDispatcher.invoke`，并通过原型链注入 Header 解决了与 Hono 请求/响应对象的兼容性以及签名校验失败的问题。
- **群聊解绑**: 增加对 `im.chat.member.bot.deleted_v1` 事件的支持。当机器人被移除群聊时，自动清理 `known_group_chats` 和 `topic_group_chats` 关联，确保订阅关系自动解绑。
+### Fixed
+- **WebSocket Initialization**: Fixed `TypeError` in `@larksuiteoapi/node-sdk` v1.56.0+.
+- **Hono Compatibility**: Fixed signature verification issues by using manual challenge handling and prototype header injection.
+- **Auto-Cleanup**: Added `im.chat.member.bot.deleted_v1` support to automatically unbind topics when bot is removed from a group.

-### 新增
- **结构化日志**: 引入 `pino` 框架替代 `console.log`，实现结构化 JSON 日志输出。
-  - 在开发环境集成 `pino-pretty` 提供人类友好格式。
-  - 支持通过环境遍历控制日志级别。
+### Added
+- **Structured Logging**: Integrated `pino` for JSON logging with `pino-pretty` for development.

 ## [1.2.0] - 2026-01-13

-### 新增
- **飞书群聊通知**: 支持将告警发送到飞书群聊 (App Bot 模式)。
-  - 自动发现机器人所在的群组。
-  - 支持在 Topic 中绑定群聊。
- **长连接模式 (WebSocket)**: 引入 `@larksuiteoapi/node-sdk`，支持通过 WebSocket 接收飞书事件，解决内网环境无法使用 Webhook 的问题。
-  - 可通过 `FEISHU_USE_WS=true` 开启。
- **UI 改进**: 在 Topic 列表页新增了群聊管理入口。
+### Added
+- **Feishu Group Notifications**: Support for sending alerts to Feishu group chats.
+- **Long Connection (WebSocket)**: Support for intranet deployments via Feishu WebSocket mode.
+- **UI Improvements**: Added group management entry in Topic list.
+
+### Changed
+- **Architecture**: Unified event distribution for Webhook and WebSocket modes.

-### 变更
- **数据库**: 新增 `topic_group_chats` 和 `known_group_chats` 表。
- **底层架构**: 重构了飞书客户端 (`FeishuClient`) 和事件处理逻辑，统一了 Webhook 和 WebSocket 的事件分发。
 ## [1.1.1] - 2026-01-13

-### 修复
- **CI/CD**: 修复了由于 Dockerfile 路径重构导致的 GitHub Actions 构建失败问题。
+### Fixed
+- **CI/CD**: Fixed Docker build failures after path restructuring.

 ## [1.1.0] - 2026-01-13

-### 新增
- **Docker 集成**: 将前端和后端合并为统一个 Docker 镜像，简化部署流程。
- **CI/CD**: 添加了 GitHub Actions 工作流，支持自动化 Docker 构建和镜像推送。
- **环境隔离**: 改进了单体仓库中的 `.env` 处理，使用 Bun 的 `--env-file` 参数。
- **根目录脚本**: 在根目录添加了 `start` 和 `dev` 脚本，提升开发体验。
- **代理配置**: 使 Vite 的代理目标可通过 `VITE_API_URL` 环境变量配置。
-
-### 变更
- 更新了服务端，使其从 `public` 目录提供前端静态文件。
- 将 `docker-compose.yml` 整合为单一服务。
+### Added
+- **Docker Integration**: Single multi-stage Docker image for both frontend and backend.
+- **Environment Isolation**: Improved `.env` handling using Bun's `--env-file`.
+- **Root Scripts**: Unified `dev` and `start` scripts in root directory.

 ## [1.0.0] - 2026-01-12

-### 新增
- **个人信箱**: 支持通过个人 Webhook Token 实现私聊推送。
- **话题管理**: 为话题增加了 `created_by` (创建者) 和 `approved_by` (审批人) 的追踪。
- **管理员看板**: 新增了管理话题申请和权限的视图。
- **身份验证**: 集成飞书 (Lark) OAuth2。
- **初始版本**: 基于 Hono, Vite 和 PostgreSQL 的基础告警分发系统。
-
-### 修复
- 优化了 README 文档和项目结构。
-
-## [0.1.0] - 2026-01-12
-
-### 新增
- 初始项目结构和数据库模式定义。
- 基础的飞书消息发送功能。
+### Added
+- **Personal Inbox**: Support for private DM notifications via personal token.
+- **Topic Management**: Ownership and approval tracking for topics.
+- **Admin Dashboard**: New view for managing topic requests and permissions.
+- **Lark OAuth2**: Integrated Feishu identity provider.
+- **Initial Release**: Core alert routing system based on Hono, Vite, and PostgreSQL.
--- a/CHANGELOG.zh-CN.md
+++ b/CHANGELOG.zh-CN.md
@@ -0,0 +1,171 @@
+# 更新日志
+
+本项目的所有显著变更都将记录在此文件中。
+
+本文件的格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
+并且本项目遵循 [语义化版本 (Semantic Versioning)](https://semver.org/lang/zh-CN/spec/v2.0.0.html)。
+
+**更新日志** | [English](./CHANGELOG.md)
+ 
+## [1.3.3] - 2026-01-17
+
+### 新增
+- **多副本部署支持**: 增强了在负载均衡/多实例环境下的稳定性。
+    - **数据库锁机制**: 在 `db:migrate:deploy` 脚本中引入了 **Postgres Advisory Locks**，防止多个实例同时执行数据库迁移导致竞态问题。
+    - **幂等性增强**: 验证并确保了飞书事件处理逻辑的幂等性，支持多副本安全接收重复事件。
+
+## [1.3.2] - 2026-01-17
+
+### 新增
+- **群聊搜索功能**: 在绑定群聊时新增了实时搜索功能，解决了群聊过多时难以查找的问题。
+    - **后端支持**: `GET /groups` 接口现在支持 `q` 查询参数进行模糊搜索，并提高了默认返回数量。
+    - **搜索前端**: 引入了带防抖逻辑的搜索输入框和自定义下拉列表，提升了用户体验。
+
+### 变更
+- **UI 优化**: 改进了 `GroupBindingsModal` 的视觉设计，使用了更现代的列表样式、状态图标和加载动画。
+- **文档优化**: 将 `README.md` 拆分为英文版 (`README.md`) 和中文版 (`README.zh-CN.md`)，以更好地支持国际化。
+
+## [1.3.1] - 2026-01-16
+
+### 新增
+- **群聊绑定管理**: 增强了 Topic 与飞书群聊绑定的安全性与流程。
+    - **权限控制**: 仅 Topic 创建者或管理员允许执行群聊绑定/解绑操作。
+    - **审批流程**: 新增群聊绑定审批机制，非管理员/非信任用户的绑定请求需经过审批（`status` 追踪）。
+    - **管理员通知**: 引入 `admin-notifier.ts`，当有新的 Topic 或群聊绑定请求时，通过飞书卡片实时通知管理员。
+- **信任用户系统**: 引入 `isTrusted` 标志。
+    - 信任用户创建 Topic 或绑定群聊时将自动通过审批。
+    - 管理员由于其特殊权限，默认享受自动审批。
+
+### 变更
+- **数据库架构**: `topic_group_chats` 表新增了 `status` 和 `created_by` 字段，以支持审批流和权限校验。
+
+
+### 新增
+- **视觉品牌**: 引入了自定义图标和 Favicon。
+    - 为 "Alert Message Center" 专门设计的现代 Indigo 主题 Logo。
+    - 将 Logo 集成到登录界面和顶部导航栏，替换了通用的 Activity 图标。
+
+### 修复
+- **部署可靠性**: 修复了 Docker 环境下数据库迁移失败的问题。
+    - 在 `.gitignore` 中移除了对 `apps/server/drizzle/meta` 的忽略，确保 Drizzle 迁移日志 (`_journal.json`) 能正确打包进 Docker 镜像。
+
+## [1.2.7] - 2026-01-15
+
+### 修复
+- **数据库迁移**：修复了在 K8s 环境下执行 `db:migrate:deploy` 时由于相对路径解析失败导致的迁移中断问题。现在使用绝对路径进行稳健解析，并增加了调试日志。
+
+## [1.2.6] - 2026-01-15
+
+### 变更
+- **用户 Token**：将用户的 `personalToken` 从 32 位 UUID 缩短为 8 位十六进制字符串，提升易用性。
+- **数据库迁移**：完善了数据库迁移流程，在 `db:migrate:deploy` 中集成了存量用户 Token 的自动缩短逻辑，确保线上环境数据的一致性。
+- **AI 规范**：更新了 `copilot-context.md`，明确要求 AI 在每次修改代码后必须进行代码风格和 Lint 检查。
+ 
+## [1.2.5] - 2026-01-15
+
+### 修复
+- **前端鲁棒性**: 修复了当数据库为空或 API 返回错误对象时页面发生崩溃（白屏）的问题。
+    - 为 `TopicsView`, `SystemLoadView` 和 `AdminView` 中的所有 API 请求增加了 `res.ok` 和 `Array.isArray` 校验。
+    - 增加了防御性逻辑，确保在数据未加载或加载失败时显示友好的提示而非崩溃。
+- **Vite 环境变量**: 修复了 `TypeError: Cannot read properties of undefined (reading 'VITE_WEBHOOK_BASE_URL')`。
+    - 在 `TopicsView.tsx` 中使用可选链 (`meta.env?.`) 安全地访问 Vite 环境变量，防止由于环境未完全初始化导致的崩溃。
+- **CI & 类型安全**: 修复了破坏 CI 流水的类型错误与格式问题。
+    - 运行 `biome check --write` 统一了全局代码格式。
+    - 完善了 `feishu.ts` 中的 `UserAccessTokenData` 接口定义，补充了飞书 API 返回的用户基础信息字段。
+    - 在 `auth.ts` 中增加了对 `feishuClient.getUserAccessToken` 返回值的空值校验，确保 OAuth 回调流程更健壮。
+
+## [1.2.4] - 2026-01-15
+
+### 变更
+- **类型安全**: 全面重构了服务端与前端的代码，消除了绝大部分 `any` 类型的使用。
+    - 在 `webhook.ts`, `verify_permissions.ts`, `feishu.ts` 等核心文件中引入了显式接口。
+    - 改进了 Webhook Body 的处理逻辑，在保持灵活性的同时增强了类型校验。
+    - 修复了多处 Non-null Assertion 为更安全的可选链或显式空值检查。
+- **Linting**: 严格执行 Biome 的 `noExplicitAny` 规则。
+
+## [1.2.3] - 2026-01-15
+
+### 新增
+- **自动化数据库迁移**: 引入了自动化数据库初始化与迁移机制。
+    - 添加了 `src/db/migrate.ts` 脚本，使用 Drizzle Migrator 自动应用挂起的迁移。
+    - 更新了 `Dockerfile`，使容器启动时自动执行数据库迁移。
+    - 在 `package.json` 中新增了 `db:migrate:deploy` 脚本。
+
+### 修复
+- **初始化错误**: 修复了在全新环境下启动时因缺少数据库表导致的 `relation "users" does not exist` 错误。
+- **迁移历史**: 清理并重新生成了初始迁移文件，确保所有表在全新部署时能正确创建。
+
+## [1.2.2] - 2026-01-14
+
+### 变更
+- **Linting**: 强化了 Biome 配置，启用了更严格的 `a11y` (可访问性), `suspicious` (可疑代码), `style` (代码规范) 和 `correctness` (正确性) 检查规则。
+- **配置**: 配置 `noUnknownAtRules` 规则以忽略 Tailwind CSS 特有的 At-rules。
+- **CI/CD**: 集成 Biome 检查到 GitHub Actions 工作流，确保在所有 Pull Request 中强制执行代码规范检查。
+
+### 修复
+- **Web 可访问性**: 为所有按钮添加了显式的 `type="button"` 以符合规范。
+- **语义化/ARAI**: 修正了 `Modal` 背景的交互逻辑，将非语义化的 `div` 替换为 `<button>` 并添加了必要的键盘事件与 ARIA 属性。
+- **Hook 依赖**: 在多个视图中使用了 `useCallback` 来确保 `useEffect` 依赖链的稳定性，解决了 `exhaustive-deps` 警告。
+- **代码健壮性**: 修复了 `main.tsx` 中的 Non-null Assertion 并解决了 `TopicsView` 中的类型重声明冲突。
+
+## [1.2.1] - 2026-01-14
+
+### 修复
+- **WebSocket 初始化**: 修复了 `@larksuiteoapi/node-sdk` v1.56.0+ 中 WebSocket 初始化不正确的 `TypeError`。现在正确使用了 `WSClient` 类并修复了参数类型错误。
+- **事件处理**: 修正了 `im.chat.member.bot.added_v1` 事件的 Payload 解析逻辑。
+- **Hono 兼容性**: 修正了 `feishu-event.ts` 中 `lark.adaptDefault` 的错误用法。改为使用手动 Challenge 处理和 `eventDispatcher.invoke`，并通过原型链注入 Header 解决了与 Hono 请求/响应对象的兼容性以及签名校验失败的问题。
+- **群聊解绑**: 增加对 `im.chat.member.bot.deleted_v1` 事件的支持。当机器人被移除群聊时，自动清理 `known_group_chats` 和 `topic_group_chats` 关联，确保订阅关系自动解绑。
+
+### 新增
+- **结构化日志**: 引入 `pino` 框架替代 `console.log`，实现结构化 JSON 日志输出。
+  - 在开发环境集成 `pino-pretty` 提供人类友好格式。
+  - 支持通过环境遍历控制日志级别。
+
+## [1.2.0] - 2026-01-13
+
+### 新增
+- **飞书群聊通知**: 支持将告警发送到飞书群聊 (App Bot 模式)。
+  - 自动发现机器人所在的群组。
+  - 支持在 Topic 中绑定群聊。
+- **长连接模式 (WebSocket)**: 引入 `@larksuiteoapi/node-sdk`，支持通过 WebSocket 接收飞书事件，解决内网环境无法使用 Webhook 的问题。
+  - 可通过 `FEISHU_USE_WS=true` 开启。
+- **UI 改进**: 在 Topic 列表页新增了群聊管理入口。
+
+### 变更
+- **数据库**: 新增 `topic_group_chats` 和 `known_group_chats` 表。
+- **底层架构**: 重构了飞书客户端 (`FeishuClient`) 和事件处理逻辑，统一了 Webhook 和 WebSocket 的事件分发。
+## [1.1.1] - 2026-01-13
+
+### 修复
+- **CI/CD**: 修复了由于 Dockerfile 路径重构导致的 GitHub Actions 构建失败问题。
+
+## [1.1.0] - 2026-01-13
+
+### 新增
+- **Docker 集成**: 将前端和后端合并为统一个 Docker 镜像，简化部署流程。
+- **CI/CD**: 添加了 GitHub Actions 工作流，支持自动化 Docker 构建和镜像推送。
+- **环境隔离**: 改进了单体仓库中的 `.env` 处理，使用 Bun 的 `--env-file` 参数。
+- **根目录脚本**: 在根目录添加了 `start` 和 `dev` 脚本，提升开发体验。
+- **代理配置**: 使 Vite 的代理目标可通过 `VITE_API_URL` 环境变量配置。
+
+### 变更
+- 更新了服务端，使其从 `public` 目录提供前端静态文件。
+- 将 `docker-compose.yml` 整合为单一服务。
+
+## [1.0.0] - 2026-01-12
+
+### 新增
+- **个人信箱**: 支持通过个人 Webhook Token 实现私聊推送。
+- **话题管理**: 为话题增加了 `created_by` (创建者) 和 `approved_by` (审批人) 的追踪。
+- **管理员看板**: 新增了管理话题申请和权限的视图。
+- **身份验证**: 集成飞书 (Lark) OAuth2。
+- **初始版本**: 基于 Hono, Vite 和 PostgreSQL 的基础告警分发系统。
+
+### 修复
+- 优化了 README 文档和项目结构。
+
+## [0.1.0] - 2026-01-12
+
+### 新增
+- 初始项目结构和数据库模式定义。
+- 基础的飞书消息发送功能。
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -95,7 +95,7 @@ docker-compose up -d

 ## 📜 更新日志

-所有版本的详细变更记录请查看 [CHANGELOG.md](CHANGELOG.md)。
+所有版本的详细变更记录请查看 [CHANGELOG.zh-CN.md](CHANGELOG.zh-CN.md)。

 ---

--- a/apps/server/package.json
+++ b/apps/server/package.json
@@ -1,6 +1,6 @@
 {
 	"name": "@alertmessagecenter/server",
-	"version": "1.2.0",
+	"version": "1.3.3",
 	"scripts": {
 		"dev": "bun run --env-file .env --watch src/index.ts",
 		"start": "bun run src/index.ts",
@@ -25,4 +25,4 @@
 		"drizzle-kit": "^0.31.8",
 		"pino-pretty": "^13.1.3"
 	}
-}
+}
--- a/apps/web/package.json
+++ b/apps/web/package.json
@@ -1,6 +1,6 @@
 {
 	"name": "@alertmessagecenter/web",
-	"version": "1.2.0",
+	"version": "1.3.3",
 	"type": "module",
 	"scripts": {
 		"dev": "bun run --env-file .env vite",
@@ -29,4 +29,4 @@
 		"@types/node": "^20.0.0",
 		"bun-types": "latest"
 	}
-}
+}
--- a/docs/copilot-context.md
+++ b/docs/copilot-context.md
@@ -1,4 +1,4 @@
-# Project Context for GitHub Copilot (v1.3.2)
+# Project Context for GitHub Copilot (v1.3.3)

 This document provides technical context, architectural decisions, and code conventions for the **Alert Message Center** project. It is intended to help AI assistants understand the codebase.

@@ -241,6 +241,10 @@ The database schema is defined in `apps/server/src/db/schema.ts`.
  - **Token Migration**: The `db:migrate:deploy` script (defined in `src/db/migrate.ts`) also handles legacy user token shortening to maintain consistency with the 8-character token logic introduced in v1.2.6.
  - **Drizzle Meta**: The `apps/server/drizzle/meta` directory MUST NOT be ignored by git (it was previously explicitly excluded in `.gitignore` but has been restored). This directory contains `_journal.json`, which is essential for `drizzle-kit` and the runtime migrator to verify migration integrity. Without it, migrations will fail in clean environments like Docker containers.

+  - **Multi-Replica Support**:
+    - **Migrations**: The `db:migrate:deploy` script uses **Postgres Advisory Locks** to prevent race conditions when multiple replicas start simultaneously. Only one replica will execute the migration; others will wait and verify.
+    - **Feishu Events**: The event handling logic is designed to be idempotent (`onConflictDoUpdate`), making it safe to run multiple replicas receiving duplicated events from Feishu (via WebSocket or Webhook).
+
 ## 8. Core Documents

 - **[README.md](file:///Users/lilithgames/Workspace/play/alert-message-center/README.md)**: Main project documentation (English version).
--- a/todo.md
+++ b/todo.md
@@ -37,4 +37,5 @@
 - [x] **User Management UI**: Added "Admin" badges and a "Trusted" toggle in the User Management view.
 - [x] **Searchable Group Binding**: Implemented server-side search and searchable dropdown for smoother group chat management.
 - [x] **Bilingual Documentation**: Split README into English and Chinese versions for international outreach.
+- [x] **Multi-Replica Safety**: Implemented Postgres Advisory Locks for safe concurrent migrations.