🍳 I am cooking

你离开电脑时（比如去做饭🍳了），pi 继续自主干活。当它真正卡住、需要你时——或任务完成时——会大声呼喊你：声音、中文 TTS、桌面弹窗、手机推送，厨房里的你也能听到。

呼喊时 agent 说："Agent需要你！"

English version

✨ 功能

功能	说明
🧠 自主模式	离开时注入"自主推进，别干等"规则，agent 继续干活而不是停下来等你
🤖 Agent 自主开启	说"我去做饭了""我离开一下""I'm cooking"，agent 理解后自动开启（无需记命令）
📣 多路呼喊	声音 + 中文 TTS + 桌面弹窗 + 手机推送 + TUI 横幅，总有一路能传到你
📣 状态栏动态指示	喊话时状态栏/横幅变 📢 正在广播中...，喊完自动恢复 🍳 离开中 · ⚠N；不想听了按 Ctrl+Alt+M 停止本次（下次照常）
🎵 自定义铃声	三段式播放：短铃声 → Agent 语音 → 你自己的歌（/i-am-cooking sound），到点自动停
🗣️ Agent 自由语音	呼喊时 agent 可原样说出想说的话（ttsText），不限于默认模板
📱 手机推送	ntfy.sh（免费，零配置）— 厨房场景的关键通道
🔔 完成通知	agent 完成任务时喊：“叮咚！好消息！任务完成了！”
🗣️ 自定义呼喊短语	默认"agent 需要你"，可改成你喜欢的话（支持占位符）
🎭 可爱 Topic	编程/算法风自动生成（如"幻觉的提示词-483726"），保证唯一
🎛️ 动态偏好	从你的话里自动切换：别喊了→静音 / 完成后喊我→完成才喊 / 随时汇报→积极模式
🚀 自主等级	该不该喊你的阈值：谨慎(遇墙就喊) / 平衡(默认) / 放手(能不喊就不喊)
🤝 多 Agent 独立	多个 pi 同时离开时互不干扰：同一时刻只放一个声音；关闭某个 Agent 不影响其他
🛡️ 安全网	agent 以"？"结尾等你回复时自动喊（放手等级下仅报错才喊）
🔙 语义退出	说"我不离开了/保持在线"→ agent 理解后关闭；或手动 /i-am-cooking off
🔊 音量控制	可选：离开时自动拉高音量（含解除静音），回来恢复原值
🗣️ 交互式配置	/i-am-cooking setup — 向导式，含 ntfy 引导 + 预览确认 + 配错可重填
🔐 Token 安全	配置值支持 ${ENV_VAR}，token 不落盘明文
🧠 用户可编辑规则	行为规则是 rules.md 单一文件，随改随生效
💻 跨平台	Windows / macOS / Linux

🎯 工作流程

flowchart TD
    A[🏠 在岗] --> B{用户要离开?}
    B -->|手动| C["/i-am-cooking on 备注"]
    B -->|自然语言| D["说：我去做饭了，你继续"]
    C --> E[🍳 离开模式开启]
    D --> E
    E --> F[Agent 自主推进任务<br/>按自主等级决定要不要喊你]
    F --> G{遇到什么?}
    G -->|人类墙 / 需要决策| H["shout_for_user 喊你"]
    G -->|任务完成| I["完成通知 info 级"]
    G -->|可自主解决| F
    G -->|进度节点/定时| P["📈 进度汇报（可选）<br/>小阶段或定时"]
    H --> J[📣 多路呼喊<br/>短铃声/语音/歌曲 + 弹窗/手机推送]
    I --> J
    P --> J
    J --> K["⌨️ 回来打字：补充/问问题，agent 继续"]
    K --> F
    E --> M{用户明确结束?}
    M -->|说 我不离开了／保持在线| N["agent 调 exit_cooking_mode 关闭本会话"]
    M -->|手动 /off| N
    N --> A

一句话版本：你说要走（或直接说"我去做饭了"）→ 离开模式开启 → agent 自主干活，该喊时多路呼喊你；你回来打字补充不关闭（agent 继续），明确说"我不离开了"或 /off 才关闭本会话（不影响其他 Agent）。

📦 安装

# GitHub 安装（推荐）
pi install git:github.com/Nita121388/i-am-cooking

# npm 已发布
pi install npm:i-am-cooking

# 本地开发路径（从源码调试时用）
pi install /path/to/your/local/checkout

安装后 /reload 或重启 pi 生效。

🚀 快速开始

