更新记录

1.9.3(2026-06-06) 下载此版本

模型配置改进

  • 配置字段 type 统一更名为 provider,原有配置自动迁移,无需手动修改
  • 模型下拉列表按提供商分组(DeepSeek / OpenAI / 硅基流动 / 通义千问 等),同名模型不再混淆
  • 模型管理弹窗新增提供商标签,开关按钮改为方形 UI / 交互优化
  • 右键菜单所有 OhMy-Agent 命令归入同一组,整洁有序
  • 底部模型按钮只显示模型名,简洁明了
  • 下拉列表与 JSON 配置实时同步,厂商信息始终准确

1.9.2(2026-06-03) 下载此版本

移动端伴随端:WebSocket 远程控制服务,手机浏览器扫码连接,实时同步会话、发送消息、处理权限确认 Build 模式自动写入:AI 回复中的代码块自动提取并直接写入文件,移除接受/拒绝流程 Plan 模式升级为真实 Agent:接入 agentLoop,使用 11 个只读工具(search_code、grep_content、read_file 等)进行项目分析 撤销增强:用户气泡的撤销按钮将消息内容放回输入框;/undo 命令实际执行 git checkout 或快照恢复 远程控制模态框:点击「

1.9.1(2026-06-02) 下载此版本

v1.9.1 更新日志 Build 模式重构:不再依赖 AI 工具调用,改为提取回复中的代码块,气泡内展示 diff + 接受/拒绝按钮 Git 功能:新增自动提交、状态查看、变更查看命令;拒绝回滚执行 git checkout 非 Git 项目:文件快照对比,无需 Git 也能显示 diff edit_file 支持行号替换:可按 startLine/endLine 替换,无需原文精确匹配 MCP 集成:支持 MySQL 数据库 MCP 服务器 混淆构建:新增 npm run build / npm run release 脚本 修复:URL 前缀、模块路径、MCP 注册、API 格式兼容等问题

查看更多

平台兼容性

HbuilderX/cli最低兼容版本
5.0.1

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后,卸载时需手动卸载,详细教程参考:如何手动卸载插件


OhMy-Agent - AI 大模型编程助手

HBuilderX 插件,集成主流 AI 大模型,提供智能对话、代码生成、补全、审查、注释、Build 智能体等全栈编程辅助能力。

功能特性

智能对话

  • 支持多轮会话,保留上下文历史
  • 流式输出,实时显示回复内容
  • Plan/Build 双模式切换:只读分析或自主操作文件
  • 会话管理:保存、切换、重命名会话

多模型支持

  • DeepSeek: deepseek-chat, deepseek-reasoner, deepseek-v4-pro, deepseek-v4-flash
  • OpenAI: gpt-4o, gpt-4o-mini, o3-mini
  • Kimi (月之暗面): moonshot-v1 系列, kimi-latest
  • MiniMax: abab 系列
  • 智谱 AI: GLM-4 系列, glm-4v(支持图像理解)
  • 通义千问 (阿里云): qwen-plus, qwen-max, qwen2.5-72b-instruct
  • 硅基流动: DeepSeek-V3, DeepSeek-R1, Qwen2.5 等开源模型
  • Ollama (本地): 支持所有本地模型

