Qoder CN 核心理念——上下文工程、Agent 自主性、目标闭环
为什么要读核心理念
Qoder CN 不是一堆功能按钮的堆砌——它有一套贯穿始终的设计理念。理解了这套理念，你在遇到「什么时候用 Ask、什么时候用 Agent、什么时候开 Quest」之类的问题时，就能自己做出判断，而不是死记硬背。
理念一：增强上下文工程
传统 AI 编码助手的上下文是 被动、有限、一次性 的——你粘贴一段代码，它给一段建议。Qoder 的上下文工程是 主动、丰富、持续 的：
- 代码：整个代码库的结构、依赖关系、设计模式、最近改动
- 知识：Repo Wiki 自动生成的项目文档、团队沉淀的知识卡片
- 规则：项目特定的编码规范、架构约定（
.qoder/rules目录） - 工具：代码搜索、文件读写、终端命令、Web 搜索、MCP 服务
- 运行环境：操作系统、可用命令、网络状态、权限设置
- 记忆：长期跨任务保留的偏好、约定、历史上下文
这意味着当你说「帮我重构 UserService」时，Qoder 知道这个类在哪里、被谁调用、项目用什么框架、之前重构过类似的吗、你的命名偏好是什么——而不是等你一个个告诉它。
理念二：Agent 自主性
Qoder 的 Agent 不是执行命令的脚本，而是 具备自我决策能力的智能体：
- 理解意图：不是逐字执行你的 prompt，而是理解背后的目标。比如「优化这个接口」，它会先看慢在哪里、是 SQL 查询还是算法、要不要加缓存。
- 做出决策：在多个可行方案中选一个。比如修复 bug 时，是改条件判断还是改成提前返回。
- 调用工具：自主决定什么时候读文件、什么时候跑测试、什么时候搜文档、什么时候问你澄清问题。
- 保留检查点：高风险操作（写文件、跑命令、删除）前会请求确认。你可以设置自动放行的范围，也可以逐个审批。
理念三：目标导向的闭环
Qoder 不是「单次问答」，而是 围绕目标的端到端闭环：
理解任务 → 制定计划 → 调用工具执行 → 验证结果 → 迭代修正 → 交付完成举个实际例子：你说「为用户管理模块添加批量导出 Excel 的功能」。
- 理解：Qoder 读项目结构，找到 UserController 和 Service 层，确认用什么 ORM。
- 计划：拆成 4 步——添加 service 方法、添加 controller endpoint、集成 Excel 库、写单元测试。
- 执行：依次读写文件、安装依赖、写测试。
- 验证：跑测试，检查覆盖率。
- 迭代：测试失败 → 分析原因 → 改代码 → 再跑。
- 交付：全部通过 → 总结改动 → 等你审批。
这个过程中你可以随时插话：「等一下，导出字段要加手机号」。Qoder 会把新需求排入队列，等当前步骤结束后带着完整上下文继续执行——不会从头再来。
三条理念如何落到产品形态
| 理念 | 产品体现 |
|---|---|
| 增强上下文工程 | Repo Wiki 自动生成文档、知识引擎沉淀业务知识、项目规则目录 |
| Agent 自主性 | Agent 模式 vs Ask 模式、Experts 多智能体专家团、自定义智能体 |
| 目标导向闭环 | Quest 任务看板与进度追踪、产物审查与交付、持续迭代对话 |
理解了理念之后怎么用
- 短任务 / 探索性工作：用 Editor 里的行间会话或右侧 Ask 模式——快、直接、即时反馈。
- 明确的编码目标：用右侧 Agent 模式——让 Agent 自主规划和执行，你在关键节点审批。
- 长程 / 多步骤 / 可以放手的任务：打开 Quest 视窗——让 Agent 持续推进，你专注结果审查。
- 复杂任务 / 需要多角色协作：Quest 里切 Experts 模式——多智能体分工并行。
- 非编码类桌面自动化：用 QoderWork——交付真实本地文件，迭代效率更高。