dsh-trae2api
一个 DeepSeek Harness(dsh)插件:在 Desktop / Web / CLI 里直接用 Trae 企业版的模型。 只需要填一个 Trae 个人访问令牌(PAT),其它什么都不用配。
v0.3 起插件自己直连 Trae 的 llm_raw_chat 接口(和 trae2api 的 direct 模式同一套协议),
不再需要 trae2api 进程、不需要 Python、不需要 traecli。
插件相关功能界面
当选择trae模式是聊天支持显示trae额度
模型配置只需要添加traecli令牌继续使用,配置上企业额度可实时读取企业额度信息,支持tob与toc额度显示(toc无需登录企业账号即可获取额度)
支持像claude一样弹出建议弹窗
它做了什么
用你填的 PAT 向
https://api.enterprise.trae.cn/cloudide/api/v3/trae/oauth/ExchangeToken换一个 Cloud-IDE JWT(和traecli login --with-trae-pat同一套流程),快过期时自动再换。注册一个叫 Trae 的模型来源,直接走
/api/ide/v2/llm_raw_chat:流式正文、流式 thinking、 function calling、token 用量都支持。模型目录是问来的,不是写死的。Trae 会随时下线模型(2026-10-16 就一次下掉了四个), 写死的目录过期后那些模型在选择器里还在,一发就是
4023 the model is unknown。所以每次 插件启动(重载插件 = 重新拉一次)按这个顺序取:上游
POST /api/ide/v1/batch_get_detail_param—— traecli 自己也走这个,请求体就是 traecli 二进制里内置的那份。它是所有事实的权威:有哪些模型、两个后端 key、两个上下文 窗口、每个变体的输出上限、Max 是不是真的、能不能吃图、思考档位及默认档。这个接口是按通道(
function)回答的,而模型是否上架是按「配置 × 通道」判的: 只问一个通道,就看不到只在别的通道上架的模型。默认按 traecli 的原样只问chat(实测企业版只有 chat 上架模型,见下);catalogFunctions里多填的通道会单独发一次 请求问,两份取并集:- 在所有通道都标了
is_invisible_to_user的,判退役,移出目录(原本就是4023的来源); - 这边藏、那边上架的,保留并钉到上架它的那个通道(聊天请求的
function字段按钉的 来发——拿一个通道没上架的模型去问,回的就是4001); - 名册没提到的,一行不动。
- 冲突按通道优先级,保留优先通道的那份拼写(
enabledModelIds是精确匹配,改名会让已启用 的模型静默消失)。
2026-10-27 用真实 ToB 会话在
api.enterprise.trae.cn上实测过 (python3 -I tools/probe_catalog.py):solo_work_remote/solo_work_lite/solo_coder/chat_v3四个名字上游都认(各回HTTP 200和一个同名 group),但 配置数全是 0,而chat有 31 个(25 个可见)。也就是说企业席位上没有可并的东西, 多问一个通道只是每次刷新多发一次 POST——所以默认是['chat']。并集这条路留着:按通道上架的 host 把通道名填进
catalogFunctions即可。额外通道始终走 第二次请求,问不到、被拒、回空都只记一行日志跳过,chat那份目录照常用。- 在所有通道都标了
traecli 缓存
~/.trae/cli/models_cache.json—— 不走网络,但只有 traecli 跑过才会更新; 它的input_modalities对每个模型都写["text","image"](Codex fork 的常量,不是能力), 所以能不能吃图这一项取插件内置表里的标记。插件内置表(
src/trae/catalog.ts,20 个模型)—— 兜底,保证断网也有选择器。 已于 2026-10-16 和上游对齐过。
拿到的目录里:14 个模型直接按 1M 上下文(Max)提供,不再额外列小窗口的版本;剩下 6 个 用各自的标准窗口(Doubao 系 184K/200K,其余 200K)。思考档位在对话框模型菜单里选, 上游目前下发的是
light / high / extra_high(界面上的 轻 / 高 / 极高)。能解析的档位词表是五档(
low|light / medium / high / extra_high|xhigh / max,Trae 客户端 自己就是这五档,按模型灰度下发)。词表宽不等于声称宽:某个模型能选哪几档,仍然只看 上游为它下发的options,2026-10-25 实测上游只给三档,所以这是「先备好」。 请求的档位如果这个模型没有,就不发,让上游用它自己的默认——把它就近折到一个便宜档 等于给出用户没要的答案,而且没有任何迹象。本地上下文预算:
contextBudgetTokens给 dsh 规划压缩用的窗口加一个上限(0 = 用模型 自己的窗口;Max 模型想要默认窗口到 1M 之间的半步就填500000)。它只改压缩时机: 请求体里除了 Max 标记那个context_window_size之外没有窗口字段,调低预算不会让上游 按更小的窗口服务、也不会便宜,只是让 dsh 更早压缩,不至于一上来就按整个 1M 的 prompt 发。 预算真的压到窗口以下时,模型选择器那行会同时写出两个数(1M 上下文(Max) · 本地预算 500K)。想看插件现在用的是哪一份:
GET /api/dsh-trae2api/catalog会返回模型列表、来源 (upstream/cache/builtin)和取到的时间;加?refresh当场重新问一次上游。 刷新失败不会清空目录,继续用上一次拿到的那份。内置了 trae2api 里那几道兜底:工具调用历史修复(避免
4027)、把模型写成文本的<invoke>工具调用捞回来、重复塌缩截断、空回合重试、上游错误码翻译。另外,工具 schema 在出口统一归一化成 draft-4。dsh 的 schemastery 产的是 draft-3 风格 ——
required: true写在属性内部;draft-4 起改成父级的字符串数组。上游是分后端校验的: 智谱系放行,DeepSeek 系按 draft-4 严校验,回4027 … properties/X/required: invalid JSON Schema,而且tools是按批校验,一个属性不合格就整轮带工具的请求全挂。归一化是纯本地 的递归提升(items/anyOf/oneOf/allOf/$defs任意嵌套,与已有required数组去重合并),幂等:本来就是 draft-4 的 schema 原样发出。「捞回来」只认模型自己发起的那一个:代码块(
)和行内反引号里的、正文中间 后面还有正文的、以及这一轮已经有原生tool_calls的,一律当文本留在回答里。所以 讲解 XML 工具格式的回答、或模型转述别处读到的这类标记,都不会变成真实调用。recoverTextToolCalls: false可以整个关掉。
安装到 Desktop
打开一次 DeepSeek Harness Desktop(初始化
desktopprofile),然后完全退出。终端里(
dsh命令可在 Desktop 菜单「管理 dsh 命令…」注册):dsh plugin --profile desktop add /Users/leeyf/Desktop/trae/dsh-plugin也可以在侧栏 插件 → 添加插件 里填这个目录的绝对路径。
重新打开 Desktop,去 设置 → 模型 → Trae,把 PAT 填进去、保存。 卡片底部的 连接状态 会显示是否连上、有哪些模型。
然后在对话框右下角的模型菜单里选 Trae 分组下的模型,思考档位在同一个菜单里切换。 选中 Trae 模型时,模型选择器旁边还会出现一个剩余额度小徽标(详见下文「额度显示」)。
一条会话里换模型或换思考档位,下一轮会开一条新的上游会话。 上游是按
conversation_id保存服务端状态(包括use_prompt_cache_pool那份共享前缀缓存)的, 而这份状态绑死在这条会话最初用的模型上:同一个conversation_id下改model_name或reasoning_effort,上游当没改,表现就是「切了模型没反应」。所以插件 给每个(会话 × 模型 × 思考档位)各发一个conversation_id(conversationUuid,src/trae/wire.ts)。代价是换挡那一轮没有缓存可用、按完整 prompt 计费;换回原来的模型和档位,又会回到它自己那条上游会话。换挡时模型选择器旁边 会提示一下,宿主侧日志也会记一行。
卸载:dsh plugin --profile desktop remove dsh-trae2api。
用 tgz 安装(发给别人)
dsh-trae2api-0.12.1.tgz 是预构建好的包,不需要构建权限:
dsh plugin --profile desktop add ./dsh-trae2api-0.12.1.tgz
装完同样去 设置 → 模型 → Trae 填 PAT。tgz 方式下插件自带全部代码,和项目目录无关。
PAT 从哪来
在 Trae 企业版控制台生成个人访问令牌(Personal Access Token)。它只保存在 dsh 的凭据库
(~/.dsh/.credentials.yaml,凭据名默认 TRAE_PAT),不会写进任何配置文件,保存后即时生效。
如果你手上已经有一个现成的 Cloud-IDE JWT(例如
~/.trae/cli/auth.json里的access_token), 也可以直接填进 PAT 框——插件识别出是 JWT 就原样使用,过期后需要你自己更新。
配置项
界面里只有 PAT 一个字段。其余都是写死的默认值,只有在 Trae 以后改了接口、而插件还没更新时,
才需要在 profile 的 cordis.patch.yml 里覆盖 id: trae2api 这一行:
| 字段 | 默认 | 说明 |
|---|---|---|
patEnv |
TRAE_PAT |
PAT 在凭据库里的名字 |
host |
https://api.enterprise.trae.cn |
Trae 接口地址 |
shareHost |
https://trae-api-cn.mchost.guru |
分享接口地址(TRAE SOLO CN 客户端自己的写接口)。链接固定拼在 share.traecontent.cn 上;企业版与消费版是两套分享空间,互相读不到 |
clientId |
app_EMoamEEZ73f0CkXaXp7hrann |
PAT 兑换用的 OAuth client id(traecli 的) |
appId / ideVersionCode / clientVersion |
20260908 那一代 | 身份头,和模型名后缀(__dev)配对 |
catalogSource |
auto |
模型目录来源:auto = 上游 → traecli 缓存 → 内置;也可锁成 upstream / cache / builtin |
catalogFunctions |
['chat'] |
问上游要目录的通道;多填的通道单独发一次请求,问不到就只用 chat 那份。企业版实测只有 chat 上架模型,可试的名字:solo_work_remote / solo_work_lite / solo_coder / chat_v3 |
modelsCacheFile |
空 | traecli 模型缓存路径;空 = ~/.trae/cli/models_cache.json |
contextBudgetTokens |
0 |
本地上下文预算上限(token);0 = 用模型自己的窗口。只改压缩时机,不改上游服务的窗口 |
consoleEmailEnv |
TRAE_CONSOLE_EMAIL |
控制台邮箱在凭据库里的引用名(卡片写这里) |
consoleEmail |
空 | 控制台邮箱的配置兜底(凭据库里没有时才用) |
consolePasswordEnv |
TRAE_CONSOLE_PASSWORD |
控制台密码在凭据库里的引用名 |
consoleHost |
https://console.enterprise.trae.cn |
企业控制台地址 |
readTimeoutMs |
300000 |
上游两次数据之间的最长间隔 |
emptyRetries |
1 |
空回合/瞬时故障的额外重试次数 |
loopGuardChars |
600 |
重复塌缩截断的触发长度;0 关闭 |
recoverTextToolCalls |
true |
把模型写成 <invoke> 文本的工具调用恢复成真实调用;false 一律当文本留在回答里 |
suggestions |
true |
回答完后在输入框上方给出下一步选择卡片(点按钮直接发送)。设置卡片里的「下一步卡片」开关改的就是它,保存后不用重启;关掉就一张也不出,也不会多花那次生成卡片的请求 |
suggestModel |
空 | 生成建议用的模型;空 = 用刚回答的那个模型 |
suggestTimeoutMs |
20000 |
生成一轮选择卡片的最长等待 |
suggestSubagent |
true |
点卡片按钮时把这件事交给子会话(subagent 工具)去做,而不是在当前会话里直接动手;卡片下面会写明,也能当场切回当前会话。设置卡片里的「下一步卡片默认由谁来做」改的就是它,保存后不用重启 |
reportCue |
true |
把选择卡片的「显示 / 采纳」上报到 Trae 的 Cue 统计(见下文);false 关闭 |
cueUserId |
空 | 覆盖上报用的 Trae user id;空 = 环境变量 TRAE_USER_ID,再空 = 自动从 GetUserInfo 取 |
⚠️ 模型名后缀(
__dev)和ideVersionCode(20260908)是一对,必须同代。Trae 升级后若 大量模型报4023/4001,说明身份头过时了,需要更新插件(或临时改这几个字段)。 单个模型报4023基本只有一种情况:目录没刷新到。重载一次插件,或GET /api/dsh-trae2api/catalog?refresh;catalogSource: builtin锁死在内置表时也会这样, 那就换回auto。2026-10-16 被下线的是 Qwen3.7-Plus、GLM-5V-Turbo、Kimi-K2.7-Code、 DeepSeek-V4-Pro(DeepSeek-V4-Pro 正式版还在),上游把它们标成is_invisible_to_user。
额度显示
插件会向 Trae 查询剩余额度,显示在两处:
- 设置 → 模型 → Trae 卡片里有一块「剩余额度」:显示每个额度包的已用/剩余/到期, 总量、美元计费标记,以及一个「刷新」按钮。
- 对话框右下角(模型选择器旁边)有一个小徽标,选中的是 Trae 模型时显示剩余百分比, 点击即刷新;其它来源的模型选中时不显示。
实现方式:插件在宿主端通过登录态隔离开的 /api/dsh-trae2api/quota 路由供 UI 查询,
带一分钟缓存,?refresh 强制刷新。后端流程是先向企业 API 的
/cloudide/api/v3/trae/CheckLogin 问 GetAIPayHost:true 拿到真正的支付网关地址,
再查 v1(企业,basic_usage_limit)→ v2(个人,credits_limit)两条
/pay/ide_user_ent_usage 路径,哪条先通用哪条,两边字段都兼容。limit: -1 按不限量处理;
额度包 basic_usage_limit: 0(免费档)显示为「当前账号没有额度包」。
空额度包列表不再当成结论:某个地址返回 0 个额度包时会继续问剩下的地址,只有全都没有额度包
才显示「当前账号没有额度包」,并附上回答这句话的 host + path。
企业版(ToB)席位:走控制台账号
用企业版 PAT 实测过(2026-10-13):IDE 那套额度接口是 CN 个人版的,拿不到企业席位的额度。
CheckLogin不给AIPayHost(Host: ""),所以一定走兜底api.trae.cn;api.enterprise.trae.cn上两条路径都是 openresty 的裸 404,网关层就没这条路由;api.trae.cn两条都 200,但只返回这个 user_id 的个人免费档:product_type: 0、display_desc: "免费"、entitlement_id: "free_utc…",所有数字额度字段都是 0 (v2连数字字段都不返回,只剩enable_solo_*布尔开关)。
席位的真实用量记在企业租户上(JWT 里的 tob_tenant_id、tenant_id: "tob_online"),
只有企业控制台的接口给得出来(src/trae/tob.ts):
| 接口 | 给什么 |
|---|---|
POST /trae/gtm/tob/api/v1/config/get_personal_quota |
user_model_quota.seat_pool_currency_quota(席位额度)、paygo_currency_quota(超额/按量) |
POST /trae/gtm/tob/api/v1/config/get_user_model_usage |
user_usage_list[].in_seat_detail.chat_usage_details[]:每个模型的 total_token_usage 与 total_cost_currency;model_usage_detail_list[] 是按量那侧 |
seat_total_cost_currency / extra_total_cost_currency 实测恒为 null,所以已用量是把
每个模型的 total_cost_currency 相加得出的。
认证只有一条路:这两个接口只认控制台的会话 cookie X-Cloudide-Tob-Session。Cloud-IDE JWT
一律回 30011 请先登录,account/check_token 换不到会话,在控制台域名上做 ExchangeToken
也不 Set-Cookie。所以插件用控制台自己的密码登录(POST /trae/gtm/tob/api/v1/account/login,
{Email, Password})拿会话,会话过期自动重登一次。SSO 登录的租户用不了这条路。
界面上因此分两种账号:
- JWT 带企业租户(
tob_tenant_id)→ Trae 卡片多出「企业控制台账号」一栏(邮箱 + 密码)。 邮箱和密码都写进 dsh 凭据库(默认引用名TRAE_CONSOLE_EMAIL/TRAE_CONSOLE_PASSWORD), 配置文件一个字都不碰——保存这对账号因此不依赖配置可写;consoleEmail配置项只作兜底。 凭据写失败时,卡片直接把宿主返回的原因显示在字段下面,而不是只说「保存失败」。填好后额度块显示「席位额度 / 超额(按量)」两个包、总剩余百分比,外加一个可展开的 按模型用量(花费 + token 数)。没填时显示「企业版席位:填下面的控制台账号才能看到额度」。 - 个人版账号 → 完全走原来的
ide_user_ent_usage,不显示控制台登录栏。
要重新验证或找新接口:
TRAE_PAT=… TRAE_CONSOLE_EMAIL=… TRAE_CONSOLE_PASSWORD=… python3 -I tools/probe_quota.py
(把 IDE 两条路径在各个地址、两套请求头下的原始响应,以及控制台的两条接口全打出来。)
模型目录那两条接口同样有个探针,拿 ~/.trae/cli/auth.json 里的会话直接问:
python3 -I tools/probe_catalog.py
它第一段就是按通道列模型:每个 function 各发一次,打出这个 host 认不认这个名字、
该通道上架了几个配置、哪些可见。想验证 catalogFunctions 里那四个未取证的通道名,就看这段
(换一批名字:TRAE_FUNCTIONS=chat,solo_coder python3 -I tools/probe_catalog.py)。
Trae 标签页:分享这条会话
会话顶上那排标签(对话 / 轨迹 / 上下文 / …)里多一个「Trae」,只在屏幕上有 Trae 会话时出现。从上到下三块:
- 分享这条会话:点「生成分享链接」,把这条会话发成一条
https://share.traecontent.cn/share/<id>?enter_from=pc链接。 每轮对话单独显示,回答里带思考、工具调用和工具输出,和 TRAE SOLO 自己分享出去的页面一个样子;不调用模型。 - 分享生成的文件:这条会话写出的 Markdown / HTML 文件(
write/edit/present工具里出现过、现在还在磁盘上的), 点「分享」发成https://share.traecontent.cn/artifact/<id>网页链接;也可以手填文件的绝对路径。见下文「分享文件」。 - 我的分享:这个账号铸过的链接,打开标签就读一次。每条显示状态(公开中 / 审核中 / 已关闭)、创建和到期时间, 可以打开、复制、关闭(对方打开会提示已关闭)、重新公开、删除(撤销,不能恢复,要点两次)。
- 会话 ID:见下一节。
拿到链接的人不用登录就能看完整对话(分享接口对读者不校验身份),链接有效期 1 年。发出去之前想清楚; 不想让人看了就在「我的分享」里关掉或删掉。
怎么做到的
llm_raw_chat 不在 Trae 的聊天服务里留会话,分享接口(POST /api/remote/v1/share)要的 chat_session_id
在这里根本不存在。插件用的是 TRAE SOLO 分享本地会话的那个端点:客户端把整段消息带上,服务端原样保存。
POST https://trae-api-cn.mchost.guru/api/remote/v1/share/local_conversation
Authorization: Cloud-IDE-JWT <PAT 换来的 JWT>
{ local_session_id, chat_session_id, source_updated_at, title, mode: 'work',
anonymous, creator_name, messages: [...], resources: [], env: 'local' }
→ { share_session_id, status, expires_at }
- 消息来自插件自己看到的请求:每轮 Trae 跑完,插件从这轮请求的历史和最终回答里按轮整理出提问、每一步的说明 / 推理 / 工具调用和输出,存在内存里(最近 64 条会话)。所以插件启动后要先跑完一轮 Trae 才能分享,重启插件会清空; 启动前的那些轮次时间都记成第一次看到它们的时刻。
- 每一步写成聊天服务自己的
plan_item,回答是最后一步finish工具的summary;dsh 的工具名映射到分享页认得的那几类 (bash→Shell、read→Read、edit→Edit、web_search→WebSearch…),认不出的保留原名。 - 一条分享最多 50 轮,超出只带最近 50 轮并说明;每一步的字段最长 4000 字,每轮最多 120 步。
chat_start_time/chat_end_time是只读字段,带上就是991102 invalid parameter;created_at严格递增, 因为服务端按它排序。- 「改为逐轮重放」是另一条路:把每个提问重新发给 Trae(每个提问一次模型调用,要确认),页面上的回答是 Trae 新生成的,不是原文。
浏览器端经 /api/dsh-trae2api/share 路由走宿主的登录态隔离:?transcript=<会话 ID> 读插件记下了多少轮,
?mine=1 列自己的分享,POST {session} 生成,POST {action:'disable'|'enable'|'delete', id} 管理。
分享文件(Markdown / HTML → 网页)
和 TRAE SOLO 分享 HTML 报告用的是同一套接口(报告 v3 §6):
1. POST /api/remote/v1/share/local_artifact/presign-upload { local_session_id, artifact_path, content_length, content_hash }
2. PUT <upload_url> body = package.zip
3. POST /api/remote/v1/share/local_artifact { local_session_id, artifact_path, resource_uri, content_hash }
→ https://share.traecontent.cn/artifact/<share_session_id>
- 打包什么:入口文件,加上它(以及它引用的 CSS / HTML)用相对路径引用到的文件——只限入口所在目录之内;
不越出这个目录(
..)、不带隐藏文件(.git之类)、不带压缩包(服务端拒收嵌套 zip),最多 200 个文件、50 MB。 引用不到的资源跳过,页面上就是断图,和在别处打开一样。 - Markdown 先用
marked排成一个带样式的网页(标题取第一个#,跟随浅色 / 深色),再按上面的规则打包,图片一起带上。 - 同一个文件再分享一次是更新:服务端以
(local_session_id, artifact_path)为键,内容替换、链接不变。 - zip 是插件自己写的(不压缩,UTF-8 文件名),不依赖额外的包。
分享页把 HTML 放在
share.traecontent.cn同源的 iframe 里执行(allow-scripts allow-same-origin,报告 v3 §7), 页面里的脚本照常运行。只分享自己生成、自己看过的文件。
会话 ID(查看 / 复制)
「Trae」标签页最下面的「会话 ID」卡片,三项各占一行、各有自己的复制按钮:
| 行 | 内容 |
|---|---|
| 会话 ID | dsh 这边的会话 ID |
| 上游会话 | 这条会话上一轮跑在哪条上游会话里,下面写明用的模型和思考档位 |
| 排查串 | 按 Trae 客户端给客服那套格式拼好的一整行(见下) |
还没发过一轮时,后两行写「这条会话还没发过一轮」,不给空的复制按钮。
只有屏幕上有 Trae 会话时这个标签才在。标签行是全局注册表(宿主用 slots.entries('conversation.view') 拼这一排,
没有「按会话过滤」这档事,唯一例外是「轨迹」跟着开发者模式走),所以插件改成按需注册:输入框旁边挂了一个
什么都不渲染的哨兵(conversation.input.right 里的 trae-session-watch),它报告当前挂载的每条会话选的是不是
Trae 模型;有 Trae 会话就注册这个标签,最后一条切走就注销,宿主订阅了这个槽,标签行自己跟着变
(标签消失时宿主的 restoreView 会退回「对话」)。
分屏同时开着一条 Trae 和一条别的会话时,标签对两边都在(全局注册表只能这样)。这时在非 Trae 那条里点开, 第一行写明「这条会话现在选的不是 Trae 模型」,会话 ID 那行照常可用。
两个 ID 不是一回事,提 bug、查日志时要的往往是后一个:上游按「会话 × 模型 × 思考档位」分别开
conversation(见 conversationUuid),所以上游那条 ID 是从会话 ID 派生出来的,不等于也猜不出
会话 ID;换模型或换档位后同一条会话会有多个上游 ID,标签页里显示的是最近一轮主循环请求真的发出去的那个。
标题生成、上下文压缩这类旁路请求用自己的临时 ID,不计入。
排查串(Trae 客户端自己那套格式)
TRAE SOLO CN 0.1.61 在回答的头部双击会复制一串给客服用的排查信息,外部账号拿到的是这个格式:
312308224:a9e9…839c_6ae1a91d…6bff.6ae1a91d…6c02.6ae1a91d…6c00:TraeWork CN.0.1.61.no_sid.no_ppe.T(2026/10/28 15:49:49)
└ userId └ traceId └ 会话 ID └ 消息 ID └ 被回复消息 ID └ 应用名 └ 版本 └ Slardar └ PPE └ 本地时间
拼接规则(region 有值才带前缀,缺字段用 no_sid / no_ppe 这类占位符;字节内部账号拿到的是 JSON 不是这串):
`${region ? region + '.' : ''}${userId}:${traceId}_${sessionId}.${messageId}.${replyId}:${appName}.${appVersion}.${sid}.${ppe}`
串里那三个 24 位十六进制是 MongoDB ObjectId,由 Trae 的聊天服务生成(前 4 字节是时间戳,和末尾 T(...) 对得上),
客户端只负责拼。
本插件直连 llm_raw_chat——这是聊天服务下面一层,根本没有 message id,所以这串按「有什么填什么、
没有的保留格式自己的 no_* 占位符」来拼,不编 ID(见 src/trae/debug.ts):
| 字段 | 这里填什么 |
|---|---|
userId |
GetUserInfo 的 UserInfo.UserID,和 IDE 上报用的是同一个;读不到填 no_uid |
traceId |
上游回包里的 trace 头(x-tt-logid / x-tt-trace-id / x-trace-id),没有就用本插件这轮发出去的 x-request-id——两者都在上游访问日志里 |
sessionId |
上游会话 ID(conversationUuid),这里是 UUID,不是 ObjectId |
messageId / replyId |
no_mid,裸接口没有这两个 |
appName / appVersion |
照客户端自己的规则:isCN ? (platform === 'trae-ide' ? 'TraeCode CN' : 'TraeWork CN') : (platform === 'trae-ide' ? 'TraeCode' : 'TraeWork')——本插件不是 IDE 端,host 是 .cn,所以是 TraeWork CN;版本写死 0.1.61(读出这套格式的那个 SOLO 版本)。上游实际给这次请求记的身份是 codex_exec + traecli 版本,两者不一样,把这行和真实请求对上的是 traceId |
sid / ppe |
no_sid / no_ppe:没有 Slardar 会话,也没走 PPE |
T(...) |
这一轮的本地时间 |
实现方式:宿主端记住最近 64 条会话各自上一轮的变体、上游 ID 和 trace,经同样走登录态隔离的
/api/dsh-trae2api/session?session=<会话 ID> 路由给浏览器端,返回
{ session, conversation, model, effort, trace, at, debug };还没发过一轮的会话 conversation、debug 都是 null。
浏览器端在挂载、换模型/档位、一轮结束和每次点复制时各读一次,不轮询。
标签注册在 conversation.view(列表槽、会话作用域)上,id: 'trae-session'、order: 100(排在宿主自带的几个后面)、
label 用 thunk 所以跟着语言走;注册 / 注销由上面那个哨兵驱动。样式用宿主的设计变量,跟着亮色 / 暗色主题走。
剪贴板优先用
navigator.clipboard,拿不到权限(非安全来源之类)时退回老的选区复制; 两条都失败时按钮写「复制失败」,ID 本身就在页面上,可以直接选中复制。
trace 头是实测过的:2026-10-28 对 api.enterprise.trae.cn 发一轮,
llm_raw_chat回的是x-tt-logid: 2026102816265801000315823240915B1,没有别的 trace 头(ExchangeToken还把它写进了access-control-expose-header),所以traceOf()选的就是它;列表里其余几个是同系网关的别的写法, 留作兜底。想自己再测一次:TRAE_PAT=<你的 PAT> node tools/probe_trace.mjs,它把响应头全打出来并说明 会选哪个,PAT 和 JWT 都不打印。注意这个
x-tt-logid和 Trae 自家排查串里那个 32 位traceId不是一回事:后者是上面一层聊天服务的 trace,裸接口这边没有;这里填的是网关给这次请求记的名字,也正是能拿去查这次请求的那个。
下一步选择卡片
Trae 模型回答完一轮后,输入框上方(和 todo、排队消息同一个位置)会出现下一步选择卡片, 样子类似 Claude 回合结束时的那个选择框:
- 一件事一张卡片:回答里报了几个问题、提了几件可以做的事(比如「安装路径写错了」和 「缺一段配置说明」),就出几张卡片,最多 3 张,卡片顶上标「下一步 · 1/2」。同一件事的几种做法才放在 同一张卡片里;模型被要求不出「两个都改」「接下来做什么」这种把几件事捆在一起的卡片或按钮。
- 每张卡片是一个问题加几个按钮,问题和按钮都是模型给的,不固定是「要 / 不要」:可能是
「用 pino / 用 winston / 用 console 封装」,也可能是「改路径 / 先查可执行名」。每张最多 4 个,
模型推荐的排第一个(加粗)。不会有「暂不 / 跳过」这类按钮——不想做就点
×。 - 先选,再一起发:点按钮只是选中这张卡片的答案(按钮变实心、带 ✓),不会马上发出去。每张卡片 选一个,点同卡片的另一个按钮就换成它,再点一次已选的就取消。选中任何一个后,卡片下面出现一个发送框: 标着「已选 2/3」,可以补充几句(可选),点发送或在框里回车,就把所有选中的答案连同补充的话 作为一条消息发出去。没选的卡片不发。
- 发出去的每个答案都带上它卡片上的问题,一行一个:「关于「要把 README 里过时的安装路径改掉吗?」:把 README 里过时的安装路径改成 DSH NEXT.app」,补充的话放在最后一段「补充:…」。卡片上的问题是旁路补全问出来的, 主对话里从来没出现过,所以只发一句「改吧」模型并不知道指的是它上一轮提到的哪件事。模型没给问句的卡片, 发出去的就是按钮背后那句话本身(模型以你的口吻写的,鼠标悬停可以看到)。 建议模型也被要求别把按钮背后那句话写成「改吧 / 是的 / 第二个」这种光同意的话,而要写清做什么、改哪儿。
- 随时开关(
suggestions: true):设置 → 模型 → Trae(或插件页)的设置卡片里有「下一步卡片」 开 / 关,点保存就生效,不用重启宿主。关掉后不只是不显示——那次生成卡片的旁路补全请求也不发, 额度一点不多花;关掉时手上还没显示的那一轮也一起丢掉,再打开不会冒出来一轮过时的卡片。 关着的时候,下面那个「默认由谁来做」是灰的。 - 默认交给子会话做(
suggestSubagent: true):发出去的那条消息会在那句话外面包一层 「用subagent工具开个子会话去做,自己别直接动手,做完把结果要点和改了哪些文件告诉我」, 并单起一行写上「背景:上一轮结束时待定的问题是「…」」。选了几张卡片时,改成「下面每件事各开一个子会话, 互不依赖的可以同时派」加一个编号列表,每项是「背景 + 任务」;补充的话写成「补充(派活时一并交代给子会话):…」。 卡片右上角标一个「子会话处理」,卡片下面那行写明这一轮按钮会怎么处理,点那行左边的小按钮就能 当场切成「当前会话处理」(这一轮有效,下一轮回到配置里的默认值)。默认值在 设置 → 模型 → Trae (或插件页)的设置卡片里选:「下一步卡片默认由谁来做」选「子会话处理」或「当前会话处理」,点保存。 这个字段是 volatile 的,宿主不用重启,下一轮卡片就按新的默认值来;已经显示的这一轮不变。切回当前会话后,发出去的就是 上面那条「关于「…」:…」,不带委派那层。开子会话这件事由 DSH 宿主的委派工具做(@deepseek-ai/dsh-subagent+dsh-tool-subagent)——宿主没装委派工具的话,模型自己就把活干了,不会报错。 这一档开着时,建议模型还会被额外要求把每个按钮背后那句话写成自带上下文的任务(点名文件、 路径、命令、已经查到的结论),因为子会话看不到当前这段对话。 - 点 「其他建议」(每张卡片最后那个虚线按钮):卡片里展开一个输入框,你写的话就是这张卡片的答案 (同卡片的按钮取消选中;反过来点按钮也会收起输入框)。回车把所有选中的答案一起发出去,Shift+回车换行, Esc 收起;中文输入法选字时的回车不会误发。发出去后卡片全部收起。
- 点卡片右上角
×:只收起这一张,它的答案也不再发。 - 点卡片下面那行最右边的 「折叠」:这一轮所有卡片一键折叠成一行(「下一步 · 2 条」加第一张卡片的问题),
点这一行就展开。折叠是你的选择而不是这一轮的:之后几轮、别的会话、重启以后,卡片出来时都是折叠的,
直到你再点开(状态存在页面的
localStorage里)。折叠再展开,已选的答案和补充的话都还在。 - 样式用的是 DSH 自己的设计变量(和它原生提问框同一套底色、圆角、阴影、主按钮色),跟着亮色 / 暗色主题走。
- 在输入框里打字时卡片先让开,清空后再回来;发送新消息 / 模型开始工作时全部清掉,等下一轮回答完再出。
- 模型在收尾前一步刚用 DSH 自带的提问框(
ask_user_question)问过你的话,这一轮不出卡片—— 它收尾的那段文字通常是在追问同一件事,再出卡片就问了第三遍。提问之后又接着干了别的、最后才收尾的,照常出卡片。
实现方式:宿主端的 adapter 在一轮主循环请求(带工具的那种)以纯文本回答收尾时,用同一个模型、
最低思考档位、不带工具、独立的上游 session 发一个很小的补全请求——只喂最近 3 条用户消息和这轮
的最终回答——让它输出一个 JSON 数组:[{ "question", "choices": [{ "label", "reply" }] }]。
模型没按 JSON 回答时,第一行文字当成只有一个按钮的卡片;什么都解析不出来就不出卡片。结果按会话存在
内存里,经 /api/dsh-trae2api/suggestion(同样走登录态隔离的 Connection 路由)给浏览器端;
浏览器端在会话由运行转为空闲时去取,生成还没完成时最多等 20 秒。标题生成、上下文压缩这类不带工具的
旁路请求不会触发。
每轮回答会多花一次很小的请求额度。不想要就在设置卡片里把「下一步卡片」关掉(等于
suggestions: false,当场生效,关掉后连那次补全请求都不发),或者用suggestModel指定一个更便宜的模型。卡片挂在 DSH 输入框的
conversation.input.dock插槽上,按钮通过输入框自己的inputActions.setDraft+submit发送,和你手动输入再回车走的是同一条路。选中和补充的话都只在 浏览器端,发出去之前宿主什么都不知道。交给子会话也走这条路:插件不自己去起子会话(宿主的
startActivation要求父会话的 agent 当场活着,而点卡片时这条会话正空闲),而是把「请委派给子会话」写进发出去的那条消息里,由 当前会话的模型调subagent工具派活。所以这件事在 Cue 统计里仍然只算一次code_gen_accept,accept_content记的是模型给的那句话本身,不含外面包的那层委派说明,也不含补充的话。
计入 Trae 的 Cue 统计(默认开启)
默认无需任何配置:卡片真的显示出来时报一条 code_gen_shown(折叠成一行时按钮不在屏幕上,
等展开才算),真的把选中的按钮发出去时报一条 code_gen_accept,走 Trae 补全客户端用的同一个业务上报接口:
POST {host}/api/ide/v1/report/clients (multipart,字段 body = JSON 字符串)
Authorization: Cloud-IDE-JWT <和 llm_raw_chat 同一个 token>
X-App-Id: <appId>
- 同一轮卡片的 shown / accept 共用一个
resp_id(每轮卡片生成时的 UUID),accept_content是发出去的按钮背后那句话;一次发了几张卡片的按钮时,按卡片顺序报第一个(宿主端每轮只记一次采纳)。 用「其他建议」自己写的不算采纳,不上报;只发了自己写的话就不报 accept。conversation_id是产生这轮卡片的那次llm_raw_chat请求用的session_id(由适配器随回合一起交给 建议模块)。同一条 DSH 会话换了模型或档位就换了conversation_id,所以这里不能由 会话 id 自己推。 - 每轮卡片 shown、accept 各最多一次,去重和「显示了多久」(
suggestion_visible_duration)都在 宿主端算,浏览器只说「显示了 / 点了第几张卡片的第几个按钮」;过期的 id 一律不报。 user_id是 IDE 登录态里的账号 id(客户端User.idOrDefault),JWT 里没有。插件和 IDE 登录时 一样调POST {consoleHost}/cloudide/api/v3/trae/GetUserInfo(请求头x-cloudide-token,空 body), 取Data.UserInfo.UserID,每个 JWT 只问一次。cueUserId/TRAE_USER_ID只是覆盖这个 id; 不要填租户 id(TenantID)或 TEA 的 device id / 匿名 uuid。- 同一个回答里的
Data.PrivacyMode打开时,什么都不报(和 IDE 的隐私模式闸门一致),配了cueUserId也一样。GetUserInfo 失败时这一条不报,只在日志里记一行。 code_gen_shown的 payload 只带resp_id/type/conversation_id,字段是按 accept 的结构推的, 未对照真实客户端抓包。
不想上报(例如把 tgz 发给别人、对方不希望计入)时,在 profile 的 cordis.patch.yml 里关掉:
- id: trae2api
config:
reportCue: false
注意:这些是聊天里的「下一步选择」,按
code_gen_*报上去后会和真正的代码补全混在一起计数, 企业控制台里的 Cue 用量 / 采纳率会因此变化。
已知限制
- 图片仅限多模态模型与 user 消息:图片以
data:URI 内联发给目录标记multimodal: true的模型(20 个里 15 个,GLM-5.3/GLM-5.2/DeepSeek 全系/MiniMax-M2.7 除外);纯文本模型与 tool 结果里的图片仍是占位文本(上游接口只在 user 消息接受image_url,发给纯文本模型会被1210拒绝还伪装成限流)。读取失败的单张图片降级为 占位文本而不是让整轮失败。图片按每边 1024px / 2MiB 预算由附件服务缩放。 - 这是 Trae 未公开的内部接口,后端改协议插件就会断——和 trae2api 的 direct 模式同样的前提。
- Max 的实际效果未经证实:trae2api 实测这条私有接口对
context_window_size和__maxkey 没有可观测差异(两者extra_info.model相同)。路由是真的(15 个模型的4023就是靠它修好的), 但「真能吃下 1M」没被实测过——目录里标着 Max 的那 14 个模型 dsh 会按 1M 规划上下文,万一后端 不认,很长的会话可能在上游被截断。真遇到了把catalogSource锁成builtin,再改src/trae/catalog.ts里那个模型的max。
开发
npm install # 仅用于类型检查 / 重新构建
npm run typecheck
npm run build # 产出 lib/index.js(宿主端)与 lib/client.js(浏览器端,无需编译)
npm run build:test # 产出 lib/testing.mjs,供单元测试导入内部纯函数
npm test # 目录、消息转换、SSE 解码、重复检测、文本工具调用、PAT/JWT 解析等
源码:
src/index.ts—— 宿主端:注册模型来源和 Models 页的 Trae 行。src/adapter.ts—— dshLlmAdapter,组装 llm_raw_chat 请求、解流、重组工具调用、兜底。src/trae/auth.ts—— PAT → Cloud-IDE JWT 兑换与缓存。src/trae/catalog.ts—— 目录的数据结构,外加断网兜底用的 20 个模型(其中 14 个走 Max)。src/trae/catalog-source.ts—— 运行时目录:上游batch_get_detail_param与 traecli 缓存的 解析、三级兜底、每次插件启动刷新一次的TraeCatalog。src/trae/wire.ts—— 消息转换、SSE、错误分类、重复检测、文本工具调用嗅探。src/trae/quota.ts—— 额度查询:CheckLogin 发现支付网关、v1/v2 兜底、宽容解析、企业席位判定。src/trae/tob.ts—— 企业版额度:控制台密码登录 + 个人配额/按模型用量两条接口。client/client.js—— 浏览器端:Models 页和插件页里的 PAT 卡片、额度块、输入框额度徽标。
已在 @deepseek-ai/dsh@0.2.0-rc.2 的 Web 界面里验证:Trae 卡片只有 PAT 一个字段,未填时
连接状态显示明确提示。77 项单元测试覆盖协议转换、各项兜底、额度解析与路由注册,以及出货
bundle 里每个模型的上下文窗口和思考档位。真实 PAT 兑换、模型调用与额度查询已在
api.enterprise.trae.cn 环境用真实 PAT 验证通过。
哪些没有实测过:工具 schema 的 draft-4 归一化是按上游「分后端校验」的报告写的,本机没有 复现过 DeepSeek 后端那条
4027;五档词表里的medium/max上游尚未下发。目录通道那条 2026-10-27 已实测(四个额外通道回 200 但 0 配置,所以默认只问chat)。四项改动各自做过 变异验证:把实现改回原样,对应的测试就转红。另外,
src/trae/catalog.ts那份内置兜底表(20 个模型)已经落后于上游:同一次实测里chat通道可见 23 个模型(除summary与custom_model_placeholder),多出DeepSeek-V4.1-Flash-1017、kimi-k3.1-pro、minimax-m3.1-flash三个。兜底表只在断网或 上游不可达时才用到,所以不影响正常使用。
No comments yet. Be the first to write one.