# 智阅AI--简单的知识库问答系统

**Repository Path**: wxyxxy1236/smart-reading-ai-front-end

## Basic Information

- **Project Name**: 智阅AI--简单的知识库问答系统
- **Description**: 智阅AI前端
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-14
- **Last Updated**: 2026-02-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# IntelijReading（开源版）

一个基于 `Electron + Next.js + TypeScript` 的桌面应用，包含文档解析、知识库检索、流式问答与图像生成功能。

## 技术栈
- 客户端：Electron、Next.js、React、TypeScript、Tailwind CSS
- 本地数据：SQLite（`knex`）
- 后端能力：Flask（SSE 问答）、FastAPI（FAISS/OCR、StableDiffusion）

## 目录结构
- `renderer/`：前端页面与组件
- `electron-src/`：Electron 主进程、预加载脚本、本地数据库
- `backend/`：后端脚本（问答、向量检索、图像生成）
- `public/`、`renderer/public/`：静态资源
- `main/`：Electron 编译产物

## 环境要求
- Node.js 18+
- pnpm 8+
- Python 3.10+
- 可选：CUDA（用于加速 OCR/扩散模型）

## 快速开始
1. 安装前端依赖
```bash
pnpm install
```

2. 配置前端环境变量
```bash
cp .env.example .env
```
Windows PowerShell 可用：
```powershell
Copy-Item .env.example .env
```

3. 配置后端环境变量
```bash
cp backend/.env.example backend/.env
```
至少需要设置：`ZHIPU_API_KEY`。

4. 启动后端服务（按需）
```bash
python backend/testmain.py
python backend/faiss_answer.py
python backend/stablediffusion.py
```
默认端口：
- `testmain.py`：`8082`（SSE 问答 `/sse`）
- `faiss_answer.py`：`8087`
- `stablediffusion.py`：`8084`

5. 启动桌面应用（开发模式）
```bash
pnpm run dev
```

## 常用脚本
- `pnpm run dev`：开发运行（Electron）
- `pnpm run build-renderer`：构建前端
- `pnpm run build-electron`：构建主进程
- `pnpm run build`：构建前后两层
- `pnpm run dist`：打包安装包
- `pnpm run type-check`：TypeScript 检查

## 环境变量说明
前端（`.env`）：
- `NEXT_PUBLIC_API_BASE_URL`：前端 API 基础地址
- `NEXT_PUBLIC_FAISS_URL`：向量检索服务地址
- `NEXT_PUBLIC_SSE_URL`：SSE 服务地址
- `API_PROXY_1` ~ `API_PROXY_4`：Next.js rewrites 代理地址

后端（`backend/.env`）：
- `ZHIPU_API_KEY`：大模型 API Key
- `CHAT_MODEL`、`VISION_MODEL`、`IMAGE_MODEL`：模型名称
- `FILE_KNOWLEDGE_ID`、`KNOWLEDGE_BASE_ID`：检索知识库 ID
- `FAISS_*`：FAISS/OCR 服务配置
- `SD_*`：StableDiffusion 服务配置

## 开源安全说明
本仓库已进行基础脱敏处理：
- 移除历史示例中的个人敏感数据
- 移除登录/注册敏感日志输出
- 将密钥与服务地址改为环境变量配置
- 增加 `backend/.gitignore`，避免提交本地密钥与产物

## 发布前检查清单
1. 确认 `.env`、`backend/.env` 未提交。
2. 轮换曾暴露过的密钥（如历史提交里出现过）。
3. 对仓库执行一次 Secret Scanning。
4. 检查 `file/`、`db/`、`img/` 是否包含不应公开的数据。

## License
请根据你的发布策略补充许可证（如 MIT、Apache-2.0）。