什么是Builder
Builder 是一款专为游戏爱好者设计的轻量级命令行工具，旨在帮助用户高效记录、追踪和管理各类游戏相关活动。它通过简洁的命令行接口，让用户能够快速记录骰子点数、得分、排名、挑战进度、奖励发放等关键信息，并将所有数据以时间戳形式本地存储，确保操作的完整可追溯性。无论是进行桌游对战、视频游戏竞技，还是组织线上比赛，Builder 都能提供一套完整的日志解决方案，无需依赖外部服务或数据库。 该工具的核心优势在于其极简的设计理念：所有数据均保存在用户本地目录 `~/.local/share/builder/` 中，每个命令对应独立的 `.log` 文件（如 `roll.log`、`score.log`），同时维护一个统一的 `history.log` 来汇总所有操作记录。这种结构不仅保证了数据的隔离性与可读性，也极大地方便了后续的查询与分析。此外，Builder 完全基于标准 POSIX 工具链构建，不引入任何外部依赖，兼容 Linux、macOS 和 Windows 下的 WSL 环境，部署门槛极低。 除了基础的日志功能，Builder 还支持多种实用操作，例如导出全部数据为 JSON、CSV 或纯文本格式，便于与其他系统对接；提供全局搜索能力，可跨所有日志条目查找特定内容；还能查看最近 20 条历史记录或系统状态报告，包括版本信息、总条目数和磁盘使用情况。这些特性使得 Builder 不仅是一个简单的记录工具，更成为一个灵活的游戏数据管理中枢。
核心功能特点
- 支持 15 种核心命令，涵盖骰子投掷、得分、排名、挑战、奖励等游戏关键环节的记录与查询
- 所有操作自动添加时间戳并写入独立日志文件，实现全链路可追溯的历史审计
- 提供 `search` 全局检索和 `recent` 快速回顾功能，方便定位特定游戏事件
- 支持将全部数据导出为 JSON、CSV 或 TXT 格式，满足数据分析与备份需求
- 无网络依赖、无外部服务，纯本地运行，保障隐私与安全
- 集成 `stats` 和 `status` 命令，实时掌握数据规模与系统健康状态
适用场景
Builder 特别适合需要长期跟踪游戏表现的玩家或组织者。例如，在玩《龙与地下城》这类依赖骰子判定的桌游时，玩家可使用 `builder roll` 命令精确记录每次投掷结果及触发效果（如暴击），结合 `score` 和 `rank` 命令统计回合积分与最终排名，形成完整对战档案。对于频繁参与竞技类视频游戏的用户，则可通过 `challenge` 命令设定目标（如‘速通关卡5’），用 `track` 监控进度，并通过 `leaderboard` 动态更新胜负榜，营造紧张的比赛氛围。 当举办小型锦标赛或朋友聚会活动时，Builder 能显著提升组织效率。主持人可用 `join` 记录每位参与者加入情况，`reward` 标记成就解锁（如连胜奖励），并在赛后一键导出数据生成可视化报表。而 `reset` 命令则适用于重置计分周期，便于开启新一轮竞赛。由于所有数据集中存储且支持全文检索，事后复盘也变得异常轻松——只需输入关键词即可快速找到某次关键对决或失误节点。 对于希望量化自身游戏习惯的研究型玩家，Builder 同样具备价值。通过定期导出日志并结合外部工具分析胜率趋势、挑战完成率或奖励获取频率，可以深入理解自己的策略偏好与成长轨迹。无论是个人娱乐还是团队协作，Builder 都以零配置成本提供了专业级的游戏活动管理方案。