cc 50 minuuttia sitten
vanhempi
commit
d9e9e873ad
23 muutettua tiedostoa jossa 421 lisäystä ja 189 poistoa
  1. 5 4
      AI_AGENT.md
  2. 55 29
      QUICK_START.md
  3. 4 3
      ai-electron/frontend/src/core/layouts/default/setting/api.ts
  4. 5 16
      ai-server/pom.xml
  5. 31 0
      ai-server/src/main/java/com/zsjz/ai/common/config/DataSourceConfig.java
  6. 3 3
      ai-server/src/main/java/com/zsjz/ai/common/config/MybatisPlusConfig.java
  7. 2 1
      ai-server/src/main/java/com/zsjz/ai/common/constants/PathConst.java
  8. 1 1
      ai-server/src/main/java/com/zsjz/ai/common/datasource/CaseRoutingDataSource.java
  9. 1 1
      ai-server/src/main/java/com/zsjz/ai/common/model/plat/dto/ServiceHealthDTO.java
  10. 0 51
      ai-server/src/main/java/com/zsjz/ai/common/pgsql/JsonbTypeHandler.java
  11. 5 0
      ai-server/src/main/java/com/zsjz/ai/module/aiclean/index/AiCleanTemplateVectorIndex.java
  12. 0 2
      ai-server/src/main/java/com/zsjz/ai/module/plat/mapper/SystemInfoMapper.java
  13. 11 11
      ai-server/src/main/java/com/zsjz/ai/module/plat/service/SystemHealthService.java
  14. 3 12
      ai-server/src/main/java/com/zsjz/ai/module/plat/service/SystemService.java
  15. 16 10
      ai-server/src/main/resources/application-dev.yaml
  16. 16 10
      ai-server/src/main/resources/application-pro.yaml
  17. 5 3
      ai-server/src/main/resources/application.yaml
  18. 0 22
      ai-server/src/main/resources/mappers/plat/SystemInfoMapper.xml
  19. 10 3
      ai-server/src/test/java/com/zsjz/ai/module/aiclean/AiCleanSchemaTest.java
  20. 11 7
      deploy/env.sh
  21. 3 0
      sql/ai_clean.sql
  22. 222 0
      sql/ai_clean_sqlite.sql
  23. 12 0
      sql/plat.sql

+ 5 - 4
AI_AGENT.md

@@ -57,7 +57,7 @@ zsjz-ai/
 | JDK | **25** |
 | 框架 | Spring Boot 3.5.16 |
 | 持久层 | MyBatis-Plus 3.5.17 + dynamic-datasource 4.5.0 |
-| 主库 | **PostgreSQL** + pgvector(master) |
+| 主库 | **加密 SQLite**(master,`qingjian/system/db/plat`,SQLiteMC aes256cbc,驱动内嵌) |
 | 分析库 | **DuckDB**(slave,按工作空间切换) |
 | 缓存 | Redis |
 | 图库 | Neo4j(配置存在,非全链路强依赖) |
@@ -145,7 +145,7 @@ ai-server/src/main/resources/mappers/<domain>/<Xxx>Mapper.xml
 
 | 数据源 | 用途 |
 |---|---|
-| **master**(PostgreSQL + pgvector) | 平台元数据、`table_info`/`table_field`、Agent 会话/消息、模型与 Provider 配置、**技能**(`agentscope_skills`/`agentscope_skill_resources`,按 namespace=用户ID 隔离 + 启停表 `agent_skill_state`)、RAG 索引状态、向量检索 |
+| **master**(加密 SQLite 平台库) | 平台元数据、`table_info`/`table_field`、`case_info`、`system_info`、银行卡/运营商字典、`lunar`,以及 AI 清洗元数据 `ai_clean_template`/`field`/`rule`/`job`/`batch`/`synonym`。向量召回已随 SQLite 回退关闭(`zsjz.ai-clean.vector.enabled=false`) |
 | **slave**(DuckDB) | **按工作空间切换**的案情库;Agent 的 `execute_sql` 只在这里跑 |
 | Redis | Sa-Token 登录态、业务缓存(`qing_jian_ai*`)、mem0、**Agent 会话状态**(`qing_jian:agent:{agentscope}:session:*`,由 `RedisAgentStateStore` 存对话历史) |
 | Neo4j | 图谱(配置在 `application-dev.yaml`) |
@@ -191,7 +191,7 @@ entity/       AgentChatSession、AgentMessage、AgentModel、AgentModelProvider
 |---|---|
 | `execute_sql` | 在当前工作空间 DuckDB 上执行**只读** SQL,返回 resultId + 列定义 + 当前页 + 总行数 |
 | `list_tables` | 列出**已登记的可查表**(`table_info` + `ai_clean_template` 含 AI 动态表 + `wa_mforensics_` 取证表结构文件):物理表名/中文名/字段(物理列名、类型、中文注释、必填)。不扫描 DuckDB(业务约定:先登记元数据才可查);取证表只含 `vectorize=true` 的表,`wa_mforensics_ext_*` 不进清单 |
-| `search_table_schema` | 基于 pgvector 的模板元数据语义检索(`AiCleanTemplateVectorIndex`):返回物理表名 + 字段,供生成 SQL;同一份向量索引也用于 AI 模板匹配召回 |
+| `search_table_schema` | 模板元数据语义检索(`AiCleanTemplateVectorIndex`):返回物理表名 + 字段,供生成 SQL;同一份向量索引也用于 AI 模板匹配召回。**当前默认关闭** —— 其 SQL 是 pgvector 专有方言,主库还原为 SQLite 后无等价能力(`zsjz.ai-clean.vector.enabled=false`),关闭时按无召回处理 |
 | `render_chart` | 校验并返回 ECharts 图表配置(**禁止**用于关系图) |
 | `execute_python` | 在沙箱中执行 Python 脚本分析,产出图片经 `/py/files/**` 访问;任意表/字段的关系图用沙箱内置 `emit_relation_graph(nodes, edges, title)` 输出 `relation_graph.json`,后端转成 `relationGraph` 交给前端通用关系图组件 |
 | `get_current_workspace` / `get_user_selected_workspace` | 读取当前/用户所选工作空间信息 |
