必须完成登录、开启开关、索引项目三步，否则AI不会主动补全；需确认插件启用、阿里云账号登录成功并显示绿色Online标识，手动启用自动补全开关，等待项目上下文索引完成，再用⌥+P（macOS）或Alt+P（Windows）触发补全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在Qoder中写到一半的函数、类或配置片段，光标停在行尾却没看到补全提示——这不是AI失灵，而是触发机制未激活或上下文未就绪。必须完成登录、开启开关、索引项目三步，否则哪怕代码写得再完整，AI也不会主动补全。
确认Qoder插件已启用并完成阿里云账号登录
未登录状态下，所有AI补全功能（包括行级、方法级）均被强制禁用，状态栏不显示Online标识即代表未生效。
VS Code用户：打开「设置」→「扩展」→ 搜索“Qoder CN” → 确认状态为「已启用」；若未安装，点击「Install」后【必须重启IDE】。
JetBrains用户：点击「File」→「Settings」→「Plugins」→ 搜索“Qoder” → 安装后同样需重启IDE。
重启完成后，在编辑器右下角状态栏找到Qoder图标，点击并选择「Login with Alibaba Cloud」→ 在浏览器中完成授权 → 返回IDE，状态栏出现绿色Online标识才算真正就绪。
手动开启自动补全主控开关
即使登录成功，Qoder默认关闭自动补全，需人工启用并调优参数。
VS Code：打开「Settings」→ 搜索“qoder auto completion” → 勾选Enable Auto Complete。
JetBrains：进入「Settings」→「Tools」→「Qoder」→「Code Completion」→ 同样勾选Enable Auto Complete。
设置AI suggestion triggers after typing为【3】（推荐值），避免输入1个字母就弹出干扰建议；同时启用Enable stream option和Enable Multiline Completion，否则跨行逻辑无法生成。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
等待项目上下文完成索引
Qoder补全质量取决于它是否理解你整个项目的结构。首次打开项目时，它会自动扫描源码、依赖、配置文件，构建本地知识图谱。
第一步：确保当前已打开完整项目根目录（而非单个文件），否则索引范围仅限该文件。
第二步：观察状态栏，若显示“Indexing project context…”则正在处理，耗时通常为30～90秒。
第三步：索引未完成前强行触发补全，AI只能基于当前文件做浅层猜测，结果常脱离实际API约束或编码风格。
第四步：索引完成后，状态栏不再显示进度文字，此时任意位置键入代码片段或自然语言描述（如“# 读取config.yaml并返回dict”），即可准备触发。
用快捷键触发行级/方法级补全
补全不是自动弹窗，必须主动唤醒。光标置于待补全位置后，按对应快捷键：
macOS：⌥ + P
Windows：Alt + P
触发后，编辑器将以半透明斜体显示「幽灵文字」预览。接受整段建议按Tab；想逐词确认，macOS按⌘ + →、Windows按Ctrl + →；不需要直接按Esc放弃。
