🔧 一、安装扩展
- 从下载页点击立即下载，获取 ZIP 文件，解压到本地文件夹
- Chrome 浏览器地址栏输入
chrome://extensions/，回车打开扩展管理页 - 右上角开启开发者模式开关
- 点击加载已解压的扩展程序，选择刚才解压的文件夹
- 浏览器工具栏出现 KonoChat 图标，安装完成 ✅
⚠️ 每次更新扩展后，需要在扩展管理页点击刷新按钮，或删除旧版本重新加载新版本。
🔑 二、登录账号
点击工具栏 KonoChat 图标 → 弹出登录页面 → 输入账号密码登录。
登录后插件顶部会显示：
- 用户名 · 套餐类型（日付/月付）
- 今日/本月使用次数 / 配额上限
- 套餐到期时间（临近到期会显示警告）
💡 账号数据与服务器绑定，换设备登录同一账号后数据自动恢复。
🤖 三、自动回复功能
前提条件
必须先在客户管理中添加客户，插件只对已登记的客户自动回复，陌生人消息会被跳过。
开启步骤
- 打开 WhatsApp Web 或 Telegram Web，保持页面在浏览器中打开
- 点击 KonoChat 图标，打开插件弹窗
- 点击启用自动发送按钮（按钮变绿 = 已开启）
注意事项
⚠️ 自动回复期间请保持 WhatsApp/Telegram 页面在浏览器中打开（可以最小化，但不能关闭标签页）。
👥 四、客户管理
添加客户
- 点击插件图标 → 切换到客户管理标签
- 点击添加客户按钮
- 输入联系人名称（必须与聊天平台显示的名字完全一致）
- 选择客户标签，点击保存
⚠️ 客户名称区分大小写，必须与 WhatsApp/Telegram 聊天窗口顶部显示的名字完全一致，否则无法匹配。
客户标签与 AI 策略
| 标签 | AI 回复策略 |
|---|---|
| 🆕 新客户 | 友好介绍，建立信任，让对方感到欢迎 |
| 💬 沟通中 | 保持耐心热情，及时回应问题 |
| 🤝 意向客户 | 积极回应需求，提供有价值信息，促进成交 |
| ✅ 已成交 | 注重关系维护，表达感谢，适当推荐新品 |
| 😴 沉睡客户 | 热情激活关系，表达想念和关心 |
| 🥈 VIP客户 | 更正式专业，体现尊重和重视 |
| 🥇 超级VIP | 最高规格服务，专属关怀 |
客户关系分析
点击客户 → 点击🔍 分析关系（消耗 10 次配额）→ AI 深度分析：
📊
关系程度
0~5 级关系评估
💰
经济状况
消费能力与支付意愿
🎯
商机评分
0~100 分成交概率
📝
跟进建议
具体行动方案
🎭 五、人设设置
点击插件图标 → 切换到人设标签，填写以下信息：
| 字段 | 说明 | 示例 |
|---|---|---|
| 姓名 | AI 回复时使用的名字 | 小李、Alex |
| 性别 | 影响 AI 的表达方式 | 男 / 女 |
| 年龄 | 影响 AI 的语气风格 | 28 |
| 职业 | AI 会自然提及 | 外贸业务员 |
| 兴趣爱好 | 聊天时自然融入 | 旅游、美食、健身 |
| 个性特点 | 定制 AI 性格 | 开朗、幽默、细心 |
| 时区 | 影响问候语（早上好/晚上好） | UTC+8（北京）/ UTC-5（纽约） |
💡 填写越详细，AI 回复越自然真实。设置后点击保存，数据自动同步到服务器。
⚠️ 时区设置非常重要！如果你在中国服务海外客户，请设置为客户所在时区，避免在对方深夜说"早上好"。
📚 六、知识库
点击插件图标 → 切换到知识库标签。
知识库用于存储产品介绍、常见问题、话术等内容。AI 回复时会自动检索相关知识，优先使用知识库内容回答客户问题。
使用建议
- 添加产品详细介绍（规格、价格、优势）
- 添加常见问题及标准回答
- 添加促销活动信息
- 添加公司介绍、资质证明等
💡 知识库内容越丰富，AI 回答产品相关问题越准确，减少"不知道"的情况。
📋 七、模板管理
点击插件图标 → 切换到模板标签。
预设常用话术模板，可直接发送到当前聊天窗口，支持变量替换：
| 变量 | 说明 |
|---|---|
{name} | 自动替换为客户名称 |
{date} | 自动替换为当前日期 |
{time} | 自动替换为当前时间 |
💡 适合用于固定格式的开场白、报价单、跟进话术等场景。
📊 八、使用统计
点击插件图标 → 切换到统计标签，查看：
📨
消息收发量
今日/本周/本月
🤖
自动回复率
自动 vs 手动比例
⏱️
平均响应时间
回复速度统计
👥
客户活跃度
各客户互动频率
☁️ 九、云端同步
登录账号后,以下数据自动与服务器同步：
- 客户管理数据（客户信息、标签、关系分析）
- 聊天记录
- 模板数据
- 知识库内容
- 人设资料（姓名、时区等）
| 同步时机 | 说明 |
|---|---|
| 登录时 | 自动从服务器恢复所有数据 |
| 每 5 分钟 | 自动同步一次 |
| 保存操作后 | 立即触发同步 |
💡 换电脑或重装浏览器后，登录同一账号即可恢复所有数据，无需重新配置。
🏢 十、代理功能（仅代理账户）
如果您是代理账户，可以使用以下功能管理下级用户。
什么是代理账户？
代理账户是由管理员创建的特殊账户，拥有 agent_balance（代理余额），可以创建和管理下级用户，并为用户分配使用次数。
代理创建用户操作指南
- 使用代理账号登录后台管理系统（
https://www.konow.shop/admin/login.html） - 登录成功后自动跳转到代理管理面板（agent-dashboard.html）
- 在面板顶部可以看到您的当前余额（显示可用次数）
- 点击创建用户按钮，打开用户创建表单
- 填写以下信息：
- 用户名：新用户的登录用户名（3-50 字符）
- 密码：新用户的登录密码（6-100 字符）
- 分配次数：为该用户分配的使用次数（正整数）
- 系统会实时显示您的当前余额和分配后的剩余余额
- 点击提交按钮创建用户
- 创建成功后，您的余额会自动扣除相应次数，新用户获得分配的使用次数
余额扣除机制
代理创建用户时，系统会执行以下操作：
✅
验证余额
检查代理余额是否充足
➖
扣除余额
从代理余额中扣除分配次数
➕
分配次数
将次数添加到新用户的配额
🔗
建立关联
新用户自动关联到该代理
💡 余额扣除和用户创建是原子操作，要么全部成功，要么全部失败，确保数据一致性。
用户管理
在代理管理面板中，您可以：
- 查看所有您创建的用户列表
- 查看每个用户的使用情况（已用次数、剩余次数）
- 为用户追加使用次数（从您的余额中扣除）
- 查看用户的套餐状态和到期时间
常见问题解答
Q：余额不足时会发生什么？
如果您的余额少于要分配的次数，系统会拒绝创建用户，并提示"余额不足，当前余额：XX次"。您需要联系管理员为您的代理账户充值后才能继续创建用户。
Q：用户名重复怎么办？
如果输入的用户名已经存在（包括其他代理创建的用户），系统会提示"用户名已存在"。请更换一个不同的用户名重新提交。
Q：创建用户失败会扣除余额吗？
不会。系统使用数据库事务确保操作的原子性。如果创建用户失败（如用户名重复、系统错误等），余额不会被扣除，您的余额保持不变。
Q：可以为用户分配 0 次或负数吗？
不可以。分配次数必须是大于 0 的正整数。如果输入 0 或负数，系统会提示"分配次数必须是大于0的整数"。
Q：创建的用户属于什么套餐？
代理创建的用户自动设置为"免费套餐"（plan="free"），没有到期时间限制。用户的使用次数完全由您分配的 extra_quota 决定。
Q：如何为代理账户充值余额？
代理账户的余额充值由系统管理员操作。请联系管理员，告知需要充值的次数，管理员会在后台为您的账户充值。
Q：可以查看其他代理创建的用户吗？
不可以。出于数据隔离和安全考虑，每个代理只能查看和管理自己创建的用户，无法访问其他代理的用户数据。
Q：创建用户后可以修改分配的次数吗？
可以。在代理管理面板的用户列表中，点击用户的"充值"按钮，可以为该用户追加使用次数。追加的次数会从您的代理余额中扣除。
❓ 十一、常见问题
Q：为什么有消息没有自动回复？
检查该联系人是否已在客户管理中添加，且名字与聊天窗口完全一致（区分大小写）。同时确认自动发送开关已开启。
Q：自动回复延迟多久？
模拟真人打字，根据回复长度延迟 5~15 秒，避免被识别为机器人。多条消息时每条之间额外等待 2 秒。
Q：配额用完了怎么办？
联系管理员充值额外次数，或等次日（日付套餐）/ 次月（月付套餐）配额自动重置。
Q：换电脑后数据还在吗？
在新电脑安装扩展后，登录同一账号，数据会自动从服务器恢复，无需重新配置。
Q：我在中国，客户在美国，AI 会不会说错时间？
不会。在人设设置中将时区设为客户所在时区（如 UTC-5 美国东部），AI 会以该时区的本地时间聊天，早安/晚安完全匹配客户实际时间。
Q：支持哪些平台？
目前支持 WhatsApp Web（web.whatsapp.com）和 Telegram Web（web.telegram.org）。
Q：扩展更新后需要重新配置吗？
不需要。更新扩展后重新加载即可，所有数据（客户、模板、人设）都保存在服务器，登录后自动恢复。
Q：关系分析消耗 10 次配额，值得吗？
值得。AI 会分析客户的关系程度、经济状况、心理状态、商机评分（0~100分），并给出具体跟进建议，帮助你判断是否值得投入更多时间。