Udesk 效率工具

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

📖 在线说明 / 更新日志：https://turingblog.org/showcase/udesk 安装脚本跑完也会自动打印本次更新内容。

一分钟上手

装完先记住三个键就够了：Alt+S 填客户和分类、Alt+I 让 AI 写整张单、Alt+G 打开 AI 助手侧栏。

一、安装 / 更新

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

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

用 PowerShell 装：完整五步

不熟悉 PowerShell 也没关系，照着下面五步做即可：

1. 打开 PowerShell

   按 Win + R，输入 powershell，回车。（不需要「以管理员身份运行」）

2. 复制安装命令

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

3. 粘贴并回车

   在 PowerShell 窗口里点右键即为粘贴（Ctrl+V 在老版本里不一定管用），然后回车。

4. 等它跑完

   脚本会下载、解压、部署，并自动打开浏览器的扩展页。装了 Chrome + Edge 会先让你输编号选一个 —— 没输之前不会有下一步动静，这是正常的。

5. 首次安装：在扩展页手动加载一次

   开开发者模式 → 点**「加载已解压的扩展程序」** → 在文件框里 Ctrl+V 粘贴目录（脚本已复制好）→ 确定。更新时不需要这一步，只需点扩展卡片上的刷新图标。

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

复制整条粘贴到 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，装了多个会让你选）。

更新后让新版生效

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

二、卸载

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 页面上填入工号即可。
• 工号会与你的 Udesk 登录姓名自动绑定（首次登录锁定），别人即使输入你的工号，在他自己的账户下也拿不到你的授权，防止冒用。

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

功能分两档

⚠ AI 功能虽是普惠档，但需要你自己填一次 API 密钥（见「五、开通 AI 功能」）。扩展不再内置公用密钥，每人用自己的额度、各记各账。

⚠ 知识库检索自 v1.18.3 起单独授权：它装的是集团内部运维/业务资料，与「能不能调 AI」是两件事。没开通时侧栏不会提示、只是不召回内部资料；想确认自己有没有开通，看设置页 →「通用设置」→ 功能开通状态那张卡。

四、快捷键速览

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

五、开通 AI 功能（必做一次）

AI 相关的一切（Alt+I 录单、Alt+G 侧栏、批量补录、拟回复）都需要你自己的 WorkBuddy 访问密钥。扩展不内置公用密钥——每人用自己的额度、用量各记各账。

申请密钥

1. 打开 https://www.workbuddy.cn/profile/keys，选 「手机号验证码登录」。 ⚠ 手机号必须与你企业微信绑定的手机号一致，否则关联不到旗舰版订阅。
2. 登录后确认当前是 旗舰版（只有旗舰版开放 API 管理）。
3. 在 API 管理 页点 「创建访问密钥」，填一个能认出来的名称（如 udesk-ext）。
4. 密钥只在创建时完整显示一次（ck_ 开头）—— 立刻复制保存。关掉弹窗就看不全了，只能删掉重建。
5. 打开扩展 设置页 → 智能设置，粘贴进「API Key」。

安全提示：密钥等同于你的账号额度，别提交到代码仓库、别发聊天群。怀疑泄露就去 API 管理页删掉重建。

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

可选：热线通话转写

想让 Alt+I 在热线通话页读录音（而不只是读 IM 文字），有两条路，在「智能设置 → 辅助服务」里选：

本机宿主没装时会自动回落云端，不影响录单。两条路都关掉则热线录单退回纯手工。

API Key 存在哪

只存在你本机（chrome.storage.local），不上传、不随配置导出。选云端转写会把通话录音发给你填的那个服务商——不希望录音出内网的，用本机转写或填内网自建地址。

六、主要功能

录单相关

快捷录单：多模板（已解决 / 转单）+ 智能三级分类匹配。描述与主题模板支持占位符（{hotelname} / {hotelid} / {contact} / {problem}），由管理员统一下发、全员一致。

客户字段自动填（Alt+S）：描述里写酒店编码或名称即可自动填「客户」。查不到时按下面的顺序逐级兜底，任一步查得到就填入客户字段：

