Metadata-Version: 2.4
Name: dfc-customer-sync
Version: 3.7.0
Summary: 巨懂车客户自动同步到大风车 CRM
Author-email: damienchen <damienchen0624@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/damienchen0624-spec/dfc-customer-sync
Project-URL: Repository, https://github.com/damienchen0624-spec/dfc-customer-sync
Project-URL: Issues, https://github.com/damienchen0624-spec/dfc-customer-sync/issues
Keywords: crm,sync,automotive,used-car
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: playwright<2.0,>=1.49

# dfc-customer-sync

将巨懂车新增留资客户同步到大风车 CRM。

大风车认证使用 `APP_KEY` 动态换取 `dfcToken`。同步前会从
`danube-tenant-web.souche.com/staffs/all.json` 拉取当前门店员工，筛选
`roleNames` 含“销售员”的记录，并将其 `id` 用作客户“销售”字段的
`recordId`。巨懂车的当前跟进人按精确名称或唯一包含关系匹配销售员名称；
同名销售不会自动映射，需通过 `dfc.follower_mapping` 手动配置。

首次使用：

```bash
dfc-sync --setup
dfc-sync --check
dfc-sync
```

`--setup` 仅保存巨懂车浏览器登录态。运行同步前需设置 `APP_KEY` 环境变量。

## 中国大陆安装与可选诊断工具

生产同步只需要 Python Playwright，无需安装 `playwright-cli`：

```bash
pip install -U dfc-customer-sync -i https://pypi.tuna.tsinghua.edu.cn/simple
dfc-sync --install-cn
dfc-sync --setup
```

只有需要排查页面改版、定位器、请求或控制台问题的用户，才安装可选 CLI。该命令同时使用国内 npm 与 Playwright 浏览器镜像：

```bash
dfc-sync --install-cli-cn
```

安装 CLI 需要 Node.js 和 npm；缺少它们不会影响正常同步。

## 旧用户更新

```bash
pip install -U dfc-customer-sync -i https://pypi.tuna.tsinghua.edu.cn/simple
dfc-sync --install-cn
dfc-sync --install-skill
dfc-sync --check
```

`--install-skill` 只更新技能说明，不升级 Python 包或浏览器。只有旧 zip 版本迁移、Chromium 缓存损坏，或常规升级无法恢复时，才使用 `dfc-sync --repair-cn`。

## Agent 技能安装

安装 PyPI 包后运行：

```bash
dfc-sync --install-skill
```

安装器会优先更新已安装的 `dfc-customer-sync` 技能；首次安装会写入检测到的
兼容技能目录。检测到用户自行修改的 `SKILL.md` 时不会覆盖，需显式使用
`dfc-sync --install-skill --force`，旧文件会自动备份。多个已安装目录时，使用
`dfc-sync --install-skill --skill-dir /path/to/skills` 指定目标。
