FAQ zh CN

常见问题

English · 返回文档首页

为什么模型看不到工具？

先检查当前模型或渠道是否支持工具调用，再确认工具没有在 GrayCode 设置中被禁用。部分渠道需要显式开启工具能力；自定义 OpenAI 兼容渠道还需要正确返回工具调用字段。

如果只有某个对话异常，可新建对话重试，以排除旧上下文或渠道状态的影响。

为什么每次执行工具都要确认？

GrayCode 会根据工具风险、工作区边界和你的确认策略决定是否请求批准。你可以在设置中调整确认策略，但建议对写文件、运行命令等有副作用的操作保留必要的确认。

能访问工作区之外的文件吗？

默认情况下，文件工具围绕当前工作区工作。涉及工作区之外的路径时，GrayCode 会遵循相应的安全限制和确认流程。若任务需要读取多个项目，建议将它们加入同一个 VS Code 多根工作区。

如何一次读取多个文件？

让模型在一次 read_file 调用中传入多个目标，或先用搜索工具定位相关文件，再批量读取。这样通常比逐个文件往返更快，也更节省上下文。

上下文太长了怎么办？

• 开启或手动触发上下文压缩。
• 新建对话，并让模型先总结当前任务的关键状态。
• 只保留与当前问题有关的文件、终端输出和引用。
• 将长期约定写入提示词文件或 Memory，避免每次粘贴。

更多说明见上下文与提示词。

如何接受或拒绝文件改动？

模型写入文件后，GrayCode 会展示 diff。你可以接受、拒绝或继续让模型修改。批量改动时，建议先整体浏览，再重点检查配置、依赖、删除操作和边界条件。

为什么没有收到完成通知或提示音？

检查 GrayCode 的通知设置、VS Code 的通知权限以及系统的专注模式或勿扰模式。声音与桌面通知可能分别受扩展设置和操作系统权限控制。

渠道或模型请求失败，先检查什么？

依次确认：

1. API 地址、密钥和模型名称是否正确。
2. 当前渠道是否兼容所选模型与工具调用格式。
3. 代理、网络和服务端配额是否正常。
4. 错误是否只出现在超长上下文、图片或特定工具请求中。

仍无法解决时，请在 GitHub Issues 提交可复现步骤、错误信息和必要的环境信息；请勿附上 API 密钥或其他敏感数据。