前言¶
在 WorkBuddy 里删掉一段对话，列表里往往立刻干净，但本机不一定同步减负。对话关联的工作区文件夹和本地数据仍可能留在磁盘上，时间一长会悄悄占空间，又不容易从 UI 里一眼看出该删哪一块。
手动翻目录既费事，也容易误删还在用的工作区。下面介绍 SkillHub 社区技能「已删对话残留清理」（@user_3f399cbf/cleanup-stale-workspaces），用可恢复的回收流程，把「已删对话」对应的废弃残留找出来并移出主目录，需要时再永久清空。
这是什么¶
「已删对话残留清理」是面向 WorkBuddy 使用场景的 Agent Skill，坐标 @user_3f399cbf/cleanup-stale-workspaces，当前版本 2.3.2，来源为 community，分类 it-ops-security，由发布者 user_3f399cbf 维护。SkillHub 标注 requires_api_key=false，安装与使用不依赖额外 API Key。
它解决的核心问题：对话在 WorkBuddy 侧已删除，但本地仍残留的文件夹与数据占用磁盘；技能自动识别这些废弃残留并安全清理，而不是让用户在文件系统里盲删。
核心功能¶
依据 SkillHub 官方简介，已核实的能力包括：
- 识别废弃残留：找出删除对话后仍留在磁盘上的残留（官方表述为废弃的工作区相关文件夹与本地数据），用于释放空间。
- 可恢复回收：清理项先移入回收目录，不直接永久删除；确认无误后，通过
--empty-trash才永久清空。 - 多重保护：
- 正在使用的活跃工作区不处理；
- 纯手动资料夹不处理；
- 实际执行需--yes确认，避免误操作。 - 自然语言触发：对 AI 说「帮我清理废弃文件夹」即可按技能流程处理。
安装与启用¶
技能页给出的安装方式，是让 Agent 按 SkillHub 通用安装文档操作，并安装指定坐标：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_3f399cbf/cleanup-stale-workspaces`。
按 SkillHub 安装与优先源配置，典型步骤如下。
- 检查或安装 SkillHub CLI（未安装时）：
command -v skillhub && skillhub --version
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
- 安装到当前 Agent 的 skills 目录。文档强调必须使用
--dir指向本机 Agent 识别的 skills 路径，否则默认装到./skills/可能不会被加载：
skillhub install @user_3f399cbf/cleanup-stale-workspaces --dir <skills 目录>
与 WorkBuddy 相关的常用路径（摘自官方安装文档）：
workbuddy: ~/.workbuddy/skills/
若你在 Cursor 等其它客户端里使用该技能，同一文档还列出例如 ~/.cursor/skills/ 等路径；请按你当前环境选择对应的 skills 目录，安装后按客户端要求重启或刷新技能列表。
典型用法¶
- 完成安装并确保 Agent 已加载该 Skill（基于通用
SKILL.md格式）。 - 在对话中对 AI 说：「帮我清理废弃文件夹」，由技能引导扫描与清理流程。
- 首次真正移入回收目录前，按技能要求带上
--yes做确认。 - 在回收目录中核对无误后，需要彻底释放空间时，再使用
--empty-trash永久清空回收内容。
具体子命令或脚本名称以技能包内 SKILL.md 为准；上文 --yes 与 --empty-trash 来自 SkillHub 页面简介中的官方说明。
适用场景与注意¶
适合谁：长期在 WorkBuddy 中创建、删除大量对话，本机磁盘占用持续上升，又希望避免手删误伤活跃工作区或手动资料夹的用户。
使用注意：
- 清理前依赖「移入回收目录」机制，建议先核对回收内容，再执行
--empty-trash。 - 活跃工作区与纯手动资料夹受保护，但仍应在重要数据上做好常规备份习惯。
- SkillHub 页面显示该技能评分 100000、下载 1346 次（统计以 SkillHub 为准）；功能边界以 v2.3.2 简介为准，未在官方文案中出现的细节不要自行假设。
结尾¶
「已删对话残留清理」把 WorkBuddy 删对话与删本地残留之间的缺口补上：先安全回收、再可选永久清空，并用 --yes 与活跃区/手动夹保护降低误删风险。需要安装或查看更新时，可打开 SkillHub 技能页：
https://www.skillhub.cn/skills/user_3f399cbf/cleanup-stale-workspaces
API 入口：https://api.skillhub.cn/user_3f399cbf/cleanup-stale-workspaces
