shield_lock
JinDaGe
← Back to skills
extension
Category: Productivity & OfficeNo API key required

端侧本地 AI 全链路文件治理

基于 OpenVINO + 语义向量，100% 本地离线运行的一站式文件自动归档、重复清理、多模态检索 Skill。内置 Windows 核心文件隔离防护，适配全行业办公场景。 核心能力： - 智能垃圾清理：识别临时文件、缓存日志、下载残留，安全隔离而非删除 - AI 文档归档：基于 sentence-transformers 语义分类，自动按主题归档 - 多模态检索：自然语言描述即可定位文件，支持以文搜图 - 全程可撤销：操作日志 7 天内一键恢复 - 四层安全防护：系统目录黑名单 + 分区锁定 + 项目保护 + 后缀拦截 技术亮点： - OpenVINO 异构加速（CPU/GPU/NPU 自动适配） - 双层检索架构：SQLite 元数据倒排 + FAISS 向量相似度 - 100% 本地推理，隐私数据不出机 - Agent 基准测试 10/10 全通过

personAuthor: qiankunyidinghubModelScope
downloadDownload package

FileGovernor - 端侧本地 AI 全链路文件治理 Skill

Description

端侧本地 AI 全链路文件治理 Skill，100% 本地离线运行，一站式覆盖文件自动归档、重复文件清理、软件缓存延时清理、多模态自然语言模糊检索。内置严格 Windows 系统核心文件隔离防护，适配全行业职场办公场景。

Agent Instructions

当用户触发文件治理相关指令时，Agent 应：

  1. 识别意图：匹配 triggers 中的关键词确定命令
  2. 执行命令：通过 Bash 工具调用 python src/main.py <command> [args] --json
  3. 解析结果：捕获 stdout 中的 JSON 输出，向用户展示结构化结果
  4. 确认执行：对于变更操作（clean/archive），先展示预览结果，用户确认后再加 --execute 执行
  5. 错误处理：如果命令失败，向用户报告错误并建议解决方案

调用示例

# 预览扫描（不执行变更）
python src/main.py clean --json

# 确认执行（用户同意后）
python src/main.py clean --execute --json

# 搜索文件
python src/main.py search "财务报表" --json

# AI 归档分析
python src/main.py archive --json

路径说明

  • 项目根目录: Skill 安装目录（即 SKILL.md 所在目录）
  • Python 解释器: 系统 PATH 中的 python 命令（需 Python 3.9+）
  • 完整调用: cd <skill_dir>; python src\main.py <command> --json
  • 也可通过入口脚本: .\run.ps1 -Command clean -Json

Capabilities

1. 磁盘分区管控

  • 自动识别系统盘并开启保护模式
  • 支持用户锁定/解锁指定数据分区
  • 归档盘空间检测与自动分流

2. 安全垃圾清理

  • 扫描用户临时文件、第三方软件缓存
  • 全局系统资源黑名单，绝不触碰 Windows 核心目录
  • 按日期归档至隔离仓，支持手动恢复

3. AI 智能文件归档

  • 轻量文本 Embedding 语义分类（文档自动归类）
  • CLIP/OCR 多模态图片分类（截图、照片智能归档）
  • 成套项目目录自动识别与保护
  • 二进制重复文件检测与安全备份

4. 多模态极速检索

  • 自然语言模糊检索文档与图片
  • 元数据倒排索引 + 多模态向量索引双层架构
  • Watchdog 实时增量索引更新
  • 冷热数据自动淘汰

5. 按日期归档管理

  • 重复文件备份回收站
  • 软件缓存按日期归档目录
  • 单文件/整目录一键恢复

6. 撤销/后悔药机制

  • 完整操作日志（SQLite 持久化）
  • 一键撤销最近 7 天操作
  • 文件占用智能跳过

Trigger Instructions

用户可以通过以下自然语言指令触发 Skill 功能：

| 指令 | 功能 | |------|------| | "初始化文件治理" / "init" | 扫描分区、加载配置、建立系统保护 | | "清理磁盘垃圾" / "clean" | 执行安全垃圾扫描，展示清单后归档隔离 | | "智能归档文件" / "archive" | AI 分析+分类+去重，生成操作清单 | | "搜索文件 [关键词]" / "search [query]" | 多模态模糊检索 | | "撤销上次操作" / "undo" | 撤销最近一次文件整理操作 | | "查看状态" / "status" | 显示预处理进度、磁盘空间统计 | | "锁定分区 [盘符]" / "lock [drive]" | 锁定指定分区禁止扫描 | | "解锁分区 [盘符]" / "unlock [drive]" | 解锁指定分区 | | "设置归档盘 [盘符]" | 修改默认归档目标盘 |

