Probly 是什么？

Probly 是一款新一代的电子表格应用，它将传统电子表格的强大功能与 AI 驱动的分析、Python 计算以及智能文档处理相结合。

核心功能

• 智能电子表格：功能齐全的电子表格，支持公式并提供智能单元格建议
• Python 集成：通过 WebAssembly 在浏览器中直接运行 Python 代码
• 数据可视化：创建交互式图表和可视化效果
• AI 驱动分析：获取智能化洞察和自动化的趋势分析
• 文档处理：从图像中提取并处理数据
• 提示库：访问预定义的分析模板，并保存自定义提示以供快速复用

🏗️ 架构

Probly 采用现代化且注重隐私的架构：

graph LR
    A[浏览器] --> B[Next.js 前端]
    B --> C[Pyodide/WASM]
    B --> D[OpenAI API]
    B --> E[Vision API]
    C --> F[本地处理]
    D --> G[AI 分析]
    E --> H[文档处理]

• 前端：使用 TypeScript 和 React 的 Next.js 14
• Python 运行时：Pyodide（WebAssembly）用于本地执行
• AI 集成：OpenAI API 用于智能分析
• 文档处理：Vision API 用于从文档中提取数据

功能

• 交互式电子表格：功能齐全的电子表格，支持公式
• Python 分析：通过 WebAssembly 在浏览器中直接运行 Python 代码
• 数据可视化：根据您的数据创建图表和可视化
• AI 驱动：获得智能建议和自动化分析
• 提示库：访问预设提示或保存您自己的提示以便快速重复使用

架构

Probly 采用现代化架构：

• 前端：在浏览器中运行的 Next.js 应用程序
• Python 执行：Pyodide（编译为 WebAssembly 的 Python）完全在浏览器中运行
• LLM 集成：OpenAI API 调用通过服务器代理进行

这种设计意味着数据分析完全在您的浏览器中本地完成，从而提供更好的性能和更高的隐私保护。

系统要求

• Node.js 18 或更高版本
• npm 或 yarn
• 一个现代的网页浏览器（Chrome、Firefox、Edge 或 Safari）
• OpenAI API 密钥

🚀 使用 Docker 快速入门

启动 Probly 的最快方式：

1. 📥 克隆仓库：

   git clone https://github.com/PragmaticMachineLearning/probly.git
   cd probly
   

2. 🔑 创建包含您的 OpenAI API 密钥的 .env 文件：

   OPENAI_API_KEY=your_api_key_here
   

3. 🐳 使用 Docker 构建并启动：

   docker compose build
   docker compose up -d
   

4. 🌐 访问 Probly：http://localhost:3000

💻 手动安装

想不使用 Docker 运行吗？请按照以下步骤操作：

1. 📥 克隆仓库：

   git clone https://github.com/PragmaticMachineLearning/probly.git
   cd probly
   

2. 📦 安装依赖项：

   npm install
   

3. 🔑 设置环境变量：

   OPENAI_API_KEY=your_api_key_here
   

4. 🚀 启动开发服务器：

   npm run dev
   

🎯 如何使用 Probly

1. 🌐 在浏览器中启动应用程序
2. 📤 导入您的数据或从空白工作表开始
3. 🤖 使用快捷键访问 AI 功能：
   • Windows/Linux：Ctrl+Shift+?
   • Mac：⌘+Shift+?
4. 📚 使用提示库进行快速分析
5. 📄 上传文档以实现自动数据提取
6. 💬 用自然语言提问关于您的数据的问题

⌨️ 快捷键

操作	Windows/Linux	Mac
AI 对话	Ctrl+Shift+?	⌘+Shift+?
提示库	Ctrl+Shift+L	⌘+Shift+L

🛠️ 技术栈

• 前端：Next.js 14、TypeScript、React
• 电子表格：Handsontable、HyperFormula
• Python：Pyodide（WebAssembly）
• AI：OpenAI API（GPT-4、Vision API）
• 可视化：ECharts

📚 文档

有关详细文档，请访问我们的 Probly 文档。

👥 社区

加入我们的 Discord 社区 以：

• 💡 分享想法并获得帮助
• 🎉 及时了解新功能
• 👥 与其他用户交流
• 🤝 参与开发

📄 许可证

MIT 许可证 - 欢迎使用和修改！

Probly 快速上手指南

Probly 是一款新一代电子表格应用，结合了传统表格功能、浏览器端 Python 计算（WebAssembly）以及 AI 驱动的数据分析与文档处理能力。数据主要在本地浏览器运行，兼顾性能与隐私。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS 或 Linux
• Node.js：版本 18 或更高
• 包管理器：npm 或 yarn
• 浏览器：现代浏览器（Chrome, Firefox, Edge, Safari）
• API 密钥：有效的 OpenAI API Key（用于 AI 分析和视觉处理）
• 可选：Docker 及 Docker Compose（用于容器化部署）

提示：国内开发者若遇到 npm 安装缓慢问题，可临时切换至淘宝镜像源： npm config set registry https://registry.npmmirror.com

安装步骤

您可以选择使用 Docker（推荐，最快捷）或 手动安装。

方案一：使用 Docker 启动

1. 克隆仓库

   git clone https://github.com/PragmaticMachineLearning/probly.git
   cd probly
   

2. 配置环境变量 创建 .env 文件并填入您的 OpenAI API Key：

   echo "OPENAI_API_KEY=your_api_key_here" > .env
   

   (请将 your_api_key_here 替换为真实的密钥)

3. 构建并运行

   docker compose build
   docker compose up -d
   

4. 访问应用 打开浏览器访问：http://localhost:3000

方案二：手动安装运行

1. 克隆仓库

   git clone https://github.com/PragmaticMachineLearning/probly.git
   cd probly
   

2. 安装依赖

   npm install
   

3. 配置环境变量 在项目根目录创建 .env 文件，内容如下：

   OPENAI_API_KEY=your_api_key_here
   

4. 启动开发服务器

   npm run dev
   

5. 访问应用 打开浏览器访问：http://localhost:3000

基本使用

启动成功后，即可在浏览器中体验 Probly 的核心功能：

1. 导入数据 进入界面后，您可以直接上传 Excel/CSV 文件，或从空白表格开始手动输入数据。

2. 调用 AI 分析 选中数据区域，使用快捷键唤起 AI 助手进行自然语言问答或自动趋势分析：

   • Windows/Linux: Ctrl+Shift+?
   • Mac: ⌘+Shift+?

3. 使用预设模板 按下 Ctrl+Shift+L (Mac: ⌘+Shift+L) 打开提示词库（Prompt Library），快速应用预定义的分析模板。

4. 文档数据提取 点击上传按钮导入图片或文档，Probly 将利用 Vision API 自动提取其中的表格数据并填入单元格。

5. 运行 Python 代码 在单元格中直接编写 Python 代码（基于 Pyodide），实现复杂的本地数据处理与可视化图表生成。