@@ -474,7 +474,8 @@ pnpm preview:dist     # 预览 :3100
 ```
 
 ### 依赖服务
-PostgreSQL(**需装 pgvector 扩展**)、Redis、Neo4j(按需)。
+ai-server:**无需任何外部数据库服务** —— 主库是内嵌驱动的加密 SQLite 文件,案件库是内嵌驱动的 DuckDB 文件。Neo4j 按需。
+ai-gateway(独立进程):PostgreSQL(**需装 pgvector 扩展**)、Redis。
 
 ---
 

+ 55 - 29
QUICK_START.md

@@ -30,15 +30,16 @@ zsjz-ai/
 | Maven | 3.9.x+ | `mvn -v` |
 | Node | `>=20.19 \|\| >=22.12`(`package.json` engines) | `node -v` |
 | pnpm | 10.x(**只能用 pnpm**,`preinstall: only-allow pnpm`) | `pnpm -v` |
-| PostgreSQL | 14+,**必须装 pgvector 扩展** | — |
-| Redis | 任意近期版本 | — |
+| SQLite 平台库 | 无需安装,加密 SQLite 文件 + JDBC 驱动内嵌(`qingjian/system/db/plat`) | — |
 | DuckDB | 无需安装,JDBC 驱动内嵌(案件分析库) | — |
+| PostgreSQL | 14+ 且**必须装 pgvector**,但**仅 ai-gateway 需要**,ai-server 不用 | — |
+| Redis | 任意近期版本,**仅 ai-gateway 需要** | — |
 | Neo4j | 可选,仅在配置图谱能力时需要 | — |
 | ffmpeg + Vosk 中文模型 | 可选,仅**音视频转写**需要(图片/扫描件 OCR 不需要任何外部资产) | `ffmpeg -version`;模型目录含 `am/` |
 
 > 依赖服务的硬/软关系:
-> - **Redis 是登录的硬依赖** —— `sa-token-redis-jackson` 已装配,Redis 不可用则所有 `StpUtil.*` 抛异常,无降级实现。
-> - **PostgreSQL(master)** 存平台元数据 / Agent 会话 / 模型配置 / 向量,不可用则起不来。
+> - **SQLite(master)** 是加密文件库 `qingjian/system/db/plat`,存平台元数据(`table_info` / `table_field` / `case_info` / 银行卡与运营商字典 / `lunar`)与 AI 清洗元数据(`ai_clean_*`)。文件不存在时 `DataSourceConfig` 直接启动失败,**不会静默新建空库**。
+> - **ai-gateway 是独立进程**,仍依赖 PostgreSQL(+pgvector) 与 Redis(`sa-token-redis-jackson` 已装配,Redis 不可用则所有 `StpUtil.*` 抛异常,无降级实现)。只跑 ai-server 时这两者都不需要。
 > - **全文检索**(`module/search`)是进程内嵌入式 Lucene,索引落在各案件目录 `data/cases/{caseId}/lucene`,**不依赖任何外部检索服务**。
 > - **DuckDB(slave)** 是按案件/工作空间切换的文件库,不是常驻服务。
 > - **图片/扫描件 OCR** 用 PP-OCRv4,模型随 `rapidocr4j` jar 分发、OpenCV 原生库在 `openpnp:opencv` jar 内 —— **无需安装 tesseract、无需下载模型**;Linux 需 glibc ≥ 2.27。
@@ -48,27 +49,31 @@ zsjz-ai/
 
 ## 3. 准备依赖服务
 
-### 3.1 PostgreSQL
+### 3.1 平台库(加密 SQLite)
 
-```sql
-CREATE DATABASE "zsjz-ai";
-\c zsjz-ai
-CREATE EXTENSION IF NOT EXISTS vector;   -- pgvector,RAG 向量检索必需
-```
+ai-server 的主库是一个**加密 SQLite 文件**,不是数据库服务:
+
+| 项 | 值 |
+|---|---|
+| 文件 | `qingjian/system/db/plat`(`PathConst.PLAT_DB_PATH`) |
+| 驱动 | `org.sqlite.JDBC`,由 `io.github.willena:sqlite-jdbc:3.51.1.0` 提供(SQLiteMC 分支,`org.xerial` 原版不支持加密) |
+| 加密参数 | `cipher=aes256cbc&key=xcj7xymg` |
+| 并发参数 | `busy_timeout=15000&transaction_mode=IMMEDIATE`(`journal_mode` 保持库原有的 `delete`,不改 WAL) |
 
-连接信息写在 `ai-server/src/main/resources/application-dev.yaml`:
+配置写在 `ai-server/src/main/resources/application-dev.yaml`(pro 同结构):
 
 ```yaml
 spring.datasource.dynamic.datasource.master:
-  url: jdbc:postgresql://192.168.0.109:5432/zsjz-ai
-  username: postgres
-  password: postgres
-spring.data.redis:      host 192.168.0.109 / port 6379
+  url: jdbc:sqlite:file:qingjian/system/db/plat?cipher=aes256cbc&key=xcj7xymg&busy_timeout=15000&transaction_mode=IMMEDIATE
+  driver-class-name: org.sqlite.JDBC
 ```
 
-**换成自己的本机地址即可**(改这一个文件,`application.yaml` 是公共配置,不要动它的 `context-path`)。
+url 里的路径**只是占位**:`DataSourceConfig` 会按 `PathConst.PLAT_DB_PATH` 换成绝对路径,并在文件不存在时直接抛异常终止启动 —— 否则 SQLite 会静默新建一个空加密库,应用照常起来然后满屏 `no such table`。
 
-> ⚠️ 该文件里存的是**内网 IP + 明文口令**,只为开发便利。不要把真实凭证提交到公开仓库,也不要在生产 profile 复用 dev 配置。
+> 该文件随 `qingjian/` 一起被 `.gitignore` 忽略,新环境需从已有环境拷贝(见 §3.2)。
+> 拿到文件后还要补建 AI 清洗元数据表,见 §4。
+
+**ai-gateway 另算**:它是独立进程,仍连 PostgreSQL(+pgvector) 与 Redis,配置在 `ai-gateway/src/main/resources/application-dev.yaml`,与上面这套无关。
 
 ### 3.2 qingjian 运行期资产与业务数据
 
@@ -106,25 +111,46 @@ qingjian/
 
 | 脚本 | 目标库 | 内容 |
 |---|---|---|
-| `sql/user.sql` | PostgreSQL(master) | `sys_user` + 案件归属迁移,**幂等可重复执行** |
-| `sql/insight_agent_tables.sql` | PostgreSQL(master) | `agent_insight_session` / `agent_insight_message` |
-| `sql/insight_agent_tables_align.sql` | PostgreSQL(master) | 上表的约束/索引补丁 |
-| `sql/plat.sql` | 平台库 | 平台元数据表(`table_info` / `table_field` / `case_info` / `bank_card_issuer_info` …),**含 Solon 时代的 `chat_*` 旧表,与当前 `agent_*` 实体不完全对应** |
+| `sql/ai_clean_sqlite.sql` | 平台库(加密 SQLite) | 6 张 `ai_clean_*` 表 + 11 个索引 + 17 条内置同义词,**幂等可重复执行** |
+| `sql/plat.sql` | — | **历史参考脚本,严禁执行**:以 `drop table` 开头,会删掉平台库在用的表;且含已删除模块的 `chat_*` / `knowledge_*` 旧表 |
+| `sql/ai_clean.sql` | — | PG 时代参考,列集合与 `ai_clean_sqlite.sql` 一致,不再对运行期库执行 |
 | `sql/external_tables.sql` / `external_table_field.sql` | 案件库(DuckDB) + 元数据 | 13 张外部数据表建表 + `table_info`/`table_field` 登记 |
 | `sql/case_table*.sql`、`create_table_2.sql`、`table_data_1.sql` | 案件库(DuckDB) | 案件业务表与初始配置 |
 
+`sql/` 下其余 `agent_*` / `insight_*` / `knowledge_*` / `gateway.sql` / `revert-user-system.sql` 属已删除模块或 ai-gateway,**ai-server 不需要执行**。
+
+### 4.1 平台库补建 AI 清洗元数据表
+
+`plat` 文件里已有平台元数据表与字典数据(`table_info` / `table_field` / `case_info` / `system_info` / `lunar` / `phone_isp` / `bank_card_issuer_info`),**这些表一律不动**。需要补建的只有 6 张 `ai_clean_*`。
+
+本机没有 sqlite3 CLI,Python 也打不开加密库,用驱动 jar + jshell 执行(**先停 ai-server,并先备份 plat 文件**):
+
 ```bash
