零代码基础也能搞定！手把手教你用 AI 编程助手搭建属于自己的 AI Agent 操作系统，还能免费用上通义千问、DeepSeek 等大模型！

---

🎯 你将学到什么

• ✅ 如何用 Qoder（AI 编程助手）从零搭建 ApexOS
• ✅ 环境配置小白教程（Java 21 + Maven）
• ✅ 免费获取 LLM API Key 的完整攻略
• ✅ 钉钉/微信/飞书扫码登录配置方法
• ✅ 第一次启动和基础使用

---

📖 第一部分：准备工作——如何与 Qoder 交互

什么是 Qoder？

Qoder 是一个 AI 编程助手，你只需要用自然语言告诉它你想做什么，它就能帮你写代码、改配置、解决问题。就像有个程序员朋友坐在你旁边一样！

操作步骤

第一步：安装 Qoder

1. 下载并安装 Qoder 编辑器
2. 打开 Qoder，登录你的账号

第二步：克隆项目

告诉 Qoder："帮我克隆 apexos 项目"

Qoder 会自动执行：

git clone https://gitee.com/ooderCN/apexos.git
cd apexos

第三步：让 Qoder 帮你编译

告诉 Qoder："编译启动"

Qoder 会帮你：

1. 检查 Java 和 Maven 环境
2. 执行 mvn clean package -DskipTests
3. 启动应用
4. 告诉你访问地址

做到了什么？

你完全不需要记住复杂的命令，只需要用中文告诉 Qoder 你想做什么，它就能帮你完成所有技术操作。

有什么用？

• 小白友好：不需要懂 Java、Maven、Spring Boot
• 节省时间：从几小时的手动操作变成几分钟的对话
• 降低门槛：让非技术人员也能搭建 AI 系统

---

📖 第二部分：环境配置——小白也能搞定的技术准备

需要安装什么？

只需要两个东西：

1. Java 21（程序运行环境）
2. Maven 3.6+（项目构建工具）

详细安装步骤

1. 安装 Java 21

方法一：让 Qoder 帮你检查

告诉 Qoder："检查我的 Java 版本"

方法二：手动安装

1. 访问：https://adoptium.net/
2. 下载 “Temurin 21 JDK”
3. 一路点击"下一步"安装
4. 验证安装：

java -version

看到类似输出就成功了：

java version "21.0.9" 2025-10-21 LTS

2. 安装 Maven

方法一：让 Qoder 帮你

告诉 Qoder："帮我安装 Maven"

方法二：手动安装

1. 访问：https://maven.apache.org/download.cgi
2. 下载 apache-maven-3.9.x-bin.zip
3. 解压到 C:\Program Files\Apache\maven
4. 添加环境变量：
   • 新建 MAVEN_HOME = C:\Program Files\Apache\maven
   • 编辑 Path，添加 %MAVEN_HOME%\bin
5. 验证：

mvn -version

项目配置文件详解

ApexOS 的配置文件在 config/application.yml，别怕，我带你读懂它！

核心配置项

# 服务端口（默认8086）
server:
  port: 8086

# LLM 配置（大模型服务）
ooder:
  llm:
    provider: qianwen        # 默认使用通义千问
    model: qwen-plus         # 默认模型
    
# 技能配置
ooder:
  skills:
    root-path: ./skills      # 技能存放目录

做到了什么？

• 完整搭建了 Java 开发环境
• 理解了项目配置文件的作用
• 为后续配置 LLM 和第三方平台打下基础

有什么用？

环境配置是使用任何 Java 项目的基础技能，学会了这个，你可以搭建 countless 开源项目！

---

📖 第三部分：免费 LLM 资源配置——不花钱用上大模型

什么是 LLM？

LLM（Large Language Model）就是大语言模型，比如 ChatGPT、通义千问、DeepSeek 等。ApexOS 需要连接这些 AI 服务才能智能对话。

免费获取 API Key 完整攻略

方案一：通义千问（推荐新手）

免费额度：新用户赠送大量免费 token！

获取步骤：

1. 注册阿里云账号

   • 访问：https://www.aliyun.com/
   • 点击"免费注册"
   • 用手机号注册即可

2. 开通百炼服务

   • 访问：https://bailian.console.aliyun.com/
   • 点击"开通服务"
   • 完成实名认证（免费）

3. 创建 API Key

   • 进入"API-KEY 管理"页面
   • 点击"创建新的 API-KEY"
   • 复制保存（只显示一次！）

4. 配置到 ApexOS

让 Qoder 帮你配置：

告诉 Qoder："帮我配置通义千问 API Key，我的 key 是：sk-xxxxxxxxx"

或者手动配置：

方法 A：环境变量方式（推荐）

# Windows PowerShell
$env:QIANWEN_API_KEY="sk-你的key"

# 然后启动
java -jar target/apex-os-1.0.0.jar

方法 B：修改配置文件
编辑 config/application.yml，找到：

ooder:
  llm:
    qianwen:
      api-key: ${QIANWEN_API_KEY:}

改为：

ooder:
  llm:
    qianwen:
      api-key: "sk-你的key"

方案二：DeepSeek（性价比之王）