/i-am-cooking setup                     # ① 配置手机推送（交互式向导）
/i-am-cooking test                      # ② 测试所有通道（声音/TTS/弹窗/手机）
/i-am-cooking on 继续做登录模块          # ③ 开启离开模式，走人
/i-am-cooking off                       # ④ 结束离开模式（关闭即关闭，无需 agent 汇报）
/i-am-cooking status                    # 查看状态

💡 开启方式有两种：

• 自动：直接说"我去做饭了，你继续"、"我离开一下，有事喊我"、"I'm cooking"，agent 会理解你的意思并自主开启（enter_cooking_mode）。仅在表达非常明确时才开启，不会误开。
• 手动：/i-am-cooking on [备注]（备注可带偏好，如 on 完成后喊我）。

⚠️ 离开状态不跨会话：任何会话启动都从"在岗"开始。上次会话开启的离开模式不会自动恢复——需要时再次开启即可。

📖 命令

命令	说明	示例
/i-am-cooking on [备注]	开启离开模式。备注可带偏好和自主等级	on 完成后喊我 / on 谨慎点继续调研
/i-am-cooking off	关闭离开模式（只关闭，不发汇报——agent 结束时会自行总结）	off
/i-am-cooking status	查看模式/待处理呼喊/通道/音量/偏好/等级/防打扰参数	status
/i-am-cooking setup	交互式配置向导（手机推送 + 音量 + 自主等级）	setup
/i-am-cooking test	测试所有通道，逐通道汇报真实结果	test
/i-am-cooking stop-sound	停止本次播放（只停当前，下次照常；同 Ctrl+Alt+M）	stop-sound
/i-am-cooking rules	查看当前生效的规则	rules
/i-am-cooking edit-rules	编辑规则文件（保存即生效）	edit-rules
/i-am-cooking reset-rules	规则恢复出厂默认	reset-rules
/i-am-cooking level [档位]	自主等级：conservative/balanced/autonomous，不填则查看	level autonomous
/i-am-cooking limits	查看/调整防打扰参数（交互式中文菜单）	limits
/i-am-cooking sound	自定义呼喊铃声（交互式中文菜单）	sound
/i-am-cooking volume	音量控制：查看/手动调整/离开自动拉高（交互式中文菜单）	volume

子命令支持 Tab 补全：输入 /i-am-cooking 后按 Tab 弹出选项。

🤖 Agent 工具

除了你手动敲命令，agent 自己也会调用 4 个工具来理解你、喊你、调整行为。这些是"人机协作"的接口：

工具	作用	Agent 何时调用
enter_cooking_mode	开启离开模式	你说"我去做饭了/我离开一下/I'm cooking"等非常明确的离开表达时；不确定不调用
set_shout_sound	设置呼喊铃声的自定义歌曲	你说"帮我换个铃声""用 xxx.mp3 当提醒音"并给了具体路径时
set_volume	调整系统音量	你说"音量调大点/小点声/静音"，或呼喊前发现系统静音需解除
shout_for_user	大声呼喊你	遇到必须你处理的事（决策/凭据/审批/澄清），先准备好交接内容（刚好够用）再喊，或任务完成时
set_calling_preference	调整呼喊偏好（响不响）	你说"别喊了"→silence、"完成后喊我"→completion_only 等
set_autonomy_level	调整自主等级（该不该喊）	你说"遇墙就喊"→conservative、"能不喊就不喊"→autonomous 等
exit_cooking_mode	关闭离开模式	你说"我不离开了/保持在线/先停一下"等明确结束表达时；临时补充/问问题不调用

shout_for_user 参数说明：

参数	必填	说明
message	✅	交接说明（一次性最终版）：需你做什么 + 必需的材料/凭据/步骤（仅列必要的）
urgency	✅	info（完成通知）/ normal / urgent（紧急）
category	❌	分类：decision / credential / approval / clarification / help
ttsText	❌	自由语音：TTS 原样念这段，不走默认模板

这些工具在离开模式关闭时会安全降级（如 shout_for_user 会提示"用户就在电脑前"），不会误发呼喊。

Agent 不能设置什么（安全边界）

配置	设置方式	为什么不交给 agent
📱 手机推送（ntfy/webhook + token）	/i-am-cooking setup 向导 / 手动改 config.json	敏感凭据，只应人工配置
🔊 音量提升开关	/i-am-cooking setup 向导	系统级改动，需用户明确允许
🛡️ 防打扰参数	/i-am-cooking limits	护栏参数，默认值已合理，避免被误改
🧠 规则文件 rules.md	/i-am-cooking edit-rules / 手动编辑	规则是用户的意志，agent 不应自我修改
🔘 开关（sound/tts/toast）	/i-am-cooking sound 菜单「开关」	可选开关，命令已支持
🔙 离开模式退出	exit_cooking_mode 工具（agent 语义判断）或 /off 命令	需用户明确结束表达才关闭，不误关

