☕ Luckin AI CLI (瑞幸终端点餐 Agent)

🚀 用自然语言在终端里点咖啡！ 基于 DeepSeek 大语言模型 + 瑞幸官方 AI Skill / MCP 协议 打造的极客终端 CLI 点餐智能体。无需打开 GUI 界面，直接在 Linux / 安卓 Termux 终端下通过连续对话完成选购与点单。

---

✨ 核心特性

• 🧠 DeepSeek 智能大脑：结合大语言模型的自然语言理解能力，自动提取商品、规格（冰度/糖度）、打包/自提等决策参数。
• 📜 官方 Skill 规范注入：直接加载瑞幸官方 @luckin/my-coffee-skill 的 SKILL.md 规则集，具备标准化的咖啡师人设与引导流程。
• 📱 Termux 手机端完美运行：无需 Root 权限，原生跑在安卓 Termux 命令行环境中，随时随地极客点餐。
• 💬 多轮交互式 CLI 体验：基于上下文记忆（Context Memory），支持连续对话、人性化交互确认与优雅撤销机制。
• 🔐 安全凭证隔离：通过 .env 配置文件严格隔离 API Key 与 Luckin MCP Token，支持 GitHub 自动免密推送。

---

🛠️ 运作原理 (Architecture)

[ 用户自然语言输入 ]
         │
         ▼
[ Termux 交互式 CLI (index.js) ]
         │
         ├───> [ 加载官方 SKILL.md (系统人设/规则) ]
         │
         ▼
[ DeepSeek LLM (Function Calling/推理) ]
         │
         ├───> 自动提取参数: { keyword, sugar, ice, store }
         │
         ▼
[ 瑞幸 API / MCP 服务器 (gwmcp.lkcoffee.com) ]
         │
         ▼
[ 终端渲染输出 / 扫码完成支付 ]

---

🚀 快速开始 (Quick Start)

1. 克隆项目与安装依赖

# 克隆仓库
git clone https://github.com/smile-wq/luckin-ai-cli.git
cd luckin-ai-cli

# 设置 Node.js 模块类型并安装依赖
npm pkg set type="module"
npm install

2. 配置环境变量 .env

在项目根目录下创建 .env 文件并填入你的凭证：

# 瑞幸官方开放平台/MCP Token
LUCKIN_MCP_TOKEN=你的瑞幸Token

# DeepSeek 大模型 API 配置
OPENAI_API_KEY=sk-xxxxxx你的API密钥
OPENAI_BASE_URL=https://api.deepseek.com/v1

3. 下载瑞幸官方 Skill（可选/推荐）

# 下载并解压官方 Skill 规则包
curl -L -o my-coffee-skill.zip "https://unpkg.luckincoffeecdn.com/@luckin/my-coffee-skill@latest/dist/my-coffee-skill.zip"
unzip my-coffee-skill.zip -d skill-files

4. 启动终端 Agent

node index.js

---

📖 使用示例 (Usage)

==================================================
📜 成功加载瑞幸官方 SKILL.md 系统提示词
☕ 瑞幸 AI 终端点餐助手已就绪 (输入 'exit' 或 'quit' 退出)
==================================================

👤 你: 帮我找找附近有哪些瑞幸门店？
🤖 瑞幸 AI: 好的，请告诉我您当前所在的具体位置或坐标，我来帮您查找最近的瑞幸咖啡门店~

👤 你: 我在国贸附近，想喝一杯生椰拿铁
🤖 瑞幸 AI: 收到！为您推荐国贸店的【生椰拿铁】☕
   • 规格建议：大杯 / 冰 / 半糖（推荐最佳口感）
   请问是否为您生成到店自取的订单？(1. 确定 / 2. 取消)

---

🛠️ 技术栈 (Tech Stack)

• Runtime: Node.js (ES Module)
• LLM Provider: DeepSeek API (deepseek-chat)
• SDKs: OpenAI Node.js SDK, Axios, dotenv
• Protocol: Model Context Protocol (MCP) / Streamable HTTP
• Environment: Termux / Linux Terminal

---

📄 开源协议 (License)

本项目基于 MIT License 开源。