EditPlus/UltraEdit 配 TaoToken：settings.json 与 config.toml 骨架

1. 为什么还在用 EditPlus/UltraEdit 的人需要 AI 接入EditPlus 和 UltraEdit 是很多老开发者的“顺手兵器”启动快、占用低、正则替换强、大文件不卡。我见过不少做运维脚本、日志清洗、老项目维护的朋友主力编辑器依然是这两款。问题也很明显——它们没有内置 AI 补全写正则、写 SQL、写一段 Python 处理逻辑时还是得切浏览器、开网页对话、复制粘贴回来。这篇要解决的就是这件事不换编辑器把 AI 能力接进 EditPlus/UltraEdit 的工作流。核心思路是用 TaoToken 作为统一的 Key/API 通道在编辑器里配置一个“外部工具”调用兼容 OpenAI 格式的接口把选中文本发出去、把结果拿回来。下面给出settings.json与config.toml两套可复制骨架再演示一次真实请求验证。适合谁还在用 EditPlus/UltraEdit 做文本处理、脚本编写、配置维护想加 AI 但不想迁移到 VS Code 或 JetBrains 的开发者。读完你能拿到可直接粘贴的配置、一条能跑通的验证命令以及常见报错的排查路径。2. TaoToken 前置统一 Key 与 API 通道TaoToken 在这里扮演的角色是“统一入口”。你不用为每个模型单独申请 Key、记不同域名而是拿一个 Key走同一个 API 地址按需切换模型。对 EditPlus/UltraEdit 这种通过外部工具调用的场景特别合适——配置里只写一个 endpoint 和一个 Key换模型只改一个字段。需要先准备两样东西一个 API Key在控制台的 API Keys 页面创建形如sk-开头的一串字符。创建后只显示一次建议立刻存到密码管理器。确认 API 基地址https://taotoken.net/api兼容 OpenAI 的/v1/chat/completions路径。注意Key 属于敏感凭据不要写进会提交到 Git 的配置文件。建议放在系统环境变量里配置文件中用变量引用。如果你还没创建 Key可以先去控制台生成https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。创建完顺手看一眼接入文档确认请求格式https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。3. 可复制配置settings.json 与 config.toml 骨架EditPlus 和 UltraEdit 本身不读settings.json或config.toml它们是“外部工具”配置。但很多团队会用一份 JSON/TOML 作为“配置源”再由脚本生成编辑器的用户工具项或者给命令行包装器读取。下面两套骨架就是干这个用的一份描述“调用哪个模型、走哪个地址”一份描述“编辑器里怎么触发”。3.1 settings.json 骨架通用调用配置{ provider: taotoken, base_url: https://taotoken.net/api, api_key_env: TAOTOKEN_API_KEY, default_model: claude-sonnet-4-20250514, timeout_seconds: 60, max_tokens: 2048, temperature: 0.3, editor_tools: { editplus: { menu_text: AI 处理选中文本, command: python, arguments: ai_bridge.py --mode replace --file \$(FilePath)\ --line $(CurLine), capture_output: true, initial_dir: $(FileDir) }, ultraedit: { menu_text: AI 处理选中文本, command: python, arguments: ai_bridge.py --mode replace --file \%f\ --line %l, capture_output: true } } }字段说明base_url固定为 TaoToken 的 API 地址api_key_env指向环境变量名避免明文default_model可按需替换成你账号下可用的模型editor_tools里分别给出 EditPlus 和 UltraEdit 的参数占位符写法——EditPlus 用$(FilePath)、$(CurLine)UltraEdit 用%f、%l。3.2 config.toml 骨架命令行包装器读取[provider] name taotoken base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY timeout_seconds 60 [model] default claude-sonnet-4-20250514 max_tokens 2048 temperature 0.3 [prompt] system 你是一个代码与文本处理助手。只输出处理后的结果不要解释不要加 Markdown 代码围栏。 replace_mode selection [editor] editplus_exe C:/Program Files/EditPlus/editplus.exe ultraedit_exe C:/Program Files/UltraEdit/uedit64.exe[prompt]段很关键system里明确“只输出结果”这样返回内容可以直接替换选中文本不会带一堆“好的以下是……”的废话。replace_mode selection表示只处理当前选中区域。3.3 桥接脚本 ai_bridge.py配置只是声明真正干活的是一个几十行的 Python 脚本。它读 TOML、取环境变量里的 Key、把选中文本发到 TaoToken、把返回写回文件。import os, sys, json, argparse, urllib.request, tomllib def load_cfg(pathconfig.toml): with open(path, rb) as f: return tomllib.load(f) def call_ai(cfg, text): key os.environ.get(cfg[provider][api_key_env]) if not key: sys.exit(缺少环境变量 cfg[provider][api_key_env]) url cfg[provider][base_url].rstrip(/) /v1/chat/completions body { model: cfg[model][default], max_tokens: cfg[model][max_tokens], temperature: cfg[model][temperature], messages: [ {role: system, content: cfg[prompt][system]}, {role: user, content: text}, ], } req urllib.request.Request( url, datajson.dumps(body).encode(utf-8), headers{ Content-Type: application/json, Authorization: Bearer key, }, ) with urllib.request.urlopen(req, timeoutcfg[provider][timeout_seconds]) as r: data json.loads(r.read().decode(utf-8)) return data[choices][0][message][content] if __name__ __main__: p argparse.ArgumentParser() p.add_argument(--file, requiredTrue) p.add_argument(--line, typeint, default1) p.add_argument(--mode, defaultreplace) args p.parse_args() cfg load_cfg() with open(args.file, r, encodingutf-8) as f: content f.read() result call_ai(cfg, content) if args.mode replace: with open(args.file, w, encodingutf-8) as f: f.write(result) else: print(result)把config.toml和ai_bridge.py放在同一目录设置好环境变量编辑器外部工具指向这个脚本即可。4. 验证请求一次真实调用与成功结果配置写完必须验证否则你不知道是 Key 错、地址错还是参数错。最直接的方式是先用 curl 打一发绕开编辑器。export TAOTOKEN_API_KEYsk-你的Key curl -s https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -d { model: claude-sonnet-4-20250514, max_tokens: 256, messages: [ {role: system, content: 只输出结果不要解释。}, {role: user, content: 把这段文本里的连续空格替换成单个空格abc def ghi} ] }成功时你会拿到类似结构{ id: chatcmpl-xxx, object: chat.completion, choices: [ { index: 0, message: { role: assistant, content: abc def ghi }, finish_reason: stop } ], usage: {prompt_tokens: 42, completion_tokens: 6, total_tokens: 48} }看到choices[0].message.content是干净结果说明 Key、地址、模型都通了。接着在 EditPlus 里选中一段文本按你设置的快捷键比如 Ctrl1触发外部工具观察底部输出窗口是否返回结果、文件是否被替换。UltraEdit 同理在“高级 → 用户工具”里配置后测试。如果你更想先在网页里确认模型行为可以直接用模型对话页面试同一段 prompthttps://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。网页通了再回到编辑器能排除掉一半环境问题。5. 本篇常见错排查5.1 401 Unauthorized九成是 Key 问题。检查环境变量是否真的导出echo $TAOTOKEN_API_KEY看有没有值检查 Key 是否复制完整、有没有多余空格。Windows 下用set TAOTOKEN_API_KEYsk-xxx设置后需要重启编辑器进程才能读到新变量。5.2 404 Not Found地址拼错。基地址是https://taotoken.net/api请求路径要补/v1/chat/completions。常见错误是写成/api/chat/completions漏了v1或者把基地址末尾的斜杠和路径斜杠拼成双斜杠。5.3 返回内容带解释文字systemprompt 没约束住。把[prompt]里的system改成更硬的措辞例如“只输出处理后的文本禁止任何前后缀说明”。如果模型仍加解释可以在桥接脚本里做一次后处理截取第一个代码块或去掉首行。5.4 EditPlus 参数占位符不生效EditPlus 的$(FilePath)、$(CurLine)必须写在“参数”框里不能写在“命令”框。另外“捕获输出”要勾选否则你看不到返回。UltraEdit 的%f、%l大小写敏感写错就不替换。5.5 大文件超时timeout_seconds默认 60 可能不够。处理几 MB 的日志时要么调大到 120要么在桥接脚本里先截断——只把选中区域或前 N 行发出去。别把整个大文件塞进 prompttoken 消耗和延迟都会爆炸。5.6 中文乱码Windows 下 Python 默认编码可能是 GBK。在脚本开头加sys.stdout.reconfigure(encodingutf-8)读写文件时显式指定encodingutf-8。EditPlus 的“转换器”里也要选对编码。6. 把 AI 接进日常编辑流配置跑通后实际用法可以很灵活。写正则时选中一段样例文本让 AI 生成匹配表达式清洗日志时选中乱码段落让它输出规整格式维护老配置文件时选中一段让它补注释或转成另一种格式。关键是systemprompt 要按场景切换——处理代码和处理自然语言约束不一样。如果你打算长期在 EditPlus/UltraEdit 里高频调用建议了解一下 Coding Plan按量或包月的方式更适合每天几十上百次请求的场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。Key 管理和额度查看都在控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。最后提醒一句桥接脚本里写回文件前最好先备份一份。AI 返回偶尔会截断或格式跑偏直接覆盖原文件有风险。我自己的做法是--mode replace时先写.bak确认没问题再删。