-# 平台库(PostgreSQL)
-psql -h <host> -U postgres -d zsjz-ai -f sql/user.sql
-psql -h <host> -U postgres -d zsjz-ai -f sql/insight_agent_tables.sql
-psql -h <host> -U postgres -d zsjz-ai -f sql/insight_agent_tables_align.sql
+cd E:/workspace/zsjz-ai
+cp qingjian/system/db/plat qingjian/system/db/plat.bak-$(date +%Y%m%d)
+
+jshell --class-path "D:/soft/repository/io/github/willena/sqlite-jdbc/3.51.1.0/sqlite-jdbc-3.51.1.0.jar" --feedback silent - <<'EOF'
+import java.sql.*; import java.nio.file.*;
+Connection c = DriverManager.getConnection("jdbc:sqlite:file:E:/workspace/zsjz-ai/qingjian/system/db/plat?cipher=aes256cbc&key=xcj7xymg");
+String sql = Files.readString(Path.of("sql/ai_clean_sqlite.sql"));
+c.setAutoCommit(false);
+for (String s : sql.split(";")) { String t = s.replaceAll("(?m)^\\s*--.*$", "").trim(); if (!t.isEmpty()) c.createStatement().execute(t); }
+c.commit(); c.close();
+/exit
+EOF
 ```
 
-初始账号(`sql/user.sql` 内置,BCrypt 哈希):**`admin` / `admin123`**,首次登录后立刻改密。
+> jar 路径按本机 Maven 仓库调整(本项目是 `D:/soft/repository`,不是 `~/.m2`)。
+> 脚本按 `;` 切分逐条执行 —— SQLite JDBC 对多语句串只执行第一条,整篇灌进去不会生效。
+> 复核:6 张新表 + 11 个索引存在,`ai_clean_synonym` 17 行、其余 5 张 0 行,原有表行数不变。
+
+### 4.2 案件库
+
+案件库按案件隔离,建案时由 `CaseInfoService#create` 从模板 `qingjian/system/db/5w8mf4kf` 复制生成,无需手工初始化。
 
-> ⚠️ **已知缺口(搭建新环境前必读)**:`agent_chat_session`、`agent_message`、`agent_model`、`agent_model_provider`、`rag_index_status` 等当前 Agent 实体对应的平台表,**在 `sql/` 下没有完整建表脚本**。`AI_AGENT.md` §11.8 记录:开发库 `zsjz-ai` 缺平台库结构(平台表在另一套 `etl-2` 库),裸跑会在启动后置任务阶段报 `PSQLException: 关系 "table_info" 不存在`。
-> 新环境请**从已有可用环境导出平台库结构**(`pg_dump --schema-only`)后再启动,别指望 `sql/` 目录自带全套。
-> 改表结构时务必补 `sql/` 脚本,并同步 `table_info` / `table_field` 元数据三表链路。
+> ⚠️ 平台库的 `table_info` / `table_field` 元数据是清洗与治理树的真源,**新环境必须从已有可用环境拷贝整个 `plat` 文件**,`sql/` 目录不自带这套数据。
+> 改表结构时务必补 `sql/` 脚本,并同步 `table_info` / `table_field` 元数据链路。
+> 升级包(`POST /sys/uploadUpgrade`)**不再覆盖平台库、也不对它执行建表脚本**,只逐案执行案件库升级 SQL。
 
 ---
 

+ 4 - 3
ai-electron/frontend/src/core/layouts/default/setting/api.ts

@@ -4,9 +4,9 @@ const { adminPath, ctxPath } = useGlobSetting();
 
 export const cleanCache = () => defHttp.get<void>({ url: adminPath + '/sys/cleanCache' });
 
-/** 系统服务健康状态项(后端 / PostgreSQL) */
+/** 系统服务健康状态项(后端 / SQLite 平台库) */
 export interface ServiceHealthItem {
-  name: 'backend' | 'postgresql';
+  name: 'backend' | 'sqlite';
   label: string;
   up: boolean;
   latencyMs: number;
@@ -22,7 +22,8 @@ export const getServiceHealth = () =>
 
 /**
  * 上传升级包并执行升级(Web 化:前端上传 zip,不再传服务端路径)。
- * 升级耗时较长(解压 + 覆盖数据库 + 执行升级 SQL),超时给了 30 分钟。
+ * 升级耗时较长(解压 + 复制基础库 + 逐案执行案件库升级 SQL),超时给了 30 分钟。
+ * 平台库 plat 是运行期加密 SQLite 主库,升级包不覆盖它、也不对它执行建表脚本。
  */
 export const uploadUpgradePackage = (file: File, onProgress?: (percent: number) => void) =>
   defHttp.uploadFile<void>(

+ 5 - 16
ai-server/pom.xml

@@ -24,7 +24,6 @@
         <commonmark.version>0.17.0</commonmark.version>
         <commons-compress.version>1.28.0</commons-compress.version>
         <testcontainers.version>1.21.4</testcontainers.version>
-        <pgvector.version>0.1.6</pgvector.version>
         <djl.version>0.38.0</djl.version>
         <onnxruntime.version>1.30.0</onnxruntime.version>
         <!-- 文档解析扩展:Tika 显式钉版本;PP-OCR 走 rapidocr4j(模型内置);ASR 走 Vosk -->
@@ -144,16 +143,12 @@
             <version>${vosk.version}</version>
         </dependency>
 
+        <!-- 平台主库:加密 SQLite(SQLiteMC / io.github.willena 分支),驱动 org.sqlite.JDBC。
+             URL 参数 cipher=aes256cbc&key=... 由该分支提供,org.xerial 原版不支持。 -->
         <dependency>
-            <groupId>org.postgresql</groupId>
-            <artifactId>postgresql</artifactId>
-        </dependency>
-
-        <!-- pgvector Java SDK for PostgreSQL vector extension -->
-        <dependency>
-            <groupId>com.pgvector</groupId>
-            <artifactId>pgvector</artifactId>
-            <version>${pgvector.version}</version>
+            <groupId>io.github.willena</groupId>
+            <artifactId>sqlite-jdbc</artifactId>
+            <version>3.51.1.0</version>
         </dependency>
 
         <!-- 本地嵌入模型推理:DJL HuggingFace 分词器(Rust 原生,加载 tokenizer.json,
@@ -181,12 +176,6 @@
             <version>1.5.6.0</version>
         </dependency>
 
-        <!-- Spring Batch(eds/bcp 迁移代码依赖,版本由 Spring Boot BOM 管理) -->
-        <dependency>
-            <groupId>org.springframework.boot</groupId>
-            <artifactId>spring-boot-starter-batch</artifactId>
-        </dependency>
-
         <!-- XStream(eds/bcp 迁移代码中 XML 序列化) -->
         <dependency>
             <groupId>com.thoughtworks.xstream</groupId>

+ 31 - 0
ai-server/src/main/java/com/zsjz/ai/common/config/DataSourceConfig.java

@@ -1,11 +1,14 @@
 package com.zsjz.ai.common.config;
 
+import com.baomidou.dynamic.datasource.creator.DataSourceProperty;
 import com.baomidou.dynamic.datasource.provider.DynamicDataSourceProvider;
 import com.baomidou.dynamic.datasource.spring.boot.autoconfigure.DynamicDataSourceProperties;
+import com.zsjz.ai.common.constants.PathConst;
 import com.zsjz.ai.common.datasource.CaseRoutingDataSource;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 
+import java.nio.file.Files;
 import java.util.List;
 
 /**
@@ -26,6 +29,7 @@ public class DataSourceConfig {
     public CaseRoutingDataSource caseRoutingDataSource(
             List<DynamicDataSourceProvider> providers,
             DynamicDataSourceProperties properties) {
+        absolutizeSqliteMasterUrl(properties);
         CaseRoutingDataSource dataSource = new CaseRoutingDataSource(providers);
         dataSource.setPrimary(properties.getPrimary());
         dataSource.setStrict(properties.getStrict());
@@ -35,4 +39,31 @@ public class DataSourceConfig {
         dataSource.setGraceDestroy(properties.getGraceDestroy());
         return dataSource;
     }
+
+    /**
+     * 把 SQLite 主库 url 里的占位路径换成 {@link PathConst#PLAT_DB_PATH} 的绝对路径。
+     *
+     * <p><b>为什么必须做</b>:SQLite 连接时文件不存在会静默新建一个空库,应用照常启动,
+     * 然后满屏 no such table。而 {@code user.dir} 会随启动方式漂移(IDE 可能设在 ai-server/),
+     * yaml 里的相对路径不可靠 —— {@link PathConst} 的根目录解析正是为此存在。
+     *
+     * <p><b>时序</b>:{@code DynamicRoutingDataSource} 构造函数只存 providers,真正
+     * {@code loadDataSources()} 在其 {@code afterPropertiesSet()} 里,Spring 在本方法返回后才调用;
+     * 且这里是就地改共享的 {@link DataSourceProperty} 对象,provider 无论何时读都拿到新值。
+     */
+    private static void absolutizeSqliteMasterUrl(DynamicDataSourceProperties properties) {
+        DataSourceProperty master = properties.getDatasource().get(properties.getPrimary());
+        if (master == null || master.getUrl() == null || !master.getUrl().startsWith("jdbc:sqlite:")) {
+            return;
+        }
+        if (!Files.isRegularFile(PathConst.PLAT_DB_PATH)) {
+            throw new IllegalStateException("平台库文件不存在: " + PathConst.PLAT_DB_PATH
+                    + ",请先初始化 plat 并执行 sql/ai_clean_sqlite.sql(见 QUICK_START)");
+        }
+        String url = master.getUrl();
+        int queryStart = url.indexOf('?');
+        master.setUrl("jdbc:sqlite:file:"
+                + PathConst.PLAT_DB_PATH.toAbsolutePath().toString().replace('\\', '/')
+                + (queryStart >= 0 ? url.substring(queryStart) : ""));
+    }
 }

+ 3 - 3
ai-server/src/main/java/com/zsjz/ai/common/config/MybatisPlusConfig.java

@@ -1,6 +1,5 @@
 package com.zsjz.ai.common.config;
 
-import com.baomidou.mybatisplus.annotation.DbType;
 import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
 import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
 import org.springframework.context.annotation.Bean;
@@ -17,8 +16,9 @@ public class MybatisPlusConfig {
     public MybatisPlusInterceptor mybatisPlusInterceptor() {
         MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
         // 如果配置多个插件, 切记分页最后添加
-        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.DUCKDB));
-        // 如果有多数据源可以不配具体类型, 否则都建议配上具体的 DbType
+        // 不指定 DbType:master(SQLite) 与 slave(DuckDB) 共用本拦截器,按连接 url 自动识别方言。
+        // 两者在 MP 里都归入 postgresqlSameType,生成 LIMIT ? OFFSET ?,各自均支持。
+        interceptor.addInnerInterceptor(new PaginationInnerInterceptor());
         return interceptor;
     }
 }

