代码补全

1. 代码补全现在支持哪些语言？

   目前 Meituan CatPaw 的代码补全功能已支持所有主流编程语言，包括但不限于 Java、Python、C++ 等。我们的 AI 引擎会根据您的代码上下文智能提供补全建议，帮助您更高效地编写代码。

2. 代码补全功能已开启，但补全不生效，也没有任何提示，快捷键也没有反应？

   • 请检查是否安装了其他包含代码补全能力的插件，可能会导致插件之间的功能冲突。
   • 若未安装其他补全插件，可以手动触发代码补全，查看右下角是否有补全提示。如果依然有问题，您可以联系客服寻求支持。

3. 同一个位置同时显示了两个一模一样的补全提示 / 同时触发了两个补全提示

   可能是补全插件冲突导致，建议尝试禁用其他的补全插件。

侧边栏对话

1. Ask 和 Agent 模式有什么区别？

   • Ask 模式：适用于简单问答。对话时需要手动选中文件来补充上下文，针对某个文件的提问 或 不依赖于文件的提问可使用 Ask 模式。
   • Agent 模式：适用于项目问答 或 复杂任务分析。对话时不需要手动选择文件上下文，Agent 将根据需求自动检索补充上下文，针对项目维度/多文件的提问 或 复杂任务的分析可使用 Agent 模式。

2. 如何让模型不要自动修改代码？

   • 在输入框左下角选择 Ask 模式；
   • 在输入框左下角点击 add mode 添加自定义对话模式，然后把自定义模式里的 Edit 类的 Tools 关掉即可。

3. Current File 如何取消自动带入？

   单次取消选择：

   • 点击 Current File 前的图标可以取消选择。
   • 输入框中未输入内容时，可通过 Backspace 按钮逐个删除已选择的上下文文件。

   配置设置：

   • 点击 Current File 右侧的按钮可配置是否在上下文中默认带上 Current File。
   • 在 Meituan CatPaw 的配置页中也可配置是否在上下文中默认带上 Current File。

4. 发送请求后回答异常

   • 请检查网络连接是否正常，确保能够访问外部服务。
   • 请检查 Meituan CatPaw IDE 版本是否为最新版本，建议及时更新以获得最佳体验。
   • 模型可接纳 Token 数上限可能已超出，尝试发送 "hello" 测试连接是否畅通。

5. System Prompt 和 Rules 的区别是什么？

   • System Prompt：是用户个人在本地配置的，只生效于当前用户的对话中。这种配置更偏向个人偏好设置。
   • Rules：是可以跟随项目上传到云端仓库的，属于项目维度的配置，其他用户把仓库拉到本地后也可以直接对对话生效。这种配置更有利于团队协作。
   • 使用场景：System Prompt 偏向个人给模型的设定以及回复时的语言要求等；Rules 偏向于项目维度的编码规范。
   • 优先级：在给模型的 Prompt 拼接上，两者有不同的传递顺序（先传 Rules 再传 System Prompt）。

6. Codebase 和 @Docs 的区别和原理实现

   • 原理相似性：Codebase 和 @Docs 原理是类似的，都是把文档、代码进行切片存储，使用的时候会根据关键词进行搜索，为您提供精准的相关信息。
   • 主要区别：@Docs 有一个从远端抓取数据的过程，然后再在本地构建索引，而 Codebase 直接就把本地的文件构建索引，让您能够快速访问本地代码库。

7. 文件无法被 @ 引用，也无法被搜索到

   • 请检查文件是否在 .ignore 文件中被包含，如果被包含则无法在 @ 或者上下文里被搜索。
   • bin 目录下的文件不允许被 @ 引用，这是出于安全性和性能考虑。

MCP

1. MCP 连接失败或 Tools 调用失败

   建议优先查看控制台中的 MCP Log ，确认报错信息。

   
   
   • STDIO 类型的 MCP Server 如果连接失败，可以确认下本地的 Node / Python 的版本和源配置是否正确，并且这些内容发生变化后是否有重启过 Meituan CatPaw。
     推荐将完整的可执行命令（可以在 MCP Log 中查看 "Initializing STDIO transport:" 关键字后面的内容）在本地全局终端中执行测试，看能否成功，全局终端内执行成功后，再考虑在 Meituan CatPaw 内进行连接。
   • 遇到无法连接的 MCP Server，推荐配置一些同类型的 MCP Server（比如同样是 Streamable HTTP 的 Server，同样是 SSE 或者 STDIO 的 Server）来排除是否是个别 Server 的问题。

2. 终端可运行，其他验证均通过，还是用不了

   如果终端可以正常运行且其他验证都通过了，那么这通常不是 Meituan CatPaw IDE 的问题，可能是 Server 配置或用户设置方面的问题。建议您检查相关配置。

3. 哪里能看到 Meituan CatPaw 的日志？

   顶栏左上角 HELP → Toggle Developer Tools → 查看终端 Console 输出。通过日志信息，我们可以更好地了解系统运行状态。

