Labor Law

一款多功能命令行数据条目管理工具。支持运行任务、管理配置、跟踪条目、搜索记录以及导出数据——并提供完整的活动日志与操作历史。

命令

数据存储

所有数据均以纯文本格式存储于 $DATA_DIR/data.log，每条记录均以日期为前缀。活动历史记录保存在 $DATA_DIR/history.log 中，并附带时间戳。默认数据目录为 ~/.local/share/labor-law/。可通过设置环境变量 LABOR_LAW_DIR 覆盖该路径；若未设置，则遵循 XDG_DATA_HOME（如已定义）。

系统要求

• Bash 4+ 及标准 Unix 工具（date、grep、cat）
• 无需外部依赖或 API 密钥
• 可在任意 Linux/macOS 终端中运行

适用场景

1. 快速数据追踪 — 使用 labor-law add 添加带自动时间戳的条目，再通过 labor-law list 查看所有已记录内容。
2. 检索历史条目 — 运行 labor-law search ，在数据日志中进行不区分大小写的关键词匹配搜索。
3. 初始化新工作区 — 使用 labor-law init 创建数据目录，随后执行 labor-law config 确认配置路径是否正确。
4. 检查系统就绪状态 — 运行 labor-law status 快速确认本工具是否已就绪并可正常运行。
5. 导出数据供外部使用 — 使用 labor-law export 将全部日志数据输出至标准输出，可重定向至文件或通过管道传递给其他工具处理。

示例

# 初始化数据目录
labor-law init

# 向数据日志中添加条目
labor-law add "Review employment contract for new hire"
labor-law add "Check overtime policy compliance"
labor-law add "Prepare severance calculation"

# 列出所有条目
labor-law list

# 搜索特定条目
labor-law search "overtime"

# 检查状态
labor-law status

# 查看配置路径
labor-law config

# 显示版本号和数据目录
labor-law info

# 导出全部数据
labor-law export > backup.txt

# 运行一项任务
labor-law run "quarterly review"

# 移除某一条目
labor-law remove "old item"

工作原理

Labor Law 将所有条目本地存储于 ~/.local/share/labor-law/data.log。每次执行 add 命令时，都会在条目前自动添加当前日期。所有命令调用均被记录至 history.log，并附带时间戳，确保完整可审计。所有数据均保留在本地机器上，以纯文本文件形式存储，不会上传至任何外部服务。

配置

设置 LABOR_LAW_DIR 环境变量可更改数据目录：

export LABOR_LAW_DIR=/custom/path

默认值：~/.local/share/labor-law/

由 BytesAgain 提供支持 | bytesagain.com | hello@bytesagain.com