sherrylein/photo-oracle

# Photo Oracle｜相册神谕 Photo Oracle 是一个本地优先、只读、隐私友好的 AI Skill。它会从你的本地照片库中抽取照片，把那些沉睡在硬盘里的瞬间，变成「每日照片签」、记忆牌、三牌问题和月度星图。 那些照片不只是文件。它们曾经属于某一天、某个地点、某种心情，或者某个已经变化了的你。Photo Oracle 做的事情很简单：让你的相册重新开口，让过去的一瞬间，给今天一点提示。 它不是心理测试，也不是真正的未来预测。它更像一种带有占卜感的自我回望仪式：用你自己拍下的照片，抽一张属于今天的牌。 ## 亮点 - 每天抽取一次「今日照片签」 - 用自己的照片生成浪漫、有仪式感的记忆牌 - 支持三牌问题、时间回声、月度星图等玩法 - 本地优先，默认只读，不移动、不删除、不改名、不编辑原始照片 - 只在需要视觉分析时生成代理图，避免直接处理原图 - 对同一天的「今日运势」做锁定：每天只能正式抽一次 ## 它适合谁 - 相册里有很多照片，但很久没有认真回看的人 - 喜欢摄影、旅行、生活记录、日常影像的人 - 想用 AI 重新整理个人记忆的人 - 喜欢塔罗、抽签、MBTI、星座这类轻仪式感体验的人 - 想研究 AI Skill、个人数据、照片档案玩法的开发者 ## 三个入口 ### 1. 今日照片签 每天从你的相册里抽一张照片，生成一张今日照片签。 它会给出： - 今日关键词 - 今日运势标签 - 宜与忌 - 幸运行动 - 时间提示 - 颜色或物件提示 - 基于照片证据的象征解读 为了保留仪式感，每个本地照片库每天只能正式抽一次今日照片签。同一天继续使用时，Photo Oracle 会返回当天已有的照片签，并提供继续玩法：解释深一点、补充行动牌、时间回声、夜间复盘。 ### 2. 三牌问题 你可以向自己的相册提一个问题，然后抽取三张照片： 1. 过去带来的影响 2. 当下没有看见的东西 3. 可以带走的方向 第三张牌不是未来预测，而是一个反思方向。 ### 3. 月度星图 Photo Oracle 可以从一个月或一段时间里抽取多张照片，帮你回看这个阶段反复出现的主题、地点、情绪和生活线索。 ## 安装 克隆仓库： git clone https://github.com/YOUR_NAME/photo-oracle.git cd photo-oracle 安装依赖： pip install -e . 可安装的 Codex Skill 位于： skill/photo-oracle/ 你可以根据自己的 Codex 配置，把这个目录复制或安装到本地 skills 目录。 ## 快速开始 初始化一个本地照片库： python skill/photo-oracle/scripts/oracle.py init --name "Personal Library" --state-root "E:\PhotoOracleData" --source "D:\Pictures" 扫描照片： python skill/photo-oracle/scripts/oracle.py scan --state-root "E:\PhotoOracleData" 抽取今天的照片签： python skill/photo-oracle/scripts/oracle.py fortune --state-root "E:\PhotoOracleData" 如果今天已经抽过，可以继续使用分支玩法： python skill/photo-oracle/scripts/oracle.py fortune --state-root "E:\PhotoOracleData" --continue explain python skill/photo-oracle/scripts/oracle.py fortune --state-root "E:\PhotoOracleData" --continue action python skill/photo-oracle/scripts/oracle.py fortune --state-root "E:\PhotoOracleData" --continue echo python skill/photo-oracle/scripts/oracle.py fortune --state-root "E:\PhotoOracleData" --continue night-review ## 示例体验 今日照片签：窗边的迟到阳光 运势：小吉 关键词：把事情说轻一点 宜：主动发出一个简单邀请 忌：把小误会解释成大结论 幸运行动：今天给一个人发一句不需要对方立刻回复的话 时间提示：下午 4 点后 颜色提示：浅金色 照片证据：画面中有窗边光线、留白和一个没有被占满的空间。 象征解读：这张照片更像是在提醒你，今天适合降低表达的重量，让关系自然靠近。 问题：你今天可以把哪句话说得更轻一点？ ## 隐私与安全 Photo Oracle 对原始照片保持只读。它不会移动、删除、重命名或编辑你的源照片。 建议把状态目录放在照片源目录之外，例如： E:\PhotoOracleData 分享导出时，默认应移除源文件路径、EXIF 和精确 GPS 等敏感信息。 ## 边界说明 Photo Oracle 是一个娱乐与自我反思工具，不是： - 心理诊断工具 - 医疗建议工具 - 金融建议工具 - 关系预测工具 - 真实未来预测工具 「今日照片签」是一种带有占卜感的反思仪式。它可以给你一个今天的小提示，但不会声称某件事一定会发生。 ## 当前限制 - v0.1 主要支持本地图片文件和元数据优先的工作流 - HEIC 支持取决于本地 Pillow HEIF 环境 - RAW 文件在可读取时使用内嵌预览图 - 视频文件不会被扫描、索引、记录、暂存或分析 - 云端占位文件会被跳过，不会自动下载 ## 仓库结构 photo-oracle/ skill/photo-oracle/ # 可安装的 Skill skill/photo-oracle/scripts/ # 本地 CLI 与照片处理逻辑 skill/photo-oracle/references/ examples/ # 示例玩法 evals/ # 行为边界测试用例 tests/ # Python 测试 docs/ # 架构、方法、迭代文档 ## 开发与测试 运行测试： python -m pytest 查看命令帮助： python skill/photo-oracle/scripts/oracle.py --help ## 一句话 你的相册不是仓库。 它是一副还没被洗开的牌。

标签：AI Skill, 个人数据, 塔罗占卜, 本地优先, 相册管理, 逆向工具