码动力客服助手 · 在线帮助

安装与启动

1. 安装：运行安装包按向导完成安装，或解压"免安装版"到任意目录。
2. 启动：双击桌面快捷方式或安装目录中的 码动力客服助手.exe，首次启动会加载本地数据与向量模型（约 100MB，仅首次较慢）。
3. 登录：在登录页使用账号密码登录；未注册可先注册账号。

账号登录与服务器选择

选择服务器（多区部署）

• 登录页顶部 🌐 服务器 下拉列出当前可用的服务器分区（如默认区、华东一区），首次使用请选择运营方指定的分区。
• 下拉切换只影响本次登录，登录成功后才会保存到本机配置；以后启动客户端自动使用上次登录的服务器。
• 已满 / 维护中的服务器不可注册新账号（下拉中带提示），但登录不受影响。

注册账号

• 填写邮箱、密码（至少 6 位）、昵称与团队名称；邮箱验证码用于验证身份，10 分钟内有效，60 秒内只能重发一次，最多验证 5 次。
• 注册成功后自动创建您的专属团队，并赠送 7 天会员 + 500 积分（会员期内检索和发送不限速，积分随会员期统一失效）。
• 同一 IP 每小时最多注册 5 次，防止批量刷号。

密码找回

• 主账号：在登录页"忘记密码"流程中输入注册邮箱，获取验证码后重置密码（新密码至少 6 位）。
• 团队成员账号（由主账号添加的）：邮箱是主账号代填的、未经本人验证，若收不到验证码，请让团队主账号在「团队管理 → 成员」中为你点「重置密码」。
• 注册与找回密码共用同一套验证码规则（10 分钟有效、60 秒重发、最多 5 次验证）。

登录与登录态

• 登录使用邮箱 + 密码，无需验证码；登录状态保存在本机，但不会自动登录，每次需手动点登录。
• 登录失败保护：同一邮箱与 IP 连续失败 5 次将锁定 15 分钟，之后自动解除。
• 退出登录可在右下角 ☰ 菜单执行；切换团队账号后本地数据会清空并拉取新团队的数据，互不混淆。

界面速览

• 顶部搜索框：输入关键词回车即搜；左侧圆点按钮为 AI 语义搜索开关（就绪后自动开启），右侧 🎤 为语音输入说明入口。
• 分类标签行：顶部两排分类标签——上排 🔒 我的私有、下排 👥 团队话术；分类较多时单行只显示一部分，鼠标移入分类区停留约 1 秒自动展开全部，移出或点击其他区域自动收起；右键标签可管理分类。
• 话术列表：每条含标题、内容预览、图片缩略图与"发送"按钮；双击内容区直接发送；私有话术可拖拽排序。
• 右下角按钮：☰ 打开菜单——团队管理、订阅会员、设置▸（更换皮肤 / 系统管理 / 备份数据库）、帮助▸（官方网站 / 使用帮助 / 隐私与协议）、账号▸（退出登录 / 注销账号）；📁 打开文件管理。
• 状态栏：底部显示当前用户、团队剩余积分；积分用完时显示限速通道提示并可点击直达订阅。

第一次使用

1. 在"话术管理"中新建分类（如：售前咨询、物流售后）。
2. 在分类下添加常用话术，可为话术配置多个变体（同一意思的不同表述），提升语义命中率。
3. 打开"窗口跟随"，把需要吸附的目标程序（如千牛、微信）加入目标进程列表。
4. 在搜索框输入顾客提问，选择命中话术，点击"发送"填充到客服窗口。

话术管理

• 入口：主界面话术列表右键即可增删改；系统管理 → 分类管理 / 话术管理可批量维护（搜索、批量删除、拖拽排序、重建语义索引）。
• 分类：分团队公共（👥）与我的私有（🔒，仅自己可见）两类；新建分类可勾选"私密分类"。删除分类时，分类下有话术则禁止删除。
• 编辑话术：支持文本与图片（图文混排，无加粗、颜色等富文本格式），可 Ctrl+V 粘贴图片、拖拽图片或点按钮插入（图片自动压缩到 300KB 内上传）；标签用逗号分隔；变体问题一行一条；还可用「用AI生成问法」按钮按话术标题自动生成顾客问法变体（去重追加，不覆盖手写内容，扣 5 积分/次）。
• 私有话术：勾选"私有"后只能挂到私有分类；挂进私有分类的话术自动变为私有；归属在创建时确定，编辑时不可更改。
• 保存快捷键：编辑话术弹窗内 Ctrl+Enter 直接保存。
• 导入导出：系统管理 → 导入导出，一键导出 JSON / CSV 备份全部话术（含私有）；导入时私有内容归当前登录账号、公共保持公共；默认跳过重复话术（同分类+同标题+同内容）。
• 删除：删除的话术会同步到云端和其他设备，不会自己恢复；话术管理页可勾选多条批量删除。

