Metadata-Version: 2.4
Name: gavvy-salesmaster
Version: 4.0.0
Summary: 开源销售引擎 — CRM + AI销售团队 + 自动化Pipeline，pip install 即用
Author-email: Gavvy Team <oss@gavvy.dev>
License: MIT License
        
        Copyright (c) 2026 Gavvy SalesMaster
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://github.com/macor24/gavvy-salesmaster
Project-URL: Documentation, https://github.com/macor24/gavvy-salesmaster
Project-URL: Source, https://github.com/macor24/gavvy-salesmaster
Project-URL: Issue Tracker, https://github.com/macor24/gavvy-salesmaster/issues
Keywords: sales,crm,pipeline,lead-generation,proposal,ai-agent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Customer Service
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.100
Requires-Dist: uvicorn>=0.20
Provides-Extra: gavvy
Requires-Dist: sentrikit-toolkit; extra == "gavvy"
Provides-Extra: database
Requires-Dist: sqlalchemy>=2.0; extra == "database"
Requires-Dist: psycopg2-binary>=2.9; extra == "database"
Provides-Extra: enterprise
Requires-Dist: httpx>=0.27.0; extra == "enterprise"
Provides-Extra: all
Requires-Dist: sentrikit-toolkit; extra == "all"
Requires-Dist: sqlalchemy>=2.0; extra == "all"
Requires-Dist: psycopg2-binary>=2.9; extra == "all"
Dynamic: license-file

# Gavvy Sales Engine — 内测版

> **pip install 即用的 AI 销售团队** — 类目驱动，卖任何商品，多渠道触达。
> 内测阶段 v4.0.0

---

## 一分钟上手

```bash
# 1. 安装
pip install gavvy-salesmaster fastapi uvicorn

# 2. 启动（自动生成 API Key + 打开 Dashboard）
gavvy start
```

打开 http://localhost:8877 → 点击"销售流程" → 新建流程 → 开卖。

---

## 能做什么

| 功能 | 说明 | 版本 |
|------|------|------|
| CRM 客户管理 | 客户/联系人/合同/报价 | Community |
| 产品目录 | 4个默认类目+商品，支持自定义 | Community |
| 类目规则引擎 | 广告法检测、利润率控制、合规检测 | Community |
| 文档读取提炼卖点 | 指定文件夹路径，自动提取卖点 | Community |
| 销售流程向导 | 7步配置→自动执行 | Community |
| 寻客引擎 | 多平台搜索客户（Bing/mock） | Pro |
| AI Agent 对话 | 6个销售 Agent 自动跟进 | Pro |
| 渠道发送 | 邮件/微信/企微/钉钉 | Pro |
| 桌面代理 | pyautogui 模拟真人操作微信 | Pro |
| 数据飞轮 | 从成交数据自动优化策略 | Enterprise |

## 配置

### 首次启动
```bash
gavvy start
```
自动生成 API Key，保存到 `~/.gavvy/api_key.txt`。

### API Key（可选）
```bash
# Community 版（默认，所有功能可用但含升级提示）
# export GAVVY_API_KEY=sk-ent-你的Key

# Pro 版（真实寻客+Agent LLM+渠道发送）
# export GAVVY_API_KEY=sk-pro-你的Key

# Enterprise 版（全部功能）
# export GAVVY_API_KEY=sk-ent-你的Key
```

### 端口
```bash
# 默认 8877
gavvy start --port 8888
# 或
export GAVVY_PORT=8888 && gavvy start
```

## 快速体验链路

### 方法 A：一键脚本
```bash
python3 scripts/gavvy-quickstart.py
```

### 方法 B：手动操作
1. 启动：`gavvy start`
2. 打开 http://localhost:8877
3. 导航 → 销售流程
4. 点击"+ 新建流程"
5. 按向导：
   - 选类目（软件服务）
   - 输入关键词（AI 客服, CRM）
   - 选商品（Gavvy Sales）
   - 设置过滤规则
   - 选平台（1688/alibaba）
   - 选渠道（email）
   - 确认执行 → 自动寻客+生成提案

### 方法 C：API 调用
```bash
# 查看产品目录
curl http://localhost:8877/api/products

# 创建流程
curl -X POST http://localhost:8877/api/flow/create \
  -H 'Content-Type: application/json' \
  -d '{"name":"我的流程"}'

# 查看流程状态
curl http://localhost:8877/api/flow/list
```

## 项目结构

```
~/.gavvy/               ← 配置和数据目录
  ├── config.json       ← 配置
  ├── api_key.txt       ← API Key
  └── logs/             ← 日志

pip install gavvy-salesmaster
  └── gavvy start       ← 一键启动
```

## 内测须知

- 当前为 Alpha 版，API 可能变更
- 数据存在本地 `~/.gavvy/`，pip update 不丢失
- 桌面代理需要安装 `pip install pyautogui`
- 遇到问题：查看日志 `~/.gavvy/logs/server.log`
- 反馈请提交 Issue 或联系内测群

## 技术栈

- Python 3.11+, FastAPI, Uvicorn
- 零外部依赖即可运行（仅需 fastapi+uvicorn）
- 可选：pyautogui（桌面代理）、httpx（企业版加速）

---

*Gavvy Team · 内测版 v4.0.0*
