业务和功能介绍
一、立项背景和目标
在日常学习与工作中，人们经常需要处理大量文档资料，如 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 调用，全程遵循安全最佳实践。
在日常学习与工作中，人们经常需要处理大量文档资料，如 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 调用，全程遵循安全最佳实践。
项目实现
本软件采用 Electron 三层架构体系，遵循安全最佳实践。核心设计思路是将 AI 大模型能力嵌入桌面文件管理流程，通过 IPC 进程间通信实现前端与后端的安全数据交换。技术栈包括：Electron 作为桌面框架层，原生 HTML5、CSS3 和 JavaScript 构建前端界面，Node.js 运行于主进程处理后端逻辑，mammoth 和 pdfjs-dist 负责文档解析，OpenAI 标准格式调用 AI 接口，本地 JSON 文件持久化配置。
项目全部开发工作由我独立完成。前端界面模块实现了左右双栏布局，左侧 AI 对话栏占百分之四十，右侧文件浏览栏占百分之六十，采用暗色扁平风设计，整页禁止外部滚动条，各区域独立滚动。实现了全局拖拽上传遮罩层、流式打字机回复、对话自动滚动、新建对话清空上下文等功能。文件浏览器模块实现了目录导航与面包屑路径显示，支持新建文件夹、删除、重命名等操作，并将访问范围限定在 UserFile 目录内。AI 对话模块实现了完整的文档上下文关联与智能分类功能，上传文件后 AI 自动分析生成摘要和标签，用户确认后自动归类到对应文件夹。文件解析模块支持 TXT、DOCX、PDF 三种格式，AI 读取完整文档内容而非截断。
开发过程中遇到的主要难点及解决方案如下：一是 PDF 解析库兼容问题，pdf-parse 对中文支持差，切换为 pdfjs-dist v6 legacy 版配合动态导入和 Uint8Array 格式解决。二是 AI 上下文串联问题，通过在设计发送请求前同步关联文档状态，并将完整文档注入system prompt来解决。三是拖拽上传时鼠标显示禁止符号，通过在dragenter和dragover事件中同时阻止默认行为解决。四是智能分类的交互设计，改为AI以对话形式输出标签，用户点击确认后再执行文件移动，兼顾了自然交互与用户控制权。五是路径编码问题，所有文件操作统一使用path.resolve和path.join规范化处理，增强系统兼容性。
项目全部开发工作由我独立完成。前端界面模块实现了左右双栏布局，左侧 AI 对话栏占百分之四十，右侧文件浏览栏占百分之六十，采用暗色扁平风设计，整页禁止外部滚动条，各区域独立滚动。实现了全局拖拽上传遮罩层、流式打字机回复、对话自动滚动、新建对话清空上下文等功能。文件浏览器模块实现了目录导航与面包屑路径显示，支持新建文件夹、删除、重命名等操作，并将访问范围限定在 UserFile 目录内。AI 对话模块实现了完整的文档上下文关联与智能分类功能，上传文件后 AI 自动分析生成摘要和标签，用户确认后自动归类到对应文件夹。文件解析模块支持 TXT、DOCX、PDF 三种格式，AI 读取完整文档内容而非截断。
开发过程中遇到的主要难点及解决方案如下：一是 PDF 解析库兼容问题，pdf-parse 对中文支持差，切换为 pdfjs-dist v6 legacy 版配合动态导入和 Uint8Array 格式解决。二是 AI 上下文串联问题，通过在设计发送请求前同步关联文档状态，并将完整文档注入system prompt来解决。三是拖拽上传时鼠标显示禁止符号，通过在dragenter和dragover事件中同时阻止默认行为解决。四是智能分类的交互设计，改为AI以对话形式输出标签，用户点击确认后再执行文件移动，兼顾了自然交互与用户控制权。五是路径编码问题，所有文件操作统一使用path.resolve和path.join规范化处理，增强系统兼容性。
示例图片视频
相似推荐
基于springboot的云之家OA和纷享销客数据交互插件
1. 立项背景和目标
公司同时使用云之家 OA（审批工作流）和纷享销客 CRM（客户/业务对象）两套系统，审批环节产生的业务数据（如订单审批、出差申请、报销流程等）需要回写到纷享销客对应的业务对象，原生云之家无法直接对接纷享销客的 OpenAPI，且双方系统在数据格式、鉴权方式、加密机制上完全不同（云之家采用 AES/ECB/PKCS5Padding 加密推送，纷享销客采用 OAuth2.0 + Bearer Token 鉴权）。本项目（mlxcl-middle）作为云之家与纷享销客之间的轻量级中间服务，承接云之家审批推送、解密、解析、调用纷享 OpenAPI 回写等完整链路，实现审批数据从 OA 到 CRM 的自动化流转。
2. 软件功能、核心功能模块介绍
服务基于 Spring Boot 3.3.5 构建，按职责划分为四大模块：
云之家推送接入（POST /middle/yunzhijia/testapi）：负责接收云之家 CloudFlow 推送的加密数据，使用 cloudflow-key（16 字节 AES 密钥）进行 AES/ECB/PKCS5Padding 解密，还原成明文 JSON 后进入业务处理链路；解密失败立即返回 error 避免阻塞云之家重试。
纷享销客 API 代理（POST /middle/fxiaoke/testapi）：作为纷享销客 OpenAPI 的统一入口，对外屏蔽鉴权细节，接收 dataObjectApiName + objectDataId 后自动识别预制对象（如 PersonnelObj）和自定义对象（ApiName 以 __c 结尾），分别路由到 /cgi/crm/v2/data/get 或 /cgi/crm/custom/v2/data/get 接口查询详情，并自动注入 x-fs-userid、x-fs-ea 等业务 Header。
通用数据处理中台（POST /api/process）：以 bizType 为路由键的策略模式分发器（TYPE_A / TYPE_B / Default），便于后续按业务类型扩展新的对接流程，无需改动主流程。
基础设施：统一响应封装 ApiResult<T>（code/message/data）、@Valid + @NotBlank 参数校验、Spring Boot Actuator 健康检查（/actuator/health）、/api/health 业务探活、WebMvcConfig 跨域配置。
3. 业务流程、功能路径描述
云之家→纷享审批数据流转（核心链路）：云之家工作流节点触发推送 → 调用 POST /middle/yunzhijia/testapi 传入加密报文 → 服务 AES 解密得到明文 → 落库/记录 → 立即返回 success 释放连接 → @Asy
基于python的K3ERP接口服务
1. 立项背景和目标
公司销售环节已使用纷享销客 CRM 管理客户、销售订单与回款流程，但财务、库存、生产环节仍依赖 K/3 ERP（SQL Server 2008 R2，AIS20130806192009 账套）。两套系统长期互不相通，订单需要人工二次录入，客户变更也无法及时回流到 ERP，导致数据孤岛、人力浪费以及业务-财务对账滞后等问题。本项目旨在构建一个轻量级中间对接服务（ConnectDemo），以 K/3 为主数据底座，将纷享销客的客户主数据与销售订单自动同步到 K/3，支撑业务一体化运营。
2. 软件功能、核心功能模块介绍
本服务围绕「K/3 数据查询、纷享→K/3 客户/订单同步、辅助工具、定时任务」四大模块建设，共 25+ 个 REST 接口：
K/3 业务数据查询：封装物料（ICItem）、库存（ICInventory）、销售订单（SEOrder）、应收单（ICSale）、收款单（ReceiveBill）、销售发票（ICSale2）六大实体的列表与数量接口，按日期范围分页查询。
客户主数据同步：调用纷享 Open API（/cgi/crm/v2/data/query）按 life_status=normal + k3_sync_fields_last_modify__c >= 1小时前 增量拉取客户，结合 Address/Contact 对象补全地址与联系人，写入 K/3 的 t_Item、t_Organization 表。
销售订单同步：/k3/sync-seorder 是核心，按 FBillNo + FHeadSelfS0170 来源标识判定新建/修改，调用 GetICMaxNum 存储过程获取 FInterID，通过 t_billcodeby 生成 XSDD15+yyyymmdd+流水号 形式的单据编号，写入 SEOrder 主表、明细表后执行 p_UpdateBillRelateData 重建关联。
辅助工具：地址智能解析（/util/parse-address-info）将「姓名+电话+省市区+详细地址」一锅端的混合文本拆分为结构化字段；客户档案修订接口（/account/update-account-number）支持必要时调整 K/3 客户编码。
3. 业务流程、功能路径描述
被动同步（客户）：纷享销客工作流回调 GET /fxapi/sync-accounts → 服务 60 秒后异步拉取最新客户 → 写入 K/3。主动同步（客户）：APScheduler 每小时执行 sync_accounts_from_fxiaoke_to_k3 → 调用本地 accounts_by_filters → 拉取增量客户 → 写入 K/3。
订单同步：纷享订单审批完成后回调 POST /k3/sync-seorder → 服务按
大型企业级ERP
本系统是为万人企业集团量身打造的大型ERP管理系统，涵盖财务、采购、生产、库存、人力等十余个核心模块，全面支撑集团及下属多家分子公司的日常运营与管控需求，助力企业实现集团一体化精细管理。
一、财务管理模块
涵盖总账管理、应收应付、固定资产管理、成本核算、预算管控等核心功能。支持多公司、多币种、多账套管理，自动生成集团合并报表与各分子公司独立财务报表。实现财务业务一体化，业务数据自动生成会计凭证，减少人工录入工作量，确保财务数据准确性与及时性。
二、采购管理模块
覆盖采购计划、供应商管理、询价比价、采购订单、采购入库、退货处理等全流程。支持集中采购与分散采购两种模式，满足集团统采统配与分厂自行采购并存的管理需求。系统自动记录供应商历史报价与履约情况，辅助比价选优。
三、生产管理模块
包含生产计划、物料需求计划、生产工单、进度跟踪、质量检验等功能。支持按订单生产与按库存生产两种模式，系统根据销售订单或库存预警自动生成生产建议，合理调配产能，避免资源浪费或产能不足。
四、库存管理模块
涵盖出入库管理、库存盘点、库存调拨、库存预警等功能，实现多仓库统一管理与数据实时同步。库存低于安全阈值时系统自动告警并生成补货建议，有效降低库存积压成本。
五、人力资源管理模块
包含组织架构管理、员工档案管理、考勤管理、薪酬管理、社保公积金管理等核心功能。考勤管理支持多区域多规则灵活配置，适配集团遍布全国的多子公司、多项目不同考勤规则，自动汇总生成考勤报表，对接薪酬模块自动核算工资。
六、审批工作流模块
支持按金额阶梯、事项类型、组织层级灵活配置审批流程，覆盖采购、付款、报销、合同、人事变动等超200种审批场景。审批进度实时追踪，有效提升集团管控效率。
七、经营决策看板
内置经营分析驾驶舱，通过图表实时呈现各分子公司收入、成本、利润、库存周转等关键经营指标，管理层一目了然掌握全局经营状况，为精准决策提供数据支撑。
数智管理平台
1.针对企业内部管理的公共平台，包含审批流程操作
2.核心模块人员起底，专业群组，自查填报等模块，包括平台的人员流动，人员打标以及审批流等基本操作
3.业务上人员从各个省份进行上报，各个省份权限管理员通过审批操作通过人员进入系统人员起底资源池
用户行为数据分析看板系统
1、立项背景和目标
传统企业在用户运营过程中面临数据分散、分析效率低、用户画像不清晰等问题。运营人员经常需要在多个系统间切换查看数据，无法快速获取用户行为全貌。为了解决这一痛点，我决定开发一套用户行为数据分析看板系统，目标是实现用户数据一站式查询、用户画像自动生成以及核心行为指标的可视化展示，将数据分析时间从小时级缩短至分钟级。
2、软件功能、核心功能模块的介绍
系统包含三大核心模块：
用户画像分析模块：基于用户行为数据自动生成画像标签，包括用户活跃时段（是否为夜猫子）、价值等级（高价值/低价值）、转化潜力（高转化率/低转化率）等多维度标签，帮助运营团队快速定位目标用户群体。
全局趋势分析模块：对用户四大核心行为（浏览、加购、购买、收藏）进行24小时内的时间分布统计，同时提供最畅销产品排行榜，让决策者一目了然地掌握整体运营态势。
精准查询模块：支持通过用户ID或产品ID进行精确检索，系统自动返回该用户/产品的完整画像数据和关联行为记录，满足精细化运营场景下的快速查询需求。
3、业务流程、功能路径描述
用户进入系统后，可直接在首页看到全局趋势概览，包括24小时行为分布柱状图、畅销产品排名等。如需深入了解特定用户，可在查询框输入用户ID，系统调用后端API查询数据库，返回该用户的画像标签和行为明细，并生成可视化图表。产品分析同理。整个流程从输入到结果展示控制在3秒以内。
帮助文档
Copyright @ 2021-2024 程聚宝 | 浙ICP备2021014372号
人工客服