可通过三种方法按项目逻辑重组qoder侧边栏图标:一、用quest视窗panel manager动态创建可折叠分组;二、通过.rules.yaml文件基于路径正则绑定工具集;三、用qoder cli注册并绑定自定义工具到指定逻辑域。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在使用 Qoder 时发现默认侧边栏图标按功能类型线性排列,无法匹配您当前项目的模块划分或工作流顺序,则可能是由于侧边栏未基于项目上下文进行逻辑分组。以下是实现按项目逻辑重新组织工具图标的多种方法:
一、通过 Quest 视窗的 Panel Manager 动态重排
Quest 独立视窗内置 Panel Manager 模块,支持运行时拖拽调整面板顺序,并可将工具图标按项目层级(如 domain / infrastructure / presentation)归类为可折叠分组。
1、点击 IDE 右上角 Qoder 图标 → 打开 Quest 视窗。
2、在 Quest 左侧工具栏空白处右键,选择 “新建逻辑分组”。
3、输入分组名称,例如 “订单域工具集” 或 “支付网关调试组”。
4、从右侧可用工具列表中,将 API Mock Generator、Payment Flow Debugger、Order Schema Validator 拖入该分组。
5、关闭 Quest 视窗,系统自动保存布局至当前 Workspace 的 .qoder/panel-layout.json。
二、利用 Rules 配置文件绑定项目路径与工具集
Rules 是 Qoder 的声明式配置机制,可通过 YAML 文件定义“当项目路径匹配某正则时,自动激活指定侧边栏图标组合”,实现真正意义上的项目逻辑驱动。
1、在项目根目录创建 .qoder/rules.yaml 文件。
2、写入如下内容:
rules:
- when: "src/main/java/com/example/order/.*"
代码编辑 CLI 工具集合:Cursor CLI(agent)和 Qoder CLI(qodercli),用于代码修改、重构、Code Review 及自动化代码任务。
then: ["OrderFlowSimulator", "RefundPolicyEditor", "IdempotencyChecker"]
- when: "src/main/resources/config/payment/.*"
then: ["GatewayConfigValidator", "WebhookInspector", "SignatureDebugger"]
3、保存文件后,在 IDE 中执行 Qoder → Reload Rules。
4、打开任意位于 order 包下的 Java 文件,侧边栏将仅显示对应三个图标,并按规则顺序排列。
三、调用 Qoder CLI 注册自定义工具面板
对于团队内部开发的专用工具(如数据库字段血缘分析器、微服务链路注入器),可通过 CLI 注册为侧边栏一级图标,并指定其归属的项目逻辑域,从而融入整体组织结构。
1、确保已安装 Qoder CLI 并完成认证:qoder auth login --token=xxx。
2、执行注册命令,指定逻辑域标签:
qoder tool register --name="TraceInjector" --icon="trace.svg" --domain="observability" --entrypoint="./bin/injector.sh"
3、在项目根目录下运行:qoder tool bind --domain="observability" --priority=2。
4、重启 IDE,新图标将出现在侧边栏中,且位置优先级高于默认 observability 类工具。
5、若当前项目包含 observability 目录,该图标将自动高亮显示并前置。










