按摩提成记录工具 - 说明文档

================================

## 1. 软件简介

本工具是一款专为按摩师设计的提成记录与统计软件，特别进行了无障碍优化，以方便视障用户通过“保益悦听”读屏软件使用。

主要功能包括：按摩项目管理、提成快捷记录、多维度查询统计以及通过WebDAV实现的云端数据同步。


## 2. 主要功能

- **项目管理**
  - 在“项目管理”选项卡中，您可以添加、编辑和删除不同的按摩服务项目。
  - 每个项目可以设置其价格以及“排钟”、“点钟”、“点排”三种不同的提成金额。

- **提成记录**
  - 在“提成记录”选项卡中，您可以快速选择项目和提成类型，程序会自动填入对应的提成金额。
  - 您也可以手动修改金额，金额支持以0.5为单位进行调整。
  - 主列表会显示最近100条提成记录。

- **查询统计**
  - 在“查询统计”选项卡中，您可以按“今天”、“昨天”、“本月”或自定义日期范围进行查询。
  - 查询结果会按项目汇总，并显示总数和总金额。
  - 在查询结果上单击右键，可以查看该项目的提成明细，或将汇总结果导出为CSV文件。

- **WebDAV同步**
  - 在“WebDAV同步”选项卡中，您可以管理一个或多个WebDAV服务器配置。
  - **添加/编辑/删除**：管理您的服务器列表。服务器信息会保存在本地。
  - **上传**：将本地的数据库上传到您选定服务器的 `anmo` 文件夹下。
  - **下载**：从服务器的 `anmo` 文件夹下下载数据库，并覆盖本地数据。**此操作不可逆，请谨慎使用。**


## 3. 运行环境要求

本程序需要 .NET 8.0 桌面运行库的支持。如果您的电脑尚未安装，请从以下地址下载并安装：

- **.NET 8.0 桌面运行库 (x64):**
  https://dotnet.microsoft.com/zh-cn/download/dotnet/8.0/runtime?os=windows&arch=x64

请在下载页面中选择与您操作系统匹配的 ".NET Desktop Runtime" 版本进行安装。


## 4. 安装方法

1.  找到本工具的程序文件夹（通常名为MassageLogger或您重命名后的文件夹）。
2.  将整个文件夹复制到“保益悦听”读屏软件的安装目录下的 `apps` 文件夹内。
3.  重启“保益悦听”软件，即可在“悦听工具箱”中找到并启动本工具。


## 5. 数据存储

- 本地数据（包括数据库 `massagelogger.db` 和WebDAV服务器配置 `webdav_servers.json`）会自动创建并存储在以下目录：
  `C:\Users\您的用户名\Documents\BoyPcReader\apps\MassageLogger`

- 您无需手动创建这个文件夹，程序首次运行时会自动生成。

