设置与配置

wescraft 的设置集中管理 AI 引擎、Provider、外观和安全策略。

设置入口

通过侧边栏底部的齿轮图标进入设置页，或使用快捷键 Ctrl+, / Cmd+,。

Provider 配置

BYOK（自带密钥）

个人版默认使用 BYOK 模式：

进入设置 → Provider
选择提供商（OpenAI / Anthropic / DeepSeek / ...）
填入 API Key 和 Base URL（自部署时需要）
保存后自动检测可用模型

WES 平台模型

Provider 策略

策略	说明	适用场景
`own_only`	仅使用私有 Key	个人版默认
`shared_only`	仅使用共享池	团队统一管理
`own_first`	私有优先，共享兜底	混合模式
`shared_first`	共享优先，私有兜底	企业场景

AI 引擎设置

治理模式

模式	说明	默认
标准模式	允许文件读写和命令执行	✅
锁定模式	禁止所有变更操作

合规级别

团队版可按部门设置合规级别：

标准：无特殊限制
PII 严格：启用 PII 脱敏规则
金融合规：锁定模式 + 内部网络策略

配额管理

可限制每个 Cell 的资源使用：

最大并发 Run 数
每分钟/每日 Token 限额
已安装技能数上限
MCP 连接数上限

外观设置

主题

深色模式（默认）
浅色模式
跟随系统

语言

简体中文（默认）
English

编辑器

字体大小
代码块主题
默认缩进方式

文件智能设置

关注目录

配置 FileIntelligence 监控的本地目录：

进入设置 → 文件智能
添加要监控的目录路径
支持多个目录
索引自动在后台构建

排除规则

可配置忽略的文件模式：

node_modules/
.git/
*.log
build/
dist/

数据目录

wescraft 的数据存储位置：

操作系统	默认路径
macOS	`~/Library/Application Support/wescraft/`
Linux	`~/.local/share/wescraft/`

目录结构：

$DATA_DIR/
├── hypervisor.db          # Cell 注册表
├── cells/personal/        # 个人 Cell 数据
│   ├── cell.db            # 引擎数据
│   ├── skills/            # 技能包
│   ├── knowledge/         # 知识库
│   └── fileintel/         # 文件索引
├── wescraft.db            # 应用层数据（页面、收集箱等）
└── config.yaml            # 用户配置

配置文件

config.yaml 示例：

# Provider 配置
providers:
  - name: openai
    type: openai
    base_url: https://api.openai.com/v1
    api_key_ref:
      source: inline
      value: sk-...

# 治理策略
governance:
  mode: open

# 文件智能
fileintel:
  watched_dirs:
    - ~/Documents/Work
    - ~/Projects
  exclude_patterns:
    - node_modules
    - .git

数据清理

# 清理文件索引（可安全重建）
rm -rf ~/Library/Application\ Support/wescraft/cells/personal/fileintel/

# 清理知识库索引（重新索引）
rm -rf ~/Library/Application\ Support/wescraft/cells/personal/knowledge/

# 注意：wescraft.db 包含页面和收集箱数据，请谨慎操作

导入与导出

Cell 导出

导出整个工作台数据为 tar.gz 包：

页面和 Block 内容
知识库文件
技能包
记忆数据
会话历史

Cell 导入

从导出包恢复完整的工作台环境，支持跨机器迁移。