【免费下载链接】easy-agent
Production-ready open source terminal coding agent with readable, layered code: permission rules, OS sandboxing, MCP, skills, sub-agents, and Anthropic, OpenAI-compatible, Gemini, or local models.
easy-agent(命令名eagent)是一款生产级开源终端 AI 编码代理,能读取代码、编辑文件、执行命令,并支持 Anthropic、OpenAI 兼容、Gemini 和本地模型。在终端交互界面中,输入/help即可查看它的30+ 个斜杠命令(slash commands)——这些命令覆盖了会话管理、模型切换、权限控制、MCP 插件扩展等日常协作的全部场景。本文按使用场景分组整理了一份速查手册,帮你快速上手与 easy-agent 终端编码代理的日常协作。
一、先搞懂:斜杠命令的两大类型
在 easy-agent 中,以/开头的输入会先经过一次"分类判断"(见 inputClassification.ts),被分成两类:
| 类型 | 行为 | 例子 |
|---|---|---|
| 系统命令 | 同步执行,不调用大模型,直接输出面板或提示 | /help、/cost、/model、/status |
| AI 触发命令 | 展开成一段提示词,触发一次正常的模型回合 | /init、/<技能名>、/<自定义命令> |
内置命令名是受保留的(见 builtinCommandNames.ts):即使你在~/.easy-agent/commands/下放了一个同名文件,也无法覆盖/help这类内置命令,避免它们"静默失效"。
所有命令的官方清单渲染在 builtinCommandHelp.ts 中,eagent --help和交互界面里的/help面板都读同一份数据,保证两边永远一致。
二、会话管理命令:随时掌控对话进程
这是日常使用频率最高的一组命令:
| 命令 | 作用 | 使用场景 |
|---|---|---|
/help | 显示所有可用命令 | 忘了命令时的第一选择 |
/clear | 清空当前对话历史 | 换新任务、释放上下文 |
/compact | 压缩(compact)对话上下文 | 长会话快接近上下文窗口上限时 |
/rewind [n] | 回退到之前的轮次并恢复文件 | Agent 改错了代码,一键撤销 |
/status | 查看当前会话配置快照 | 排查"为什么模型/权限不对" |
/context | 按类别可视化上下文窗口占用 | 弄清 token 花在了哪里 |
/history | 列出本项目保存的会话 | 找到之前做过的会话 |
/resume [n\|id] | 恢复并切换到已保存会话 | 隔天继续昨天的任务 |
/copy [n] | 把某条回复复制到剪贴板 | 快速搬运 AI 的回答 |
/export [file] | 把整个对话导出为 Markdown | 归档、分享、写周报 |
几个实用小技巧:
/checkpoint是/rewind的别名,/continue是/resume的别名,哪个顺口用哪个;/export导出的 Markdown 可以直接贴进文档系统,是沉淀"人机协作记录"的好方法;- 改完文件后先看
/diff(见下文),确认无误再考虑提交。
三、模型与推理强度:按需切换"马力"
不同任务对模型能力的要求差异很大,easy-agent 提供了一组命令让你随时调参:
| 命令 | 说明 |
|---|---|
/model [name\|list\|default] | 查看当前模型,或为本次会话临时切换模型 |
/mode [default\|plan\|auto] | 查看或切换权限模式;Plan Mode 是只读的,适合先规划再动手 |
/think [on\|off\|<budget>] | 控制扩展思考(extended thinking)开关与预算 |
/effort [low\|medium\|high\|max] | 设置推理强度(Anthropic 模型) |
/config [list\|get\|set] | 查看或修改设置,支持--user/--project/--local分层作用域 |
/output-style [name] | 切换回答风格(如简洁、解释型等) |
一个典型的工作流:先/mode plan让 Agent 在只读模式下规划改动 → 确认方案后切回default执行 → 复杂任务临时/model换更强的模型。所有权限分层配置的细节可参考 docs/configuration.md。
四、扩展系统管理:MCP、插件、技能与子代理
easy-agent 的可扩展性是它的核心卖点之一,对应一组管理命令:
| 命令 | 管理对象 |
|---|---|
/mcp [tools\|reconnect <n>] | 查看已连接的 MCP 服务器与工具,或重连某台服务器 |
/plugin [install\|enable\|disable\|marketplace ...] | 管理插件;/plugins是别名,/marketplace等价于/plugin marketplace |
/reload-plugins | 重载插件与扩展注册表(改完配置后必用) |
/skills [reload] | 列出已加载的技能(Skills),或重载扩展 |
/agents | 列出内置 + 自定义子代理(sub-agent)定义 |
/hooks | 展示已配置的生命周期钩子;/hook是别名 |
MCP 与钩子的完整说明分别见 docs/mcp.md 和 docs/hooks.md。
桌面应用用户注意:easy-agent 也提供桌面端,欢迎页支持"打开文件夹"或"克隆仓库"两种方式启动工作区,每个工作区独立运行一个 Agent 进程,项目级配置需要信任后才会生效:
五、权限、诊断与项目记忆:安全协作的基础
| 命令 | 作用 |
|---|---|
/permissions [allow\|deny\|remove <规则>] | 按层级管理允许/拒绝规则;/allowed-tools是别名 |
/doctor | 运行环境健康检查(依赖、剪贴板、平台能力等) |
/memory [edit <n>] | 列出/在$EDITOR中编辑 AGENT.md 与项目记忆文件 |
/diff [n] | 查看未提交的 git 变更 + 最近的 Agent 编辑记录 |
/tasks [task\|todo\|reset] | 切换任务系统,或重置任务图 |
/permissions是安全协作的核心:Agent 的每个可能改变系统的动作都会先经过允许/询问/拒绝规则、工作区信任与可选的操作系统级沙箱检查(详见 docs/sandbox-security.md)。
六、杀手锏:/init—— 让 AI 自动读懂你的仓库
/init是内置的prompt 型命令(见 builtinPromptCommands.ts):它展开成一段精心设计的提示词,运行一次真正的模型回合——Agent 会派一个 Explore 子代理快速勘察仓库(依赖清单、README、构建/测试配置、现有 AI 助手配置),然后在仓库根目录生成(或改进)一份 AGENT.md。
生成的 AGENT.md 会作为"项目记忆"注入给未来的每个会话实例,内容聚焦于:Agent猜不到的命令(非标准构建/测试脚本)、需要读多个文件才能理解的整体架构、以及现有规则文件中的重要约定。它明确排除文件清单罗列和套话式最佳实践——"每一行都必须值回票价"。
/init # 分析仓库并起草 AGENT.md /init 聚焦于 CLI # 附加的指令会被拼进提示词配合/memory手动微调、/diff审核变更,项目记忆体系就闭环了。
七、自定义斜杠命令与技能:把你的工作流变成命令
除了内置命令,你还可以创建自己的命令,输入/名字即可触发:
- 用户自定义命令:把
.md文件放进~/.easy-agent/commands/(用户级)或<项目>/.easy-agent/commands/(项目级,重名时优先)。发现与命名规则见 loadCommandsDir.ts:review.md→/review- 子目录变成命名空间:
team/review.md→/team:review - 支持 YAML frontmatter:
description(描述)、argument-hint(参数提示)、model(本回合模型覆盖)、allowed-tools(工具白名单)
- 参数占位符:命令正文是提示词模板,支持
$ARGUMENTS(完整参数)、$1$2(按位参数,从 1 开始)、$ARGUMENTS[n](从 0 开始的数组式访问),替换逻辑见 argumentSubstitution.ts - 技能(Skills):
/<技能名> [args]把技能作为一次聊天回合运行——技能是"模型可触发"的能力,自定义命令是"用户手动触发"的姊妹形态
一个典型的代码评审命令~/.easy-agent/commands/review.md的写法思路:正文写清楚评审要求(关注点、输出格式),然后/review src/main.ts即可按模板跑起来。
八、常用命令速查表(30+ 一览)
| 分组 | 命令清单 |
|---|---|
| 会话 | /help/clear/compact/rewind/checkpoint/status/context/copy/export/history/resume/continue |
| 模型与推理 | /model/mode/think/effort/config/output-style |
| 扩展系统 | /mcp/plugin/plugins/marketplace/reload-plugins/skills/agents/hooks/hook |
| 权限与安全 | /permissions/allowed-tools/doctor |
| 项目与任务 | /memory/init/diff/tasks/cost |
| 退出 | /exit/quit/bye |
💡上手建议:第一天只记
/help、/clear、/model、/mode、/rewind五个;一周后加上/init、/permissions、/export;之后把重复的工作流沉淀成自定义命令,斜杠体系就真正"为你所用"了。
写在最后
easy-agent 把"斜杠命令"做成了与终端 AI 编码代理协作的统一入口:系统命令即时响应、不消耗 token;AI 命令按需触发模型回合;自定义命令和技能则让团队工作流可以像 CLI 一样被复用和分享。完整命令实现可参考 src/commands/ 目录,分层架构的学习路径见 docs/learning-path.zh-CN.md。
【免费下载链接】easy-agent
Production-ready open source terminal coding agent with readable, layered code: permission rules, OS sandboxing, MCP, skills, sub-agents, and Anthropic, OpenAI-compatible, Gemini, or local models.
相关推荐
Routa CLI终端实战:10个常用命令带你玩转AI编码Agent自动化
Routa CLI终端实战:10个常用命令带你玩转AI编码Agent自动化 Routa CLI 是一个多智能体协调平台的命令行入口:一行 routa p "你的
10分钟玩转Zero终端TUI:快捷键与斜杠命令完全速查表
10分钟玩转Zero终端TUI:快捷键与斜杠命令完全速查表 Zero 是一款运行在本地终端的 AI 编程智能体(terminal coding agent),它
Maki斜杠命令大全:/model /tasks /memory等核心命令速查
Maki斜杠命令大全:/model /tasks /memory等核心命令速查 ! Maki AI编码智能体 https://raw.gitcode.com/g
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考