展开本页目录
开始前准备什么
- 准备自己有权使用的合成练习资料，不上传他人的录音或私密内容。
- 按官方文档核对当前平台、版本与套餐；本轮目标产品操作未执行，练习文件可离线查看。
- 练习包提供口述脚本、规则与验收数据，不附目标工具生成录音。按录音说明自行录制有权使用的输入，并在运行后保存实际音频。
- 准备三个边界文件名
- 核对上下文能力
- 在支持的IDE编辑区域口述
- 单独测试不合格名称
- 换到IDE终端做负例
- 隔离词典与上下文干扰
- 归档文件引用证据
1. 准备三个边界文件名
在自有练习项目创建report.ts、draft notes.md和2items.ts，给每个文件写不同标题。文件名的空格和首字符故意不同，用于区分识别条件。
2. 核对上下文能力
查看Context Awareness开关和平台范围，在Mac核对必要的辅助功能权限。练习仅使用虚构代码，避免让测试上下文带入真实密钥或客户数据。
3. 在支持的IDE编辑区域口述
切到当前支持的Cursor或Windsurf输入区域，说出report.ts完整扩展名。保留输入区域截图，识别成文件引用与仅打出文字是两个结果。
4. 单独测试不合格名称
分别口述含空格和数字开头的名称，记录是否仍为普通文字。不要通过手工点文件把链接补上，再宣称系统自动识别成功。
5. 换到IDE终端做负例
在终端说同一文件名，比较与编辑区域的行为。官方列有终端不触发文件标签，负例只用于界定范围，不要求终端达到同一输出。
6. 隔离词典与上下文干扰
如果语音经过词典替换，另开一轮不包含该替换的控制样本。官方说明词典替换可能阻止文件标签，先把两种机制分开。
7. 归档文件引用证据
保存文件清单、原始口述、标签截图与失败场景记录。没有实际运行Flow时，练习目录只证明文件存在，不证明语音引用已建立。
下载本课材料并开始操作
练习包包含本课的具体输入、可编辑数据、正反样例与七步说明。index.html 可离线查看原件和验收参考，actual-results.csv 用于记录你实际操作后的结果。
怎样确认已经完成
- 合格文件名的真实标签与普通文字能分辨。
- 终端、空格文件名和数字开头的负例保留原样记录。
- 只用自有代码页面，记录上下文开关与权限范围。
常见问题
Wispr说出文件名为什么没有变成代码引用？
文件名需带扩展名、以字母开头且没有空格，还要处于支持的IDE区域并启用相关设置。终端或词典替换过的转录可能不触发文件标签。
看到report.ts几个字就算引用成功吗？
不算。需要核对它是否真是可指向对应文件的标签；纯文本、手工点击补链和自动关联应分别记录。