🧠 用户可编辑规则

agent 离开模式的行为规则不是写死的，你可以自己改：

/i-am-cooking edit-rules    # 打开编辑器改规则（保存即生效）
/i-am-cooking rules         # 查看当前生效规则
/i-am-cooking reset-rules   # 恢复出厂默认（从 rules.default.md 拷贝）

规则文件在 ~/.pi/i-am-cooking/rules.md（Markdown），首次启动插件时自动创建（从出厂默认模板拷贝）——直接去这个文件夹改就行，任何编辑器都能编辑，它就是唯一生效的规则。

出厂默认模板在仓库里：extensions/i-am-cooking/rules.default.md（进 git，随插件版本更新）。开发时直接看/改这份文件；用户首次运行时会自动拷贝一份到 ~/.pi/i-am-cooking/rules.md，之后完全由用户接管。

⏰ 什么时候生效？

规则每回合实时读取、零缓存——before_agent_start 时插件重新读文件并注入 system prompt。所以：

你在任何编辑器里改 rules.md → 保存
  ↓ 无需重启 / 无需 /reload / 无需重新 on
下一次 agent 回合开始 → 新规则生效

你改的内容	效果
加一条"不修改生产代码"	下次离开回合起 agent 遵守（取决于 LLM 理解）
删掉"什么时候需要喊我"段落	喊我时机交给自主等级指南（等级是机制层，不受影响）
清空整个文件	只剩底线规则 + 等级指南，agent 仍不会干等
改文件但不在离开模式	不生效（规则只在离开模式下注入）
改仓库 rules.default.md	不影响已生成的用户 rules.md；只影响未来首次安装 / reset-rules

⚠️ 规则只在离开模式下注入（before_agent_start 会检查 config.cooking），普通对话中改规则不会影响 agent。

⚠️ 有一条底线规则永远追加、无法删除："绝不要默默结束回合等用户回复"——防止规则被删空导致 agent 干等。

🧠 动态呼喊偏好

呼喊偏好管"喊得响不响"。agent 从你的话里自动判断，两种方式并行：

1. 文字匹配（扩展代码，毫秒级）：你说"别喊了" → 立即静音，不依赖 agent
2. 语义理解（agent）：你说"我睡会儿" → 理解为静音，调用 set_calling_preference

你说	模式	效果
（不说）	normal（默认）	需要你 + 完成都喊
"别喊了" / "安静" / "静音"	silence	全静音，只剩横幅
"完成后喊我" / "干完通知我"	completion_only	只有完成才响铃
"只有紧急才找我"	urgent_only	只有 urgent 才响铃
"随时汇报" / "每步告诉我"	eager	需要你 / 完成 / 进度都喊

🚀 自主等级（autonomy level）

自主等级管"该不该喊你"——遇到阻塞（比如人类墙：验证码 / 登录 / 手动点击等必须你手动处理的事）时，agent 自己解决还是喊你。与呼喊偏好正交：等级决定"要不要喊"，偏好决定"喊多响"，自由组合。

/i-am-cooking level                   # 查看当前等级
/i-am-cooking level conservative      # 谨慎：遇墙就喊
/i-am-cooking level balanced          # 平衡（默认）：有点难度才喊
/i-am-cooking level autonomous        # 放手：能不喊就不喊

等级	行为
conservative 谨慎	遇到任何人类墙（验证码 / 登录 / 手动点击等）立即喊你；需要决策 / 审批 / 凭据 / 澄清先喊你确认；需求模糊先问清楚；只自主做完全确定无风险的部分
balanced 平衡（默认）	人类墙才喊你；普通决策 / 模糊处用最合理默认方案自主推进并注明假设；只有"自主尝试后仍无法推进"或"选错代价很大"才喊
autonomous 放手	尽量不喊你；所有决策、假设自己定并记录；只有任务彻底无法继续（无权限 / 外部服务故障 / 违反硬性约束）才喊

三个等级都内置保证质量要求（自主 ≠ 降低标准，拿不准选最稳妥方案）。

切换方式（与偏好相同，4 种）：

• 命令：/i-am-cooking level autonomous
• on 备注：on 谨慎点继续
• 直接说："遇墙就喊我" / "能不喊就不喊"（文字匹配保险丝）
• agent 语义理解：set_autonomy_level

等级持久化（存在 config.json，跨离开会话保留），不同于偏好（偏好是会话级的）。

🔊 自定义呼喊铃声（高级设置）

