Code Voice Tutor
一个 VS Code 内的中文 AI 代码老师原型。它会读取当前编辑器上下文、选中代码和工作区内的相关文件，然后用 OpenAI-compatible API 进行文字讲解，并在 Webview 里自动朗读回复。
当前能力
Code Voice Tutor: Open Chat：打开导师聊天面板。Code Voice Tutor: Explain Current File：从当前文件开始逐步讲解。Code Voice Tutor: Explain Selection：解释当前选中的代码；没有选区时解释光标附近代码。Code Voice Tutor: Set API Key：保存 API Key 到 VS Code SecretStorage。- 自动收集当前文件、光标行、选区和轻量相关文件上下文。
- Webview 内使用浏览器
speechSynthesis 自动朗读 AI 回复。
- Webview 内提供实验性语音输入按钮，取决于当前 VS Code Webview/系统是否支持 Web Speech Recognition。
小白使用方式
cd D:\my-vscode-plugins\my-first-extension
npm install
code .
在 VS Code 中按 F5，会打开一个新的调试窗口。
在新的调试窗口中，插件会自动弹出学习面板。
- 打开一个你想学习的代码项目或代码文件。
- 点 VS Code 左侧活动栏的
代码老师。
- 想让 AI 自己看项目，就点
自动读项目。
- 想讲当前文件或选区，就点
一键开始，或者点底部状态栏的 一键学代码。
使用规则很简单：
- 你选中一段代码，它就解释选区。
- 你不选代码，它就讲当前文件。
- 你点
自动读项目，它会扫描项目结构、读取关键文件、先给学习路线再讲第一点。
- 你可以把文件拖到聊天面板里，插件会尽量匹配当前工作区里的真实文件并显示为上下文标签。
- 你也可以点
@ 当前文件 或 # 选区，上下文会显示成类似 PersonProxy.java、PersonProxy.java 10-15。
- AI 回复会自动朗读。
- 原型版已经内置默认模型密钥，不需要用户导入。
右侧停靠
VS Code 不允许扩展强制进入其他插件的聊天容器，但可以手动把它放到右侧：
- 打开左侧
代码老师。
- 右键活动栏或标题栏，选择把侧边栏/辅助栏移动到右侧。
- 也可以拖动
代码老师 视图标题到右侧辅助栏。
当前版本的命令和状态栏入口会优先聚焦侧边栏视图，不再主动打开中央编辑器标签。
也可以按 Ctrl+Shift+P 搜索中文命令：
代码语音老师：一键开始学习代码语音老师：自动读取项目代码语音老师：打开学习面板代码语音老师：讲解当前文件代码语音老师：解释选中代码
如果不想启动时自动弹出，可以关闭：
{
"codeVoiceTutor.openOnStartup": false
}
API 配置
默认使用讯飞星火代码模型的 OpenAI-compatible /chat/completions 接口。
VS Code 设置项：
codeVoiceTutor.apiBaseUrl：默认 https://maas-coding-api.cn-huabei-1.xf-yun.com/v2codeVoiceTutor.model：默认 astron-code-latestcodeVoiceTutor.temperature：默认 0.2codeVoiceTutor.maxContextChars：默认 50000codeVoiceTutor.maxSearchFiles：默认 80codeVoiceTutor.autoSpeak：默认 truecodeVoiceTutor.speechLanguage：默认 zh-CNcodeVoiceTutor.speechVoice：默认 zh-CN-XiaoxiaoNeuralcodeVoiceTutor.speechRate：默认 1.05codeVoiceTutor.speechPitch：默认 1
如果使用 OpenAI 或 DeepSeek 一类兼容接口，可以改成类似：
{
"codeVoiceTutor.apiBaseUrl": "https://api.openai.com/v1",
"codeVoiceTutor.model": "gpt-4o-mini"
}
下一步计划
- 加入真正的课程状态机：等待“听懂了”后才进入下一个知识点。
- 接入更稳定的本地语音输入方案。
- 加入代码索引缓存、函数/类符号索引和调用链检索。
- 支持暂停、继续、回到刚才进度。
| |
