DocKit 设置
DocKit 提供丰富的自定义选项以匹配您的工作习惯。从设置面板配置外观、编辑器行为和历史记录管理。
打开设置
从以下方式打开设置：
- 菜单：点击顶部工具栏的齿轮图标 (⚙️)
- 快捷键：按
Cmd+,（或Ctrl+,）
设置面板包含三个部分：主题与语言、编辑器和历史记录。
主题设置
选择 DocKit 在您系统上的外观。
| 选项 | 值 | 说明 |
|---|---|---|
| 主题 | 自动 / 深色 / 浅色 | 自动跟随系统主题偏好；深色和浅色强制指定主题 |
推荐：
自动：适合大多数用户 —— 自动匹配 macOS/Windows 深色模式设置深色：适合夜间编程浅色：适合明亮环境或文档查看
主题更改即时生效，无需重启。
语言设置
选择 DocKit 的显示语言。
| 选项 | 值 | 说明 |
|---|---|---|
| 语言 | 自动 / 英文 / 中文 | 自动检测系统语言；其他选项强制指定语言 |
当前支持：
- 英文 (
enUS) - 中文 (
zhCN— 简体中文)
语言影响：
- UI 标签和菜单
- 错误消息
- 快捷键描述
- AI 助手提示（如已启用）
编辑器设置
自定义 Monaco 编辑器（与 VS Code 同引擎）以匹配您的编码风格。
字体大小
| 选项 | 范围 | 默认值 |
|---|---|---|
| 字体大小 | 8 - 32 px | 14 px |
调整文本大小以提高可读性。较大的尺寸便于代码审查；较小的尺寸可在屏幕上显示更多代码。
字体粗细
| 选项 | 值 | 说明 |
|---|---|---|
| 字体粗细 | 正常 / 中等 / 粗体 | 控制文本厚度 |
正常：标准粗细，渲染最快中等(500)：略厚，适合长时间阅读粗体：重文本，适合演示或低对比度显示器
行号
| 选项 | 值 | 默认值 |
|---|---|---|
| 显示行号 | 开启 / 关闭 | 开启 |
切换编辑器边栏中的行号。适用于：
- 调试时的错误引用
- 代码审查讨论
- 定位特定查询部分
缩略图
| 选项 | 值 | 默认值 |
|---|---|---|
| 显示缩略图 | 开启 / 关闭 | 关闭 |
启用编辑器右侧的缩略图（代码概览）。显示：
- 整个文档结构一览
- 点击快速导航滚动
- 当前视口位置
提示：大型查询文件（100+ 行）建议启用缩略图。小型查询建议关闭以获得更简洁的 UI。
Tab 大小
| 选项 | 范围 | 默认值 |
|---|---|---|
| Tab 大小 | 2 - 8 空格 | 2 空格 |
设置缩进宽度。常见约定：
- 2 空格：JSON、JavaScript、TypeScript（默认）
- 4 空格：Python、SQL 约定
- 8 空格：遗留代码库
插入空格
| 选项 | 值 | 默认值 |
|---|---|---|
| 插入空格 | 开启 / 关闭 | 开启（使用空格） |
开启时，按 Tab 键插入空格而非制表符。关闭时，插入真正的制表符 (\t)。
建议：保持开启（空格），以确保在所有编辑器和终端中缩进一致。
历史记录设置
配置 DocKit 如何管理您的查询历史。
历史记录容量
| 选项 | 范围 | 默认值 |
|---|---|---|
| 历史记录容量 | 0 - 1000 条 | 100 条 |
设置历史记录中存储的最大查询数量：
0：禁用历史记录（不保存查询）100：默认 —— 适合大多数工作流程500-1000：重度用户或团队共享查询
历史记录存储在本地，跨会话持久保存。详见 查询历史指南。
设置存储
所有设置保存到本地文件系统：
| 平台 | 位置 |
|---|---|
| macOS | ~/Library/Application Support/DocKit/ |
| Windows | %APPDATA%/DocKit/ |
| Linux | ~/.config/DocKit/ |
设置在以下情况保持：
- 应用重启
- 版本更新
- 系统重启
重置设置
要将所有设置恢复为默认值：
- 打开设置面板
- 点击底部的 恢复默认设置
- 确认重置
此操作将恢复：
- 主题：
自动 - 语言：
自动 - 字体大小：14px
- 字体粗细：
正常 - 行号：
开启 - 缩略图：
关闭 - Tab 大小：2
- 插入空格：
开启 - 历史记录容量：100