个性化定制

Wesclaw 提供丰富的个性化设置，让你根据个人习惯和喜好调整使用体验。

主题设置

深色 / 浅色模式

Wesclaw 支持深色和浅色两种主题模式。

设置 → 外观 → 主题模式
  ○ 浅色模式
  ● 深色模式（默认）
  ○ 跟随系统

选择「跟随系统」后，Wesclaw 会自动根据操作系统的显示模式切换主题。

品牌色

不同的 Wesclaw 产品使用不同的品牌色：

产品	品牌色	说明
Wesclaw 默认	蓝色	标准个人助手
与 wescode 集成	VS Code 蓝	编程工具风格

品牌色会影响按钮、链接、高亮等视觉元素的颜色。

字体设置

设置 → 外观 → 字体
  正文字体：Noto Sans SC（默认）
  代码字体：Menlo / Consolas
  字体大小：14px（可调范围 12-20px）

界面布局

侧边栏

侧边栏是 Wesclaw 的主要导航区域，可以自定义显示内容。

设置 → 布局 → 侧边栏
  ☑ 显示对话列表
  ☑ 显示 Agent 列表
  ☑ 显示收藏
  ☐ 显示技能列表
  ☐ 显示最近文件

侧边栏位置：
  ● 左侧
  ○ 右侧

侧边栏宽度：240px（可拖动调整）

对话区域

设置 → 布局 → 对话区域
  消息宽度：
    ○ 窄（适合阅读）
    ● 中等（默认）
    ○ 宽（充分利用屏幕）

  代码块：
    ☑ 显示行号
    ☑ 启用语法高亮
    ☑ 显示复制按钮

  消息时间：
    ○ 不显示
    ● 悬浮显示
    ○ 始终显示

输入区域

设置 → 布局 → 输入区域
  输入框高度：
    ○ 单行（回车发送，Shift+回车换行）
    ● 多行（默认 3 行，可拖动调整）

  附件区域：
    ● 输入框内顶部
    ○ 输入框上方独立区域

  工具栏：
    ☑ 显示附件按钮
    ☑ 显示 @ 上下文按钮
    ☑ 显示模型选择器
    ☑ 显示发送按钮

快捷操作

全局快捷键

功能	macOS	Windows/Linux
打开/唤醒 Wesclaw	`Cmd + Shift + Space`	`Ctrl + Shift + Space`
新建对话	`Cmd + N`	`Ctrl + N`
搜索对话	`Cmd + K`	`Ctrl + K`
关闭当前对话	`Cmd + W`	`Ctrl + W`

对话快捷键

功能	macOS	Windows/Linux
发送消息	`Enter` 或 `Cmd + Enter`	`Enter` 或 `Ctrl + Enter`
换行	`Shift + Enter`	`Shift + Enter`
停止生成	`Escape`	`Escape`
清除输入	`Cmd + Backspace`	`Ctrl + Backspace`
上一条消息	`↑`（输入框空时）	`↑`（输入框空时）

自定义快捷键

设置 → 快捷键

可以修改以下操作的快捷键：
- 唤醒/隐藏窗口
- 新建对话
- 搜索
- 切换 Agent
- 打开设置
- 切换侧边栏

快速操作

通过 / 斜杠命令快速执行常用操作：

/new         新建对话
/clear       清除当前对话
/agents      查看可用 Agent
/skills      管理技能
/settings    打开设置
/help        查看帮助

显示选项

AI 回复显示

设置 → 显示 → AI 回复
  流式输出：
    ● 逐字显示（打字机效果）
    ○ 整段显示（等待完成后一次性显示）

  Thinking 过程：
    ○ 不显示
    ● 折叠显示（可展开查看）
    ○ 完整显示

  工具调用：
    ○ 不显示
    ● 折叠显示
    ○ 详细显示（包含输入输出参数）

消息气泡

