Zapmyco 内置了 AI Agent 功能，让你在终端中直接与 AI 进行交互式对话。

启动 AI 模式

zapmyco

执行后进入交互式对话界面，终端会显示对话提示符，等待输入。

交互式对话

AI 代理支持多轮对话，你可以连续提问，AI 会基于上下文进行回答。

$ zapmyco
进入 AI 对话模式
模型: deepseek-v4-flash
输入 /exit 退出，/clear 清空上下文
---

❯ 你好，请介绍一下 Zapmyco
你好！Zapmyco 是一个基于 Rust 的 AI 驱动命令行工具...

❯ 它的主要功能有哪些？
主要包括：CLI 命令工具、AI 对话模式、配置管理等...

❯ /exit

退出对话

输入 /exit 或按 Ctrl+C 退出对话模式。输入 /clear 清空对话上下文。

一次性执行模式

如果你只需要执行一个任务而不需要后续交互，可以使用 run 命令：

zapmyco run 帮我写一个 hello world 程序

一次性模式与交互模式的区别：

模式	命令	行为	内置工具
交互模式	`zapmyco`	AI 回答后继续等待输入	❌ 无
一次性模式	`zapmyco run <task>`	AI 回答后自动退出	✅ 3 个

一次性模式额外提供了 3 个内置工具：web_fetch（获取网页）、web_search（搜索网络）、shell_exec（执行命令）。交互模式下不启用这些工具。详细说明请参见内置工具。

Skill 系统集成

一次性执行模式支持加载 Skill 工作流模板，通过预定义的指令让 AI Agent 按统一标准执行任务：

通过 --skill 参数预加载 Skill：zapmyco run --skill check
Skill 文件（SKILL.md）定义执行规则、步骤和工具权限（allowed-tools）
AI Agent 加载 Skill 后自动按指令文件中的工作流执行

详细说明请参见 Skill 系统指南。

实现原理

AI Agent 模块（src/agent.rs）基于 Rust/tokio 异步运行时实现：

使用 anthropic-ai-sdk crate 调用 Anthropic Messages API
通过 tokio::io 异步读取用户输入
支持 SSE 流式解析，实时输出 AI 响应
支持 模型配置档（profile） 快速切换不同模型

配置

通过 zapmyco init 交互式向导配置：

选择 AI 供应商（DeepSeek / GLM / 自定义）
输入 API Key（支持环境变量引用 ${env.VAR}）
选择默认模型

配置存储在 ~/.zapmyco/settings.toml。

使用场景

代码辅助 — 询问代码写法、调试建议
项目咨询 — 了解项目结构和功能
日常工具 — 替代简单的 Web 搜索或文档查阅

AI 代理功能