+ 2 - 1
ai-server/src/main/java/com/zsjz/ai/common/constants/PathConst.java

@@ -66,7 +66,8 @@ public class PathConst {
      */
     public static final Path BASE_CASE_DB_PATH = SYSTEM_PATH.resolve("db").resolve("5w8mf4kf");
     /**
-     * 平台库(升级补丁用)
+     * 平台库:运行期主库(master),加密 SQLite 文件。
+     * 数据源 url 由 {@code DataSourceConfig} 按本路径绝对化。
      */
     public static final Path PLAT_DB_PATH = SYSTEM_PATH.resolve("db").resolve("plat");
 

+ 1 - 1
ai-server/src/main/java/com/zsjz/ai/common/datasource/CaseRoutingDataSource.java

@@ -31,7 +31,7 @@ import java.util.List;
  * 之后解析该 key 会走负载均衡策略,造成随机串库且极难排查。故统一用 {@code case12}。
  *
  * <p><b>与 strict 的关系</b>:{@code spring.datasource.dynamic.strict} 保持 false(不影响其它 key 的容错),
- * 由本类对 {@code slave} 显式抛业务异常,替代原先「静默回退 master(PG) 然后报关系不存在」的坑。
+ * 由本类对 {@code slave} 显式抛业务异常,替代原先「静默回退 master 然后报表不存在」的坑。
  *
  * @see CaseDataSourceRegistry
  */

+ 1 - 1
ai-server/src/main/java/com/zsjz/ai/common/model/plat/dto/ServiceHealthDTO.java

@@ -17,7 +17,7 @@ import java.io.Serializable;
 public class ServiceHealthDTO implements Serializable {
 
     /**
-     * 服务标识:backend / postgresql
+     * 服务标识:backend / sqlite
      */
     private String name;
 

+ 0 - 51
ai-server/src/main/java/com/zsjz/ai/common/pgsql/JsonbTypeHandler.java

@@ -1,51 +0,0 @@
-package com.zsjz.ai.common.pgsql;
-
-import org.apache.ibatis.type.BaseTypeHandler;
-import org.apache.ibatis.type.JdbcType;
-import org.apache.ibatis.type.MappedJdbcTypes;
-import org.apache.ibatis.type.MappedTypes;
-import org.postgresql.util.PGobject;
-
-import java.sql.CallableStatement;
-import java.sql.PreparedStatement;
-import java.sql.ResultSet;
-import java.sql.SQLException;
-
-/**
- * PostgreSQL JSONB类型处理器
- * 使用PGobject显式声明jsonb类型,避免PostgreSQL将参数识别为varchar
- *
- * @author cc
- * @since 2026-05-19
- */
-@MappedTypes(String.class)
-@MappedJdbcTypes(JdbcType.OTHER)
-public class JsonbTypeHandler extends BaseTypeHandler<String> {
-
-    @Override
-    public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) throws SQLException {
-        if (parameter == null || parameter.isBlank()) {
-            ps.setNull(i, JdbcType.OTHER.TYPE_CODE);
-            return;
-        }
-        PGobject pgObject = new PGobject();
-        pgObject.setType("jsonb");
-        pgObject.setValue(parameter);
-        ps.setObject(i, pgObject);
-    }
-
-    @Override
-    public String getNullableResult(ResultSet rs, String columnName) throws SQLException {
-        return rs.getString(columnName);
-    }
-
-    @Override
-    public String getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
-        return rs.getString(columnIndex);
-    }
-
-    @Override
-    public String getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
-        return cs.getString(columnIndex);
-    }
-}

+ 5 - 0
ai-server/src/main/java/com/zsjz/ai/module/aiclean/index/AiCleanTemplateVectorIndex.java

