更新记录

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 数据库查询 默认禁用
mail 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)

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议