一、环境准备
本地需准备 PHP 8.0+、MySQL 以及一套独立的 WordPress 测试站点，避免直接在生产环境试错。
1.1 目录结构约定
子主题放在 wp-content/themes/zibll_child，附加插件放在 wp-content/plugins/zibll-zhiji，二者职责分离。
1.2 必备依赖
Codestar Framework 用于后台选项面板，须随主题或插件一并加载，否则设置页无法渲染。
二、覆盖父主题行为
核心原则是”父主题文件零改动”，所有定制都收敛到子主题或插件中。
2.1 函数行为覆盖
通过 get_theme_file_path() 在父主题指定行号处注入，配合 after_setup_theme 钩子加载。
2.2 模板覆盖
把需要改写的模板复制到子主题同名路径，WordPress 会优先加载子主题版本。
三、后台选项面板集成
使用 CSF 在左侧导航新增顶级菜单，UI 完全复用父主题后台风格，保持视觉统一。
3.1 开关收纳
所有功能开关统一收纳到一个配置域，便于运维与排查。
3.2 权限与安全
涉及积分、支付等敏感操作时，必须走父主题提供的鉴权接口，禁止自行绕过。
示意图
子主题文件结构示意（theme-box / inc / templates 分层）
