kx

一、立项背景和目标 在日常学习与工作中，人们经常需要处理大量文档资料，如 PDF 教材、Word 讲义、TXT 笔记等。传统文件管理方式存在文档分散、信息检索低效、分类混乱、缺乏智能交互等痛点。基于此，我们立项开发小P AI 文件助手，旨在将 AI 大模型能力与桌面文件管理相结合，为用户提供一站式的文档智能阅读、分类与管理体验。项目目标是构建统一的文档阅读平台，实现 AI 驱动的文档分析与智能归类，提供现代化交互体验，并保障用户数据安全与隐私。 二、软件功能与核心模块 小P AI 文件助手是一款基于 Electron 框架的 Windows 桌面应用，核心围绕"AI + 文件管理"两条主线设计。 AI 智能对话模块位于左侧面板，用户可发送消息与 AI 互动，AI 以打字机效果流式回复。上传或双击打开文件后，AI 自动关联该文件，用户可针对文件内容提问。支持一键新建对话，重置上下文。 文件管理与浏览模块位于右侧面板，以目录形式展示 UserFile 文件夹内容，提供面包屑导航。支持新建文件夹、删除、重命名、双击打开文件等基本操作。AI 分析文件后给出分类建议，用户确认后自动归入对应分类文件夹。 文件导入支持拖拽上传（显示遮罩层）和按键上传（多选），上传后自动触发 AI 分析生成摘要与标签。 AI 配置管理模块支持首次启动时配置 API Key 和 Base URL，可测试连接，主界面设置按钮可随时返回修改配置。 文档内容提取支持 TXT、DOCX、PDF 三种格式，AI 读取完整文档内容而非截断，确保信息完整性。 三、业务流程概述 应用启动后，首先判断是否已配置 API，未配置则弹出配置界面，填写并测试连接后进入主界面。 文件导入与智能分类流程：用户拖入或按键上传文件，渲染进程通过 IPC 发送文件路径到主进程，主进程解析文件内容并调用 AI 分析，生成摘要和分类标签。AI 以对话形式询问用户分类意向，用户点击标签确认后，主进程在 UserFile 下对应分类文件夹中创建文件，右侧浏览器刷新。 对话问答流程：用户在左侧输入问题，如果有当前关联文档则连同文档内容一起发送给 AI，否则仅发送问题。AI 以打字机效果回复，对话区自动滚动到底部。 文件浏览操作流程：单击选中文件，双击文件用系统默认应用打开，双击文件夹进入目录，面包屑可点击返回上级。选中后可使用删除、重命名功能，也可在当前目录新建文件夹。 新建对话流程：点击"新建对话"按钮，清空历史记录和关联文档，对话区仅显示欢迎语，后续消息不再关联前文。 应用采用 Electron 三层架构：渲染进程负责 UI 展示，preload.js 作为安全桥梁暴露有限 IPC 接口，主进程负责文件系统操作和 AI API 调用，全程遵循安全最佳实践。