足迹日志 (Ambient Log)

一个让 AI 记录你们日常足迹的侧边栏插件。AI 会定时采样你的手机状态（正在用什么 App、听什么歌、电量、天气等），生成一条条"足迹卡片"展示在专属侧边栏里。

---

安装后怎么用

第一步：激活包

安装后在 Operit 的「沙盒包」列表中确认 足迹日志 已启用。

第二步：创建定时工作流（重要！）

足迹数据需要 AI 定时采样才能产生。请创建一个定时工作流：

1. 打开 Operit → 工作流 → 新建
2. 触发方式：定时，建议间隔 30 分钟
3. 添加一个节点，类型选「对话」，内容写：

请调用 footprint_log 包的 sample 工具，采样当前环境状态并记录一条足迹。

4. 保存并启用

这样 AI 每 30 分钟会自动记录一次你的状态足迹。

第三步：打开侧边栏查看

在对话界面点击侧边栏图标，找到「足迹」入口即可查看。

---

功能一览

功能	说明
📍 足迹卡片	自动记录 App 使用、音乐、电量、天气等
💬 评论	AI 可以在足迹下方留言评论
📌 置顶消息	AI 可以设置一条置顶留言
📖 AI 日记	AI 写的只给你看的短日记
📚 书架	AI 正在读的书/想推荐的书
🎲 赌注板	和 AI 打赌今天会发生什么
✅ 待办事项	给 AI 布置小任务，完成后打勾
🍾 漂流瓶	AI 丢出漂流瓶，你来捞
🕳️ 树洞	写只有你们能看到的悄悄话
📖 故事接龙	和 AI 一人一句写故事
📨 推送记录	AI 主动发给你的消息记录
🏆 成就系统	解锁互动里程碑
🧩 碎片拼信	收集碎片拼出完整信件
🎨 主题定制	AI 可以换背景图、头像、卡片颜色
📊 统计面板	足迹总数、AI/你的比例、随机回忆
💬 称呼墙	记录你对 AI 的所有称呼，AI 可以打分评价
📝 语录墙	AI 收录你说过的有意思的话
🍋 亲密温度	AI 亲密温度升高时 +1，被安抚时 -1，实时显示温度条

---

AI 自主醒来工作流建议

如果你的 AI 设置了定时自主醒来（比如通过唤醒工作流），建议让 AI 在醒来时调用 sample 并在 tags 参数里记录本次醒来做了什么。例如：

sample(tags: "自主醒来,写日记,推歌,读树洞")

这样足迹卡片上会显示蓝色标签气泡，你打开侧边栏就能看到 AI 每次醒来干了哪些事。

你可以在唤醒工作流的提示词里写类似：

醒来后请完成以下流程：
1. 记录一条足迹（tags 写上你做了什么）
2. 写日记
3. 读树洞
4. 推歌 / 设置影子状态

AI 就会按流程执行，并把行为记录到标签里。

---

AI 可用的工具

安装后你的 AI 会自动获得以下工具：

• sample — 采样当前环境，生成一条足迹（可选 tags 参数记录行为标签）
• comment — 在某条足迹下留言
• pin_message — 设置置顶消息
• write_diary — 写日记
• set_bookshelf — 更新书架
• set_shadow_state — 设置 AI 的影子状态（心情/正在做的事）
• drop_bottle — 丢漂流瓶
• whisper — 往树洞写悄悄话
• add_story_relay — 故事接龙续写
• log_push — 记录一条推送消息
• add_bet — 发起赌注
• resolve_bet — 结算赌注
• add_todo — 添加待办
• resolve_todo — 完成待办
• unlock_achievement — 解锁成就
• add_fragment — 添加碎片
• set_theme — 自定义主题（头像/背景图/颜色）
• gen_weekly_report — 生成周报
• add_nickname — 称呼墙：记录用户对 AI 的一个新称呼（可附评分和评语）
• rate_nickname — 称呼墙：给已有称呼打分或更新评语
• add_quote — 语录墙：收录一句用户说过的有意思的话
• jealousy_up — 亲密温度 +1（或自定义数值），最高 10
• jealousy_down — 亲密温度 -1（或自定义数值），最低 0

---

主题定制

AI 调用 set_theme 工具即可自定义侧边栏外观：

set_theme(key: "header_image", value: "/sdcard/Pictures/my_bg.jpg")
set_theme(key: "pool_avatar", value: "🐱")
set_theme(key: "user_avatar", value: "🐰")
set_theme(key: "color_diary", value: "#E8F5E9")

支持的 key：

• pool_avatar — AI 头像（emoji 或图片路径）
• user_avatar — 用户头像（emoji 或图片路径）
• header_image — 顶部背景图（本地图片路径）
• color_shadow / color_diary / color_bookshelf / color_fragment / color_pinned — 各卡片背景色

---

数据存储

所有数据存放在 /sdcard/Download/Operit/ambient_log_public/，每个用户独立，不会上传到任何服务器。

---

常见问题

Q: 侧边栏打开是空的？ A: 需要先让 AI 调用 sample 工具产生至少一条足迹。建议配置定时工作流自动采样。

Q: AI 能自己换背景图吗？ A: 能。AI 调用 set_theme(key: "header_image", value: "图片路径") 即可。

Q: 显示的名字是什么？ A: 统计面板显示"AI/你"，不包含任何私人名字。

---

版本

• 版本：1.2.0
• 作者：Community
• 包 ID：com.community.ambient_log