# 🛡️ 膜掌柜 (zhanggui)

> 手机钢化膜门店智能 CLI — 库存、订单、报价、AI 对话
> 仿照瑞幸咖啡 AI 开放平台架构，专为社区门店打造

[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Node](https://img.shields.io/badge/Node-%3E%3D16-green.svg)](package.json)
[![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](mcp/server.js)
[![中文](https://img.shields.io/badge/lang-中文-red.svg)]()

```
curl -fsSL https://你的服务器/install | bash
```

## 架构（三层设计，跟瑞幸一样）

```
┌─────────────────────────────────────┐
│  CLI 层  → 终端交互                  │
│  zhanggui login / invent / order 等     │
│  AI 对话模式: 输入"还有iPhone膜吗"   │
├─────────────────────────────────────┤
│  MCP 层  → 标准 AI 接口              │
│  zhanggui mcp → 启动服务               │
│  任意 AI Agent 能调用门店业务        │
├─────────────────────────────────────┤
│  Skill层 → 可导入 AI 助手的知识包     │
│  SKILL.md → 导入 WorkBuddy/Cursor   │
└─────────────────────────────────────┘
```

## 快速开始

```bash
# 1. 配置门店
zhanggui login

# 2. 添加库存
zhanggui invent add -b 闪魔 -m "iPhone 16 Pro" -t 钢化膜 -c 20

# 3. 查看库存
zhanggui invent ls

# 4. 创建订单
zhanggui order new

# 5. 生成报表
zhanggui report --today

# 6. AI 对话模式（需配置 LLM）
zhanggui chat

# 7. 启动 MCP 服务
zhanggui mcp
```

## 配置 AI 模型（自备 API Key，跟瑞幸一样）

```bash
zhanggui models add --name deepseek --api-key sk-xxxxxxxx
```

支持任意兼容 OpenAI API 的模型：
- DeepSeek (deepseek.com)
- Kimi (moonshot.cn)
- Qwen (qwen.aliyun.com)
- GPT (openai.com)
- 硅基流动 / 本地 ollama 等

## MCP 服务（让 AI Agent 操作你的店）

```bash
zhanggui mcp -p 3456
```

提供 7 个标准工具：
- `query_inventory` - 查询库存
- `add_inventory` - 入库登记
- `create_order` - 创建订单
- `query_orders` - 查询订单
- `query_report` - 生成报表
- `query_price` - 查报价
- `get_shop_info` - 门店信息

## 数据存储

全部数据存在 `~/.zhanggui/` 目录，JSON 文件格式，零数据库依赖。

## 📜 开源信息

- **协议**: [MIT](LICENSE) - 你可以随意使用、修改、商用
- **变更记录**: [CHANGELOG.md](CHANGELOG.md)
- **贡献代码**: 欢迎 PR ！参见 [CONTRIBUTING.md](CONTRIBUTING.md)
- **报告问题**: [Issues](https://github.com/doudou-coder/zhanggui/issues)

## 🗺️ 路线图

- [ ] 微信小程序 (扫码查库存)
- [ ] 抖音本地生活数据接入
- [ ] 语音录入 (CosyVoice 集成)
- [ ] 多门店支持
- [ ] 数据可视化 Dashboard (Web)

## 跟瑞幸 CLI 对比

| 特性 | 瑞幸 CLI | 膜掌柜 |
|------|---------|-----------|
| 安装 | curl \| bash | curl \| bash |
| AI 模型 | 自备 API Key | 自备 API Key |
| 交互模式 | AI 对话点咖啡 | AI 对话管门店 |
| MCP 服务 | ✅ | ✅ |
| Skill 包 | ✅ | ✅ |
| 业务逻辑 | 选店→选品→下单 | 库存→订单→报表 |

## 部署到服务器

```bash
# 把整个目录传到服务器
scp -r 膜掌柜/ root@你的服务器:/opt/膜掌柜/

# 然后修改 install.sh 里的远程下载地址
# 用户只需一行命令安装
```

## License

MIT