# SkinNexus 文档

> Self-hosted Minecraft skin server documentation — deploy a Go skin server with Yggdrasil external auth and migrate losslessly from blessing-skin-server.

## Table of Contents

### 契约与部署

- [SkinNexus 部署手册（Docker 优先）](/deploy.md)
- [从 blessing-skin-server 迁移（migrate 子命令手册）](/migration.md)
- [SkinNexus 构建指南](/build.md)
- [兼容矩阵 —— blessing / yggdrasil-connect 1:1 复刻进度](/compat-matrix.md)
- [SkinNexus 插件创作规范（plugin-spec）—— 宿主 v2](/plugin-spec.md)
- [扩展发布与签名市场（插件 + 主题）](/plugin-publishing.md)
- [SkinNexus 主题创作规范（theme-spec）—— 含 AI 生成提示词模板](/theme-spec.md)
- [启动器 API（Launcher API v1）](/launcher-api.md)
- [竞品源码分析](/competitor-analysis.md)
- [变更日志](/CHANGELOG.md)

### 知识手册 · 入门与架构

- [知识手册（架构与模块）](/handbook.md)
- [项目概览与快速开始](/handbook/项目概览与快速开始.md)
- [快速开始](/handbook/快速开始.md)
- [开发指南](/handbook/开发指南.md)
- [故障排除与常见问题](/handbook/故障排除与常见问题.md)
- [系统架构总览](/handbook/系统架构总览.md)
- [后端核心模块](/handbook/后端核心模块.md)
- [应用入口与外壳](/handbook/应用入口与外壳.md)
- [路由系统与 API 暴露](/handbook/路由系统与-API-暴露.md)
- [数据模型](/handbook/数据模型.md)
- [状态管理与领域模型](/handbook/状态管理与领域模型.md)

### 知识手册 · 存储与迁移

- [多引擎存储抽象模块](/handbook/多引擎存储抽象模块.md)
- [方言适配与 dbx 抽象层](/handbook/方言适配与-dbx-抽象层.md)
- [数据库与迁移](/handbook/数据库与迁移.md)
- [数据库选型与迁移](/handbook/数据库选型与迁移.md)
- [迁移系统](/handbook/迁移系统.md)

### 知识手册 · 账号与协议

- [认证与账户系统](/handbook/认证与账户系统.md)
- [本地账号与密码认证](/handbook/本地账号与密码认证.md)
- [密码与认证模块](/handbook/密码与认证模块.md)
- [账户与角色模块](/handbook/账户与角色模块.md)
- [用户管理](/handbook/用户管理.md)
- [玩家与角色管理](/handbook/玩家与角色管理.md)
- [邀请码与注册门禁](/handbook/邀请码与注册门禁.md)
- [邮箱验证门禁与通知](/handbook/邮箱验证门禁与通知.md)
- [Yggdrasil 协议实现](/handbook/Yggdrasil-协议实现.md)
- [Yggdrasil 协议 API](/handbook/Yggdrasil-协议-API.md)
- [内置 OIDC 提供者](/handbook/内置-OIDC-提供者.md)
- [OIDC 提供者模块](/handbook/OIDC-提供者模块.md)
- [OIDC 第三方登录集成](/handbook/OIDC-第三方登录集成.md)
- [启动器 Bearer API](/handbook/启动器-Bearer-API.md)
- [协议与外部集成](/handbook/协议与外部集成.md)

### 知识手册 · 材质与皮肤库

- [纹理上传与处理管线](/handbook/纹理上传与处理管线.md)
- [纹理处理与材质模块](/handbook/纹理处理与材质模块.md)
- [皮肤与材质管理](/handbook/皮肤与材质管理.md)
- [材质管理](/handbook/材质管理.md)
- [皮肤库浏览与筛选](/handbook/皮肤库浏览与筛选.md)
- [头像生成与材质元数据](/handbook/头像生成与材质元数据.md)

### 知识手册 · 插件与主题

- [插件系统](/handbook/插件系统.md)
- [插件架构与生命周期](/handbook/插件架构与生命周期.md)
- [插件管理](/handbook/插件管理.md)
- [插件开发指南](/handbook/插件开发指南.md)
- [插件 API（/api/plugins/\*/v1）](/handbook/插件-API（-api-plugins---v1）.md)
- [Manifest v2 规范](/handbook/Manifest-v2-规范.md)
- [事件总线与钩子](/handbook/事件总线与钩子.md)
- [UI 插槽与 iframe 集成](/handbook/UI-插槽与-iframe-集成.md)
- [主题系统](/handbook/主题系统.md)
- [主题市场](/handbook/主题市场.md)

### 知识手册 · API 参考

- [API 参考](/handbook/API-参考.md)
- [API 客户端封装](/handbook/API-客户端封装.md)
- [Web API（/api/v1）](/handbook/Web-API（-api-v1）.md)
- [管理 API（/api/admin）](/handbook/管理-API（-api-admin）.md)
- [公开只读 API（/api/public/v1）](/handbook/公开只读-API（-api-public-v1）.md)

### 知识手册 · 前端与面板

- [前端架构](/handbook/前端架构.md)
- [组件体系](/handbook/组件体系.md)
- [页面与路由](/handbook/页面与路由.md)
- [国际化](/handbook/国际化.md)
- [管理面板](/handbook/管理面板.md)
- [面板概览与导航](/handbook/面板概览与导航.md)
- [仪表盘](/handbook/仪表盘.md)
- [站点设置](/handbook/站点设置.md)
- [举报、通知与任务](/handbook/举报、通知与任务.md)

### 知识手册 · 运维与安全

- [部署与运维](/handbook/部署与运维.md)
- [Docker 部署](/handbook/Docker-部署.md)
- [构建与开发环境](/handbook/构建与开发环境.md)
- [二进制与源码构建](/handbook/二进制与源码构建.md)
- [环境变量参考](/handbook/环境变量参考.md)
- [反向代理配置](/handbook/反向代理配置.md)
- [备份与恢复](/handbook/备份与恢复.md)
- [备份与灾难恢复](/handbook/备份与灾难恢复.md)
- [监控与健康检查](/handbook/监控与健康检查.md)
- [性能与可扩展性](/handbook/性能与可扩展性.md)
- [安全与合规](/handbook/安全与合规.md)
- [安全模型与沙箱限制](/handbook/安全模型与沙箱限制.md)
- [审计与访问日志](/handbook/审计与访问日志.md)
- [访问日志与审计模块](/handbook/访问日志与审计模块.md)
- [出站请求安全封装](/handbook/出站请求安全封装.md)
- [测试与质量保障](/handbook/测试与质量保障.md)

### 知识手册 · 功能专题

- [UGC 文本过滤与审核举报](/handbook/UGC-文本过滤与审核举报.md)
- [后台任务模块](/handbook/后台任务模块.md)
- [邮件服务集成](/handbook/邮件服务集成.md)

### Other

- [MUA Union 成员站集成](/handbook/MUA-Union-成员站集成.md)