@@ -366,6 +366,11 @@ public class AiCleanTemplateVectorIndex {
      */
     public IndexStatus status() {
         try {
+            // 开关关闭时直接返回:否则会去探测 pgvector 专有方言的向量表,
+            // 在 SQLite 主库上必然失败,虽然被吞掉但每次调用都刷一条 debug 噪音。
+            if (!properties.isEnabled()) {
+                return new IndexStatus(false, null, null, 0, 0L);
+            }
             if (!embeddingProvider.isAvailable()) {
                 return new IndexStatus(false, null, null, 0, 0L);
             }

+ 0 - 2
ai-server/src/main/java/com/zsjz/ai/module/plat/mapper/SystemInfoMapper.java

@@ -12,8 +12,6 @@ import org.apache.ibatis.annotations.Mapper;
 */
 @Mapper
 public interface SystemInfoMapper extends BaseMapper<SystemInfo> {
-
-    void executePlatSql(String platSql);
 }
 
 

+ 11 - 11
ai-server/src/main/java/com/zsjz/ai/module/plat/service/SystemHealthService.java

@@ -22,7 +22,7 @@ import java.util.concurrent.TimeoutException;
 /**
  * 系统服务健康检查
  *
- * <p>供设置 → 系统服务展示:后端自身、PostgreSQL 的可用性与探测耗时。
+ * <p>供设置 → 系统服务展示:后端自身、SQLite 平台库的可用性与探测耗时。
  * 探测并发执行,单项超时 {@value #PROBE_TIMEOUT_SECONDS} 秒即判为异常,
  * 避免任一依赖不可达时把整个接口拖到客户端超时。
  */
@@ -38,16 +38,16 @@ public class SystemHealthService {
     /**
      * 探测全部系统服务
      *
-     * @return 按「后端服务、PostgreSQL」顺序排列的探测结果
+     * @return 按「后端服务、SQLite 平台库」顺序排列的探测结果
      */
     public List<ServiceHealthDTO> check() {
         ExecutorService executor = Executors.newVirtualThreadPerTaskExecutor();
         try {
-            Future<ServiceHealthDTO> dbFuture = executor.submit(this::checkPostgresql);
+            Future<ServiceHealthDTO> dbFuture = executor.submit(this::checkSqlite);
 
             List<ServiceHealthDTO> result = new ArrayList<>(2);
             result.add(checkBackend());
-            result.add(await(dbFuture, "postgresql", "PostgreSQL"));
+            result.add(await(dbFuture, "sqlite", "SQLite"));
             return result;
         } finally {
             executor.shutdownNow();
@@ -66,12 +66,12 @@ public class SystemHealthService {
     }
 
     /**
-     * PostgreSQL:执行 SELECT 1 验证主库可读写(连接本身可用)。
+     * SQLite 平台库:执行 SELECT 1 验证主库可读写(连接本身可用)。
      *
      * <p>跑在独立虚拟线程上,没有案件上下文 / {@code @DS("slave")},
-     * 因此默认路由到 primary(PostgreSQL),不会误探 DuckDB 案件库。
+     * 因此默认路由到 primary(加密 SQLite 平台库),不会误探 DuckDB 案件库。
      */
-    private ServiceHealthDTO checkPostgresql() {
+    private ServiceHealthDTO checkSqlite() {
         long start = System.nanoTime();
         try (Connection connection = dataSource.getConnection();
              Statement statement = connection.createStatement();
@@ -80,11 +80,11 @@ public class SystemHealthService {
                 throw new IllegalStateException("SELECT 1 返回异常");
             }
             String version = connection.getMetaData().getDatabaseProductVersion();
-            return new ServiceHealthDTO("postgresql", "PostgreSQL", true, elapsedMs(start),
-                    "PostgreSQL " + version + " · SELECT 1 正常");
+            return new ServiceHealthDTO("sqlite", "SQLite", true, elapsedMs(start),
+                    "SQLite " + version + " · SELECT 1 正常");
         } catch (Exception e) {
-            log.info("PostgreSQL 健康检查失败: {}", e.getMessage());
-            return new ServiceHealthDTO("postgresql", "PostgreSQL", false, elapsedMs(start), rootMessage(e));
+            log.info("SQLite 健康检查失败: {}", e.getMessage());
+            return new ServiceHealthDTO("sqlite", "SQLite", false, elapsedMs(start), rootMessage(e));
         }
     }
 

+ 3 - 12
ai-server/src/main/java/com/zsjz/ai/module/plat/service/SystemService.java

@@ -261,7 +261,6 @@ public class SystemService extends ServiceImpl<SystemInfoMapper, SystemInfo> {
         }
         ZipUtil.unzip(path1.toFile(), PathConst.UPGRADE_PATH.toFile());
         Path baseDbPath = PathConst.UPGRADE_PATH.resolve("db");
-        Path platSqlPath = PathConst.UPGRADE_PATH.resolve("sql").resolve("plat.sql");
         Path caseSqlPath = PathConst.UPGRADE_PATH.resolve("sql").resolve("case.sql");
         if (Files.exists(baseDbPath)) {
             log.info("开始复制基础数据库...");
@@ -269,17 +268,9 @@ public class SystemService extends ServiceImpl<SystemInfoMapper, SystemInfo> {
             FileUtil.copy(baseDbPath.toFile(), PathConst.SYSTEM_PATH.toFile(), true);
             log.info("结束复制基础数据库...");
         }
-        if (Files.exists(platSqlPath)) {
-            log.info("开始执行平台数据库升级sql...");
-            FileUtil.copy(platSqlPath.toFile(), PathConst.PLAT_DB_PATH.toFile(), true);
-            String platSql = FileUtil.readUtf8String(platSqlPath.toFile());
-            try {
-                baseMapper.executePlatSql(platSql);
-            } catch (Exception e) {
-                log.error("平台数据库升级sql执行失败!", e);
-            }
-            log.info("结束执行平台数据库升级sql...");
-        }
+        // 平台库 plat 是运行期加密 SQLite 主库,升级包不得覆盖它、也不得对它执行建表脚本
+        // (历史 sql/plat.sql 以 drop table 开头,会删掉在用的表)。
+        // 平台库结构变更走一次性迁移脚本,见 sql/ai_clean_sqlite.sql 与 QUICK_START。
         if (Files.exists(caseSqlPath)) {
             log.info("开始执行案件数据库升级sql...");
             //每个案件的数据进行升级

+ 16 - 10
ai-server/src/main/resources/application-dev.yaml

@@ -3,24 +3,30 @@
 # 例外:mybatis-plus 段在 application.yaml 里按约定保持字面值,不参数化。
 spring:
   # ========================================
-  # PostgreSQL 数据库配置
-  # 驱动:org.postgresql.Driver
-  # 需要安装 pgvector 扩展用于向量存储
-  # 本机开发凭证直接配置于此文件。
+  # 平台主库:加密 SQLite 文件 qingjian/system/db/plat(SQLiteMC aes256cbc)
+  # 驱动 org.sqlite.JDBC 由 io.github.willena:sqlite-jdbc 提供,随 jar 内置,无需装数据库服务。
+  # url 里的路径只是占位:DataSourceConfig 会按 PathConst.PLAT_DB_PATH 绝对化,
+  # 避免 cwd 漂移时 SQLite 静默新建一个空库。
+  # slave(案件 DuckDB)由 CaseRoutingDataSource 动态路由,与此处无关。
   # ========================================
   datasource:
     dynamic:
-      # 主数据源:pgsql,永不改变
+      # 主数据源:加密 SQLite 平台库
       primary: "${SPRING_DATASOURCE_DYNAMIC_PRIMARY:master}"
       # 严格模式:@DS 写错 key 时直接报错,而不是静默回退主库。案件库走 CaseRoutingDataSource
-      # 的 slave 分支,不受影响;这能防止未来新增 mapper 时把案件 SQL 误发到 PostgreSQL。
+      # 的 slave 分支,不受影响;这能防止未来新增 mapper 时把案件 SQL 误发到平台库。
       strict: "${SPRING_DATASOURCE_DYNAMIC_STRICT:true}"
       datasource:
         master:
-          url: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_URL:jdbc:postgresql://192.168.0.106:5432/zsjz-ai}"
-          username: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_USERNAME:postgres}"
-          password: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_PASSWORD:postgres}"
-          driver-class-name: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_DRIVER_CLASS_NAME:org.postgresql.Driver}"
+          # busy_timeout:驱动默认仅 3000ms,delete 日志模式下多路并发写需要更长等待。
+          # transaction_mode=IMMEDIATE:BEGIN 即取写锁,避免读事务升级写时的即时 SQLITE_BUSY。
+          url: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_URL:jdbc:sqlite:file:qingjian/system/db/plat?cipher=aes256cbc&key=xcj7xymg&busy_timeout=15000&transaction_mode=IMMEDIATE}"
+          username: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_USERNAME:}"
+          password: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_PASSWORD:}"
+          driver-class-name: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_DRIVER_CLASS_NAME:org.sqlite.JDBC}"
+          hikari:
+            max-pool-size: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_HIKARI_MAX_POOL_SIZE:8}"
+            min-idle: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_HIKARI_MIN_IDLE:1}"
 
 storage:
   local:

+ 16 - 10
ai-server/src/main/resources/application-pro.yaml

