对比测评：为什么AI编程工具需要 Rules 能力？

通义灵码 Project Rules

在开始体验通义灵码 Project Rules 之前，我们先来简单了解一下什么是通义灵码 Project Rules？
大家都知道，在使用 AI 代码助手的时候，有时候生成的代码不是自己想要的，或者说生成的代码采纳后还需要人工修改一部分。这其实就是当模型对于你的描述不能正确理解，或者说理解了你的描述，但是没有适当的方案时，大模型会根据自己的规则来生成相似的自己认为对的代码，这就是我们常说的模型幻觉。
那么当模型生成代码不精准的时候，是否有什么手段可以硬控 AI ，根据你的代码风格和偏好生成代码和回复？现在有了，你可以感受一下通义灵码 Project Rules 的效果。

举个例子

这里我们来举个小例子。比如我想要使用阿里云百炼服务平台的模型在自己的项目中引入一个 DeepSeek 调用，那么我就可以拿到阿里云百炼服务平台的 curl 的调用方法

复制 curl 的调用内容放在通义灵码的对话框中，输入我想要的内容

curl -X POST "https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "deepseek-r1","input":{"messages":[      {"role": "user","content": "你是谁？"}]},"parameters": {"result_format": "message"}
}' 生成java代码

以下是通义灵码为我们生成的使用 Java 调用 DeepSeek 的 API 接口的调用工具类：

这里通过截图我们可以看到，生成的代码基本上没有注释，生成的效果功能上稍作改动就可以用，采纳率 95% 以上。

下面我们再来为通义灵码定义 AI 编码规则，定义完 AI 编码规则之后再来看一下基于上面的 curl 调用方法生成的 Java 代码的效果。

环境准备

在配置通义灵码 Project Rules AI 编码规则之前，首先需要我们确认一下我们的通义灵码插件版本要在 v2.1.5 及以上。

规则配置

这里我们在 IDEA 开发工具的 setting 弹框中找到【Lingma】，勾选启用并点击【编辑】。

在编辑页面输入具体的编码规则 Project Rules ，这里的规则我们直接使用官方提供的 Java 编码规则，具体规则内容的 markdown 语法格式如下：

你是一个资深的 java 专家，请在开发中遵循如下规则：

  • 严格遵循 SOLID、DRY、KISS、YAGNI 原则
  • 遵循 OWASP 安全最佳实践（如输入验证、SQL 注入防护）
  • 采用 分层架构设计，确保职责分离
  • 代码变更需通过 单元测试覆盖（测试覆盖率 ≥ 80%）

技术栈规范

技术栈要求：

1）框架：Spring Boot 3.x + Java 17

2）依赖：

  • 核心：Spring Web, Spring Data JPA, Lombok

  • 数据库：PostgreSQL Driver 或其他关系型数据库驱动

  • 其他：Swagger (SpringDoc), Spring Security (如需权限控制)

应用逻辑设计规范

分层架构原则

核心代码规范

1. 实体类（Entity）规范

@Entity
@Data // Lombok 注解
public class User {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private Long id;@NotBlank(message = "用户名不能为空")@Size(min = 3, max = 50)private String username;@Emailprivate String email;// 关联关系使用懒加载@ManyToOne(fetch = FetchType.LAZY)private Department department;
}

2. 数据访问层（Repository）规范

public interface UserRepository extends JpaRepository<User, Long> {// 命名查询Optional<User> findByUsername(String username);// 自定义 JPQL 查询@Query("SELECT u FROM User u JOIN FETCH u.department WHERE u.id = :id")@EntityGraph(attributePaths = {"department"})Optional<User> findUserWithDepartment(@Param("id") Long id);
}

3. 服务层（Service）规范

