⚙️ 设置
设置模块提供 Wegent 系统的各项配置功能，包括智能体、模型、执行器和技能的配置管理。
📋 本模块文档
| 文档 | 说明 |
|---|---|
| 智能体设置 | 配置智能体（Agent）、机器人（Bot）、提示词和协作模式 |
| 配置模型 | 配置 AI 模型（Anthropic Claude、OpenAI GPT 等） |
| 配置执行器 | 配置运行时环境（ClaudeCode、Dify、Chat） |
| 管理 Skills | 上传、管理和使用 Skills 能力扩展包 |
| 键盘快捷键 | 管理 Wework 桌面版本机快捷键 |
| 桌面应用偏好 | 配置 Wework 桌面版启动、后台运行和托盘行为 |
| 浏览器设置 | 配置内置浏览器的链接、隐私和下载行为 |
| 工作台标签页 | 配置固定标签页、启动标签页和临时普通标签页 |
🎯 核心配置
智能体设置
配置 AI 智能体的核心组件：
智能体 (Agent/Team) = 机器人(Bot) + 协作模式
机器人 (Bot) = 执行器 (Shell) + 模型 (Model) + 提示词 (Prompt) + MCP 工具 + Skills
协作模式：
- Solo：单个机器人独立工作
- Pipeline：顺序执行，形成处理流水线
- Coordinate：领导者协调并行执行，汇总结果
Web 界面当前在新建或编辑智能体时提供 Solo、Pipeline 和 Coordinate。
模型配置
支持多种 AI 模型提供商：
| 提供商 | 支持的模型 |
|---|---|
| Anthropic | Claude Haiku 4、Claude Sonnet 4、Claude Opus |
| OpenAI | GPT-4、GPT-4 Turbo、GPT-3.5 Turbo |
执行器配置
支持多种运行时环境：
| 执行器 | 说明 | 适用场景 |
|---|---|---|
| ClaudeCode | Claude Code SDK，支持代码执行和文件操作 | 代码开发、文件处理 |
| Dify | 外部 Dify API 代理 | Dify 工作流集成 |
| Chat | 直接 LLM API（无 Docker） | 轻量级对话 |
Skills 管理
Skills 是 Claude Code 的能力扩展包：
- 上传 Skills：打包为 ZIP 文件上传
- 管理 Skills：查看、下载、更新、删除
- 使用 Skills：在 Bot 中引用 Skills
OAuth Apps 管理
应用开发者可以在 设置 → 开发者凭据 → OAuth 应用 中自行创建和管理外部 OAuth Client，用于让外部系统通过 Wegent 证明当前用户身份。client_id 在页面创建成功后获得；Confidential Client 的 client_secret 只显示一次。
每个 OAuth App 需要配置应用名称、Client 类型，以及一个或多个精确匹配的 Redirect URI。Token 生命周期、TokenIssuer 和 SigningKey 都由 Provider 统一管理，不需要开发者或管理员逐个配置。
开发者只能查看和维护自己创建的 OAuth App。管理员在 管理后台 → 密钥管理 → OAuth 应用 中只负责全局查看、停用和删除。
外部 access token 只允许读取 OAuth userinfo，并且只返回用户 id、user_name 和 email；它不能调用 Wegent 业务 API，也不会授予角色、资源权限或 Git 凭据等内部权限。
切换 Client 类型、轮换 secret、禁用或删除 OAuth App 时，现有 refresh token 会失效。完整接入流程见外部 OAuth 2.0 接入指南。
已归档聊天管理
桌面版 Wework 的设置中可以查看已归档的 Project 和 Conversation 聊天。删除单个已归档聊天或执行“删除全部”时，界面会先显示确认弹窗；确认后才会永久删除对应的本地运行时会话记录。批量删除只作用于当前归档列表中的项目，不会影响未归档聊天。
OpenCode 编码会话也支持归档。归档会结束当前运行进程，但保留会话元数据，并将会话移动到 设置 → 已归档；用户可以在这里取消归档，将会话恢复到工作台，也可以永久删除记录。该操作不会删除项目工作区中的文件。
桌面应用偏好
桌面版 Wework 的“通用”设置可以控制界面语言、启动后是否显示主界面，以及关闭主窗口后是否继续在后台运行。后台运行开启时，关闭主窗口会释放主界面 WebView 资源，但不会停止正在执行的任务；用户可以单击系统托盘图标重新打开主界面。
桌面版 Wework 的“集成 → 应用快照”提供 macOS Appshots 状态和声音偏好。默认快捷键 ⌘⇧2 会截取最前面的应用窗口，并把 PNG 快照添加到当前 Wework 输入框。
Wework 上下文设置
桌面版 Wework 的左侧设置菜单将 通用、云端连接、外观、上下文、模型、代理、键盘快捷键 和 关于 归入 个人 分组。移动端设置首页保留 个人 入口，进入后可以访问通用、外观、上下文、模型和关于设置。
在 设置 → 个人 → 上下文 中可以配置两类本机上下文行为：
- 终端上下文注入：控制新任务是否自动携带当前终端上下文。
- Wework 自定义指令：保存本机的 Wework 指令内容，并影响之后启动的新任务。清空内容并保存会移除该本机指令配置。
🚀 配置流程
推荐的配置顺序：
- 配置模型 → 设置 AI 模型和 API 密钥
- 配置执行器 → 选择运行时环境
- 上传 Skills → 添加能力扩展（可选）
- 创建机器人 → 组合模型、执行器和提示词
- 创建智能体 → 组合机器人和协作模式