常规设置

Sidian 提供了广泛的配置选项来定制您的开发环境。本指南涵盖了优化您开发体验的最重要设置。

访问设置

您可以通过多种方式访问 Sidian 的设置：

键盘快捷键

• Windows/Linux: Ctrl+,
• macOS: ⌘+,

菜单访问

• 文件 → 首选项 → 设置
• macOS: Sidian → 首选项 → 设置

AI 行为设置

微调 Sidian AI 功能的行为：

自动刷新模型 (Auto Refresh Models)

自动刷新可用的 AI 模型

• 默认值: true
• 类型: boolean

启用自动补全 (Enable Autocomplete)

启用 AI 驱动的代码补全

• 默认值: false
• 类型: boolean

显示行内建议 (Show Inline Suggestions)

在输入时行内显示 AI 建议

• 默认值: true
• 类型: boolean

聊天模式 (Chat Mode)

设置默认的 AI 聊天交互模式

• 默认值: agent
• 类型: string
• 选项: agent, chat

在工具中包含 Lint 错误 (Include Tool Lint Errors)

在 AI 工具的响应中包含 linting 错误

• 默认值: true
• 类型: boolean

内存设置 (Memory Settings)

配置 AI 内存和对话持久性

• 默认值: 综合内存设置对象
• 类型: object

其他 AI 设置

高级 AI 行为配置：

自动批准 (Auto Approve)

自动批准某些 AI 操作

• 默认值: { terminal: false }
• 类型: object
• 描述: 配置哪些 AI 操作会被自动批准

自动执行单元格 (Auto Execute Cell)

生成后自动执行 notebook 单元格

• 默认值: false
• 类型: boolean

自动接受 LLM 更改 (Auto Accept LLM Changes)

自动接受 AI 生成的代码更改

• 默认值: false
• 类型: boolean

外观设置

自定义 Sidian 的视觉外观：

主题设置

• 颜色主题: 选择您偏好的配色方案
  • 默认: Dark+ (默认深色)
  • 热门选项: Dark+, Light+, Monokai, Solarized Dark
• 图标主题: 选择文件和文件夹图标
  • 默认: vs-seti
  • 选项: vs-seti, vs-minimal, material-icon-theme
• 产品图标主题: 选择 UI 图标
  • 默认: Default

窗口设置

• 标题栏样式: 控制标题栏外观
  • 默认: native
  • 选项: native, custom
• 菜单栏可见性: 显示/隐藏菜单栏
  • 默认: default
  • 选项: default, visible, toggle, hidden
• 禅模式: 无干扰编辑
  • 使用 Ctrl+K Z 切换

文件和文件夹设置

配置文件处理行为：

终端设置

配置集成终端：

Shell 配置

• 默认 Shell: 选择您偏好的 shell
  • Windows: PowerShell, Command Prompt, Git Bash
  • macOS/Linux: bash, zsh, fish
• Shell 参数: 向 shell 传递参数
• 环境变量: 设置自定义环境变量

终端外观

• 字体家族: 终端字体（默认继承自编辑器）
• 字体大小: 终端文本大小
• 光标样式: 终端光标外观
  • 选项: block, line, underline

高级配置

对于高级用户，Sidian 支持 JSON 配置：

settings.json

访问原始设置文件：

1. Ctrl+Shift+P → "首选项: 打开设置 (JSON)"
2. 直接以 JSON 格式编辑设置
3. 更改会立即生效

工作区设置

为每个工作区覆盖全局设置：

1. 在您的项目中创建 .vscode/settings.json
2. 添加特定于工作区的设置
3. 这些设置将覆盖该项目的全局设置

用户设置 vs 工作区设置

• 用户设置: 全局应用于所有项目
• 工作区设置: 仅应用于当前项目
• 文件夹设置: 应用于多根工作区中的特定文件夹

设置故障排除

重置设置

要将设置重置为默认值：

1. Ctrl+Shift+P → "首选项: 打开设置 (JSON)"
2. 删除内容并保存
3. 重启 Sidian

设置未生效

• 检查 settings.json 中的语法错误
• 验证设置名称是否正确
• 如果需要，重启 Sidian
• 检查是否存在冲突的扩展

性能问题

• 减少文件监视范围
• 增加内存限制
• 禁用不必要的功能
• 检查扩展的影响

正确配置这些设置将帮助您创建一个根据您的特定需求和偏好量身定制的最佳开发环境。