手艺生活记录应用使用说明
应用概述
"手艺生活记录"是一款基于Web的应用程序，专为记录和跟踪各类手工艺活动时间而设计。通过直观的界面和完善的功能，帮助您管理和分析您的手艺活动数据。
系统要求
- 运行PHP环境（推荐PHP 7.4+）
- MySQL数据库
- 现代浏览器（Chrome、Firefox、Edge、Safari等）
- 互联网连接（访问在线部署版本时）
安装指南
自行部署
-
准备环境
- 确保服务器已安装PHP和MySQL
- 创建MySQL数据库
-
部署文件
- 下载或克隆项目代码到服务器
- 配置
config.php文件，修改数据库连接信息：$db_config = [ 'host' => '您的数据库服务器地址', 'dbname' => 'nntracker', 'username' => '数据库用户名', 'password' => '数据库密码', 'charset' => 'utf8mb4' ];
-
初始化数据库
- 导入
db/schema.sql文件创建所需表结构
- 导入
-
访问应用
- 通过浏览器访问部署目录下的index.php
在线使用
访问已部署的在线演示版本：NewNewTracker
基本功能使用
账户管理
-
注册账户
- 访问应用首页，点击"立即注册"
- 填写用户名（至少3个字符）和密码（至少6个字符）
- 确认密码后点击"注册"按钮
-
登录账户
- 输入已注册的用户名和密码
- 点击"登录"按钮进入主界面
-
退出登录
- 在主页面右上角点击"退出登录"按钮
记录活动
-
开始记录
- 在主页面点击"开始"按钮
- 计时器开始运行，记录您的活动时间
-
结束记录
- 活动结束后，点击"结束"按钮停止计时
- 在显示的文本框中输入可选备注信息
- 点击"保存"完成记录
查看历史记录
-
切换到历史记录
- 点击顶部"历史记录"标签
-
筛选记录
- 选择筛选类型：全部记录、按月筛选或按年筛选
- 选择具体的年份和月份（若适用）
- 点击"应用筛选"按钮
-
删除记录
- 在历史记录列表中找到要删除的记录
- 点击对应行的"删除"按钮
- 确认删除操作
数据导入导出
-
导出数据
- 在主页面点击"导出数据"按钮
- 系统自动生成JSON格式文件并下载到您的设备
-
导入数据
- 点击"导入数据"按钮
- 选择之前导出的JSON文件
- 确认导入（注意：导入会覆盖当前数据）
查看统计数据
统计卡片自动显示以下数据：
- 总记录次数
- 平均持续时间
- 本周记录次数
- 本月记录次数
使用日历功能
-
月视图
- 默认显示当月日历
- 不同颜色深浅代表活动频率
- 点击或悬停于有记录的日期可查看详情
- 使用"<"和">"按钮切换月份
-
年视图
- 点击日历上方的"年"按钮切换到年视图
- 查看全年12个月的活动分布
- 点击有记录的日期查看详细信息
- 使用"<"和">"按钮切换年份
高级功能提示
-
备注功能的高效使用
- 使用简洁关键词记录活动类型
- 可添加标签如"#项目名称"便于日后筛选
-
数据安全
- 定期导出数据进行备份
- 导出的数据可跨设备导入
故障排除
-
无法登录
- 检查用户名和密码是否正确
- 确认网络连接正常
- 清除浏览器缓存后重试
-
记录无法保存
- 检查网络连接是否正常
- 确认您已登录账户
- 刷新页面后重试
-
统计数据不更新
- 切换页面标签后再切换回来
- 刷新浏览器页面
-
导入数据失败
- 确认导入文件格式正确（必须是本应用导出的JSON文件）
- 检查文件是否损坏
- 确保文件大小不超过限制
数据隐私说明
所有用户数据均存储在数据库中，仅对当前登录用户可见。应用不会共享您的个人记录数据，请放心使用。
灵感与许可证
本项目灵感来自于zzzdajb/DickHelper，原项目为"一个简单易用的手冲管理工具"。
根据GPL-3.0许可证要求，本项目同样采用GNU通用公共许可证第3版(GPL-3.0)进行许可。
主要修改
相比原项目，本项目进行了以下修改：
- 更改了用途，专注于记录各类手艺活动时间
- 增加了年视图日历功能
- 增加了按月份和年份筛选历史记录的功能
- 优化了UI界面和用户体验
- 增加了月份/年份导航功能
- 增加了Vercel一键部署教程