mo_planX 用户手册 v1.0.3

一款专注于「好看」与「好用」的桌面日程计划表 作者：mobai　·　博客：https://www.moxbai.cn 适用版本：v1.0.3

目录

1. 软件简介
2. 安装与卸载
3. 首次启动
4. 主界面概览
5. 视图操作（周计划 / 月计划）
6. 任务管理
7. 提醒功能
8. 导入与导出
9. 计划卡片与悬浮窗
10. 个性化设置
11. 常规设置
12. 数据存储位置
13. 快捷键一览
14. 常见问题 FAQ
15. 版本更新说明

1. 软件简介

mo_planX 是一款基于 PyQt5 开发的 Windows 桌面日程计划表程序，主打高度可定制的视觉外观与流畅的果冻质感交互动画。它以日历卡片的形式管理你的日程，支持周 / 月两种视图、定时提醒、Excel 与自然语言智能导入、计划悬浮窗等功能。

核心特点：

• 自由卡片布局：计划以卡片形式按「日期 + 上午 / 下午」自由排布，不再是死板的表格。
• 磨砂玻璃 + 果冻质感：卡片半透明磨砂、按钮弹性回弹动画，视觉现代柔和。
• 深度个性化：背景图、主题配色、字体、圆角、阴影、边框艺术风格、动画强度均可自定义。
• 智能导入：粘贴一段中文文字即可自动识别日期、时间、提醒并批量生成任务。
• 提醒不遗漏：到点弹出提醒小窗 + 系统通知，可稍后提醒，支持系统托盘常驻。

2. 安装与卸载

2.1 安装

1. 双击运行 Setup.exe（粉色水墨风格安装向导）。
2. 按提示选择安装位置，点击安装。
3. 安装完成后，桌面与开始菜单会创建 mo_planX 快捷方式。

建议安装到普通目录（如 D:\mo_planX）。若安装到 C:\Program Files 等受保护目录，程序数据写入可能因权限受限，首次启动会给出提醒。

2.2 卸载

有两种方式，任选其一：

• 开始菜单：打开「开始菜单 → mo_planX → 卸载 mo_planX」。
• 安装目录：进入安装目录，运行 uninstall.exe。

卸载程序会弹出确认框，确认后将关闭正在运行的程序、删除桌面 / 开始菜单快捷方式，并清除整个安装目录（含全部数据）。请在卸载前自行备份重要日程数据。

3. 首次启动

第一次运行 mo_planX 会弹出欢迎向导，简单介绍软件后即可进入主界面。程序会自动在安装目录下创建 data 数据文件夹用于存放数据库、配置与日志，无需手动选择数据位置。

4. 主界面概览

主窗口采用日历风格，主要区域包括：

菜单功能一览：

• 文件：导入 Excel、智能导入、导出 Excel、退出
• 任务：添加任务、编辑任务、删除任务、标记完成 / 未完成
• 视图：隐藏 / 显示已完成任务、按日期筛选、清除日期筛选、搜索任务
• 设置：打开设置
• 帮助：关于

5. 视图操作（周计划 / 月计划）

5.1 周计划

• 顶部有上一周 / 下一周相邻胶囊按钮（带果冻回弹动画）与回到本周按钮。
• 通过日期选择器可快速跳转到任意一周。
• 每天按「上午 / 下午」分区自由排布计划卡片；左侧为 iOS 风格的时间转轮（仅显示「上午 / 下午」，滚动带吸附效果）。
• 精确任务时间（如 10:14–13:21）会存储并显示在卡片上，但不影响卡片所在的上午 / 下午分区。

5.2 月计划

• 以整月日历格子展示，每个日期格显示当天的计划条目，超出部分以「更多」提示。
• 顶部同样提供上一月 / 下一月 / 回到本月导航。
• 点击某天可进一步查看或跳转到对应周视图。

6. 任务管理

6.1 新建任务

通过「任务 → 添加任务」（快捷键 Ctrl+N），或在视图空白处操作打开任务对话框。任务字段包括：

6.2 编辑 / 删除 / 完成

• 编辑任务：选中后「任务 → 编辑任务」（Ctrl+E），或点击卡片打开详情弹窗编辑。
• 删除任务：「任务 → 删除任务」（Delete），会弹出确认框。
• 标记完成：「任务 → 标记完成 / 未完成」，或选中任务后按 空格键 快速切换。

6.3 筛选与搜索

• 搜索任务：「视图 → 搜索任务」（Ctrl+F），按关键字过滤。
• 按日期筛选 / 清除日期筛选：快速聚焦某一天。
• 隐藏 / 显示已完成任务：一键切换是否显示已完成项。

7. 提醒功能

• 程序每 30 秒检查一次到期提醒。
• 到点后弹出提醒小窗（粉色渐变 / 可自定义背景），并发送 Windows 系统通知。
• 提醒窗支持稍后提醒（Snooze）与查看详情。
• 可将程序最小化到系统托盘常驻后台，不错过任何提醒。

8. 导入与导出

8.1 Excel 导入 / 导出

• 「文件 → 导入 Excel」：从 Excel 表格批量导入任务。
• 「文件 → 导出 Excel」：将当前任务导出为 Excel 文件备份。

8.2 智能导入（自然语言）

「文件 → 智能导入」（Ctrl+Shift+I）。在文本框中按行粘贴中文日程描述，程序会自动解析日期、时间、提醒与重复类型，并在下方预览表格中生成任务，可直接双击单元格编辑修正后再确认导入。

支持识别的自然语言示例：

