skillhub/document/docs/05-reference/faq.md
tww 3e2f25a42f feat(docs): initialize Docusaurus documentation website
- Initialize Docusaurus project structure
- Add Chinese documentation (all sections)
- Add English documentation (getting started section)
- Custom iFlytek blue theme styling
- Enterprise value focused homepage design
2026-03-15 18:27:32 +08:00

49 lines
1,009 B
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
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) - 问题诊断