大家好，我们近期整理并上线了一个专门面向子比主题用户和开发者的社区开发文档站：
这不是简单收集几篇教程，也不是把主题函数罗列出来，而是希望建立一套覆盖“安装部署、后台配置、源码理解、业务扩展、问题排查和 AI 辅助开发”的完整知识库。
无论你是刚接触子比主题、正在搭建网站，还是需要开发插件、子主题、商城、论坛、支付和用户系统，都可以在这里找到对应的学习路线和开发资料。
为什么要做这个文档站？
子比主题包含大量功能模块，后台配置、主题源码、WordPress 数据结构、Ajax 请求和前端脚本之间存在复杂的关联。
在实际使用和开发过程中，大家经常会遇到这些问题：
- 找到了一篇教程，但不知道是否适用于当前主题版本。
- 知道后台有这个功能，却不知道对应配置保存在哪里。
- 想修改功能，只能直接改主题核心文件。
- 找到了一个函数，却不知道它在哪个页面、哪个请求链路中执行。
- Ajax 请求失败，但不知道应该检查 nonce、权限、参数还是缓存。
- 支付、论坛、用户中心等功能涉及多个模块，很难定位真正的问题。
- AI 可以生成代码，但不了解子比主题的真实函数和数据结构。
- 每次开发都要重新搜索教程、翻源码、查 Hook，效率较低。
我们的目标，就是把这些分散的信息整理成可以搜索、可以验证、可以继续追踪源码的系统化开发文档。
这个文档能用来做什么？
1. 学习如何正确搭建和配置子比主题网站
文档提供了从服务器环境到主题功能的完整学习路线，包括：
- WordPress 与子比主题运行环境。
- 域名解析、HTTPS 和站点绑定。
- 宝塔、LNMP、Docker 等部署方式。
- PHP 扩展、目录权限和环境检查。
- 伪静态、固定链接、缓存和 CDN。
- 主题更新、备份、迁移和故障回滚。
- Logo、导航、菜单、首页、文章列表和 SEO。
- 登录注册、邮件、短信和验证码配置。
如果你只是使用子比主题建站，可以按照学习路线逐步完成配置，不需要在大量零散教程中反复查找。
2. 排查网站运行中的实际问题
文档不仅说明“功能在哪里开启”，还会解释问题发生时应该检查什么，例如：
- 页面或用户中心出现 404。
- 开启 CDN 后登录状态或 Ajax 异常。
- 支付成功但订单状态没有更新。
- 邮件、短信验证码无法发送。
- 图片上传成功但前台不显示。
- 固定链接、HTTPS 或伪静态配置错误。
- 论坛帖子进入待审核或无法发布。
- 用户权限、会员权限、下载权限判断异常。
- 更新主题后样式错乱或自定义代码失效。
排查内容会尽量覆盖请求入口、配置字段、数据保存、权限判断、缓存边界和日志位置，帮助用户从现象逐步找到真正原因。
3. 开发子比主题插件和子主题
对于需要二次开发的用户，文档提供了更系统的开发资料，包括：
- 子比主题源码目录和模块结构。
- WordPress 与主题文件加载顺序。
- Action、Filter 和主题自定义 Hook。
- Ajax action、nonce、权限和返回格式。
- 主题函数、Meta 数据和配置读取。
- 模板覆盖与页面扩展方式。
- 插件目录、加载入口和停用边界。
- 子主题的 functions.php、样式和模板继承。
- 用户中心 Tab、作者主页和前台弹窗扩展。
- 前台投稿、编辑器和内容保存链路。
目标是帮助开发者优先使用 Hook、插件和子主题完成扩展，减少直接修改主题核心文件带来的升级覆盖和维护问题。
4. 查询 Codestar Framework 的真实使用方式
子比主题后台大量配置由 Codestar Framework 承载，因此我们单独整理了完整的 Codestar Framework 分类，包括：
- 后台设置菜单和 Section。
- 常用字段类型与参数。
- Metabox 和文章 Meta。
- 用户、分类、评论和菜单字段。
- 小工具与自定义设置。
- 论坛相关 Meta。
- 配置值读取、保存和默认值处理。
- 子比主题现有 CSF 配置的扩展方式。
不仅可以查询字段怎么写，还可以理解配置保存在哪里、前台如何读取，以及怎样与子比主题现有设置保持一致。
5. 开发商城、支付、资源和用户资产功能
文档覆盖了子比主题中较复杂的业务模块，例如：
- Zibpay 订单、支付和回调链路。
- 付费下载、付费阅读和资源权限。
- VIP 会员、余额、积分和用户资产。
- 分佣、推广、提现和推荐关系。
- 商城商品、规格、库存和购物车。
- 自动发货、物流、售后和退款。
- 优惠码、优惠活动和订单状态。
- 用户中心订单、资产和下载记录。
这些功能不适合只通过修改数据库字段实现。文档会尽量梳理现有订单、权限、支付回调和消息通知入口，降低扩展时破坏业务状态的风险。
6. 开发论坛、社区和用户互动功能
社区类网站可以查询论坛板块、帖子、话题、标签、发帖编辑、草稿审核、版主、关注、评分、采纳、付费板块、阅读权限、推荐指数、评论互动、用户成长、站内消息和内容审核等链路。
论坛功能通常会同时涉及用户权限、缓存、消息和积分。文档会把这些关联关系放在一起说明，避免只修改其中一个环节。
首页 AI 文档助手有什么用？
文档站首页提供了基于本站文档索引的 AI 对话功能。它与普通的通用 AI 对话不同，回答时会优先检索本站的子比主题开发文档，并显示实际使用的引用来源。
目前支持：
- 检索本站文档并结合文档内容回答。
- 显示引用文档、标题和来源链接。
- 点击引用直接打开对应文档。
- 深度思考和思考摘要。
- 服务器联网搜索。
- 自定义 OpenAI 兼容接口。
- 多模型选择与多模型对话。
- 图片和文件附件。
- 对话引用、分享和历史记录。
- 重新生成回答及多个回答版本快照。
当 AI 给出代码或排查建议时，可以通过引用直接回到原始文档继续核对，减少只看到答案却不知道依据来自哪里的情况。
文档阅读无需注册账号。AI 模型需要用户配置自己的 OpenAI 兼容接口，接口地址、密钥和模型配置保存在当前浏览器本地。
MCP、Codex 和 AI 编程工具能做什么？
除了网页阅读和 AI 对话，文档站还提供 MCP 文档服务器、Codex 插件、Codex Skill、llms.txt、完整 LLM 文本和单页 Markdown 文档接口。
接入后，Codex 或其他支持 MCP 的开发工具可以直接检索子比主题开发文档。例如：
- 根据文档制作一个子比主题插件。
- 查找适合某个需求的 Hook。
- 分析一个 Ajax 请求为什么失败。
- 判断配置值应该从哪里读取。
- 根据现有主题风格生成 Codestar 字段。
- 检查支付、用户中心或论坛扩展代码。
- 在修改代码前先读取对应的主题开发资料。
这样可以减少在浏览器、编辑器和 AI 对话之间反复切换的时间。
相比零散教程，我们的优势在哪里？
不是只告诉你“怎么配置”
普通教程通常解决一个具体操作，而本站还会继续追踪对应源码文件、配置保存位置、函数和 Hook、Ajax 请求、权限与 nonce、数据对象与 Meta、缓存边界以及日志和状态。
不是简单复制官方教程
官方教程更适合了解功能和后台配置，而本站会结合主题源码、子主题样本和插件案例继续整理实现链路。官方资料负责说明“这个功能怎么使用”，本站重点补充“源码怎么运行、数据怎么保存、Hook 怎么接入、问题怎么排查”。
按完整业务链路组织内容
支付、论坛、登录、媒体和用户系统往往不是一个函数就能完成。文档会尽量把前端入口、Ajax、权限、数据、缓存、通知和后续状态放在同一个链路中说明，更适合真实开发和故障排查。
有明确的学习路线
新用户可以按照部署、基础设置、内容、用户、商城、论坛和二次开发的顺序阅读。开发者则可以按照源码结构、加载顺序、数据模型、主题函数、Hook、Ajax、Codestar Framework 和模板覆盖的顺序学习。
文档与 AI 使用同一套知识库
网页文档、首页 AI、MCP、Codex Skill 和 LLM 文本来自同一套内容体系。你既可以自己阅读，也可以让 AI 帮你检索、总结、解释和生成代码，并通过引用继续核对原文。
访问速度快，使用门槛低
文档页面以静态内容为主，无需登录即可阅读和搜索。AI、MCP、Codex 插件和在线部署等需要动态能力的部分才会调用对应接口，普通浏览不会依赖复杂后台。
为什么值得选择这个文档站？
因为它希望解决的不是“再增加一个教程网站”，而是让子比主题开发形成一套可以持续使用的工作流：
- 遇到问题时先搜索文档。
- 找到对应模块和调用链路。
- 通过引用核对源码和数据结构。
- 使用 Hook、插件或子主题完成扩展。
- 让 AI 基于同一套文档协助分析和编写代码。
- 将新的问题和解决方案继续沉淀回文档。
这样可以减少重复搜索、盲目改源码、复制过时代码和 AI 凭空生成不存在函数的问题。
适合哪些用户？
- 正在搭建子比主题网站的新用户。
- 需要排查部署、缓存、支付和权限问题的站长。
- 开发子主题和功能插件的开发者。
- 制作资源站、会员站、商城或社区论坛的用户。
- 使用 Codex、MCP 或其他 AI 编程工具的开发者。
- 希望系统理解子比主题源码和业务结构的用户。
如何开始使用？
可以先打开文档首页：https://docs.vxras.com
新用户建议先阅读“使用指南”和“学习路线”；开发者可以从“源码结构”“主题扩展”和“Codestar Framework”开始；遇到具体问题时，也可以直接在首页询问 AI 文档助手。
当前整理进度与后续更新
需要说明的是，目前文档站的数据还没有全部整理完成，现有内容只是当前已经完成蒸馏、分类和校准的部分。
楼主目前仍在持续使用 AI 对子比主题源码、官方教程、插件案例、子主题样本和实际开发链路进行数据蒸馏，并在整理、校准后逐步更新到文档站。
后续还会持续补充：
- 尚未覆盖的主题功能和业务模块。
- 更完整的源码调用链路。
- 插件与子主题开发案例。
- 不同版本之间的实现差异。
- 常见故障和真实排查过程。
- AI、MCP、Codex 和自动化开发能力。
- 用户反馈中需要补充的文档内容。
完整的数据蒸馏需要持续消耗 AI 模型 Token、服务器资源和人工整理时间，因此全部数据完成蒸馏的时间，会取决于楼主能够持续投入的收入，以及用户自愿提供的赞助支持。
收入和赞助越充足，就能够投入更多模型额度和时间，加快数据蒸馏、人工校准与文档更新速度。即使暂时无法一次性完成全部内容，站点现有文档也会继续维护，并持续加入新的开发资料。
这是一个由社区整理并持续完善的开发文档项目，并非子比主题官方文档。涉及具体版本和线上业务时，请同时结合官方说明、当前主题源码、数据备份和实际运行结果进行确认。
欢迎大家体验后反馈缺失的模块、错误内容和希望补充的开发专题。我们会继续把新的源码分析、开发案例和排查经验整理进文档。