@@ -3,24 +3,30 @@
 # 例外:mybatis-plus 段在 application.yaml 里按约定保持字面值,不参数化。
 spring:
   # ========================================
-  # PostgreSQL 数据库配置
-  # 驱动:org.postgresql.Driver
-  # 需要安装 pgvector 扩展用于向量存储
-  # 本机开发凭证直接配置于此文件。
+  # 平台主库:加密 SQLite 文件 qingjian/system/db/plat(SQLiteMC aes256cbc)
+  # 驱动 org.sqlite.JDBC 由 io.github.willena:sqlite-jdbc 提供,随 jar 内置,无需装数据库服务。
+  # url 里的路径只是占位:DataSourceConfig 会按 PathConst.PLAT_DB_PATH 绝对化,
+  # 避免 cwd 漂移时 SQLite 静默新建一个空库。
+  # slave(案件 DuckDB)由 CaseRoutingDataSource 动态路由,与此处无关。
   # ========================================
   datasource:
     dynamic:
-      # 主数据源:pgsql,永不改变
+      # 主数据源:加密 SQLite 平台库
       primary: "${SPRING_DATASOURCE_DYNAMIC_PRIMARY:master}"
       # 严格模式:@DS 写错 key 时直接报错,而不是静默回退主库。案件库走 CaseRoutingDataSource
-      # 的 slave 分支,不受影响;这能防止未来新增 mapper 时把案件 SQL 误发到 PostgreSQL。
+      # 的 slave 分支,不受影响;这能防止未来新增 mapper 时把案件 SQL 误发到平台库。
       strict: "${SPRING_DATASOURCE_DYNAMIC_STRICT:true}"
       datasource:
         master:
-          url: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_URL:jdbc:postgresql://localhost:5432/zsjz-ai}"
-          username: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_USERNAME:postgres}"
-          password: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_PASSWORD:postgres}"
-          driver-class-name: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_DRIVER_CLASS_NAME:org.postgresql.Driver}"
+          # busy_timeout:驱动默认仅 3000ms,delete 日志模式下多路并发写需要更长等待。
+          # transaction_mode=IMMEDIATE:BEGIN 即取写锁,避免读事务升级写时的即时 SQLITE_BUSY。
+          url: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_URL:jdbc:sqlite:file:qingjian/system/db/plat?cipher=aes256cbc&key=xcj7xymg&busy_timeout=15000&transaction_mode=IMMEDIATE}"
+          username: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_USERNAME:}"
+          password: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_PASSWORD:}"
+          driver-class-name: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_DRIVER_CLASS_NAME:org.sqlite.JDBC}"
+          hikari:
+            max-pool-size: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_HIKARI_MAX_POOL_SIZE:8}"
+            min-idle: "${SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_HIKARI_MIN_IDLE:1}"
 
 storage:
   local:

+ 5 - 3
ai-server/src/main/resources/application.yaml

@@ -139,10 +139,12 @@ zsjz:
     # 只读两套模板元数据(table_info/table_field + ai_clean_template/ai_clean_field,不扫描 DuckDB),
     # 写进独立向量表 rag_tpl{tag}_d{dims}(按模型名隔离,如 rag_tpl_bge_m3_d1024)。
     # 用途:AI 模板匹配的向量召回(只补候选,不判档)。
-    # 前提:本地嵌入模型目录存在 + PG 已装 pgvector;未满足时全链路 fail-open。
+    # 该链路的建表/检索 SQL 是 pgvector 专有方言(vector(n)、<=>、jsonb),
+    # 主库还原为加密 SQLite 后无等价能力,故默认关闭;模板匹配走原有评分 + LLM 路径。
     vector:
-      # 总开关;关闭行为与改造前完全一致(无索引、无召回)
-      enabled: "${ZSJZ_AI_CLEAN_VECTOR_ENABLED:true}"
+      # 总开关;关闭行为与改造前完全一致(无索引、无召回)。
+      # 如需重新启用,必须先把 AiCleanVectorMapper 改成 SQLite 可用的向量方案。
+      enabled: "${ZSJZ_AI_CLEAN_VECTOR_ENABLED:false}"
       # 模板新增/更新/删除后自动增量更新索引(关闭只能手工调 /aiClean/templateVector/rebuild)
       auto-index-on-template-change: "${ZSJZ_AI_CLEAN_VECTOR_AUTO_INDEX_ON_TEMPLATE_CHANGE:true}"
       # 启动时若索引表不存在/为空则后台自举重建(存量模板不会补发变更事件)

+ 0 - 22
ai-server/src/main/resources/mappers/plat/SystemInfoMapper.xml

@@ -1,22 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE mapper
-        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
-        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
-<mapper namespace="com.zsjz.ai.module.plat.mapper.SystemInfoMapper">
-
-    <resultMap id="BaseResultMap" type="com.zsjz.ai.common.model.plat.entity.SystemInfo">
-            <id property="productNo" column="product_no" />
-            <result property="clientNo" column="client_no" />
-            <result property="computerName" column="computer_name" />
-            <result property="firstDateTime" column="first_date_time" />
-            <result property="activeDateTime" column="active_date_time" />
-    </resultMap>
-
-    <sql id="Base_Column_List">
-        product_no,client_no,computer_name,first_date_time,active_date_time
-    </sql>
-
-    <update id="executePlatSql">
-        ${platSql}
-    </update>
-</mapper>

+ 10 - 3
ai-server/src/test/java/com/zsjz/ai/module/aiclean/AiCleanSchemaTest.java

@@ -23,7 +23,7 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
 /**
- * 实体注解与 {@code sql/ai_clean.sql} 的列名一一对齐。
+ * 实体注解与 {@code sql/ai_clean_sqlite.sql} 的列名一一对齐。
  *
  * <p><b>为什么单独测这个</b>:{@code @TableField("case_id")} 写成 {@code caseId} 时编译毫无反应,
  * 直到 AI 清洗真的写库那一刻才在日志里炸出一句「Column "caseId" not found」——
@@ -37,8 +37,15 @@ import static org.junit.jupiter.api.Assertions.assertTrue;
  */
 class AiCleanSchemaTest {
 
-    /** Maven 从模块目录跑测试,脚本在仓库根的 sql/ 下 */
+    /**
+     * Maven 从模块目录跑测试,脚本在仓库根的 sql/ 下。
+     *
+     * <p>优先校验 {@code ai_clean_sqlite.sql} —— 主库已还原为加密 SQLite,它才是真正被执行的
+     * 建表脚本;{@code ai_clean.sql} 是 PG 时代参考,列集合相同,仅作兜底。
+     */
     private static final List<Path> CANDIDATES = List.of(
+            Path.of("../sql/ai_clean_sqlite.sql"), Path.of("sql/ai_clean_sqlite.sql"),
+            Path.of("../../sql/ai_clean_sqlite.sql"),
             Path.of("../sql/ai_clean.sql"), Path.of("sql/ai_clean.sql"),
             Path.of("../../sql/ai_clean.sql"));
 
@@ -73,7 +80,7 @@ class AiCleanSchemaTest {
                 return Files.readString(p);
             }
         }
