TimeTagger 本地部署与开机自启手册一、TimeTagger 产品介绍TimeTagger 是一款轻量级、开源免费的Web端时间跟踪工具基于PythonWeb技术开发支持本地离线运行、时间记录分类、数据统计分析无需云端账号即可实现数据本地持久化存储界面简洁易用适合个人日常时间管理、工作时长统计等场景兼顾轻量化与实用性支持自定义部署端口与数据存储位置。TimeTagger 官网https://timetagger.app/二、前置准备操作系统Windows 全系列Win10/Win11 优先已安装Python 3.8及以上版本并配置好系统环境变量可通过python \-\-version验证下载 TimeTagger 官方源码压缩包ZIP格式三、完整部署步骤1. 下载并解压源码包第一步访问 TimeTagger GitHub 仓库下载压缩包打开浏览器输入 GitHub 仓库地址https://github.com/almarklein/timetagger进入仓库后找到页面右侧的Releases版本发布区域或直接访问https://github.com/almarklein/timetagger/releases在 Releases 列表中找到26.1.3 版本标有「Latest」或「Stable」的稳定版向下滚动找到「Assets」资源板块点击Source code (zip)下载源码压缩包文件名timetagger-26.1.3.zip若看不到 26.1.3可在版本列表中翻找或用页面搜索CtrlF输入「26.1.3」定位第二步解压压缩包关键无中文 / 特殊字符路径找到下载的timetagger-26.1.3.zip默认在「下载」文件夹右键压缩包 → 选择「解压到…」在弹出的路径选择窗口中选择磁盘根目录下的纯英文文件夹推荐D:\tools若没有则先新建右键 → 新建 → 文件夹命名为tools确认解压后的完整路径为D:\tools\timetagger-26.1.3重点路径中不能有中文、空格、括号、特殊符号如#%点击「确定」完成解压验证解压结果打开D:\tools\timetagger-26.1.3能看到requirements.txt、setup.py等文件说明解压正确2. 安装项目依赖按下Win\R输入cmd打开命令提示符窗口通过cd命令切换到解压后的项目根目录示例命令cdD:\tools\timetagger-26.1.3执行依赖安装命令一键安装所需组件推荐搭配国内镜像源加速pipinstall-rrequirements.txt-ihttps://pypi.tuna.tsinghua.edu.cn/simple3. 启动服务并验证部署打开命令提示符CMD通过cd命令切换到解压后的项目根目录示例cd D:\tools\timetagger-26.1.3执行启动命令TimeTagger 默认端口为 8080我自定义调整为 8787命令如下python -m timetagger --bind127.0.0.1:8787若想恢复默认端口命令改为python -m timetagger --bind127.0.0.1:8080端口可任意自定义如 8788、8081只要未被其他程序占用即可启动成功验证命令行窗口会保持运行状态打印服务相关日志无红色报错、无「端口被占用」提示即代表部署正常打开任意浏览器输入你自定义的端口访问地址http://localhost:8787/timetagger/app/若用默认端口则访问http://localhost:8080/timetagger/app/确认页面能正常加载。4. 进入正式APP模式核心步骤页面加载完成后找到并点击左上角的 APP 菜单在下拉选项中点击APP应用程序切换至本地持久化模式此时退出演示沙箱状态所有时间记录、标签配置都会本地保存关闭浏览器不会丢失数据5. 配置开机自启免手动启动完成APP模式切换后关闭当前命令行窗口重启电脑开机后无需双击任何脚本、无需重新执行启动命令直接浏览器访问原有地址即可使用服务会在后台静默自启全程无弹窗、不占用桌面资源四、常规使用流程电脑开机等待系统加载完成浏览器输入地址http://localhost:8787/timetagger/app/直接进入TimeTagger操作界面开始时间记录、分类、统计五、完整注意事项项目解压路径严禁包含中文、空格、特殊符号否则会导致依赖安装失败、服务无法读取数据必须点击左上角APP菜单→APP应用程序否则处于沙箱演示模式关闭页面数据立即丢失保持8787端口不被其他程序占用若端口冲突可将启动命令端口改为8788、8080等未占用端口禁止删除Python环境否则会导致服务无法自启、运行崩溃数据默认存储在系统用户目录定期手动备份数据目录防止系统故障丢失记录开机自启为后台静默运行任务管理器可查看对应的python.exe进程勿随意结束该进程六、常见故障排查1. 端口被占用无法启动:: 查找8787端口占用进程PIDnetstat-ano|findstr :8787 :: 强制终止占用进程替换PID为实际数字 taskkill /F /PID12342. 依赖安装失败/超时:: 先升级pip工具 python-mpipinstall--upgradepip :: 重新安装依赖更换国内镜像源 pipinstall-rrequirements.txt-ihttps://mirrors.aliyun.com/pypi/simple/3. 开机无法自启重新进入项目根目录手动执行启动命令再次点击APP→APP应用程序切换模式重启电脑验证自启效果4. 数据无法保存确认已退出沙箱模式完成APP模式切换检查当前Windows用户是否拥有目录读写权限关闭杀毒/防护软件排除拦截进程的情况七、服务启停补充临时停止服务找到运行的python.exe命令行窗口按下Ctrl\C关闭窗口即可禁用开机自启删除自启配置或卸载全局TimeTagger恢复手动启动模式GitHub 仓库主页https://github.com/almarklein/timetagger26.1.3 版本发布页https://github.com/almarklein/timetagger/releases/tag/26.1.3