# ai-office-agent-tool

**Repository Path**: elfbobo_admin_admin/ai-office-agent-tool

## Basic Information

- **Project Name**: ai-office-agent-tool
- **Description**: Excel 自动计算报表工具，打包 Exe 免环境全员即用
办公数据处理自动化脚本 | 一键生成可执行程序
本地离线 Excel 提效工具，可视化操作 + EXE 分发
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-14
- **Last Updated**: 2026-05-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Excel 快速计算提效工具

面向日常办公的 **Excel 处理小工具**：本地选文件、填写简单规则、一键生成新的 Excel。源码可 **打包为 Windows 独立程序**，分发后无需安装 Python。

- **界面**：tkinter（Python 自带，无需额外装 GUI 库）
- **表格**：openpyxl
- **打包**：PyInstaller  
- **离线**：不依赖数据库与网络

---

## 一、本地环境要求

| 项目 | 说明 |
|------|------|
| 操作系统 | Windows 10 / 11（开发与打包均以 Windows 为例） |
| Python | **3.10 及以上**（与 `pyproject.toml` 中 `requires-python` 一致） |
| 编辑器（可选） | PyCharm / VS Code 等 |

---

## 二、本地启动（运行源码）

### 1. 进入项目目录

在终端（PowerShell 或 CMD）中：

```powershell
cd D:\ai-office-agent-tool
```

（请改成你本机实际路径。）

### 2. 创建虚拟环境（推荐）

```powershell
python -m venv .venv
.\.venv\Scripts\Activate.ps1
```

若 PowerShell 禁止脚本，可先执行：

```powershell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
```

或使用 CMD：

```cmd
.\.venv\Scripts\activate.bat
```

### 3. 安装依赖

```powershell
pip install -r requirements.txt
pip install -e ".[build]"
```

第二行会把包以「可编辑」方式装进当前环境，便于 IDE 识别 `office_agent`，并安装打包用的 PyInstaller。

### 4. 启动程序

任选一种方式即可。

**方式 A：模块方式（推荐）**

```powershell
python -m office_agent
```

（需在项目根目录，且已执行过上面的 `pip install -e ".[build]"`。）

**方式 B：直接运行入口脚本**

```powershell
python src\office_agent\main.py
```

若未做可编辑安装，可先设置环境变量再运行：

```powershell
$env:PYTHONPATH = "src"
python src\office_agent\main.py
```

**方式 C：PyCharm**

1. 用 PyCharm 打开本项目文件夹。  
2. 解释器指向 `.venv` 下的 Python。  
3. 右键 `src/office_agent/main.py` → **Run 'main'**。  
4. 若导入报错，可将 `src` 标记为 **Sources Root**，或务必执行 `pip install -e ".[build]"`。

启动后会弹出桌面窗口：可选源 Excel、编辑规则文本、点击「生成 Excel…」保存结果。

---

## 三、本地编译（打包成 EXE）

### 前提

- 已完成上文「创建虚拟环境 + `pip install -r requirements.txt`」，且已安装 PyInstaller（随 `requirements.txt` 或 `pip install -e ".[build]"` 安装）。
- 在项目根目录执行打包命令。

### 使用脚本（推荐）

在项目根目录打开 PowerShell：

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\build_exe.ps1
```

脚本会调用 `.venv` 里的 Python 与 `scripts\office_agent.spec` 进行构建。

### 产物位置

- 可执行文件（仅此一个即可分发）：**`dist\OfficeAgentTool.exe`**

当前为 **onefile 单文件** 模式：把 **`OfficeAgentTool.exe`** 发给对方即可。首次启动会比单文件夹模式稍慢（需解压到系统临时目录）；部分杀毒软件可能误报，可加入信任区。

### 手动调用 PyInstaller（可选）

```powershell
.\.venv\Scripts\python -m PyInstaller .\scripts\office_agent.spec --noconfirm --clean
```

---

## 四、规则文本简要说明（界面内也有示例）

在程序里可写类似内容（`#` 开头为注释）：

```text
sheet=绩效表
headers=姓名,部门,绩效分,等级,备注
rows=8
```

具体解析逻辑见 `src/office_agent/core/rules_engine.py`；生成表格逻辑见 `src/office_agent/core/excel_builder.py`。

---

## 五、常见问题

**Q：双击 exe 没反应？**  
在命令行里运行 `dist\OfficeAgentTool.exe` 查看是否有报错；杀毒软件有时会拦截单文件 exe，可加入信任区。

**Q：想改回「旁边一堆文件」的单文件夹模式？**  
在 `scripts/office_agent.spec` 中改回 `exclude_binaries=True` + `COLLECT(...)` 写法即可（PyInstaller 文档中的 onedir 示例）。

**Q：依赖与 README 里以前写的不一致？**  
以本 README 与 **`requirements.txt`** 为准；当前版本未使用 pandas、streamlit 等。

---

更偏 PyCharm 的逐步说明还可参考仓库内 **`SETUP.txt`**。