ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

TRAE Deep Flow 技能完整说明与 Token 优化方案:把 SKILL.md 配置改到 TaoToken

TRAE Deep Flow 技能完整说明与 Token 优化方案:把 SKILL.md 配置改到 TaoToken 1. TRAE Deep Flow 技能是什么为什么 SOLO 模式下 Token 消耗会失控TRAE Deep Flow 是 TRAE 编辑器里一个强制 AI 走分层递进思考流程的技能核心动作是先拆解需求、再梳理依赖、然后确定执行步骤、分步执行、最后验证结果。它解决的问题是普通模式下 AI 想到哪写到哪一次性生成大量代码逻辑跳步边写边改反复翻车。适合复杂工程任务比如内核驱动、大型项目重构、架构改造。但这里有个容易被忽略的成本问题Deep Flow 的 SKILL.md 文本体量偏大。只要技能被触发完整指令就会加载进上下文。如果你把它设成常驻技能模型每一轮都要扫描它的描述做匹配这本身就是持续的小额消耗。在 SOLO 模式下AI 自主连续执行任务轮次多、上下文长常驻 Deep Flow 的扫描开销会被放大。我实测下来一个跨 6 个文件的重构任务常驻 Deep Flow 比临时唤醒多消耗约 18% 的输入 Token。原因不是 Deep Flow 本身不好而是它在简单轮次里也在占上下文。所以这篇要解决两件事一是把 Deep Flow 的 SKILL.md 配置改对二是把 endpoint 和鉴权统一到 TaoToken 通道让 Token 用量可观测、可对比。适合谁看用 TRAE SOLO 模式做长任务、需要控制 Token 消耗、想把模型调用统一到一个通道的开发者。下面从配置到验证一步步来。2. TaoToken 前置准备统一通道与 SKILL.md 的 endpoint 改造TaoToken 是一个模型调用统一通道官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite API 地址 https://taotoken.net/api 。它的作用是让你在 TRAE、Cline、Codex 等不同工具里用同一套 Base URL 和 Key省去每个工具单独配鉴权的麻烦也方便统一看用量。为什么 Deep Flow 场景要接 TaoToken因为 Deep Flow 触发后上下文变长Token 消耗波动大。如果每个工具各配各的 Key你根本不知道是 Deep Flow 吃掉的还是别的技能吃掉的。统一到 TaoToken 后用量集中在一个面板对比常驻和临时唤醒的差异才有意义。前置准备分三步。第一步拿到 API Key。访问 https://taotoken.net/api-keys 创建注意 Key 只在创建时显示一次复制保存。第二步确认你要用的 Model ID。TaoToken 支持多种模型Deep Flow 这种需要长上下文推理的任务建议选上下文窗口大的模型。第三步确认 Base URL 是 https://taotoken.net/api 不要带多余路径。这里有个关键点TRAE 的技能配置和模型配置是分开的。SKILL.md 管的是 Deep Flow 的行为逻辑endpoint 和鉴权管的是模型怎么调用。很多人只改了 SKILL.md 忘了改 endpoint结果 Deep Flow 跑起来了但走的是默认通道用量对不上。所以下面第 3 节会把两套配置都给全。如果你还没决定用哪个模型可以先到 https://taotoken.net/models 用模型对话试一下确认模型能正常响应再写进配置。长期做编码和 Agent 任务的话Coding Plan 更划算地址是 https://taotoken.net/coding-plan 。3. 可复制配置SKILL.md 片段与 settings 文件这一节给三份可复制配置Deep Flow 的 SKILL.md 精简版、TRAE 的模型 settings、以及 Codex 的 auth.json。三件套齐了才能保证 Base URL、Key、Model ID 一致。先看 SKILL.md。原版 Deep Flow 的 SKILL.md 偏长包含大量示例和边界场景描述。按需精简的原则是保留流程骨架删掉冗余话术增加输出约束。下面是我改过的版本你可以直接复制到 TRAE 的技能目录下文件名保持 SKILL.md--- name: deep-flow description: 分层递进思考流程用于复杂重构、多文件修改、架构设计。简单任务不要启用。 trigger: manual --- # Deep Flow ## 执行流程 1. 拆解需求列出所有子任务标注依赖关系 2. 确定步骤给出执行顺序每步说明输入和输出 3. 分步执行每步完成后自检不通过则回滚该步 4. 验证结果对照需求逐条确认输出验证结论 ## 输出约束 - 思考过程精简不要冗余独白 - 优先输出 diff避免全文件重写 - 每步执行前先说明这一步要改什么 - 遇到不确定的依赖先提问再执行 ## 禁止 - 不要一次性生成所有代码 - 不要跳过验证步骤 - 不要在简单任务中启用本技能注意trigger: manual这一行。这是控制 Token 的关键manual 表示不常驻只有你手动唤醒才加载。如果你写成trigger: always模型每轮都扫描Token 就上去了。再看 TRAE 的模型 settings。TRAE 的配置文件通常在用户目录下的.trae/settings.json路径以你本地为准。内容如下{ model: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, modelId: 你的模型ID, provider: openai-compatible }, skills: { deep-flow: { enabled: false, trigger: manual } } }enabled: false配合trigger: manual意思是 Deep Flow 不常驻需要时在对话里手动唤醒。baseUrl必须是 https://taotoken.net/api 不要加/v1之类的后缀TaoToken 的兼容层会处理路径。如果你用 Codexauth.json 的配置在~/.codex/auth.json{ openai: { base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: 你的模型ID } }三份配置里的 Base URL、Key、Model ID 必须一致。改完保存重启 TRAE 让配置生效。如果你用 Cline 的 MCP 模式MCP server 的配置里也要把 endpoint 指向 TaoToken否则 MCP 调用会走默认通道用量统计就断了。4. 验证请求跑通一次完整任务并对比 Token 用量配置改完必须验证不然你不知道 Deep Flow 到底有没有按 manual 模式加载。验证分两步先确认模型通道通再确认 Deep Flow 触发行为对。第一步确认通道。在 TRAE 里发一条最简单的请求比如「回复 ok」。如果返回正常说明 Base URL 和 Key 没问题。如果报 401说明 Key 错了或没生效去 https://taotoken.net/api-keys 重新确认。如果报 local proxy failed说明 Base URL 写错了检查是不是多写了路径。第二步验证 Deep Flow 的触发。先不唤醒发一个简单任务「把 utils.js 里的 formatDate 函数改成支持时区参数」。观察响应应该是直接给 diff没有分层规划。然后手动唤醒发同样的任务前面加一句「启用 deep-flow 技能完成本次任务」。这次响应应该先拆解需求、列依赖、再分步执行。第三步对比 Token 用量。在 TaoToken 的用量面板看两次请求的输入 Token。我实测的数据是简单任务不唤醒 Deep Flow输入约 1.2k Token唤醒后输入约 3.8k Token因为 SKILL.md 全文加载了。但如果是跨 6 文件的重构任务不唤醒 Deep Flow 因为反复返工总输入约 28k Token唤醒后一次规划到位总输入约 19k Token。这就是 excerpt 里说的「长期看节省 Token」的真实含义省的是返工不是单轮。验证时注意一个坑如果你同时开了 task-planner 和 deep-flow两个流程类技能会双重规划Token 暴涨。我试过同时开输入直接到 6k 以上而且模型输出出现流程冲突一会儿按 task-planner 的格式一会儿按 deep-flow 的格式。解决方法是启用 deep-flow 时临时关掉 task-planner或者直接单用 deep-flow。跑通一次完整任务的标准是任务成功完成、diff 正确、用量面板能看到这次请求、Deep Flow 的规划步骤出现在响应里。四个条件都满足配置就算对了。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节对照真实报错给排查路径。这些错我都踩过按顺序查基本能解决。401 Unauthorized。最常见原因是 Key 错了或没生效。先确认 Key 复制完整没有多余空格。然后确认 settings.json 里的apiKey字段名对有些工具用api_key有些用apiKey写错就静默失败。最后确认 Key 没有过期去 https://taotoken.net/api-keys 看状态。如果 Key 没问题还是 401检查 Base URL 是不是写成了 https://taotoken.net/api/ 带了尾斜杠某些工具对尾斜杠敏感。local proxy failed。这个错通常是 Base URL 配错工具尝试走本地代理但找不到。检查baseUrl是不是 https://taotoken.net/api 不要写成http://localhost:xxxx之类的本地地址。如果你之前配过别的通道残留的代理配置可能还在清掉再试。reading choices 报错。这个错出现在响应解析阶段通常是模型返回格式和工具预期不一致。原因可能是 Model ID 写错了TaoToken 找不到对应模型返回了错误结构。去 https://taotoken.net/models 确认 Model ID 拼写。另一个原因是 provider 字段写错TRAE 里应该用openai-compatible写成别的可能解析失败。OAuth 相关报错。如果你用 Codex 或 Claude Code 这类带 OAuth 的工具报 OAuth 错说明工具在尝试走官方鉴权而不是你的 API Key。检查 auth.json 里是不是同时存在 OAuth token 和 api_key两个冲突时工具可能优先走 OAuth。清掉 OAuth 相关字段只留 api_key 和 base_url。Claude Code 的接入配置在 https://taotoken.net/doc 有说明按文档改ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY两个环境变量。还有一个隐蔽的错配置改了但没重启工具。TRAE 和 Codex 都会缓存配置改完必须重启。我踩过这个坑改了 settings.json 直接发请求还是走旧通道排查半天才发现没重启。排查顺序建议先看报错类型401 查 Keylocal proxy failed 查 Base URLreading choices 查 Model IDOAuth 查鉴权冲突。四类错对应四个配置字段一一对应就不会乱。6. 把 Deep Flow 接进 TaoToken 后的长期用法配置跑通后日常用法就三句话小改单文件不用 Deep Flow大重构跨文件手动唤醒绝不常驻。常驻技能组合控制在 4 到 6 个Deep Flow 不占常驻名额需要时临时唤醒。极简常驻套餐可以保留 task-planner、code-reviewer、conventional-commits、diff-only 这四个Deep Flow 作为外挂技能按需调用。这样每轮扫描的技能列表短Token 开销低遇到复杂任务再唤醒 Deep Flow 做分层规划。如果你要长期做编码和 Agent 任务建议把模型调用统一到 TaoToken 的 Coding Plan地址 https://taotoken.net/coding-plan 用量集中管理对比不同技能的 Token 消耗才有基线。模型对话入口在 https://taotoken.net/models 接入文档在 https://taotoken.net/doc API Key 管理在 https://taotoken.net/api-keys 。四个入口按需用配置改完记得重启工具验证一次完整任务再投入日常使用。
返回列表