使用教程
更新日期：2026年7月3日 · 站点：eat.yisuncloud.com
1. 这个产品解决什么问题？
一榫云 · 今天吃什么 帮你回答「今天/这顿吃什么」——不是简单搜菜谱，而是根据人数、时间、口味、冰箱食材，从川菜库中给出主推 + 备选。
页脚品牌行：一榫云 · 今天吃什么（eat.yisuncloud.com）
2. 第一次怎么用？
- 打开首页，点「帮我决定这顿」。
- 回答：几个人、多少分钟、辣度、场景，可选填冰箱食材。
- 查看推荐结果，点菜名进入详细步骤。
- 可安装 PWA到手机，厨房离线查阅。
3. 免费与付费
- 访客：每日 5 次规则决策（不含 AI 解释）。
- 注册：激活邮箱后 7 天试用，含 20 次 AI 问答。
- 订阅：无限规则决策 + 每月 AI 配额 + Pro 周菜单（开发中）。
- 中国内地首选支付宝；境外站 eat.yisun.cloud 支持 PayPal、万里汇。
4. 管理员 · 采集入库
管理员（info@yisuncloud.com）登录后可在采集页提交含 schema.org Recipe 的网页 URL。任务进入异步队列，支持批量 URL；处理完成后进入待审核，发布后才进入推荐池。
采集在服务器端执行（可配置 cron 访问 cron/process-crawl.php?secret=…），PWA 仅触发任务并展示进度。
5. 开发者 API（预览）
REST 接口位于 /api/v1/，后续将提供 API Key 与 MCP 接入。当前可用：
GET /api/v1/health.php— 健康检查POST /api/v1/decide.php— 吃饭决策 JSONGET /api/v1/recipes.php— 菜谱列表
6. 邮件激活
注册后向邮箱发送激活链接。在 config.local.php 配置 SMTP 或阿里云 DirectMail。未收到可在激活页重发。
7. MCP / 开发者 API
订阅用户可在API Key页生成 Key，供 Cursor / Claude Desktop 等 MCP 客户端调用。
- MCP 端点：
https://eat.yisuncloud.com/mcp/ - 协议：JSON-RPC 2.0 POST，Header：
Authorization: Bearer eat_xxx - 工具：
decide_what_to_eat·search_recipes·get_recipe·ask_ai_teacher·recommend_kitchen_gear - REST：
/api/v1/decide.php·/api/v1/ai-ask.php·/api/v1/recommend-gear.php