更新记录
2.0.3(2026-11-08) 下载此版本
新增 · 任务完成后在 HBuilderX 右下角弹出提示,显示用时和改动文件数 · 闲聊、翻译这类简单问题不再走智能体流程,回复更快
修复 · 请求过于频繁时的提示改得更通俗,不再出现技术细节 · 修复重试结束后输入框卡住、无法继续发送的问题 · 修复抓取网页时读不到正文、导致反复重试的问题 · 同一地址反复调用时自动叫停,避免长时间空等 · 修复部分环境下复制的内容无法粘贴到其他程序
优化 · 重试次数由 4 次调整为 3 次,减少空等
2.0.2(2026-11-06) 下载此版本
- 402 / 限流识别,自动退避重试:识别 402 与限流响应,自动执行退避重试
- 历史会话分页加载:长会话按需加载,滚动更流畅
- Checkpoint 模块:Agent 多步改动支持回滚
- 工具解析器与选择对话框:新增工具解析能力及调用选择弹窗
- 强化 Agent 权限控制与迭代限制:收紧权限边界,增加迭代次数约束
2.0.1(2026-11-02) 下载此版本
-新增功能 7 条:Design 智能体、技能系统、内置 MCP(fs/mail/weather)、Token 统计、非 Git 撤销、天气技能×2 + 授权码、决策项内联交互 -体验优化 10 条:MCP 开关/进度/错误精简、发送圆框、智能体术语、上下文档位、权限框精简+本次会话信任+长路径换行、思考区去 JSON、停止即时收尾、思考文案修正、迭代次数隐藏 -问题修复 10 条:Agent 停止推理、checkpoint 崩溃、回传 undefined、回复 JSON 排版、MCP 不回显/会话串台、HTML 污染、技能不生效、fs 越权、中文邮件/天气、其它
查看更多平台兼容性
| HbuilderX/cli最低兼容版本 |
|---|
| 3.0.0 |
deepseek、opencode、workbuddy、claude,自带git/文件/邮件/天气/ MCP 服务器,支持自定义技能与多模型,开箱即用
内置 Agent智能体 可自主读写修改代码,自带 MCP 服务器,支持自定义技能与多模型,开箱即用。
一、快速开始(3 步)
1. 打开面板
第一种方式:工具——ohmy-agent——ohmy-agent:打开面板
第二种方式:快捷键 Ctrl + Shift + C(Mac:Cmd + Shift + C),或点击右侧栏 AI 对话 图标。
2. 配置模型
命令面板搜索 插件设置(也可从对话面板内的设置入口进入)。
| 配置项 | 说明 |
|---|---|
| 配置方式 | custom-api-key(自己填 Key) |
| API 访问地址 | 各厂商的 OpenAI 兼容地址,如 https://api.deepseek.com/v1 |
| API Key | 填入你的密钥 |
| 模型 | 如 deepseek-chat |
| 是否启用流式输出 | 默认开启,逐字显示 |
内置 9 个服务商可选:DeepSeek、OpenAI、Kimi、MiniMax、智谱、通义千问、硅基流动、Ollama(本地)、自定义。
选 Ollama 时填本地地址(如
http://localhost:11434/v1),无需 Key。
3. 开始使用
输入框直接提问即可。输入 @ 切换智能体,输入 / 唤起命令面板。
二、三种智能体
输入框左下角的下拉可切换:
| 智能体 | 能力 | 适用场景 |
|---|---|---|
| plan | 只读分析,不修改任何文件 | 想先看清方案再动手 |
| build | 可读写、创建、修改文件 | 让它直接改代码 |
| design | UI/UX 设计,输出具体色值与布局 | 界面设计、配色、组件样式 |
design 要求输出具体 hex 色值、对比度 ≥4.5、热区 ≥44px,并说明深色模式如何适配——不是"建议采用简洁现代风格"这类空话。
三、@ 智能体
输入 @ 可临时指定角色(不影响模式):
@agent @ask @explain @review @debug @refactor @test @design @terminal @vscode @workspace
四、斜杠命令
输入 / 唤起。除通用命令外,design 智能体下有四个:
| 命令 | 用途 |
|---|---|
/layout |
页面布局方案 |
/style |
组件样式 |
/theme |
配色与主题 |
/review |
审视现有 UI 并指出问题 |
五、MCP 服务器(内置,无需手填命令)
命令面板搜索 MCP 服务器配置,或在插件设置内打开 MCP 页。列表中点开关即可启用,默认全部停用。
| 服务器 | 工具 | 说明 |
|---|---|---|
| fs | 10 个:fs_list fs_read fs_write fs_append fs_delete fs_move fs_copy fs_stat fs_search fs_mkdir |
文件读写。默认禁用(有写权限,建议先用只读类操作试) |
| mysql | 数据库查询 | 默认禁用 |
| SMTP 收发邮件 | 需授权码,未授权时显示「未激活」 | |
| weather | 天气查询与预报 | 需授权码 |
fs 的安全边界:所有路径强制限制在当前项目目录内,../ 逃逸一律拒绝。作用域跟随顶部选中的项目自动切换。想固定到别的目录,在编辑表单的 env 里填 FS_ROOT=绝对路径(留空即当前项目);FS_MAX_BYTES 可设单文件读取上限(默认 200000 字节)。
mail 与 weather 为增值功能,未授权时服务器仍可启动但注册 0 个工具,设置页显示「未激活」而非「连接失败」——这两件事排查方向完全不同。
六、技能系统(让 AI 遵守你的项目规范)
在项目根目录建:
.ohmy/skills/<技能名>/SKILL.md
内容格式:
---
name: 我的规范
description: 本项目 Vue 组件编写规范与提交信息格式约定
---
(正文:写你希望 AI 遵守的具体规则)
生效方式:
- 自动匹配 —— 提问时若与
description相关,自动注入,输入框上方显示「已应用技能」标签 - 手动挂载 —— 输入框的技能按钮下拉中勾选,或输入
/在技能分组里选。挂载后本次对话强制使用该技能
关键提示:
description是匹配的唯一依据,写得越具体越准。只写「规范」两个字,问什么都命中不了- 技能是项目级的,切项目会自动重载;也可放全局目录
- 匹配不上时,用手动挂载最稳妥
七、命令一览
在命令面板搜索 OhMy-Agent 即可调用(菜单 工具 → OhMy-Agent 中直接列出「打开主面板」和「检查更新」两项,其余走命令面板):
| 命令 | 用途 |
|---|---|
| 打开主面板 | 打开对话面板(Ctrl+Shift+C) |
| 选中代码带入聊天 | 编辑器内选中代码后带入对话 |
| 快速提问 Quick Chat | 轻量提问 |
| 内联对话 Inline Chat | 在编辑器内直接对话 |
| Git 自动提交 | AI 生成提交信息 |
| Git 状态查看 / Git 变更查看 | 查看仓库状态 |
| PR 代码审查 | 审查变更 |
| 批量编辑 Multi-file Edit | 跨文件批量修改 |
| 构建工作区知识索引 | 建立索引以加速检索 |
| MCP 服务器配置 | 管理 MCP 服务器 |
| 插件设置 | 配置模型与参数 |
| 远程控制(手机端) | 手机端控制 |
| 检查更新 | 检查插件更新 |
八、Token 用量统计
顶栏按钮显示今日用量(如 12.3k),点开可看:
- 今日总量、输入/输出占比
- 按模型、按来源排行
- 近 7 日柱状图
- 最近请求明细
服务端返回真实用量时用真实值;流式请求网关不返回用量时为估算值,界面上标「估」字。历史对话每轮都会重新发送,接口按每次请求的完整内容计费,所以这里记录的是全量,与实际账单一致。
九、改动审阅
底部 Git 面板可查看 AI 的所有改动:左侧变更文件列表,每个文件可 +采纳 / ↩放弃,也支持批量「采纳全部 / 放弃全部」,并可在提交说明框一键提交。
非 Git 项目也能用:未纳入版本控制的项目通过插件快照撤销,面板会提示「当前目录不是 Git 仓库,以上改动通过插件快照撤销」。
十、常见问题
Q:没有反应 / 提示 API 错误?
检查设置里的 API 地址和 Key 是否匹配(DeepSeek 官方地址是 https://api.deepseek.com/v1,注意结尾 /v1)。
Q:响应很慢或报 429?
多为限流。可关闭流式输出、减少「附带历史消息数」,或调低上下文大小档位(10k/20k)。
Q:技能没有生效?
确认文件在当前项目根的 .ohmy/skills/<名>/SKILL.md,重启插件;控制台出现 [Skills] 已加载 N 个本地技能 说明扫到了。仍不行用手动挂载。
Q:AI 返回一大段 HTML 源码,界面样式被改了?
已修复:裸 HTML 会自动包成代码块,不会再污染界面。
Q:MCP 服务器连不上?
提示分两类——配置错误(命令空、文件不存在、无权限、参数错)和服务器连接异常(超时、拒绝连接、协议不符)。连接过程每秒显示进度,不会长时间无提示。
Q:fs 服务器提示越权?
路径必须在项目目录内。检查顶部选中的是哪个项目,fs 作用域跟随项目。
十一、隐私说明
- API Key 保存在本地配置中
- 插件不采集任何数据
- 注意:工具的执行结果(文件内容、命令输出)会作为上下文发送给模型服务商。真正不出机器的只有纯本地模型(Ollama)

收藏人数:
下载插件并导入HBuilderX
下载插件ZIP
赞赏(8)
下载 10652
赞赏 8
下载 12768355
赞赏 1959
赞赏
京公网安备:11010802035340号