Design Pattern
此技能使用 Pipeline（流水线）模式 来执行多步骤工作区管理，并通过 Tool Wrapper（工具包装器）模式 安全地封装文件系统操作。优先调用配套脚本，避免在 Prompt 中内联复杂 bash 命令，以控制 Token 成本并提升执行稳定性。
Workspace Manager
此技能旨在保持工作区的整洁和高效，将人类文件与 Agent 文件分离，并提供一站式维护能力。
标准目录结构 (Standard Structure)
~/.openclaw/workspace/
├── Workspace_Human/ # ❶ 供人类使用的文件（输入、输出、备份）
│ ├── input/ # 用户提供或导入的原始文件
│ ├── output/ # 生成的产物（图片、PDF、文档）
│ │ ├── images/ # 图片文件
│ │ ├── docs/ # 文档文件 (PDF, DOCX)
│ │ └── data/ # 结构化数据 (JSON, CSV)
│ ├── backup/ # 备份文件（手动 + 自动）
│ └── temp/ # 临时文件（CDP 截图、缓存等，可安全清理）
│
├── Workspace_Agent/ # ❷ 供 Agent 之间交互的文件
│ ├── memory/ # 每日日志 (YYYY-MM-DD.md) + 长期记忆
│ ├── skills/ # 已安装的技能目录
│ ├── subagents/ # 永久子 agent 配置
│ ├── shared_context/ # 多 agent 共享上下文
│ ├── artifacts/ # 中间产物（构建产物、待整理文件）
│ ├── cache/ # 可复用的缓存数据
│ ├── logs/ # 操作日志
│ ├── skills_custom/ # 自定义编写的技能
│ ├── prompts/ # 常用提示词模板
│ └── kb/ # Agent 知识库
│
├── archive/ # 归档目录（按 YYYY-MM/ 组织）
├── scripts/ # 本地脚本（workspace-manager 专用）
└── secret/ # 敏感凭据
核心文件保护（永不删除）
以下文件无论任何情况都受到保护：
MEMORY.md, SOUL.md, USER.md, AGENTS.md, HEARTBEAT.md.git/, memory/, skills/, subagents/, Workspace_Human/
Pipeline 工作流
所有步骤均通过配套脚本执行。推荐使用一键全量 Pipeline，复杂场景可单独触发某一阶段。
推荐：一键全量 Pipeline
# 执行完整 5 步流水线（Audit → Organize → Clean → Archive → Sync）
bash {{SKILL_DIR}}/scripts/pipeline.sh --all
# 仅预览（不实际执行任何写入操作）
bash {{SKILL_DIR}}/scripts/pipeline.sh --all --dry-run
# 执行指定步骤
bash {{SKILL_DIR}}/scripts/pipeline.sh audit organize
Step 1 — 健康审计 (Audit)
bash {{SKILL_DIR}}/scripts/health-check.sh
自动检查：断链、空目录、大文件(>10MB)、畸形命名、磁盘占用、最近活动。
输出 0-100 健康评分及分级建议。
Step 2 — 规范化 (Standardize)
bash {{SKILL_DIR}}/scripts/standardize.sh
确保标准目录结构完整，检测根目录散落文件并给出整理建议。
Step 3 — 自动整理 (Organize)
bash {{SKILL_DIR}}/scripts/organize.sh
将 Workspace_Agent/artifacts/ 中的散落文件按类型移动到 Workspace_Human/output/ 对应子目录：
| 文件类型 | 目标位置 |
|---|
*.png, *.jpg, *.webp, *.gif | Workspace_Human/output/images/ |
*.pdf, *.docx, *.doc | Workspace_Human/output/docs/ |
*.json, *.csv, *.xml | Workspace_Human/output/data/ |
*screenshot*, cdp_tmp_*, *.tmp | Workspace_Human/temp/ |
Step 4 — 安全清理 (Clean)
# 预览（默认，永远先预览）
python3 {{SKILL_DIR}}/scripts/cleanup.py
# 执行清理（移动到系统 trash，可恢复）
python3 {{SKILL_DIR}}/scripts/cleanup.py --execute
# 按条件清理
python3 {{SKILL_DIR}}/scripts/cleanup.py --min-age 30 --execute # 30天以上
python3 {{SKILL_DIR}}/scripts/cleanup.py --min-size 50 # >50MB
保护规则：永不删除 .git/、memory/、skills/、Workspace_Human/、最近 24h 文件及所有核心配置文件。
Step 5 — 归档 (Archive)
# 交互式归档（7天以上文件，按月组织）
bash {{SKILL_DIR}}/scripts/archive.sh
# 自定义天数
DAYS=30 bash {{SKILL_DIR}}/scripts/archive.sh
归档结构：archive/YYYY-MM/。仅处理 Workspace_Agent/artifacts/。
Step 5 — 云端同步 (Sync) ⭐ 可选扩展
bash {{SKILL_DIR}}/scripts/sync.sh
此步骤为可选扩展，需要 gog CLI 已安装并认证。未安装或未认证时自动跳过，不阻断其他 Pipeline 步骤。
同步范围（可通过 config/sync-config.json 配置开关）：
- ✅
Workspace_Human/ 全部内容 → Google Drive AI_Workspace/Workspace_Human/
- ✅
Workspace_Agent/ 全部内容 → Google Drive AI_Workspace/Workspace_Agent/（默认关闭）
- ✅ 核心配置文件（MEMORY.md 等） → Google Drive
AI_Workspace_Backup/
启用同步：安装 gog CLI 并运行 gog auth login 即可自动启用。
关闭同步：删除 gog 或不运行 gog auth login，Pipeline 自动跳过此步骤。
常用命令速查
| 任务 | 命令 |
|---|
| 一键全量 | bash {{SKILL_DIR}}/scripts/pipeline.sh --all |
| 健康审计 | bash {{SKILL_DIR}}/scripts/health-check.sh |
| 规范化 | bash {{SKILL_DIR}}/scripts/standardize.sh |
| 整理文件 | bash {{SKILL_DIR}}/scripts/organize.sh |
| 预览清理 | python3 {{SKILL_DIR}}/scripts/cleanup.py |
| 执行清理 | python3 {{SKILL_DIR}}/scripts/cleanup.py --execute |
| 归档旧文件 | bash {{SKILL_DIR}}/scripts/archive.sh |
| 云端同步 | bash {{SKILL_DIR}}/scripts/sync.sh ⭐可选 |
目录命名规则
- 所有目录名：kebab-case，无空格，无特殊字符
- 示例：
Workspace_Human, Workspace_Agent, shared_context, skills_custom
- 文件扩展名：全部小写
最佳实践
- 每次会话结束前：
bash {{SKILL_DIR}}/scripts/pipeline.sh audit organize
- 每周定期维护：
bash {{SKILL_DIR}}/scripts/pipeline.sh --all（完整流水线）
- 永远先预览再执行：特别是
cleanup.py（默认就是预览模式）
- 永远用
trash 代替 rm：所有脚本均使用 trash-put，误删可从系统回收站恢复
- 引导用户将临时文件生成在
Workspace_Agent/artifacts/，会话结束后由 Pipeline 自动整理