4. Meituan CatPaw 在使用 STDIO NPX 的 Server 的时候，一直连不上。但是 Node 版本，NPM 包源以及指令都可以执行

   这种情况通常是环境缓存问题导致的，重启电脑即可解决。如果问题依然存在，请联系我们的客户服务团队。

IDE 设置相关

1. IDE 内前端预览时，页面的背景色为什么是深色，在浏览器中是白色的？

   Meituan CatPaw IDE 中前端预览的页面没有设置背景色，预览是跟随 Meituan CatPaw 主题色的。

2. 快捷键操作时报错 command 'composerMode.agent' not found

   
   

   出现这个错误通常是因为快捷键冲突导致的，请检查是否有其他插件或设置占用了相同的快捷键，修改成没有冲突的快捷键即可。

3. 如何将原 VS Code / Cursor 中的配置导入 Meituan CatPaw IDE ？

   您可以通过 "配置页" - "通用" - "导入配置" 功能一键导入原有配置，让迁移过程更加便捷。

   

4. 支持手动安装 VSIX 文件吗？

   当然支持！您只需将 VSIX 文件直接拖至插件面板即可快速安装，操作非常简单直观。

5. 支持 Jupyter Notebook 吗？

   完全支持！您可以在插件市场搜索 Jupyter 相关插件进行安装，即可享受 Jupyter Notebook 的强大功能。

6. ArkTS 语法支持高亮吗？

   支持的。请安装插件：NailyZero.vscode-naily-ets 。

   使用方法参考：https://github.com/ohosvscode/arkTS?tab=readme-ov-file#%E9%A3%9F%E7%94%A8%E6%96%B9%E6%B3%95-

7. Meituan CatPaw IDE 的左侧菜单栏怎么调整成在顶部 / 侧边展示？

   目前默认是放在顶部，如果您想要切换至侧边展示，只需在顶栏配置：外观 → 活动栏位置 → 默认。这样可以根据您的使用习惯自由调整界面布局。

   

8. 会话窗口加载不出来（侧边栏对话框黑屏或白屏无显示）

   这种问题通常出现在安装过程中。请确保在打开 .dmg 文件后，将 Meituan CatPaw 图标正确拖到 Applications 文件夹中，然后通过启动台或者直接在 Applications 文件夹中打开 Meituan CatPaw。

   

9. 如何清除缓存？

   如果您需要清除缓存来解决某些问题，可以执行命令 rm -rf ~/Library/Application\ Support/Meituan CatPaw 来完成清理。

配置

1. Codebase 索引进度卡住了，一直是 0 怎么处理？

   如果同一个仓库下文件数量超过 2 万个，系统会自动禁用索引功能。这是为了确保性能和响应速度的优化措施。

2. 哪些文件夹和文件不会被索引？

Files（以下文件后缀不会被索引）

".DS_Store", "-lock.json", ".lock", ".log", ".ttf", ".png", ".jpg", ".jpeg", ".gif", ".mp4", ".svg", ".ico", ".pdf", ".zip", ".gz", ".tar", ".dmg", ".tgz", ".rar", ".7z", ".exe", ".dll", ".obj", ".o", ".o.d", ".a", ".lib", ".so", ".dylib", ".ncb", ".sdf", ".woff", ".woff2", ".eot", ".cur", ".avi", ".mpg", ".mpeg", ".mov", ".mp3", ".mp4", ".mkv", ".mkv", ".webm", ".jar", ".onnx", ".parquet", ".pqt", ".wav", ".webp", ".db", ".sqlite", ".wasm", ".plist", ".profraw", ".gcda", ".gcno", "go.sum", ".env", ".gitignore", ".gitkeep", ".continueignore", "config.json", ".csv", ".uasset", ".pdb", "*.bin"

Folders（以下文件夹不会被索引）

".git/", ".svn/", ".vscode/", ".idea/", ".vs/", "venv/", ".venv/", "env/", ".env/", "node_modules/", "dist/", "build/", "Build/", "target/", "out/", "bin/", ".pytest_cache/", ".vscode-test/", ".continue/", "pycache/", "site-packages/", ".gradle/", ".cache/", "gems/", "vendor/"

Terminal

1. 自动打开新终端，或者打开终端但命令不执行

   方法一（推荐）：使用 git -C "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k" pull 命令，或者直接进到 Powerlevel10k 主题的安装目录执行 git pull 更新到主题的最新版本，最新版本作者进行了兼容性修复。

   方法二：配置 Shell Integration 默认使用其他可支持的 Shell 启动（打开设置 → 搜索 terminal.integrated.defaultProfile → 设置所用 OS 的默认 Shell 为其他 Shell，例如 Bash → 重启 Meituan CatPaw），但是换 Shell 可能有环境变量缺失的风险（见下图）。

   

其他

1. Meituan CatPaw 日志在哪里查看？

   您可以在最上方搜索栏中找到 Developer: Toggle Developer Tools 选项来查看日志信息。