🛡️ 膜掌柜 (zhanggui)

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

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

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

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

快速开始

# 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，跟瑞幸一样）

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 操作你的店）

zhanggui mcp -p 3456

提供 7 个标准工具：

• query_inventory - 查询库存
• add_inventory - 入库登记
• create_order - 创建订单
• query_orders - 查询订单
• query_report - 生成报表
• query_price - 查报价
• get_shop_info - 门店信息

数据存储

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

📜 开源信息

• 协议: MIT - 你可以随意使用、修改、商用
• 变更记录: CHANGELOG.md
• 贡献代码: 欢迎 PR ！参见 CONTRIBUTING.md
• 报告问题: Issues

🗺️ 路线图

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

跟瑞幸 CLI 对比

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

部署到服务器

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

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

License

MIT