立项背景与目标 :日常办公中,表格合并、文档处理、数据看板生成等重复性工作耗时且门槛高。雪球旨在利用大语言模型的自然语言理解能力,让用户通过一句话即可完成复杂办公任务,实现"对话即操作"的智能办公体验。
软件功能与核心模块 :平台围绕四大模块构建——表格处理引擎(JOIN联查、批量填充、分组聚合、拆分合并)、文档处理引擎(Word改写/模板填充、PDF提取/拆分/合并、PPT生成)、BI看板生成器(11种ECharts图表,支持HTML/PNG/PDF/PPT导出)和PPT自适应渲染引擎(四级降级策略)。所有工具通过DeepSeek Agent统一调度。
业务流程与功能路径 :用户自然语言输入 → Agent解析意图并编排步骤 → 自动调用工具链执行 → SSE流式返回执行进度与结果 → 任务快照持久化存档。全程支持审计日志脱敏和中断恢复,确保数据安全与操作可追溯。
整体架构 :Python 后端(FastAPI)+ Web 前端(HTML/CSS/JS)+ PyWebView 桌面壳,PyInstaller 打包为单文件 exe。核心采用"工具注册 + Agent 调度"解耦模式,四个处理模块(表格、文档、BI、PPT)各自封装为 FunctionCall 工具,由 DeepSeekAgent 通过 SSE 流式统一编排调用,配置与密钥经 AES-256 加密存储。
负责模块 :全栈独立开发,涵盖后端 6 个核心模块(约 7000 行)和前端单页应用(约 5000 行)。实现 20+ 个 FunctionCall 工具、四级 PPT 渲染降级、11 种 BI 图表与四格式导出、分层 Token 压缩、快照恢复、审计脱敏等完整工程化能力。
难点与解决 :(1)长任务 Token 溢出——按轮次分组,旧结果压缩为关键字段摘要,错误信息优先保留。(2)PPT 跨环境兼容——四级降级(MS COM→WPS COM→LibreOffice→python-pptx)兜底。(3)打包资源路径——通过 sys._MEIPASS + 环境变量双重兜底。(4)COM 进程残留——后台定时清理线程 + 300 秒超时锁