dsh-connect-trae 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+## 1.0.0 (2026-08-30)
+
+### Features
+
+- 首个稳定版本：将本机当前登录的 Trae 中国区模型接入 DSH，并通过安全 loopback shim 提供模型调用。
+- 接入 `llm_utils_chat` 原生函数调用通道，将 Trae `function_call` 转换为 DSH 可执行的 OpenAI `tool_calls`，支持工具结果回传与连续 Agent 循环。
+- 自动发现 Trae CN / TRAE SOLO CN 本地登录账号，支持刷新 Token 列表、选择账号，并优先使用具有通用积分的账号。
+- 提供 DSH Connect Trae 插件卡片，分别展示 Work 积分与 DSH 可使用的通用积分，并支持模型目录刷新和启用选择。
+- 支持 DeepSeek-V4-Flash 等 Trae 模型、只读用量接口及中英文界面。
+
+### Fixes
+
+- 凭据选择优先使用可供 `llm_utils_chat` 计费的通用积分账号；单个损坏、过期或已退出的本地凭据不会阻断其他账号。
+- 规范化 DSH 的 `developer` 消息角色为 Trae 接受的 `system`，避免模型请求持续 400 重试。
+- 正确处理 Trae 流式错误事件，配额错误不再被误报为 `EMPTY_RESPONSE`。
+
+### Docs
+
+- 发布元数据、双语 README、发布流程、第三方 Trae 相关项目声明与 npm 打包白名单均已补齐。
+- 项目以 MIT 许可证发布，版权归属明确为 `Copyright (c) 2026 LaoDing`。
+
+## 0.1.0-dev.1 (2026-08-28)
+
+### Features
+
+- **新版 SOLO 远程会话通道**：`TraeSoloRemoteClient` + `TraeSoloRemoteBridge`，把 `solo.trae.cn/api/remote/v1/chat_sessions` 的轮询结果转换为 OpenAI SSE，接入安全 loopback shim，成为第一可用上游路线。
+- **本地模型目录**：`DeepSeek-V4-Flash` / `DeepSeek-V4-Pro` / `Doubao_1_6` / `kimi-k2.6` / `qwen-3.6-plus` / `glm-5.1` / `minimax-m2.7`。
+- **只读用量概览**：`TraeUsageClient` 查询总可用额度、积分来源、每日签到与奖励活动（`web_user_ent_usage` / `checkin_credits/status` / `activity/info`），只读、不消耗积分。
+- **插件设置卡片**（对齐 `dsh-subagent-default-model` 外部形象）：在 `settings.plugin.item` 注册折叠卡片（key `trae`），带 LD 品牌图标与 `dsm-plugin-card` 卡片外壳，展开后展示总可用/已消耗、各项积分进度条、每日签到与奖励活动；Host 侧通过 `webServer` 只读路由 `/plugins/dsh-connect-trae/usage` 提供脱敏数据。
+- **SSE 扩展**：解析 `token_usage` 与 `tool_calls` 事件。
+- **安全骨架**：随机 loopback 端口、进程内随机 secret、Host/Origin/Content-Type 校验、请求取消、body 上限。
+
+### Docs
+
+- 新增 `docs/SOLO_ROUTE_DECISION.md`、`docs/USAGE_API_RESEARCH.md`、`docs/HANDOFF.md`。
+- README 中英双语双文件，对齐插件外部形象标准。
+- 新增 `THIRD_PARTY_NOTICES.md` 第三方开源声明：只记录与 Trae 接入直接相关的架构/协议参考项目及其许可证与合规说明；README 增加对应章节，发布包 `files` 白名单纳入该文件。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LaoDing
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,76 @@
+# dsh-connect-trae
+
+[English](README.en.md) | 中文
+
+A [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) bundle plugin that connects locally signed-in Trae CN models to the DSH model picker. Trae generates structured tool calls while DSH executes its own local tools, with a read-only Work/general credits and model-management panel.
+
+## Preview
+
+<p align="center">
+  <img src="docs/assets/dsh-connect-trae-usage-card.png" alt="DSH Connect Trae plugin card showing account selection, Work and general credits, and model management" width="900">
+</p>
+
+<p align="center"><sub>Settings → Plugins → DSH Connect Trae: switch local Trae accounts, view Work/general credits, and manage the Trae models enabled in DSH.</sub></p>
+
+## Features
+
+- **Trae model provider** — registers locally signed-in Trae models as the `trae` provider (e.g. `DeepSeek-V4-Flash`, `DeepSeek-V4-Pro`).
+- **DSH local tool loop** — gets pending structured `tool_calls` from Trae `llm_utils_chat`, lets DSH execute its own local tools, then returns tool results to the model.
+- **Trae CN account switching** — detects local Trae CN and TRAE SOLO CN sign-ins, refreshes the token list, and lets users select an account without storing tokens in DSH settings.
+- **Read-only credits and model management** — shows Work credits separately from the general credits usable by DSH, and manages which Trae models are enabled. Read-only queries do not consume credits.
+- **Secure loopback shim** — random port + in-process random secret; the real Trae token is never handed to pi-ai.
+
+## How it works
+
+```text
+DSH PiAiAdapter
+  -> secure loopback shim
+  -> TraeSoloBridge
+  -> https://trae-api-cn.mchost.guru/api/agent/v3/llm_utils_chat
+  -> Trae SSE / pending function_call
+  -> OpenAI SSE tool_calls
+  -> DSH executes local tools and returns their results
+```
+
+Usage overview hits the read-only `https://api.trae.cn/trae/api/v2/pay/*` and `/trae/api/v2/ug/*` endpoints.
+
+> See `docs/IMPLEMENTATION_PLAN.md`, `docs/SOLO_ROUTE_DECISION.md`, `docs/USAGE_API_RESEARCH.md`.
+
+## Install
+
+```sh
+dsh plugin --profile desktop add dsh-connect-trae
+```
+
+Or directly via npm:
+
+```sh
+npm install dsh-connect-trae
+```
+
+Restart the DSH process after install/update/uninstall.
+
+## Development
+
+```sh
+pnpm install
+pnpm run check   # typecheck + test + build
+```
+
+Local dev via a `link:` install to the desktop profile (restart DSH Desktop after editing):
+
+```sh
+dsh plugin --profile desktop add /Users/dmh2002/DshProject/dsh-connect-trae
+```
+
+## Acknowledgements
+
+- [Wang-JQ77/dsh-trae-api](https://github.com/Wang-JQ77/dsh-trae-api) (MIT) — Reference implementation for research into Trae authentication, sessions, and model protocols.
+
+## Third-party open-source dependencies
+
+The open-source projects referenced for Trae integration (architecture/protocol research), together with their licenses and compliance notes, are recorded in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). When introducing new Trae-related external dependencies or reusing code from other projects, update that file accordingly and honor the upstream licenses.
+
+## License
+
+This project is licensed under the [MIT License](LICENSE). Copyright: **Copyright (c) 2026 LaoDing**.