-        throw new AssertionError("找不到 sql/ai_clean.sql,候选路径:" + CANDIDATES);
+        throw new AssertionError("找不到 sql/ai_clean_sqlite.sql,候选路径:" + CANDIDATES);
     }
 
     private static void assertColumns(String table, Class<?> entity, String ddl) {

+ 11 - 7
deploy/env.sh

@@ -49,15 +49,17 @@ SPRING_SERVLET_MULTIPART_MAX_FILE_SIZE="200MB"
 SPRING_SERVLET_MULTIPART_MAX_REQUEST_SIZE="500MB"
 
 # ---------------------------------------------------------------------------
-# PostgreSQL(平台库,必须装 pgvector 扩展)
-# 【按环境修改】dev 默认 192.168.0.106,pro 默认 localhost
+# 加密 SQLite 平台库(qingjian/system/db/plat,SQLiteMC aes256cbc)
+# 驱动 org.sqlite.JDBC 随 jar 内置,无需安装数据库服务。
+# url 里的路径只是占位:DataSourceConfig 按 PathConst.PLAT_DB_PATH 绝对化。
+# 注意:ai-gateway 是独立进程,仍使用 PostgreSQL + pgvector,不受此处影响。
 # ---------------------------------------------------------------------------
 SPRING_DATASOURCE_DYNAMIC_PRIMARY="master"
 SPRING_DATASOURCE_DYNAMIC_STRICT="true"
-SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_URL="jdbc:postgresql://192.168.0.106:5432/zsjz-ai"
-SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_USERNAME="postgres"
-SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_PASSWORD="postgres"
-SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_DRIVER_CLASS_NAME="org.postgresql.Driver"
+SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_URL="jdbc:sqlite:file:qingjian/system/db/plat?cipher=aes256cbc&key=xcj7xymg&busy_timeout=15000&transaction_mode=IMMEDIATE"
+SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_USERNAME=""
+SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_PASSWORD=""
+SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_DRIVER_CLASS_NAME="org.sqlite.JDBC"
 
 # ---------------------------------------------------------------------------
 # 业务文件存储
@@ -113,10 +115,12 @@ ZSJZ_EMBEDDING_EAGER_LOAD="false"
 
 # ---------------------------------------------------------------------------
 # zsjz.ai-clean(AI 清洗与模板向量索引)
+# 向量索引默认关闭:其建表/检索 SQL 是 pgvector 专有方言,SQLite 主库无等价能力。
+# 下面其余 VECTOR_* 参数在关闭状态下不生效,保留以备将来换向量方案时复用。
 # ---------------------------------------------------------------------------
 ZSJZ_AI_CLEAN_BATCH_TOKEN_BUDGET="0"
 ZSJZ_AI_CLEAN_STALE_MINUTES="30"
-ZSJZ_AI_CLEAN_VECTOR_ENABLED="true"
+ZSJZ_AI_CLEAN_VECTOR_ENABLED="false"
 ZSJZ_AI_CLEAN_VECTOR_AUTO_INDEX_ON_TEMPLATE_CHANGE="true"
 ZSJZ_AI_CLEAN_VECTOR_AUTO_REBUILD_ON_STARTUP="true"
 ZSJZ_AI_CLEAN_VECTOR_TOP_K="12"

+ 3 - 0
sql/ai_clean.sql

@@ -1,4 +1,7 @@
 -- ============================================================================
+-- 【PG 时代参考脚本】主库已还原为加密 SQLite,实际执行的是 sql/ai_clean_sqlite.sql
+-- (列集合与本文件一致,仅方言不同)。本文件保留作对照,不再对运行期库执行。
+--
 -- AI 清洗链路(module/aiclean)元数据表
 --
 -- 落在 **master PG**(与 table_info / table_field 同库),但**一张都不碰模板库**:

+ 222 - 0
sql/ai_clean_sqlite.sql

@@ -0,0 +1,222 @@
+-- ============================================================================
+-- AI 清洗链路(module/aiclean)元数据表 —— SQLite 方言
+--
+-- 落在 master:加密 SQLite 平台库 qingjian/system/db/plat
+-- (cipher=aes256cbc,驱动 io.github.willena:sqlite-jdbc / org.sqlite.JDBC)。
+-- 与 table_info / table_field 同库,但一张都不碰模板库:AI 生成的模板、字段、
+-- 清洗函数链、任务轨迹全部存这六张表。之所以不写 table_info:一旦写行并打开
+-- table_field.matched,既有匹配器就会命中该模板,进而走到
+-- StrategyType.fromCode(main_id) 抛异常(StrategyType.java:82)。
+--
+-- 列集合与 sql/ai_clean.sql(PG 时代参考)完全一致,仅改写方言:
+--   bigint / integer / smallint -> INTEGER
+--   varchar(n) / text           -> TEXT
+--   numeric(6,4)                -> REAL
+--   timestamp default current_timestamp -> TEXT default (strftime(...localtime))
+-- 主键一律 INTEGER not null primary key(rowid 别名):id 由应用侧雪花算法供给,
+-- 不需要 AUTOINCREMENT。不含 case_id_src —— 那是 PG 侧未执行补丁
+-- ai_clean_template_drop_case_src.sql 的残留,实体无此字段,模板跨案件共享。
+--
+-- 全部语句幂等(if not exists / on conflict do nothing),可重复执行。
+-- plat 中已存在的表一律不动,本脚本只补建缺失的六张表。
+--
+-- 执行方式(本机无 sqlite3 CLI,Python 打不开加密库,用驱动 jar + jshell):
+-- 见 QUICK_START「平台库初始化」。执行前先停服务并备份 plat 文件。
+--
+-- 设计文档:docs/design/ai-clean-parallel.md
+-- ============================================================================
+
+-- ----------------------------------------------------------------------------
+-- 1. AI 模板(等价于 table_info 的角色,但完全独立)
+--    header_md5 唯一键是「零模型重放」的收口:同一张表头签名第二次上传直接命中,
+--    不再调用大模型。
+-- ----------------------------------------------------------------------------
+create table if not exists ai_clean_template
+(
+    id                   INTEGER not null primary key,
+    table_name_cn        TEXT    not null,
+    table_name_en        TEXT    not null,
+    headers              TEXT,
+    header_md5           TEXT    not null,
+    header_line_no       INTEGER,
+    func_regex           TEXT,
+    block_no             INTEGER,
+    struct_ops           TEXT,
+    needs_struct         INTEGER default 0,
+    category             TEXT,
+    category_l2          TEXT,
+    main_ref_template_id INTEGER,
+    match_tier           TEXT,
+    status               TEXT    default 'DRAFT',
+    ver                  INTEGER default 1,
+    confidence           REAL,
+    create_by            INTEGER,
+    create_time          TEXT    default (strftime('%Y-%m-%d %H:%M:%f', 'now', 'localtime')),
+    update_time          TEXT
+);
+create unique index if not exists uk_ai_clean_tpl_md5 on ai_clean_template (header_md5);
+create index if not exists idx_ai_clean_tpl_status on ai_clean_template (status);
+create index if not exists idx_ai_clean_tpl_category on ai_clean_template (category);
+
+-- ----------------------------------------------------------------------------
+-- 2. AI 模板字段(等价于 table_field 的角色)
+--    既是动态表 DDL 的真源(field_type/field_len -> DuckDB 类型),
+--    也是前端列表头的真源(field_name_cn + field_sort)。
+-- ----------------------------------------------------------------------------
+create table if not exists ai_clean_field
+(
+    id             INTEGER not null primary key,
+    ai_template_id INTEGER not null,
+    column_name    TEXT    not null,
+    field_name_cn  TEXT,
+    field_name_en  TEXT,
+    field_type     TEXT,
+    required       INTEGER default 0,
+    field_len      INTEGER default 0,
+    field_sort     INTEGER default 0,
+    direction_conf TEXT,
+    col_index      INTEGER,
+    matched        INTEGER default 1,
+    create_time    TEXT    default (strftime('%Y-%m-%d %H:%M:%f', 'now', 'localtime'))
+);
+create index if not exists idx_ai_clean_field_tpl on ai_clean_field (ai_template_id);
+
+-- ----------------------------------------------------------------------------
+-- 3. AI 清洗规则(函数链快照)
+--    只存扁平枚举 hint,绝不存带 @class 的多态 JSON:TableRuleDTO/Fun 用的是
+--    Jackson @JsonTypeInfo(use=CLASS),让模型输出它等于开放任意类名反序列化攻击面。
+--    加载时由 AiRuleCompiler 在内存里把 hint 还原成 Fun 对象。
+-- ----------------------------------------------------------------------------
+create table if not exists ai_clean_rule
+(
+    id              INTEGER not null primary key,
+    ai_template_id  INTEGER,
+    col_index       INTEGER not null,
+    field_name_en   TEXT,
+    field_name_cn   TEXT,
+    hints           TEXT,
+    ref_template_id INTEGER,
+    ver             INTEGER default 1,
+    create_time     TEXT    default (strftime('%Y-%m-%d %H:%M:%f', 'now', 'localtime'))
+);
+create index if not exists idx_ai_clean_rule_tpl on ai_clean_rule (ai_template_id);
+
+-- ----------------------------------------------------------------------------
+-- 4. AI 清洗任务(幂等游标 + 状态线 + 成本埋点)
+--    唯一键 (case_id,file_id,sheet_id,block_no,ver) 就是「同一块只被处理一次」的保证。
+-- ----------------------------------------------------------------------------
+create table if not exists ai_clean_job
+(
+    id              INTEGER not null primary key,
+    case_id         INTEGER not null,
+    file_id         INTEGER not null,
+    sheet_id        INTEGER not null,
+    block_no        INTEGER default 0,
+    ver             INTEGER default 1,
+    batch_id        INTEGER,
+    file_name       TEXT,
+    sheet_name      TEXT,
+    status          TEXT    not null,
+    exit_code       TEXT,
+    matched_by      TEXT,
+    match_tier      TEXT,
+    ref_template_id INTEGER,
+    ai_template_id  INTEGER,
+    header_md5      TEXT,
+    header_row      INTEGER,
+    confidence      REAL,
+    detail          TEXT,
+    draft           TEXT,
+    model_name      TEXT,
+    token_in        INTEGER,
+    token_out       INTEGER,
+    llm_calls       INTEGER default 0,
+    cost_ms         INTEGER,
+    row_total       INTEGER,
+    row_loaded      INTEGER,
+    row_rejected    INTEGER,
+    row_warned      INTEGER,
+    row_unprocessed INTEGER,
+    fail_reason     TEXT,
+    create_time     TEXT    default (strftime('%Y-%m-%d %H:%M:%f', 'now', 'localtime')),
+    update_time     TEXT
+);
+create unique index if not exists uk_ai_clean_job on ai_clean_job (case_id, file_id, sheet_id, block_no, ver);
+create index if not exists idx_ai_clean_job_status on ai_clean_job (status);
+create index if not exists idx_ai_clean_job_file on ai_clean_job (file_id);
+
+-- ----------------------------------------------------------------------------
+-- 5. 智能清洗批次(融合入口的状态机与幂等锚点)
+--    唯一键 (case_id, batch_id) 让重复点按钮返回同一批次而不是重跑一遍。
+-- ----------------------------------------------------------------------------
+create table if not exists ai_clean_batch
+(
+    id                 INTEGER not null primary key,
+    case_id            INTEGER not null,
+    batch_id           INTEGER not null,
+    stage              TEXT    not null,
+    file_count         INTEGER default 0,
+    sheet_total        INTEGER default 0,
+    matched_count      INTEGER default 0,
+    ai_judged_count    INTEGER default 0,
+    existing_hit_count INTEGER default 0,
+    ai_load_count      INTEGER default 0,
+    loaded_rows        INTEGER default 0,
+    rejected_rows      INTEGER default 0,
+    unprocessed_rows   INTEGER default 0,
+    self_built_count   INTEGER default 0,
+    need_review_count  INTEGER default 0,
+    failed_count       INTEGER default 0,
+    need_review_detail TEXT,
+    last_error         TEXT,
+    create_time        TEXT    default (strftime('%Y-%m-%d %H:%M:%f', 'now', 'localtime')),
+    update_time        TEXT
+);
+create unique index if not exists uk_ai_clean_batch on ai_clean_batch (case_id, batch_id);
+create index if not exists idx_ai_clean_batch_stage on ai_clean_batch (stage);
+
+-- ----------------------------------------------------------------------------
+-- 6. 表头同义词库(评分归一 + 绑定域)
+--    星型词组:alias_word -> std_word。只进 HeaderScorer 评分与 filterBinds 绑定域,
+--    绝不进 HeaderFingerprint 指纹 —— 同义词一旦折叠指纹,存量模板 header_md5
+--    会随词条配置漂移。
+-- ----------------------------------------------------------------------------
+create table if not exists ai_clean_synonym
+(
+    id          INTEGER not null primary key,
+    std_word    TEXT    not null,
+    alias_word  TEXT    not null,
+    remark      TEXT,
+    status      INTEGER default 1,
+    create_by   INTEGER,
+    create_time TEXT    default (strftime('%Y-%m-%d %H:%M:%f', 'now', 'localtime')),
+    update_time TEXT
+);
+create unique index if not exists uk_ai_clean_synonym on ai_clean_synonym (std_word, alias_word);
+
+-- ----------------------------------------------------------------------------
+-- 内置词条(建表脚本自带的引导数据,不是从 PG 搬的业务数据)
+--
+-- 必须写入:GlobalCache.synonymMap 初值为空 Map,loadSynonymMap() 遇空表返回 null
+-- 从而保留空快照,且 HeaderScorer 已无硬编码 SYNONYMS 兜底 —— 空表会静默丢失
+-- EXACT 同义词归一(户名↔姓名、交易金额↔发生额、账号↔卡号…),只剩代码内模糊规则。
+-- ----------------------------------------------------------------------------
+insert into ai_clean_synonym (id, std_word, alias_word, remark) values
+    (1,  '户名',     '账户名称', '内置:户名系'),
+    (2,  '户名',     '客户名称', '内置:户名系'),
+    (3,  '户名',     '姓名',     '内置:户名系'),
+    (4,  '交易金额', '发生额',   '内置:金额系'),
+    (5,  '交易金额', '交易额',   '内置:金额系'),
+    (6,  '交易金额', '金额',     '内置:金额系'),
+    (7,  '日期',     '交易日期', '内置:日期系'),
+    (8,  '时间',     '交易时间', '内置:时间系'),
+    (9,  '账号',     '卡号',     '内置:账号系'),
+    (10, '账号',     '银行账号', '内置:账号系'),
+    (11, '账号',     '账户',     '内置:账号系'),
+    (12, '电话',     '手机号',   '内置:电话系'),
+    (13, '电话',     '手机',     '内置:电话系'),
+    (14, '电话',     '联系电话', '内置:电话系'),
+    (15, '身份证号', '身份证',   '内置:证件系'),
+    (16, '身份证号', '身份证号码', '内置:证件系'),
+    (17, '身份证号', '证件号码', '内置:证件系')
+on conflict (std_word, alias_word) do nothing;

+ 12 - 0
sql/plat.sql

@@ -1,3 +1,15 @@
+-- ============================================================================
+-- 【历史参考脚本,严禁对运行期平台库执行】
+--
+-- plat(qingjian/system/db/plat)现在是运行期加密 SQLite 主库。本脚本以
+-- drop table if exists 开头,执行它会删掉在用的表并丢失数据;且 SQLite JDBC
+-- 对多语句串只执行第一条,整篇灌进去本来也不是预期行为。
+--
+-- 保留此文件仅为查阅 Solon 时代的平台表结构。新环境初始化 / 补建缺失表请用
+-- sql/ai_clean_sqlite.sql(幂等 create table if not exists),步骤见 QUICK_START。
+-- 另注:本脚本的 system_info 缺 first_date_time,chat_* / knowledge_* 属已删除模块。
+-- ============================================================================
+
 drop table if exists bank_card_issuer_info;
 create table bank_card_issuer_info
 (