明天下午三点 开会 提前30分钟提醒
下周三 上午 交报告
2026-07-10 19:00 健身 每天
今天 20:30 给妈妈打电话

可识别「今天 / 明天 / 下周三 / 2026-07-10」等日期、「上午 / 下午 / 三点 / 19:00」等时间、「提前 30 分钟提醒」等提醒关键词、「每天 / 每周」等重复关键词。

9. 计划卡片与悬浮窗

• 计划卡片采用磨砂玻璃效果（半透明 + 柔和高光），支持自定义边框艺术风格（漫画 / 素描 / 虚线 / 双线）。
• 卡片入场带弹性动画，鼠标悬停时会轻微上浮、加深阴影。
• 右键卡片 →「以悬浮窗打开」：可将某条计划弹为独立的无边框置顶悬浮小窗，可拖动、可多开，方便钉在桌面随时查看。悬浮窗内可直接编辑 / 完成 / 删除，改动实时同步。

10. 个性化设置

打开「设置 → 打开设置」，切换到「个性化」选项卡。设置对话框底部按钮顺序为 取消 → 应用 → 确定（应用可即时预览效果，取消会回滚未保存的更改）。

可调整项：

背景 / 主题 / 字体

• 主窗口背景图：支持浏览选图与内置裁剪；布局可选拉伸 / 平铺 / 居中。
• 主窗口透明度：0.3 – 1.0。
• 小窗口背景图 / 透明度：单独设置提醒窗与悬浮窗背景。
• 背景模式：浅色 / 深色。
• 文字颜色模式：跟随背景（自动对比）/ 深色文字 / 浅色文字。
• 主题强调色：多套配色预设或自定义颜色。
• 字体：可加载自定义字体文件（.ttf/.otf）；字号提供 10 / 12 / 14 / 16 px 预设及 8–72 px 自定义。

背景效果

• 背景模糊（0–20）、半透明遮罩颜色与不透明度。

卡片外观

• 背景不透明度、圆角、边框宽度与颜色、投影（开关 / 颜色 / 模糊 / 偏移）、悬停放大变亮。
• 优先级颜色：普通 / 重要 / 紧急 三种任务底色可自定义。
• 卡片边框艺术风格与时间形状（圆形 / 方形 / 椭圆 / 圆角矩形 / 菱形）及其颜色。

交互动画（果冻质感）

• 动画强度：无 / 标准弹性 / 夸张弹跳。
• 果冻按钮范围：仅主要按钮 / 全部按钮。
• 日期选择器样式：美化 QDateEdit / 独立小日历面板。
• 性能模式 / 流畅度优先：低配设备可关闭动画以提升流畅度。

11. 常规设置

「设置 → 打开设置 →「常规」」选项卡：

• 默认提前提醒分钟数：新建任务时的默认提醒提前量。
• 提示音文件：自定义提醒声音。
• 开机自启：随 Windows 启动（写入注册表，可随时关闭）。
• 关闭行为：每次询问 / 最小化到托盘 / 直接退出。

12. 数据存储位置

自 v1.0.x 起，所有应用数据统一存放在程序安装目录下的 data 文件夹中：

<安装目录>\mo_planX\data\
    ├── planner.db      数据库（全部任务）
    ├── config.ini      配置文件（外观、常规设置）
    ├── error.log       运行日志
    └── themes\         主题预设与自定义主题（.theme）

备份数据只需复制整个 data 文件夹即可。用户不能再自定义数据位置，以保证程序绿色、可携带。

13. 快捷键一览

14. 常见问题 FAQ

Q1：主窗口背景图设置后不显示 / 设置不了？ A：v1.0.3 已修复。旧版在安装路径含特殊字符（如英文单引号 '）时，背景样式解析会被截断导致背景不显示。请升级到 v1.0.3。若仍不显示，请确认所选图片文件真实存在且格式受支持（PNG/JPG 等）。

Q2：设置了背景，月视图看不到而周视图能看到？ A：v1.0.3 已统一周 / 月视图的透明处理，两个视图均可正常透出背景。

Q3：数据保存在哪里？如何备份 / 迁移？ A：见「12. 数据存储位置」。备份 / 迁移只需复制安装目录下的 data 文件夹。

Q4：安装到 C 盘 Program Files 后提示写入受限？ A：这些是系统受保护目录，普通权限无法写入。建议将程序安装到非系统盘的普通目录（如 D:\mo_planX）。

Q5：动画卡顿 / 想要更简洁的效果？ A：在「个性化 → 交互动画」中把动画强度调为「无」，或开启性能模式 / 流畅度优先。

Q6：卸载后数据还在吗？ A：卸载会删除整个安装目录（含 data）。如需保留数据，请在卸载前备份 data 文件夹。

15. 版本更新说明

v1.0.3

• 修复：安装路径包含特殊字符（如单引号 '）时，主窗口 / 提醒窗 / 悬浮窗背景图无法显示的问题（背景样式改用双引号包裹路径，兼容任意合法 Windows 路径）。
• 修复：月视图滚动区未透明，导致背景图在月视图下被遮挡的问题。
• 周 / 月视图背景透明处理统一，视觉一致。

v1.0.2（既往）

• 数据存储统一到安装目录 data，移除自定义数据路径。
• 菜单栏 / 视图重构，周视图导航胶囊按钮，视图列对齐优化。
• 设置对话框精简为「常规 / 个性化 / 关于」三卡。
• 新增一键卸载程序 uninstall.exe 并集成到安装器。
• 全局果冻质感动画（按钮、卡片、输入框、滚动条、窗口、时间转轮），新增动画强度调节。