@Service
public class UserServiceImpl implements UserService {@Autowiredprivate UserRepository userRepository;@Transactionalpublic ApiResponse<UserDTO> createUser(UserDTO dto) {// 业务逻辑实现User user = User.builder().username(dto.getUsername()).build();User savedUser = userRepository.save(user);return ApiResponse.success(UserDTO.fromEntity(savedUser));}
}

4. 控制器（RestController）规范

@RestController
@RequestMapping("/api/users")
public class UserController {@Autowiredprivate UserService userService;@PostMappingpublic ResponseEntity<ApiResponse<UserDTO>> createUser(@RequestBody @Valid UserDTO dto) {try {ApiResponse<UserDTO> response = userService.createUser(dto);return ResponseEntity.ok(response);} catch (Exception e) {return GlobalExceptionHandler.errorResponseEntity(e.getMessage(), HttpStatus.BAD_REQUEST);}}
}

数据传输对象（DTO）规范

// 使用 record 或 @Data 注解
public record UserDTO(@NotBlank String username,@Email String email
) {public static UserDTO fromEntity(User entity) {return new UserDTO(entity.getUsername(), entity.getEmail());}
}

全局异常处理规范

1. 统一响应类（ApiResponse）

@Data
@NoArgsConstructor
@AllArgsConstructor
public class ApiResponse<T> {private String result; // SUCCESS/ERRORprivate String message;private T data;// 工厂方法public static <T> ApiResponse<T> success(T data) {return new ApiResponse<>("SUCCESS", "操作成功", data);}public static <T> ApiResponse<T> error(String message) {return new ApiResponse<>("ERROR", message, null);}
}

2. 全局异常处理器（GlobalExceptionHandler）

@RestControllerAdvice
public class GlobalExceptionHandler {@ExceptionHandler(EntityNotFoundException.class)public ResponseEntity<ApiResponse<?>> handleEntityNotFound(EntityNotFoundException ex) {return ResponseEntity.status(HttpStatus.NOT_FOUND).body(ApiResponse.error(ex.getMessage()));}@ExceptionHandler(MethodArgumentNotValidException.class)public ResponseEntity<ApiResponse<?>> handleValidationErrors(MethodArgumentNotValidException ex) {String errorMessage = ex.getBindingResult().getFieldErrors().stream().map(error -> error.getField() + ": " + error.getDefaultMessage()).collect(Collectors.joining(", "));return ResponseEntity.badRequest().body(ApiResponse.error(errorMessage));}
}

安全与性能规范

1. 输入校验：

  • 使用 @Valid 注解 + JSR-303 校验注解（如 @NotBlank, @Size）

  • 禁止直接拼接 SQL 防止注入攻击

2. 事务管理：

  • @Transactional 注解仅标注在 Service 方法上
  • 避免在循环中频繁提交事务

3. 性能优化：

  • 使用 @EntityGraph 预加载关联关系
  • 避免在循环中执行数据库查询（批量操作优先）

代码风格规范

1. 命名规范：

  • 类名：UpperCamelCase（如 UserServiceImpl）
  • 方法/变量名：lowerCamelCase（如 saveUser）
  • 常量：UPPER_SNAKE_CASE（如 MAX_LOGIN_ATTEMPTS）

2. 注释规范：

  • 方法必须添加注释且方法级注释使用 Javadoc 格式
  • 计划待完成的任务需要添加 // TODO 标记
  • 存在潜在缺陷的逻辑需要添加 // FIXME 标记

3. 代码格式化：

  • 使用 IntelliJ IDEA 默认的 Spring Boot 风格
  • 禁止手动修改代码缩进（依赖 IDE 自动格式化）

部署规范

部署规范