免费额度：新用户注册即送 14 元体验金！

获取步骤：

1. 注册 DeepSeek

   • 访问：https://platform.deepseek.com/
   • 用手机号注册
   • 完成实名认证

2. 获取 API Key

   • 进入"API Keys"页面
   • 点击"创建 API Key"
   • 复制保存

3. 配置到 ApexOS

# 设置环境变量
$env:DEEPSEEK_API_KEY="sk-你的key"

# 修改默认 Provider
# 编辑 config/application.yml
ooder:
  llm:
    provider: deepseek
    model: deepseek-chat

方案三：百度文心（备选方案）

免费额度：有一定的免费调用额度

获取步骤：

1. 访问：https://cloud.baidu.com/

2. 注册并实名认证

3. 进入"千帆大模型平台"

4. 创建应用获取 API Key 和 Secret Key

5. 配置到 ApexOS

$env:BAIDU_API_KEY="你的api_key"
$env:BAIDU_SECRET_KEY="你的secret_key"

免费额度对比

平台	免费额度	适用场景	推荐指数
通义千问	新用户赠送大量 token	中文对话、文档处理	⭐⭐⭐⭐⭐
DeepSeek	14元体验金	代码生成、逻辑推理	⭐⭐⭐⭐⭐
百度文心	有一定免费额度	企业合规场景	⭐⭐⭐⭐

做到了什么？

• 零成本获取了商用级 AI 能力
• 掌握了多平台 API Key 获取方法
• 学会了灵活的配置方式

有什么用？

• 个人学习：完全免费体验 AI 操作系统
• 原型开发：快速验证想法，不用花钱
• 小规模使用：个人项目完全够用

---

📖 第四部分：第三方平台配置——钉钉/微信/飞书扫码登录

为什么需要配置？

配置后，你的团队可以用企业微信、钉钉或飞书直接扫码登录，不用记密码，安全又方便！

配置钉钉扫码登录

第一步：创建钉钉应用

1. 访问钉钉开放平台

   • 网址：https://open-dev.dingtalk.com/
   • 用钉钉管理员账号登录

2. 创建应用

   • 点击"应用开发" → “企业内部应用” → “创建应用”
   • 填写应用名称（如：ApexOS）
   • 选择"企业自助接入"

3. 获取 AppKey 和 AppSecret

   • 进入应用 → “凭证与基础信息”
   • 复制 AppKey 和 AppSecret

4. 配置回调地址

   • 回调 URL：http://你的服务器IP:8086/api/v1/auth/dingding/callback
   • 本地测试：http://localhost:8086/api/v1/auth/dingding/callback

第二步：配置到 ApexOS

让 Qoder 帮你配置：

告诉 Qoder："帮我启用钉钉扫码登录，AppID是xxx，AppSecret是xxx"

或者手动编辑 config/application.yml：

auth:
  qrcode:
    enabled: true
    platforms:
      dingding:
        enabled: true                    # 改为 true
        name: 钉钉
        icon: ri-message-3-line
        app-id: "你的AppKey"             # 填入
        app-secret: "你的AppSecret"      # 填入
        callback-url: "http://localhost:8086/api/v1/auth/dingding/callback"
        auth-url: https://login.dingtalk.com/oauth2/auth
        qrcode-url: https://login.dingtalk.com/oauth2/auth
        description: 使用钉钉扫码登录

配置微信扫码登录

第一步：注册微信开放平台

1. 访问微信开放平台

   • 网址：https://open.weixin.qq.com/
   • 注册开发者账号（需要营业执照）

2. 创建网站应用

   • 进入"管理中心" → “网站应用” → “创建网站应用”
   • 填写应用信息
   • 等待审核（1-3个工作日）

3. 获取 AppID 和 AppSecret

   • 审核通过后，查看应用详情
   • 复制 AppID 和 AppSecret

4. 配置授权回调域

   • 回调域名：localhost（本地测试）
   • 或你的服务器域名

第二步：配置到 ApexOS

auth:
  qrcode:
    platforms:
      weixin:
        enabled: true                    # 改为 true
        name: 微信
        icon: ri-wechat-line
        app-id: "你的AppID"              # 填入
        app-secret: "你的AppSecret"      # 填入
        callback-url: "http://localhost:8086/api/v1/auth/weixin/callback"
        auth-url: https://open.weixin.qq.com/connect/qrconnect
        qrcode-url: https://open.weixin.qq.com/connect/qrconnect
        description: 使用微信扫码登录

配置飞书扫码登录

第一步：创建飞书应用

1. 访问飞书开放平台

   • 网址：https://open.feishu.cn/
   • 用飞书管理员账号登录

2. 创建企业自建应用

   • 点击"创建企业自建应用"
   • 填写应用名称和描述
   • 选择应用类型

3. 获取 App ID 和 App Secret

   • 进入应用 → “凭证与基础信息”
   • 复制 App ID 和 App Secret

4. 配置重定向 URL

   • 添加：http://localhost:8086/api/v1/auth/feishu/callback

5. 发布应用

   • 创建版本并提交审核
   • 管理员审批通过

第二步：配置到 ApexOS

