AI 编程入门
理解智能体、会话管理与工具调用，掌握用自然语言驱动 CodeMama 完成开发任务。
CodeMama Desktop 内置完整的 AI 编程引擎：你只需要用自然语言描述目标，AI 会自主完成读代码、改文件、跑命令、看结果的完整闭环。
核心概念：智能体（Agent）
应用内置 Build 智能体（默认），可读写文件、可执行命令，日常开发中无需切换，直接用自然语言描述需求即可。
如需在多个智能体间切换（例如配置了自定义智能体），可在输入框旁的选择器中选择，或用 Ctrl + . / Ctrl + Shift + . 循环切换：
提示
智能体选择器默认隐藏。在「设置 → 通用 → 显示智能体」中开启后，即可在输入框中切换智能体；隐藏时默认使用 Build 智能体。
另外内置 general 子智能体，负责复杂检索与多步骤任务，在对话中通过 @general 调用，一般无需手动使用。
第一次任务
在输入框描述需求，例如：
这个项目里登录接口的 JWT 过期时间在哪配置？帮我改成 24 小时，并补充单元测试AI 会依次：
- 检索项目代码，定位 JWT 配置
- 修改配置并补充测试
- 运行测试并汇报结果
你可以随时打断（Esc）、要求调整方案或让 AI 解释每一步做了什么。
会话与项目
- 新会话：每次任务建议开新会话，上下文更聚焦；历史会话保留在会话列表中
- 打开项目：
Ctrl+O（Windows）选择项目目录，AI 只在该目录范围内操作 - 文件树：AI 的所有文件改动实时反映在左侧文件树，可随时查看
注意
AI 修改文件前通常会在对话中说明意图并展示 diff。请留意对话中的改动确认提示，重要文件建议先提交到 Git 再让 AI 操作。
工具能力
引擎内置多种工具，按需自动调用：
- 文件编辑：读取、创建、修改、重命名、删除文件
- 终端执行：运行命令、安装依赖、执行脚本
- 代码检索：全文搜索、符号定位，快速理解大型代码库
- 浏览器：必要时打开网页验证效果
工具执行过程会在对话中流式展示，方便你随时掌握 AI 的进展。
编程技巧
需求描述三要素
好的描述包含目标、约束、验收标准：
用 Python 写一个 CLI 工具：
- 输入 CSV 文件路径与输出目录
- 按“日期”列分桶生成多个 CSV
- 输出处理统计，错误行单独记录到 error.log善用 / 命令
在输入框输入 / 可唤起内置命令，例如：
/write-novel：启动小说写作流程/agent：切换智能体（需先开启智能体选择器）
让 AI 解释与复盘
任务完成后可以追问"你改动了哪些文件？为什么这么做？"，帮助理解与复核代码质量。