klog 新手必看：10 个最常用的时间追踪命令速查清单

klog 新手必看10 个最常用的时间追踪命令速查清单【免费下载链接】klogCommand-line tool for time tracking in a human-readable, plain-text file format.项目地址: https://gitcode.com/gh_mirrors/klog/klogklog 是一款基于纯文本文件格式的命令行时间追踪工具time tracking CLI它把每天的工时记录写成人类可读的.klg文件再用一条条简洁的命令完成计时、统计和报表。对新手来说klog 时间追踪命令并不难本文整理了 10 个最常用的 klog 命令配好示例和速查表照着敲就能上手。提示本文面向新手如果你需要完整语法可随时运行klog info --spec查看官方格式规范对应仓库中的 Specification.md 文档或者用klog --help查看全部命令。klog 是什么为什么值得一试在介绍命令之前先花 30 秒理解 klog 的核心设计你的时间数据就是一个普通的文本文件。比如2026-08-19 09:00 - 12:00 写季度报告 #work 13:00 - ? 整理 klog 使用教程 #work每天的日期是一行记录头下面的缩进行是条目09:00 - 12:00表示一条已结束的时间段?表示正在进行中标签如#work用来给时间打分类方便后续统计。这种设计意味着数据永远归你所有、永远可读、永远可以用任何文本编辑器修改不会被任何私有格式绑架。而 klog 命令则负责帮你自动维护这个文件避免手写出错。如果你是从源码运行可以克隆仓库获取git clone https://gitcode.com/gh_mirrors/klog/klog然后用 Go 构建即可。速查清单10 个 klog 时间追踪命令一览命令一句话作用最常用示例klog start开始一条开放式计时klog start --summary 写周报klog stop结束当前计时klog stopklog today今日工时速览klog today --diffklog total统计总时长klog total --filter#workklog create新建某天的记录klog create --date 2026-08-19klog edit用编辑器打开数据文件klog editklog report按周期生成报表klog report --aggregate weekklog print打印记录内容klog print --with-totalsklog tags按标签统计时间klog tags --countklog json输出 JSON 数据klog json --pretty下面逐一拆解每个命令的用法和技巧。1.klog start一键开始计时 ⏱️klog start会在今天的记录里追加一条开放式条目结束时间记为?默认使用当前时刻作为开始时间。# 最简单的用法直接开始计时 klog start # 给任务加个说明 klog start --summary 写季度报告 # 指定开始时间并四舍五入到最近的 15 分钟 klog start --time 09:07 --round 15 小技巧--resume参数会自动沿用上一条条目的说明文字重复性的工作流非常省事。实现细节可参考源码 klog/app/cli/start.go。2.klog stop结束计时并结算 有开始就有结束。klog stop会把记录里那条?开放式条目的结束时间替换为当前时刻klog stop如果今天没有开放式条目它会自动回退到昨天尝试关闭跨午夜加班的场景很贴心也可以用--time手动指定结束时刻或用--round取整用--summary 补充说明可以在结束的同时往条目说明里追加文字。3.klog today今日工时速览 这是 klog 的签到命令一眼看清今天的进度klog today klog today --diff # 对比应有工时与实际工时 klog today --diff --now # 额外预测目标达成时间 klog today --follow # 保持终端开启每秒实时刷新如果今天还没有记录它会自动回退显示昨天--follow模式特别适合用来盯着工时达标时刻。相关实现见 klog/app/cli/today.go。4.klog total统计总时长 想知道这周一共干了多久用klog totalklog total # 总时长 klog total --diff # 同时输出应有工时与差值 klog total --filter#work # 只统计 #work 标签 klog total --filter2026-08 #work # 2026年8月的 #work 工时⚠️ 注意默认统计不包含开放式条目?。想把它当成现在结束来算加--now即可。5.klog create新建一条日期记录 如果某天完全没记录可以用klog create直接创建一条空记录klog create --date 2026-08-19 klog create --date 2026-08-19 --should 8h --summary 居家办公日--should可以设置应有工时比如 8h这样后续--diff类统计就能计算差距。新记录会自动插入到文件中按日期排序的正确位置。6.klog edit用编辑器打开数据文件 ✍️klog 的文件格式本身就很适合手写klog edit会用你的编辑器直接打开数据文件klog edit通过环境变量$EDITOR或 klog 配置文件指定你喜欢的编辑器如vim、code改完保存退出后文件就实时生效下次统计立刻反映最新内容。7.klog report按周期生成工时报表 想要日报、周报、月报、季报、年报一键生成klog report正是为此设计klog report # 默认按天聚合 klog report --aggregate week # 按周聚合 klog report --aggregate month # 按月聚合 klog report --aggregate week --chart # 附带条形图直观对比 klog report --aggregate month --fill # 补全空白周期形成连续序列--chart生成的条形图是纯文本渲染在终端里非常直观--fill则把没有数据的空档也补上适合做完整的时间轴。相关逻辑在 klog/app/cli/report.go 与 klog/app/cli/report/ 目录下。8.klog print原样打印记录 klog print会在终端输出数据文件的内容带语法高亮相当于格式化预览klog print klog print --with-totals # 每条记录/条目前缀显示时长 klog print --sort # 按日期排序输出它不会改动文件本身只是帮你以更清晰的方式查看。如果你只需要纯数据可以搭配后面的klog json使用。9.klog tags标签维度统计 ️如果你的记录里用了标签如#work、#meetingklog tags可以按标签统计时间klog tags # 列出所有标签及其总时长 klog tags --count # 显示每个标签命中的条目数 klog tags --values # 显示带值的标签明细如 #projecta标签支持#tagvalue这种带值形式统计时会自动把#projecta归入基础标签#project非常灵活。10.klog json输出 JSON 数据 需要把工时数据喂给脚本、表格或自动化工具klog json输出结构化数据klog json klog json --pretty # 格式化输出便于阅读 klog json --filter#work输出包含records、warnings、errors三个顶层字段文件合法时返回记录数组有语法错误时返回错误详情。这是 klog 面向程序消费的接口实现见 klog/parser/json/serialiser.go。高频参数速记让命令更好用的 5 个通用标志 上面的命令大量复用了同一批通用参数记住它们就掌握了 klog 的半壁江山参数含义示例--date / -d指定目标日期klog stop --date 2026-08-18--time / -t指定时间点klog start --time 08:30--round时间取整分钟klog stop --round 5--filter过滤表达式日期 标签klog total --filter2026-08 #work--diff / --now对比应有工时 / 按当前时刻结算开放式条目klog today --diff --now过滤表达式的完整文档可以用klog info --filtering查看。进阶组合3 个真实工作流示例 把命令组合起来就是完整的工作闭环场景一上午专注写代码klog start --summary 实现登录模块 #work # …… 专心写代码 …… klog stop场景二下班前复盘当天klog today --diff --now klog report --aggregate day --chart场景三月底导出工时明细klog json --filter2026-08 --pretty august.json klog total --filter2026-08 #work结语klog 的哲学是纯文本 命令没有复杂的 GUI、没有数据库、没有云同步依赖只有一份你可以随时打开阅读的.klg文件和一串即敲即用的时间追踪命令。上面这 10 条命令覆盖了从开始计时到生成报表的完整链路先照着速查表用起来再慢慢探索klog --help里的更多细节吧。想深入了解文件格式可以阅读仓库根目录的 Specification.md想跟进版本变化可查看 CHANGELOG.md命令的完整实现都集中在klog/app/cli/目录有兴趣的开发者可以直接阅读源码学习。【免费下载链接】klogCommand-line tool for time tracking in a human-readable, plain-text file format.项目地址: https://gitcode.com/gh_mirrors/klog/klog创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考