ming-theme/          可部署的 WordPress 主题源码
assets/reference/    非运行时的品牌视觉参考素材
docs/brief/          系统说明、业务策略等交付资料
docs/private/        本地运维交接资料；已由 .gitignore 排除
scripts/             可重复执行的打包脚本
dist/                生成的主题 ZIP；不进入 Git

开发与打包

运行环境应使用 PHP 7.4+、WordPress 6.0+ 和 WooCommerce。修改主题时，保持 ming-theme/functions.php 中的 MING_VERSION 与 ming-theme/style.css 的 Version 一致。

执行以下命令生成可上传的主题包：

./scripts/package-theme.sh

产物为 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 密钥、生产配置或本地运维交接材料。
主题启用钩子包含历史数据初始化逻辑，可能创建内容、菜单、商品变体与媒体资源；生产环境切换主题前必须先备份并人工确认。
投票、SKU 初始化、海报生成等业务功能目前仍在主题内。后续应逐步迁移至独立插件，避免主题切换影响业务数据。

首次推送前

确认 git status --ignored 中没有敏感文件。
轮换曾出现在旧交接文档中的后台凭据。
在 Git 平台新建空仓库后，按团队身份配置 Git 用户信息、添加远程地址并推送。