想让 Copilot Chat Widget 完美呈现你精心设计的中文口语化提示词？这个需求看似简单，实际操作却暗藏不少技术陷阱。许多开发团队反复尝试后，发现提示词要么被自动转换为标准书面语，要么被系统默认的“请问有什么可以帮您”所替代。问题根源在哪里？又该如何有效解决？接下来为你详细拆解。

简而言之，当你把微软 Copilot 的前端组件嵌入网页后，默认情况下，它会“自作主张”地对提示词进行语义重写。例如，你写下“查一下上季度华东区销售额”，系统可能自动改成“请您查询华东区上一季度的销售数据”。要打破这一机制，需从 SDK 版本、初始化参数、DOM 控制三个层面入手。

确认 Copilot SDK 版本与初始化配置

首先，务必使用 v1.0.0 或更高版本的 @microsoft/copilot-js-sdk。如果你仍在沿用旧版 SDK，基本无法实现目标——旧版会强制将提示词“标准化”，导致你精心设计的口语化文案面目全非。

初始化时的参数设置是关键节点。必须将 enablePromptSuggestions 设为 true，这是开启自定义提示词功能的入口。但这里有一个常见陷阱：切勿再设置 promptSuggestionsMode: 'auto'。auto 模式正是罪魁祸首，一旦启用，Copilot 后台便会启动语义重写引擎，你写的“嘿，试试问这个！”会被自动修正为“您可以询问…”。

正确做法是：直接跳过 promptSuggestionsMode 参数，让 SDK 采用默认的 'manual' 模式。只有这样，你传入的文本才能保持原样。请务必牢记，这是保留原始文本的大前提。

手动注入提示词数组并禁用自动补全

在 widget 初始化配置中，使用 prompts 字段传入提示词数据。注意格式要求非常严格——必须是纯字符串数组：

prompts: ["查一下上季度华东区销售额", "把这份周报转成PPT大纲", "用老板能听懂的话解释Transformer"]

千万不要图省事写成对象格式（例如带 id 或 type 字段）。一旦那样写，SDK 会将其视为结构化 suggestion 并启动重写机制，你的文案又会被修改掉。

与此同时，记得将 enableAutoSuggestion 设为 false。如果不关闭这个开关，Copilot 会在用户输入过程中弹出各种干扰性联想词，遮挡或覆盖你预设的提示词，导致效果大打折扣。

规避 DOM 层级劫持导致的样式/文本污染

这一步最容易忽略，但往往决定了最终效果的优劣。Copilot 组件在渲染时会自动插入一些默认提示占位符，这些占位符可能遮挡你的自定义提示词，或与之合并显示。

解决此问题有两种常用方法。

方法一：用 CSS 隐藏默认占位符

页面加载完成后，立即执行一段清理脚本：document.querySelector('.copilot-suggestion-placeholder')?.remove()。这能直接移除那些干扰元素，为你的自定义提示词腾出空间。

方法二：在挂载容器上加属性

给 Copilot widget 的挂载容器添加 data-copilot-managed="false" 属性。该属性可阻止 Copilot 注入其内部的提示逻辑，让它只响应你显式传入的 prompts 数组，从根源上避免运行时动态改写。这里有个细节：此属性必须在调用 copilot.createChatWidget() 之前就写在容器的 DOM 上，否则无效。

验证原始风格是否生效

配置完成后，如何确认真的生效了？方法很简单。

打开浏览器开发者工具，切换到 Elements 面板。然后展开 Copilot widget 的容器，找到 class 为 copilot-suggestion-bubble 的元素。检查其 innerText 是否与你传入的 prompts 数组完全一致——标点、空格、语气词（如“哈”“啦”“？”）都得一个不差才算成功。

如果你看到的是“请告诉我您想了解什么”这类泛化文案，说明问题出在：要么 enableAutoSuggestion 仍未关闭，要么 prompts 被包装成了对象格式。回去排查这两个地方，基本就能解决问题。