🍚 吃什么？

每天自动为全家生成中晚餐菜单 + 买菜清单，到点推送到家人微信。 给爸妈用的菜谱机器人 —— 自托管、单容器、打开即用、零配置、不需要任何密钥。

解决的问题：家里每天为「吃什么」发愁，老人去菜市场不知道买什么，天天买同一种菜。 本项目用「本地家常菜谱库 + 可选的大模型」按「省份菜系 + 时令 + 家人忌口 + 最近吃过的菜」 每天排出一桌搭配合理的家常菜，生成买菜清单，并在固定时间推送到老人手机上的微信里。

推送到企业微信群的每日消息：

🍚 今日菜单 · 今天 午餐 + 晚餐

**午餐**
- 清蒸鲈鱼 · *荤菜* —— 水开后蒸 8 分钟，泼热油
- 西红柿炒鸡蛋 · *素菜* —— 先炒蛋后下番茄
- 醋溜土豆丝 · *素菜* —— 手切更脆，出锅前淋醋
- 紫菜蛋花汤 · *汤*
- 主食：米饭
> 荤素搭配，一荤两素一汤，清淡好消化

**晚餐**
- 香菇油菜 · *素菜*
- 番茄牛腩 · *荤菜* —— 牛腩先焯水，小火炖 40 分钟
- 拍黄瓜 · *凉菜*
- 主食：米饭
> 晚上少油，牛肉补铁

## 🛒 买菜清单
🥬 蔬菜：西红柿×2、土豆、黄瓜、油菜、香菇
🥩 肉蛋类：牛腩、鸡蛋
🐟 水产海鲜：鲈鱼
🧂 调味料：米醋、姜、蒜

另外还有两条老人友好的页面：

• 大字版买菜清单 /plans/<日期>/shopping —— 一键复制到微信、一键打印。
• 简单做法 /plans/<日期>/recipes —— 每道菜的「一句话要点 + 三步做法」，下厨时照着做，也能一键复制/打印。

推送消息里也能带上做法（「设置 → 定时推送 → 推送里带简单做法」开关，默认开）：

## 👩‍🍳 午餐简单做法
- 红烧肉：①五花肉切块冷水下锅焯水去沫 ②小火炒冰糖至琥珀色，下肉块裹匀 ③加生抽老抽、姜葱和热水没过，小火炖 40 分钟收汁
- 醋溜土豆丝：①土豆切细丝泡冷水去淀粉 ②热油下干辣椒、蒜片爆香 ③下土豆丝大火炒，加盐和醋快速翻匀

一句话版本：NAS 上只放一个 docker-compose.yml，docker compose up -d 自动拉镜像，不需要源码、不需要构建。

curl -fsSL https://raw.githubusercontent.com/BEIJUUUUU/chishenme/main/docker-compose.yml -o docker-compose.yml
docker compose up -d

下面按场景分开写：

• NAS / 服务器 → 方式二（拉镜像，最省事）
• Windows 本机 → 方式一（双击 启动.bat）
• 想改代码 → 方式三

直接双击项目目录里的 启动.bat。它会自动：

1. 优先用 Docker 启动（装了 Docker Desktop 的话）；
2. 没装 Docker 就自动建 .venv 虚拟环境、装依赖（只做一次）；
3. 启动服务并把浏览器打开到 http://127.0.0.1:8080。

停止服务：双击 停止.bat，或直接关掉标题为「吃什么？ 服务」的那个窗口。 数据存在项目目录下的 data/ 文件夹里。

默认免登录，打开就是首页，什么都不用填。 只有你之后在「设置 → 访问控制」里改成「需要账号密码」时，才用默认账号 admin / admin123（改完记得立刻换密码）。

镜像已发布在 GHCR（支持 amd64 与 arm64，群晖 / 威联通 / 树莓派都能跑）， 只要下面这个文件 + 一条命令：

# 在 NAS 上（SSH 进去，随便找个目录）
curl -fsSL https://raw.githubusercontent.com/BEIJUUUUU/chishenme/main/docker-compose.yml -o docker-compose.yml
docker compose up -d

或者手动把这段贴成 docker-compose.yml，效果一样：

services:
  chishenme:
    image: ghcr.io/beijuuuuu/chishenme:latest
    container_name: chishenme
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data
    environment:
      TZ: Asia/Shanghai
      CSM_DATA_DIR: /data
    extra_hosts:
      - "host.docker.internal:host-gateway"

打开 http://<NAS-IP>:8080 即可。

docker compose pull && docker compose up -d   # 升级到最新版
docker compose logs -f                        # 看日志
docker compose down                           # 停止

