# 南瓜的万事屋

**Repository Path**: ngcb/pumpkins-everything-house

## Basic Information

- **Project Name**: 南瓜的万事屋
- **Description**: 一款可以本地使用的事务管理程序
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-27
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎃 南瓜的万事屋

> Pumpkin's Everything House — 跨平台本地综合事务管理程序

**版本：v1.0 Build 20260527**

---

## 📖 简介

「南瓜的万事屋」是一款面向个人的综合事务与项目管理工具，支持**任务管理、项目分类、AI 智能助手**，所有数据本地存储（SQLite），可接入任意 OpenAI 兼容大模型。

### 核心特性

- 📋 **任务管理** — 创建/编辑/删除任务，支持优先级、状态、标签、截止日期、进展备注、处置方式
- 📁 **项目管理** — 多项目分类，自定义颜色标识
- 🤖 **AI 助手（右侧常驻面板）** — Chat 模式自由对话，Agent 模式自然语言操作事务
- ✅ **Agent 变更确认** — 变更前逐一展示待修改项，用户确认后才执行
- 📥 **智能导入** — 上传文件（txt/md/csv/json），AI 自动解析并批量创建任务
- 🗄️ **本地存储** — 全部数据存于 SQLite，配置（含 AI Key）也写入数据库
- 🌙 **暗黑主题** — 全局统一深色风格，良好对比度
- 🖥️ **Electron 封装** — 原生桌面窗口，无需浏览器

---

## 📁 项目结构

```
pumpkins-everything-house/
├── main.py                    # 启动入口
├── package.json               # Electron 配置与脚本
├── backend/
│   ├── app.py                 # Flask API 路由（任务/项目/AI/配置/导入）
│   ├── database.py            # SQLite 数据库模型与初始化
│   ├── ai_service.py          # AI 服务（Chat/Agent/工具调用）
│   └── requirements.txt       # Python 依赖
├── electron/
│   ├── main.js                # Electron 主进程（启动后端+创建窗口）
│   └── preload.js             # 预加载安全桥接
├── frontend/
│   ├── index.html             # 主页面
│   ├── css/
│   │   └── style.css          # 暗黑主题样式
│   └── js/
│       └── app.js             # 前端应用逻辑
└── .gitignore
```

---

## 🚀 快速开始

### 环境要求

- **Python** 3.10+
- **Node.js** 18+（仅 Electron 打包需要）

### 1. 安装 Python 依赖

```bash
pip install flask flask-cors openai python-dotenv
```

### 2. 启动服务

```bash
python main.py
```

浏览器访问 `http://localhost:5000`

### 3. 配置 AI 模型

进入「系统配置」页面，填入：

- **API 地址**：OpenAI 兼容接口地址（如 `https://api.openai.com/v1`）
- **API Key**：你的 API 密钥
- **模型名称**：如 `gpt-4o`、`deepseek-chat` 等
- 点击「测试连接」验证 → 保存

---

## 🖥️ Electron 桌面运行

不依赖浏览器，独立桌面窗口：

```bash
# 安装依赖
npm install

# 启动
npm start
```

Electron 会自动启动 Python 后端，等待就绪后打开窗口。关闭窗口时自动停止后端。

---

## 📦 打包分发

### Python 单文件（需浏览器）

```bash
pip install pyinstaller
python -m PyInstaller --onefile \
    --add-data "frontend;frontend" \
    --add-data "backend;backend" \
    --hidden-import flask \
    --hidden-import flask_cors \
    --hidden-import openai \
    --name "PumpkinHouse" \
    --console main.py
```

产物：`dist/PumpkinHouse.exe`

### Electron 完整打包

```bash
npm run build
```

产物：`release/南瓜的万事屋.exe`

---

## 🗄️ 数据库结构

| 表名 | 用途 |
|------|------|
| `projects` | 项目管理 |
| `tasks` | 任务（标题/描述/状态/优先级/标签/进展/处置） |
| `task_comments` | 任务评论 |
| `ai_config` | AI 与系统配置（API/Key/模型/版本号） |
| `conversations` | AI 对话会话 |
| `messages` | 对话消息记录 |
| `agent_changes` | Agent 变更记录（用于确认/追踪） |

---

## 🤖 AI Agent 工具列表

Agent 模式支持以下自然语言操作：

| 工具 | 功能 | 示例 |
|------|------|------|
| `create_task` | 创建任务 | "帮我创建一个高优先级的任务" |
| `update_task` | 更新任务 | "把 ID 为 3 的任务标记为已完成" |
| `query_tasks` | 查询任务 | "查询所有待办的高优先级任务" |
| `create_project` | 创建项目 | "创建一个叫'学习计划'的项目" |
| `add_comment` | 添加评论 | "给任务 5 添加一条备注" |
| `cleanup_tasks` | 清理旧任务 | "清理 30 天前完成的任务" |

---

## 🔧 技术栈

| 层 | 技术 |
|----|------|
| 后端 | Python / Flask |
| 数据库 | SQLite |
| 前端 | 原生 HTML/CSS/JS（无框架） |
| AI | OpenAI 兼容 API |
| 桌面封装 | Electron |
| 打包 | PyInstaller / electron-builder |

---

## 📄 许可

MIT License