dsh-pylon-trae

> A Trae LLM provider plugin for DeepSeek Harness (DSH).
> Repository:
> Package name: dsh-pylon-trae (this is the first plugin under the dsh-pylon- prefix).

English

What it is

This plugin adds a Trae provider to DeepSeek Harness. After installing it and
restarting DSH, Settings → Models gains one editable Trae provider whose
model list is read from the Trae installation already signed in on this machine
(Trae desktop app, or the Trae CLI).

It does not depend on, import, or patch dsh-connect-trae.

How it works

1. It reads the credential file that the Trae desktop app or the Trae CLI already
   wrote, and decrypts it locally with its own implementation.
2. It pulls the live model directory for the signed-in edition (CN or
   international) and decodes the streaming responses.
3. It serves an OpenAI-compatible endpoint (/healthz, /v1/models,
   /v1/chat/completions) from a fixed loopback port. /v1/models advertises the
   conversation models only: the directory also answers with Trae's own IDE workflow
   components (title_generation, fast_apply, the custom_model_* placeholders, the
   *_advisor / search_agent_* aliases), and this plugin tells them apart by fields
   rather than by a hand-written denylist. On the live CN directory that is
   47 chat + 32 internal = 79, and /healthz names the parts
   (models / chat / internal / total).
4. It seeds one provider entry into the llm-pi-ai namespace, which is the
   namespace the Models page renders an editor for — so you can add, remove and
   test models from the UI.

Trae's own data is read-only. The plugin never writes to Trae's files; there
is an assertion in the code that refuses to.

Hard prerequisites — all four

> Installing does not start or restart DSH. Quit DSH completely and reopen it.
> Reloading the window is not enough.

Install

Three routes are documented in 发布.md. In short:

• From this repository (GitHub source). The install target is a pnpm GitHub
  spec, github:rumilhz/dsh-pylon-trae. Any DSH version that can add a plugin
  from a GitHub source can install it this way.
• From the plugin market. ⛔ Not searchable yet. An entry has been / will
  be submitted to the curated awesome-dsh-plugin catalog, but the market only
  offers sources inside that catalog, so this route works only after that pull
  request is merged. See 发布.md.
• From a prebuilt tarball. node tools/pack.mjs produces
  dist/dsh-pylon-trae-.tgz plus a .sha256 and a .manifest.txt
  checksum pair; node install.mjs --from installs it offline.

Node ≥ 22.6 can run the .ts sources directly (type stripping), so there is
no build step.

中文

这是什么

DSH 的 Trae 供应商插件（自研实现；不依赖、不引用、不打补丁于 dsh-connect-trae）。

目标形态：在「设置 → 模型」里出现一条可编辑、含 Trae 全量模型、能自己筛的供应商。

• 包名 dsh-pylon-trae，仓库名 dsh-pylon-trae。
• 状态/数据目录只有一个：$DSH_HOME\.dsh-pylon-trae\（token、state.json、备份、boot.log 都在里面）。
  旧 .dsh-trae\ 首次启动时会自动复制迁移，原目录保留给用户自己清理。

> 四硬前提见上面英文小节的表格（Trae 已登录 · 7864 空闲 · profile 里没有 dsh-connect-trae · Windows）。
> 装完必须完全退出 DSH 再打开，刷新页面不算。

状态（截至 2026-10-16；M1~M6 六行是 2026-10-14 深夜的口径，最后一行是 2026-10-16 这一轮加的）

> M1~M6 是什么：不是版本号，是施工顺序（M = milestone）。
> 每一步都刻意做成"做完就能单独验证"的一小段，且顺序保证越早可用：
> M1 只读不碰配置 → M2 让链路能说话 → M3 才把它接进「设置 → 模型」→ M4 之后就都是加功能。
> 状态口径：✅ = 本机实测通过 · ⏳ = 没做完，或做完但还没验收。

