Udesk 效率工具

English · 中文

一个用于锦江 Udesk 工作台（jinjianghotels.udesk.cn）的 Chrome / Edge 浏览器扩展，把日常最费手的操作——录单、自动响应、会话状态标注、知识库检索、监控看板——用快捷键和智能填充一键搞定。

当前版本：1.16.3（更新日志见随包的 changelog.json，或安装/更新脚本运行后会自动打印当次更新内容）。 在线说明：https://turingblog.org/showcase/udesk

一、安装 / 更新

无需管理员权限，安装目录在 %USERPROFILE%\udesk\udesk-extension（即 C:\Users\你的用户名\udesk\udesk-extension）。首次安装和后续更新是同一条命令。

老用户注意：v1.15.0 之前装在 %USERPROFILE%\udesk-extension（少一层 udesk）。更新脚本检测到旧目录会继续用旧位置、不搬家 —— 浏览器认的是你加载时的那个绝对路径，搬走扩展就失效了。所以你的目录与新装同事不一样是正常的。

云端安装（公网，推荐大多数人）

复制整条粘贴到 PowerShell 回车即可：

irm https://ext.turinghost.org/udesk/install.ps1 | iex

内网安装（公司内网，无需公网）

iex(irm 'http://10.100.50.215/udesk/install-lan.ps1')

只有「命令提示符 (CMD)」怎么办

CMD 里没有 irm，上面的命令用不了。用下面这条等价命令——它下载一个引导器再执行，跑的是同一个安装脚本，结果完全一致：

curl -sLo "%TEMP%\ud.cmd" https://ext.turinghost.org/udesk/i.cmd && "%TEMP%\ud.cmd"

内网版把地址换成 http://10.100.50.215/udesk/i-lan.cmd 即可。

可能会弹「用户账户控制 (UAC)」窗口——这是 Windows 对「命令行启动 PowerShell」的例行确认，点**「是」**即可继续。点了「否」安装会中止并报 Access is denied。PowerShell 那条命令不会有这个弹窗，能用 PowerShell 就优先用它。

脚本会自动做什么

1. 下载最新扩展包、解压、部署到安装目录；
2. 打印本次更新内容（changelog）；
3. 把安装目录复制到剪贴板；
4. 自动打开浏览器的扩展管理页（Chrome / Edge，装了多个会让你选）。

首次安装还需手动一步（浏览器安全限制，脚本无法代劳）

在自动打开的扩展管理页上：

1. 打开右上角 「开发者模式」（Edge 在左下角，叫「开发人员模式」）；
2. 点 「加载已解压的扩展程序」，在文件框里 Ctrl+V 粘贴安装目录（脚本已复制好），确定；
3. 完成，去 Udesk 工作台刷新页面即可看到右侧机器人小球。

更新后让新版生效

浏览器不会自动重载已解压扩展，更新脚本跑完后：到扩展管理页找到「Udesk 效率工具」→ 点卡片上的 刷新/重新加载图标（或直接重启浏览器）。

你也可以在机器人小球面板里点 「检查更新」，一键复制更新命令，Win+R 粘贴运行。

二、卸载

irm https://ext.turinghost.org/udesk/uninstall.ps1 | iex

CMD 用户：

curl -sLo "%TEMP%\ud-u.cmd" https://ext.turinghost.org/udesk/u.cmd && "%TEMP%\ud-u.cmd"

脚本会删除本机安装目录并自动打开扩展页，最后你在扩展页找到「Udesk 效率工具」点 「移除」 即可彻底卸载（浏览器不允许脚本代点移除）。

三、登录 / 授权

• 只需输入工号，不需要激活码。点浏览器工具栏的扩展图标（弹窗）或机器人小球，在 Udesk 页面上填入工号即可。
• 录单、自动响应、知识库检索 装上即用（普惠功能）。
• 监控看板、AI 功能 属高级功能，由管理员在后台按工号授权后可用。
• 工号会与你的 Udesk 登录姓名自动绑定（首次登录锁定），别人即使输入你的工号，在他自己的账户下也拿不到你的授权，防止冒用。

必须先在 Udesk 页面登录状态下填写工号（工具栏弹窗在非 Udesk 页 / 未识别到坐席时会置灰禁用）。

四、快捷键速览

快捷键均可在 设置页 → 快捷键设置 中自定义，同一组合键被两个功能占用时会提示冲突。

五、主要功能

• 快捷录单：多模板（已解决 / 转单）+ 智能三级分类匹配（关键词 / 酒店品牌 / PMS 系统锚点 → 分类，可看评分明细）。描述与主题模板支持 占位符（{hotelname} / {hotelid} / {contact} / {problem}），由管理员统一下发、全员一致。

• 客户字段自动填（Alt+S）：描述里写酒店编码或名称即可自动填「客户」。查不到时会依次兜底 ——

  • 历史工单：翻这位客户以前的工单，拿其中的门店；
  • IRM：客户报的是 PMS 编码（如 H800482）时自动换算成 udesk 认的门店编码；
  • SSO：只报得出手机号 / 工号 / 姓名时，查这位同事属于哪家门店。

  主题右侧有 SSO / IRM 状态灯（绿=已登录、红=未登录，点一下去登录），查询时会转圈。这两个系统只复用你浏览器里已登录的身份，扩展从不接触账号密码。

• 智能分类：按钮在「描述」标签右侧，推荐随输入实时更新。匹配没准时可用左侧 手动搜索框 直接输系统名/关键词筛选填入（支持逗号或空格分词，如 绿云 操作）。匹配规则由云端统一下发、全员一致。

• 自动响应：新客户进线自动发送首句；快捷回复一键发送（是否邀评每条自己可控）。

