---
title: 常见问题
sidebar_position: 1
description: 常见问题解答
---

# 常见问题

## 部署相关

### 如何修改默认端口？

修改 `.env.release` 中的端口配置。

### 如何配置 HTTPS？

建议使用反向代理（Nginx/Ingress）处理 TLS 终止。

### 数据库如何备份？

使用 PostgreSQL 标准备份工具（pg_dump）。

## 使用相关

### 如何重置管理员密码？

如果忘记管理员密码，可通过环境变量重新设置首登管理员，或直接操作数据库。

### 技能包上传失败怎么办？

检查：
1. 文件大小是否超限
2. 文件类型是否在白名单内
3. 是否包含必需的 SKILL.md
4. SKILL.md frontmatter 格式是否正确

## 开发相关

### 如何扩展 OAuth Provider？

参考现有 GitHub 实现，添加新的 OAuth Provider 配置。

### 如何自定义搜索实现？

实现 `SearchIndexService` 和 `SearchQueryService` 接口。

## 下一步

- [故障排查](./troubleshooting) - 问题诊断