设置 → 显示 → 消息气泡
  用户消息样式：
    ● 右对齐气泡
    ○ 左对齐无气泡

  AI 消息样式：
    ● 左对齐无气泡
    ○ 左对齐气泡

  头像显示：
    ☑ 显示用户头像
    ☑ 显示 AI 头像

Markdown 渲染

AI 回复中的 Markdown 内容渲染规则：

设置 → 显示 → Markdown
  ☑ 渲染标题（但不增大字号，保持对话一致性）
  ☑ 渲染列表
  ☑ 渲染表格
  ☑ 渲染代码块（语法高亮）
  ☑ 渲染链接（可点击）
  ☑ 渲染图片（内联显示）
  ☑ 渲染数学公式（LaTeX）

通知设置

设置 → 显示 → 通知
  桌面通知：
    ☑ AI 完成长时间任务时通知
    ☑ 定时任务执行结果通知
    ☑ IM 渠道新消息通知
    ☐ 每条 AI 回复都通知

  声音提示：
    ☐ 启用声音提示

语言设置

界面语言

设置 → 语言 → 界面语言
  ● 简体中文
  ○ English

切换界面语言后，所有菜单、按钮、提示文字会相应变更。

AI 回复语言

AI 回复的语言可以通过以下方式控制：

方法一：在对话中指定

请用英文回答以下问题：What is AI?

方法二：通过记忆设定默认

记住：我希望你默认用中文回复，除非我特别要求用其他语言

方法三：Agent 级别设定

在 Agent 的系统提示词中指定回复语言。

本地化设置

设置 → 语言 → 本地化
  时区：Asia/Shanghai（自动检测）
  日期格式：YYYY-MM-DD
  时间格式：24 小时制
  数字格式：1,234.56

模型设置

默认模型选择

设置 → 模型 → 默认模型
  选择你的默认 AI 模型

  模型列表会显示所有已配置的 Provider 中可用的模型。
  不同模型在能力、速度、成本上有差异。

模型参数

设置 → 模型 → 高级参数
  Temperature：0.7（创造性程度，0-2）
  Max Tokens：4096（单次回复最大长度）
  Thinking Level：normal / high（推理深度）

模型切换

在对话中可以随时切换模型：

点击输入框上方的模型选择器
或使用快捷键切换

注意：切换模型会在下一轮对话生效，不影响当前正在生成的回复。

进阶定制

系统提示词

可以自定义 AI 助手的基础行为：

设置 → Agent → 编辑默认 Agent → 系统提示词

示例：
你是一个专注于技术领域的 AI 助手。
你的回答风格简洁、专业、重视实操性。
默认使用简体中文回复。
代码示例优先使用 Go 语言。

自定义 Agent

创建专属的 Agent，针对不同场景定制：

设置 → Agent → 新建 Agent

名称：合同审查助手
系统提示词：你是一个专业的法律顾问...
默认模型：选择能力最强的模型
关联技能：合同审查、法律条文
知识库：公司合同模板库

工作区配置

设置 → 工作区
  默认工作目录：~/workspace
  项目目录：~/Projects

配置文件

配置文件位置

macOS:   ~/.config/wesclaw/config.yaml
Linux:   ~/.config/wesclaw/config.yaml
Windows: %APPDATA%\wesclaw\config.yaml

手动编辑配置

高级用户可以直接编辑 config.yaml 文件：

# 示例配置
display:
  theme: dark
  font_size: 14
  sidebar_width: 240

model:
  default_provider: "openai"
  default_model: "gpt-4o"
  temperature: 0.7

修改配置文件后需要重启 Wesclaw 生效。

重置设置

重置单项设置

在对应的设置页面点击「恢复默认」按钮。

重置全部设置

设置 → 高级 → 重置所有设置

⚠️ 此操作会将所有设置恢复为默认值，不会删除对话记录和数据。

完全重置

如果需要完全重置 Wesclaw（相当于全新安装）：

关闭 Wesclaw
删除数据目录
重新启动 Wesclaw

⚠️ 完全重置会删除所有数据，包括对话记录、记忆、配置等。请先备份重要数据。