镜像地址：ghcr.io/beijuuuuu/chishenme（也支持 :sha-xxxxxxx 与 :1.2.3 版本号标签）

想从源码自己构建（改代码时用）： docker compose -f docker-compose.build.yml up -d --build

想让新版镜像自动生效，把 docker-compose.yml 末尾注释掉的 Watchtower 段打开即可（每 6 小时检查一次）。

会签名的会话密钥不用操心：不配置时程序会自动生成一份随机密钥保存在 data/secret.key。 默认免登录（家里局域网自用最省事）；如果这台 NAS 会被公网访问，请在 docker-compose.yml 里把 CSM_AUTH_MODE: password 的注释去掉，或进「设置 → 访问控制」切换。

git clone https://github.com/BEIJUUUUU/chishenme.git
cd chishenme
python -m venv .venv
# Windows: .venv\Scripts\activate    macOS/Linux: source .venv/bin/activate
pip install -r requirements.txt
python run.py

1. 设置 → 家庭画像：确认省份 + 人数（默认山东 / 4 人）。这一项影响最大，填对就够用了。
2. 设置 → 口味与健康：家里老人有高血压 / 高血糖 / 痛风 / 牙口不好，勾上；不吃的食材写进忌口。
3. 设置 → 推送通道 + 定时推送：想要每天自动发到微信，填一个推送通道并打开定时任务。

可选：想让 AI 按你家口味自由配菜（而不是固定从菜谱库挑），到「设置 → LLM 模型」选一条通道。 四条通道覆盖了几乎所有接法，详见 接大模型 一节。

配好后再回首页点「生成今天菜单」即可；没配也照样能用，只是换成菜谱库搭配。

1. 地址怎么写都行。填到域名、填到 /v1、甚至把完整 endpoint 直接粘进来，程序都会自动补全，不会拼出 /v1/chat/completions/chat/completions。
2. 本地地址可以不填 Key。Base URL 是 127.0.0.1 / localhost / 192.168.x / 10.x / host.docker.internal 时按「不校验」处理 —— LM Studio、llama.cpp、cliproxy 反代本来就不需要；而指向公网服务却没填 Key 时，会明确告诉你缺什么，而不是生成一串 401。
3. 「列出可用模型」按钮。直接向对方要一份模型列表，点一个名字就填进配置。反代的模型别名（claude-sonnet-4-5 还是 anthropic/claude-3.5）不用再去翻文档猜。

假设你的反代跑在局域网某台机器的 8317 端口：

通道        Anthropic 兼容（Claude / cliproxy 等反代）
Base URL    http://192.168.1.10:8317
API Key     留空（反代一般不校验；如果它校验就填上）
模型名      填反代支持的别名，比如 claude-sonnet-4-5
            不确定就点「列出可用模型」

点「测试 LLM 连接」出现绿色 ✅ 就通了。两个细节已经替你处理：

• 官方 API 认 x-api-key，有些反代要 Authorization: Bearer —— 后者用「额外请求头」补一行 Authorization: Bearer xxx 即可。
• 有些反代无视 stream=false 直接吐 SSE 流 —— 遇到这种会被自动识别并把流拼回完整文本，而不是报「返回非 JSON」。

容器里访问宿主机一律用 host.docker.internal（compose 已配 host-gateway）； 服务在另一台机器上就填那台的 IP。忘了 IP 可以先在本机浏览器打开确认。

python scripts/fake_llm_server.py --port 877

它会起一个本地假接口，同时模拟 OpenAI / Anthropic / Ollama / Gemini 四种形状， 并且从仓库自带的菜谱库里随机拼菜单（带做法、遵守辣度与忌口约束）。 把「设置 → LLM 模型」的地址指向它，就能验证整条链路是否打通 —— 用它可以一眼分清「是我配错了」还是「是模型不行」。

免费、无审核、不用公众号，老人只要在微信里进这个群就能收到。

