CopraVopasen/trackr
GitHub: CopraVopasen/trackr
一款基于 Go 和 Bubble Tea 框架的终端时间追踪工具,集成番茄钟和项目管理功能,帮助用户在命令行中高效管理个人时间。
Stars: 1 | Forks: 0
# ⏱️ trackr - 简单的终端时间追踪器
[](https://github.com/CopraVopasen/trackr/releases)
## 📋 什么是 trackr?
trackr 是一款基于终端的应用程序,旨在帮助您管理时间。它直接在您电脑的命令行窗口中运行。该应用程序允许您启动计时器,将工作组织到项目中,并生成关于您时间花费的报告。它还包含一个帮助保持专注的番茄钟计时器,以及用于导出数据以便您在其他地方使用的选项。
有了 trackr,您无需在应用程序之间切换或使用复杂的工具。一切都在您的终端中发生,使其轻量且快速。
## 💻 trackr 可以在哪些系统上运行?
trackr 是使用 Go(一种流行的编程语言)构建的,因此它可以在大多数电脑上运行,包括:
- Windows 10 或更新版本
- macOS 10.13 或更新版本
- Linux 发行版(Ubuntu、Fedora 等)
您需要一个终端应用程序来使用 trackr,您的系统默认已经自带了终端。
## 🔧 主要功能
- 计时器:轻松开始、暂停和停止时间追踪。
- 项目:将任务和时间条目归类到项目名称下。
- 报告:按天、周或项目查看您的工作摘要。
- 番茄钟:使用内置计时器应用番茄工作法。
- 导出:将您追踪的时间保存为电子表格用的 CSV 文件。
- SQLite 数据库:在您的电脑上安全地本地保存数据。
- 轻量级:直接在终端中运行所有内容,无需额外程序。
## 🚀 快速入门
本指南将帮助您快速下载并开始使用 trackr。
### 第 1 步:下载 trackr
点击本页面顶部的大蓝色按钮或访问:
[https://github.com/CopraVopasen/trackr/releases](https://github.com/CopraVopasen/trackr/releases)
此页面包含所有可供下载的 trackr 版本。
### 第 2 步:选择适合您电脑的文件
在发布页面上,找到最新版本。在最新版本下,您会看到带有以下扩展名的文件:
- `.exe` 适用于 Windows
- `.dmg` 适用于 macOS
- `.tar.gz` 或 `.deb` 适用于 Linux
下载与您的操作系统相匹配的文件。
### 第 3 步:安装 trackr
- **Windows:** 双击 `.exe` 文件并按照提示操作。如果是独立程序,您可能只需直接运行它。
- **macOS:** 打开 `.dmg` 文件,然后将 trackr 应用程序拖到您的 Applications 文件夹中。
- **Linux:** 如果可用,请使用您的包管理器,或者解压 `.tar.gz` 文件并按照包含的说明进行操作。
### 第 4 步:打开您的终端
- **Windows:** 打开 PowerShell 或 Command Prompt。
- **macOS:** 从 Applications > Utilities(实用工具)中打开 Terminal。
- **Linux:** 打开您平时使用的终端应用程序。
### 第 5 步:运行 trackr
输入 `trackr` 并按 Enter 键。这将在您的终端窗口中启动该应用程序。
## 🎯 如何使用 trackr
trackr 使用在终端中输入的简单命令。以下是入门基础知识。
### 启动计时器
要开始追踪任务时间,请输入:
```
trackr start [project_name]
```
将 `[project_name]` 替换为您想要处理的项目名称。例如:
```
trackr start marketing
```
这将开始记录您的营销工作时间。
### 暂停和停止
要暂停计时器:
```
trackr pause
```
要停止并保存您的时间条目:
```
trackr stop
```
### 检查您的时间
要查看您今天追踪了多少时间:
```
trackr report today
```
要查看本周在某个项目上花费的时间:
```
trackr report week marketing
```
### 使用番茄钟计时器
使用以下命令启动番茄钟会话:
```
trackr pomodoro start
```
使用以下命令暂停它:
```
trackr pomodoro pause
```
使用以下命令停止它:
```
trackr pomodoro stop
```
trackr 会在每个番茄钟会话结束时通知您。
### 导出您的数据
要将您的时间条目导出为 CSV 文件:
```
trackr export csv
```
此文件可以在 Excel 等电子表格应用程序中打开。
## 📥 下载并安装
返回此处的下载页面:
[https://github.com/CopraVopasen/trackr/releases](https://github.com/CopraVopasen/trackr/releases)
- 在页面顶部找到最新版本。
- 选择与您的操作系统(Windows、macOS、Linux)相匹配的文件。
- 下载并运行该文件。
- 按照上一节的说明安装并启动 trackr。
如果您遇到问题,请查看 GitHub 页面上的“Issues”标签以寻求帮助,或者在线搜索适用于您操作系统的终端基础知识。
## ⚙️ 配置和设置
trackr 将其数据本地存储在您主目录内的数据库文件中。您无需手动进行任何设置。但是,您可以自定义:
- 默认项目名称
- 计时器设置,如番茄钟时长
- 导出文件路径
您可以通过编辑位于以下位置的配置文件来更改这些设置:
```
~/.trackr/config.yaml
```
使用任何文本编辑器打开此文件。它包含解释每个选项的注释。
## 🛠 故障排除
- 如果 trackr 未启动,请确保您安装了适合您操作系统的正确文件。
- 在 Windows 上,如果程序被阻止,请检查您的杀毒软件或安全设置。
- 对于 macOS/Linux 上的权限问题,请尝试在终端中运行 `chmod +x trackr` 以使其可执行。
- 如果命令不起作用,请输入 `trackr help` 以查看所有可用选项。
## 🔄 更新
定期查看发布页面以获取新版本。每次更新可能包含错误修复或新功能。
要更新,请下载最新文件并用它替换您现有的 trackr 程序。
## 📚 了解更多
使用终端命令:
```
trackr help
```
查看完整的命令列表及其使用方法。
访问 GitHub 仓库以获取详细的文档和示例:
[https://github.com/CopraVopasen/trackr](https://github.com/CopraVopasen/trackr)
## 🧰 关于技术
trackr 是使用以下技术构建的:
- Go (Golang) – 一种快速且可靠的编程语言。
- Bubble Tea – 一个用于构建终端用户界面的框架。
- SQLite – 一个用于存储您追踪时间的简单数据库。
这种组合使 trackr 轻量、快速,并且易于在您的终端窗口内使用,无需其他软件。
## 🏷 主题
bubble-tea, cli, go, golang, pomodoro, productivity, sqlite, terminal, time-tracker, tui
标签:CLI, EVTX分析, Golang, Go语言, LangChain, Linux 内核安全, Pomodoro, PPID欺骗, SQLite, trackr, WiFi技术, 任务追踪, 安全编程, 开源, 报表生成, 效率工具, 日志审计, 时间管理, 时间记录, 本地数据库, 番茄钟, 程序破解, 终端应用, 计时器, 轻量级, 项目管理