设置与故障排查
设置 管理应用级选项；管理中心 管理标签、工具和 Skill 更新。遇到问题时，先分清是哪一种操作失败。
外观、语言和应用更新
可选择浅色、深色或跟随系统主题。桌面界面支持中文、英文和韩文；本官网用户文档提供中文和英文。语言切换不会改变 Skill 文件内容。
应用更新入口位于标题栏或设置中。查看版本说明后安装，并在方便时重启。更新说明和真实下载文件见版本记录与下载页。AI 管理组件通过自己的更新入口维护。
英文界面（截图来自 v1.0.0）。
存储与缓存
中心库默认位于 ~/.skillshub。需要移动时：
- 打开设置中的存储配置。
- 选择新的中心库目录。
- 查看迁移预览及受影响的 Skills。
- 确认迁移，完成后检查技能库和工具状态。
新目录不能与现有中心库、工具目标或本地来源形成不安全的重叠。迁移失败时保留应用报告的恢复信息，不要自行清空原目录。
Git 缓存用于减少重复下载。缓存有效期决定何时重新读取远端；清理天数与立即清理用于管理占用。清理缓存不等于删除技能库，也不能修复来源中的缺失文件。
代理与凭据
应用代理设置用于外部 HTTP、OAuth、应用更新及远端 Git 操作，包括设备同步。代理关闭时，不应依赖终端环境变量或 Git 全局代理来替代应用设置。
需要 GitHub Token 或设备同步授权时，只使用对应的应用配置入口。凭据存入系统安全凭据存储；不要写进 Skill、仓库地址、截图或聊天记录。
如果授权失效，使用界面提供的重新配置入口。不要为了修复凭据而删除技能库。公共读取通常不需要凭据；遇到访问限制时，按具体错误处理。
常见问题
| 现象 | 先检查 | 下一步 |
|---|---|---|
| 工具未检测到 | 是否安装并首次运行、目录是否正确 | 打开工具管理核对；必要时添加自定义工具 |
| 目标目录已存在 | 是否为另一来源或已有独立修改 | 比较内容，使用明确的冲突处理流程 |
| Skill 没出现在 AI 工具中 | 是否仅安装到库、分发是否成功 | 检查目标与范围，再按工具要求刷新会话 |
| 原始来源找不到 | 本地目录是否移动或远端是否可访问 | 恢复来源访问；已有库内容可先查看 |
| CLI 命令找不到 | 是否完成 AI 管理启用、终端是否重开 | 使用 AI 管理中的终端修复入口 |
| 合集无法加载 | 是否联网、代理是否可用、该详情是否已缓存 | 恢复网络后重试；离线不保证能查看未缓存详情或下载来源 |
| 设备同步失败 | 仓库权限、凭据、分支、代理或冲突 | 查看设备同步中的具体失败项 |
| 操作繁忙 | 是否有桌面、CLI 或定时写操作 | 等待完成后重试，不要删除写锁 |
反馈问题
记录应用版本、操作系统、操作步骤、预期结果和实际错误。通过项目问题页反馈。
提交截图或错误信息前，移除 Token、授权码、私钥及不希望公开的路径或仓库信息。不要上传整个数据库或凭据文件。涉及合集时，附上官网合集地址和失败条目名称即可帮助定位。