1. 手机企业微信（或个人微信也能用「企业微信」App）新建一个内部群，把家人拉进去。
2. 群 → 右上角 ··· → 群机器人 → 添加机器人 → 复制 Webhook 地址。
3. 粘贴到「设置 → 推送通道 → 企业微信 Webhook」，保存后点「发送测试」。

                 ┌──────────────────────────────────────────┐
   定时触发  ──▶  │ 1. 组装上下文                             │
 (APScheduler)   │    省份菜系 · 时令食材 · 人数 · 健康约束    │
                 │    忌口 · 最近 N 天吃过的菜（防重复）       │
                 └───────────────────┬──────────────────────┘
                                     ▼
                 ┌──────────────────────────────────────────┐
                 │ 2. 出菜单：两条路                          │
                 │    没配大模型 → 本地菜谱库直接搭配（默认）   │
   配了 → 四条通道任选一条                      │
                 └───────────────────┬──────────────────────┘
                                     ▼
                 ┌──────────────────────────────────────────┐
                 │ 3. 本地校验闸门（app/core/pantry.py）      │
                 │    重复 / 忌口 / 辣度 / 荤素 / 健康 / 时令  │
                 └───────┬───────────────────────┬──────────┘
                    有 error                 无 error
                         │                       │
                         ▼                       │
              ┌────────────────────┐             │
              │ 4. 定点修复重试      │  达上限      │
              │ 把问题回传给模型     ├──────┐      │
              └────────────────────┘      │      │
                                          ▼      ▼
                 ┌──────────────────────────────────────────┐
                 │ 5. 兜底：本地菜谱库拼一桌（保证合规）       │
                 └───────────────────┬──────────────────────┘
                                     ▼
                 ┌──────────────────────────────────────────┐
                 │ 6. 汇总购物清单 → 入库 → 多通道推送微信     │
                 └──────────────────────────────────────────┘

为什么要有本地库？ LLM 会幻觉（「西红柿炒月饼」）、会重复、会无视忌口，也不是每个人都愿意配密钥。 所以把「创意」交给 LLM（可选），把「合规判断」和「没网也能用」交给确定性代码 —— 这是本项目最核心的设计取舍。

app/
├── main.py               FastAPI 装配、启动引导、异常处理
├── config.py             环境变量配置（CSM_* 前缀）
├── models.py             SQLite 表：settings / users / dishes / plans / push_logs / generation_logs
├── runtime_config.py     家庭配置模型 AppConfig + WebUI 表单 Schema（页面数据驱动）
├── scheduler.py          APScheduler 定时任务（可热更新）
├── services.py           推送编排 + 落库
├── security.py           PBKDF2 密码 + 签名 Cookie 会话
├── core/
│   ├── generator.py      生成 → 校验 → 重试 → 兜底 → 入库
│   ├── pantry.py         本地菜谱库、健康规则、校验、兜底拼菜
│   ├── prompt.py         提示词（家庭画像 + 时令 + 防重复）
│   ├── shopping.py       购物清单归类聚合
│   ├── season.py         时令计算
│   └── message.py        推送文本渲染（markdown / 纯文本）
├── llm/                  四条通道：OpenAI 兼容 / Anthropic 兼容 / Ollama / Gemini
│                         + 自定义请求头、模型列表、JSON 健壮解析
│   ├── openai_compat.py      DeepSeek、各类网关、LM Studio、vLLM、llama.cpp
│   ├── anthropic_compat.py   官方 Claude 与 cliproxy 等反代（含 SSE 兜底解析）
│   ├── ollama_provider.py    本地 Ollama
│   ├── gemini_provider.py    Google Gemini（可强制 JSON 输出）
│   └── factory.py            通道注册、可用性判断、连通性自检、模型列表
├── notify/               8 个推送通道 + 注册表
├── routers/              auth / pages / settings / dishes / api
├── data/                 内置菜谱库、做法库、时令表
├── templates/            Jinja2 模板（10 个页面）
└── static/               原生 CSS + JS，零 CDN 依赖，离线可用
scripts/
├── start_server.ps1      记录 PID 后拉起服务（启动.bat 调用）
├── stop_server.ps1       按 PID / 端口 / 命令行三级精确停止
├── fake_llm_server.py    本地假模型服务器（模拟四种接口，验证配置用）
└── offline_demo.py       不配 LLM 也能跑通全流程，打印今天的菜单
tests/                    pytest：校验、购物清单、生成全链路、Web 冒烟、
                          四条 LLM 通道的报文形状与真实 HTTP 往返
启动.bat / 停止.bat         Windows 双击即可启动 / 停止
docker-compose.yml        拉 GHCR 现成镜像（NAS 用这个）
docker-compose.build.yml  从源码本地构建（改代码时用）
.github/workflows/        ci.yml（测试 + 构建校验）· docker-publish.yml（发布多架构镜像到 GHCR）

免登录模式下（默认）直接就能调；切到需要登录后要先登录拿 Cookie。可在「API 文档」/api/docs 里直接试。

菜谱分成两个文件，职责分开、各自升级：

howto.json 里每道菜长这样：

"醋溜土豆丝": {
  "howto": "切丝泡水去淀粉，出锅前淋醋",
  "steps": "①土豆切细丝泡冷水去淀粉 ②热油下干辣椒、蒜片爆香 ③下土豆丝大火炒，加盐和醋快速翻匀"
}