1. 历史工单 —— 翻这位客户以前的单
2. IRM —— PMS 编码 H800482 → udesk 门店码
3. SSO —— 手机号 / 工号 / 姓名 → 所属门店

这三个系统只复用你浏览器里已登录的身份，扩展从不接触账号密码。查询进度和登录状态显示在「描述」右侧的状态条上。

酒店交叉校验（v1.18.3 新增）：历史工单命中后，再拿 SSO 的组织信息比对一次。

治的是一个不会报错的错：报障人调岗后，历史工单里还是旧酒店，而历史优先级最高、命中就不再查别的 —— 于是过期值稳定胜出，且没有任何地方会发现它过期了。现在两源都跑，结论显示在状态条上：

⚠ 校验只给结论、不改字段。客户字段提交后不可改，所以「判得准不准」与「要不要照着填」被刻意分开。

用户联系方式（v1.18.3 改）：热线来电号码会先查一次 SSO —— 命中就标 【SSO手机号】（顺带知道报障人是谁、属于哪家店），查不到退回 【来电】。门店的当前店总（姓名 / 工号 / 手机）从 IRM 取，只取在职。

查不到人时不再说「请手动填写」那种自相矛盾的话：浏览器访客标 【访客】、企微用户未登录 SSO 标 【企微·SSO未登录】（后者是可修复的 —— 你登录一下 SSO 就有号码了）。

智能分类：控件在「描述」标签右侧，一行五件套：

匹配规则由云端统一下发、全员一致。

AI 录单（Alt+I）：读当前接线对话或通话录音，自动写描述、处理结果、分类，并把报障截图一并插进描述（最多 3 张，会挑真正属于本次故障的；身份证、付款码这类不会插）。

⚠ 只填草稿、不自动提交，提交前请自己过一眼。 ⚠ 想每次打开录单页自动跑一遍？设置 →「通用设置」→ 快捷录单 → 开「进录单页自动跑 AI 录单」（默认关，每开一页烧一次额度）。

热线通话转写的三处不可靠（已在设计上绕开，也请你留意）：

会话相关

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

  v1.18.3 新增「兜底等待」：管理员可设一个等待时长（如 10 秒）。设了之后，客户进线不再立刻自动回 —— 这段时间里你自己回了，机器就不再发；一直没人回才由扩展兜底。等待时长由管理员统一下发，默认 0 = 维持立即发。

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

  会话时长（秒表）自 v1.18.3 起可单独开关 —— 它显示这个会话已经进行了多久（12m / 1h20m），并随时间由灰→黄→橙→红升温。以前它和「已回复/未回复」共用一个开关，想关秒表就得连状态标一起关掉。

AI 助手（Alt+G 侧栏）

⚠ 对客户发送消息永远需要人工确认，AI 不会自己发出去。

其他

• 监控看板（高级）：热线 / IM / 工单实时看板，含占用率与健康度提示。
• 知识库（高级，v1.18.3 起单独授权）：云端检索，管理员改一次全员立刻生效，你什么都不用配。已内化进 Alt+G 侧栏，提问时自动召回。

七、设置页

按 Alt+` 打开，或在工作台面板点「完整设置」。共 7 个标签，按「你会不会去动它」分组：

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

八、常见问题

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

Q：AI 功能提示「请填写访问密钥」？ A：扩展不再内置公用密钥，需你自己申请一次，见「五、开通 AI 功能」。

Q：装的时候，命令跑到一半就不动了？ A：多半是停在选浏览器那一步（装了 Chrome + Edge 时会让你输编号）。输入编号回车即可继续 —— 在那之前扩展页和文件夹都不会弹出来，这是设计如此。

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

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

Q：填了工号但监控看板 / 知识库用不了？ A：这两个是高级功能，需管理员按工号授权。在设置页 →「通用设置」→ 功能开通状态能看到自己开通了哪些。

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

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

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

九、支持

• 在线说明 / 更新记录：https://turingblog.org/showcase/udesk
• 适用站点：https://jinjianghotels.udesk.cn
• 支持浏览器：Chrome / Edge（Chromium 内核，建议较新版本）