代码编辑

  • 代码应用: 聊天回复中的代码块可直接应用到编辑器,支持 Diff 预览和确认
  • 代码补全: 光标处智能补全代码(快捷键 Ctrl+K
  • 代码审查: 分析性能、安全、风格、逻辑问题(快捷键 Alt+R
  • 智能注释: 自动生成 JSDoc/Docstring 文档注释(快捷键 Alt+D

Build 智能体

  • 自主读取、搜索、编辑、创建文件
  • 运行终端命令(需用户确认)
  • 多种工具:read_file、edit_file、run_terminal、grep_content 等
  • Plan 模式只读分析,Build 模式可操作文件

快捷指令

  • /explain - 解释代码
  • /fixbug - 修复 Bug
  • /test - 生成测试用例
  • /review - 代码审查
  • /doc - 生成注释
  • /optimize - 优化代码

文件与图片

  • @+ 按钮以目录树形式浏览并引用项目文件,支持目录导航
  • 自动读取文件内容作为 AI 上下文
  • 支持上传图片(多模态模型如 gpt-4o、glm-4v)
  • 文件变更面板,实时追踪修改

安装使用

安装

  1. HBuilderX 菜单 → 工具 → 插件安装 → 搜索 OhMy-Agent
  2. 或从 DCloud 插件市场 下载 ZIP 手动安装
  3. 安装完成后重启 HBuilderX

打开聊天窗口

  • 快捷键: Ctrl+Shift+C(Mac: Cmd+Shift+C
  • 菜单路径: HBuilderX 顶部菜单 → 工具OhMy-Agent打开主面板

配置 API — 快速配置(推荐)

  1. 打开聊天窗口(Ctrl+Shift+C 或菜单:工具 → OhMy-Agent → 打开主面板)
  2. 点击底部模型选择区域旁的齿轮按钮 ⚙️ 打开"模型管理",或点击 + 按钮打开"添加模型"对话框
  3. 选择提供商(DeepSeek / OpenAI / Kimi / 通义千问 / 硅基流动 等),自动填写 API 地址和可选模型
  4. 填入 API Key(从对应平台获取)
  5. 点击「测试」验证连通性 → 点击「添加」保存

配置 API — 手动配置(JSON 编辑)

在设置面板中可切换到 JSON 编辑 模式,直接编辑模型配置数组:

[
  {
    "name": "显示名称",
    "model": "模型ID",
    "url": "API地址",
    "apiKey": "密钥",
    "provider": "提供商ID"
  }
]
字段 说明 必填
name 模型在 UI 中显示的名称,用于下拉菜单标识
model 实际发送到 API 的模型 ID,如 gpt-4o-minideepseek-chat
url API 完整地址,以 /v1 结尾,例如 https://api.deepseek.com/v1
apiKey API 认证密钥,从对应提供商平台获取
provider 提供商标识(如 openaideepseeksiliconflow),用于下拉菜单按厂商分组

所有字段仅需遵循 JSON 格式,保存后即时生效。

添加模型对话框字段说明

点击 + 按钮弹出"添加模型"对话框,各字段说明如下:

字段 说明
提供商 下拉选择预置提供商(DeepSeek、OpenAI、Kimi、硅基流动、Ollama 等),选择后自动填写 API 地址和模型列表
模型 自动填充该提供商的预置模型列表;若无预置模型(如 Ollama、自定义),需手动输入模型名称
API 地址 OpenAI 兼容 API 的完整地址,必须以 https://http:// 开头,以 /v1 结尾
API Key 从对应提供商平台获取的密钥,输入后点击「测试」按钮验证连通性

模型管理 & 可见性

点击型号名称旁的齿轮按钮 ⚙️ 打开模型管理模态框:

  • 每个模型旁有开关按钮,关闭后该模型不出现在底部模型下拉菜单中
  • 适用于需要保持配置但暂时不想显示的模型

快捷操作

操作 快捷键
打开聊天窗口 Ctrl+Shift+C
选中代码带入聊天(行号引用) Ctrl+Shift+A
代码补全 Ctrl+K
代码编辑 (AEI) Alt+E
代码审查 Alt+R
智能注释 Alt+D
发送消息 Enter
换行 Shift+Enter

配置项

配置项 说明 默认值
ohmy-agent.proxyURL API 访问地址 https://api.openai.com/v1
ohmy-agent.apiKey API Key
ohmy-agent.aiModel 模型名称 gpt-4o-mini
ohmy-agent.NumberOfAttachedHistoryMessages 附带历史消息数 4
ohmy-agent.models 多模型配置(JSON 数组)
ohmy-agent.currentModel 当前使用的模型
ohmy-agent.enableStream 是否启用流式输出 true

多模型配置示例

[
  {
    "name": "gpt-4o-mini",
    "model": "gpt-4o-mini",
    "url": "https://api.openai.com/v1",
    "apiKey": "sk-你的key",
    "provider": "openai"
  },
  {
    "name": "deepseek-chat",
    "model": "deepseek-chat",
    "url": "https://api.deepseek.com/v1",
    "apiKey": "sk-你的key",
    "provider": "deepseek"
  },
  {
    "name": "qwen-plus",
    "model": "qwen-plus",
    "url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
    "apiKey": "sk-你的key",
    "provider": "qwen"
  }
]

项目结构

src/
├── extension.js          # HBuilderX 插件入口
├── main.js               # 命令路由、AI API 调用
├── biz/
│   ├── webview/          # 聊天界面(Vue + 目录文件选择)
│   ├── edit/             # 代码编辑(Diff 预览)
│   ├── agent/            # Build 智能体模式
│   ├── coding/           # 代码生成 AI 命令
│   ├── autocomplete/     # 代码补全
│   ├── review/           # 代码审查
│   ├── doc/              # 智能注释生成
│   ├── actions/          # 自定义快捷指令
│   └── images/           # AI 图像生成
├── setting/              # 插件设置 UI
├── token/                # Token 计算器
├── data/                 # 提示词模板
├── chat/                 # 创建聊天会话
├── libs/                 # 工具函数(含版本检查)
├── features/             # 新特性注册
├── i18n/                 # 国际化
├── mcp/                  # MCP 协议模块
├── skills/               # 技能系统
├── subagents/            # 子代理模块
└── cli/                  # CLI 命令行接口

使用技巧

  1. 快速开始: 打开文件后按 Ctrl+Shift+C,直接输入问题即可
  2. 代码审查: 选中代码后按 Ctrl+Shift+A 带入行号,然后输入 /review
  3. 文件上下文: 点击输入框上方 + 按钮,以目录树形式浏览并添加项目文件
  4. 代码应用: AI 回复中的代码块有"应用"按钮,可直接应用到编辑器(支持 Diff 对比)
  5. Build 模式: 左下角切换 Plan/Build 模式,Build 模式可让 AI 自主修改文件
  6. 多模型切换: 点击底部模型名称按钮,快速切换不同模型
  7. 图片上传: 上传图片后自动使用视觉模型识别

更新日志

v1.9.3

  • 改进: type 字段重命名为 provider,配置 JSON 使用 provider 替代 type
  • 改进: 下拉菜单按提供商分组显示(DeepSeek / OpenAI / 硅基流动 等),便于区分同名模型
  • 改进: 模型管理弹窗显示提供商标签,开关按钮改为方形
  • 改进: 右键菜单统一归入 OhMy-Agent
  • 改进: 下拉列表与 JSON 配置数据实时同步,确保厂商名称正确显示
  • 修复: 插件入口从 dist/src/extension.js 改为 src/extension.js,开发无需构建

v1.9.2

  • Build 模式自动写入: AI 生成的代码块自动写入文件,取消手动接受/拒绝步骤
  • Plan 模式升级: 升级为完整 Agent 循环,支持只读工具(文件读取、搜索、grep 等)
  • 斜杠命令系统: /init 初始化项目 AGENTS.md、/compact 压缩对话、/undo 撤销文件修改、/new 新建前端项目
  • 模型管理: 齿轮按钮打开模态框,支持开关控制模型在 UI 中的可见性
  • 远程控制: 底部工具栏新增"远程控制"按钮,通过 WebSocket + QR 码从手机端连接
  • 设置面板改进: 双 Tab(已配置模型 / 关于),列表视图 + JSON 编辑两种模式
  • UI 优化: 新会话/历史会话按钮,模型搜索过滤,Toast 通知,恢复出厂设置按钮
  • 深层依赖 wsjavascript-obfuscator

v1.9.1

  • 添加 OhMy-Agent 前缀到右键菜单项,便于识别
  • 修复 HBuilderX 模块加载问题(移除 extensionDependencies)
  • 集成 MCP 协议模块,支持 MySQL 连接等外部工具
  • 新增插件快捷键:代码审查 Alt+R、智能注释 Alt+D

v1.9.0

  • 新增目录树文件选择,支持目录导航浏览
  • 新增代码块"应用"按钮,支持 Diff 预览和确认
  • Plan/Agent → Plan/Build 模式重命名
  • 新增手动检查更新命令 ohmy-agent.checkUpdate
  • 主题适配:气泡颜色跟随主题主色
  • 选中代码带入聊天改为行号引用
  • 图片上传支持项目目录上下文选择
  • 文件引用自动读取文件内容发送给 AI
  • 优化发送按钮样式(SVG 纸飞机图标)
  • 优化 Enter/Shift+Enter 换行逻辑
  • 修复 skippedVersion 跳过逻辑

v1.8.0

  • 新增活动文件自动显示功能
  • 新增选中行号显示
  • 优化文件引用标签样式
  • 修复 DeepSeek 相关配置

v1.7.0

  • 新增 Agent 智能体模式
  • 新增 Plan/Agent 双模式切换
  • 新增文件变更面板
  • 新增会话管理功能

v1.6.0

  • 新增 AEI 代码编辑功能
  • 新增多模型配置支持
  • 优化代码审查和注释生成

许可证

MIT License

联系方式

隐私、权限声明

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

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

插件不采集任何数据。用户配置的 API Key 仅存储在本地 HBuilderX 配置中,发送至用户自行配置的 AI 模型 API 地址。

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

许可协议

MIT协议