mcpField
D
deepwork-tracker

deepwork-tracker

github.com/adunne09生产力037 次安装40 周前更新
代码仓库

关于 deepwork-tracker

deepwork-tracker 是用于管理专注工作时段的本地技能，操作 SQLite 支持的应用并生成活动报告。它还可尝试启动 macOS Clock 计时器。

主要功能

  1. 01开始和停止专注时段
  2. 02查看当前状态
  3. 03生成文本或 Telegram 报告
  4. 04生成周度热图
  5. 05启动 macOS Clock 计时器

适用场景

  1. 01开始设定时长的专注工作
  2. 02检查当前专注时段状态
  3. 03查看最近数日的专注报告

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/adunne09/deepwork-tracker --skill deepwork-tracker

安装后在 Claude Code 中输入/deepwork-tracker确认已加载。

详细介绍

深度工作跟踪器

使用本地深度工作应用（基于 SQLite），路径为 ~/clawd/deepwork/deepwork.js。

初始化（如果脚本缺失）

如果 ~/clawd/deepwork/deepwork.js 不存在，请从公开仓库初始化：

mkdir -p ~/clawd
cd ~/clawd

# Clone if missing
[ -d ~/clawd/deepwork-tracker/.git ] || git clone https://github.com/adunne09/deepwork-tracker.git ~/clawd/deepwork-tracker

# Ensure expected runtime path exists
mkdir -p ~/clawd/deepwork
cp -f ~/clawd/deepwork-tracker/app/deepwork.js ~/clawd/deepwork/deepwork.js
chmod +x ~/clawd/deepwork/deepwork.js

（如果克隆或复制失败，不要因此放弃用户请求——仍要尝试其他步骤，并报告缺失内容。）

命令

通过 exec 运行：

  • 开始一个会话（同时启动 macOS 时钟计时器；默认目标为 60m）：
    • ~/clawd/deepwork/deepwork.js start --target-min 60
  • 停止一个会话：
    • ~/clawd/deepwork/deepwork.js stop
  • 检查状态：
    • ~/clawd/deepwork/deepwork.js status
  • 生成报告：
    • 最近 7 天（默认）：~/clawd/deepwork/deepwork.js report --days 7 --format text
    • 最近 7 天的 Telegram 格式：~/clawd/deepwork/deepwork.js report --days 7 --format telegram
    • 热力图（可选）：~/clawd/deepwork/deepwork.js report --mode heatmap --weeks 52 --format telegram

聊天工作流

开始深度工作
  1. 运行 ~/clawd/deepwork/deepwork.js start --target-min 60（如果用户指定其他目标时长，则使用该时长）。
  2. 这也应启动一个计时器，在 macOS 时钟中计时目标时长（尽力而为；可能需要辅助功能权限）。
  3. 回复确认信息。
停止深度工作
  1. 运行 ~/clawd/deepwork/deepwork.js stop。
  2. 回复持续时长。
显示深度工作图表
  1. 运行 ~/clawd/deepwork/deepwork.js report --days 7 --format telegram。
  2. 始终使用 message 工具，通过 Markdown 等宽字体代码块将输出发送给 Alex 的 Telegram（id 8551040296）。
  3. 可以选择在当前聊天中确认已发送。

如果用户需要不同的时间范围，请支持 --days 7|14|30|60。 （仅在用户明确要求时，才可通过 --mode heatmap --weeks ... 使用热力图。）

评论

支持 Markdown