必须同步清理知识库注册表、本地索引文件和connector绑定元数据三处残留，否则会持续占用空间、拖慢搜索并干扰agent理解；操作包括复制knowledge id、解绑connector并勾选删除索引、手动清除对应路径下的索引目录、再通过cli或编辑配置文件注销注册项。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake中残留的无效知识库会持续占用本地索引空间、拖慢全局搜索响应速度，甚至干扰Agent对当前项目上下文的理解精度。必须从知识库注册表、本地索引文件、Connector绑定元数据三处同步清理，缺一不可。
确认待删知识库的唯一标识
启动QoderWake → 点击左下角「知识库」图标 → 在列表中找到目标知识库 → 将鼠标悬停在条目右侧，出现「详情」按钮并点击 → 复制弹窗顶部显示的【Knowledge ID】字段值（形如kb_8a3f2e1d4c9b）。该ID是后续所有操作的唯一锚点，不可用名称替代，因为多个知识库可能重名。
解除Connector绑定并注销知识库
进入「设置」→「连接器管理」→ 找到与该知识库关联的Connector（如RepoWiki、本地文件夹、Web URL等）→ 点击右侧「解绑」→ 在确认弹窗中勾选【同时删除该知识库在本设备上的全部索引与缓存】 → 点击「执行解绑」。这一步会触发后台异步清理，但不会立即删除物理文件。
解绑完成后，返回「知识库」列表，该条目应已变为灰色且显示“已断开”。若仍显示为绿色“已连接”，说明解绑未生效，需检查Connector服务状态或重启QoderWake再试。
手动清除本地索引残留
打开文件资源管理器（Windows）/ Finder（macOS）/ 文件管理器（Linux），依次访问以下路径，删除对应Knowledge ID命名的子目录：
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
Windows：%LOCALAPPDATA%\QoderWake\index\kb_8a3f2e1d4c9b
macOS：~/Library/Caches/QoderWake/index/kb_8a3f2e1d4c9b
Linux：~/.cache/qoderwake/index/kb_8a3f2e1d4c9b
注意：路径中的kb_8a3f2e1d4c9b需替换为你实际复制的Knowledge ID。若该目录不存在，说明索引已被自动清理；若存在但为空，可直接删除整个文件夹。
清理注册表或配置项中的引用记录
方法一：通过CLI强制注销（推荐）
启动QoderWake终端 → 执行命令：qoderwake kb unregister --id kb_8a3f2e1d4c9b → 等待返回Unregistered successfully。
方法二：手动编辑配置文件
定位配置文件：
Windows：%APPDATA%\QoderWake\config\knowledge-broker.json
macOS：~/Library/Application Support/QoderWake/config/knowledge-broker.json
Linux：~/.config/QoderWake/config/knowledge-broker.json
用文本编辑器打开 → 搜索Knowledge ID → 删除其所在整行JSON对象（包括前后逗号）→ 保存文件 → 重启QoderWake。
⚠️警告：手动编辑JSON时，务必确保语法合法，缺失逗号或括号会导致QoderWake启动失败。建议编辑前先备份原文件。