• 会话状态标注：左侧会话列表每项标注「录单 · 邀评 · 状态（已回复/未回复/已超时）」，切标签页/刷新也保留缓存。

• 侧栏工具箱：Alt+G 侧栏内的「常用文案 / 常用导航 / 常用命令」三块清单，左键插入输入框、右键复制、点 ↗ 直接发送。内容由管理员统一下发，你也可以追加自己的条目。

• 监控看板（高级）：热线 / IM / 工单实时看板，含占用率与健康度提示。

• AI 助手（高级）：回复草稿、对话总结、批量处理会话与历史批量补录、知识库 AI 提炼。侧栏对话框输入 / 列出斜杠命令（/收尾 = Alt+5、/提交 = 只录单）。

• 热线通话 AI 录单（高级）：在通话记录里点某通电话的「新建工单」，按 Alt+I 会先把通话录音转成文字再生成描述与处理结果（3 分半的通话约 3 秒转完）。按钮显示 ☎️ / 🤖 告诉你这次读的是录音还是 IM 对话。 ⚠ 转写有三处不可靠，已在设计上绕开、也请留意：不区分谁在说话、数字（订单号/证件号/手机号）会串位、酒店名称几乎必错 —— 酒店以「客户」字段为准，数字请自行核对。 该功能需自行配置转写服务（见下方「接自己的 API」），默认关闭。

• 知识库：Udesk 自家 JINTELL 检索 + 内置运维文档私有库（语义检索，含图片与操作链接）。已内化进 Alt+G 侧栏对话，提问时自动召回。

• 机器人陪伴：上线问候（带天气/带伞提醒）、整点报时、久坐提醒、临近节日倒数（可在设置关闭）。

六、设置页

在机器人小球面板点「完整设置」或按 Alt+` 打开。共 6 个标签，按「你会不会去动它」分组：

• 开关都在「通用」；「个性」放你自己的语库；「云端」是只读的公司统一配置。这样一眼能分清「哪些我能改、哪些是公司统一的」。
• 标 ☁ 云端 的项由管理员统一下发、全员一致，坐席端只读；没标的就是你自己的。
• 导入 / 导出（在「个性」页）只涉及换机器该带走的个人配置，不含服务端权限参数与 API Key；已上云的内容（模板、话术、分类基线）不导出，避免旧快照与云端打架。

七、接自己的 API（可选）

AI 功能默认走内置服务，开箱即用，不需要做任何配置。以下两种情况才需要自己申请密钥：

申请 WorkBuddy 访问密钥

1. 打开 https://www.workbuddy.cn/profile/keys，选 「手机号验证码登录」。 ⚠ 手机号必须与你企业微信绑定的手机号一致，否则关联不到旗舰版订阅。
2. 登录后确认当前是 jjinn 旗舰版（只有旗舰版开放 API 管理）。
3. 在 API 管理 页点 「创建访问密钥」，填一个能认出来的名称（如 udesk-ext）。 若页面让你选可访问范围，确保勾上你要调用的模型（如 hy3）。
4. 密钥只在创建时完整显示一次 —— 立刻复制保存。关掉弹窗就看不全了，只能删掉重建。
5. 把密钥填进设置页「智能」页对应的输入框。

安全提示：密钥等同于你的账号额度，别提交到代码仓库、别发聊天群。怀疑泄露就去 API 管理页删掉重建；不同用途建议建不同的密钥，方便隔离与追溯。

官方文档：https://www.codebuddy.cn/docs/workbuddy/Overview

⚠ 用自己的 key 前请知悉

• API Key 只存在你本机（chrome.storage.local），不上传、不随配置导出。
• 转写会把通话录音发给你填的服务商。不希望录音出内网的，可以填公司内网自建的转写服务地址（任何 OpenAI 兼容的 /audio/transcriptions 接口都行）。
• 向量模型请保持默认——换成别的会导致私有知识库搜出来的内容不相关。

八、常见问题

Q：更新后功能没变化？ A：浏览器不会自动重载已解压扩展。到扩展管理页点该扩展的 刷新/重新加载 图标，或重启浏览器。

Q：CMD 里安装报 Access is denied？ A：UAC 弹窗没点「是」。重跑一次，弹窗出现时点「是」。能用 PowerShell 就优先用 PowerShell 那条命令，它不弹 UAC。

Q：中文显示乱码？ A：请使用文档里提供的完整安装命令（已强制 UTF-8）。个别老环境（Windows PowerShell 5.1）若仍乱码，改用 install.ps1 头部注释里的「按字节下载 + 显式 UTF-8 解码」兜底命令。

Q：填了工号但高级功能（监控/AI）用不了？ A：高级功能需管理员按工号授权。请联系管理员开通。

Q：某个设置项是灰的、改不了？ A：说明它由管理员云端统一下发（卡片标题会有 ☁ 云端 标记），全员一致以保证口径统一。需要调整请联系管理员。

Q：在小球面板里关掉某个功能后页面自动刷新了？ A：正常。这四个能力在页面加载时一次性挂载，改完必须刷新才能真正生效，所以面板会自动帮你刷。

Q：扩展页找不到「Udesk 效率工具」？ A：确认已完成首次「加载已解压的扩展程序」这一步。扩展目录：新装为 %USERPROFILE%\udesk\udesk-extension；v1.15.0 前装的老用户仍在 %USERPROFILE%\udesk-extension（更新不会搬家）。

九、支持

• 在线说明 / 更新记录：https://turingblog.org/showcase/udesk
• 更新日志：随包 changelog.json（安装/更新时自动打印当次内容）。
• 适用站点：https://jinjianghotels.udesk.cn
• 支持浏览器：Chrome / Edge（Chromium 内核，建议较新版本）。