Input/Output Specification

Agent 标准调用协议

FileGovernor 支持通过 CLI 子进程调用，Agent 面板通过 --json 参数获取结构化输出进行解析渲染。

通用输入格式

{
  "command": "clean|archive|search|init|undo|status|lock|unlock",
  "args": {
    "query": "搜索关键词（search 命令必填）",
    "drive": "盘符（lock/unlock 命令）",
    "execute": true,
    "json": true,
    "partition": "分区过滤（search 可选）"
  }
}

通用输出格式

{
  "status": "preview|cleaned|analyzed|archived|search_complete|error",
  "total_count": 26545,
  "total_size_mb": 589.12,
  "files": [...],
  "batch_id": "clean_20260720_143052",
  "message": "操作说明文本"
}

各命令输出示例

init - 初始化结果

{
  "status": "initialized",
  "partitions": 3,
  "archive_drive": "D:",
  "indexed_files": 12450
}

clean - 垃圾扫描结果

{
  "status": "scan_complete",
  "total_count": 26545,
  "total_size_mb": 589.12,
  "files": [
    {"path": "C:\\Users\\...\\temp.tmp", "name": "temp.tmp", "size_kb": 12.5, "source": "桌面", "category": "临时文件"}
  ]
}

archive - 归档分析结果

{
  "status": "analyzed",
  "doc_count": 342,
  "image_count": 89,
  "duplicate_groups": 15,
  "categories": {"财务报表": 45, "产品PRD": 32, "会议纪要": 28},
  "sample_files": {"财务报表": ["Q3报告.docx", "预算表.xlsx"]}
}

search - 检索结果

{
  "status": "search_complete",
  "count": 12,
  "results": [
    {"path": "D:\\归档库\\财务报表\\Q3.docx", "name": "Q3.docx", "score": 0.87, "match_reason": "语义相似度匹配"}
  ]
}

调用方式

Agent 通过子进程调用 CLI 并捕获 stdout JSON：

import subprocess, json
result = subprocess.run(
    ["python", "src/main.py", "clean", "--json"],
    capture_output=True, text=True, cwd="/path/to/project"
)
data = json.loads(result.stdout)

人类交互模式

  • 默认（无 --json）：人类可读的控制台文本输出
  • -i / --interactive：执行前弹出 y/N 确认提示
  • --execute：跳过预览直接执行（配合 Agent 自动化流程）

Security Declaration

  1. 系统文件物理隔离：全程跳过 Windows 系统核心目录，不读取、不修改、不删除
  2. 零网络上传：所有 AI 推理、索引、用户文档全部本地存储处理
  3. 操作可撤销：所有文件变更均记录日志，支持 7 天内一键撤销
  4. 文件占用跳过：正在使用的文件不会被移动或删除
  5. 用户确认优先：批量操作前强制展示清单，用户确认后执行
  6. 不读取注册表：仅基于目录特征+文件后缀+修改时间识别文件

Architecture

Hybrid 混合 AI 架构
├── 上层交互层：Skill 标准对话面板（对接 Agent）
├── 五大业务引擎：分区管控 | 垃圾清理 | AI归档 | 检索 | 日期归档
├── 公共调度层：异步调度 | 安全防护 | 撤销机制 | 占用检测 | 空间检测
└── 底层推理层：OpenVINO 模型服务 | 文件工具 | Watchdog 监听

Execution

# 基础命令
python src/main.py init              # 初始化
python src/main.py init --watch      # 初始化 + 启动文件监听
python src/main.py clean             # 垃圾扫描（预览）
python src/main.py clean --execute   # 垃圾清理（执行）
python src/main.py clean --json      # 结构化输出（供 Agent 解析）
python src/main.py clean -i          # 交互确认模式
python src/main.py archive           # AI 归档分析（预览）
python src/main.py archive --execute # AI 归档执行 + 索引构建
python src/main.py archive --json    # 结构化输出
python src/main.py search "关键词"   # 多模态检索
python src/main.py search "关键词" --json  # JSON 输出
python src/main.py undo              # 撤销最近操作
python src/main.py status            # 状态查看
python src/main.py lock D:           # 锁定分区
python src/main.py unlock D:         # 解锁分区

Competition Notes

本 Skill 专为英特尔 Production AI Skills 第三期大赛设计：

  • 100% 端侧离线：无需联网，AI 推理全部本地完成
  • Intel 硬件优化：OpenVINO 调度 NPU/GPU/CPU 异构推理
  • 安全防护：四层拦截确保系统文件零风险
  • 可逆操作：SQLite 日志 + 7天撤销保障
  • Agent 友好：标准化 JSON I/O，可被任何 Agent 平台调用