Expand description
API 层根模块。
按职责划分子模块,包含两类接口:
- Dioxus server function(
#[server(Name, "/api")]),如auth、posts; - Axum 手动路由处理器,如
upload、image。
Modules§
- assets
- 素材管理(assets/asset_refs)的 Dioxus server function。 素材管理 API 模块。
- auth
- 认证相关的 Dioxus server function。 认证相关的 Dioxus server function 与辅助函数。
- changelog
- 更新日志(内嵌 CHANGELOG.md 渲染)的 Dioxus server function。 更新日志接口。
- code_
runner - 代码运行接口与数据结构。 代码运行接口(Code Runner)。
- comments
- 评论相关接口。 评论模块:提供评论的 CRUD、Markdown 渲染、审核状态流转与分页查询。
- csrf
- CSRF 防护中间件。 CSRF 防护:对写请求校验 Origin(回退 Referer)必须等于本站。
- database
- 数据库管理接口(运行状态 / SQL 控制台 / 导出 / 备份恢复)。 数据库管理 server functions 与 Axum 处理器。
- error
- 应用错误类型与转换。
应用错误类型与
ServerFnError转换。 - feed
- RSS 2.0 与 JSON Feed 1.1 订阅端点(server-only)。 RSS 2.0 与 JSON Feed 1.1 订阅端点。
- friends
- 友链 CRUD 与前台列表的 Dioxus server function。 友链管理:Dioxus server functions。
- health
- 健康检查端点(liveness / readiness)。 健康检查端点(liveness / readiness)。
- image
- 图片服务的 Axum 处理器。 图片服务的 Axum 处理器与处理流水线。
- katex
- KaTeX 服务端数学公式渲染(server-only)。 KaTeX 服务端数学公式渲染。
- markdown
- Markdown 渲染与 HTML 清理。 Markdown 渲染与目录生成。
- mcp_
tokens - MCP 访问令牌管理(签发 / 列表 / 重查 / 撤销)的 Dioxus server function。 MCP 访问令牌管理:Dioxus server functions。
- mhchem
- mhchem 化学公式转译器(\ce/\pu → LaTeX,server-only)。
mhchem 化学公式转译器:把
\ce{...}/\pu{...}预转译为标准 LaTeX, 再交给 katex 渲染。 - posts
- 文章 CRUD 相关接口。 文章模块:提供文章的 CRUD、列表、搜索、标签聚合与统计等 server function。
- rate_
limit - 限流工具。 基于 governor 的多级限流。
- sanitizer
- HTML 消毒器。 HTML 消毒器。
- settings
- 回收站与站点配置接口。 回收站配置接口:读取与更新自动清理设置。
- slug
- URL slug 生成与校验。 文章 slug 生成与唯一性校验。
- upload
- 图片上传的 Axum 处理器。 图片上传:web 处理器 + 共享入库流水线。
- url_
fetch - SSRF 防护的 URL 抓取(服务端按图,供 MCP upload_media 工具)。
SSRF 防护的 URL 抓取:服务端按图,供 MCP
upload_media(url)工具使用。