【OneX】OneX AI 工具安装、配置及功能介绍

OneX 知识平台：一个面向AI时代的知识交付平台，12+ 高质量体系课、4+ 实战项目，涵盖 Go、云原生、AI 。

微信GZH：令飞编程，分享 Go、云原生、AI Infra 相关技术。回复「资料」免费下载 Go、云原生、AI 等学习资料；

在课程 01 | 课程导论：OneX Harness AI Coding 工具介绍中，我介绍了OneX Harness AI Coding（onexai）的设计思路、功能及演示。本节课，我们就正式进入 OneX Harness AI Coding工具的实战中。

首先，我们来安装和配置 OneX Harness AI Coding 工具。当前onexai支持 Windows 和 MAC。

下载并配置onexai工具

onexai 下载地址为：https://onex\\\\.feizaonet\\\\.com/downloads。请根据操作系统和CPU架构下载对应的 Tar包，解压后放在 PATH 路径中。

配置 onexai 工具

进入 https://onex\\\\.feizaonet\\\\.com/account?tab=aksk 页面，创建一堆 AKSK。注意 AKSK 只有会员可以创建。点击创建 AccessKey 按钮，创建一对密钥。注意密钥要妥善保存、禁止共享、禁止外传。

编辑 $HOME/.onexai/onexai.yaml 文件，配置上面创建的AKSK。配置后，内容如下：

YAML 复制代码

user:
  access-key: ak-xxxxxx
  secret-key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

进入你的Go项目中，执行以下命令初始化：

Bash 复制代码

$ onexai ide init -h # 查看 AI Coding IDE 初始化帮助。当前支持 claude, opencode, crush, cursor
$ onexai ide init --ide=claude # 如果你用的是claude code command line tool
▸ Claude Code
  ✓ .claude/settings.local.json # 默认开启 onexai mcp server
  ✓ .claude/commands/onexai.md # onexai 编程命令。在 IDE 中键入 /onexai <Your Prompt> 会用onexai 的方式来开发代码
  ✓ .claude/commands/onex-commit.md # 
  ✓ .claude/commands/onex-review.md # 使用 onexai 提供的方式来 Review 代码
  ✓ .claude/skills/onexai-conventions.md # OneX 的规范 SKILl，由模型自己判定合适调用

✓ IDE initialization complete.
Restart your IDE for changes to take effect.

onexai 命令介绍

onexai 中有很多好用的命令，当前处在隐藏状态，例如：聊天室、小工具、Code IDE等等。onexai 未来会打造成为一个cliops工具。

当前已有的功能，可以通过onexai -h查看：

Bash 复制代码

[colin@local onexai]$ onexai -h
onexai is a command-line tool for the onex technology stack scaffold..

 Find more information at: https://github.com/feizaonet/onexai/blob/master/docs/guide/en-US/cmd/onexai/onexai.md

Basic Commands (Beginner):
  upgrade           Upgrade onexai to the latest version

Project Commands:
  create            Create a new project

Manifest Generation Commands:
  completion        Output shell completion code for the specified shell (bash, zsh, fish, or powershell)

Troubleshooting and Debugging Commands:
  sysload           Display system load information for performance troubleshooting
  cleanup-zombies   Clean up zombie processes for the current user

Convention Commands (AI Coding):
  convention        Query Go development conventions and coding standards used by the OneX team

Standard Commands (IT Governance):
  standard          Query and enforce the enterprise IT naming & grading standards

Local Development Commands:
  compose           Manage the local OneX backend services

AI Commands:
  rag               Semantic search over the OneX knowledge base using RAG
  mcp               Start an MCP server exposing onexai commands as tools

Other Commands:
  version           Print the client version information

Usage:
  onexai [flags] [options]

Use "onexai <command> --help" for more information about a given command.
Use "onexai options" for a list of global command-line options (applies to all commands).

命令解析：

create：脚手架父命令，用来创建各类Go项目开发中，常用的服务类型。例如：
- webserver：Web服务器，支持各种Web框架，例如：gin、kratos、grpc、echo、fiber、go-zero、kitex、hertz、iris等；
- api：给Web服务新增加一个REST类型的资源实现。能实现Handler -> Biz -> Store 3 层的代码打通；
- jobserver：创建一个异步任务服务器；支持CronJob、Job及自定义的Job，而且扩展能力、可插拔能力非常强；
- job：为已有 JobServer 追加指定资源类型的异步任务处理器；
- mqserver：创建独立 MQServer（消息队列消费者）项目
- mq：为项目创建消息队列消费者与处理器；
- mcpserver：创建独立 MCPServer（Model Context Protocol 服务器）项目；
- mcp: 为项目创建 MCP 工具命名空间;
- clitool: 创建独立 CLI 工具项目;
- cmd: 为 CLI 项目创建 Cobra 子命令;
- console: 创建现代 Web 前端（控制台）项目;
- micro: 为已有 Web 控制台项目创建微前端子应用;
- declserver: 创建独立声明式（kube-apiserver 风格）API 服务器项目。;
- crd: 为已有 declserver 项目追加 REST 资源（CRD）;
- controller-manager: 创建独立控制器聚合（kube-controller-manager 风格）项目;
- controller: 为已有 controller-manager 项目追加控制器;
- operator: 创建独立 controller-runtime Operator 项目;
- operator-api: 为已有 Operator 项目追加 CRD 及其控制器;
convention: 查询 OneX 团队维护的 Go 开发规范全集。里面有大概有50~60 种规范，几乎涵盖了 Go 项目开发中的方方面面，可以自行查阅，后期也会持续维护。
- overview: 查看当前所有的规范列表；
- check： Go 代码运行具备确定性检查器的规范规则；
- 各类其他规范，请自行查阅
mcp：启动 MCP 服务器，把 onexai 子命令暴露为工具，供 Claude 等 AI 助手驱动脚手架；
ide: 初始化 onexai 集成的 AI 编码 IDE 配置;

实战演示

Bash 复制代码

$ mkdir onexdemo
$ cd onexdemo
$ onexai ide init --ide=claude # 我用的 CLAUDE CODE
$ claude .
> 请帮我创建一个博客平台，平台支持帖子、点赞、收藏 3类能力。使用内存数据库。完成前后端接线，并启动前端。

或者你也也可以让AI确定性用OneX规范开发项目，可以这么问：/onexai 请帮我创建一个博客平台，平台支持帖子、点赞、收藏 3类能力。使用内存数据库。完成前后端接线，并启动前端。

大约10分钟后，请在本地浏览器打开http://127.0.0.1:3000：

你可以看下代码，跟你课程中学到的规范、开发方式、代码架构、设计理念等几乎是保持一致的。

上面项目的后端已经是按OneX 的方式开发的。前端因为比较简单，所以没有用前端。你还可以这么问，让AI也是用onex的规范来开发前端：

Bash 复制代码

/onexai 请帮我创建一个博客平台，平台支持帖子、点赞、收藏 3类能力。使用内存数据库。完成前后端接线，并启动前端。前端也要使用onex规范

开发完成后的界面如下：

上面开发时将博客平台放在了一个统一前端控制面中，因为整个前端采用的是微前端架构。所以，你可以很容易的将博客平台独立出来。之后，你可以基于当前的界面对博客平台进行微调，实现自己的博客平台。

onexai 未来规划

Harness AI Coding 要想达到一个预期的状态，是一个精细活，需要不断的对SKILL、MCP、RAG及推理流程进行调优改进。所以onexai未来会持续不断的去调优，以实现稳定、精准、规范、一致的目标。