呼喊声音按 短铃声 → Agent 语音 → 自定义歌曲 顺序播放，总时长到点自动停止：

/i-am-cooking sound

中文菜单支持：查看当前设置 / 设置自定义歌曲 / 试听 / 设置总时长上限（默认 60 秒）/ 清除歌曲。

设置歌曲两种方式：

• 文件浏览：从 ~/Music 开始逐级浏览（📁 文件夹 / 🔊 音频文件），选中的文件即为铃声，不用记路径
• 手动输入：直接输入完整路径（如 ~/Music/闹铃.mp3）

也可以直接对 agent 说"帮我换个铃声"并给出路径，agent 会调用 set_shout_sound 工具帮你设置。

环节	说明
① 短铃声	系统哔哔（默认 4 声）
② Agent 语音	中文 TTS。Agent 调用 shout_for_user 时可带 ttsText 原样念自己想说的话（如“叮咚！方案 A 和 B 我拿不准，快回来看看！”）；不填则用默认模板
③ 自定义歌曲	你指定的音频文件（macOS 支持 mp3/wav/m4a；Linux wav/ogg；Windows 建议 wav）
⏱ 总时长	默认 60 秒，到点强制停止，可调（1-300 秒）

格式建议：wav 全平台通用，mp3 在 macOS/Linux 最佳。

三种消息，三种通道：

消息	通道	例子
🚨 需要你	完整三段式响铃：哔哔 4 声 + 语音 + 你的歌曲（最醒目）+ 弹窗/横幅/手机	"需要你决定方案 A 还是 B"
✅ 整个完成	哔哔 2 声 + 完成语音（不播歌曲，安静报喜）+ 弹窗/横幅/手机	"所有任务都完成了！"
📈 进度（小阶段/定时）	只推手机（不响铃/不弹窗/不进横幅），本地仅一条轻提示	"已下载 3/10 个文件"

📈 进度汇报模式（三选一）：每次手动开启离开模式时会问"进度汇报"——① 小阶段完成时（默认）/ ② 定时（每 15 分钟，即使无进展也汇报）/ ③ 不汇报。进度类只推送手机（锁屏可见，不打扰）；紧急/完成通知不受影响。任务完成（收到 ✅ 完成通知）后，定时汇报自动停止，不再继续催进度。

🗣️ 自定义呼喊短语

所有呼喊文案里的"agent 需要你"（TTS / 弹窗 / 手机推送 / 横幅）可以改成任何你想听的话。改 config.json 里的 shoutPhrase：

{ "shoutPhrase": "快来救我" }

TTS 模板里用 {shoutPhrase} 占位（默认 叮咚！{shoutPhrase}！{message}），改一处全生效。

📣 状态栏动态指示 & 停止本次播放

离开模式下状态栏（底部）和编辑区上方横幅保持极简，只做“信号灯”：

状态	状态栏	横幅
离开中、安静	🍳 离开中 · ⚠N 待处理	🍳 离开中 · ⚠N 待处理 · /status 看全部
正在喊话（响铃中）	📢 正在广播中...（Ctrl+Alt+M 静音）（高亮）	同上加一行 📢 正在广播中...
喊完 / 被停止	自动恢复 🍳 离开中 · ⚠N 待处理	同步恢复

设计原则：横幅只显示“计数 + 状态”，不塞具体内容——方案、进度、任务总结等详情都在对话历史里（agent 完成任务后会有总结），看 /i-am-cooking status 也能查全部待处理明细。所以横幅正常 1 行、响铃时最多 2 行，不占屏幕。

你打字补充信息 = 已响应：离开模式下你打字（回复呼喊 / 给新指示 / 补充要求），正在响的铃声会立即停止，之前的呼喊自动标记“已处理”并从横幅清掉（agent 继续自主干活；之后的呼喊是新信号，照常显示/响铃）。

停止本次播放（不想听这次响铃，但保留待处理呼喊）：

• 快捷键：Ctrl+Alt+M（M = Mute；可在 ~/.pi/agent/keybindings.json 自定义绑定）
• 命令：/i-am-cooking stop-sound

停止只掐断当前正在播放的声音——不改任何配置、不关声音开关、不清除待处理呼喊，所以下次呼喊照常响铃。

⚠️ 说明：pi 的终端状态栏不支持鼠标点击，所以用快捷键替代“点击关闭”；按键只影响当前这个终端里正在播的声音（多 Agent 各停各的）。

📱 手机推送配置

交互式向导（推荐）

/i-am-cooking setup

会引导你：了解 ntfy 是什么 → 装 app → 填 topic → 自动随机 topic 建议 → 预览确认（填错了可重填）→ 测试推送。