两种改法：

1. 直接在 WebUI「菜谱库」里改 —— 鼠标点一下就能改做法要点和步骤，立刻生效。
2. 改 howto.json 后重启（或点「设置 → 同步内置菜谱库」）—— 已有菜如果做法为空会被自动补上，不会覆盖你自己写过的做法。

设置里选「四川」时，LLM 会按川菜口味出菜，本地兜底库也优先挑川菜与通用菜（含上海→苏浙、重庆→川、东三省→东北等别名映射）。 欢迎 PR 扩充各省菜谱与做法 —— 这是让项目真正「给各省人用」的关键。

Q：一定要配密钥 / 一定要有大模型吗？ 都不用。默认就是「仅本地菜谱库」模式：122 道家常菜按时令、荤素、忌口自动搭配，离线可用、零成本。 大模型是可选的加分项，接法见 接大模型。

Q：我有 cliproxy / 各种反代，能接吗？ 能。反代分两类：Anthropic 形状的（cliproxy、claude-code-proxy）选**「Anthropic 兼容」通道； OpenAI 形状的（one-api、new-api、各类中转站）选「OpenAI 兼容」**通道。 两者都支持「本地/局域网地址不填 Key」，模型别名不用猜 —— 点「列出可用模型」直接拉一份回来点选。

Q：菜品有做法吗？我想照着做。 有。内置 122 道菜每道都配好了「一句话要点 + 三步做法」，本地模式也能带出来：

• 首页 / 菜单详情：每道菜后面跟一句要点；
• 「简单做法」页（/plans/<日期>/recipes，首页有入口）：列出三步做法，大字排版，可一键复制或打印；
• 推送消息里也会附「👩‍🍳 简单做法」（可在「设置 → 定时推送」关掉）。

想改做法或给自家菜补做法：直接在「菜谱库」页面改，或编辑 app/data/howto.json 后重启。

Q：为什么不用登录？被别人看到怎么办？ 默认免登录是为了「打开即用」——家里局域网自用，省掉记账号密码的麻烦。 代价是：能访问到这个网址的人就是管理员。所以只要不是把端口映射到公网，就没事； 一旦要暴露到公网（端口转发、内网穿透），请务必去「设置 → 访问控制」改成「需要账号密码」， 或者在 docker-compose.yml 里设 CSM_AUTH_MODE: password 把登录锁死。

Q：老人只用微信，没有企业微信怎么办？ 注册一个企业微信（个人可免费注册，无需企业资质），建群、加群机器人，然后让家人在微信里接收「企业微信」消息即可。这是目前对老人最省事的方案。

Q：容器访问不到 NAS 上的 Ollama？ docker-compose.yml 已配 host.docker.internal:host-gateway，地址填 http://host.docker.internal:11434。 若 Ollama 在另一台机器，直接填那台的 IP:11434，并确认 Ollama 监听 0.0.0.0（OLLAMA_HOST=0.0.0.0）。

Q：为什么生成的菜被「打回」了？ 看「日志 → AI 生成记录」里的说明列，会写明原因（重复 / 忌口 / 辣度 / 荤素失衡）。调整设置或点「换一桌」即可。

Q：数据存在哪？怎么备份？ ./data/chishenme.db（SQLite + WAL）、./data/secret.key 与 ./data/logs/。备份直接拷 data 目录。

Q：推送时间不准？ 确认容器时区。docker-compose.yml 已设 TZ=Asia/Shanghai。

Q：能不能给爸妈各自发不同内容？ WxPusher 支持按 UID 精准推送，可自行扩展成多接收人；当前版本已预留 PushLog.target 字段。

• 每周菜单一次生成（7 天批量，去重跨天生效）
• 菜价估算与预算控制（接入本地菜价数据）
• 语音播报（TTS 推语音条，方便不识字老人）
• 拍照识别冰箱剩余食材 → 优先消耗
• 多家庭 / 多租户注册
• 各省份菜谱库众包扩充

pip install -r requirements-dev.txt
pytest -q                       # 全部测试
ruff check app tests scripts    # 代码检查
python scripts/offline_demo.py  # 不配 LLM 也能跑通全流程，打印今天的菜单

Windows 上调试启动脚本时可以直接指定解释器，跳过环境准备：

set CSM_PYTHON=D:\python312\python.exe
set CSM_PORT=8081
启动.bat

可用环境变量：CSM_PORT（端口）、CSM_PYTHON（指定解释器）、CSM_FORCE_DOCKER=1（强制容器）、CSM_NO_BROWSER=1（不自动开浏览器）。

MIT