  • 生产环境需禁用 @EnableAutoConfiguration 的默认配置
  • 敏感信息通过 application.properties 外部化配置
  • 使用 Spring Profiles 管理环境差异（如 dev, prod）

扩展性设计规范

1. 接口优先：

服务层接口（UserService）与实现（UserServiceImpl）分离
2. 扩展点预留：

关键业务逻辑需提供** Strategy 或 Template 模式支持扩展

3. 日志规范：

使用 SLF4J 记录日志（禁止直接使用 System.out.println）核心操作需记录 INFO 级别日志，异常记录 ERROR 级别

在增加了 rules 规则之后，我们再来执行一次上面基于 curl 请求生成 java 调用代码的需求。执行之后，我们可以看到对第一次生成的 DeepSeekClient.java 类进行了按照 rules 规则的变更：

可以看到已经按照我们添加的异常处理规则以及编码规范进行了优化。

编辑后的灵码规则文件的的位置在项目的具体目录位置如图，如果没有看到的话刷新一下磁盘就看到了：

总的来说，通义灵码 IDE 插件提供 AI 规则的设置功能，开发者可以通过设定个性化规则提示词，在智能问答和 AI 程序员中，引导模型生成更为精准、符合个人偏好或项目风格的代码与回答。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如若转载，请注明出处：http://www.pswp.cn/web/78525.shtml
繁体地址，请注明出处：http://hk.pswp.cn/web/78525.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

Java学习手册：MyBatis 框架作用详解

Java学习手册：MyBatis 框架作用详解

一、MyBatis 简介 MyBatis 是一款优秀的持久层框架&#xff0c;用于简化 JDBC 开发。它通过将 Java 对象与数据库表之间的映射关系进行配置&#xff0c;使得开发者可以使用简单的 SQL 语句和 Java 代码来完成复杂的数据操作。MyBatis 支持自定义 SQL 语句&#xff0c;提供了灵…
阅读更多...
list的设计

list的设计

#pragma once #include<assert.h> #include<iostream> using namespace std; namespace aqc {template<class T>struct list_node{list_node* _next;list_node* _prev;T _data;list_node(const T& xT())//加const防止权限放大&#xff0c;用引用减少拷贝…
阅读更多...
基于 PyQt 的YOLO目标检测可视化界面+ nuitka 打包

基于 PyQt 的YOLO目标检测可视化界面+ nuitka 打包

在人工智能和计算机视觉领域&#xff0c;YOLO&#xff08;You Only Look Once&#xff09;是一种广泛使用的实时目标检测算法。为了直观地展示YOLO算法的检测效果&#xff0c;我们使用Pyqt框架进行检测结果的可视化&#xff0c;同时为了使其能够脱离Python环境&#xff0c;我们…
阅读更多...
2.1 阅读错题---02-04年

2.1 阅读错题---02-04年

引言 2002年-2004年英语阅读错题汇总与分析总结。 一、02年阅读 Text 1 题目&#xff1a;21题 题型&#xff1a;细节题 原因&#xff1a;单词认错了&#xff0c;原句中 in sympathy with 译为 与…一致 &#xff1b;题干中的 sympathy 译为 同情 题目&#xff1a;22题 题…
阅读更多...
Axure疑难杂症：中继器制作下拉菜单（多级中继器高级交互）

Axure疑难杂症：中继器制作下拉菜单（多级中继器高级交互）

亲爱的小伙伴，在您浏览之前，烦请关注一下，在此深表感谢！ Axure产品经理精品视频课已登录CSDN可点击学习https://edu.csdn.net/course/detail/40420 本文视频课程记录于上述地址第五章中继器专题第11节 课程主题：中继器制作下拉菜单 主要内容：创建条件选区、多级中继器…
阅读更多...
即刻启程，踏上W55MH32高性能以太网单片机学习之路！

即刻启程，踏上W55MH32高性能以太网单片机学习之路！

单芯片解决方案&#xff0c;开启全新体验——W55MH32 高性能以太网单片机 W55MH32是WIZnet重磅推出的高性能以太网单片机&#xff0c;它为用户带来前所未有的集成化体验。这颗芯片将强大的组件集于一身&#xff0c;具体来说&#xff0c;一颗W55MH32内置高性能Arm Cortex-M3核心…
阅读更多...
C++负载均衡远程调用学习之上报功能与存储线程池

C++负载均衡远程调用学习之上报功能与存储线程池

目录 1. Lars-reportV0.1 report模块介绍 2.Lars-reporterV0.1 reporter项目目录构建 3.Lars-ReporterV0.1 数据表和proto协议环境搭建 4.Lars-ReporterV0.1上报请求业务处理 5.Lars-ReporterV0.1上报请求模块的测试 6.Lars-ReporterV0.2开辟存储线程池-网络存储分离 1. L…
阅读更多...
LabVIEW三轴电机控制

LabVIEW三轴电机控制

在工业自动化迅猛发展的当下&#xff0c;多轴伺服电机控制系统在制造业、3D 打印等众多领域的需求与日俱增。它不仅要实现高精度的单轴运动控制&#xff0c;还需保障多轴协同作业的精准度&#xff0c;对响应速度也有严格要求。LabVIEW 开发多轴伺服电机控制系统&#xff0c;有效…
阅读更多...
驱动开发硬核特训 · Day 27（下篇）：深入掌握 Common Clock Framework 架构与实战开发

驱动开发硬核特训 · Day 27（下篇）：深入掌握 Common Clock Framework 架构与实战开发

节。 在本篇内容中&#xff0c;我们将围绕 Linux 内核中的时钟子系统核心架构 —— Common Clock Framework&#xff08;简称 CCF&#xff09;展开深入讲解&#xff0c;目标是帮助你全面理解其设计理念、主要数据结构、注册流程、驱动实现方式&#xff0c;以及如何基于 NXP i.M…
阅读更多...
数据库基础：数据库类型与MySQL特点详解

数据库基础：数据库类型与MySQL特点详解

一、数据库的主要类型 1. 关系型数据库(RDBMS) 特点：基于关系模型，数据以表格形式存储 代表产品：MySQL、Oracle、SQL Server、PostgreSQL 优势：ACID事务支持、强一致性、成熟的SQL标准 适用场景：需要复杂查询和事务支持的场景 2. 非关系型数据库(NoSQL) 文档型数据库：Mo…
阅读更多...
49认知干货：产品的生命周期及类型汇总

49认知干货：产品的生命周期及类型汇总

49章：产品的生命周期与类型划分 宇宙是运动的而非静止的，任何事物亦是如此。只要是存在的事物，便必然存在周期性变化，就像四季更替中的冬日枯树、春日新芽、夏日繁茂与秋日凋零。 这也意味着：事物的发展，离不开周期的更迭与演化，死亡并非终点，而是一种新的循环转变。 …
阅读更多...
【2025最新】为什么用ElasticSearch？和传统数据库MySQL与什么区别？

【2025最新】为什么用ElasticSearch？和传统数据库MySQL与什么区别？

Elasticsearch 深度解析&#xff1a;从原理到实践 一、为什么选择 Elasticsearch&#xff1f; 数据模型 Elasticsearch 是基于文档的搜索引擎&#xff0c;它使用 JSON 文档来存储数据。在 Elasticsearch 中&#xff0c;相关的数据通常存储在同一个文档中&#xff0c;而不是分散…
阅读更多...
Docker安装Gitblit（图文教程）

Docker安装Gitblit（图文教程）

本章教程，使用Docker安装部署Gitblit。 一、Gitblit简介 Gitblit 是一个基于 Java 的 Git 仓库管理工具，主要用于在局域网或小型团队环境中搭建私有 Git 服务器。它提供了一个简单易用的 Web 界面，用于浏览代码、管理仓库和用户权限等。 二、拉取镜像 sudo docker pull git…
阅读更多...
nDCG（归一化折损累计增益） 是衡量排序质量的指标，常用于搜索引擎或推荐系统

nDCG（归一化折损累计增益） 是衡量排序质量的指标，常用于搜索引擎或推荐系统

nDCG&#xff08;归一化折损累计增益&#xff09; 是衡量排序质量的指标&#xff0c;常用于搜索引擎或推荐系统。核心思想是&#xff1a;排名越靠前的高质量结果&#xff0c;对整体评分的贡献越大&#xff0c;但后续结果的贡献会逐渐“打折”。最终通过对比实际排序与理想排序的…
阅读更多...
《从线性到二维：CSS Grid与Flex的布局范式革命与差异解析》

《从线性到二维：CSS Grid与Flex的布局范式革命与差异解析》

在前端开发的广袤宇宙中&#xff0c;CSS布局技术宛如闪耀的星辰&#xff0c;不断革新与演进&#xff0c;为构建绚丽多彩的网页世界提供了坚实的支撑。其中&#xff0c;CSS Grid布局与Flex布局作为两颗璀璨的明星&#xff0c;以其独特的魅力和强大的功能&#xff0c;深受开发者们…
阅读更多...
2025年01月03日美蜥（杭州普瑞兼职）一面

2025年01月03日美蜥（杭州普瑞兼职）一面

目录 vue2 vue3 的区别react 性能优化react 组件传值v-for 和 v-if 的优先级react 中多个接口请求的数据&#xff0c;需要渲染到一个列表上怎么处理百万条数据怎么渲染vue2、vue3 的响应式原理微前端了解吗git 版本控制git mearge 和 git rebase 的区别垂直水平居中react 中实…
阅读更多...
【聚类分析】基于copula的风光联合场景生成与缩减

【聚类分析】基于copula的风光联合场景生成与缩减

目录 1 主要内容 风光出力场景生成方法 2 部分程序 3 程序结果 4 下载链接 1 主要内容 该程序方法复现《融合风光出力场景生成的多能互补微网系统优化配置》风光出力场景生成部分&#xff0c;目前大多数研究的是不计风光出力之间的相关性影响&#xff0c;但是地理位置相近…
阅读更多...
LeetCode 1128 等价多米诺骨牌对的数量 题解

LeetCode 1128 等价多米诺骨牌对的数量 题解

今天的每日一题&#xff0c;我的思路还是硬做&#xff0c;不如评论区通过状压写的简单&#xff0c;但是答题思路加算法实现是没有问题的&#xff0c;且时间复杂度也是可以通过的&#xff0c;毕竟全是o(n) 那么我就来说一下我的思路&#xff0c;根据dominoes[i] [a, b] 与 domi…
阅读更多...
技术部测试规范

技术部测试规范

简短测试流程&#xff1a; 开发完成 -> 本地自测 -> 测试环境自测 -> 通知测试同事复测 -> 确认无误后上生产 -> 生产环境自测 -> 再次通知测试同事复测 -> 提交产品验收。 当然可以&#xff01;以下是进一步优化后的测试流程规范&#xff0c;特别强调了开…
阅读更多...
算法每日一题 | 入门-顺序结构-大象喝水

算法每日一题 | 入门-顺序结构-大象喝水

大象喝水 题目描述 一只大象口渴了&#xff0c;要喝 20 升水才能解渴&#xff0c;但现在只有一个深 h 厘米&#xff0c;底面半径为 r 厘米的小圆桶 &#xff08;h 和 r 都是整数&#xff09;。问大象至少要喝多少桶水才会解渴。 这里我们近似地取圆周率 π 3.14 \pi3.14 π…
阅读更多...
最新文章

Copyright @ 2022~2023