xiaowei-system/skills/devops/file-resource-management/SKILL.md

name	version	description
file-resource-management	1.1.0	文件资源管理机制 — 脚本/图片/视频/文档分类存放，避免根目录散落。触发词"文件乱/资源管理/整理文件/归类"。

文件资源管理机制（2026-09-05 牧尘要求）

核心原则（科学分类，遵循已有约定，不重复造轮子）

文件类型	统一去处	理由
脚本	~/.hermes/scripts/（140+ 统一库）	已有脚本库，不新建
知识/文档/研究	~/mc/小唯/06-Raw/<年>/ 按类分 reports/logs/images/videos	进 Obsidian 可检索、进织忆图谱
AI 生图/素材	~/mc/小唯/06-工具与资源/media/	跟随知识库备份体系
下载	~/Downloads（系统标准）	不迁移
根目录(~)	只允许 dotfile + 目录	散落文件 = 异常

自动化机制

1. resource-watchdog.py（cron c336c1c3b39f 每日5:00）

• 扫描 ~ 根目录非 dotfile 文件
• 按扩展名分类：.md/.json/.txt→reports；.png/.jpg→images；.mp4→videos；.zip→archives
• 自动归档到 ~/mc/小唯/06-Raw/<year>/<kind>/
• watchdog 语义：干净静默，有散落才报警
• 手动跑：python3 ~/.hermes/scripts/resource-watchdog.py [--dry-run|--apply]

2. backup-cleanup.py（cron 6a87615b5155 每日4:00）

• 自动轮转过期备份：state.db.*留3 / 快照留8 / bundle留2 / broken直删 / bak留2
• 磁盘>85% 额外触发清理

铁律

1. 任何新备份机制必须先问"它怎么被自动清掉"（保留上限）
2. 根目录不产生散落文件——产出物直接写入目标目录
3. 安装前查重目录，模型用软链不复制
4. 恢复/修复流程结尾必须含"验证新库健康→删旧残留"步骤

Obsidian 笔记库整理（2026-09-10 实战，10000→4557 文件 / 1.1GB→376MB）

结构分离原则

内容	去处	理由
笔记	~/mc/（Obsidian 各人分区）	可检索、进织忆图谱
项目	~/projects/<name>/	独立 git/构建，不污染 vault
凭证	~/mc/牧尘/claw/key.md	单一事实来源；已 gitignore 不入库
备份	~/.hermes/backups/	运行时产物

五步流程

1. 编码变体合并 — 同一逻辑目录可能出现多编码形式（织忆同步/ZhiyiSync/zhiyi-sync/zhi-yi-tong-bu/%E7%BB%87.../\u7ec7.../双重编码/乱码汉字）。归一化（urllib.unquote + unicode_escape + latin1→utf8）后合并，内容 md5 去重
2. 项目移出 — 按特征文件识别（Dockerfile/Makefile/go.mod/Cargo.toml/package.json/pyproject.toml）
3. 凭证集中 — 全库正则扫描（sk-/nvapi-/tskey-/gh[pousr]_/cli_/AIza/ms-）→ 提取到 key.md（结构化：AI模型/服务器/代码托管/消息平台/账号）→ 原处替换为 [🔐 已迁移至 牧尘/claw/key.md]
4. 散落归位 + 空目录清理
5. 固化防护 — mc-structure-check.py（5 类检测）+ cron 每周一 9:00（watchdog 语义：干净静默）

⚠️ 陷阱（血泪）

• 批量替换必须排除 sessions/ logs/ dump- cron/output/ — 2026-09-10 误改 572 个历史文件（回滚 530）
• git add -A 在大 vault 会失控（曾 staging 46456 文件 → .git 膨胀 3.2G；reflog expire + gc --prune=now 可回收）
• 移动含绝对路径软链的项目要修软链（kocr.py -> 旧路径 会断）
• 脚本类（.py/.json/.yaml）不要用 markdown 文本脱敏（破坏语法）；改为移出或 env 引用
• 项目迁移后要更新引用：~/.hermes/scripts + skills/ + MEMORY.md（会话历史不动）
• 移动项目后原位可能残留 kocr.sh 里的 cd 路径和解释器路径（KOCR 需 ~/ocr_v6_env/bin/python，系统 python3 无 cv2）

归档历史

• 2026-09-10 笔记库全面整理：mc 10000→4557 文件 / 1.1GB→376MB；凭证 26 个集中 key.md；12 编码变体合并；项目迁出 ~/projects/
• 2026-09-05 首建：根目录 53 散落文件 → 0；脚本归 legacy-checks、研究报告归 06-Raw
• 2026-09-05 磁盘 86%→47%（释放 174G）：broken 83G + 双ComfyUI 30G + 旧备份 40G+ 缓存 8G+ 日志 4G