元圣网址导航系统 · 开发文档 - 开发文档

元圣网址导航系统 · 开发文档

一、技术架构

形态：原生 PHP（无框架、无 Composer 依赖）网址导航/网站收录系统；PHP 7.4+（演示站跑 PHP 8.3）/ MySQL 5.7+（utf8mb4）；
发行形态：官方发行包中 6 个核心文件为加密（ionCube）发行版 —— admin/login.php、admin/config.php、admin/ajax.php、admin/article_category.php、admin/site_category.php、ys/functions.php；其余文件为明文源码，可直接二开；
前台：PC / 移动端自适应模板（template/default，可切换），伪静态 URL（/category-1.html、/site-1.html、/article-1.html 等）；
后台：/admin/login.php（登录带滑块验证）；
计划任务：ad_cron.php（广告到期）、site_check_cron.php（站点巡检）、ai_review_cron.php（AI 审核队列）。

二、目录结构

程序根/
├── index.php / site.php / site_category.php      # 前台入口
├── article.php / article_list.php / article_category.php
├── apply.php（收录申请）/ friend_link_apply.php / search.php / ranking.php
├── ad_buy_page.php / ad_pay.php / ad_process.php # 广告位购买
├── resource_download.php / resource_pay.php      # 资源下载（付费）
├── recommend_pay.php / site_audit_pay.php        # 付费推荐 / 付费审核
├── go.php（跳转统计）/ sitemap.php / captcha.php / api.php
├── ad_cron.php / site_check_cron.php / ai_review_cron.php / push_monitor.php
├── admin/        # 后台（站点/分类/文章/广告/资源/AI审核/统计/会员/设置/模板/备份…）
├── ys/           # 核心库（config.php 配置、database.php 数据库、security.php 安全与滑块、
│                 #   functions.php、Mailer.php、BackupManager.php、UpdateManager.php…）
├── user/         # 会员中心（登录/注册/资料/钱包/收益/提现/投稿/第三方登录）
├── template/default/   # 前台模板（含 slider-captcha.js）
├── sdk/          # 支付 SDK（易支付 notify/return/epayapi）
├── pay/          # 支付相关页面
├── assets/       # 后台与前台静态资源
├── install/      # 安装向导（装完请删除）
├── uploads/ cache/ logs/ backups/ backup/   # 运行目录（要可写）
└── 伪静态规则/   # Nginx / Apache 伪静态规则样例

三、数据库（38 张表，前缀默认 `ys_`）

站点与分类：ys_site（站点）、ys_site_category（分类，支持二级）、ys_site_stats / ys_site_view_log / ys_view_defense_ban（浏览统计与防刷）、ys_site_check_task / ys_site_check_task_item（巡检任务）；
内容：ys_article / ys_article_category / ys_article_stats / ys_article_view_log（文章与统计）、ys_article_resource / ys_article_resource_link（文章挂资源）、ys_user_article（用户投稿）；
资源付费：ys_resource_access / ys_resource_order / ys_resource_profit / ys_resource_view_event；
广告：ys_ad_big / ys_ad_small / ys_ad_word（大图/小图/文字链位）、ys_ad_order（投放订单）；
会员与资金：ys_user_info（会员）、ys_user_oauth_bind（第三方登录绑定）、ys_user_wallet / ys_user_wallet_ledger（钱包与流水）、ys_user_withdraw（提现）；
自动化与统计：ys_ai_review_task / ys_ai_review_task_item（AI 审核）、ys_visit_log / ys_visit_stats_daily / ys_spider_visit_log / ys_spider_stats_daily / ys_inbound_visit_log（访问与蜘蛛统计）；
系统：ys_config（键值配置：站点信息 / SEO / 易支付 / SMTP / 违禁词 / 拒绝原因模板…）、ys_admin（后台账号）、ys_system_nav（系统导航）、ys_friend_link（友链）。

四、关键机制

4.1 收录申请与审核（含付费）

访客提交 → ys_site（未审核）→ 后台「收录审核」通过/拒绝（可配默认拒绝原因）；支持付费审核（site_audit_pay.php）与付费推荐（recommend_pay.php），付款后自动置位。

4.2 AI 自动审核

命中 ys_config 里配置的违禁词/规则的任务进 AI 审核队列（ys_ai_review_task*），由 ai_review_cron.php 定时处理，后台可人工复核。

4.3 站点巡检

site_check_cron.php 定时批量检测站点可用性，结果写 ys_site_check_task*，失败站点在后台「站点检测/错误页」里集中处理。

4.4 广告位

广告位三种形态（大图/小图/文字链）分别对应 ys_ad_* 表，前台调用模板里按位输出；投放订单 ys_ad_order 有到期时间，由 ad_cron.php 定时下架。

4.5 安全

ys/security.php（明文，可直接阅读）集中处理：Session 安全、登录失败锁定、频率限制、滑块验证（challenge + 轨迹+指纹评分）、访问防护与封禁（ys_view_defense_ban）、安全响应头。

五、二次开发指引

改前台样式：template/default/ 下模板与 CSS；站点卡片/分类块都在模板里，改前先复制一份；
加前台页面：根目录加 xxx.php + 在 伪静态规则/ 里加对应 rewrite（Nginx 改完 reload）；
加后台功能：admin/ 下照现有页面写（明文页面可直接改；6 个加密文件改不了，要扩展就在旁边新建文件，后台菜单在加密的 admin/config.php 里维护——菜单项可改数据库/绕开加密页自建入口）；
加表/加字段：直接改库 + 在自己的明文页面里读写（核心加密文件不依赖新表）；
支付对接：sdk/（易支付 notify/return）与 admin/ad_config.php（广告/资源收款配置）；
注意：uploads/、cache/、logs/、backups/ 要可写；升级前备份加密文件之外的改动。

六、授权与更新

程序自带「云中心」（后台 → 云中心，接口 auth.yuansage.com）与「系统更新」页（UpdateManager.php，按系统码 + 当前版本请求更新）；本发行包不含星聚授权壳，包内《使用前必看》为作者随包说明文件。

← 返回文档列表

开发文档