设置与配置
Wesclaw 的设置页面提供外观、运行参数、Provider、Agent 等多项配置。所有设置保存在本地配置文件中，重启后自动生效。
外观设置
主题切换
- 暗色主题（默认）：深色背景，适合长时间使用
- 亮色主题：浅色背景，适合明亮环境
- 主题切换立即生效，无需重启
语言切换
- 支持 中文 和 英文 两种界面语言
- 语言切换后界面文案即时更新
运行设置
控制 AI 对话的运行参数，影响每次 Run 的行为：
| 参数 | 说明 | 默认值 |
|---|---|---|
| 任务预算（Task Budget） | 单次 Run 中 Tool 调用的上限次数 | 由引擎默认 |
| 超时时间（Timeout） | 单次 Run 的最长执行时间 | 由引擎默认 |
| 最大 Token 预估 | 单次 Run 的 Token 消耗上限预估 | 由引擎默认 |
这些参数帮助你控制 AI 的执行范围和成本，防止单次对话消耗过多资源。
Provider 设置
Provider 是 AI 模型的提供方。你可以配置多个 Provider 以使用不同的模型。
添加 Provider
- 进入 设置 → Provider
- 点击"添加"按钮
- 选择 Provider 类型（如 OpenAI、Anthropic、Azure 等）
- 填写 API Base URL 和 API Key
- 配置可用模型列表
编辑与删除
- 已添加的 Provider 可随时修改配置（Base URL、Key、模型列表）
- 删除 Provider 后，使用该 Provider 的对话将无法继续调用对应模型
安全说明
API Key 通过 AES-256-GCM 加密存储在本地，不会以明文形式出现在配置文件中。
Agent 设置
Agent 是 AI 助手的角色配置。每个 Agent 有独立的系统提示词、工具权限和技能配置。
- 创建 Agent：设定名称、头像、系统提示词
- 编辑 Agent：修改提示词、调整工具权限、绑定技能
- 删除 Agent：移除不再需要的 Agent 配置
数据目录
Wesclaw 遵循 XDG 规范存储数据，默认路径：
| 平台 | 数据目录 |
|---|---|
| macOS | ~/Library/Application Support/wesclaw/ |
| Linux | ~/.local/share/wesclaw/ |
数据目录包含引擎数据（会话、记忆、知识库）、登录凭证、日志等。
配置文件
用户可编辑的设置存储在配置目录下的 config.yaml 文件中：
| 平台 | 配置文件路径 |
|---|---|
| macOS | ~/.config/wesclaw/config.yaml |
| Linux | ~/.config/wesclaw/config.yaml |
可通过环境变量 WESCLAW_CONFIG 覆盖默认路径。配置文件不存在时使用内置默认值，首次保存设置时自动创建。