WorkBuddy 文件系统管家

要解决的问题

工作区长期运行后，目录会逐渐堆积，手工归档既费时又容易漏掉临时文件；数据库与工作区的状态容易不一致，排查问题时找不到根源；会话 jsonl 文件里会积攒幽灵任务记录，占用空间还干扰调试；过期会话如果没人处理，不仅浪费存储资源，还可能让旧数据暴露在风险中。这些细节平时不明显，但会慢慢拖慢开发节奏。

核心能力与工作方式

该技能围绕文件系统管理的几个关键环节展开：

• 目录归档：按规则整理工作区目录，把临时或历史文件归置到位，保持当前操作区干净。
• 数据库同步：将工作区数据与数据库状态对齐，减少因两边不一致导致的排查成本。
• 幽灵任务清理：扫描会话 jsonl 文件，识别并移除无效或残留的任务记录，保留有效会话。
• 过期会话归档：按自定义天数（默认15天）判断会话是否过期，将旧会话归档，避免占用实时资源。
• 自动化配置生成：一键生成三种模式的配置——周期执行、按间隔执行、单次执行，适配不同任务节奏。

操作时先梳理当前工作区结构，再根据需求选择清理或归档任务，最后生成对应的自动化配置即可。

适用边界与注意点

• 自定义天数要结合工作节奏调整，太短可能误删活跃会话，太长则清理不及时。
• 数据库同步前需确认数据源状态，避免同步过程中断导致数据不一致。
• 自动化配置需提前验证路径和规则，确保任务按预期触发和执行。
• 清理 jsonl 文件前建议备份关键会话，防止误删重要记录。