Chat 面板使用指南
Chat 面板是 wescode 的核心交互界面，你可以通过自然语言与 AI 对话，完成代码生成、问题解答、重构建议等任务。
打开 Chat 面板
有多种方式打开 Chat 面板：
| 方式 | 操作 |
|---|---|
| 快捷键 | Ctrl+L（macOS: Cmd+L） |
| 活动栏 | 点击左侧活动栏的 AI 图标 |
| 命令面板 | Ctrl+Shift+P → 输入「Chat」 |
Chat 面板默认显示在编辑器右侧。你可以拖拽它到任意位置，也可以通过面板标题栏的按钮将其最大化或最小化。
消息交互
发送消息
在底部输入框中输入你的问题或指令，然后按 Enter 发送。AI 会以流式方式实时输出回复。
消息类型
AI 回复中可能包含以下类型的内容块：
| 内容类型 | 说明 |
|---|---|
| 文本 | 普通回答和解释 |
| 代码块 | 语法高亮的代码片段 |
| 工具调用 | AI 执行的操作（读文件、搜索、编辑等） |
| Plan 面板 | 多步任务的执行计划 |
| Diff 预览 | 代码修改的差异对比 |
| 错误信息 | 执行中遇到的问题 |
中断生成
当 AI 正在生成回复时，你可以：
- 点击输入框旁的「停止」按钮
- 按
Escape键
中断后 AI 会保存已生成的内容，你可以继续对话。
重试
如果对 AI 的回复不满意，可以点击消息旁的「重试」按钮，AI 会重新生成回复。
上下文引用
wescode 的 Chat 支持丰富的上下文引用，帮助 AI 更好地理解你的需求。
@file — 引用文件
在输入框中输入 @ 后跟文件名，会弹出文件选择器：
@main.go 这个文件里的 handleRequest 函数有什么问题？
@symbol — 引用符号
引用函数、类、变量等代码符号：
@handleRequest 帮我给这个函数添加超时控制
@folder — 引用目录
引用整个目录作为上下文：
@internal/auth/ 这个包的认证逻辑是怎么工作的？
自动上下文
除了手动引用，wescode 会自动注入以下上下文：
- 当前打开的文件：编辑器中正在查看的文件
- 光标位置：当前光标所在的函数/类
- CKG 片段：与你的问题相关的代码知识图谱信息
- 编辑器 Buffer：文件的最新内存内容（即使未保存）
状态栏下方的「上下文快照条」（ContextSnapshotBar）会显示 AI 实际使用的上下文片段，帮助你了解 AI "看到了"什么。
模型选择
切换模型
在 Chat 面板底部工具栏可以看到当前使用的模型。点击模型名称打开模型选择器：
- WES 平台模型：由 weisyn 云端提供，标有
WES标签 - 自有模型（BYOK）：你自己配置的 API Key 对应的模型
- 本地模型：通过 Ollama 等工具本地部署的模型
模型推荐
| 场景 | 推荐模型 |
|---|---|
| 日常编码辅助 | Claude Sonnet / GPT-4o |
| 复杂架构设计 | Claude Opus / o1 |
| 快速补全 | Claude Haiku / GPT-4o mini |
| 代码审查 | Claude Sonnet |
欠费处理
如果 WES 平台余额不足：
- WES 模型会显示为不可用（灰色）
- 如果你配置了 BYOK 模型，可以切换到自有模型继续使用
- 欠费提示仅在选中 WES 模型时显示
对话历史管理
会话列表
每次打开 Chat 面板都会创建一个新会话。你可以在面板顶部查看和切换历史会话：
- 点击面板标题栏的会话标题
- 在下拉列表中选择历史会话
- 或点击
+创建新会话
会话与工作区
会话数据绑定到当前工作区（Cell）：
- 切换工作区后，会话列表会更新为新工作区的历史
- 不同工作区的会话是完全隔离的
- 关闭工作区后，会话数据会保留在磁盘上
跨工作区会话
如果你在当前工作区看到了来自其他工作区的历史会话（例如通过搜索），会话标签上会显示工作区名称徽标，帮助你区分来源。
清除历史
你可以在设置中清除当前工作区的所有会话历史。注意：此操作不可恢复。
高级用法
Plan 模式
对于复杂的多步任务，AI 会自动创建一个执行计划（Plan）：
帮我重构 internal/auth 包：
1. 将认证逻辑从 handler 中分离
2. 创建 AuthService 接口
3. 实现 JWT 和 Session 两种认证方式
4. 为每种方式编写单元测试
Plan 面板会显示每一步的状态（待执行 / 进行中 / 已完成），你可以实时跟踪进度。
委派任务
在对话中，AI 可以将子任务委派给专门的子 Agent：
- 子 Agent 有自己独立的执行上下文
- 执行结果会汇总回主对话
- 你可以在 Chat 面板中看到委派过程
使用技能（Skills）
wescode 预装了 26 个编程技能，涵盖代码审查、测试工程、性能优化等场景。技能会自动在适当的场景下激活，增强 AI 的专业能力。
常用对话模板
代码解释
解释一下 @processOrder 这个函数的逻辑
代码生成
在 @handlers/ 目录下创建一个新的 REST API handler，
处理用户注册请求，包含参数验证和错误处理
代码审查
审查 @internal/payment/ 这个包的代码，
关注安全性和错误处理
Bug 修复
@error.log 中第 42 行的 nil pointer 错误是什么原因？
帮我修复它
重构建议
@legacy/utils.go 这个文件太大了（1200 行），
帮我拆分成更合理的模块结构
注意事项
- 上下文窗口有限：每个模型有最大上下文长度限制，过长的对话可能导致早期信息被压缩
- 编辑器 Buffer 优先：AI 读取文件时优先使用编辑器内存中的内容，即使你尚未保存
- 一次一个 Run：同一工作区同时只能运行一个 AI 任务，如果正在生成中需要等待完成或中断
- 隐私：你的代码会发送到选定的模型服务提供商，请确保使用符合你安全要求的 Provider