# 3Chat 私域客户运营

[中文](README.md) · [English](README.en.md)

3Chat 私域客户运营是面向 DeepSeek Harness 的开源插件。通过微信、企业微信、小红书、抖音等已连接渠道查询、筛选客户。向单个或批量客户定向发送个性化消息。客户产生回复后，已配置的 3Chat Agent 可接续上下文，提供 7×24 小时自主接待，持续完成需求沟通、产品答疑、异议处理和购买引导，帮助商家将客户洞察转化为真实触达和成交机会。

## 从客户洞察到下一轮沟通

例如，你想重新联系最近咨询过的客户：

1. **找到客户**：描述时间范围和筛选条件，查看客户名单及最近沟通上下文。
2. **准备跟进**：让 DeepSeek Harness 总结客户关心的问题，结合你提供的产品资料和活动素材拟定消息。
3. **确认触达**：核对收件人、发送账号、渠道、正文和附件后发送；批量发送可继续查询任务进度及逐项结果。
4. **接待回复**：客户回到已连接渠道后，由该渠道已配置的 3Chat Agent 按知识和业务规则接待，必要时转交人工。

你得到的是可继续行动的客户分析、消息草稿和发送结果。成交、预约等业务结果仍需结合实际业务记录判断。

## 三方如何配合

| 角色 | 负责什么 |
|---|---|
| DeepSeek Harness | 理解目标、读取客户上下文、分析问题、生成草稿，并编排插件工具。 |
| 本插件 | 将 3Chat 的客户、会话、群、附件和消息能力接入 DSH，处理授权与调用。 |
| 3Chat 平台与 Agent | 提供客户数据和渠道执行；在 3Chat 中预先配置的 Agent 负责回复接待。 |

**接通插件前，先在 3Chat 中准备好组织／空间、渠道及 Agent 回复能力。** 插件授权与客户回复接待是两个步骤，详细准备方法见[使用指南](docs/usage.md)。

## 试着说一句

> 我昨天有哪些新客户？

> 给林女士拟一条跟进信息

> 把这张活动图片和介绍，发给张先生

以上分别展示查询、拟稿和发送。拟稿后可继续调整；发送时先确认目标客户和最终内容。同名客户由你选择，批次结果可在同一对话中继续查询。

## 开始使用

需要官方 0.2.1-rc.2 或更新版本 [**DeepSeek Harness**](https://www.deepseek.com/harness/) 和具有客户查询、渠道发送权限的 **3Chat 组织账号**。

1. 在 [3Chat 国内站](https://www.3chatai.cn/) 准备业务空间、连接渠道；需要自主接待时，配置该渠道的 Agent、知识和转人工规则。
2. 打开 DSH「插件 → 添加插件」，粘贴[仓库完整地址](https://github.com/3ChatAI-NCT/3chatai-deepseek-harness-plugin)，安装后启用：

   ```text
   https://github.com/3ChatAI-NCT/3chatai-deepseek-harness-plugin
   ```
3. 打开“3Chat 私域客户运营”，点击“连接 3Chat”，在浏览器登录目标组织账号并授权。
4. 返回对话，先查询一个已知客户，再准备一条跟进草稿。

在「插件 → 添加插件」中输入上述仓库地址，即可安装 3Chat 插件。启用并完成账号授权后，即可在 DeepSeek Harness 对话中使用客户运营功能。升级时先卸载，再粘贴同一地址安装。也可使用 [Release 安装包](https://github.com/3ChatAI-NCT/3chatai-deepseek-harness-plugin/releases/latest/download/3chat-customer-growth.tgz)。自行构建见[开发说明](docs/development.md)。

插件随 DSH 界面语言选择服务：中文连接国内服务，其他语言连接海外服务；两端分别授权。上传和发送还需通过 DSH 的本次执行确认。客户与渠道可见范围遵循组织授权。

## 进一步使用

- [使用指南](docs/usage.md)：空间与回复能力准备、完整跟进示例、连接与发送常见问题。
- [开发说明](docs/development.md)：源码构建、宿主兼容范围、工具接口和社区收录准备。

当前插件提供客户／会话／群查询、上下文读取、附件上传、单发与批量发送，以及批次状态查询。品牌库、定时活动、持续跟进任务控制和收入归因属于更广的产品规划；本插件的现有工具范围见开发说明。

## 反馈与许可

问题和建议请提交到 [Issues](https://github.com/3ChatAI-NCT/3chatai-deepseek-harness-plugin/issues)，附上复现步骤、DSH 环境和去除客户信息后的错误提示。开发贡献请先阅读开发说明。

[Apache-2.0](LICENSE)。安装包包含所打包依赖的许可声明。