发送话术

• 前提：先到 系统管理 → 窗口跟随 添加目标聊天程序（如千牛、微信），发送时话术才会填入对应窗口。
• 一键发送：话术列表每条话术右侧都有"发送"按钮，点击后话术自动填入目标聊天窗口并回车发出；双击话术内容也能直接发送。
• 发送方式：采用"写入剪贴板 → 粘贴到目标窗口"的方式，支持文本、图片、文件与图文混排；发送期间不会打扰您正在输入的内容。
• 右键菜单：在话术上点右键，可发送、粘贴（不回车）、预览、复制、编辑或删除。
• 预览：点击话术查看详情弹窗，弹窗里也能编辑、复制或发送。
• 积分不足：搜索积分用完时，发送会根据服务端负载情况动态延迟一小段时间后自动完成，不会失败。
• 发送文件：通过右下角 📁 文件管理面板，可将常用文件一键发送到聊天窗口，详见下方"文件管理"。

文件管理

• 入口：主界面右下角 📁 按钮，点击弹出文件管理面板。
• 存放文件：将常用文件（图片、文档、表格等）放入 userfile 目录，文件列表会自动刷新（首次打开面板会自动创建该目录）。点击面板底部的链接可直接打开此目录。
• 搜索：面板顶部搜索框可按文件名快速定位。
• 发送：每条文件右侧有"发送"按钮，点击后文件自动发送到目标聊天窗口。
• 删除：点击"删除"按钮，确认后文件移入系统回收站（可还原），不会永久删除。

语义搜索

• 开启：搜索框旁的点状按钮（AI 语义搜索），模型就绪后自动开启，也可手动开关。
• 效果：不记得关键词也能按"意思"找到话术——比如搜"怎么跟客户道歉"能匹配到道歉类话术；结果按相关度排序，相关度 ≥0.8 的结果排在上段，并带「AI」徽标。
• 没搜到时：如果全部结果相关度都低于 0.8，会显示"✨ 新增这个问题的话术"按钮，一键把搜索词预填为话术标题，方便您沉淀新话术。
• 模型：本地 AI 模型随安装包提供，编码检索全在本机、不联网；话术内容仅同步到团队云端。返回条数由服务端配置。
• 异常兜底：模型加载中或异常时自动回退为关键词检索，不影响使用。

窗口跟随

• 在 系统管理 → 窗口跟随 添加目标聊天程序（如 aliworkbench.exe 千牛、微信、QQ），可加多个——跟随进程完全由你自行添加配置，不写死、不限于预置列表，任何软件窗口（客服系统、聊天工具、网页等）想跟谁就加谁；也可以点 🎯 抓取进程名，按住 Alt + 鼠标左键 点击目标窗口即自动识别进程名（普通点击不会触发）。
• 添加后话术库窗口自动吸附到目标窗口（支持右侧 / 底部 / 左侧三种吸附方向），随它移动缩放，不遮挡聊天区。
• 点话术"发送"，自动填入目标窗口输入框并回车，光标停在目标窗口。
• 发送定位点（可选）：点「📍 录制定位」，15 秒内按住 Alt + 鼠标左键 点击目标窗口的消息输入框（如千牛输入框），以后发送话术会自动先聚焦该输入框再粘贴回车；定位点与跟随进程绑定，可随时清除，未录制则用默认聚焦位置。
• 窗口跟随仅对已添加的目标进程生效；自动抓取平台消息并搜索开关也在本页配置（见"平台消息抓取"）。

划词捕获与悬浮球

• 仅在你配置的目标聊天窗口（系统管理 → 窗口跟随中添加的进程，如千牛、京东咚咚、微信、QQ 等）内，用鼠标选中一段文字并松开，屏幕会弹出悬浮球。
• 点击悬浮球，主窗口自动唤起并把选中文字填入搜索框发起搜索。
• 悬浮球 3 秒未点击自动隐藏；主窗口获得焦点时也会收起。

语音输入