auth:
  qrcode:
    platforms:
      feishu:
        enabled: true                    # 改为 true
        name: 飞书
        icon: ri-message-2-line
        app-id: "你的AppID"              # 填入
        app-secret: "你的AppSecret"      # 填入
        callback-url: "http://localhost:8086/api/v1/auth/feishu/callback"
        auth-url: https://passport.feishu.cn/suite/passport/page/auth
        qrcode-url: https://passport.feishu.cn/suite/passport/page/auth
        description: 使用飞书扫码登录

快速配置技巧

让 Qoder 一键配置所有平台：

告诉 Qoder："帮我配置所有第三方登录平台"

Qoder 会：

1. 引导你输入各平台的 AppID 和 AppSecret
2. 自动修改配置文件
3. 重启应用使配置生效

做到了什么？

• 掌握了三大办公平台的接入方法
• 实现了企业级单点登录能力
• 提升了系统安全性和用户体验

有什么用？

• 团队协作：员工用日常办公工具直接登录
• 安全管理：统一身份认证，便于权限管控
• 用户体验：扫码即登录，不用记密码

---

📖 第五部分：完整搭建流程——从零到运行

完整操作清单

Step 1：准备工作（5分钟）

• 安装 Java 21
• 安装 Maven 3.6+
• 下载/克隆 ApexOS 项目

Step 2：获取 LLM API Key（10分钟）

• 注册通义千问/DeepSeek
• 获取 API Key
• 配置到环境变量或配置文件

Step 3：配置第三方登录（可选，15分钟）

• 选择需要的平台（钉钉/微信/飞书）
• 创建应用获取凭证
• 修改配置文件

Step 4：编译启动（3分钟）

告诉 Qoder："清空重新编译一下"

Qoder 会自动：

1. 停止旧进程
2. 执行 mvn clean package -DskipTests
3. 启动应用
4. 打开预览浏览器

Step 5：首次登录（1分钟）

• 访问：http://localhost:8086
• 用户名：admin
• 密码：admin123

启动成功标志

看到以下日志说明成功了：

Tomcat started on port 8086 (http) with context path '/'
Started OsApplication in 14.062 seconds

常见问题

Q1：端口被占用怎么办？

告诉 Qoder："端口8086被占用了，帮我解决"

Q2：LLM 连接失败？

• 检查 API Key 是否正确
• 检查网络连接
• 查看日志：logs/apexos.log

Q3：编译失败？

• 检查 Java 版本是否为 21
• 检查 Maven 是否安装
• 让 Qoder 帮你：“编译失败了，帮我看看”

---

🎁 最终收获

你现在拥有了

1. ✅ 一个完整的 AI 操作系统

   • 技能热插拔（像装手机 App 一样简单）
   • 多 LLM 支持（通义千问/DeepSeek/百度）
   • RAG 知识增强（让 AI 懂你的业务）

2. ✅ 企业级认证能力

   • 钉钉扫码登录
   • 微信扫码登录
   • 飞书扫码登录

3. ✅ 零成本的 AI 开发环境

   • 免费 LLM 额度
   • 开源代码
   • 本地部署

延伸价值

个人开发者：

• 快速原型开发，验证 AI 应用想法
• 学习 AI Agent 架构设计
• 构建个人 AI 助手

企业团队：

• 搭建内部 AI 平台
• 集成现有办公系统
• 降低 AI 应用开发门槛

技术学习：

• Spring Boot 实战项目
• 微服务架构设计
• 热插拔插件系统

---

🚀 下一步做什么？

1. 探索技能市场

   • 登录控制台 → 技能市场
   • 浏览可用技能
   • 一键安装新技能

2. 配置知识库

   • 上传你的文档（PDF/Word/Markdown）
   • 让 AI 学习你的业务知识
   • 实现智能问答

3. 创建场景

   • 用自然语言描述业务需求
   • 系统自动生成工作流
   • 体验"场景即技能"

4. 加入社区

   • Gitee：https://gitee.com/ooderCN/apexos
   • 提交 Issue
   • 分享你的使用经验

---

💡 小贴士

Qoder 使用技巧

高效提问模板：

• “帮我配置 [功能]，我的 [参数] 是 [值]”
• “编译启动” / “清空重新编译”
• “查看日志” / “检查配置”
• “帮我解决 [问题描述]”

常见指令：

• 编译启动：首次编译并启动
• 清空重新编译一下：清理后重新编译
• 检查一下配置：查看当前配置
• 看看日志：查看运行日志

配置备份

建议备份你的配置文件：

# 备份配置
copy config\application.yml config\application.yml.backup

性能优化

如果电脑配置较低，可以调整 JVM 参数：

# 在启动命令中添加
java -Xms256m -Xmx512m -jar target/apex-os-1.0.0.jar

---

📞 需要帮助？

• 📖 官方文档：https://gitee.com/ooderCN/apexos
• 💬 提交问题：https://gitee.com/ooderCN/apexos/issues
• 📧 联系作者：18683731@qq.com
• 🌟 给个 Star：支持开源项目！

---

从零到一，你做到了！ 🎉

现在就开始你的 AI 操作系统之旅吧！

Made with ❤️ by ooder Team