AI 文本检测系统，支持文本与文件导入、检测结果展示、历史记录和 PDF 报告，并可选提供 Evidence 写作特点分析。
本仓库保存系统的阶段性交付快照。日常开发在各组件的个人仓库进行，大更新后统一同步到本仓库。
| 目录 | 职责 | 使用说明 |
|---|---|---|
frontend/ |
Web 界面、文件解析、检测结果与历史展示 | 前端 README |
backend/ |
会话、配额、检测调度、历史记录、报告与 Evidence 分析 | 后端 README |
detector/ |
主检测模型推理与可选的 Evidence Router | 检测端 README |
服务调用链：frontend → backend → detector。三端分别安装依赖、配置和部署。
git clone -c core.autocrlf=false https://github.com/NLP2CT/AIDetector.git
cd AIDetector按以下顺序启动：
- 进入
detector/，按检测端 README 准备模型、配置并启动检测服务。 - 进入
backend/，按后端 README 配置数据库和检测服务地址，启动 API，确认/api/v1/ready中的database和detect_service均为ok。 - 进入
frontend/，按前端 README 配置 API 地址，启动开发服务器或构建静态文件。
已克隆本仓库时，跳过各端 README 中原仓库的克隆步骤。各端命令均在对应组件目录执行；backend/backend/ 是原有 Python 应用目录，保留这一层结构。
代码更新在本仓库根目录执行。后端的 scripts/server-update.sh 面向原独立仓库，尚未适配本目录结构，不用于本仓库更新。
Evidence 是可选功能，用于展示文本的词汇、重复表达、句子节奏和衔接特点，不改变主检测模型的 AI / Human 标签及分数。
它不是第四个独立服务：特征提取与参考比较在后端运行，语言和领域路由在检测端运行，前端负责展示。相关运行代码已包含在三端目录中。
启用该功能还需要以下两项外置产物，本仓库当前未打包：
| 产物 | 使用位置 | 要求 |
|---|---|---|
冻结的 Reference Bundle（.bundle） |
后端 | 提供文件及其 SHA-256，用于加载参考统计 |
| Evidence Router 模型目录 | 检测端 | 提供完整模型文件及 Router 聚合 SHA-256，用于语言和领域路由 |
请向维护者获取本次交付对应的产物及校验信息。Bundle 中记录的 Router SHA 必须与实际加载的 Router 一致；Router 聚合 SHA 不等于单个权重文件的 SHA。
配置顺序：
- 检测端设置
REPRE_GUARD_EVIDENCE_ENABLED=true、REPRE_GUARD_EVIDENCE_MODEL_PATH和REPRE_GUARD_EVIDENCE_ARTIFACT_SHA256。 - 后端挂载 Bundle，设置
DETECT_EVIDENCE_BUNDLE_PATH和DETECT_EVIDENCE_BUNDLE_SHA256；联调验收后设置DETECT_EVIDENCE_MODE=serve。 - 前端设置
VITE_EVIDENCE_ENABLED=true，重新构建并部署。
后端默认 DETECT_EVIDENCE_MODE=off。不启用 Evidence 时，无需准备上述两项产物，主文本检测仍需按检测端 README 准备主检测模型。
离线数据处理、参考统计构建、Router 训练和实验复现保留在独立的 Evidence 研究仓库。研究仓库不纳入本次快照；只有需要重建产物或复现研究时才需要获取对应研究代码和数据。
| 组件 | 开发仓库 | 来源分支 | 提交 |
|---|---|---|---|
| 前端 | AIDetector-web | main |
d4a6298 |
| 后端 | AIDetector-Back | demo/text-envelope |
2c76291 |
| 检测端 | repre_guard_server | demo/text-envelope |
cc11b97 |
每次交付更新此表，以记录本仓库对应的三端版本。