• 用法：把鼠标指针放到要输入文字的地方 → 按住触发键 → 说话 → 松开，自动转为文字输入到光标所在窗口（任意窗口都支持，不限于目标进程）。
• 触发键：系统管理 → 语音输入可切换，四个选项：Ctrl+Win（默认）、鼠标中键（按住滚轮说话，免键盘）、Ctrl+鼠标左键、Ctrl+Alt。若与其他软件快捷键冲突可换一组。
• 语音开关：点击主页 🎤 话筒按钮，弹窗内可一键开启/关闭语音功能；也可在 系统管理 → 语音输入 中切换。关闭后不加载语音识别模型（省约 232MB 内存），快捷键与语音识别均不可用，重新开启立即恢复。
• 静音门限：可调节识别灵敏度（关闭 / 低 / 中 / 高），环境嘈杂时调高可减少误识别，保存后下次录音生效。
• 语音指令（说话内容自动识别，无需额外设置）：
  • "搜索 xxx" —— 在码动力客户端内自动检索话术。
  • "xxx，发送" —— 先把 xxx 输入到光标所在窗口，再自动回车发送。
  • "回车" / "发送" —— 不输入文字，直接向光标所在窗口发送回车键。
• 自定义指令：系统管理 → 语音输入中按 指令词=回复内容 每行一条配置，说话整句命中指令词时自动输入对应回复内容。
• 剪贴板保护：语音输入采用粘贴方式写入，粘贴后自动恢复你原来的剪贴板内容，复制的东西不会被顶掉。

团队管理

• 右下角 ☰ 菜单 → 团队管理进入（仅主账号可见），含概览、成员、账单、统计、日志五个页签。
• 成员分为客服与管理员；子账号数量不限制，主账号可控制"允许成员编辑公共话术"开关。
• 话术数量不设上限（公共 + 私有都算）；团队数据云端存储，多台电脑登录同一团队账号自动共享话术。
• 订阅由团队主账号与客服均可发起，赠送积分计入团队共用余额。

平台消息抓取

• 支持主流客服平台（如千牛），顾客发来新消息时自动抓取并触发搜索，不抢焦点、不打断输入。
• 自动抓取并搜索开关默认开启（系统管理 → 窗口跟随）：抓到新消息直接搜索，同一关键词 5 秒内不重复扣费。
• 不想自动搜索时，取消勾选该开关：之后抓到的新消息会弹出悬浮球，你点击后才搜索，可避免自动扣费。

多设备数据同步

• 登录同一账号，话术与分类自动在设备间同步，无需手动操作。
• 多人同时编辑同一条话术时，以最后保存者为准，不会整体覆盖丢失。
• 私有话术只同步给你本人，团队成员看不到。
• 上传中途出错（如网络中断、服务端繁忙）时会自动重试：数据仍安全保存在本地，下次同步自动增量补传；同步按"最后修改者优先"合并，云端旧数据不会覆盖本地新内容。
• userfile 文件目录中的文件属于本地隐私数据，不会上传云端、不会自动同步；多台设备需要时请手动拷贝该目录。

服务器分区与选区

• 服务端支持多区部署（如默认区、华东一区）：同一套系统可部署多台服务器，每台服务独立的一批用户，客户端登录前先选区。
• 注册限制：服务器设定了用户容量上限，已满或维护中的区不能注册新账号（登录页下拉会标注"已满 / 维护中"）；已注册用户登录不受影响。
• 数据隔离：账号、话术、积分都在注册时选择的区内，切换服务器登录将看不到其他区的数据。
• 本机连接不上服务器时，可检查登录页选中的服务器是否为您所在的分区。

商品便签浏览器扩展

• 是什么：配套的 Chrome 浏览器扩展「商品便签工具」，在淘宝 / 天猫 / 京东 / 拼多多商品页做"商品便签"（云端团队共享），给商品记备注、促销信息、改价记录等。
• 安装：Chrome / 360 浏览器地址栏打开 chrome://extensions（360 浏览器为 se://extensions）→ 开启开发者模式 → 点"加载已解压的扩展程序"选择客户端安装目录下的 res/Extension 文件夹（两款浏览器都需先开启开发者模式）。
• 登录：打开支持的电商商品页（目前仅支持 淘宝 / 天猫 / 京东 / 拼多多 商品页；如需扩展到其他平台，请联系开发团队在服务器后台添加规则），点页面上的 「M」圆形按钮（可按住拖动位置，下次打开保持），登录面板第一行是服务器地址选择框，选择账号所在服务器（注册时选择的服务器），填好后再输入码动力客服助手的账号密码登录即可（与客户端同套账号体系，地址与 token 都保存在本机）。
• 使用：在商品页查看/新建/编辑该商品的便签；支持图文混排（最多 3 张图）、一键图文复制到聊天窗口（粘贴自动带图）、关键词搜索全部便签。
• 团队共享：便签按"平台 + 商品 ID"存储，团队内所有成员可见可编辑；支持的平台规则由管理员在后台「便签平台」页配置。

