diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 00000000..2056f595
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,10 @@
+# Changelog
+
+## 0.4.0 — 2026-03-14
+
+### Highlights
+- 版本号升级至 v0.4.0，标记为稳定版本里程碑
+
+### Dev
+- `pubspec.yaml`: 版本号从 `0.1.0+1` 更新至 `0.4.0+2`
+- `CodexBar/version.env`: 营销版本从 `0.18.0-beta.3` 更新至 `0.4.0`
diff --git a/CodexBar b/CodexBar
index 631c33cd..aeb24955 160000
--- a/CodexBar
+++ b/CodexBar
@@ -1 +1 @@
-Subproject commit 631c33cd6c5c858ca1b962e3a6d69b1c1acb1fdc
+Subproject commit aeb24955bb3a42bc12e7f40960593b7c46874f2c
diff --git a/pubspec.yaml b/pubspec.yaml
index 0cfc840f..d18433ed 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -2,7 +2,7 @@ name: xworkmate
 description: "XWorkmate desktop-first AI workspace shell."
 publish_to: 'none'
 
-version: 0.1.0+1
+version: 0.4.0+2
 build-date: 2026-03-12
 build-id: acc3a06