手艺生活记录应用使用说明

应用概述

"手艺生活记录"是一款基于Web的应用程序，专为记录和跟踪各类手工艺活动时间而设计。通过直观的界面和完善的功能，帮助您管理和分析您的手艺活动数据。

系统要求

• 运行PHP环境（推荐PHP 7.4+）
• MySQL数据库
• 现代浏览器（Chrome、Firefox、Edge、Safari等）
• 互联网连接（访问在线部署版本时）

安装指南

自行部署

1. 准备环境

   • 确保服务器已安装PHP和MySQL
   • 创建MySQL数据库

2. 部署文件

   • 下载或克隆项目代码到服务器
   • 配置config.php文件，修改数据库连接信息：

     $db_config = [
         'host'     => '您的数据库服务器地址',
         'dbname'   => 'nntracker',
         'username' => '数据库用户名',
         'password' => '数据库密码',
         'charset'  => 'utf8mb4'
     ];

3. 初始化数据库

   • 导入db/schema.sql文件创建所需表结构

4. 访问应用

   • 通过浏览器访问部署目录下的index.php

在线使用

访问已部署的在线演示版本：NewNewTracker

基本功能使用

账户管理

1. 注册账户

   • 访问应用首页，点击"立即注册"
   • 填写用户名（至少3个字符）和密码（至少6个字符）
   • 确认密码后点击"注册"按钮

2. 登录账户

   • 输入已注册的用户名和密码
   • 点击"登录"按钮进入主界面

3. 退出登录

   • 在主页面右上角点击"退出登录"按钮

记录活动

1. 开始记录

   • 在主页面点击"开始"按钮
   • 计时器开始运行，记录您的活动时间

2. 结束记录

   • 活动结束后，点击"结束"按钮停止计时
   • 在显示的文本框中输入可选备注信息
   • 点击"保存"完成记录

查看历史记录

1. 切换到历史记录

   • 点击顶部"历史记录"标签

2. 筛选记录

   • 选择筛选类型：全部记录、按月筛选或按年筛选
   • 选择具体的年份和月份（若适用）
   • 点击"应用筛选"按钮

3. 删除记录

   • 在历史记录列表中找到要删除的记录
   • 点击对应行的"删除"按钮
   • 确认删除操作

数据导入导出

1. 导出数据

   • 在主页面点击"导出数据"按钮
   • 系统自动生成JSON格式文件并下载到您的设备

2. 导入数据

   • 点击"导入数据"按钮
   • 选择之前导出的JSON文件
   • 确认导入（注意：导入会覆盖当前数据）

查看统计数据

统计卡片自动显示以下数据：

• 总记录次数
• 平均持续时间
• 本周记录次数
• 本月记录次数

使用日历功能

1. 月视图

   • 默认显示当月日历
   • 不同颜色深浅代表活动频率
   • 点击或悬停于有记录的日期可查看详情
   • 使用"<"和">"按钮切换月份

2. 年视图

   • 点击日历上方的"年"按钮切换到年视图
   • 查看全年12个月的活动分布
   • 点击有记录的日期查看详细信息
   • 使用"<"和">"按钮切换年份

高级功能提示

1. 备注功能的高效使用

   • 使用简洁关键词记录活动类型
   • 可添加标签如"#项目名称"便于日后筛选

2. 数据安全

   • 定期导出数据进行备份
   • 导出的数据可跨设备导入

故障排除

1. 无法登录

   • 检查用户名和密码是否正确
   • 确认网络连接正常
   • 清除浏览器缓存后重试

2. 记录无法保存

   • 检查网络连接是否正常
   • 确认您已登录账户
   • 刷新页面后重试

3. 统计数据不更新

   • 切换页面标签后再切换回来
   • 刷新浏览器页面

4. 导入数据失败

   • 确认导入文件格式正确（必须是本应用导出的JSON文件）
   • 检查文件是否损坏
   • 确保文件大小不超过限制

数据隐私说明

所有用户数据均存储在数据库中，仅对当前登录用户可见。应用不会共享您的个人记录数据，请放心使用。

灵感与许可证

本项目灵感来自于zzzdajb/DickHelper，原项目为"一个简单易用的手冲管理工具"。

根据GPL-3.0许可证要求，本项目同样采用GNU通用公共许可证第3版(GPL-3.0)进行许可。

主要修改

相比原项目，本项目进行了以下修改：

• 更改了用途，专注于记录各类手艺活动时间
• 增加了年视图日历功能
• 增加了按月份和年份筛选历史记录的功能
• 优化了UI界面和用户体验
• 增加了月份/年份导航功能
• 增加了Vercel一键部署教程

许可证

GNU通用公共许可证第3版(GPL-3.0)