← 返回项目库

开箱即用的智能 AI 平台｜卿神 AI 编码助手

一套可直接运行的中文 AI 文件操作工作台，支持流式对话、读取与编辑文件、浏览工作区并通过工具日志查看执行过程。

卿神 AI 编码助手是 ruoyi-ai 项目中的独立 Web Copilot 模块。它提供浏览器可操作的中文界面，用户可以用自然语言提出文件和项目操作需求，系统通过 Spring AI 调用模型并在工作区内执行读取、写入、编辑、目录浏览和项目分析等工具，同时以实时日志反馈任务进度。当前交付聚焦可本地运行的 AI 文件操作能力，模型 API 密钥由部署者自行配置。

真实界面

项目截图

共 7 张

中文 AI 文件操作工作台
流式对话完成
读取演示文件
编辑演示文件
验证更新内容
读取项目配置
浏览工作区目录

Capabilities

核心功能

✓中文 AI 对话工作台
✓流式 SSE 回复与完成状态展示
✓工作区文件读取与分页读取
✓文件创建、覆盖与精确编辑
✓目录浏览与项目结构分析
✓工具执行日志与耗时反馈
✓本地工作区路径安全校验
✓可通过环境变量配置模型密钥

适用场景

学习自然语言驱动文件工具调用的完整交互流程
为个人或团队搭建本地 AI 编码助手原型
验证 Spring AI、SSE 和工作区工具的组合方式
在受控工作区内辅助浏览和修改项目文件

适合谁

需要学习 AI 工具调用、搭建内部代码助手、管理本地项目文件或验证 Spring AI 工作流的开发者与技术团队。

商业化思路

用于社群学习、研究 AI 编码助手产品形态、内部自动化原型和本地文件工作流验证；正式商业部署应由使用者自行配置模型服务与运行环境。

你会拿到什么

  • ✓固定上游 commit 的完整源码包
  • ✓中文 AI Copilot 界面与流式 SSE 适配修改
  • ✓MIT License、版权声明与上游来源说明
  • ✓7 张真实中文运行界面截图及校验清单
  • ✓Maven 构建、SSE 契约和浏览器采集证据

部署流程

  1. 1安装 Java 21 与 Maven 3.9+，进入 ruoyi-extend/ruoyi-ai-copilot 目录。
  2. 2配置 SPRING_AI_OPENAI_API_KEY，并按需设置兼容模型的 base-url 和 model。
  3. 3执行 mvn package -DskipTests 生成 target/ruoyi-ai-copilot-1.0.0.jar。
  4. 4执行 java -jar target/ruoyi-ai-copilot-1.0.0.jar，并在浏览器访问服务端口。

真实验证结果

独立 Web UI 首页返回 HTTP 200；页面、历史读取/清空接口和流式接口均已验证。SSE 契约测试确认事件可解析为“验证”“成功”和 [DONE]，浏览器真实运行采集 7 张不重复功能状态截图，控制台错误为 0；Maven 构建与中文化 TDD 证据已归档。

部署前须知

模型 API 是运行前置条件，响应速度和工具选择受模型服务影响；当前 UI 的助手自然语言回复可能夹带英文，核心操作控件与工具日志已中文化。运行工作区中的演示文件和模型生成内容不进入源码交付包。

部署难度

中等

最低配置

Java 21 与 Maven 3.9+；需要可用的 OpenAI 兼容模型 API 密钥，默认配置面向 DashScope 兼容接口；现代桌面浏览器即可访问 Web 界面。

开源许可证

MIT License

最后验证

2026-08-29

技术栈

Java 21Spring Boot 3.4.5Spring AI 1.0.0-M6Thymeleaf原生 JavaScriptDashScope OpenAI 兼容 API

授权说明

源码仓库包含 MIT License，版权声明为 Copyright (c) 2023 ruoyi-ai。交付包保留 LICENSE、版权声明和上游来源，并披露本版本对 AI Copilot 界面文案及流式 SSE 适配的修改；许可证结论仅作事实披露，不构成额外商业授权承诺。

Release notes

版本记录

1 个已发布版本

vcn-83ede63b9719 当前推荐

首个中文社群学习交付版本；完成核心界面中文化、流式 SSE 事件适配，并通过真实文件工具操作和浏览器截图验收。

部署要求：Java 21、Maven 3.9+、现代桌面浏览器和 OpenAI 兼容模型 API 密钥。

已知问题：模型服务需由部署者自行配置；助手生成文本可能保留部分英文；运行工作区内容仅用于本地验证。

登录后领取