magic-agent 2.4.3 → 2.6.0

package/internal/agent/dsh.go

@@ -84,6 +84,7 @@ import (
 	"fmt"
 	"os"
 	"path/filepath"
+	"strconv"
 	"strings"
 	"time"
 )
@@ -170,16 +171,17 @@ func (e *DshEngine) Detect() (bool, string) {
 // 什么的东西」—— 网关列出的上百个模型并不都能用，只有配置里声明过的才会被路由接受。
 // 故**配置层才是权威**，也顺带避免了每次探测都发网络请求 + 需要解密凭据。
 //
-// 配置位置随 dsh 版本变过（见 dshConfigDocs）：0.1.7 起是各 profile 的
-// cordis.patch.yml，之前是 $DSH_HOME/settings.yaml。两处都读、取并集 ——
+// 配置位置随 dsh 版本变过（见 dshConfigDocs）：0.1.7 起是 cordis.patch.yml
+// （profile 级，0.2.1 起也会写在 home 级 $DSH_HOME/cordis.patch.yml），之前是
+// $DSH_HOME/settings.yaml。各处都读、取并集 ——
 // 前者是 SDK 通道，后者是 headless 回退通道，magic-agent 两条都会用到。
 //
 // 输出形态 `provider/model`（与 openclaw 的 `provider/model` 同构）：dsh 的模型只在
 // 所属路由内有意义，同名模型可能出现在两条路由上，裸 id 会歧义。
 //
-// 这份清单**就是** `-m` 的可取值 —— 但只在 SDK 通道下生效（转成 initialize 的
-// provider/model 两个必填参数，见 dshResolveRoute）。回退 headless 后 `-m` 无作用
-// （无 --model 参数），引擎会打一行告警说明该改配置层。
+// 这份清单**就是** `-m` 的可取值：SDK 通道转成 initialize 的 provider/model
+// （见 dshResolveRoute）；headless 通道没有 --model，改由每轮临时 `--patch` 覆盖配置层的
+// agent-default-model（见 dshHeadlessPatchFor）—— 两条通道都能按 -m 换模型。
 func (e *DshEngine) ListModels(_ context.Context) ([]string, error) {
 	docs := dshConfigDocs()
 	var models []string
@@ -202,7 +204,7 @@ func (e *DshEngine) ListModels(_ context.Context) ([]string, error) {
 		tried = strings.Join(paths, "、")
 	}
 	return nil, fmt.Errorf("%w: 没有读到已配置的模型；找过 %s。"+
-		"dsh 0.1.7 起 provider 声明在 profile 的 cordis.patch.yml（可用 dsh 的「设置 → 模型」写入），"+
+		"dsh 0.1.7 起 provider 声明在 cordis.patch.yml（profile 级或 home 级，可用 dsh 的「设置 → 模型」写入），"+
 		"更早的版本在 settings.yaml 的 llm-pi-ai.providers.<id>.models 段",
 		ErrNoModelSource, tried)
 }
@@ -343,27 +345,24 @@ func dshNativeImageMIME(mime string) bool {
 // 形态：`dsh --profile headless [--session-id <id>] "<prompt>"`，stdout 即最终正文。
 // --session-id 是 dsh 自己的续接入口（见 dsh_resume.go），只在续接轮带上。
 func (e *DshEngine) completeHeadless(ctx context.Context, req Request, bin, sessionID, prompt string, start time.Time) (Response, error) {
-	// headless 没有 --model 参数：-m 在这里「不生效」，告警一次（与 arkclaw 一致），
-	// 让用户知道该去改 dsh 自己的配置。显式 Profile: "headless" 也走这里，同样告警。
-	// ⚠️ **续接轮不告警**：那种轮的模型由那条会话自己决定，-m 本来就不该有作用
-	//（客户端每轮都会带 -m，不区分的话每次追问都会刷一行无意义的告警）。
-	if req.Model != "" && sessionID == "" {
-		fmt.Fprintf(stderr, "  ⚠ dsh: headless 通道下 --model %s 不生效（无 --model 参数）；"+
-			"换模型请改 $DSH_HOME/settings.yaml 的 agent-default-model 段，或用 dsh 的 Settings → Models\n", req.Model)
-	}
+	// headless 没有 --model 参数：-m 只能经 `--patch` 覆盖配置层的 agent-default-model
+	//（见 dshHeadlessPatchFor）。拿不到 --patch 才退回「配置默认模型」，并告警一次。
+	patchPath, cleanup := dshHeadlessPatchFor(ctx, bin, req.Model)
+	defer cleanup()
 
-	args := dshHeadlessArgs(e.profile(), sessionID, prompt, false)
+	promptArg, stdinText := dshHeadlessPromptArg(prompt)
+	args := dshHeadlessArgs(e.profile(), sessionID, patchPath, promptArg, false)
 
 	// workspace：dsh 的「调用时所在目录即默认 workspace 根」正是子进程 cwd 的语义。
 	// 档位同 SDK 通道：走 DSH_PERMISSION_MODE（dsh 没有逐调用的权限 flag）。
-	stdout, stderrText, runErr := runCLIEnvIn(ctx, req.Workspace, dshPermissionEnv(req.Permission), bin, args...)
+	stdout, stderrText, runErr := runCLIEnvInStdin(ctx, req.Workspace, dshPermissionEnv(req.Permission), stdinText, bin, args...)
 
 	resp := Response{
 		Engine: e.Name(),
 		// headless 的 stdout 就是最终助手正文（推理增量走 stderr，不混入）。
 		Text: strings.TrimSpace(stdout),
-		// 模型名尽力而为：读 dsh 配置里的默认模型（读不到给 "config-default"）。
-		Model:   dshHeadlessModel(req, sessionID),
+		// 模型标签：本轮真的用哪个（有 -m 且 patch 生效 → -m；否则配置默认）。
+		Model:   dshHeadlessModelLabel(req, patchPath),
 		Latency: time.Since(start),
 	}
 	if resp.Model == "" {
@@ -386,18 +385,19 @@ func (e *DshEngine) completeHeadless(ctx context.Context, req Request, bin, sess
 	return resp, nil
 }
 
-// dshHeadlessModel headless 轮次对外报的模型标签。
+// dshHeadlessModelLabel headless 轮次对外报的模型标签（= 本轮真正用的那个）。
 //
-//	普通 headless 轮：读 $DSH_HOME 配置里的 agent-default-model（读不到返回空串，
-//	                  调用方回落 "config-default"）—— 这轮真的用它。
-//	续接轮：        dsh 不回会话的模型，而配置层默认值**很可能不是**这条会话的模型
-//	                （实测：会话是 modelverse/… 建的，配置默认是 deepseek-v4-flash）。
-//	                调用方每轮都会带同一个 -m（客户端 1 任务 = 1 会话 = 1 模型），
-//	                所以拿它当**最佳近似**比报配置默认值更接近事实。
-func dshHeadlessModel(req Request, sessionID string) string {
-	if sessionID != "" {
-		if m := strings.TrimSpace(req.Model); m != "" {
-			return m
+//	patch 生效（有 -m 且 dsh 支持 --patch）→ 就是 -m 解析出的 `provider/model`
+//	没有 -m                              → 读 $DSH_HOME 的 agent-default-model
+//	                                       （读不到返回空串，调用方回落 "config-default"）
+//
+// 旧实现里续接轮直接回 `req.Model` 当「最佳近似」，但实际跑的是配置默认模型 ——
+// 2026-10-25 用户报障就是被这个假标签误导（界面写 volcengine/…，真实是 minimax/…）。
+// 现在模型真的经 --patch 落到配置层，标签才跟事实一致。
+func dshHeadlessModelLabel(req Request, patchPath string) string {
+	if patchPath != "" {
+		if p, m := dshResolveRoute(req.Model); p != "" && m != "" {
+			return p + "/" + m
 		}
 	}
 	return DshConfiguredModel()
@@ -405,17 +405,26 @@ func dshHeadlessModel(req Request, sessionID string) string {
 
 // dshHeadlessArgs 构造 headless 的参数：**启动器 flag 在前，app 参数在后**。
 //
-//	["--profile", <profile>] [+ "--session-id", <id>] [+ "--json"] + ["<prompt>"]
+//	[--patch <file>] ["--profile", <profile>] [+ "--session-id", <id>] [+ "--json"] + ["<prompt>"]
+//
+// ⚠️ 三类 flag 的归属不同（顺序不能错）：
+//   - `--patch` 是**启动器 flag**（LauncherOptions），必须在 --profile **之前** —— 放在
+//     后面会被 headless 当成未知 app 参数（实测 `dsh --profile headless --patch` → unknown option）。
+//   - --session-id / --json 是 **headless 自己的 flag**，排在 --profile 之后、任务文本之前。
+//   - 启动器在第一个它不认识的 token 处结束解析，剩下的全交给 app。
 //
-// ⚠️ --session-id / --json 是 **headless 自己的 flag**（不是启动器 flag，见 dsh --help），
-// 必须排在 --profile 之后、任务文本之前 —— 启动器在第一个它不认识的 token 处结束解析。
-// prompt 走位置参数（headless 唯一的 app 参数，无 --prompt / stdin 通道），
-// 超长 prompt 会撞 ARG_MAX：需要喂超长文本时先落成文件，让 dsh 用读文件工具看。
+// prompt 默认走位置参数（headless 唯一的 app 参数，无 --prompt）。Windows 上改走 stdin
+// 的 `-`（见 dshHeadlessPromptArg）；位置参数形态下超长 prompt 会撞 ARG_MAX：需要喂超长
+// 文本时先落成文件，让 dsh 用读文件工具看。
 //
 // ⚠️ 只有 headless 用得到它：SDK 通道的 prompt 走 session/prompt 的 contentBlocks
 // （见 dsh_sdk.go），既不占命令行也不受 ARG_MAX 限制。
-func dshHeadlessArgs(profile, sessionID, prompt string, jsonEvents bool) []string {
-	args := []string{"--profile", profile}
+func dshHeadlessArgs(profile, sessionID, patchPath, prompt string, jsonEvents bool) []string {
+	args := make([]string, 0, 8)
+	if patchPath != "" {
+		args = append(args, "--patch", patchPath)
+	}
+	args = append(args, "--profile", profile)
 	if sessionID != "" {
 		args = append(args, "--session-id", sessionID)
 	}
@@ -425,6 +434,67 @@ func dshHeadlessArgs(profile, sessionID, prompt string, jsonEvents bool) []strin
 	return append(args, prompt)
 }
 
+// dshHeadlessPromptArg 决定 headless 的提示词怎么进 dsh：位置参数，还是 stdin（"-"）。
+//
+// Windows 上必须走 stdin：dsh 在 PATH 上解析到 npm 的 `dsh.cmd`，launchWrap 会以
+// `powershell -Command "& 'dsh.cmd' …"` 启动，参数还要再过一层 cmd.exe 的 `%*` 重解析 ——
+// **多行位置参数会被整段丢掉**（2026-10-25 实测：单行正常，带换行的提示词模型收到的是空消息）。
+// dsh 的 headless 原生支持 `-` 读 stdin（help 原文：task `-` reads stdin），走 stdin 既绕开
+// cmd 解析层，也顺带避开 ARG_MAX。unix 无此问题，保持原来的位置参数形态。
+func dshHeadlessPromptArg(prompt string) (arg, stdinText string) {
+	if platformIsWindows() {
+		return "-", prompt
+	}
+	return prompt, ""
+}
+
+// dshHeadlessPatchFor 把本轮 `-m` 落成一份临时 `--patch`（只覆盖 agent-default-model）。
+//
+// 为什么需要：headless 通道**没有 --model**（`dsh --profile headless --help` 只有
+// --json / --session-id），模型只由配置层 agent-default-model 决定；而续接轮又**必须**
+// 走 headless（SDK 没有 resume，见 dsh_resume.go）。2026-10-25 用户报障就是这条缝：
+// 界面选 volcengine/deepseek-v4.1-flash-1017，续接轮实际跑配置默认的 minimax/MiniMax-M3.1-Flash，
+// 报的是 MiniMax 的「Token Plan 用量上限」，看上去像模型选错了。
+//
+// 顶层启动器支持 `dsh --patch <path>`（profile 之上再叠一层），所以每轮按 -m 写一份临时
+// patch，进程结束后删掉 —— 模型选择在续接轮 / 回退轮同样生效。
+//
+// 返回 (路径, 清理函数)；没有 -m / 拆不出 provider/model / dsh 不认 --patch 时返回 "",
+// 此时沿用配置默认模型并告警一次（旧行为，但不再谎报模型）。
+func dshHeadlessPatchFor(ctx context.Context, bin, reqModel string) (string, func()) {
+	model := strings.TrimSpace(reqModel)
+	if model == "" {
+		return "", func() {}
+	}
+	if !dshHeadlessCapabilities(ctx, bin).Patch {
+		fmt.Fprintf(stderr, "  ⚠ dsh: 这台 dsh 不认 --patch，headless 通道无法按 -m %s 换模型"+
+			"（实跑配置默认模型）；请升级 dsh，或改 $DSH_HOME 的 agent-default-model\n", model)
+		return "", func() {}
+	}
+	provider, id := dshResolveRoute(model)
+	if provider == "" || id == "" {
+		fmt.Fprintf(stderr, "  ⚠ dsh: 无法从 -m %s 拆出 provider/model，本轮沿用配置默认模型\n", model)
+		return "", func() {}
+	}
+	f, err := os.CreateTemp("", "magic-agent-dsh-model-*.yml")
+	if err != nil {
+		fmt.Fprintf(stderr, "  ⚠ dsh: 写临时 patch 失败（%v），本轮沿用配置默认模型\n", err)
+		return "", func() {}
+	}
+	// YAML 双引号标量 = JSON 字符串，用 strconv.Quote 免得模型 id 里的特殊字符破坏结构。
+	content := "- id: agent-default-model\n  config:\n    provider: " + strconv.Quote(provider) +
+		"\n    model: " + strconv.Quote(id) + "\n"
+	_, werr := f.WriteString(content)
+	cerr := f.Close()
+	if werr != nil || cerr != nil {
+		_ = os.Remove(f.Name())
+		fmt.Fprintf(stderr, "  ⚠ dsh: 写临时 patch 失败（%v），本轮沿用配置默认模型\n", errors.Join(werr, cerr))
+		return "", func() {}
+	}
+	path := f.Name()
+	return path, func() { _ = os.Remove(path) }
+}
+
 // ── 流式（--stream）────────────────────────────────────────────
 //
 // dsh 的流式形态与通道有关，如实接线：
@@ -532,14 +602,12 @@ func (e *DshEngine) Stream(ctx context.Context, req Request, onEvent func(Stream
 // 有 --json 时按事件流逐条上报（推理 / 正文 / 工具调用，能力与 SDK 通道同构）；
 // 老版本没有 --json 就退回「stderr 推理增量 + stdout 收尾正文」，工具调用拿不到 —— 如实说明。
 func (e *DshEngine) streamHeadless(ctx context.Context, req Request, bin, sessionID, prompt string, onEvent func(StreamEvent), start time.Time) (StreamResult, error) {
-	// 同 completeHeadless：headless 没有 --model；续接轮的模型由会话决定，不告警。
-	if req.Model != "" && sessionID == "" {
-		fmt.Fprintf(stderr, "  ⚠ dsh: headless 通道下 --model %s 不生效（无 --model 参数）；"+
-			"换模型请改 $DSH_HOME/settings.yaml 的 agent-default-model 段，或用 dsh 的 Settings → Models\n", req.Model)
-	}
-
+	// 同 completeHeadless：-m 经 --patch 覆盖配置层（headless 没有 --model）。
 	caps := dshHeadlessCapabilities(ctx, bin)
-	args := dshHeadlessArgs(e.profile(), sessionID, prompt, caps.JSON)
+	patchPath, cleanup := dshHeadlessPatchFor(ctx, bin, req.Model)
+	defer cleanup()
+	promptArg, stdinText := dshHeadlessPromptArg(prompt)
+	args := dshHeadlessArgs(e.profile(), sessionID, patchPath, promptArg, caps.JSON)
 
 	emit := func(ev StreamEvent) {
 		if onEvent != nil {
@@ -607,11 +675,11 @@ func (e *DshEngine) streamHeadless(ctx context.Context, req Request, bin, sessio
 		runErr             error
 	)
 	if caps.JSON {
-		stdout, stderrText, runErr = runStreamLinesIn(ctx, req.Workspace, dshPermissionEnv(req.Permission), bin, args, true, onLine)
+		stdout, stderrText, runErr = runStreamLinesInStdin(ctx, req.Workspace, dshPermissionEnv(req.Permission), stdinText, bin, args, true, onLine)
 	} else {
 		// 老版本：推理增量在 stderr（"dsh: reasoning:" 起头），正文在 stdout 收尾时一次给出。
 		inReasoning := false
-		stdout, stderrText, runErr = runStreamLinesIn(ctx, req.Workspace, dshPermissionEnv(req.Permission), bin, args, false, func(line string) error {
+		stdout, stderrText, runErr = runStreamLinesInStdin(ctx, req.Workspace, dshPermissionEnv(req.Permission), stdinText, bin, args, false, func(line string) error {
 			// 标题行本身不是内容；它出现即进入推理区段。
 			if strings.HasPrefix(line, dshReasoningPrefix) {
 				inReasoning = true
@@ -650,7 +718,7 @@ func (e *DshEngine) streamHeadless(ctx context.Context, req Request, bin, sessio
 	resp := Response{
 		Engine:    e.Name(),
 		Text:      text,
-		Model:     dshHeadlessModel(req, sessionID),
+		Model:     dshHeadlessModelLabel(req, patchPath),
 		SessionID: sid,
 		Latency:   time.Since(start),
 	}
@@ -711,6 +779,9 @@ func DshHome() string {
 //	≤ 0.1.6   $DSH_HOME/settings.yaml（顶层段 agent-default-model / llm-pi-ai）
 //	≥ 0.1.7   各 profile 的 $DSH_HOME/profiles/<name>/cordis.patch.yml
 //	          （settings 体系重构后，providers 由「设置 → 模型」页面写进这份 patch）
+//	≥ 0.2.1   也会写在 home 级 $DSH_HOME/cordis.patch.yml（对所有 profile 生效；
+//	          2026-10-23 实测 0.2.1-rc.2 重写配置后 profile 级 patch 清成空 [],
+//	          provider 只剩 home 级这一份 —— 不读它就整条链空手而归）
 //
 // ⚠️ 0.1.7 首次启动会把旧的 settings.yaml 改名为 settings.yaml.imported
 //（官方 dsh-settings：改名先于首次写入，被组合拒绝的 section 只留在改名后的文件里）。
@@ -740,7 +811,8 @@ func (d dshConfigDoc) legacyText() string {
 //	   （MAGIC_AGENT_DSH_PROFILE 可改；headless 回退通道见 ②）
 //	② headless profile 的 cordis.patch.yml —— SDK 不可用时的回退通道，
 //	   列模型时不能漏（两条通道 magic-agent 都会用到）
-//	③ $DSH_HOME/settings.yaml —— 0.1.7 之前的位置，兼容未升级的装机
+//	③ $DSH_HOME/cordis.patch.yml —— home 级 patch，对所有 profile 生效
+//	④ $DSH_HOME/settings.yaml —— 0.1.7 之前的位置，兼容未升级的装机
 func dshConfigDocs() []dshConfigDoc {
 	home := DshHome()
 	if home == "" {
@@ -750,12 +822,14 @@ func dshConfigDocs() []dshConfigDoc {
 	if names[0] != dshDefaultProfile {
 		names = append(names, dshDefaultProfile)
 	}
-	docs := make([]dshConfigDoc, 0, len(names)+1)
+	docs := make([]dshConfigDoc, 0, len(names)+2)
 	for _, name := range names {
 		p := filepath.Join(home, "profiles", name, "cordis.patch.yml")
 		docs = append(docs, dshConfigDoc{Path: p, Patch: true, Text: readFileOrEmpty(p)})
 	}
-	p := filepath.Join(home, "settings.yaml")
+	p := filepath.Join(home, "cordis.patch.yml")
+	docs = append(docs, dshConfigDoc{Path: p, Patch: true, Text: readFileOrEmpty(p)})
+	p = filepath.Join(home, "settings.yaml")
 	return append(docs, dshConfigDoc{Path: p, Text: readFileOrEmpty(p)})
 }
 

package/internal/agent/dsh_resume.go

@@ -155,10 +155,13 @@ func dshSessionDir() string {
 
 // ── 能力探测：这台 dsh 的 headless 认不认 --session-id / --json ──
 
-// dshHeadlessCaps headless 支持的两个 flag。
+// dshHeadlessCaps headless 支持的两个 flag（外加顶层启动器的 --patch）。
 type dshHeadlessCaps struct {
 	SessionID bool // --session-id（0.1.7+ 才有；没有就当不了真续接）
 	JSON      bool // --json（事件流；没有就走旧版 stderr 推理增量）
+	// Patch 顶层启动器的 `--patch <path>`（在 profile 之上再叠一层配置）。
+	// headless 没有 --model，续接轮要按 -m 换模型只能靠它（见 dshHeadlessModelPatch）。
+	Patch bool
 }
 
 var dshCapsCache sync.Map // bin → dshHeadlessCaps
@@ -176,7 +179,7 @@ func dshHeadlessCapabilities(ctx context.Context, bin string) dshHeadlessCaps {
 	if v, ok := dshCapsCache.Load(bin); ok {
 		return v.(dshHeadlessCaps)
 	}
-	caps := dshHeadlessCaps{SessionID: true, JSON: true}
+	caps := dshHeadlessCaps{SessionID: true, JSON: true, Patch: true}
 	if stdout, stderr, err := runCLI(ctx, bin, "--profile", "headless", "--help"); err == nil {
 		help := stdout + stderr
 		if strings.Contains(help, "Usage:") && strings.Contains(help, "--profile") {
@@ -184,6 +187,14 @@ func dshHeadlessCapabilities(ctx context.Context, bin string) dshHeadlessCaps {
 			caps.JSON = strings.Contains(help, "--json")
 		}
 	}
+	// --patch 是**顶层启动器**的 flag，不在 headless 的 app help 里 —— 单独探一次。
+	// 同样只在输出确实像 help 时才据它判断（否则保留乐观默认 true）。
+	if stdout, stderr, err := runCLI(ctx, bin, "--help"); err == nil {
+		help := stdout + stderr
+		if strings.Contains(help, "Usage:") {
+			caps.Patch = strings.Contains(help, "--patch")
+		}
+	}
 	dshCapsCache.Store(bin, caps)
 	return caps
 }

package/internal/agent/dsh_test.go

@@ -382,22 +382,102 @@ func TestDshHeadlessArgs(t *testing.T) {
 	cases := []struct {
 		name      string
 		sessionID string
+		patch     string
 		json      bool
 		want      []string
 	}{
-		{"纯 headless", "", false, []string{"--profile", "headless", "任务"}},
-		{"续接", "s1", false, []string{"--profile", "headless", "--session-id", "s1", "任务"}},
-		{"事件流", "", true, []string{"--profile", "headless", "--json", "任务"}},
-		{"续接 + 事件流", "s1", true, []string{"--profile", "headless", "--session-id", "s1", "--json", "任务"}},
+		{"纯 headless", "", "", false, []string{"--profile", "headless", "任务"}},
+		{"续接", "s1", "", false, []string{"--profile", "headless", "--session-id", "s1", "任务"}},
+		{"事件流", "", "", true, []string{"--profile", "headless", "--json", "任务"}},
+		{"续接 + 事件流", "s1", "", true, []string{"--profile", "headless", "--session-id", "s1", "--json", "任务"}},
+		// --patch 是**启动器** flag，必须在 --profile 之前（放到后面 headless 会报 unknown option）。
+		{"模型 patch", "s1", "/tmp/p.yml", false,
+			[]string{"--patch", "/tmp/p.yml", "--profile", "headless", "--session-id", "s1", "任务"}},
 	}
 	for _, c := range cases {
-		got := dshHeadlessArgs("headless", c.sessionID, "任务", c.json)
+		got := dshHeadlessArgs("headless", c.sessionID, c.patch, "任务", c.json)
 		if fmt.Sprint(got) != fmt.Sprint(c.want) {
 			t.Errorf("%s: %v want %v", c.name, got, c.want)
 		}
 	}
 }
 
+// headless 提示词传输：Windows 走 stdin（"-"），其余平台保持位置参数。
+func TestDshHeadlessPromptArg(t *testing.T) {
+	arg, stdin := dshHeadlessPromptArg("【用户】\n只回复 OK")
+	if platformIsWindows() {
+		if arg != "-" || stdin != "【用户】\n只回复 OK" {
+			t.Errorf("Windows 应走 stdin：arg=%q stdin=%q", arg, stdin)
+		}
+		return
+	}
+	if arg != "【用户】\n只回复 OK" || stdin != "" {
+		t.Errorf("非 Windows 应走位置参数：arg=%q stdin=%q", arg, stdin)
+	}
+}
+
+// dshHeadlessPatchFor：把 -m 落成 agent-default-model 覆盖；没 -m 不落文件。
+func TestDshHeadlessPatchFor(t *testing.T) {
+	dir := t.TempDir()
+	w, _ := argsCaptureCLI(t, dir, "dsh", `echo 'ok'`)
+
+	if path, cleanup := dshHeadlessPatchFor(context.Background(), w.bin, ""); path != "" {
+		t.Fatalf("没有 -m 不该写 patch，got %q", path)
+	} else {
+		cleanup()
+	}
+
+	path, cleanup := dshHeadlessPatchFor(context.Background(), w.bin, "volcengine/deepseek-v4.1-flash-1017")
+	if path == "" {
+		t.Fatal("有 -m 应写出临时 patch")
+	}
+	data, err := os.ReadFile(path)
+	if err != nil {
+		t.Fatalf("读 patch: %v", err)
+	}
+	body := string(data)
+	for _, want := range []string{"id: agent-default-model", `provider: "volcengine"`, `model: "deepseek-v4.1-flash-1017"`} {
+		if !strings.Contains(body, want) {
+			t.Errorf("patch 内容缺 %q：%q", want, body)
+		}
+	}
+	cleanup()
+	if _, err := os.Stat(path); !os.IsNotExist(err) {
+		t.Errorf("cleanup 应删掉临时 patch，stat err = %v", err)
+	}
+}
+
+// 续接轮把 -m 透成 --patch：模型选择在 headless 通道同样生效（2026-10-25 报障）。
+func TestDshResumePassesModelPatch(t *testing.T) {
+	dir := t.TempDir()
+	w, log := argsCaptureCLI(t, dir, "dsh", `echo 'ok'`)
+
+	resp, err := (&DshEngine{BinPath: w.bin}).Complete(context.Background(), Request{
+		Messages:  []Message{{Role: "user", Content: "hi"}},
+		SessionID: "sess-1",
+		Model:     "volcengine/deepseek-v4.1-flash-1017",
+	})
+	if err != nil {
+		t.Fatalf("Complete: %v", err)
+	}
+	args := readFileString(t, log)
+	var headlessLine string
+	for _, ln := range strings.Split(args, "\n") {
+		if strings.Contains(ln, "--patch") {
+			headlessLine = ln
+		}
+	}
+	if headlessLine == "" {
+		t.Fatalf("续接轮应带 --patch（headless 没有 --model）：%q", args)
+	}
+	if strings.Index(headlessLine, "--patch") > strings.Index(headlessLine, "--profile") {
+		t.Errorf("--patch 必须排在 --profile 之前：%q", headlessLine)
+	}
+	if resp.Model != "volcengine/deepseek-v4.1-flash-1017" {
+		t.Errorf("Model = %q want 本轮 -m 指定的那条路由", resp.Model)
+	}
+}
+
 // -c/--continue：按会话登记表找**同一 workspace** 下最近一条 dsh 会话（其它引擎不算）。
 func TestDshLatestSessionIDPrefersWorkspace(t *testing.T) {
 	sess := t.TempDir()
@@ -870,6 +950,28 @@ func TestDshListModelsFromProfilePatch(t *testing.T) {
 	}
 }
 
+// home 级 $DSH_HOME/cordis.patch.yml（对所有 profile 生效）也要进探测链：
+// 2026-10-23 实测 dsh 0.2.1-rc.2 重写配置后 profile 级 patch 清成空 []，
+// provider 只剩 home 级这一份，不读它就整条链空手而归。
+func TestDshListModelsFromHomePatch(t *testing.T) {
+	t.Setenv("MAGIC_AGENT_DSH_PROFILE", "")
+	home := writeDshPatch(t, "sdk", "[]\n")
+	if err := os.WriteFile(filepath.Join(home, "cordis.patch.yml"),
+		[]byte("- id: llm-pi-ai\n  config:\n    providers:\n      minimax:\n        models:\n          - id: MiniMax-M3.1-Flash\n"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	t.Setenv("DSH_HOME", home)
+
+	got, err := (&DshEngine{}).ListModels(context.Background())
+	if err != nil {
+		t.Fatalf("ListModels: %v", err)
+	}
+	want := []string{"minimax/MiniMax-M3.1-Flash"}
+	if !equalStrings(got, want) {
+		t.Errorf("ListModels() = %v\n want %v", got, want)
+	}
+}
+
 // 两条通道（sdk + headless 回退）的 patch 取并集：magic-agent 两条都会用到。
 func TestDshListModelsUnionAcrossProfiles(t *testing.T) {
 	t.Setenv("MAGIC_AGENT_DSH_PROFILE", "")
@@ -1175,7 +1277,7 @@ func TestDshIgnoredParamsProduceNoFlags(t *testing.T) {
 	_ = req.Temperature
 	_ = req.Tools
 	_ = req.Timeout
-	args := dshHeadlessArgs(e.profile(), "", "【用户】\nhi", false)
+	args := dshHeadlessArgs(e.profile(), "", "", "【用户】\nhi", false)
 	want := []string{"--profile", "headless", "【用户】\nhi"}
 	if fmt.Sprint(args) != fmt.Sprint(want) {
 		t.Errorf("headless args = %v want %v", args, want)

package/internal/agent/engine.go

@@ -12,7 +12,7 @@
 //	prompt.go      — 多轮消息扁平化为单条 prompt 的公共逻辑
 //	claude.go      — Claude Code CLI 引擎（--print --output-format json）
 //	codebuddy.go   — CodeBuddy Code CLI 引擎（一个独立 CLI、两个账号）
-//	trae.go        — Trae CLI 引擎（-p，无 --model flag，-c model.name= 覆盖）
+//	trae.go        — TRAE CLI 2.0 引擎（exec --json，-m 指定模型）
 //	llmengine.go   — simonw/LLM CLI 引擎（-m / -s / -o 透传）
 //	codex.go       — Codex CLI 引擎（exec / exec resume + --output-schema）
 //	openclaw.go    — OpenClaw CLI 引擎（agent --local --json）
@@ -92,6 +92,24 @@ type Request struct {
 	// 引擎实现负责剥掉可能的 "engine/model" 前缀。
 	Model string
 
+	// FallbackEngine / FallbackModel 主引擎失败时的**备用引擎**（2026-10-24）。
+	//
+	// 只在「主引擎只有过程、没有正文」时降级（见 fallback.go）：已经流出正文再换
+	// 模型重来，用户会看到两段互相矛盾的答案。降级时 SessionID / Continue 一律清空 ——
+	// 备用引擎没有主引擎那条会话，拿旧 id 去 resume 只会报「会话不存在」。
+	// 空引擎 = 没配备用，行为与以前完全一致。引擎实现不读这两个字段。
+	FallbackEngine string
+	FallbackModel  string
+
+	// FallbackDown 降级标记：为 true 时本轮请求**本身就是备用引擎在跑**（见 fallback.go）。
+	//
+	// 为什么要有它（2026-10-26 修「主备没真的发挥作用」）：模型清单只属于它自己的引擎。
+	// 用户配的备用模型（如 codebuddy 的 `hy3`）拿到别的引擎上只会吃一句
+	// `--model hy3 未知`，于是备用「跑了但没用」。fallbackTarget 因此清空 Model，
+	// 这个字段让引擎侧在 Model 为空时**不要回落到自己的默认模型** —— 配置里的备用模型
+	// 作废时「用备用引擎自己的默认模型重跑」比「带着一个必然失败的模型再失败一次」有用。
+	FallbackDown bool
+
 	// SystemPrompt 可选系统提示词。各引擎自行决定注入方式
 	//（claude/codebuddy用 --append-system-prompt，trae 拼进 prompt 头）。
 	SystemPrompt string
@@ -211,6 +229,24 @@ type Request struct {
 	// 默认值是否开启按引擎区分，见 AppendDefaultOn（dsh 默认关）。
 	Append <-chan string
 
+	// Reply 原生控制应答通道（可写回引擎自己的控制协议行）。
+	//
+	// 为什么需要（2026-10-25 实测）：codebuddy / claude 在 headless 下遇到需要宿主裁决的动作
+	// （计划审批 ExitPlanMode、manual 档下的工具授权）时会发一行
+	//
+	//	{"type":"control_request","request_id":"perm_…","request":{"subtype":"can_use_tool",…}}
+	//
+	// 然后**原地等 stdin 上的 control_response**。不回就整轮挂住（用户侧看到的是
+	// 「转圈、没有审批卡」）。回的内容必须走子进程 stdin —— 不能当成下一条 user 消息，
+	// 那时 CLI 正阻塞在控制请求上，user 消息要等到这一轮结束才会被读。
+	//
+	// 语义：非 nil 时本次调用的 stdin 会**保持打开**（首条 user 消息之后不 EOF），
+	// 通道里每收到一行就原样写进子进程 stdin；这一轮收尾（turn_end / result / error）
+	// 或 Stream 返回时关掉写端，让 CLI 正常退出。
+	// 只有 stream-json 输入通道的引擎（claude / codebuddy / codebuddy-ai）支持；其余引擎
+	// 拿到非 nil 会在 CLI 层被挡下（见 AppendSupportOf）。
+	Reply <-chan string
+
 	// OnSessionID 引擎发现 session_id 时回调（用于「看历史」持久化）。
 	//
 	// 谁需要它：CLI 在 runStreamAsk 里包一个 sessionWriter，每条事件落盘到

package/internal/agent/engine_base.go

@@ -22,16 +22,16 @@ import (
 //	┌──────────────┬──────────────────────────┬───────────────────────────┬────────────────────────────┬──────────────────┬───────────────────────┬─────────────────────┬──────────────────────┐
 //	│ Request 字段 │ claude                   │ codebuddy                 │ trae                       │ llm              │ codex                 │ openclaw            │ dsh                  │
 //	├──────────────┼──────────────────────────┼───────────────────────────┼────────────────────────────┼──────────────────┼───────────────────────┼─────────────────────┼──────────────────────┤
-//	│ Model        │ --model <m>              │ --model <m>               │ -c model.name=<m>          │ -m <m>           │ -m <m>                │ --model <m>         │ 不支持（配置层）⑨    │
-//	│ SessionID    │ --resume <id>            │ --resume <id>             │ --resume=<id>              │ --cid <id>       │ exec resume <id>      │ --session-id <id>   │ 不支持（显式报错）⑨  │
-//	│ Continue     │ --continue               │ --continue                │ --resume（自动选最近会话） │ -c               │ resume --last         │ sessions 查最新 id  │ 不支持（显式报错）⑨  │
+//	│ Model        │ --model <m>              │ --model <m>               │ -m <m>                     │ -m <m>           │ -m <m>                │ --model <m>         │ 不支持（配置层）⑨    │
+//	│ SessionID    │ --resume <id>            │ --resume <id>             │ exec resume <id>           │ --cid <id>       │ exec resume <id>      │ --session-id <id>   │ 不支持（显式报错）⑨  │
+//	│ Continue     │ --continue               │ --continue                │ exec resume --last         │ -c               │ resume --last         │ sessions 查最新 id  │ 不支持（显式报错）⑨  │
 //	│ MaxTokens    │ --settings（env 注入）①  │ --settings（env 注入）①   │ 不支持（静默忽略）②        │ -o max_tokens    │ 不支持（静默忽略）②   │ 静默忽略②           │ 静默忽略②            │
 //	│ Temperature  │ 不支持                   │ 不支持                    │ 不支持（静默忽略）②        │ -o temperature   │ 不支持（静默忽略）②   │ 静默忽略②           │ 静默忽略②            │
 //	│ Reasoning    │ --effort <l>             │ --effort <l>              │ 不支持（忽略）             │ 不支持           │ -c reasoning_effort   │ 不支持              │ 不支持               │
 //	│ Tools        │ --tools / 档位③         │ --tools / 档位③          │ --disallowed-tool / 全放行③│ 不支持           │ -s 沙箱档位④          │ 内嵌 agent（忽略）  │ 内嵌 agent（忽略）⑨  │
-//	│ Permission   │ --permission-mode⑧      │ --permission-mode⑧        │ 未接线（yaml 配置）        │ 不支持           │ 未接线（沙箱×审批两轴）│ 未接线（exec.mode） │ 未接线（配置层预设）⑨│
+//	│ Permission   │ --permission-mode⑧      │ --permission-mode⑧        │ 未接线（仅 -y）            │ 不支持           │ 未接线（沙箱×审批两轴）│ 未接线（exec.mode） │ 未接线（配置层预设）⑨│
 //	│ SystemPrompt │ --append-system-prompt   │ --append-system-prompt    │ 展平进 prompt 头部         │ -s               │ -c developer_instr.⑤  │ 展平进 prompt 头部  │ 展平进 prompt 头部   │
-//	│ Timeout      │ 进程级超时               │ 进程级超时                │ + --query-timeout          │ 进程级超时       │ 进程级超时            │ + --timeout <sec>   │ 进程级超时           │
+//	│ Timeout      │ 进程级超时               │ 进程级超时                │ 进程级超时                 │ 进程级超时       │ 进程级超时            │ + --timeout <sec>   │ 进程级超时           │
 //	│ JSONSchema   │ 不支持                   │ 不支持                    │ 不支持                     │ 输出后处理抽 JSON│ --output-schema 原生  │ 输出后处理抽 JSON   │ 输出后处理抽 JSON    │
 //	│ Workspace    │ 子进程 cwd⑥              │ 子进程 cwd⑥               │ 子进程 cwd⑥                │ 不支持⑦          │ -C/--cd + cwd⑥        │ 不支持⑦             │ 子进程 cwd⑥          │
 //	└──────────────┴──────────────────────────┴───────────────────────────┴────────────────────────────┴──────────────────┴───────────────────────┴─────────────────────┴──────────────────────┘
@@ -41,11 +41,10 @@ import (
 //
 //	注入输出上限（已用真实 CLI --help 验证）；两者无 temperature 原生参数，也无对应 settings 键。
 //
-// ② trae 的 `-c <k>=<v>` 会整体覆盖模型配置块（实测设置 model.max_tokens 后模型名漂移并触发配额错误），
-//
-//	因此 MaxTokens / Temperature 在 trae 上明确不支持；codex 实测 `-c model_max_output_tokens=` /
-//	`-c temperature=` 会被 CLI 静默忽略（无对应生效键）；openclaw agent 无相关 flag ——
-//	三者构造参数时统一静默忽略。
+// ② trae 2.0 的 exec 没有 max-tokens / temperature 原生参数（1.x 的 `-c` 覆盖
+// 会整体替换模型配置块，曾实测导致模型名漂移），因此这两项在 trae 上明确不支持；
+// codex 实测 `-c model_max_output_tokens=` / `-c temperature=` 会被 CLI 静默忽略
+// （无对应生效键）；openclaw agent 无相关 flag —— 三者构造参数时统一静默忽略。
 //
 // ③ Tools 语义：关闭 = claude/codebuddy `--tools ""`；trae `--disallowed-tool`
 //
@@ -53,7 +52,7 @@ import (
 //	开启 = claude/codebuddy `--permission-mode <档位>`（四档模型，见 ⑧ 与 permission.go；
 //	改造前恒传 `--dangerously-skip-permissions` / `-y` = 第 4 档）；trae `-y`。
 //	白名单 = claude/codebuddy `--tools a,b` + `--permission-mode <档位>`；trae **无收窄能力**
-//	（`--allowed-tool` 只做自动批准、不裁剪工具集，实测仍下发全部 18 个工具），
+//	（`--allowed-tool` 只做自动批准、不裁剪工具集，实测仍下发全部工具），
 //	故白名单降级为「默认开启所有工具」= 全放行 `-y`，与 codex 的白名单降级同构。
 //	llm 无工具概念。
 //
@@ -170,10 +169,15 @@ var (
 		binName: "trae-cli",
 		envVar:  "MAGIC_AGENT_TRAE_BIN",
 		candidates: []string{
+			// TRAE CLI 2.0 的官方 v2 安装器落点：主程序 traex，
+			// 同目录还有 trae-cli / traecli 兼容入口（.cmd / 符号链接）。
+			"~/AppData/Local/Programs/TraeCLI/bin/traex.exe",
+			"~/.local/bin/traex",
+			"~/.trae/cli/current/traex",
+			// 兼容入口（PATH 不干净时的兜底）
 			"~/.local/bin/trae-cli",
-			"~/bin/trae-cli",
 		},
-		notFound: "trae-cli not found (install trae-cli or set MAGIC_AGENT_TRAE_BIN)",
+		notFound: "TRAE CLI not found (install TRAE CLI or set MAGIC_AGENT_TRAE_BIN)",
 	}
 	llmBase = cliBase{
 		binName: "llm",
@@ -370,9 +374,9 @@ func WorkspaceSupportOf(engine string) string {
 //	codex     npm install -g @openai/codex
 //	openclaw  npm install -g openclaw@latest（官方文档；装完通常还要 openclaw onboard --install-daemon）
 //	dsh       npm i -g @deepseek-ai/dsh
-//	trae      sh -c "$(curl -L https://trae.cn/trae-cli/install.sh)"
-//	          （官方 TraeCode CLI 安装脚本，落在 ~/.local/bin —— 正是本包探测链的候选位，
-//	           故不必在同一行里 export PATH）
+//	trae      sh -c "$(curl -fsSL https://trae.cn/trae-cli/install_v2.sh)"
+//	          （官方 TRAE CLI 2.0 安装脚本；Windows 用
+//	           `irm https://trae.cn/trae-cli/install_v2.ps1 | iex`。1.x 已不再支持）
 //	llm       python3 -m venv ~/.llm-venv && ~/.llm-venv/bin/pip install llm
 //	          （与 npm postinstall 同一条隔离安装路径，避开系统 Python；另有 pip / pipx / brew）
 //
@@ -400,7 +404,7 @@ func InstallCommandOf(engine string) string {
 	case "dsh":
 		return "npm i -g @deepseek-ai/dsh"
 	case "trae":
-		return `sh -c "$(curl -L https://trae.cn/trae-cli/install.sh)"`
+		return `sh -c "$(curl -fsSL https://trae.cn/trae-cli/install_v2.sh)"`
 	case "llm":
 		return "python3 -m venv ~/.llm-venv && ~/.llm-venv/bin/pip install llm"
 	}