trae-solo-local-api

项目说明（2026-07-31）：TRAE WORK 已改用积分制并取消免费政策，本项目后续随缘更新。仓库中的模型思考 prompt 前缀注入方案可能仍有一定研究价值，欢迎自行研究和验证。

把 TRAE SOLO (Trae Work) 包装成本地 OpenAI / Anthropic 兼容 API，供 Claude Code、Cursor、Cline、OpenCode 等调用 SOLO 底层模型。

• 本仓库：https://github.com/Ttungx/trae-solo-local-api
• 上游：https://github.com/ZedeX/trae-local-api

本仓库是 SOLO 适配分支，不是官方上游。

默认按 SOLO 轻路径。未完成：完整 create_agent_task 对齐（见 TODO.md）。

git clone https://github.com/Ttungx/trae-solo-local-api.git
cd trae-solo-local-api
npm install
cp .env.example .env   # TRAE_PRODUCT=solo
npm start

服务：http://localhost:19900
Key：.env 的 API_KEY

curl -s http://localhost:19900/v1/status \
  -H "Authorization: Bearer trae-solo-local-api-key"

curl -s http://localhost:19900/v1/chat/completions \
  -H "Authorization: Bearer trae-solo-local-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.2","messages":[{"role":"user","content":"hi"}],"stream":false}'

日志应出现 function=solo_work_lite, config_name=glm-5.2。

主对话端点：

鉴权（三选一）：

• Authorization: Bearer <API_KEY>
• x-api-key: <API_KEY>
• ?key=<API_KEY>

错误体（OpenAI 兼容路径）：

{ "error": { "message": "...", "type": "invalid_request_error", "code": "..." } }

/v1/messages 仍使用 Anthropic 错误格式。

$env:ANTHROPIC_BASE_URL = "http://localhost:19900"
$env:ANTHROPIC_API_KEY = "trae-solo-local-api-key"
claude

Cursor / Cline / OpenCode：Base URL http://localhost:19900/v1，Key 同上，Model 推荐 auto 或 glm-5.2。

SOLO llm_utils_chat 没有原生 reasoning_effort 参数。本项目在网关层按模型族把固定字符串 prepend 到 system 顶部，实现“曲线救国”。

灵感来源：Controlling Reasoning Effort in LLMs

取值：auto（默认，不注入） | off | low | high | max

不支持的模型/档位 → 静默 no-op，请求仍成功。换模/降级时会按新 config_name 重新计算前缀。

能力查询：GET /v1/think-effort

来源说明（注入字符串来源于官方仓库与技术报告，本地 probe 验证有效）：

• DeepSeek-V4 Absolute-max 长串：官方 HF encoding/README
  https://huggingface.co/deepseek-ai/DeepSeek-V4-Flash/blob/main/encoding/README.md

• GLM-5.2：官方 HF chat_template.jinja
  https://huggingface.co/zai-org/GLM-5.2/blob/main/chat_template.jinja

• 通用 reasoning effort 训练机制：Sebastian Raschka - Controlling Reasoning Effort in LLMs
  https://magazine.sebastianraschka.com/p/controlling-reasoning-effort-in-llms

• Kimi 低思考约束：社区逆向 + 训练技术（截断暴露疗法等），详见 think effort/AI模型推理指令挖掘.md

其他模型（含 auto）：think_effort 忽略。

curl -s http://localhost:19900/v1/chat/completions \
  -H "Authorization: Bearer trae-solo-local-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "DeepSeek-V4-Pro",
    "think_effort": "max",
    "messages": [{"role": "user", "content": "findMin in rotated sorted array"}],
    "stream": false
  }'

日志应出现 [think_effort ...] injected=yes。

SOLO 有时只输出 reasoning 就结束，导致 OpenCode 等客户端“正常结束但没答案”。

本项目在服务端统一处理（OpenAI + Anthropic 共用逻辑）：

• 只有思考、无正文、无 tool → 自动再请求
• 半截输出（未闭合代码块、句尾断裂等）→ 自动续
• finish_reason=length → 自动续
• 上限默认 10 次（MAX_CONTINUES）

配置（.env）：

AUTO_CONTINUE=true
MAX_CONTINUES=10

日志关键字：auto_continue ... reason=reasoning_only

src/           核心服务 + 客户端
  think-effort.js
  auto-continue.js
  api-catalog.js
  errors.js
web/           Dashboard
scripts/       模型拉取 / probe
doc/           设计文档
model-config.json
SOLO_PARITY.md
TODO.md
.env.example

同步官方模型表：

node scripts/dump-model-detail.js
# 结果在 output/（已 gitignore）

仅供学习研究。遵守 SOLO / Trae 服务条款。