Trae CN 用豆包-1.5-pro 搭 whoosh 全文索引,Base URL 改到 TaoToken
一、先说清楚这篇要解决什么问题
很多朋友在用 Trae CN 做 Python 小项目时,习惯直接在左侧对话框里描述需求,右侧就等着模型把代码吐出来。原文作者就是这么干的:让 AI 生成 app.py,用 os.walk 遍历 docs 目录产出文档索引列表,再配上 Flask 的 / 和 /doc/<path:doc_path> 两条路由,外加 templates/index.html 里的 Jinja 循环,一个文档索引站就成型了。接着往下接 whoosh 做全文检索,用 Flask 起服务,浏览器里能打开 /doc/xxx.txt 就算跑通。
但这里有个容易被忽略的环节:模型从哪来。原文里 Trae CN 是直接调豆包-1.5-pro 出码的,如果你想让这条链路走自己的通道,就需要把接口地址换掉。这篇不动机器后面的 Flask 和 whoosh 逻辑,只补上「模型接入」这一步——先去 TaoToken 官网 注册并创建 Key,然后在 Trae CN 的自定义模型 / 供应商配置里把接口地址填成 https://taotoken.net/api。注意这里不带 /v1,也不加任何后缀,填错一个字符请求就会 404。
TaoToken 在这里只提供 Key 与 Base URL,它不参与生成文档索引、不代替 whoosh 建索引、更不替读者写 Flask 路由。换句话说,它只是把「模型请求」这一段的出口换了个地方,剩下的活儿还是 Trae CN 里的模型帮你补 whoosh 索引重建、模板分页这些片段。改完之后,你顺着原文的步骤,应该能把文档索引站一路跑到浏览器里打开 /doc/xxx.txt 为止。
二、TaoToken 前置:注册、拿 Key、认清 Base URL
在动 Trae CN 的配置之前,先把 TaoToken 这边的准备工作做完。打开 TaoToken 官网,完成注册后进入控制台,在 API Keys 页面创建一个新的 Key。这个 Key 就是你后面填进 Trae CN 的凭证,格式通常是 YOUR_API_KEY 这种占位符对应的真实字符串,创建后记得复制保存,页面刷新后一般不再完整显示。
接下来要记牢两个地址:
- API 地址:
https://taotoken.net/api,这是填进 Trae CN 供应商配置里的 Base URL,不要在后面加/v1,也不要加/chat/completions之类的后缀。很多接入失败就是因为手滑多加了路径。 - Key 地址:控制台里的 API Keys 页面,用来创建和管理你的凭证。
如果你后面还要用命令行方式跑 Claude Code 这类工具,可以顺带记一下 CLI 的装法:npm i -g @taotoken/taotoken,然后 taotoken cc -k YOUR_API_KEY -u API -m MODEL_ID。不过这篇的主线是 Trae CN 的图形界面配置,CLI 只是备选,用不上可以先跳过。
需要强调的是,TaoToken 的角色是「提供 Key 与 Base URL」,它不会帮你生成 app.py 里的 os.walk 逻辑,也不会替你写 whoosh 的索引重建代码。这些还是 Trae CN 里的模型根据你的对话来产出,只是请求的出口换到了 TaoToken 通道。
三、可复制配置:在 Trae CN 里改自定义模型
Trae CN 的模型配置入口一般在设置里的「模型」或「供应商」区域,不同版本菜单叫法略有差异,但核心就三样:接口地址、API Key、模型 ID。下面按通用步骤走一遍。
第一步,打开供应商配置。 在 Trae CN 的设置里找到自定义模型 / 供应商管理,新增一个供应商。名称可以随便填,比如 taotoken,方便自己认。
第二步,填 Base URL。 在接口地址栏填入:
https://taotoken.net/api
这里再强调一次:不要带 /v1,不要带任何后缀。填完可以先不急着保存,等 Key 也填好一起测。
第三步,填 API Key。 把你在 TaoToken 控制台创建的 Key 粘贴进去,对应占位符就是 YOUR_API_KEY。如果 Key 有多个,选一个专门给 Trae CN 用的,方便后面排查。
第四步,填模型 ID。 原文用的是豆包-1.5-pro,你在模型 ID 栏填入对应的模型标识即可。具体可用的模型 ID 以 TaoToken 控制台或接入文档里列出的为准,填错模型 ID 通常会返回模型不存在的报错。
第五步,保存并设为当前模型。 保存后在 Trae CN 的对话模型选择里切到这个新配的供应商,确保后续对话走的是 TaoToken 通道。
如果你用的是 Claude Code 这类需要 settings.json 的工具,配置思路类似,核心是把 ANTHROPIC_BASE_URL 指向 https://taotoken.net/api,ANTHROPIC_API_KEY 填你的 Key。Codex 则是改 config.toml。这篇主线是 Trae CN,其他工具的细节可以对照接入文档来。
四、验证请求:从对话出码到浏览器打开 /doc/xxx.txt
配置保存后,别急着写 whoosh,先用一句简单对话验证通道是否通。在 Trae CN 左侧对话框输入类似「帮我写一个 Flask 最小示例,返回 hello」这样的需求,看右侧是否能正常出码。如果模型正常返回,说明 Base URL 和 Key 都对了。
接着按原文的节奏走:
- 生成
app.py:让模型产出os.walk遍历docs目录、生成文档索引列表的代码,以及 Flask 的/和/doc/<path:doc_path>两条路由。 - 生成
templates/index.html:让模型写出 Jinja 循环,把doc_index渲染成链接列表。 - 补 whoosh 全文检索:继续在对话里让模型补上 whoosh 索引重建、查询接口这些片段。这一步的请求同样走 TaoToken 通道。
- 起服务验证:在终端跑
python app.py,浏览器打开http://127.0.0.1:5000/,能看到文档索引列表;点进某个文档,地址栏出现/doc/xxx.txt且内容正常显示,就算跑通。
成功的结果就是:Trae CN 里模型正常出码,Flask 服务正常启动,whoosh 检索能返回结果,浏览器里 /doc/xxx.txt 能打开。整条链路里,TaoToken 只负责模型请求这一段,Flask 和 whoosh 的逻辑没动。
五、本篇常见错排查
报错一:404 Not Found。 最常见的原因是 Base URL 填成了 https://taotoken.net/api/v1 或带了其他后缀。改回 https://taotoken.net/api 即可。
报错二:401 Unauthorized。 Key 填错、Key 已删除、或者 Key 前后多了空格。去 TaoToken 控制台的 API Keys 页面重新复制一个,粘贴时注意别带换行。
报错三:模型不存在。 模型 ID 填错。对照 TaoToken 控制台或接入文档里列出的模型 ID,确认拼写。
报错四:Trae CN 里对话没反应或超时。 先确认供应商是否已设为当前模型,再检查网络是否能正常访问 https://taotoken.net/api。如果其他工具也连不上,优先看 Key 和地址。
报错五:whoosh 索引报错。 这类报错通常和模型通道无关,是 whoosh 本身的索引目录、字段定义问题。检查索引目录是否存在、schema 字段是否和查询字段一致。
报错六:Flask 路由 404。 检查 docs 目录下是否真有 .txt 文件,以及 /doc/<path:doc_path> 的路径拼接是否正确。这属于原文逻辑范畴,和模型接入无关。
排查顺序建议:先确认模型通道通(对话能出码),再看 Flask 和 whoosh 的逻辑。别把两类问题混在一起查。
六、接下来怎么走
如果你只是想把这篇的文档索引站跑通,按上面的配置改完 Base URL 和 Key,顺着原文步骤走到浏览器能打开 /doc/xxx.txt 就够了。后续如果还要长期用 Trae CN 做编码、补 whoosh 分页、加模板样式,可以考虑用 Coding Plan 这类长期方案,把模型请求稳定下来。
需要再核对 Key 和接入细节的,去 API Keys 页面 和 接入文档 对照一遍;想先试试模型对话效果的,可以直接去 模型对话 里发一句需求看看返回。配置过程中遇到报错,优先回到 API Keys 和接入文档这两处核对,大部分问题都能定位到地址或 Key 上。




被折叠的 条评论
为什么被折叠?



