核心用法
Social Automator 是一款基于 Bash 的通用 CLI 日志工具，专为需要快速记录时间戳数据的场景设计。用户通过 run、check、analyze 等 12 个语义化命令将输入追加至对应日志文件（~/.local/share/social-automator/*.log），格式为 YYYY-MM-DD HH:MM|<value>。无参数调用时则显示该类型的最近 20 条记录。所有操作同步写入 history.log 形成统一时间线，支持 recent、search、stats、export 等管理命令进行回顾、检索、统计与导出（JSON/CSV/TXT）。
显著优点
1. 零依赖部署：仅需 Bash 4.0+ 与 coreutils，无需数据库、API 密钥或网络。
2. 语义化命令设计：run、batch、compare 等动词贴合自动化工作流，降低认知成本。
3. 灵活导出与检索：内置 export 与 search 支持跨日志全文检索及结构化数据输出，便于对接下游分析。
4. 资源占用极低：纯文本存储，磁盘占用可预测（stats 实时可见），适合边缘设备与 CI 环境。
潜在缺点与局限性
- 无并发控制：多进程同时写入同一日志文件可能导致内容交错或截断，缺乏文件锁机制。
- 数据完整性风险：
set -euo pipefail虽严格，但磁盘满、权限变更等场景下未显式处理写入失败回滚。 - 功能重叠陷阱：
export与status在 case 语句中出现两次，实际行为取决于匹配顺序，易造成用户困惑。 - 无长期归档策略：日志无限累积，需外部定时任务（如 logrotate）防止磁盘膨胀。
- 格式硬编码：时间戳与分隔符（
|）不可配置，难以适配已有数据规范。
适合人群
- 需要快速原型化、不愿维护数据库的自动化工程师
- 在服务器/容器中追踪批处理作业与运维操作的 DevOps/SRE
- 个人开发者记录日常脚本执行与指标变化
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据丢失 | 直接操作文本文件，误删或磁盘故障无恢复机制 |
| 隐私泄露 | 日志明文存储于用户主目录，多用户系统需检查权限 |
| 注入痕迹 | 输入未经转义直接写入，若来源不可控可能污染日志 |
版本说明
当前文档对应 v2.0.0，由 BytesAgain 维护。