1. 右键“新建文本”消失,先别急着重装系统
Windows 桌面右键菜单里的“新建 -> 文本文档”突然没了,这事我遇到过不止一次。表现很典型:右键空白处,菜单里“新建”还在,但展开后只剩“文件夹”和“快捷方式”,原本的“文本文档”凭空消失。很多人第一反应是系统坏了,甚至想重装,其实绝大多数情况只是注册表里.txt关联的ShellNew键值被删了。
为什么会这样?市面上不少“系统优化”“右键菜单清理”“注册表瘦身”类工具,为了追求“干净”,会把它们认为冗余的 ShellNew 项一并清掉。.txt的 ShellNew 一旦被删,资源管理器就不知道“新建文本”该调用哪个模板,菜单项自然不显示。这不是文件损坏,也不是权限问题,纯粹是注册表缺了骨架。
这篇内容适合三类人:一是被优化工具误删 ShellNew 键值的普通用户;二是想搞懂右键“新建”菜单背后注册表结构的人;三是希望顺手把 AI 编码工具的 API 通道也配好的开发者。我会先给出可直接双击导入的.reg恢复文件,再讲清楚每个键值的作用,最后演示在 Cline 里通过settings.json把 TaoToken 的统一 Key 和 API 通道配好,并用“右键新建文本文档”来验证整条链路是否生效。全程可复制、可跟做,不需要重装系统。
2. 恢复前先认识 TaoToken 与统一 API 通道
在动手改注册表之前,先把后面要用到的 API 通道说清楚,避免你配到一半卡住。TaoToken 是一个面向开发者的模型 API 聚合入口,官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,API 根地址是 https://taotoken.net/api 。它的核心价值是:你只需要申请一个统一 Key,就能在 Cline、Cursor、各类支持 OpenAI 兼容协议的工具里调用不同模型,不用为每个模型单独维护一套密钥和地址。
对本文场景来说,TaoToken 扮演两个角色。第一,它是“验证工具”——修完注册表后,我会用 Cline 发一次真实请求,确认 API 通道是通的,这样你就知道自己的配置没白做。第二,它是“长期通道”——如果你平时用 Cline 做编码或 Agent 任务,把 TaoToken 配进settings.json后,后续换模型只改一个字段,不用动 Key。
需要提前准备的东西只有两样:一个 TaoToken 的 API Key,以及本机的 Cline 插件(VS Code 里搜 Cline 安装即可)。Key 的获取入口在控制台的 API Keys 页面,地址是 https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。拿到 Key 后先放一边,我们先把注册表修好。
注意:注册表操作有风险,导入前建议先导出备份。文中的
.reg文件只涉及.txt关联,不会影响其他文件类型。
3. 可复制的 .reg 恢复文件与注册表路径骨架
3.1 直接导入的恢复文件
把下面这段内容保存为restore_txt_shellnew.reg,注意编码选 ANSI 或 UTF-16 LE(Windows 记事本另存为时选“ANSI”最稳),然后双击导入,弹窗确认即可。
Windows Registry Editor Version 5.00 [HKEY_CLASSES_ROOT\.txt] @="txtfile" "PerceivedType"="text" "Content Type"="text/plain" [HKEY_CLASSES_ROOT\.txt\OpenWithList] [HKEY_CLASSES_ROOT\.txt\OpenWithList\notepad.exe] [HKEY_CLASSES_ROOT\.txt\PersistentHandler] @="{5e941d80-bf96-11cd-b579-08002b30bfeb}" [HKEY_CLASSES_ROOT\.txt\ShellNew] "FileName"="C:\\WINDOWS\\NOTEPAD.EXE"导入后不需要重启,直接去桌面右键测试。如果“新建 -> 文本文档”回来了,说明修复成功。如果还没回来,往下看路径骨架和排查部分。
3.2 注册表路径骨架逐项说明
上面这段.reg实际写了四组键,我逐个拆开讲,方便你理解而不是死记。
第一组是HKEY_CLASSES_ROOT\.txt,它定义.txt这个扩展名的基础属性。@="txtfile"表示.txt默认关联到txtfile这个 ProgID;PerceivedType和Content Type告诉系统这是纯文本,影响搜索索引和预览行为。有些优化工具会把@值改错或删掉,导致关联断裂。
第二组是OpenWithList,它决定“打开方式”列表里出现哪些程序。这里写入notepad.exe,保证记事本在候选列表里。这一项缺失不会直接导致“新建文本”消失,但会影响右键“打开方式”。
第三组是PersistentHandler,它的 GUID{5e941d80-bf96-11cd-b579-08002b30bfeb}是 Windows 内置的文本持久化处理器,负责文件内容识别。删了它,.txt可能被当成未知类型。
第四组也是最关键的ShellNew,FileName指向C:\WINDOWS\NOTEPAD.EXE。资源管理器看到这个键,才会在“新建”菜单里生成“文本文档”项。优化工具误删的通常就是这一组。
3.3 手动定位与核对
如果你不想导入文件,也可以手动打开注册表编辑器(regedit),依次展开到HKEY_CLASSES_ROOT\.txt\ShellNew,右键新建“字符串值”,名称填FileName,数值填C:\WINDOWS\NOTEPAD.EXE。改完按 F5 刷新,再测右键菜单。
提示:64 位系统上,
HKEY_CLASSES_ROOT是HKEY_LOCAL_MACHINE\Software\Classes和HKEY_CURRENT_USER\Software\Classes的合并视图。如果你在 HKCR 下改不动,可以到HKEY_CURRENT_USER\Software\Classes\.txt\ShellNew下补同样的键值,优先级更高。
4. 在 Cline 的 settings.json 里配好 TaoToken 通道
注册表修好后,我们顺手把 API 通道配好,这样后面验证请求时能直接跑通。Cline 的配置入口在 VS Code 设置里,也可以直接编辑settings.json。我实测下来,用settings.json配置最清晰,字段一目了然。
打开 VS Code,按Ctrl+Shift+P,输入Preferences: Open User Settings (JSON),在打开的settings.json里加入下面这段。注意把your_taotoken_api_key换成你在控制台拿到的真实 Key。
{ "cline.apiProvider": "openai", "cline.openAiApiKey": "your_taotoken_api_key", "cline.openAiBaseUrl": "https://taotoken.net/api", "cline.openAiModelId": "gpt-4o-mini", "cline.openAiModelInfo": { "maxTokens": 8192, "contextWindow": 128000, "supportsImages": true } }几个字段的作用:apiProvider选openai,因为 TaoToken 走 OpenAI 兼容协议;openAiApiKey填统一 Key;openAiBaseUrl填https://taotoken.net/api,注意结尾不要多加/v1,Cline 会自己拼接;openAiModelId填你要用的模型名,这里以gpt-4o-mini为例,你可以换成其他支持的模型。
如果你更习惯用界面配置,也可以在 Cline 侧边栏点设置图标,在 API Provider 里选 OpenAI Compatible,Base URL 填https://taotoken.net/api,API Key 填统一 Key,Model ID 填模型名。两种方式等价,改完保存即可。
注意:Key 属于敏感信息,不要提交到 Git 仓库。如果你用 dotfiles 管理配置,建议把 Key 放到环境变量里,再用
${env:TAOTOKEN_API_KEY}引用。
5. 验证请求与右键新建文本文档实测
5.1 用 Cline 发一次真实请求
配置保存后,打开 Cline 面板,在输入框里发一句简单的话,比如“用一句话说明什么是纯文本文件”。如果配置正确,Cline 会通过 TaoToken 的通道拿到模型回复,界面上会正常流式输出。这一步验证的是 API 通道,和注册表无关,但能确认你的 Key 和 Base URL 没写错。
如果请求失败,先看 Cline 报错信息。常见的是 401(Key 错)或 404(Base URL 多写了/v1)。确认无误后,再回到注册表验证。
5.2 右键新建文本文档验证修复
回到桌面空白处,右键 -> 新建,看“文本文档”是否出现。点击它,桌面会生成一个“新建文本文档.txt”,双击能正常用记事本打开,说明.txt关联和 ShellNew 都正常。
我实测下来,导入.reg后立即生效,不需要注销或重启。如果你导入后菜单没变化,按 F5 刷新桌面,或者重启一次explorer.exe:任务管理器里找到“Windows 资源管理器”,右键重新启动。
5.3 用新建的文本文件做一次端到端确认
为了把两件事串起来,你可以新建一个test.txt,在里面写一句提示词,然后用 Cline 读取这个文件并让它基于内容回复。这样既验证了右键新建功能,又验证了 API 通道,一举两得。具体做法:在 Cline 里输入“读取桌面 test.txt 的内容,并按里面的要求回复”,Cline 会调用文件读取工具,再通过 TaoToken 通道请求模型。
6. 本篇常见错排查
6.1 导入 .reg 报“不是有效的注册表脚本”
多半是编码问题。Windows 记事本另存为时如果选了 UTF-8 带 BOM,regedit可能识别失败。改成 ANSI 或 UTF-16 LE 重新保存即可。另外确认第一行必须是Windows Registry Editor Version 5.00,不能有空行或多余字符。
6.2 导入成功但右键仍无“新建文本”
先确认你改的是当前用户的注册表视图。64 位系统上,如果只在HKEY_CLASSES_ROOT下改,可能被HKEY_CURRENT_USER\Software\Classes下的同名键覆盖。检查HKEY_CURRENT_USER\Software\Classes\.txt\ShellNew是否存在,不存在就补上。另外确认FileName指向的C:\WINDOWS\NOTEPAD.EXE真实存在,有些精简系统把记事本删了,需要改成实际存在的编辑器路径。
6.3 Cline 请求报 401 或 404
401 是 Key 无效,去控制台 API Keys 页面重新生成一个,注意复制时不要带空格。404 通常是 Base URL 写错,正确写法是https://taotoken.net/api,不要写成https://taotoken.net/api/v1或漏掉/api。如果报模型不存在,检查openAiModelId是否拼写正确,换一个支持的模型名再试。
6.4 新建的文本文档打开是乱码或关联错程序
这说明.txt的默认关联被改到了别的编辑器。检查HKEY_CLASSES_ROOT\.txt的@值是否为txtfile,以及HKEY_CLASSES_ROOT\txtfile\shell\open\command是否指向记事本。如果被优化工具改成了其他 ProgID,改回txtfile即可。
6.5 修改后其他文件类型的“新建”也消失了
这种情况通常是你误删了别的 ShellNew 键,而不是本次操作导致。.reg文件只写了.txt相关键,不会影响其他类型。如果其他类型也消失,说明之前的优化工具做了更大范围的清理,需要针对对应扩展名逐个恢复 ShellNew。
排障过程中如果涉及 API 接入问题,可以直接看接入文档,地址是 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ;需要管理 Key 就去 API Keys 页面 https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。
7. 修完注册表后,把 TaoToken 通道固定下来
注册表修复是一次性的,但 API 通道是长期要用的。如果你只是偶尔验证,用模型对话页面就够了,地址是 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,打开就能直接和模型对话,不用配任何东西。
如果你像我一样长期用 Cline 做编码和 Agent 任务,建议把 TaoToken 的配置固定到settings.json,并且用 Coding Plan 来管理用量和模型切换,入口是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。这样你换模型时只改openAiModelId一个字段,Key 和 Base URL 都不用动。
最后提醒一句:注册表改完后,建议把那份restore_txt_shellnew.reg存到网盘或 U 盘里。下次再遇到优化工具误删,双击一下就能恢复,比重新查路径快得多。我自己就把这个文件放在桌面一个叫“系统修复”的文件夹里,用了好几次了。