设置与配置
概述
wescode 的所有配置遵循 XDG 规范，数据和配置分别存储在独立目录中。用户可以通过配置文件管理 LLM Provider、治理策略、工具配额等核心参数。
数据目录
wescode 使用统一的数据根目录（开发模式和正式构建共享）：
| 平台 | 路径 |
|---|---|
| macOS | ~/Library/Application Support/wescode/ |
| Linux | ~/.local/share/wescode/ |
| 环境变量覆盖 | WESCODE_DATA_DIR |
配置文件
配置文件位于 $XDG_CONFIG_HOME/wescode/config.yaml。首次启动时按需创建；不存在时使用默认配置。
# 示例配置片段
provider:
strategy: own_only # own_only / shared_only / own_first / shared_first
private:
- name: my-openai
type: openai
base_url: https://api.openai.com/v1
api_key_ref:
source: inline
value: sk-xxx
Provider 配置
wescode 支持三种 LLM Provider 来源：
BYOK（自带 API Key）
你自己的 API Key，数据不经过第三方：
- 直接配置 OpenAI / Anthropic / DeepSeek 等 Provider
- API Key 通过 AES-256-GCM 加密存储
- 默认策略
own_only：只使用你自己的 Key
WES 平台托管
通过 weisyn 平台统一管理的 LLM 服务：
- 使用
wes:前缀标识（如wes:openai） - 按用量计费，走平台 LLM Proxy
- 余额不足时自动降级到 BYOK Provider
组织托管
企业通过组织账户提供的 LLM 服务：
- 使用
org:前缀标识 - 组织管理员统一配置和管理
- 费用由组织账户承担
治理策略
wescode 提供四种预设的治理模式（面向用户的中文名称）：
| 模式 | 说明 | 适用场景 |
|---|---|---|
| 编程模式 | 默认模式，允许所有工具操作 | 日常开发 |
| 助手模式 | 允许工具操作，附加审计日志 | 需要操作记录 |
| 锁定模式 | 禁止变更类操作 | 只读分析、代码审查 |
| 基准模式 | 锁定 + 禁止网络访问 | 评测、安全审计 |
在设置页面选择对应模式即可，无需了解底层 Governance 配置。
工具与配额
Exec 超时
- 前台命令：默认随上下文超时
- 验证命令（build/test）：可配置独立超时
- 后台进程：不设超时，手动终止
并发与 Token 配额
- 最大并发 Run：同一时刻允许的 AI 执行任务数
- Token 配额：按分钟/天限制 Token 用量，防止意外消耗
- Task Budget：单次任务的 Token 预算上限
CycleDetector
wescode 内置循环检测器，仅检测"可证明的死循环"（完全相同操作 + 完全相同结果重复多次），而不是简单的"你跑太久了"：
- 编程场景中反复编辑同一文件是正常操作，阈值设置较高
- 首次触发：注入纠正消息，给 AI 第二次机会
- 第二次触发：询问用户"怎么办"，60 秒超时后自动终止
模型选择
wescode 要求始终显式选择模型——你必须知道"我在和哪个模型对话"：
- 发送按钮在未选择模型时禁用
- 模型列表来自 Provider 配置和平台 Catalog
- 切换模型立即生效，无需重启