Bookmark Keeper: CLI 资源与效率管理 - Openclaw 技巧

时间:2026-07-24 11:12:01 来源:互联网

什么是 Bookmark Keeper?

Bookmark Keeper 是一个强大且注重隐私的生产力工具包,专为在终端中工作的开发者设计。作为 Openclaw Skills 生态系统的一部分,它提供了一套完整的命令来保存网页链接、记录目标,并维护专业活动的时间戳历史记录。与基于云的书签工具不同,此技能确保您的数据完全由您控制,以纯文本日志的形式存储在本地。

通过将此技能集成到您的工作流中,您可以获得一个统一的界面来管理资源的整个生命周期——从最初的发现和标记到优先级排序、追踪以及最终归档。它弥补了简单书签管理器与全规模个人知识管理(PKM)系统之间的差距,为连续天数、里程碑和报告提供了特定的工作流。

下载入口:https://github.com/openclaw/skills/tree/main/skills/ckchzh/bookmark-keeper

安装与下载

1. ClawHub CLI

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

npx clawhub@latest install bookmark-keeper

2. 手动安装

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

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

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

3. 提示词安装

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

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

Bookmark Keeper 应用场景

  • 研究链接收集:在深入研究期间保存带有上下文注释的 URL,并使用标签分类以便即时检索。
  • 目标追踪与一致性:使用 streak 和 plan 功能来保持日常习惯,并监控技术目标的长期进度。
  • 每周生产力审计:进行结构化的每周复盘,总结成就并规划接下来的冲刺。
  • 阅读清单整理:通过优先处理高价值文章并在完成学习后将其归档来管理技术待办事项。
  • 项目里程碑记录:记录关键时间线事件,并为利益相关者或个人档案生成进度报告。
Bookmark Keeper 工作原理
  1. 输入捕获:使用 add、plan 或 track 等特定命令后跟您的文本,以自动带有时间戳的方式记录信息。
  2. 本地持久化:该技能使用标准化的 YYYY-MM-DD HH:MM 管道分隔格式将数据写入本地共享目录中的专用 .log 文件。
  3. 搜索与检索:使用 search 命令查询您的整个历史记录,或通过运行不带参数的命令查看特定日志。
  4. 综合与报告:生成摘要和统计数据,以评估生产力水平和各类别的数据分布。
  5. 数据可移植性:使用 export 功能将您的本地日志转换为 JSON 或 CSV 格式,以便进行外部分析或备份。

Bookmark Keeper 配置指南

要开始使用 Openclaw Skills 家族的这一成员,请确保您已安装 Bash 4.0+。无需 API 密钥或外部依赖项。

# 进入您的本地 bin 或首选目录
# 克隆或下载 bookmark-keeper 脚本
chmod +x bookmark-keeper

# 初始化并检查状态
bookmark-keeper status

Bookmark Keeper 数据架构与分类体系

Bookmark Keeper 在位于 ~/.local/share/bookmark-keeper/ 的几个专用纯文本日志中组织信息。所有条目都遵循统一格式:YYYY-MM-DD HH:MM|entry_content

日志文件 用途
add.log 书签和新项目的主要存储
plan.log 战略目标和未来目标
track.log 活动任务的增量进度更新
review.log 评估和关键评价
tag.log 元数据和分类映射
history.log 在技能中采取的每项操作的统一流
version: "2.0.0"
name: bookmark-keeper
description: "Save, organize, and search web bookmarks with tags and categories. Use when collecting research links, organizing lists, or reviewing resources."
author: BytesAgain
homepage: https://bytesagain.com
source: https://github.com/bytesagain/ai-skills

Bookmark Keeper

A productivity toolkit for managing bookmarks, plans, tasks, and reviews — all from the command line with timestamped local logging, tagging, archiving, and weekly review workflows.

Commands

Command Description
bookmark-keeper add <input> Add a new bookmark or item. Without args, shows recent add entries
bookmark-keeper plan <input> Record a plan or goal. Without args, shows recent plans
bookmark-keeper track <input> Track progress on an item. Without args, shows recent tracking entries
bookmark-keeper review <input> Log a review or assessment. Without args, shows recent reviews
bookmark-keeper streak <input> Record a streak or consistency milestone. Without args, shows recent streaks
bookmark-keeper remind <input> Set a reminder note. Without args, shows recent reminders
bookmark-keeper prioritize <input> Record a prioritization decision. Without args, shows recent priorities
bookmark-keeper archive <input> Archive a completed or inactive item. Without args, shows recent archives
bookmark-keeper tag <input> Add tags or categorize an item. Without args, shows recent tag entries
bookmark-keeper timeline <input> Record a timeline entry or milestone. Without args, shows recent timeline entries
bookmark-keeper report <input> Generate and log a report. Without args, shows recent reports
bookmark-keeper weekly-review <input> Record a weekly review summary. Without args, shows recent weekly reviews
bookmark-keeper stats Show summary statistics across all entry types
bookmark-keeper search <term> Search across all log entries for a keyword
bookmark-keeper recent Show the 20 most recent activity entries
bookmark-keeper status Health check — version, data dir, entry count, disk usage, last activity
bookmark-keeper export <fmt> Export all data in json, csv, or txt format
bookmark-keeper help Show all available commands
bookmark-keeper version Print version (v2.0.0)

