企业官网建设流程全解析

MiniMax Code插件与Hooks机制详解：让AI编程Agent按你的规则自动干活

【免费下载链接】minimax-codeAn open-source coding agent for your terminal, powered by MiniMax.项目地址: https://gitcode.com/gh_mirrors/mi/minimax-code

MiniMax Code 是一款由 MiniMax 驱动的开源终端 AI 编程 Agent，你可以把它理解为住在你命令行里的智能工程师。而它的「插件 + Hooks」机制，相当于给这位工程师装上一套「规章制度」：在会话开始、工具调用前后、回答结束等关键时刻，自动执行你定义的脚本或规则，让 AI 真正按你的流程干活。本文面向新手，用最少的代码讲透 MiniMax Code 的插件与 Hooks 机制。

先认识 MiniMax Code：一个终端里的 AI 编程 Agent

MiniMax Code 提供交互式 TUI（终端 UI）界面，你可以直接对话让它读代码、改文件、跑测试、连浏览器。

它内置了搜索、图片理解、网页搜索等能力，同时通过插件系统支持扩展。打开 TUI 后输入/plugins（或在终端运行mcode plugin），就能打开插件管理面板，切换「全部 / 已安装 / 官方 / 本地」四个视图，安装官方市场插件或启用你自建的本地插件。完整操作说明见 docs/examples.md。

什么是 Hooks：在关键时刻注入你的规则

如果说插件是「扩展包」，那 Hooks（钩子）就是插件里的「定时任务 + 拦截器」。每当 Agent 运行到某个节点，Host 就会触发对应事件，执行你注册的命令脚本。

MiniMax Code 内置了10 个钩子事件，覆盖一次任务的全生命周期：

事件清单定义在 packages/agent-modules/plugin-hooks/src/contracts.ts。

三步写一个最简单的 Stop Hook

以「Agent 完成回答后弹出一条通知」为例，三步搞定：

1. 准备脚本：写一个脚本（如scripts/notice.cjs），向标准输出打印一个 JSON 对象即可，例如用console.log(JSON.stringify({ systemMessage: "Checks complete." }))，然后以退出码 0 结束。
2. 注册 Hook：在插件的清单文件hooks数组中引用 Hook 注册文件，例如"hooks": ["hooks/notify.json"]。注册文档长这样：

{ "hooks": { "Stop": [{ "hooks": [{ "type": "command", "command": "node \"${PLUGIN_ROOT}/scripts/notify.cjs\"", "timeout": 5 }] }] } }

3. 启用插件：在/plugins面板中按Space启用插件，通知就会在回答结束后以Hook · Stop的形式显示出来。

💡 小贴士：脚本输出除了systemMessage（仅显示给用户，不污染模型上下文），还可以返回additionalContext注入额外上下文、或decision做出 allow/deny 等决策控制，实现「自动拦截危险操作」这类高级玩法。

安全边界：Hook 永远不会失控

给 Agent 加自动化最怕「失控」，MiniMax Code 在 packages/agent-modules/plugin-hooks/src/runner.ts 中为 Hook 执行设置了多重护栏：

• ⏱️超时保护：默认 5 秒、最长 10 秒超时，超时自动终止，不阻塞主流程；
• 📦规模限制：单个插件最多 64 个可执行 Hook，脚本输出上限 64KB，输入上限 1MB；
• 🧪严格校验：注册文档经过 parser.ts 逐字段校验，非法事件名、非法匹配器都会生成诊断信息（如HOOK_SCHEMA_INVALID）而不是静默执行；
• 🔒只读插件根目录：插件包根目录不可写，Hook 的状态数据只能写入 Host 提供的专属可写目录。

这些设计保证了你的规则自动化可靠、可预期、可排查。

实际应用场景速览

Hooks 不是孤立的玩具，它和 MiniMax Code 的其他能力组合起来非常实用：

• ✅ 会话结束时自动跑 lint / 提交统计；
• ✅ 拦截rm类危险命令并弹出确认；
• ✅ 子代理任务完成后自动通知 IM 工具；
• ✅ 结合上下文压缩事件，压缩前强制保留关键文件摘要。

下面的示例演示了 MiniMax Code 在一个真实项目（口袋宠物页面）中按流程完成开发任务的过程，Hooks 正是这类流程可定制化的关键：

快速上手清单

1. 安装并构建 MiniMax Code（参考 docs/installation.md）；
2. 在本地插件目录创建插件包，写入 Hook 注册文件；
3. 打开/plugins面板启用插件；
4. 触发对应事件，验证通知与日志；
5. 阅读 docs/hooks.md 了解systemMessage的显示与上下文隔离细节，以及 packages/agent-modules/plugin-hooks/src/index.ts 查看模块对外导出的完整 API。

掌握 MiniMax Code 的插件与 Hooks 机制后，你就能把团队的规范、审批流程、自动化检查「写进」AI Agent 的运行循环里——它不再只是听懂话，而是真正按你的规则自动干活。

【免费下载链接】minimax-codeAn open-source coding agent for your terminal, powered by MiniMax.项目地址: https://gitcode.com/gh_mirrors/mi/minimax-code