# 项目台

**Repository Path**: ghosthack/xiangmutai

## Basic Information

- **Project Name**: 项目台
- **Description**: 单机项目管理。带看板、项目地图、紧急事项提醒和安装包脚本。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-10-27
- **Last Updated**: 2026-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目台 (XiangmuTai)

Windows 上的单机项目管理。按客户管理多个项目，数据只保存在这台电脑上。

仓库：https://gitee.com/ghosthack/xiangmutai

## 简介

项目台用 Python 和 PySide6 做成。一个窗口里可以放多个客户、多个项目，带看板、列表、周期和项目地图。不需要账号，数据也不会上传。

## 界面

首页按客户列出项目，并汇总逾期和即将到期的工作项。

![首页](screenshots/01-home.png)

看板按状态排列工作项。

![看板](screenshots/02-board.png)

列表可以按表头排序，也能一次处理多条。

![列表](screenshots/03-list.png)

周期统计这一段时间里的工作项和估点。

![周期](screenshots/04-cycles.png)

项目地图按客户看各项目的起止时间。滚轮可以放大缩小。

![项目地图](screenshots/05-map.png)

逾期、今天到期和标为紧急的工作项会留在桌面小窗里。

![紧急事项](screenshots/06-urgent.png)

## 主要功能

- **客户和项目**：先建客户，再建项目。客户从下拉列表里选。不同客户可以用相同的项目代号
- **工作项**：看板拖动改状态，列表可多选、可按表头排序
- **周期**：项目先有起止日期，周期必须落在这段日期里
- **项目地图**：按客户看项目起止和周期，滚轮缩放，拖动平移。没有甘特图导出
- **紧急事项**：逾期、今天到期，以及标为紧急的工作项显示在桌面小窗。关掉主窗口后小窗还在
- **托盘和开机启动**：关掉窗口会收到托盘。托盘「退出」或 Ctrl+Q 才会结束进程。可以开机自动启动
- **数据**：备份、从备份恢复、导出工作项或客户清单（CSV），回收站可恢复删掉的项目和工作项
- **在线更新**：启动后自动检查本仓库的最新发行版。帮助菜单和托盘里也可以检查

## 技术栈

- Python 3.13
- PySide6
- SQLite

## 安装

发行版页面提供 Windows 安装包。安装到本机的「项目台」目录，项目数据放在安装目录的 `data` 文件夹里，卸载程序不会删除这些数据。

从源码运行时，双击 `run.bat`。它会用 Python 3.13 准备环境并启动。也可以先安装依赖再运行：

```bash
pip install -r requirements.txt
python -m plane_local
```

打包安装包：

```bash
build.bat
```

安装包会出现在 `release` 目录，文件名里带版本号。

## 更新

安装版启动后会查看仓库最新发行版。已经是最新版本时不会打扰；有新版本时可以选择下载安装包。确认后程序会先退出，再打开安装程序，方便替换文件。项目数据留在原来的位置。

帮助菜单和托盘菜单里的「检查更新」可以手动再查一次。选「稍后」后，同一个版本不再提醒。

左侧「项目仓库」、帮助菜单和「关于」都可以打开：

https://gitee.com/ghosthack/xiangmutai

## 窗口底部

底部这一行的位置固定，文字会随页面变化：

- 全部客户、某个客户、项目地图：显示当前数据文件路径
- 打开某个项目：显示「显示几条 / 一共几条」，后面仍带着数据文件路径
- 备份、导出或从备份恢复之后：暂时显示这次操作的结果，切换页面后回到上面的内容

路径不是写死的。源码运行时一般是项目目录下的 `data\plane.db`；安装版在安装目录的 `data` 文件夹。

## 项目结构

```
plane_local/
├── constants.py    # 常量、版本号和仓库地址
├── db.py           # 数据库操作
├── dialogs.py      # 对话框和软件内说明
├── main_window.py  # 主窗口
├── startup.py      # 开机启动
├── update.py       # 检查更新和下载安装包
├── theme.py        # 主题样式
├── widgets.py      # 自定义控件
└── __main__.py     # 入口模块
```

## 使用说明

1. **新建客户**：左侧底部「新建客户」，或文件菜单。客户要单独新建
2. **新建项目**：左侧底部「新建项目」，或客户标题旁的「新建项目」。客户只能从下拉列表选择
3. **新建工作项**：打开项目后点「新建工作项」，或按 Ctrl+N
4. **看板、列表、周期**：Ctrl+1、Ctrl+2、Ctrl+3
5. **项目地图**：左侧「项目地图」，或 Ctrl+4
6. **软件内说明**：左侧「使用提示」，或按 F1
7. **真正退出**：托盘菜单「退出」，或 Ctrl+Q。点窗口关闭按钮只会收到托盘

## 许可证

MIT License