🎭 Topic 自动生成：随机组合编程/算法风可爱名字 + 6 位数字（如 i-am-cooking-幻觉的提示词-483726），共 5.28 亿种组合，全局唯一。不想用可以手动改。

手动配置

~/.pi/i-am-cooking/config.json：

{
  "phonePush": true,
  "pushProvider": "ntfy",
  "ntfyTopic": "i-am-cooking-你的随机topic",
  "ntfyToken": "${NTFY_TOKEN}",
  "autonomyLevel": "balanced",
  "soundSeconds": 60
}

其余字段（beeps / soundPath / repeatIntervalMinutes 等）都有默认值，一般无需手改——用对应命令调整即可：/i-am-cooking level、/i-am-cooking sound、/i-am-cooking limits。

ntfy 安装：Android/iOS 搜 "ntfy" 安装 → Subscribe → 填入 topic 名即可。

也支持 Webhook（Bark / 企业微信机器人 / Server酱），见 完整文档。

🔊 音量控制（可选）

手动调整 & 查看

/i-am-cooking volume

交互式中文菜单：查看当前系统音量 / 立即把音量调到指定值（0-100）/ 设置"离开时拉高到多少" / 开关"离开自动拉高"。

Agent 也会调整音量（set_volume 工具）：你说"音量调大点""小点声""静音"时，agent 帮你调；呼喊前发现系统静音也会先解除静音保证你能听到。

离开自动拉高（可选）

离开时自动拉高音量（防止静音听不到呼喊），回来恢复。

setup 向导里会明确问你"允许吗"，默认关闭。允许后每次 on 自动拉高，off 恢复原值。

平台	实现
Windows	Core Audio API（PowerShell，零依赖）
macOS	osascript（系统自带，同时还原音量+静音状态）
Linux	pactl（PulseAudio）

macOS 细节：静音状态下（含 Mute 键触发的 muted=true），on 会自动解除静音并拉高音量，off 恢复原来的音量和静音状态。

🛡️ 防打扰机制（默认护栏，可调）

需要你 / 整个完成 / 进度（小阶段·定时）是三种不同消息，各自走各自的通道与限制，互不影响。

限制	作用于	默认值	调整方式
同一任务完成只通知一次	✅ 整个完成	不重复喊	固定
每次离开最多通知几次完成	✅ 整个完成（不同任务累计）	3 次	/i-am-cooking limits
小阶段完成提醒	📈 小阶段完成	① 小阶段完成时（默认，开启时询问）；只推手机	开启时询问
定时汇报进度	⏰ 进度	关闭（选②时每 15 分钟）；只推手机；完成后自动停止	开启时询问
普通呼喊重复	⚠️ 普通呼喊	3 分钟一次（只重复一次）	/i-am-cooking limits
紧急呼喊反复喊	🚨 紧急呼喊	1 分钟一次，直到你回来	/i-am-cooking limits
10 分钟内不重复同内容	所有消息	自动去重	固定

运行 /i-am-cooking limits 弹中文菜单即可调整（无需记英文参数）。

🤝 多 Agent 场景（多个 pi 同时离开）

同时开多个 pi（比如两个终端 / 一个终端一个 RPC）并都进入离开模式时，各 Agent 完全独立、互不干扰：

能力	行为
🔊 音频互斥	多个 Agent 同时喊时，同一时刻只放一个声音——后到的跳过声音（只留弹窗/推送/横幅），避免重叠听不清；用户主动 /i-am-cooking test 或试听可抢占
🔙 独立关闭	关闭某个 Agent（说"我不离开了"或 /i-am-cooking off）只影响它自己，其他 Agent 继续工作，无需重新开启

崩溃恢复：Agent 进程崩溃留下的音频锁会被自动检测（进程存活检查）并抢占；超时（75 秒）兜底防误判。

🖥️ 平台支持

平台	声音	中文 TTS	自定义歌曲	桌面通知	手机推送	音量控制
Windows	✅	✅	✅ wav	✅ Toast	✅	✅
macOS	✅	✅ say Tingting	✅ mp3/wav/m4a	✅ osascript	✅	✅
Linux	✅¹	✅¹ espeak-ng	✅¹ wav/ogg	✅¹ notify-send	✅	✅¹

¹ Linux：需安装对应包（canberra-gtk-play / espeak-ng / paplay / notify-send / pactl）。

✅ 验证清单

发布前请通过 docs/VERIFICATION.md。

📄 许可

MIT — 详见 LICENSE。

---

English users: see docs/README.en.md for the full English documentation.