（4620期）Folders – 安全索引，智能管理项目目录

安全索引，智能管理项目目录 安全索引管理项目目录，支持路径安全校验与跨平台文件夹操作，防止误删系统文件 使用说明 核心用法 Folders 是一个轻量级目录管理工具，专为安全、高效的项目文件夹操作而设计。 主要功能 智能索引：维护 ~/.config/folder-index.json 记录重要目录位置，快速响应"我的项目在哪"类查询 项目发现：自动扫描常见开发目录（~/projects、~/code 等），通过 .git、package.json、Cargo.toml 等项目标记识别项目 路径安全：强制规范化路径（解析 ~、..、符号链接），主动拒绝系统关键目录 安全删除：使用系统废纸篓而非永久删除，明确标注可恢复性 跨平台适配：处理 macOS 的 .DS_Store、Windows 长路径（>260字符）、网络驱动器警告等 显著优点 安全性优先：多层防护机制——路径白名单、符号链接跳过、系统目录拦截，大幅降低误操作风险 开发场景优化：深度理解开发者工作流程，自动识别主流技术栈项目结构 非侵入式操作：发现项目后先征求确认再添加索引，避免自动修改用户环境 平台感知：针对 macOS/Windows/Linux 的特定行为做适配处理 潜在局限 索引范围有限：仅支持用户主动添加或扫描到的项目，非全局文件系统搜索 技术栈偏向：项目检测依赖特定配置文件，非主流技术栈可能识别不全 网络路径谨慎：对网络驱动器采取保守策略，批量操作前需人工确认 无版本控制：索引文件为简单 JSON，无冲突解决或多设备同步机制 适合人群 多项目并行、频繁切换目录的开发者 注重操作安全、担心误删系统文件的用户 需要快速定位散落在各处的项目文件夹的技术人员 常规风险 | 风险类型 | 缓解措施 ||---------|---------|| 路径遍历攻击 | 强制 canonicalize，拒绝 .. 穿越系统目录 || 符号链接劫持 | 遍历中跳过所有 symlinks，单独报告 || 误删重要文件 | 强制使用系统 trash，标注恢复方式 || 网络路径延迟/离线 | 批量操作前显式警告 | 总体评估 该技能在安全设计上表现成熟，将"恢复能力"和"用户确认"作为核心原则，适合日常开发目录管理，但不应作为关键数据的唯一备份或同步方案。 原始说明 Index important directories and perform safe folder operations with proper security checks.