Qoder使用手册介绍

Qoder使用手册1.产品概述主要功能中2.快速开始注意注意：Qoder个人版目前向所有用户提供免费试用。试用期限可能会调整。最新信息请查看产品更新。2.1安装Qoder2.2登录或注册-Windows：CtrlShift,2.3打开项目-Windows：CtrlO2.4核心功能体验3.用户指南3.1智能会话概述3.2Agent模式智能体模式具备自主决策、环境感知与工具调度能力。它可利用项目搜索、文件功能描述项目级更改基于任务描述，自主拆解任务并修改多个代码文件计划制定创建分步计划供审阅自动环境感知自动检测项目框架、技术栈等信息工具使用自主使用多种内置工具命令执行自主在终端中生成并运行命令旋转圆圈：任务进行中智能体模式会根据需求自主选择并运行命令。默认情况下需要在每条命令执行前进4.查看并编辑优化后的提示3.3Ask模式智能问答使Qoder能够回答问题并帮助解决编码问题。它还可以点评、优化并3.输入问题或选中代码后点击"发送到聊天"3.4@提及上下文类型描述使用场景@file引用代码文件或规则文件查询、重构或理解模块@folder引用整个目录模块重构、测试生成、跨文件查询@attachments引用本地文件/图片支持md,pdf,docs,xlsx,xmind,jpg,png等格式@rule引用项目规则编码风格、框架约定、业务规范3.5记忆功能注意注意：当规则与记忆发生冲突时，以规则为准。3.6MCP模型上下文协议获取实时信息处理结构化/非结构化数据类型描述STDIOstdin/stdout流通信，适合本地工具SSEHTTPPOST请求，事件流响应，远程托管易用StreamableHTTP流式HTTP传输注意注意：MCP服务仅智能体模式支持，最多10个并发-连接自有服务：添加JSON配置（名{{}}}3.7规划智能体显式调用：使用/plan命令显式请求规划智能体4.启动执行：智能体读取文件、修改代码、运行命令保持每一步足够小：待办事项应能在较小diff中看清影范围说明代码库用于探索代码库的代码搜索工具文件在项目内搜索文件代码在项目内搜索特定代码片段查看项目目录结构Web无需API密钥的自由网页搜索网页内容获取网页内容功能说明修改文件修改特定代码文件查看文件显示代码文件内容功能说明运行命令在终端中执行命令获取终端输出获取先前已运行命令的输出功能说明获取代码问题查找项目中的代码问题功能描述更新记忆基于用户输入更新持久化记忆3.9模型选择模型级别Credit消耗倍率适用场景智能路由(Auto)大部分日常开发工作，建议默认使用极致(Ultimate)需要深度思考的专家级任务性能(Performance)高阶复杂任务，如核心功能实现经济(Efficient)常规开发任务，如基础代码生成轻量(Lite)免费基础研发任务，如快速验证模型名称模型简介Credit消耗倍率Qwen-Coder-Qoder-1.0基于QwenCoder深度定制的智能编码模型0.2×Qwen3.5-Plus阿里巴巴最新模型0.2×GLM-5智谱最新旗舰模型0.3×Kimi-K2.5Kimi最新模型0.3×MiniMax-M2.5MiniMax最新Agentic模型0.2×3.10浏览器智能体浏览器智能体是在智能体模式下使用浏览器完成任务的能能力描述打开与导航网页根据URL打开网页，支持多步导航任务阅读与提取信息读取页面文本，提取并总结关键信息交互与操作页面点击按钮、填写表单、滚动页面可视反馈与状态感知截图当前页面状态，感知页面加载状态显式调用：使用/browser命令/browser/browser打开https://避免让浏览器智能体输入敏感信息（密码、访问令某些复杂站点可能存在加载缓慢或元素难以识3.11上下文压缩记住"并处理的信息总量。当前Qoder支持200K上下更省：避免因无关上下文导致的Credit注意注意：上下文压缩在以下情况下会被禁用：-对话的早期阶段-AI正在生成回复时3.12NEXT行间建议预测按Tab接受建议启用NEXT单文件内的多点预测：修改变量或函数名时自动识别所有跨文件编辑预测：在其他文件中提出相关修3.13行间会话4.获取代码建议并应用3.14索引4.选择：注意注意：支持最多100,000个文件的代码库。对于少于10,000个文件的代码库，自动更新默认开启。.qoderignore中列出的文件模式示例描述config.json忽略特定文件dist/忽略整个目录*.log忽略所有.log扩展名的文件**/logs忽略任意嵌套层级中的logs目录!app/从忽略规则中排除某个路径（取反）3.15规则类型描述使用场景手动引入通过`@rule`手动应用按需工作流，自定义提示词模型决策模型在智能体模式下评估规则描述并决定何时应用场景化任务始终生效适用于所有智能会话和行间会话请求强制执行项目级标准指定文件生效适用于匹配通配符模式的所有文件语言或目录特定的规则1.将AGENTS.md文件复制到项目目录中注意注意：如果AGENTS.md内容与规则内容存在冲突，则规则内容优先。4.点击添加3.16Diff视图Dif预览格式变更级管理：在每个变更的右上角接受拒绝或接受：丢弃或应用当前文件中的所在文件之间导航：在包含待处理更改的文件间点击文件名直接跳转到该文件并显示diff3.17快捷键命令macOSWindows打开/关闭AI聊天打开通用设置打开Qoder设置打开命令面板命令macOSWindows发送消息在输入框中插入新行接受所有建议的更改拒绝所有建议的更改命令macOSWindows打开行间会话发送到会话Dif视图快捷键命令macOSWindows接受单个更改拒绝单个更改`CtrlShiftBackspace`接受文件中的所有更改拒绝文件中的所有更改`CtrlBackspace`跳转到下一个文件`CtrlShift[`跳转到上一个文件`CtrlShift]`命令macOSWindows打开Quest面板打开全局Quest窗口`CtrlAltE`自定义指令功能允许将常用提示词和工作流封特性用户级指令项目级指令作用范围当前用户所有项目当前项目及子目录存储路径`~/.qoder/commands/``<项目根目录>/.qoder/commands/`适用场景通用开发任务（代码审查、生成单元测试）项目专属任务（API规范检查）共享方式仅当前用户可通过Git共享1.打开管理界面：设置页面点击"添加"或对话框输入/后点"添加指令"2.输入唯一指令名（如gen-test）按回车4.填写完整提示词内容并保存3.19RepoWiki供准确答案。支持英文和中文，创建独立目录如repowiki/zh/和repowiki/en/。4.CLI命令行工具4.1快速上手支持的CPU架构：arm64、am注意注意：Windows(arm64)暂时不支持loginwithqoderpersonalexportQODER_PERSONAL_ACCESS_TOKEN="your_token_here"setQODER_PERSONAL_ACCESS_TOKEN="your_token_here"4.2使用CLI在项目根目录运行qodercli进入交互式模式。命令描述对话模式（默认）Bash模式`/`斜杠模式`#`记忆模式多行输入命令描述`/login`登录账号`/help`显示帮助`/init`初始化AGENTS.md`/memory`编辑记忆文件`/quest`基于Spec的任务委派`/review`代码评审`/resume`恢复会话`/clear`清除上下文`/compact`总结上下文`/usage`显示账户状态`/status`查看CLI状态`/config`显示系统配置`/agents`管理子Agent`/quit`退出TUI`/logout`退出账号命令说明示例`-w`指定工作区`qodercli-w/path``-c`继续上次会话`qodercli-c``-r`恢复指定会话`qodercli-rid``--max-turns`最大对话轮数`--max-turns=10``--yolo`跳过权限检查`--yolo`~/.qoder/settings.json${project}/.qoder/settings.json${project}/.qoder/settings.local.json{{}}使用AGENTS.md作为记忆文件：用户级别：~/.qoder/AGENTS.md项目级别：${project}/AGENTS.mdSubagent~/.qoder/agents/<name>.md：用户级${project}/agents/<name>.md：项目级4.3ACP协议跳过权限模式：等同于--yolo模式/review：审查未提交的本地代码{{}}}4.4技能(Skills)智能调用：模型根据用户请求和Skill描述自模块化设计：每个Skill专注解决特定类位置路径作用域用户级`~/.qoder/skills/{skill-name}`当前用户的所有项目项目级`.qoder/skills/{skill-name}`仅当前项目创建Skill使用Skill手动触发：输入/skill-name查看可用：询问"WhatSkillsareavailable?"5.JetBrains插件5.1插件概述功能描述代码建议理解整个项目，提供架构一致的智能建议智能问答模式集成的AI专家，提供上下文感知的答案Agent模式自主完成复杂的多步开发任务自定义配置通过项目规则和MCP进行精确定制5.2快速开始2.搜索Qoder并点击安装1.下载安装包：/1.按⌘⇧I（macOS5.3智能会话能力描述代码库感知通过智能分析项目与自然语言描述，自动理解任务的完整上下文项目级变更在整个项目范围内执行复杂的跨文件更改记忆感知持久的、基于LLM的记忆，能够随着时间学习并适应工具使用自主选择并使用强大的内置工具套件待办事项生成结构化的分步任务清单命令执行智能判定、生成并执行终端命令历史记录：完整的会话记录操作macOSWindows/Linux发送消息在输入框中换行`Shift⏎`添加上下文`@``@`将所选内容添加到聊天`CtrlAltI`接受所有建议的更改`Ctrl⏎`拒绝所有建议的更改`CtrlBackspace`5.4NEXT代码建议按Tab接受建议6.账户与计费6.1定价方案方案价格特点免费基础功能$10/月（促销价）无限代码补全Pro+$30/月（促销价）重度Agent使用Ultra$100/月（促销价）频繁长任务如Quest6.2Credits说明什么是QoderCredits？功能50K上下文窗口中位数200K上下文窗口中位数Ask~3Credits/请求~4Credits/请求Agent~7Credits/请求~12Credits/请求Quest/~100Credits/任务RepoWiki/~50Credits/仓库7.故障排除7.1常见问题如果Qoder卡在"Qoderstarti2.使用curl命令测试网络连接（a登录失败时：确保网络可访问所需域名代码不会被存储或共享。仅匿名反馈可能用于算法高资源使用可通过.qoderignore文件管理。扩展主机崩溃可能需要重新安7.2问题排查指南本文介绍如何使用Qoder诊断脚本排查启动与脚本文件：下载windows_qoderZIP压缩包：qoder-diagnosis_YYYYMMDD_HHMMSS.zip主要日志文件：Qoder_Log_YYYYMMDD_HHMMSS.txt问题类型问题解决方案网络检查代理设置查看NetworkSettings