webforJ 的 AI 工具
AI 编码工具速度很快，但其输出仍需检查。webforJ 为它们提供编写、检查和审查的闭环：可查阅的真实 API、可遵循的正确工作流，以及无需浏览器即可返回通过或失败结果的测试。
适用于 Claude Code、GitHub Copilot、Cursor、Gemini 和 Codex。
为什么使用循环
当编码代理没有可查阅的资料时，只能凭记忆编写。提醒它谨慎并不能解决这些问题。每种失误都需要单独检查，而 webforJ 用相应的工具填补每个漏洞。
它调用了一个不存在或曾经存在过的 API。
它遵循通用的 Java 习惯，而非框架约定。
它生成的代码虽然能编译，但用户点击时却毫无作用。
循环
智能体编写视图和测试、运行测试，并查看通过或失败结果。逐步演示一个真实界面，从提示词到测试通过。
在 /greeting 添加 webforJ 问候视图，包含姓名字段、“问候”按钮，以及显示“你好”和姓名的段落。
除此之外无需任何内容：屏幕与代码之间不需要模板、JavaScript 或 REST 层。
连接 MCP 服务器后，智能体已在写入 Composite、Button 和 @Route 前查询过它们。
@Route("greeting")
public class GreetingView extends Composite<Div> {
private final TextField name = new TextField("Name");
private final Paragraph message = new Paragraph();
private final Button greet =
new Button("Greet", ButtonTheme.PRIMARY, e -> greet());
public GreetingView() {
getBoundComponent().add(name, greet, message);
}
private void greet() {
message.setText("Hello, " + name.getValue() + "!");
}
}
01 webforJ AI 插件
该插件集成了 MCP 服务器和 Agent Skills。两者协同，让原本靠猜测 webforJ 约定的助手转而遵循这些约定。
在提示中提及 webforJ，即可引导助手使用插件，而非通用 Java 知识。
01a MCP 服务器，AI 插件的一部分
Model Context Protocol 是一项开放标准，让 AI 助手按需调用外部工具。webforJ MCP 服务器基于真实框架提供答案，涵盖文档、设计令牌、组件样式和项目脚手架。
验证可在发布前捕获拼写错误和虚构令牌，避免 CSS 静默失效。
有 pom.xml 时会读取该文件，否则会询问你。此后的回答都会针对你的版本。
关于 API 的问题、指南、代码示例或 Kotlin DSL，答案均来自真实框架。
如何在 webforJ 中使用 @Route 设置路由？适用于 hello-world、blank、tabs 或 sidemenu，并采用 webforj 或 webforj-spring 版本的正确 Maven 原型命令。
使用 sidemenu 原型创建一个名为 CustomerPortal 的 webforJ 项目基于单一品牌色生成主色、成功、警告、危险、信息、默认和灰色调色板，并自动确保文本对比度。
根据品牌色 #6366f1 生成 webforJ 主题编写任何 CSS 之前，请先阅读 CSS 自定义属性、Shadow Parts、反射属性和插槽。
dwc-button 提供哪些 CSS 变量和部件？对照真实的 --dwc-* 目录检查 CSS、Java 或 Markdown，并标记未知名称、建议更正。
检查 app.css 中是否存在未知的 --dwc-* 令牌claude mcp add webforj-mcp https://mcp.webforj.com/mcp -t http -s user
01b 智能体技能，AI 插件的一部分
MCP 服务器提供准确信息。技能会告诉助手何时查找信息、采用哪种方法，以及按什么顺序操作。
技能遵循开放的 Agent Skills 标准。当你的提示与某项技能匹配时，助手会自动加载该技能。
webforj-adding-servlets在 webforJ UI 旁提供 REST endpoints、webhooks 和 custom servlets。
添加 REST 端点 /api/orders。webforj-building-forms数据绑定、Jakarta 验证、掩码输入框和响应式表单布局。
创建绑定到我的 User bean 的注册表单。webforj-creating-components来自 Custom Elements、JavaScript 库或组合的可复用 Java 组件。
将这些 webforJ 组件组合成可复用的卡片。webforj-handling-timers-and-async使用 Interval、Debouncer、Environment.runLater 和 PendingResult，而非原始计时器和线程。
每 30 秒刷新此仪表板。webforj-localizing-apps消息资源包、运行时语言切换和浏览器区域设置检测。
添加英语和西班牙语支持。webforj-securing-apps登录、注销、基于角色的访问控制和默认安全的路由。
保护 /admin，仅允许具有 ADMIN 角色的用户查看。webforj-styling-apps主题、调色板和组件样式，验证每个 --dwc-* 令牌。
将此应用设为蓝色主题。webforj-upgrading-versions使用官方 webforj-rewrite OpenRewrite 规则进行主版本升级。
将此应用从 webforJ 25 升级到 26。02 TestBed
视图在普通 JUnit 测试中运行。组件会像在应用中一样挂载、触发事件并导航。
每次交互都会在测试执行下一行之前完成，因此无需等待，也不会偶发失败。Spring Boot 应用使用 webforj-spring-testbed 模块。
ComponentLocator根据组件类型及其显示内容，以用户识别它的方式进行描述。
UserInteraction仅执行用户能够进行的操作。点击已禁用的按钮会导致测试失败。
verifyThat检查用户会看到的内容；失败时会指出组件名称和两个值。
<dependency>
<groupId>com.webforj</groupId>
<artifactId>webforj-testbed-junit</artifactId>
<scope>test</scope>
</dependency>
03 craftforJ Assistant
它可以自由编写 Java，每次编辑后都会先编译，再应用到运行中的应用。应用更改会重启应用，重启后代理会继续执行计划。
它随 webforJ 一同提供，因此无需安装。craftforJ 不附带自有模型：添加受支持提供商的 API 密钥，或将其连接到通过 Ollama 在本地运行的模型。
webforj.debug = true
webforj.devtools.craftforj.enabled = true
如何开始
选一个你本周原本要手动开发的页面。webforJ 是面向企业 Web 应用的全栈 Java 框架：整个应用，包括页面，都用 Java 构建。
claude plugin marketplace add webforj/webforj-ai
claude plugin install webforj@webforj-ai
向 MCP 服务器获取项目，或打开现有项目。
描述你关心的行为，让测试验证它。
mvn test 并查看结果