klog 快速上手教程：3 步在终端创建你的第一份时间追踪记录
【免费下载链接】klogCommand-line tool for time tracking in a human-readable, plain-text file format.项目地址: https://gitcode.com/gh_mirrors/klog/klog
你是否常常在一天结束时想不起来时间都花在了哪里？klog 是一款基于纯文本格式的时间追踪工具，它把每天的记录变成一份人类可读的.klg文件，你只需要在终端里敲几个命令，就能轻松创建、查看和统计自己的时间记录。本教程将带你用 3 个简单步骤，快速创建你的第一份时间追踪记录，零基础也能一次上手。
为什么推荐用纯文本做时间追踪？
大多数时间追踪工具都要求你把数据存在私有数据库里，换工具就等于换牢笼。klog 反其道而行：你的时间数据就是一份普通文本文件，可以放在任何地方、用任何编辑器打开、用 Git 管理历史版本，甚至可以写脚本自由处理。这种"文件即数据库"的设计，让 klog 在时间追踪工具中显得格外轻量可靠。
更重要的是，klog 的命令行交互非常直观：start开始计时、stop结束计时、track直接补记、today快速查看今日概览，几乎不需要学习曲线。
第一步：安装 klog（两种最快方法）
klog 由 Go 编写，安装方式非常灵活。如果你电脑上已经有 Go 环境，一条命令即可完成安装：
go install github.com/jotaen/klog/klog@latest如果你更喜欢从源码构建，也可以先将仓库克隆到本地：
git clone https://gitcode.com/gh_mirrors/klog/klog克隆完成后进入目录，执行go build编译出可执行文件即可使用。无论哪种方式，装好后在终端输入klog --help，能看到命令列表就说明安装成功了。
第二步：创建你的时间记录文件
时间追踪的第一步是准备一个记录文件。先创建一个空目录专门存放你的时间数据，然后让 klog 帮你生成第一份记录：
mkdir ~/timetracking klog create ~/timetracking/times.klgcreate命令会在目标位置创建一个以当天日期开头的记录（对应源码实现见klog/app/cli/create.go）。现在用任意文本编辑器打开这个文件，你会看到类似这样的内容：
2026-08-19这就是 klog 的**记录（Record）**结构：第一行是日期，下面的空白区域用来填写条目。你完全可以手动编辑这个文件——因为它是纯文本，任何人都能读懂、修改。
第三步：用终端记录并查看你的时间
文件就绪后，最常用的操作就是记录时间。klog 提供了三种记录方式，对应不同场景：
| 场景 | 命令示例 | 说明 |
|---|---|---|
| 正在开始工作 | klog start '写周报' -f ~/timetracking/times.klg | 开启一个"开放时间区间"，自动记录当前时刻 |
| 工作结束 | klog stop -f ~/timetracking/times.klg | 把开放区间的结束时间补上 |
| 事后补记 | klog track '2h30m 开发新功能 #work' -f ~/timetracking/times.klg | 直接添加一条固定时长的记录 |
执行完start和stop后，再打开文件，你会看到时间区间已经被自动写入：
2026-08-19 (8h!) 9:00 - 11:30 写周报 2h30m 开发新功能 #work这就是 klog 最强大的地方——命令自动写文件，文件又完全透明。值得一提的是，(8h!)是"目标时长"（Should-Total），它让你能对比计划与实际的差距。相关命令逻辑可参考klog/app/cli/start.go和klog/app/cli/stop.go。
记录好之后，随时可以查看统计结果：
klog today -f ~/timetracking/times.klg # 今日概览 klog total ~/timetracking/times.klg # 所有时间总和today会显示今天的实际总时长、目标时长和差值（实现见klog/app/cli/today.go），而total则汇总全部记录的总时长（实现见klog/app/cli/total.go）。就这样，你的第一份时间追踪记录已经创建完成并开始为你工作啦！
进阶：让时间记录更好用的小技巧
当你熟悉了 3 步基本流程后，可以试试这些高频技巧：
- 使用标签分类：在摘要里加
#work、#home这样的标签，再用klog tags命令就能按标签统计时间（见klog/app/cli/tags.go）。 - 设定目标时长：在日期后面写
(8h!)，配合klog today --diff实时查看与目标的差距。 - 生成统计报告：
klog report支持按周、月、季度、年生成汇总报表（相关实现见klog/app/cli/report/目录）。
时间追踪的价值在于坚持记录，而 klog 让这个过程变得几乎零成本：一条命令开始，一条命令结束，剩下的交给纯文本文件。现在就打开终端，用这 3 步创建你的第一份时间追踪记录，让每一分钟都有迹可循吧！
【免费下载链接】klogCommand-line tool for time tracking in a human-readable, plain-text file format.项目地址: https://gitcode.com/gh_mirrors/klog/klog
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