验证全部跑在临时 profile 上：<工作区>\_trae-coldstart\home（独立 DSH_HOME，里面只装本插件）。
把插件装进真 profile（~/.dsh/profiles/*）是部署动作。

目录里的「内部组件」过滤（2026-10-16）

问题：写进「设置 → 模型」的 79 条里混着 Trae IDE 自己的流程组件 —— title_generation（起标题）、
input_optimization（优化输入）、fast_apply（快速套用）、search_agent_qwen_fast（搜索）、
custom_model_gpt-6（占位槽）、glm-5.2_advisor_doubao（顾问模式）…… 它们都是真的可调用的
config_name（所以确实能调通），但不是对话模型，出现在模型选择器里就是垃圾项。

判据：字段判定，不是手写黑名单（src/catalog.ts 的 classifyDirectoryEntry）

实测的 usage 分布（CN，2026-10-16，169 行 / 79 个不重复 config_name）：
chat_completion 56 · custom_model 18 · summary · fast_apply · fast_apply_new ·
title_generation · input_optimization 各 1（= 79）。

为什么必须是 OR，而不是"保留第一行"：solo_work_remote 是第一个被问的 function，它对
DeepSeek-V4-Flash / DeepSeek-V4-Pro / Doubao-Seed-2.0-Code 返回的是陈旧 wire
（deepseek_v4_flash__dev 等）；first-wins 会让同一份目录从 47 掉到 44 —— 3 个真模型被静默丢掉。
改成 OR 之后连拉两次稳定 47 chat + 32 internal = 79：判据成了目录的属性，与网关先答哪一行无关。

上游 dsh-connect-trae@3.4.0 没有做等价的事：collectModels（:2604-2640）全收；它只有两个与用途
无关的过滤（sanitizeCatalog :283-290、dropDeadModels :5303）。它的注释自称 internals
不会浮出，靠的是「以 Remote 用户面目录为骨架」这一条结构性假设；我们试过那条路（拿它的 32 个名字
与我们的 79 个求交）只剩 30 个，连 glm-4.6 · glm-4.7 · kimi-k2 · minimax-m2 ·
minimax-m2.1 · qwen3-coder 这些真模型一起丢 ⇒ 弃用，改为留在本仓库字段上的判据
（离线可复现，不需要第二次网关调用）。

被判为 internal 的 32 个 id（CN，2026-10-16，完整名单）

title_generation · input_optimization · summary · fast_apply · fast_apply_new
custom_model_1M · custom_model_1M_text · custom_model_200k · custom_model_200k_text
custom_model_claude · custom_model_deepseek_chat · custom_model_deepseek_reasoner
custom_model_deepseek_v4 · custom_model_doubao_1M · custom_model_doubao_256k
custom_model_gemini · custom_model_gpt-5 · custom_model_gpt-6 · custom_model_kimi
custom_model_no-fc · custom_model_placeholder · custom_model_vercel · custom_model_vercel_gemini
browser_use_subagent · explore_sub_agent_v2 · file_search_agent · search_agent_qwen_fast
search_agent_qwen_fast-0710 · glm-5.1_advisor · glm-5.2_advisor_default · glm-5.2_advisor_doubao
seed-code-pro-0430

（同一份 32 条逐字冻结在 tools/test-catalog.ts 的 INTERNAL_ROSTER：判据或名单一变，那个先红。）

边界：缺 usage 或缺 model_name 的畸形行一律判 internal（绝不误判为 chat）。方向是刻意的 ——
隐藏一个真模型的代价是"用户少看到一个选项"，而放进一个流程组件正是这次要修的问题；而且被隐藏的 id 会经
SeedOutcome.skippedInternal、GET /models/all、boot.log 三处报出来，所以可发现、可撤回。

用户怎么清掉已经写进去的垃圾条目：只有一条路 ——
「设置 → 模型」→ Trae 卡片 → ② 目录行 → 「移除内部组件（N 个）」。
不点就一个字都不动（插件在启动时故意不自动删用户配置，只在 boot.log 里留一行提示）：

internal: 检测到 N 个内部组件仍在你的条目里（…）—— 未自动删除；在设置卡片点「移除内部组件」即可清除（会先备份到 profile 之外）

怎么验（全部可复制）

把 `` 换成你本机的 Node ≥ 22.6 可执行文件（DSH 自带的那份即可）：

set NODE=

① 服务端离线回归（不联网、不花额度）—— 当前 11/11 套件 PASS

%NODE% tools\_run-suites.mjs

任一失败即退出码非 0（缺脚本记 SKIP，不算过）。想单跑某一项（排查时更省时间，退出码 0 才算过）：

%NODE% tools\check-entry.ts        :: 入口能 import、Config 校验（本机：ENTRY OK）
%NODE% tools\test-seed.ts          :: 写路径 create/present/refresh/回滚 + 备份保留策略（真文件系统 e2e）
%NODE% tools\test-api.ts           :: 端点处理函数（本机：172/172）
%NODE% tools\test-catalog.ts       :: 目录分类：哪些 config_name 是对话模型、哪些是内部组件
%NODE% tools\test-reasoning.ts     :: 推理档位映射
%NODE% tools\test-contract.ts      :: 与钉死的上游 dsh-connect-trae@3.4.0 对线（本机：127 passed · 0 failed）
%NODE% tools\client-bundle-check.mjs  :: 卡片 bundle
%NODE% tools\client-route-check.mjs   :: 宿主路由 handler，走真 HTTP

> tools/_run-suites.mjs 本机（2026-10-16）的输出是 11 passed · 0 failed · 0 skipped · offline only，
> 退出码 0。本轮新加的就是 test-catalog（56 条断言：2026-10-16 实测的 169 行 / 79 个 id 冻结在套件里）。
> tools/test-seed.ts · tools/test-catalog.ts 与 client-*.mjs 自己不打总数
> （只打 ALL CHECKS PASSED / N/N），所以判据始终是退出码 0，不是某一行的数字。

再加两项联网只读检查（只拉目录、只起回环服务，不产生生成、不花额度）：

%NODE% tools\_run-suites.mjs --network

② 冷启动验收（起真 DSH 进程）—— 当前 19/19

%NODE% tools\coldstart-verify.mjs

它自己会：重建临时 profile → 起真 DSH（显式给 DSH_HOME）→ 轮询
$DSH_HOME\.dsh-pylon-trae\boot.log 与 profile patch → 断言 seed: created → 断言
providers.trae 与模型数 > 0 → 用 Bearer 打 http://127.0.0.1:7864/admin/status 得到 ok:true
→ 停进程 → 再起一次断言 seed: present 且 patch sha256 未变 → 打印结论与耗时，并确认 7864 已释放。

%NODE% tools\coldstart-verify.mjs --keep-profile
%NODE% tools\coldstart-verify.mjs --skip-restart
%NODE% tools\coldstart-verify.mjs --capture
%NODE% tools\coldstart-verify.mjs --timeout 120 --port 7864 --dsh-profile unset

> 铁律不变：脚本只写工作区下的 _trae-coldstart\（临时 home\ 加上它自己的 PID 账本
> coldstart-pids.json、可选捕获日志），不引用活体 ~/.dsh；启动的每个进程都记账，
> 结束前连子进程一起杀，并复查端口。它能重复跑。

③ 真机六条用法（不需要 UI；只有 test 花一点点额度，refresh 可能写配置，其余只读）

%NODE% tools\trae.ts status
%NODE% tools\trae.ts models --limit 30
%NODE% tools\trae.ts usage
%NODE% tools\trae.ts checkin
%NODE% tools\trae.ts test --model mimo-v2.6-flash
%NODE% tools\trae.ts refresh --host

· status —— 账号（desktop + CLI）+ 模型数 + 当前凭据（只有 sha256[0:12] 指纹）
· models --limit 30 —— 实时目录逐条列出：id / 名字 / 上下文 / 输入模态 / 所属 function
· usage —— 总额与各 pack 的 credits_amount（只读，不花额度）
· checkin —— 今日签到状态（只读）；加 --claim 才真的领，那会改变账号状态
· test --model —— ⚠️ 会向 Trae 发一条极小真实消息，消耗一点点额度
· refresh --host —— 让正在运行的宿主重建清单（只增不删；需要 7864 上已经有宿主在跑）

④ 客户端半边的两个离线闸门（不需要浏览器）

%NODE% tools\client-bundle-check.mjs
%NODE% tools\client-route-check.mjs

client-bundle-check 查：经典脚本可加载、席位注册、无任何凭据、四个状态都渲染，外加：
「刷新目录」必须打到 POST /models/reload、「重建清单」必须打到 POST /models/refresh（两者不许互换）、
reload 之后目录行里的 模型 N 个 只出现一次、accountWarning 原样透传到卡片（红字）。
client-route-check 查：两条前缀路由、disposer 反注册、失败一律回 {ok:false,detail}，
以及栅栏口径——只有「Host 与 Origin 都是回环」的 403 被容忍（且只 trace 一次），
401 永不放过，非回环 Host/Origin 仍然 403。

这两个数字会继续长，所以只当"跑没跑过"的判据：退出码 0 才算过。

⑤ M1 只读探针（原来的入口，仍然可用；不联网不花额度）

tools\probe-m1.cmd --no-network

去掉 --no-network 就是再拉一次实时模型目录（会联网，只读）。

已知限制（都会静默失败，所以写在这里）

① 卡片这条通道依赖宿主的两件事，任一件变了卡片就整片 403。

卡片的数据走宿主 web server 上本插件自己注册的路由（/plugins/dsh-pylon-trae 与 /api/plugins/dsh-pylon-trae），
而请求要过宿主自己的栅栏 connection.requestRejection。桌面 app 的 UI 层只转发 /api/*，
并且会把 Host 改写成宿主端口、Origin 仍是 app 端口 —— 于是同一个栅栏对回环请求也回 403。

我们的处理是容忍这一种 403（Host 与 Origin 都是回环，端口可不同）：仅此情形放行并 trace 一次；
401 绝不放行，非回环 Host/Origin 仍然 403。

⇒ 若某天宿主改了这套判据，症状是卡片五个区块全是
HTTP 403 … 没有返回 JSON（这条路没被转发到插件）。先看 $DSH_HOME\.dsh-pylon-trae\boot.log 里有没有这行：

host route: fence 403 tolerated as a loopback port hop (host=… origin=…) — the card is served through the desktop app's proxy

有 ⇒ 栅栏已放行，问题在别处；没有 ⇒ 请求在栅栏处就被判掉了（handleApi 一次都没被调用）。
另一种"没数据"是插件根本没被 import：模块顶层会打 [dsh-pylon-trae] module loaded，
没有这行 = 没被 import；有这行但没有 apply: 行 = import 了但 apply 没跑（inject 依赖没到，插件停在 PENDING）。

② 图片输入是刻意没开的，不是漏了。

src/protocol.ts 顶部有 NOT IMPLEMENTED — image input (deliberate) 一节：请求侧不翻译 image_url
内容块，所以目录里 multimodal === true 的模型也不往 provider 条目的 input 里写 'image'
（恒为 ['text']）。理由是"先宣告、再让用户的图片静默消失"比不支持更糟。

③ 单次「测试启用模型」最多 10 个，而且每个都是真请求。

/models/test 的 MAX_PROBE_MODELS = 10（src/api.ts）：显式给 modelIds 时，去重、丢掉未知 id 之后
最多真的测 10 个，被截掉的用 requested / tested / truncated 明说；不给 modelIds 只测前 5 个。
每个 verdict 都是一次真的发往 Trae 的请求（30s 超时、串行），所以这一步会花一点点额度。
反过来，/models/reload 与 /models/refresh 只拉目录，不发消息、不花额度（refresh 会写配置）。

④ 只在 Windows + Trae CN 上实测过。

路径与 edition 表按三平台（win32/darwin/linux）写好，但 macOS / Linux 没有真机验证；
国际版（ai 区域）同理 —— 本机没有国际版凭据，代码结构保留了 cn/ai 双桶，等有账号时再验。

⑤ 手打一个内部组件的 id，仍然会被转发出去 —— 刻意如此。

回环 GET /v1/models 只公布对话模型，但 POST /v1/chat/completions 解析 model 用的是全目录：
用户自己往模型页里手打一个 internal id（如 title_generation），请求会按它的真名转发到 Trae。
理由写在 src/shim.ts 里（handleChat 上方）：用户手打的 id 可能是网关还没列出来的新模型，
"按真名转发、让 Trae 自己回答"比我们替他拒绝更诚实。这是刻意保留的，不是过滤漏了一处。

⑥ /v1/models 不按 id 去重，而写进 provider 条目的那一份会去重。

src/seed.ts 的 buildProviderProfile 用 seen 集合按 id 去重；src/shim.ts 只是把
advertisedModels() 原样映射成 OpenAI list。当前目录已经按 id 去重（fetchDirectoryModels
用 byId Map 归并同一个 config_name 的多个 function 行），所以这两个面没有分歧；
若将来网关真的给出重复 id，分歧会先在 tools/test-api.ts [9] 节的一致性断言
（/v1/models 的 id 集合 == provider 条目的 id 集合）上变红，而不是静默地一边多、一边少。

目录结构

src/format.ts     ← 生成物（tools/extract-format.mjs）：Trae 自身格式常量（salt 表、storage key、directory functions）
src/paths.ts      ← 三个平台的安装/数据目录探测（4 个 edition，desktop + CLI）
src/auth.ts       ← 凭据读取与解密（自研实现）、账号归一化、CLI JWT 解析
src/identity.ts   ← 机器/设备身份（读 Trae 自己的文件，绝不伪造）
src/catalog.ts    ← 实时目录拉取（逐 function 取并集）+ **分类判据**（哪些 config_name 是对话模型、
哪些是 Trae IDE 自己的流程组件：classifyDirectoryEntry / partitionModels）
+ 静态兜底 + 请求头契约 + 推理档位解析
src/protocol.ts   ← 请求翻译（OpenAI → Trae）+ 命名 SSE 解码（Trae → OpenAI chunk）
src/shim.ts       ← 固定端口回环门面：/healthz（models / chat / internal / total 四个具名计数）·
/v1/models（**只列对话模型**，由 ShimOptions.advertisedModels() 注入，
与写 provider 条目用的是同一个 partition）· /v1/chat/completions（model 解析走全目录）
以及 /admin/* 与 /plugins/dsh-pylon-trae/* 两条插件端点前缀，同一条 Bearer
src/seed.ts       ← 找 namespace、生成供应商条目（**只写 kind === 'chat'**）、create / present /
refresh（只增不删）、pruneInternalModels（点了「移除内部组件」才删：
删前备份到 profile 之外、写后核对、任一不过逐字节回滚）
src/guard.ts      ← 写路径安全网：写前备份、写后由纯函数 judgePatchWrite 核对四条
（条目不少 / 文件不空 / provider 真在 providers 字典里 / 模型数等于期望）；
"读不到"判失败（"无法确认" ≠ "确认无误"），任一不过就逐字节回滚
src/api.ts        ← 端点处理函数（与传输无关，可离线测）；/models（**只给对话模型**）·
/models/all（全部条目 + 每条的 internalReason，只读诊断）·
/models/reload（只读重拉）与 /models/refresh（只增不删写配置）是两条不同的路由；
/models/prune-internal 是**唯一**会删模型条目的路由
src/index.ts      ← 插件入口：配置 + 起服务 + 种子 + 账号状态/墓碑集合（落 .dsh-pylon-trae/state.json）
lib/client.js     ← 浏览器半边：设置卡片（两个席位；**不碰**回环 token，只走宿主路由）
tools/            ← 见上面「怎么验」；另有 make-temp-profile.mjs（临时 profile 配方）
cordis.patch.yml  ← 本插件的 bundle 补丁（声明它是怎么被 profile 挂上的）
install.mjs       ← 装机入口（源码目录 link / tgz --from / --uninstall / --rollback）

安全约定

· 探针只打印 token 的 sha256[0:12] 指纹；真实 token 只在内存里，且永不写入 cordis.patch.yml、日志或任何 HTTP 响应
（写进供应商条目的是**本插件自己的回环 token**，不是 Trae 的凭据 —— 它只用来挡住别的本机进程蹭额度）
· 凭据值、token 值一律不打印；冷启动脚本比对 Authorization 时也只比 sha256 指纹
· 绝不碰活体 profile（~/.dsh）：所有验证都在工作区下的临时 home 里做
· 写文件一律用编辑工具或 Node 的 fs.writeFileSync(p, s, 'utf8') —— 不用 PowerShell 的 Set-Content / Out-File
· Trae 的数据只读：install.mjs / doctor.ts 里都有断言拦着写 AppData\Roaming\Trae*

许可

MIT，见 LICENSE。

src/format.ts 是由 tools/extract-format.mjs 生成的格式常量（Trae 自身 storage key 与 salt 表），
数据来源是同样以 MIT 分发的 dsh-connect-trae@3.4.0；本仓库没有 vendor 它的任何代码。