Qoder CLI 核心概念与术语说明
本页汇总 Qoder CLI 文档中出现的核心概念与术语，方便快速查阅。
产品与品牌
| 术语 | 说明 |
|---|---|
| Qoder | 面向海外用户的 AI-Native CLI 品牌。 |
| Qoder CLI | 产品完整名称。 |
qodercli | 用户在终端输入的命令名。 |
通用技术术语
| 术语 | 说明 |
|---|---|
| Terminal | 终端，用户与 CLI 交互的文本界面环境。 |
| 子命令 (Subcommand) | qodercli 后跟的操作词，如 login、commit 等。 |
| 标志 (Flag) | 命令行参数，如 --model、--resume 等。 |
| 环境变量 | 通过 QODER_ 前缀的系统变量配置 CLI 行为。 |
| TUI | Text User Interface，终端中的富交互界面。 |
| Headless Mode | 无界面模式，适用于 CI/CD 等非交互环境，不弹出确认提示。 |
| Sandbox | 沙箱，隔离执行环境，限制命令的文件系统与网络访问。 |
认证
| 术语 | 说明 |
|---|---|
| Browser Login | 推荐的登录方式，通过浏览器完成 OAuth 认证。 |
| Qoder PAT | 个人访问令牌（Personal Access Token），适用于 CI/CD 或无浏览器环境。 |
模型
| 术语 | 说明 |
|---|---|
| Model Key | 模型的唯一标识，用于指定一个模型。 |
| BYOK | Bring Your Own Key，用户自备 API Key 使用自定义模型。 |
| Default Models | 默认提供的分级模型，包括 Lite / Efficient / Auto / Performance / Ultimate。 |
| Custom Models | 支持自带 API Key 的自定义模型。 |
| Thinking Efforts | 模型推理时设置的思考深度，如 low / medium / high / xhigh / max。 |
| Fast Mode | 部分模型提供的快速模式，优先提升响应速度（/fast）。 |
| Context Window | 模型一次能处理的上下文大小。 |
Agent 与会话
| 术语 | 说明 |
|---|---|
| Agent | 执行任务的 AI 助手实例。 |
| Subagent | 主 Agent 派生的独立执行单元，用于并行处理子任务。 |
| Session | 一次完整的交互会话。 |
| Memory | Agent 跨会话记住的持久化信息，保留用户偏好和项目知识。 |
| Memory File | 存储 Memory 的文件，包括用户级 ~/.qoder/AGENTS.md、项目级 AGENTS.md 与 AGENTS.local.md，以及 .qoder/rules/ 下的规则文件。 |
| Worktree | Git 工作树隔离，让 Agent 在独立分支上工作而不影响主目录。 |
| Compaction | 对话过长时自动压缩历史消息以保持在上下文窗口内。 |
| Plan Mode | 让 Agent 先制定方案、用户确认后再执行的工作模式。 |
| Goal Mode | 让 Agent 围绕指定目标持续执行的工作模式。 |
| Dynamic Workflow | 动态工作流，用 JavaScript 脚本编排多个子 Agent 的后台任务。 |
工具
| 术语 | 说明 |
|---|---|
| Tool | Agent 可调用的能力单元，如读写文件、执行命令、搜索代码。 |
| MCP | Model Context Protocol，工具扩展协议，允许接入第三方工具与服务。 |
| MCP Server | 实现 MCP 协议的服务器，支持工具查询与调用。 |
| RepoWiki | qodercli wiki 命令，用于为仓库生成结构化 Wiki 文档。 |
权限系统
| 术语 | 说明 |
|---|---|
| Workspace Directory | CLI 启动时的所在目录。 |
| Additional Directory | 通过 --add-dir 或 /add-dir 为当前会话添加的额外信任目录。 |
| Permission Mode | 权限模式，设置工具执行前的确认原则。 |
| Default Mode | 标准模式，安全读取和内部动作自动执行，敏感操作逐个确认。 |
| Auto-accept Edits Mode | 自动批准文件编辑，Shell 命令仍需确认。 |
| Auto Mode | AI 自动判断安全操作并批准。 |
| Don't Ask Mode | 拒绝所有需要确认的操作。 |
| YOLO Mode | 绕过权限，自动批准所有操作。 |
插件与扩展
| 术语 | 说明 |
|---|---|
| Plugin | 可安装的扩展包，为 CLI 添加新的 Skill、Hook 或 MCP Server。 |
| Plugin Marketplace | 插件市场，浏览和安装社区或官方发布的插件。 |
| Slash Command | 以 / 开头的会话内快捷命令。 |
| Skill | 可复用的专业能力模板，通过 /技能名 调用。 |
| 条件 Skill | 仅在特定文件路径匹配时激活的 Skill。 |
| Hook | 在特定事件发生时自动执行的自定义逻辑。 |
| Hook Type | Hook 的执行方式，支持 Shell 命令、HTTP 请求、Prompt 注入等。 |
| Hook Event | 触发 Hook 的时机，如工具执行前/后、会话开始/结束等。 |
配置文件
| 术语 | 说明 |
|---|---|
| User Settings | 用户级配置，位于 ~/.qoder/settings.json，对所有项目生效。 |
| Project Settings | 项目级配置，位于 .qoder/settings.json，随代码仓库共享。 |
| Project Local Settings | 项目本地配置，位于 .qoder/settings.local.json，仅本机生效。 |
计费与额度
| 术语 | 说明 |
|---|---|
| Credits | 计费单位。 |
| Plan | 账号当前的套餐（如 /usage 中的 Qoder Plan 与套餐额度）。 |
| Plan Tier | 订阅层级：Community、Pro、Teams。 |
| Quota | 额度配额，包含已用/剩余/总量。 |
| Price Factor | 不同模型消耗 Credits 的倍率。 |
| Add-on Credits | 附加额度包，套餐额度之外单独购买的 Credits。 |
| Org Resource Package | 组织资源包，团队/组织统一分配的额度资源。 |
集成相关
| 术语 | 说明 |
|---|---|
| ACP | Agent Client Protocol，CLI 与 IDE 之间的通信协议。 |
| SDK | Software Development Kit，CLI 提供的开发库，支持三方集成。 |
| Cloud Mode | --remote 云端执行模式，任务托管在云端虚拟机中运行。 |
| Remote Control | 通过手机 / Web 实时掌控本地运行的 Agent，在关键节点远程决策。 |
下一步
- 核心概念详解：任务执行原理。
- 全部配置项：配置项、环境变量与文件路径。