diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..cfa14ac
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,25 @@
+# MING 明命项目 Agent 说明
+
+## 发布规则
+
+- 当前主题版本以 `ming-theme/style.css` 的 `Version` 和 `ming-theme/functions.php` 的 `MING_VERSION` 为准，两者必须一致。
+- 每次发布必须同步更新本文件、仓库根目录 `README.md` 的版本记录，以及 `ming-theme/ROADMAP.md` 的当前版本。
+- 发布前执行 `./scripts/package-theme.sh`，确认 `dist/ming-theme.zip` 含有顶层 `ming-theme/` 目录。
+- 不得将账号、密码、Cookie、令牌、生产配置或私有部署资料提交到 Git。
+
+## 版本更新记录
+
+| 版本 | 更新内容 |
+|---|---|
+| 1.2.4 | 品牌页面、电商页面与新品投票系统的功能基线。 |
+| 1.5.2 | 订单页增加 BACS 汇款信息卡；重构未登录会员中心为双卡片布局。 |
+| 1.5.3 | 增加移动端汉堡按钮与全屏抽屉导航。 |
+| 1.5.4 | 优化已登录会员中心的移动端导航与内容布局。 |
+| 1.5.5 | 修复移动端订单列表数据被最小宽度挤出屏幕的问题。 |
+| 1.5.6 | 字体改为本地托管的 Noto TC 字体子集，移除 Google Fonts 外链并精简字重。 |
+| 1.6.0 | 增加首页宣传片、站内商品搜索、三栏页脚与启用主题时的信息页初始化。 |
+| 1.7.0 | 增加 OG/Twitter 分享标签、许愿分享、品牌专栏、SKU/色卡体系与海报生成器；同步修复视频、库存与移动端布局。 |
+| 1.7.1 | 协调移动端字体与断行，修复变体库存状态、色卡属性与投票商品过滤。 |
+| 1.7.2 | 修复分享按钮的 `hidden` 状态、色点点击换图/跳转及移动端页脚三栏布局。 |
+| 1.7.3 | 当前主题源码整理与 Git 仓库基线版本；未发现独立的功能变更记录。 |
+| 1.7.4 | 字体、SVG 文字与分享语言标识改为跟随 WordPress 后台“站点语言”：繁中使用自托管 TC 字体，简中、日文、韩文及其他语言使用相应字型回退。 |
diff --git a/README.md b/README.md
index fe4e7ca..d9cc281 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,27 @@ dist/                生成的主题 ZIP；不进入 Git
 
 产物为 `dist/ming-theme.zip`，其中包含顶层 `ming-theme/` 目录。
 
+## 版本与更新记录
+
+主题当前版本为 **1.7.4**。主题版本必须同时更新 `ming-theme/style.css` 的 `Version` 和 `ming-theme/functions.php` 的 `MING_VERSION`；前者供 WordPress 识别主题版本，后者用于 CSS、JS 与字体资源的缓存刷新。
+
+| 版本 | 更新内容 |
+|---|---|
+| 1.2.4 | 品牌页面、电商页面与新品投票系统的功能基线。 |
+| 1.5.2 | 订单页增加 BACS 汇款信息卡；重构未登录会员中心为双卡片布局。 |
+| 1.5.3 | 增加移动端汉堡按钮与全屏抽屉导航。 |
+| 1.5.4 | 优化已登录会员中心的移动端导航与内容布局。 |
+| 1.5.5 | 修复移动端订单列表数据被最小宽度挤出屏幕的问题。 |
+| 1.5.6 | 字体改为本地托管的 Noto TC 字体子集，移除 Google Fonts 外链并精简字重。 |
+| 1.6.0 | 增加首页宣传片、站内商品搜索、三栏页脚与启用主题时的信息页初始化。 |
+| 1.7.0 | 增加 OG/Twitter 分享标签、许愿分享、品牌专栏、SKU/色卡体系与海报生成器；同步修复视频、库存与移动端布局。 |
+| 1.7.1 | 协调移动端字体与断行，修复变体库存状态、色卡属性与投票商品过滤。 |
+| 1.7.2 | 修复分享按钮的 `hidden` 状态、色点点击换图/跳转及移动端页脚三栏布局。 |
+| 1.7.3 | 当前主题源码整理与 Git 仓库基线版本；未发现独立的功能变更记录。 |
+| 1.7.4 | 字体、SVG 文字与分享语言标识改为跟随 WordPress 后台“站点语言”：繁中使用自托管 TC 字体，简中、日文、韩文及其他语言使用相应字型回退。 |
+
+每次发布必须：更新上述两处版本号、在本表和项目 Agent 文档记录变更、提交 Git、重新打包并验证主题包。
+
 ## 重要约束
 
 - 不提交后台密码、Cookie、API 密钥、生产配置或本地运维交接材料。
diff --git a/ming-theme/ROADMAP.md b/ming-theme/ROADMAP.md
index 2fb5f28..3c3fe97 100644
--- a/ming-theme/ROADMAP.md
+++ b/ming-theme/ROADMAP.md
@@ -1,6 +1,6 @@
 # ROADMAP.md — MING 明命 项目路线图
 
-> 当前源码版本：ming-theme **v1.7.3**
+> 当前源码版本：ming-theme **v1.7.4**
 > 最后更新：2026-09
 
 ---