---
title: "保存底部导航栏 Tab 配置"
method: PUT
path: "/settings/tab-config"
tags: ["设置"]
---

# 保存底部导航栏 Tab 配置

`PUT /settings/tab-config`

保存用户自定义的底部导航栏 Tab 配置。首页和设置固定显示（不在配置中），可选项为曲库和已启用（active）插件 Tab，总数不超过 10 个。插件已不存在的孤儿条目会在保存时被静默清理（保存即自愈）；禁用插件的条目保留但不占名额，重新启用后自动恢复。每个插件 Tab 的 entry_path 和 name 不能为空，且不能重复。show_playlists 字段仅为兼容旧配置保留（歌单已并入曲库），不参与任何展示与计数。移动端超过 5 个时自动折叠到「更多」菜单。

## Request body

- HandlersTabConfigSetting
  - `plugin_tabs` HandlersPluginTabEntry[]
    - `entry_path` string
    - `name` string
    - `plugin_id` integer
  - `show_library` boolean
  - `show_playlists` boolean

## Response `200`

保存后的 Tab 配置（孤儿条目已清理）

- HandlersTabConfigSetting
  - `plugin_tabs` HandlersPluginTabEntry[]
    - `entry_path` string
    - `name` string
    - `plugin_id` integer
  - `show_library` boolean
  - `show_playlists` boolean

## Other responses

- `400` — 请求格式错误或校验失败
- `500` — 服务器错误

---

[API](https://skmtc.dev/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.dev/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/songloft-org/songloft-api/revisions/5b1368253f6c/schema)