WorkBuddy补全失效时，需依次检查语言服务器进程状态、禁用冲突插件、重置语言绑定与文件关联、清除插件缓存并重载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在编辑器中输入代码时，WorkBuddy未自动弹出补全建议或按快捷键无响应，则可能是语言服务未就绪、插件加载失败或与其他扩展存在冲突。以下是解决此问题的步骤：
一、验证WorkBuddy语言服务器进程状态
WorkBuddy代码补全依赖独立运行的语言服务器（LSP）进程提供语义分析与建议生成能力。若该进程未启动、崩溃或端口被占用，补全功能将完全失效。
1、打开终端，执行ps aux | grep workbuddy-lsp（macOS/Linux）或 tasklist | findstr workbuddy-lsp（Windows）确认进程是否存在。
2、若未查到进程，进入WorkBuddy安装目录下的lsp子目录，手动运行./workbuddy-lsp --port=43210（macOS/Linux）或 workbuddy-lsp.exe --port=43210（Windows）。
3、在编辑器设置中检查LSP连接地址是否为http://127.0.0.1:43210，且协议类型为“HTTP”而非“HTTPS”或“WS”。
4、若端口被占用，修改启动参数为--port=43211，并同步更新编辑器插件配置中的端口号。
二、禁用可能冲突的第三方语言类插件
部分AI编程助手（如Tabnine、CodeWhisperer、GitHub Copilot）或语法高亮增强工具（如Better Comments、Error Lens）会劫持LSP通信通道或覆盖代码提示触发逻辑，导致WorkBuddy补全被静默屏蔽。
1、在VS Code中按下Ctrl+Shift+P（Windows）或Cmd+Shift+P（macOS），输入“Extensions: Show Enabled Extensions”并回车。
2、依次禁用名称含“AI”“Copilot”“Whisper”“Tabnine”“IntelliCode”的扩展，逐一重启编辑器测试补全是否恢复。
3、对保留启用的插件，在设置中搜索“editor.suggest.showMethods”等通用提示开关，确保其值为true且未被其他插件强制覆盖。
4、若使用JetBrains系列IDE，进入Settings → Plugins，临时停用“Code With Me”“Rainbow Brackets”及所有非官方LSP客户端插件。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、重置编辑器语言绑定与文件关联
WorkBuddy补全仅对明确声明支持的语言ID生效。若当前文件未被识别为对应语言（如.py文件被误判为Plain Text），或语言绑定被用户自定义规则覆盖，补全将不会触发。
1、在编辑器中打开目标代码文件，右下角查看当前语言标识（如Python、JavaScript），点击该标识。
2、选择“Configure File Association for '.py'”，在弹出菜单中确认已选中“Python”而非“Plain Text”或“Auto”。
3、进入设置搜索“workbuddy.languages”，检查列表中是否包含当前文件类型；若缺失，手动添加如"python", "typescript", "java"等标准语言ID。
4、对自定义语言（如.vue、.astro），需在settings.json中显式配置"workbuddy.languageMappings": {"vue": "html", "astro": "typescript"}。
四、清除插件缓存并强制重载语言服务
插件首次加载后会缓存语言模型元数据与语法树解析器实例，若缓存损坏或版本不匹配，可能导致补全引擎初始化失败，但界面无报错提示。
1、关闭编辑器，定位插件缓存路径：VS Code为~/.vscode/extensions/tencent.workbuddy-*/out/lsp-cache/（macOS/Linux）或 %USERPROFILE%\.vscode\extensions\tencent.workbuddy-*/out/lsp-cache/（Windows）。
2、删除整个lsp-cache文件夹及其内所有子项，保留out目录结构。
3、重新打开编辑器，在命令面板中执行“Developer: Reload Window”，等待底部状态栏出现WorkBuddy LSP connected提示。
4、新建一个空白.py文件，输入def test():后换行并键入return，观察是否触发函数签名补全。
