TeaQL Java：面向人类与编程 Agent 协同的确定性 Java 领域运行时

核心能力与快速开始

★ 4 · Java

能做什么

TeaQL Java 是 TeaQL 领域应用的 Java 运行时，提供类型化实体和请求模型、可审计执行、可插拔运行时能力、可移植 SQL 支持与数据库方言、以及服务端 Java 和 Android 集成。其五项保障机制包括：以 UserContext 承载身份、追踪与运行时能力的上下文绑定执行；读操作需声明 .comment(...).purpose(...)、写操作需 .auditAs(...) 的声明式意图；可检查或拒绝 select、insert、update、delete、recover 操作的 RequestPolicy 策略门；通过独立模块和注册运行时能力提供的显式能力（如 HTTP 工具、动态字段、业务 ID 生成）；以及以类型化实体图持久化替代临时更新语句和关系循环的类型化图变更。运行时还通过可插拔 RuntimeLogSink 记录执行元数据。

适用场景

适合构建数据库支撑的 Java 应用，尤其是代码可能由人类与编程 Agent 共同编写或操作、需要把执行限制在显式上下文、意图、策略与能力边界内的场景。可用于 Spring Boot + JDBC、纯 JVM/Quarkus/Micronaut + JDBC、Android 或可移植 SQL 客户端、以及内存执行等不同集成方式；官方建议与 TeaQL Agent Kit 配合用于领域建模、确定性评估与修复、代码生成、实现和基于证据的验证。

项目形态

开发框架

部署方式

README 说明其可集成于服务端 Java 与 Android，支持 Spring Boot 兼容 starter，以及纯 JVM、Quarkus、Micronaut、Android 和可移植 SQL 客户端等路径；构建命令为 mvn clean install，但未说明具体生产部署拓扑、托管方式或完整运维要求。

主要依赖

Java 17 或更高版本；Maven 3.8 或更高版本。集成方式不同所需模块不同，例如多数应用需要核心运行时、一条数据访问路径和一个数据库方言；PostgreSQL/MySQL 集成测试需要专用且新建的 teaql_live_* 数据库。

使用限制

README 未说明性能上限、规模化部署限制、API 成本或完整商用限制。运行时默认日志包含 intent、trace、耗时、结果和参数化 SQL，但不含绑定值与渲染后的 Debug SQL；诊断 SQL 日志会包含值与 Debug SQL，需配合限制性留存策略，可选文件型 LogManager 仅在 TEAQL_SQL_LOG=_full_with_payload 时请求含值 SQL，需限制访问与留存。动态值和附加值应保持 JSON 友好，任意应用对象仍可能触发 Jackson 默认 bean 内省。

许可证

Apache-2.0

最近推送

2026-09-24 05:52

资料检查：2026-09-24 07:00 · 卡片整理：2026-09-24 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容