Each command (add, plan, track, etc.) works the same way:

  • With arguments: saves the entry with a timestamp to its dedicated .log file and records it in activity history
  • Without arguments: displays the 20 most recent entries from that command's log

Data Storage

All data is stored locally in plain-text log files:

~/.local/share/bookmark-keeper/
├── add.log             # Added bookmarks and items
├── plan.log            # Plans and goals
├── track.log           # Progress tracking entries
├── review.log          # Reviews and assessments
├── streak.log          # Streak / consistency records
├── remind.log          # Reminder notes
├── prioritize.log      # Prioritization decisions
├── archive.log         # Archived items
├── tag.log             # Tag and categorization entries
├── timeline.log        # Timeline milestones
├── report.log          # Generated reports
├── weekly-review.log   # Weekly review summaries
└── history.log         # Unified activity log with timestamps

Each entry is stored as YYYY-MM-DD HH:MM|<value> for easy parsing and export.

Requirements

  • Bash 4.0+ (uses set -euo pipefail)
  • Standard UNIX utilities: date, wc, du, grep, head, tail, cat
  • No external dependencies or API keys required
  • Works offline — all data stays on your machine

When to Use

  1. Research link collection — Use add to save URLs with notes as you research a topic, then tag to categorize them and search to find them later
  2. Weekly productivity reviews — Run weekly-review every Sunday to summarize what you accomplished, what's pending, and what to focus on next week
  3. Goal tracking with streaks — Set goals with plan, track daily progress with track, and celebrate consistency milestones with streak
  4. Reading list management — Add articles and resources with add, prioritize what to read next, and archive items once consumed
  5. Project milestone tracking — Use timeline to record key milestones, report to generate progress summaries, and remind to set follow-up notes

Examples

Build a bookmark collection

# Add bookmarks with notes
bookmark-keeper add "https://example.com/rust-guide — comprehensive Rust tutorial"
bookmark-keeper add "https://arxiv.org/abs/2401.12345 — attention mechanisms survey paper"

# Tag them for organization
bookmark-keeper tag "rust-guide: #programming #rust #tutorial"
bookmark-keeper tag "attention-paper: #ml #research #papers"

# Search later
bookmark-keeper search "rust"

# Prioritize what to read first
bookmark-keeper prioritize "rust-guide — high priority, needed for current project"

Weekly review workflow

# Track daily progress
bookmark-keeper track "completed 3 chapters of Rust book, built first CLI tool"
bookmark-keeper track "reviewed 5 research papers, summarized key findings"

# Record streaks
bookmark-keeper streak "day 14 of daily coding practice"

# Do your weekly review
bookmark-keeper weekly-review "Week 12: finished Rust basics, started async chapter. Read 5 papers. Next week: build REST API in Rust."

# Generate a report
bookmark-keeper report "March progress: 20 bookmarks added, 12 reviewed, 8 archived"

Plan, remind, and archive

# Set a plan
bookmark-keeper plan "Q2 reading goal: 15 technical articles, 3 books"

# Set reminders
bookmark-keeper remind "follow up on ML paper discussion — Friday"

# Record a timeline milestone
bookmark-keeper timeline "2024-04-01: started Rust learning path"

# Archive completed items
bookmark-keeper archive "rust-guide — completed, notes saved to wiki"

# View stats and recent activity
bookmark-keeper stats
bookmark-keeper recent

Export and status

# Export everything as JSON
bookmark-keeper export json

# Export as CSV for spreadsheet analysis
bookmark-keeper export csv

# Health check
bookmark-keeper status

Output

All commands print confirmation to stdout. Data is persisted in ~/.local/share/bookmark-keeper/. Use bookmark-keeper stats for an overview, bookmark-keeper search <term> to find specific entries, or bookmark-keeper export <fmt> to extract all data as JSON, CSV, or plain text.


Powered by BytesAgain | bytesagain.com | hello@bytesagain.com