无法连接云端

• 检查服务器：登录页顶部「🌐 服务器」下拉确认选中的是您所在的分区；切换服务器后需重新登录才会生效。
• 网络：确认能访问服务器端口，防火墙/安全组放行。
• 版本不匹配：客户端与服务器版本相差过大时接口可能不兼容，请升级到一致版本。

登录异常

• 注册 / 找回密码验证码收不到：检查邮箱垃圾箱；验证码 10 分钟内有效，60 秒内只能重发一次，最多验证 5 次，超限需重新获取。
• 提示"尝试次数过多，请稍后再试"：连续登录失败 5 次会锁定 15 分钟，请稍后再试；密码错误可走"忘记密码"重置。
• 提示登录已过期：令牌 7 天有效，过期重新登录即可；如反复过期请检查本机系统时间。
• 提示"服务器内部错误"：多发生在服务端数据库重启恢复的瞬间，稍等几秒重试即可；本机部署可查看服务端状态确认。
• 登录后界面加载慢：登录本身已即时返回，首次登录后的数据同步、向量重建在后台进行，界面会自动刷新，无需等待。
• 换了服务器登不上：确认该服务器的运营方给您的分区；不同分区的账号数据互相独立。

语义搜索不可用

• 模型加载失败：多发生在内存不足的机器，worker 会自动重启（最多 3 次）并降级为关键词检索，不影响使用。
• 一直未就绪：可尝试重启客户端；确认磁盘剩余空间充足（模型缓存约需 300MB）。
• 低内存机器建议：关闭无关程序释放内存，或增大系统虚拟内存。

话术同步丢失

• 确认已登录：未登录时本地修改不会推送云端，登录后自动补齐。
• 重启客户端：部分客户端代码变更需重启才生效，改动前请重启确认版本。
• 冲突处理：两台设备同时编辑同一条话术时按时间戳合并，若被他方覆盖可在团队管理中查看操作日志确认改动来源。

日志与问题反馈

• 日志位置：安装目录 data/logs/app.log，超过 5MB 自动轮转保留最近 3 份。
• 反馈模板：联系管理员时请附带：操作步骤、现象描述、日志文件、客户端版本（帮助页右上角）。

Q&A · 搜索与话术

Q&A · 同步与数据

Q&A · 计费与账户

Q&A · 其他问题

免费赠送

新注册账号自动创建团队并开通 7 天会员，赠送 500 积分。会员期内检索和发送速度没有限制；赠送积分跟随会员期统一失效，到期未用完自动作废。可直接体验全部功能。

订阅会员

按周期订阅会员即赠送对应本地检索加速积分，客户端展示以服务端返回为准，常见套餐示例：

更多套餐请以订阅页面实际展示为准，价格由团队管理员配置。

支付方式

• 支持微信扫码支付方式，下单后弹出收款码，扫码支付完成立即开通会员。
• 支付完成后系统通过异步回调 + 主动轮询双重确认开通，无需手动刷新。
• 客服与团队管理员均可发起订阅，赠送积分计入团队共用。
• 订阅赠送的积分不可兑换、不可转赠；中途停用可在「订阅会员 → 我的订单」申请退未消耗积分（会员有效期不随退款扣减，仅退未消耗部分，原路退回）。

消费规则

• 每次搜索返回消耗 1 积分；发送话术不消耗积分（文本、图片、文件发送均不扣费）。
• 消费请求带唯一请求号，重复扣费有幂等保护——同一关键词 5 秒内重复搜索、网络抖动重试都不会多扣。
• 积分为团队共用，客服与管理员搜索都从同一个池子里扣。
• 公测免费 / 活动折扣期间，扣费按服务端配置（免费则记为 0 积分，活动则按折扣后积分），消费日志仍保留。
• 积分低于预警阈值时，客户端会提示主账号及时续订会员。
• AI 生成问法：话术编辑弹窗可用「用AI生成问法」按话术标题自动生成顾客问法变体，每次扣 5 积分，每人每天限 30 次（服务端可配）。该功能有真实 AI 调用成本，不受公测免费影响。
• AI 生成额度：注册时团队获得两笔独立的赠送（数量均由运营后台配置，可调整、可关闭）——① AI 生成专用额度：独立于积分余额之外，只能用于 AI 生成；② 注册赠送积分：在积分余额里，只能用于搜索，不能用于 AI 生成。AI 专用额度用完后，继续生成会自动改扣订阅或充值获得的积分。

余额查询

在右下角 ☰ 菜单进入订阅会员，或在团队管理 → 账单页，可查看团队剩余积分、消费明细与订阅记录。