orocoa

Resource Reuse — 项目内资源复用与只读引用

Resource Reuse 是项目内资源库的 Agent Skill 与 Python 命令行工具:查找完全相同的文件、建立只读引用视图,并在需要编辑或独立交付时生成独立文件。当前公开说明标记为 Beta,验证范围为 macOS/APFS。

先查找,再创建

生成、下载或复制资源前,先确认项目归属,再按名称、版本、内容哈希与用途查找现有候选。名称相同或字节相同都不能代替归属和许可核对。

资源库放在对应项目自己的主目录内。不同项目保持独立,不能因为主题、名称或哈希相同就共用一个跨项目池。

选择合适的使用方式

只读使用可以建立具名引用视图,让多个名称指向同一个已固定内容对象。需要修改时,生成独立可写文件;需要交付时,导出不依赖资源库的独立文件。

macOS/APFS 上的写时复制需要实际后端支持。其他存储方式以公开命令说明为准;允许普通复制会产生相应复制成本,不能保证任意平台都达到相同效果。

安装与依赖

公开仓库根目录的 SKILL.md 是 Skill 入口,按所用 Agent 的技能安装方式安装完整目录。也可以从源码运行命令行。Python 需要 3.9 或更新版本,资源库操作使用标准库。

完全重复文件的扫描与批量计划另需 fclones。脚本不会自动安装依赖;先阅读公开 README 的安装、复核计划与导出步骤。

边界与证据

原始文件保留。项目不提供自动删除、后台监听、操作系统写入拦截或跨项目自动共享。资源库和引用视图应排除在发布包、源码副本与恢复快照之外。

只读视图依赖对应资源库,不是独立备份。示例中的复制成本对比不是已经释放的磁盘空间,也不是对其他数据集保证相同节省。

项目入口