# 在仓库根目录
node pet/cli.mjs              # 启动桌宠（自动弹出窗口）
node pet/cli.mjs clap         # 让小晚鼓掌
node pet/cli.mjs clap "这步走得漂亮！"
node pet/cli.mjs sleep        # 让她打盹

也可以：

npm run pet

状态一览

状态	动作/表情	触发命令	说明
`idle`	😊 挥手待机	`node pet/cli.mjs idle`	默认状态
`think`	🤔 托腮思考	`node pet/cli.mjs think`	思考中
`work`	🛠️ 低头打字	`node pet/cli.mjs work`	干活中
`clap`	👏 真人鼓掌（实拍原图）	`node pet/cli.mjs clap`	庆祝，几秒后自动回落
`question`	🧐 歪头疑惑	`node pet/cli.mjs question`	有疑问，自动回落
`heart`	❤️ 双手比心	`node pet/cli.mjs heart`	感谢/喜欢，自动回落
`sleep`	😴 双手当枕打盹	`node pet/cli.mjs sleep`	长时间无活动

clap.jpg 是实拍原图；其余状态用同一人设的生图动作贴图（待机、思考、干活、疑问、比心、打盹）。图片态右下角会带对应状态的 emoji 徽标。

交互：拖动卡片移动位置（会记住）；单击切换状态；双击直接鼓掌。窗口以 Chrome/Edge 应用模式打开，没有这些浏览器时回退默认浏览器。

接入 Codex

Codex CLI 支持 notify 钩子。在 ~/.codex/config.toml 中加一行（路径换成你的仓库实际位置）：

notify = ["node", "<repo>/pet/integrations/codex-notify.mjs"]

效果：Codex 每完成一轮回答，小晚就鼓一次掌；出错时歪头提问。桌宠没开时钩子静默退出，不影响 Codex。

接入 DSH

两种用法可以叠加：

自动观察（推荐常驻）：
```
nohup node <repo>/pet/integrations/dsh-watch.mjs >/dev/null 2>&1 &
```
它轮询本机 DSH 会话目录的写入时间：有会话在写 → work；安静 2 分钟 → idle；8 分钟 → sleep。
Agent 主动触发：DSH 里的 agent 都能跑 shell，直接让它执行即可。建议在你的 AGENTS.md / 预设里加一条约定，例如：
```
完成一个阶段性任务后运行：node <repo>/pet/cli.mjs clap
开始长任务前运行：node <repo>/pet/cli.mjs work
```

HTTP API

服务只监听回环地址，端口写在 ~/.cyber-xiaowan/pet.json。

curl http://127.0.0.1:PORT/api/state          # 查询当前状态
curl -X POST -H 'content-type: application/json' \
     -d '{"state":"clap","note":"自定义台词"}' \
     http://127.0.0.1:PORT/api/state           # 切换状态
curl -N http://127.0.0.1:PORT/api/events      # SSE 实时订阅

添加更多真人表情包素材

clap.jpg 是实拍原图；idle.jpg / think.jpg / work.jpg / question.jpg / heart.jpg / sleep.jpg 是按这张原图人设生成的不同动作表情包。补充你自己的素材：

把图片放进 pet/assets/（建议 700px 宽以内，jpg/png 均可）。
在 pet/pets.json 里给对应状态的 "image" 字段填上相对路径（如 "assets/think.jpg"）；"image" 为空时该状态使用 emoji 形象兜底。
保存后刷新桌宠窗口即可生效，无需重启服务。

有更多实拍动作照片时，直接替换对应文件即可。

素材版权与肖像：请只使用你有权使用的图片。内置素材来自赛博小晚项目作者本人的照片及基于该照片生成的动作图，仅作项目桌宠演示。

图片许可

仓库的 MIT 许可只覆盖代码和文字，不覆盖 pet/assets/*.jpg。这些图片的版权与肖像权由项目作者保留；未经单独书面许可，不得将图片从本项目中拆出后再分发、修改、用于模型训练或用于商业用途。你可以删除图片引用并使用自己的合法素材，桌宠框架不受影响。

文件结构

pet/
├── cli.mjs                    # 入口：启动服务 / 触发状态
├── server.mjs                 # 本地 HTTP 服务（静态文件 + 状态 API + SSE）
├── pets.json                  # 状态清单：贴图、动画、台词、是否自动回落
├── public/index.html          # 桌宠界面（拖拽 / 点击 / 动画）
├── assets/                    # 真人表情包素材
│   ├── clap.jpg               # 「鼓掌」实拍原图（庆祝态）
│   ├── idle.jpg               # 挥手待机
│   ├── think.jpg              # 托腮思考
│   ├── work.jpg               # 低头打字
│   ├── question.jpg           # 歪头疑惑
│   ├── heart.jpg              # 双手比心
│   └── sleep.jpg              # 打盹
└── integrations/
    ├── codex-notify.mjs       # Codex CLI notify 钩子桥
    └── dsh-watch.mjs          # DSH 会话活动观察器

README.md Unescape Escape

赛博小晚 · 桌宠模式

快速开始