Osori 核心功能与评估
Osori（오소리）是一款本地项目注册表与上下文加载工具，旨在解决开发者在多个项目间频繁切换时的路径记忆负担和上下文重建成本。
核心用法
该工具通过 ${OSORI_REGISTRY:-$HOME/.openclaw/osori.json} 维护本地项目数据库，支持五种主要操作模式：
- 项目发现（find）：采用四级回退策略——先查注册表 fuzzy match，再调用 macOS Spotlight（
mdfind），接着使用find遍历OSORI_SEARCH_PATHS指定目录，最后询问用户。发现后自动提示加入注册表 - 上下文加载（switch）：切换项目时自动聚合
git status、git branch、最近 5 条 commit 日志，若绑定 GitHub 仓库则额外拉取 5 条最新 issue - 批量管理（scan/add/remove/list）：支持目录批量扫描入库、手动添加/删除项目、按标签/语言过滤列表
显著优点
1. 跨平台兼容：macOS 原生集成 Spotlight，Linux 自动降级为 find，无需额外依赖
2. 零配置启动：环境变量 OSORI_REGISTRY 和 OSORI_SEARCH_PATHS 均为可选，开箱即用
3. 智能上下文重建：一次切换即可呈现代码状态、分支、历史、待办 issue 的完整视图，显著降低认知负荷
4. Schema 结构化存储：JSON 格式便于版本控制和第三方集成
潜在局限与风险
- 路径遍历深度限制：默认
--maxdepth 4可能遗漏深层嵌套仓库，需手动调整OSORI_SEARCH_PATHS - GitHub CLI 依赖：
gh issue list功能要求提前认证，未认证时命令会失败 - Spotlight 索引延迟：macOS 上若项目为新创建且未建立索引，
mdfind可能返回空结果 - 无自动同步机制：注册表为本地文件，多设备使用需手动同步或配合云盘
适合人群
多项目并行开发者、开源贡献者、需要频繁在客户端/服务端/基础设施代码库间切换的全栈工程师，以及追求终端工作流自动化的效率型用户。
常规风险提示
- 脚本执行涉及文件系统遍历，建议确保
OSORI_SEARCH_PATHS不包含敏感系统目录 scan-projects.sh批量操作前建议备份注册表文件- 涉及
gh命令时需确认当前认证身份，避免误操作企业私有仓库