package/README.md

@@ -0,0 +1,95 @@
+<p align="center">
+  <b>dsh-connect-trae</b>
+</p>
+
+<h1 align="center">dsh-connect-trae</h1>
+
+<p align="center"><b>把本机登录的 Trae 模型接入 DeepSeek Harness，并提供只读的用量/积分概览。</b></p>
+
+<p align="center">
+  <a href="README.en.md">English</a> ·
+  <a href="#安装">安装</a> ·
+  <a href="#工作原理">工作原理</a> ·
+  <a href="CHANGELOG.md">更新日志</a> ·
+  <a href="https://github.com/dingminhua/dsh-connect-trae/issues">问题反馈</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/dsh-connect-trae"><img src="https://img.shields.io/npm/v/dsh-connect-trae?style=flat-square&label=npm&color=cb3837" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/dingminhua/dsh-connect-trae?style=flat-square" alt="MIT license"></a>
+</p>
+
+一个独立的 [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) bundle 插件。它把本机已登录的 Trae 中国区账号接到 DSH 的模型选择器：模型负责生成结构化工具调用，`bash` / `read` / `write` / `edit` 等工具由 DSH 本地执行；同时提供**只读**的 Work/通用积分与模型管理界面。
+
+## 效果预览
+
+<p align="center">
+  <img src="docs/assets/dsh-connect-trae-usage-card.png" alt="DSH Connect Trae 插件卡片：Trae 账号、Work 与通用积分以及模型管理" width="900">
+</p>
+
+<p align="center"><sub>设置 → 插件配置 → DSH Connect Trae：切换本机 Trae 账号、查看 Work/通用积分，并管理 DSH 中启用的 Trae 模型。</sub></p>
+
+## 功能特性
+
+- **Trae 模型接入** —— 把本机登录的 Trae 模型注册为 DSH 的 `trae` provider，模型选择器出现 `DeepSeek-V4-Flash`、`DeepSeek-V4-Pro` 等。
+- **DSH 本地工具循环** —— 通过 Trae `llm_utils_chat` 获取待执行的结构化 `tool_calls`，交由 DSH 自带的本地工具执行，再将工具结果回传模型。
+- **中国区多账号切换** —— 自动发现 Trae CN 与 TRAE SOLO CN 本地登录账号，支持重新读取 Token 列表并选择账号；Token 不写入 DSH 设置。
+- **只读积分与模型管理** —— 插件设置面板可分别查看 Work 积分与 DSH 可使用的通用积分，并刷新/启用 Trae 模型；只读查询不消耗积分。
+- **安全 loopback shim** —— 随机端口 + 进程内随机 secret，真实 Trae token 不交给 pi-ai。
+
+## 工作原理
+
+```text
+DSH PiAiAdapter
+  -> 安全 loopback shim
+  -> TraeSoloBridge
+  -> https://trae-api-cn.mchost.guru/api/agent/v3/llm_utils_chat
+  -> Trae SSE / pending function_call
+  -> OpenAI SSE tool_calls
+  -> DSH 本地执行工具并回传结果
+```
+
+用量概览走 `https://api.trae.cn/trae/api/v2/pay/*` 与 `/trae/api/v2/ug/*` 只读接口。
+
+> 详见 `docs/IMPLEMENTATION_PLAN.md`、`docs/SOLO_ROUTE_DECISION.md`、`docs/USAGE_API_RESEARCH.md`。
+
+## 安装
+
+推荐使用 DSH 插件命令安装 npm 已发布版本：
+
+```sh
+dsh plugin --profile desktop add dsh-connect-trae
+```
+
+或直接通过 npm 安装：
+
+```sh
+npm install dsh-connect-trae
+```
+
+安装、更新或卸载 bundle 后，需要重启对应的 DSH 进程。
+
+## 开发
+
+```sh
+pnpm install
+pnpm run check   # typecheck + test + build
+```
+
+本地开发用 `link:` 安装到 desktop profile（改码后重启 DSH Desktop 生效）：
+
+```sh
+dsh plugin --profile desktop add /Users/dmh2002/DshProject/dsh-connect-trae
+```
+
+## 致谢
+
+- [Wang-JQ77/dsh-trae-api](https://github.com/Wang-JQ77/dsh-trae-api)（MIT）— Trae 认证、会话和模型协议研究的参照实现。
+
+## 第三方开源依赖
+
+本项目参考的与 Trae 接入直接相关的开源项目，以及它们的许可证与合规说明，见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。引入新的 Trae 相关外部依赖或复用其他项目代码时，请同步更新该文件并遵守对应许可证要求。
+
+## 许可证
+
+本项目采用 [MIT](LICENSE) 许可证，版权归属：**Copyright (c) 2026 LaoDing**。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,18 @@
+# 第三方开源声明（Third-Party Notices）
+
+> 本文件只记录与 Trae 接入直接相关的开源项目及其许可证，确保符合各上游项目的开源许可要求（署名保留、许可文本随分发携带等）。通用平台与构建依赖（`@deepseek-ai/*`、`react`、`typescript`、`tsdown`、`vitest` 等）的许可证随各自 npm 包自动携带，不属于本文档记录范围。若你对本文件的完整性有疑问或发现遗漏，请提交 issue 或 PR。
+
+## 与 Trae 接入相关的参考项目
+
+本项目在设计与实现过程中参考了以下与 Trae 接入直接相关的开源项目，主要用于**架构模式与上游协议研究**。参考方式为"借鉴设计思路 + 独立实现"，未整体复制其源码（关键模块均为本项目独立编写，并在源码注释中标注了所参考的既有模式）。这些项目的版权属于其各自的作者，本项目代码不构成对它们的再分发。
+
+| 参考项目 | 仓库 | 参考内容 | 许可证 |
+| --- | --- | --- | --- |
+| `dsh-trae-api` | <https://github.com/Wang-JQ77/dsh-trae-api> | Trae 上游协议（认证、会话、模型目录）的参考与失败样本分析（见 `docs/ANALYSIS.md`、`docs/ANALYSIS_CONCLUSION.md`、`docs/SOLO_ROUTE_DECISION.md`） | MIT |
+| `laojichao/trae-local-api` | <https://github.com/laojichao/trae-local-api> | `dsh-trae-api` 的直接上游，仅作为 Trae 协议调研线索，本项目未复用其代码（见 `docs/SOLO_ROUTE_DECISION.md`） | 未声明（保留所有权利） |
+
+## 合规说明
+
+- `dsh-trae-api` 使用 **MIT** 宽松许可，与项目自身的 MIT 许可证兼容；`laojichao/trae-local-api` 未声明许可证（保留所有权利），本项目仅将其作为协议调研线索，未复制、修改或分发其代码。
+- MIT 许可要求保留上游版权声明。本项目**不重新打包或再分发**上述参考项目的源码，仅参考其架构思路与协议信息；`docs/` 中的分析文档亦为独立撰写。
+- 若后续引入新的与 Trae 接入相关的依赖或复用其他项目的代码，必须在引入时同步更新本文件，并遵守对应许可证的署名与声明要求。

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# Register the Trae provider without changing the profile's default model.
+- insert:
+    - id: llm-trae
+      name: dsh-connect-trae