docs: 中期成果物整理 - 新增DESIGN.md/AGENTS.md、更新README、规范化文件命名与路径

2026-08-31 15:07:30 +08:00
parent e2a4d40c9e
commit 813cddb589
16 changed files with 2536 additions and 18 deletions
@@ -0,0 +1,104 @@
+# 指摘管理系统（IMS）技术构成简要说明
+
+> **版本**：V4.1 | **日期**：2026-07-20
+> 
+> AI驱动的指摘（缺陷/问题）全生命周期管理系统，以 Agent（智能体）为核心，实现"人机协同"的自动化管理。
+
+---
+
+## 一、整体架构
+
+```
+┌─────────────┐     ┌─────────────┐     ┌─────────────────────────┐
+│   前端层    │────▶│  后端业务层  │────▶│    Agent决策编排层       │
+│  React SPA  │     │ Spring Boot │     │ ReAct循环 + 工具调用     │
+└─────────────┘     └─────────────┘     └─────────────────────────┘
+                                                │
+                    ┌───────────────────────────┼───────────────────┐
+                    ▼                           ▼                   ▼
+              ┌──────────┐              ┌────────────┐      ┌────────────┐
+              │本地数据层 │              │ 本地向量库  │      │ 外接AI算力 │
+              │PostgreSQL│              │  pgvector  │      │ DeepSeek   │
+              │+ Redis   │              │  (1536维)  │      │ API        │
+              └──────────┘              └────────────┘      └────────────┘
+```
+
+---
+
+## 二、核心技术栈
+
+| 层级 | 技术选型 | 作用 |
+|:---|:---|:---|
+| **前端** | React 19 + TypeScript + Vite + Ant Design 6 | 单页应用，工作台/指摘管理/Agent驾驶舱 |
+| **后端** | Java 17/21 + Spring Boot 3.5 + Spring Security | RESTful API、RBAC权限、数据访问（JPA） |
+| **Agent引擎** | Spring AI / 自定义ReAct框架 + DeepSeek API | 自然语言理解、任务规划、工具调用、思考链 |
+| **向量检索** | PostgreSQL 16 + **pgvector** 插件 | 本地存储文档向量（1536维），余弦相似度检索 |
+| **缓存/消息** | Redis 7.4 | 热点缓存、会话管理、异步通知 |
+| **对象存储** | MinIO（本地部署） | 知识库文档、附件文件存储 |
+| **AI算力** | DeepSeek API（deepseek-v4-pro + text-embedding-3-small） | **仅提供推理与向量化算力，不留存数据** |
+
+---
+
+## 三、核心创新点
+
+### 1. Agent驱动的业务闭环
+- 内置 **ReAct循环**（推理→行动→观察）
+- 用户自然语言指令（如"催办逾期指摘分配给张三"）→ Agent自动规划 → 调用工具执行
+- 高风险操作（删除/跨部门分配）自动触发人工审批
+
+### 2. 本地知识库 + 外接算力
+- 所有文档原文和向量索引 **存储于本地**（PostgreSQL pgvector）
+- 仅将待向量化的文本片段通过API发送至DeepSeek
+- **数据不出内网**，兼顾智能化与数据安全
+
+### 3. 人机协同审批机制
+- Agent执行敏感操作前自动触发 `request_human_approval`
+- 详情页"Agent驾驶舱"实时展示思考链：`[思考]` → `[行动]` → `[观察]`
+- 用户可实时批准/拒绝/修改建议
+
+### 4. 长期记忆能力
+- 成功的Agent处理经验自动沉淀为向量记忆（`agent_memories`表）
+- 后续遇到相似问题时优先检索历史方案，持续优化决策质量
+
+---
+
+## 四、关键数据流示例
+
+**用户输入**："这个4K屏幕适配问题怎么处理？"
+
+```
+Agent接收目标
+    │
+    ▼
+检索本地知识库（search_knowledge）
+    │
+    ▼
+匹配历史案例 #KB-042（Flex容器4K适配方案）
+    │
+    ▼
+生成行动方案 → 调用 send_reminder 给担当者
+    │
+    ▼
+触发人工审批闸门（request_human_approval）
+    │
+    ▼
+用户批准 → 发送通知并附解决方案 → 记录成功经验到记忆库
+```
+
+---
+
+## 五、部署特点
+
+| 特性 | 说明 |
+|:---|:---|
+| **全栈容器化** | Docker Compose 一键启动所有服务 |
+| **数据本地化** | 知识库文档、向量索引、业务数据全部本地存储 |
+| **算力外包化** | 仅DeepSeek API为外部依赖，传输内容可控、不留存 |
+| **可观测性** | Prometheus + Grafana 监控Agent任务指标；ELK审计思考链日志 |
+| **安全策略** | JWT认证 + RBAC权限 + 单用户Agent调用限流（10次/分钟） |
+
+---
+
+## 六、一句话概括
+
+> 用 **Spring Boot + React** 构建、以 **DeepSeek AI** 为大脑、以 **本地pgvector** 为记忆、以 **Agent** 为执行中枢的智能化缺陷管理系统——让AI自动处理80%的常规指摘流转，人工只介入关键决策。