适用于 Openclaw 的 TimeBlock

TimeBlock 是一个本地优先的 CLI 工具,通过简单的 bash 命令记录、跟踪和分析有意识的时间块操作。

xueyetianya
v2.0.0
2026年3月18日
0
814
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install timeblock

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 timeblock。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 TimeBlock?

TimeBlock 是一款专为重视意图和数据隐私的人群设计的强大开发者工具。作为 Openclaw Skills 生态系统的一部分,它允许用户使用结构化的时间块方法逐小时管理每日日程。与云端重度替代方案不同,TimeBlock 将所有数据存储在本地的扁平日志文件中,确保您的生产力模式和日程安排完全由您掌控。

该工具通过提供命令行界面来记录运行、分析时间分配和生成每日议程,弥补了手动规划与自动跟踪之间的差距。无论您是希望保护深度工作时段的开发者,还是跟踪团队同步情况的管理者,此技能都能提供优化工作流所需的透明度和历史记录,而无需离开终端。

TimeBlock 应用场景

  • 使用生成的日程安排进行每小时有意识的每日规划。
  • 跟踪对特定专注块的遵循情况,以识别生产力流失点。
  • 分析不同项目类别之间的长期时间分配模式。
  • 批量创建每周议程,以减轻每日的认知规划负担。
  • 将本地生产力数据导出为 CSV 或 JSON,用于自定义仪表板报告。

TimeBlock 工作原理

  1. 用户通过执行特定命令(如 run、generate 或 check)及输入详情来启动时间块操作。
  2. 脚本捕获输入并加上精确的 YYYY-MM-DD HH:MM 时间戳。
  3. 数据被追加到特定命令的日志文件和本地 ~/.local/share/timeblock/ 目录下的全局 history.log 中。
  4. 用户随后可以使用内置的 search、stats 或 report 函数查询这些数据,以可视化时间使用情况。
  5. 结构化数据可以随时导出为标准格式,以便进行外部分析或备份。

TimeBlock 配置指南

TimeBlock 需要 Bash 4.0+ 和标准 Unix 实用程序。无需外部 API 密钥即可将其集成到您的 Openclaw Skills 工作流中。

# 将脚本克隆或下载到您的机器
# 确保脚本具有执行权限
chmod +x scripts/script.sh

# 运行 version 命令以验证安装
./scripts/script.sh version

# 可选:为脚本设置别名以方便访问
alias timeblock='~/path/to/scripts/script.sh'

TimeBlock 数据架构与分类体系

TimeBlock 使用位于 ~/.local/share/timeblock/ 的扁平文件、管道分隔架构。每个条目遵循格式:Timestamp|Input。

文件 描述
<command>.log 特定操作(run, check, analyze 等)的分类日志
history.log 按时间顺序排列的所有操作的主记录
export.<fmt> 在 JSON, CSV 或 TXT 导出期间生成的临时文件

TimeBlock 高级特性

  • 多类别日志记录:针对 12 种以上不同生产力操作进行分类跟踪。
  • 模式分析:使用 analyze 和 compare 命令审计计划与实际的时间使用情况。
  • 全局搜索:在整个本地数据库中进行不区分大小写的关键词搜索。
  • 磁盘管理:内置 stats 命令监控数据增长和条目数量。
  • 本地优先架构:零网络调用,确保最大隐私和速度。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*