☰
easy-agent 斜杠命令速查手册:30+个命令带你玩转终端AI编码代理
2026/10/17 21:24:09 网站建设 项目流程

【免费下载链接】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.

项目地址:https://gitcode.com/gh_mirrors/easy/easy-agent
点击查看免费下载

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.

项目地址:https://gitcode.com/gh_mirrors/easy/easy-agent
点击查看免费下载

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询