常见问题

本页面收集了 wescode 用户最常遇到的问题及解答。

安装问题

Q: macOS 提示"无法验证开发者"怎么办？

A: 首次打开 wescode 时，macOS 可能会阻止运行。解决方法：

1. 打开「系统设置 → 隐私与安全」
2. 在底部找到 wescode 的提示
3. 点击「仍然打开」
4. 在弹出的对话框中确认

Q: Linux 上启动报 GLIBC_2.28 not found？

A: wescode 需要较新版本的 glibc。解决方法：

• 升级你的 Linux 发行版到较新版本（Ubuntu 20.04+, Debian 10+）
• 或使用 AppImage 版本，它内置了所需的库

Q: Windows 安装后打开是空白页面？

A: 可能是 GPU 加速问题。尝试：

1. 右键 wescode 快捷方式 → 属性
2. 在目标后添加 --disable-gpu
3. 重新启动 wescode

Q: 如何在多台电脑上同步配置？

A: wescode 的配置文件位于：

• macOS: ~/Library/Application Support/wescode/
• Linux: ~/.config/wescode/

你可以通过云盘同步配置目录，或手动复制 config.yaml 和 .vscode/settings.json。

注意：API Key 等敏感信息不应通过不安全的方式同步。

Q: 能否与已有的 VSCode 共存？

A: 可以。wescode 是独立的应用程序，使用独立的数据目录（wescode/ 而非 Code/），与 VSCode 互不干扰。但它们不能同时打开同一个文件。

配置问题

Q: 如何配置多个 LLM Provider？

A: 在设置页面中可以添加多个 Provider：

1. 打开设置 → 「AI 模型配置」
2. 点击「添加 Provider」
3. 填入各个 Provider 的信息
4. 设置优先级（Provider Strategy）

支持的 Provider 类型：

Q: 如何切换模型？

A: 在 Chat 面板底部工具栏点击模型名称即可切换。你也可以设置默认模型：

{
  "wescode.chat.defaultModel": "claude-sonnet"
}

Q: WES 欠费后怎么办？

A: WES 欠费后：

1. WES 模型会显示为不可用（标记为 disabled）
2. 如果你配置了自有模型（BYOK），切换到自有模型即可继续使用
3. 只有当你选中 WES 模型时才会看到欠费提示
4. 已选自有模型时不会显示任何欠费提示，输入框正常可用
5. 前往 weisyn 平台结清欠款后 WES 模型自动恢复

Q: 如何配置 HTTP 代理？

A: 在 config.yaml 中配置：

proxy:
  http: http://proxy.example.com:8080
  https: http://proxy.example.com:8080
  no_proxy: localhost,127.0.0.1

或通过环境变量：

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080

Q: 配置文件在哪里？

A:

索引问题

Q: CKG 索引一直不完成怎么办？

A: 可能的原因和解决方法：

1. 项目过大：配置排除规则减少索引范围

   {
     "wescode.ckg.exclude": ["vendor/**", "node_modules/**"]
   }
   

2. 索引数据损坏：重建索引

   • 命令面板 → CKG: Rebuild Index

3. 磁盘空间不足：检查数据目录所在磁盘的可用空间

Q: CKG 索引结果不准确？

A: 可能的原因：

1. 索引未完成：检查状态栏是否显示「AI 就绪」
2. 文件未保存：CKG 索引基于磁盘文件，确保修改已保存
3. 语言不支持：检查你的编程语言是否在 CKG 支持列表中
4. 动态调用：通过反射、eval() 等动态调用无法被静态分析发现

Q: 索引数据占用多少磁盘空间？

A: 大约为源代码体积的 10-30%：

索引数据位于 $WESCODE_DATA_DIR/cells/ws-{hash}/index/ 目录。

Q: 如何强制重建索引？

A: 三种方式：

1. 命令面板 → CKG: Rebuild Index
2. 删除 cells/ws-{hash}/index/ 目录后重新打开工作区
3. 右键项目概览面板中的索引状态 → 「重建」

AI 回复问题

Q: AI 回复很慢？

A: 可能的原因和优化方法：

1. 网络延迟：检查到 API 服务器的网络连接
2. 模型太重：切换到更轻量的模型（如 Claude Haiku）
3. 上下文太长：新建会话减少上下文积累
4. 请求排队：同一时间只能运行一个 AI 任务

Q: AI 回复内容不相关？

A: 提升回复质量的技巧：

1. 精确引用上下文：使用 @file 和 @symbol
2. 提供背景信息：说明你在做什么、为什么
3. 分步提问：将复杂问题拆解为小步骤
4. 使用项目指令：在 AGENTS.md 中说明项目约定

Q: AI 修改了不该修改的文件？

A: 预防措施：

1. 配置 denyPaths 保护敏感文件
2. 使用 Diff 视图仔细检查每个修改
3. 逐文件 Accept/Reject，不要盲目 Accept All
4. 必要时使用 Ctrl+Z 撤销

Q: AI 生成的代码风格与项目不一致？

A: 解决方法：

1. 在 AGENTS.md 中明确说明代码风格要求
2. CKG 的 Convention 检测会自动学习项目风格
3. 在 Chat 中明确说明：「请使用与项目一致的风格」
4. 配置 .editorconfig 文件

Q: 模型选择器中看不到某些模型？

A: 检查以下几点：

1. Provider 是否正确配置且连接测试通过
2. API Key 是否有效且有对应模型的权限
3. 是否为账户欠费导致 WES 模型不可用
4. 本地模型服务（Ollama 等）是否正在运行

性能问题

Q: 编辑器响应变慢？

A: 优化步骤：

1. 关闭不需要的扩展
2. 检查是否有大型文件打开（>1MB 的文件影响 Buffer Overlay）
3. 减少 CKG 索引范围（排除 vendor 等目录）
4. 检查系统内存使用情况
5. 关闭 Ghost Write 功能减少后台 API 调用

Q: 内存使用过高？

A: wescode 典型内存使用为 500MB-1GB。如果超过 2GB：

1. 检查打开的文件数量，关闭不需要的文件
2. 减少 CKG 索引范围
3. 重启 wescode（会清理内存缓存）
4. 检查是否有大型扩展在运行

Q: CKG 索引导致 CPU 占用高？

A: 正常的首次索引会短暂占用较多 CPU。如果持续高占用：

1. 检查是否有循环修改导致反复触发增量索引
2. 增加增量索引的 debounce 时间
3. 排除频繁变更的生成文件（如 build 产物）

已知限制

功能限制

语言支持限制

CKG 对以下语言的支持程度不同：

平台限制

获取帮助

如果以上内容没有解决你的问题：

1. 查看日志：$WESCODE_DATA_DIR/logs/wescode.log 可能包含有用的错误信息
2. 重启 wescode：很多临时问题可以通过重启解决
3. 清理数据：删除 cells/ws-{hash}/ 目录可以重置工作区状态
4. 社区支持：前往 weisyn 社区论坛寻求帮助

相关文档

• 快速开始
• 性能与优化
• 个性化定制