开发者接口总览

YeCha 是纯 PHP 8.1+ / MySQL 的轻量博客系统（无 Composer / Node 依赖），适合改造与二次开发。

目录约定

• index.php 前台单一入口（伪静态转发），admin/ 后台
• core/ 内核：Db、Auth、Csrf、Cache、Str、Markdown、Poly、Front、Nav、Uc、View、Plugins、Upgrade、Feed、Router、Uc 等
• themes/<name>/、plugins/<id>/、install/migrations/、lang/*.php

前台路由（Router::resolve）

内容与多语

• ye_contents：type=post/page，status=publish/draft/hidden，正文 markdown 或 html
• ye_poly_contents：译文组（group_id=原文 id，lang/status/slug/manual_override）
• ye_metas（category/tag，含 name_en/slug_i18n）、ye_relationships（内容↔术语）

常用前台函数（主题模板内可用）

• e() 转义、__() 语言包、site_label()、Lang::short()、Poly::*
• Db::one/row/rows/insert/update/run/t；Cache::get/set/flush/incr
• View::render/asset、Markdown::render、Str::、Csrf::field/check、Auth::check/user、Uc::

“接口”说明（诚实版）

• 主要数据通道是 服务端渲染 + 表单 POST（带 CSRF）；对外公开的“接口”以 /feed、/sitemap.xml 等静态化输出为主；
• 需要 JSON API / 站内通知 / 采集互认等，官方通过插件扩展（如 links 的采集互认、market 的清单读取），可参考插件源码实现自己的端点。