magic-agent 1.0.3 → 1.0.49

package/internal/client/service_test.go

@@ -5,13 +5,20 @@ import (
 	"bytes"
 	"encoding/json"
 	"fmt"
+	"image"
+	"image/png"
 	"io"
+	"mime/multipart"
 	"net/http"
 	"net/http/httptest"
+	"net/url"
 	"os"
 	"path/filepath"
 	"strings"
 	"testing"
+	"time"
+
+	"github.com/darren/magic-agent/internal/session"
 )
 
 // fakeCore 写一个假的 magic-agent 脚本：既能回答 --contract / --engines，
@@ -32,12 +39,16 @@ case "$*" in
     exit 0
     ;;
   *--sessions*)
-    echo '[{"run_id":"run-1","session_id":"sess-1","engine":"claude","state":"done"}]'
+    echo '[{"run_id":"run-1","session_id":"sess-1","engine":"claude","state":"done","source":"pc","client":"magic-client"},
+           {"run_id":"run-2","session_id":"sess-2","engine":"claude","state":"done"},
+           {"run_id":"run-3","session_id":"sess-3","engine":"claude","state":"done","client":"other-app"},
+           {"run_id":"run-4","session_id":"sess-4","engine":"claude","state":"done","source":"pc","client":"magic-test"}]'
     exit 0
     ;;
 esac
-# 把收到的参数也回显成一行事件：让「插件有没有把 --session 透传下去」变成可断言的事实。
-printf '{"v":1,"seq":0,"type":"args","raw":"%s"}\n' "$*"
+# 把收到的参数与来源客户端环境变量一起回显成一行事件：让「插件有没有把 --session 透传下去」
+# 与「有没有注入 MAGIC_AGENT_CLIENT」都变成可断言的事实。
+printf '{"v":1,"seq":0,"type":"args","raw":"%s","client":"%s"}\n' "$*" "$MAGIC_AGENT_CLIENT"
 echo '{"v":1,"seq":1,"type":"ready","engine":"claude"}'
 echo '{"v":1,"seq":2,"type":"text","text":"hi"}'
 while IFS= read -r line; do
@@ -110,46 +121,21 @@ func TestAuthRequired(t *testing.T) {
 	}
 	defer resp.Body.Close()
 	if resp.StatusCode != http.StatusUnauthorized {
-		t.Errorf("无令牌访问 /desk/health 应 401，实际 %d", resp.StatusCode)
-	}
-
-	req, _ := http.NewRequest(http.MethodGet, srv.URL+"/desk/health", nil)
-	req.Header.Set("X-Magic-Token", "tok")
-	resp2, err := http.DefaultClient.Do(req)
-	if err != nil {
-		t.Fatal(err)
-	}
-	defer resp2.Body.Close()
-	if resp2.StatusCode != http.StatusOK {
-		t.Errorf("带令牌应 200，实际 %d", resp2.StatusCode)
-	}
-	var health struct {
-		OK              bool     `json:"ok"`
-		ContractVersion int      `json:"contractVersion"`
-		Features        []string `json:"features"`
-	}
-	if err := json.NewDecoder(resp2.Body).Decode(&health); err != nil {
-		t.Fatal(err)
-	}
-	if !health.OK || health.ContractVersion != 1 || len(health.Features) != 2 {
-		t.Errorf("health 内容不对: %+v", health)
+		t.Errorf("/desk/health 无令牌应 401，实际 %d", resp.StatusCode)
 	}
 }
 
-// TestProfileGateEngine profile 白名单之外的引擎必须被拦住（403），
-// 否则「按需个性化配置」就是一句空话。
 func TestProfileGateEngine(t *testing.T) {
-	core := fakeCore(t, goodContract)
 	prof := DefaultProfile()
 	prof.Engines = []string{"claude"}
-	svc, err := New(Options{MagicAgent: core, Profile: prof, Token: "tok"})
+	svc, err := New(Options{MagicAgent: fakeCore(t, goodContract), Profile: prof, Token: "tok"})
 	if err != nil {
 		t.Fatal(err)
 	}
 	srv := httptest.NewServer(svc.Handler())
 	defer srv.Close()
 
-	body, _ := json.Marshal(askRequest{Engine: "codex", Prompt: "x"})
+	body, _ := json.Marshal(askRequest{Engine: "codex", Prompt: "hi"})
 	req, _ := http.NewRequest(http.MethodPost, srv.URL+"/desk/ask", bytes.NewReader(body))
 	req.Header.Set("X-Magic-Token", "tok")
 	resp, err := http.DefaultClient.Do(req)
@@ -158,11 +144,10 @@ func TestProfileGateEngine(t *testing.T) {
 	}
 	defer resp.Body.Close()
 	if resp.StatusCode != http.StatusForbidden {
-		t.Errorf("白名单外的引擎应 403，实际 %d", resp.StatusCode)
+		t.Errorf("白名单外引擎应 403，实际 %d", resp.StatusCode)
 	}
 }
 
-// sseReader 逐行读 SSE（data: 后面的 JSON）。
 type sseReader struct {
 	sc   *bufio.Scanner
 	resp *http.Response
@@ -208,6 +193,61 @@ func (r *sseReader) next(t *testing.T) map[string]any {
 
 func (r *sseReader) close() { _ = r.resp.Body.Close() }
 
+// fakeSilentCore 写一个「首段输出前长时间静默」的假 core —— 复现 2026-10-19 手机端
+// 17.7s「连接中断」的真实场景：核心在冷启动/长思考时几十秒不吐一行，期间服务端
+// 一个字节都不写，移动网络或 WebView 就会把这条 SSE 当成死连接掐掉。
+func fakeSilentCore(t *testing.T, contract string) string {
+	t.Helper()
+	dir := t.TempDir()
+	path := filepath.Join(dir, "magic-agent")
+	script := `#!/bin/sh
+case "$*" in
+  *--contract*)
+    echo '` + contract + `'
+    exit 0
+    ;;
+  *--engines*)
+    echo '[{"engine":"claude","ok":true,"capabilities":["session.stream"]}]'
+    exit 0
+    ;;
+esac
+sleep 12
+echo '{"v":1,"seq":1,"type":"result","text":"hi"}'
+`
+	if err := os.WriteFile(path, []byte(script), 0o755); err != nil {
+		t.Fatal(err)
+	}
+	return path
+}
+
+// TestAskSendsHeartbeatDuringSilence core 长时间不输出时，SSE 必须持续有心跳帧 ——
+// 否则手机端会在首段回复到达前就把连接掐掉（用户看到「没有收到回复 · 连接中断」，
+// 而服务端任务其实完整跑完了）。心跳用 SSE 注释帧（`: ping`），解析端会忽略。
+func TestAskSendsHeartbeatDuringSilence(t *testing.T) {
+	svc := newTestService(t, fakeSilentCore(t, goodContract))
+	srv := httptest.NewServer(svc.Handler())
+	defer srv.Close()
+
+	sse := openSSE(t, srv.URL, "tok", askRequest{Engine: "claude", Prompt: "长时间思考"})
+	defer sse.close()
+	_ = sse.next(t) // open
+
+	ping := make(chan struct{})
+	go func() {
+		for sse.sc.Scan() {
+			if strings.HasPrefix(strings.TrimSpace(sse.sc.Text()), ": ping") {
+				close(ping)
+				return
+			}
+		}
+	}()
+	select {
+	case <-ping:
+	case <-time.After(12 * time.Second):
+		t.Fatal("静默超过 10s 仍未收到 SSE 心跳（': ping'）")
+	}
+}
+
 // TestAskRelaysAndControl 中继与控制通道的端到端：
 //  1. core 的每一行原样到达客户端（顺序与内容都不改）；
 //  2. `POST /desk/ask/{id}/control` 写进 core 的 stdin（假 core 会回显，构成可断言证据）。
@@ -280,7 +320,13 @@ func TestAskRelaysAndControl(t *testing.T) {
 	}
 }
 
-// TestSessionsProxy 列表页要的是 core 的**持久会话登记表**（`--sessions`）。
+// TestSessionsProxy 列表页要的是 core 的**持久会话登记表**（`--sessions`），
+// 且只回「本客户端 + 同族 magic-* 来源」那些（原口径见用户 2026-10-12
+// 「不是 magic-agent 客户端调用的任务不显示」；2026-10-15 放宽到名单，见 extraSessionClients）。
+//
+// 登记表目录是全机共享的，假 core 故意返回四种来源：本客户端的、没有 client 的
+// （= 直接跑 CLI / 旧记录）、别的应用的、掌天瓶（magic-test）的 —— 匿名那条与别家应用仍被滤掉，
+// 留下本客户端的 sess-1 与掌天瓶的 sess-4。
 func TestSessionsProxy(t *testing.T) {
 	svc := newTestService(t, fakeCore(t, goodContract))
 	srv := httptest.NewServer(svc.Handler())
@@ -299,33 +345,83 @@ func TestSessionsProxy(t *testing.T) {
 	var rows []struct {
 		RunID     string `json:"run_id"`
 		SessionID string `json:"session_id"`
+		Client    string `json:"client"`
+		Source    string `json:"source"`
 	}
 	if err := json.NewDecoder(resp.Body).Decode(&rows); err != nil {
 		t.Fatal(err)
 	}
-	if len(rows) != 1 || rows[0].SessionID != "sess-1" {
-		t.Errorf("应原样转发 core 的会话表，实际 %+v", rows)
+	if len(rows) != 2 {
+		t.Fatalf("应只剩本客户端与 magic-test 的会话（2 条），实际 %d: %+v", len(rows), rows)
+	}
+	if rows[0].RunID != "run-1" || rows[1].RunID != "run-4" {
+		t.Errorf("过滤结果不对：%+v", rows)
 	}
 }
 
-// TestAskPassesSession 续接参数必须透传到 core 的 `--session` ——
-// 否则「点历史会话继续」会静默变成新会话（用户看到的是「它不记得上一轮」）。
-func TestAskPassesSession(t *testing.T) {
+func TestAskPassesSaveHistory(t *testing.T) {
 	svc := newTestService(t, fakeCore(t, goodContract))
 	srv := httptest.NewServer(svc.Handler())
 	defer srv.Close()
 
-	sse := openSSE(t, srv.URL, "tok", askRequest{Engine: "claude", Prompt: "接着上一轮", Session: "sess-1"})
+	sse := openSSE(t, srv.URL, "tok", askRequest{Engine: "claude", Prompt: "hi"})
 	defer sse.close()
-	_ = sse.next(t) // open
+	_ = sse.next(t)
+	raw, _ := sse.next(t)["raw"].(string)
+	if !strings.Contains(raw, "--save-registry") || !strings.Contains(raw, "--save-history") {
+		t.Errorf("core 应收到两个存档开关，实际 %q", raw)
+	}
+}
+
+func TestAskInjectsClientEnv(t *testing.T) {
+	svc := newTestService(t, fakeCore(t, goodContract))
+	srv := httptest.NewServer(svc.Handler())
+	defer srv.Close()
+
+	sse := openSSE(t, srv.URL, "tok", askRequest{Engine: "claude", Prompt: "hi", Client: "mobile"})
+	defer sse.close()
+	_ = sse.next(t)
+	var ev map[string]any
+	for ev == nil || ev["type"] != "args" {
+		ev = sse.next(t)
+	}
+	if got, _ := ev["client"].(string); got != "" && !strings.Contains(got, "magic") {
+		t.Errorf("MAGIC_AGENT_CLIENT 应为本插件 AppID，实际 %q", got)
+	}
+}
+
+func TestAskInjectsProfileAppID(t *testing.T) {
+	prof := DefaultProfile()
+	prof.App.BundleID = "magic-test"
+	svc, err := New(Options{MagicAgent: fakeCore(t, goodContract), Profile: prof, Token: "tok"})
+	if err != nil {
+		t.Fatal(err)
+	}
+	srv := httptest.NewServer(svc.Handler())
+	defer srv.Close()
 
-	args := sse.next(t)
-	raw, _ := args["raw"].(string)
-	if !strings.Contains(raw, "--session sess-1") {
-		t.Errorf("core 收到的参数里应有 --session sess-1，实际 %q", raw)
+	sse := openSSE(t, srv.URL, "tok", askRequest{Engine: "claude", Prompt: "hi"})
+	defer sse.close()
+	_ = sse.next(t)
+	var ev map[string]any
+	for ev == nil || ev["type"] != "args" {
+		ev = sse.next(t)
+	}
+	if got, _ := ev["client"].(string); got != "magic-test" {
+		t.Errorf("MAGIC_AGENT_CLIENT 应为 profile AppID，实际 %q", got)
 	}
-	if !strings.Contains(raw, "--events") || !strings.Contains(raw, "--control") {
-		t.Errorf("core 收到的参数里应有 --events 与 --control，实际 %q", raw)
+}
+
+func TestAskPassesSession(t *testing.T) {
+	svc := newTestService(t, fakeCore(t, goodContract))
+	srv := httptest.NewServer(svc.Handler())
+	defer srv.Close()
+
+	sse := openSSE(t, srv.URL, "tok", askRequest{Engine: "claude", Prompt: "继续", Session: "sess-1"})
+	defer sse.close()
+	_ = sse.next(t)
+	if raw, _ := sse.next(t)["raw"].(string); !strings.Contains(raw, "--session sess-1") {
+		t.Errorf("应透传 --session sess-1，实际 %q", raw)
 	}
 }
 
@@ -369,14 +465,12 @@ func TestAskPassesPermission(t *testing.T) {
 	}
 }
 
-// TestProjectAPINotConfigured 没配项目后端时 `/api/*` 回 501 并**点名 profile 字段**，
-// 不静默 404（静默 404 会让人以为是模块前端写错了）。
 func TestProjectAPINotConfigured(t *testing.T) {
 	svc := newTestService(t, fakeCore(t, goodContract))
 	srv := httptest.NewServer(svc.Handler())
 	defer srv.Close()
 
-	req, _ := http.NewRequest(http.MethodGet, srv.URL+"/api/docs", nil)
+	req, _ := http.NewRequest(http.MethodGet, srv.URL+"/api/x", nil)
 	req.Header.Set("X-Magic-Token", "tok")
 	resp, err := http.DefaultClient.Do(req)
 	if err != nil {
@@ -384,34 +478,26 @@ func TestProjectAPINotConfigured(t *testing.T) {
 	}
 	defer resp.Body.Close()
 	if resp.StatusCode != http.StatusNotImplemented {
-		t.Fatalf("/api/* 未配后端应 501，实际 %d", resp.StatusCode)
-	}
-	var m map[string]string
-	if err := json.NewDecoder(resp.Body).Decode(&m); err != nil {
-		t.Fatal(err)
-	}
-	if !strings.Contains(m["error"], "backend") {
-		t.Errorf("错误信息应点名 profile 的 backend 字段，实际 %q", m["error"])
+		t.Errorf("未配置 backend 时 /api 应 501，实际 %d", resp.StatusCode)
 	}
 }
 
-// TestProjectAPIForwards `/api/*` 原样转发；凭据由服务端注入，插件自己的令牌不带去后端。
-//
-// 这三条一起构成「业务视图能搬但业务逻辑不用重写」的前提：路径 / 方法 / 查询不变，
-// 凭据不泄漏到浏览器，两套令牌不互相污染。
 func TestProjectAPIForwards(t *testing.T) {
-	type seen struct {
-		path, query, auth, magic string
-	}
-	var got seen
 	backend := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		got = seen{path: r.URL.Path, query: r.URL.RawQuery, auth: r.Header.Get("Authorization"), magic: r.Header.Get("X-Magic-Token")}
-		writeJSON(w, http.StatusOK, map[string]any{"表格": "docs", "行数": 3})
+		if r.Header.Get("Authorization") != "Bearer srv-token" {
+			t.Errorf("后端应收服务端注入的凭据，实际 %q", r.Header.Get("Authorization"))
+		}
+		if r.Header.Get("X-Magic-Token") != "" {
+			t.Error("插件的令牌不应带给后端")
+		}
+		w.Header().Set("Content-Type", "application/json")
+		_, _ = w.Write([]byte(`{"ok":true}`))
 	}))
 	defer backend.Close()
 
 	prof := DefaultProfile()
-	prof.Backend = BackendConfig{URL: backend.URL, Token: "backend-secret"}
+	prof.Backend.URL = backend.URL
+	prof.Backend.Token = "srv-token"
 	svc, err := New(Options{MagicAgent: fakeCore(t, goodContract), Profile: prof, Token: "tok"})
 	if err != nil {
 		t.Fatal(err)
@@ -419,7 +505,7 @@ func TestProjectAPIForwards(t *testing.T) {
 	srv := httptest.NewServer(svc.Handler())
 	defer srv.Close()
 
-	req, _ := http.NewRequest(http.MethodGet, srv.URL+"/api/docs?page=2", nil)
+	req, _ := http.NewRequest(http.MethodGet, srv.URL+"/api/x", nil)
 	req.Header.Set("X-Magic-Token", "tok")
 	resp, err := http.DefaultClient.Do(req)
 	if err != nil {
@@ -427,47 +513,31 @@ func TestProjectAPIForwards(t *testing.T) {
 	}
 	defer resp.Body.Close()
 	if resp.StatusCode != http.StatusOK {
-		t.Fatalf("/api/docs 应 200，实际 %d", resp.StatusCode)
-	}
-
-	if got.path != "/api/docs" {
-		t.Errorf("后端收到的路径应为 /api/docs，实际 %q", got.path)
-	}
-	if got.query != "page=2" {
-		t.Errorf("查询串应原样转发，实际 %q", got.query)
-	}
-	if got.auth != "Bearer backend-secret" {
-		t.Errorf("应注入后端凭据，实际 %q", got.auth)
+		t.Fatalf("/api 转发应 200，实际 %d", resp.StatusCode)
 	}
-	if got.magic != "" {
-		t.Errorf("插件的令牌不该带去后端，实际 %q", got.magic)
-	}
-	var body map[string]any
-	if err := json.NewDecoder(resp.Body).Decode(&body); err != nil {
-		t.Fatal(err)
-	}
-	if body["表格"] != "docs" {
-		t.Errorf("后端响应应原样回来，实际 %v", body)
+	b, _ := io.ReadAll(resp.Body)
+	if string(b) != `{"ok":true}` {
+		t.Errorf("转发响应不对：%s", b)
 	}
 }
 
-// TestProjectAPIRejectsBadURL 地址写错时启动即失败（比运行时 502 好查）。
 func TestProjectAPIRejectsBadURL(t *testing.T) {
 	prof := DefaultProfile()
-	prof.Backend = BackendConfig{URL: "不是地址"}
-	if _, err := New(Options{MagicAgent: fakeCore(t, goodContract), Profile: prof}); err == nil {
-		t.Fatal("非法 backend.url 应当启动即失败")
+	prof.Backend.URL = "not a url"
+	_, err := New(Options{MagicAgent: fakeCore(t, goodContract), Profile: prof})
+	if err == nil || !strings.Contains(err.Error(), "backend.url") {
+		t.Fatalf("非法 backend.url 应启动即报错，实际 %v", err)
 	}
 }
 
-// TestModulesEndpoint 模块清单从 profile 派生：只回答「有哪些模块、入口在哪、声明了哪些表」。
 func TestModulesEndpoint(t *testing.T) {
-	prof := DefaultProfile()
-	prof.Modules = []Module{
-		{ID: "cases", Entry: "cases.js"},
-		{ID: "reqboard", Entry: "reqboard.js", DataTables: []string{"workspaces", "requirements"}},
+	dir := t.TempDir()
+	if err := os.MkdirAll(filepath.Join(dir, "m1"), 0o755); err != nil {
+		t.Fatal(err)
 	}
-	svc, err := New(Options{MagicAgent: fakeCore(t, goodContract), Profile: prof, Token: "tok", UIRoot: t.TempDir()})
+	prof := DefaultProfile()
+	prof.Modules = []Module{{ID: "m1", Entry: "m1/index.html"}}
+	svc, err := New(Options{MagicAgent: fakeCore(t, goodContract), Profile: prof, Token: "tok"})
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -483,172 +553,545 @@ func TestModulesEndpoint(t *testing.T) {
 	defer resp.Body.Close()
 	var out struct {
 		Modules []struct {
-			ID         string   `json:"id"`
-			URL        string   `json:"url"`
-			DataTables []string `json:"dataTables"`
-			Loadable   bool     `json:"loadable"`
+			ID string `json:"id"`
 		} `json:"modules"`
-		Backend string `json:"backend"`
 	}
 	if err := json.NewDecoder(resp.Body).Decode(&out); err != nil {
 		t.Fatal(err)
 	}
-	if len(out.Modules) != 2 {
-		t.Fatalf("应有 2 个模块，实际 %d", len(out.Modules))
+	if len(out.Modules) != 1 || out.Modules[0].ID != "m1" {
+		t.Errorf("模块列表不对：%+v", out.Modules)
+	}
+}
+
+func TestModulesStatic(t *testing.T) {
+	uiDir := t.TempDir()
+	if err := os.MkdirAll(filepath.Join(uiDir, "shared"), 0o755); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(uiDir, "shared", "a.js"), []byte("var a=1;"), 0o644); err != nil {
+		t.Fatal(err)
 	}
-	// URL 必须带上挂载点前缀 `/modules/`（漏了就是「清单里有点开 404」）。
-	if out.Modules[0].ID != "cases" || out.Modules[0].URL != "/modules/cases.js" || !out.Modules[0].Loadable {
-		t.Errorf("第一个模块不对: %+v", out.Modules[0])
+	svc, err := New(Options{MagicAgent: fakeCore(t, goodContract), Profile: DefaultProfile(), UIRoot: uiDir, Token: "tok"})
+	if err != nil {
+		t.Fatal(err)
+	}
+	srv := httptest.NewServer(svc.Handler())
+	defer srv.Close()
+
+	resp, err := http.Get(srv.URL + "/m/shared/a.js")
+	if err != nil {
+		t.Fatal(err)
 	}
-	if len(out.Modules[1].DataTables) != 2 {
-		t.Errorf("模块声明的表应原样回，实际 %+v", out.Modules[1])
+	defer resp.Body.Close()
+	if resp.StatusCode != http.StatusOK {
+		t.Fatalf("共享静态资源应 200，实际 %d", resp.StatusCode)
 	}
-	if out.Backend != "" {
-		t.Errorf("未配后端时 backend 应为空串，实际 %q", out.Backend)
+	b, _ := io.ReadAll(resp.Body)
+	if string(b) != "var a=1;" {
+		t.Errorf("内容不对：%s", b)
 	}
 }
 
-// TestModulesStatic 模块静态资源的两个根与优先级：
-// 先项目自己的 `ui.modulesDir`，再退回插件的 `--ui-dir`；越界读不到根外的东西。
-//
-// 为什么要有独立的模块目录：模块文件属于项目（跟项目仓库一起改），基础版 UI 属于插件。
-// 混在一个目录里，插件升级与模块改动会互相踩。
-func TestModulesStatic(t *testing.T) {
-	uiDir := t.TempDir()
-	modDir := t.TempDir()
-	if err := os.WriteFile(filepath.Join(uiDir, "index.html"), []byte("from-ui"), 0o644); err != nil {
+func TestUploadReadBackAndTraversalGuard(t *testing.T) {
+	svc, err := New(Options{MagicAgent: fakeCore(t, goodContract), Profile: DefaultProfile(), Token: "tok"})
+	if err != nil {
+		t.Fatal(err)
+	}
+	srv := httptest.NewServer(svc.Handler())
+	defer srv.Close()
+
+	var buf bytes.Buffer
+	w := multipartWrite(&buf, "file", "a.txt", []byte("hello"))
+	req, _ := http.NewRequest(http.MethodPost, srv.URL+"/desk/upload", &buf)
+	req.Header.Set("X-Magic-Token", "tok")
+	req.Header.Set("Content-Type", w)
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
 		t.Fatal(err)
 	}
-	if err := os.WriteFile(filepath.Join(uiDir, "shared.js"), []byte("from-ui"), 0o644); err != nil {
+	defer resp.Body.Close()
+	if resp.StatusCode != http.StatusOK {
+		msg, _ := io.ReadAll(resp.Body)
+		t.Fatalf("上传应 200，实际 %d（%s）", resp.StatusCode, msg)
+	}
+	var out struct {
+		Path string `json:"path"`
+		URL  string `json:"url"`
+	}
+	if err := json.NewDecoder(resp.Body).Decode(&out); err != nil {
 		t.Fatal(err)
 	}
-	if err := os.WriteFile(filepath.Join(modDir, "shared.js"), []byte("from-project"), 0o644); err != nil {
+
+	// 回读：<img> 只能走 ?token=。
+	read, err := http.Get(srv.URL + out.URL + "?token=tok")
+	if err != nil {
 		t.Fatal(err)
 	}
-	if err := os.WriteFile(filepath.Join(modDir, "cases.js"), []byte("cases-module"), 0o644); err != nil {
+	defer read.Body.Close()
+	if read.StatusCode != http.StatusOK {
+		t.Fatalf("回读应 200，实际 %d", read.StatusCode)
+	}
+
+	// 目录穿越：编码后的 ../ 不能读到上传目录以外。
+	bad, err := http.Get(srv.URL + "/desk/uploads/..%2F..%2Fetc%2Fpasswd?token=tok")
+	if err != nil {
 		t.Fatal(err)
 	}
-	secret := filepath.Join(filepath.Dir(modDir), "secret-"+filepath.Base(modDir)+".txt")
-	if err := os.WriteFile(secret, []byte("TOP-SECRET"), 0o644); err != nil {
+	defer bad.Body.Close()
+	if bad.StatusCode == http.StatusOK {
+		t.Error("目录穿越请求不应成功")
+	}
+}
+
+func TestMediaFileServesImageByPath(t *testing.T) {
+	dir := t.TempDir()
+	img := filepath.Join(dir, "x.png")
+	if err := os.WriteFile(img, []byte{0x89, 'P', 'N', 'G'}, 0o644); err != nil {
 		t.Fatal(err)
 	}
+	svc := newTestService(t, fakeCore(t, goodContract))
+	srv := httptest.NewServer(svc.Handler())
+	defer srv.Close()
 
-	prof := DefaultProfile()
-	prof.UI.ModulesDir = modDir
-	svc, err := New(Options{MagicAgent: fakeCore(t, goodContract), Profile: prof, Token: "tok", UIRoot: uiDir})
+	resp, err := http.Get(srv.URL + "/desk/media?path=" + url.QueryEscape(img) + "&token=tok")
 	if err != nil {
 		t.Fatal(err)
 	}
+	defer resp.Body.Close()
+	if resp.StatusCode != http.StatusOK {
+		t.Fatalf("按路径回读图片应 200，实际 %d", resp.StatusCode)
+	}
+}
+
+func TestPathReadTextAndGuards(t *testing.T) {
+	dir := t.TempDir()
+	md := filepath.Join(dir, "a.md")
+	if err := os.WriteFile(md, []byte("# 标题\n\n正文"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	bin := filepath.Join(dir, "b.bin")
+	if err := os.WriteFile(bin, []byte{0x00, 0x01, 0x02}, 0o644); err != nil {
+		t.Fatal(err)
+	}
+	big := filepath.Join(dir, "c.txt")
+	if err := os.WriteFile(big, bytes.Repeat([]byte("a"), maxReadBytes+1), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	svc := newTestService(t, fakeCore(t, goodContract))
 	srv := httptest.NewServer(svc.Handler())
 	defer srv.Close()
 
-	get := func(p string) (int, string) {
-		req, _ := http.NewRequest(http.MethodGet, srv.URL+p, nil)
+	read := func(path, base string) map[string]any {
+		body, _ := json.Marshal(map[string]string{"path": path, "base": base})
+		req, _ := http.NewRequest(http.MethodPost, srv.URL+"/desk/path-read", bytes.NewReader(body))
 		req.Header.Set("X-Magic-Token", "tok")
+		req.Header.Set("Content-Type", "application/json")
 		resp, err := http.DefaultClient.Do(req)
 		if err != nil {
-			t.Fatalf("GET %s: %v", p, err)
+			t.Fatal(err)
 		}
 		defer resp.Body.Close()
-		b, _ := io.ReadAll(resp.Body)
-		return resp.StatusCode, string(b)
+		if resp.StatusCode != http.StatusOK {
+			t.Fatalf("path-read 应 200，实际 %d", resp.StatusCode)
+		}
+		var out map[string]any
+		if err := json.NewDecoder(resp.Body).Decode(&out); err != nil {
+			t.Fatal(err)
+		}
+		return out
 	}
 
-	// 同名文件：项目目录优先
-	if code, body := get("/modules/shared.js"); code != 200 || body != "from-project" {
-		t.Errorf("/modules/shared.js 应取项目目录的，实际 %d %q", code, body)
+	// 绝对路径读文本。
+	if got := read(md, ""); got["text"] != "# 标题\n\n正文" {
+		t.Fatalf("文本应原样返回，实际 %v", got)
 	}
-	// 项目目录里没有的，退回 UI 目录
-	if code, body := get("/modules/index.html"); code != 200 || body != "from-ui" {
-		t.Errorf("/modules/index.html 应退回 UI 目录，实际 %d %q", code, body)
+	// 相对路径按 base 解析。
+	if got := read("a.md", dir); got["text"] != "# 标题\n\n正文" {
+		t.Fatalf("相对路径应按 base 解析，实际 %v", got)
 	}
-	// 项目模块能读到（这是「业务模块留在项目仓库里」的关键）
-	if code, body := get("/modules/cases.js"); code != 200 || body != "cases-module" {
-		t.Errorf("/modules/cases.js 应读到项目模块，实际 %d %q", code, body)
+	// 不存在。
+	if got := read(filepath.Join(dir, "nope.md"), ""); got["ok"] != false {
+		t.Fatalf("不存在的文件应 ok=false，实际 %v", got)
 	}
-	// 都不存在 → 404
-	if code, _ := get("/modules/nope.js"); code != http.StatusNotFound {
-		t.Errorf("不存在的模块应 404，实际 %d", code)
+	// 二进制。
+	if got := read(bin, ""); got["binary"] != true {
+		t.Fatalf("含 NUL 应判二进制，实际 %v", got)
 	}
-	// 越界：Clean 把 `..` 收进根内，因此只能命中根内文件或 404，绝不可能读到根外
-	if _, body := get("/modules/../" + filepath.Base(secret)); strings.Contains(body, "TOP-SECRET") {
-		t.Error("越界路径读到了根外的文件")
+	// 超限。
+	if got := read(big, ""); got["tooBig"] != true {
+		t.Fatalf("超 512KB 应判 tooBig，实际 %v", got)
 	}
 }
 
-// TestLoadProfileDefaultsAndOverrides profile 只描述差异：省略的字段要有稳定默认值。
-func TestLoadProfileDefaultsAndOverrides(t *testing.T) {
-	t.Run("空路径给默认", func(t *testing.T) {
-		p, err := LoadProfile("")
-		if err != nil {
-			t.Fatal(err)
-		}
-		if p.UI.Entry != "index.html" || p.AppID() != "magic-client" {
-			t.Errorf("默认 profile 不对: entry=%q appID=%q", p.UI.Entry, p.AppID())
-		}
-		if len(p.Modules) != 0 {
-			t.Errorf("默认 profile 不该有业务模块，实际 %v", p.Modules)
+func TestMediaFileScalesWhenWidthGiven(t *testing.T) {
+	dir := t.TempDir()
+	img := filepath.Join(dir, "wide.png")
+	src := image.NewNRGBA(image.Rect(0, 0, 2000, 1000))
+	for y := 0; y < 1000; y++ {
+		for x := 0; x < 2000; x++ {
+			i := src.PixOffset(x, y)
+			src.Pix[i] = uint8(x*7 + y*13)
+			src.Pix[i+1] = uint8(x*3 + y*29)
+			src.Pix[i+2] = uint8((x * y) >> 3)
+			src.Pix[i+3] = 0xff
 		}
-	})
+	}
+	f, err := os.Create(img)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := png.Encode(f, src); err != nil {
+		t.Fatal(err)
+	}
+	f.Close()
 
-	t.Run("读文件并补默认", func(t *testing.T) {
-		dir := t.TempDir()
-		path := filepath.Join(dir, "掌天瓶.json")
-		content := `{"app":{"name":"掌天瓶","bundleId":"com.magic.test"},"modules":[{"id":"cases","entry":"modules/cases.js"}]}`
-		if err := os.WriteFile(path, []byte(content), 0o644); err != nil {
-			t.Fatal(err)
-		}
-		p, err := LoadProfile(path)
-		if err != nil {
-			t.Fatal(err)
-		}
-		if p.App.Name != "掌天瓶" || p.AppID() != "com.magic.test" {
-			t.Errorf("app 字段没读到: %+v", p.App)
-		}
-		if p.UI.Entry != "index.html" {
-			t.Errorf("省略的 ui.entry 应补默认，实际 %q", p.UI.Entry)
-		}
-		if len(p.Modules) != 1 || p.Modules[0].ID != "cases" {
-			t.Errorf("业务模块清单没读到: %+v", p.Modules)
-		}
-		if !strings.HasSuffix(p.DataDir(), filepath.Join(".magic-client", "com.magic.test")) {
-			t.Errorf("数据目录应按 appID 派生，实际 %q", p.DataDir())
-		}
-	})
+	svc := newTestService(t, fakeCore(t, goodContract))
+	srv := httptest.NewServer(svc.Handler())
+	defer srv.Close()
 
-	t.Run("坏文件报错", func(t *testing.T) {
-		dir := t.TempDir()
-		path := filepath.Join(dir, "bad.json")
-		if err := os.WriteFile(path, []byte("{不是 JSON"), 0o644); err != nil {
-			t.Fatal(err)
-		}
-		if _, err := LoadProfile(path); err == nil {
-			t.Fatal("坏 profile 应当报错")
-		}
-	})
+	resp, err := http.Get(srv.URL + "/desk/media?path=" + url.QueryEscape(img) + "&w=720&token=tok")
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer resp.Body.Close()
+	if resp.StatusCode != http.StatusOK {
+		t.Fatalf("缩放回读应 200，实际 %d", resp.StatusCode)
+	}
+	got, _, err := image.Decode(resp.Body)
+	if err != nil {
+		t.Fatalf("缩放结果应是可解码图片：%v", err)
+	}
+	if w := got.Bounds().Dx(); w != 720 {
+		t.Fatalf("应按目标宽度 720 缩放，实际 %d", w)
+	}
+	if h := got.Bounds().Dy(); h != 360 {
+		t.Fatalf("应等比缩放到 360 高，实际 %d", h)
+	}
+}
+
+func TestLoadProfileDefaultsAndOverrides(t *testing.T) {
+	dir := t.TempDir()
+	path := filepath.Join(dir, "p.json")
+	if err := os.WriteFile(path, []byte(`{"app":{"bundleId":"app-x"},"engines":["claude"],"backend":{"url":"http://127.0.0.1:9"}}`), 0o600); err != nil {
+		t.Fatal(err)
+	}
+	prof, err := LoadProfile(path)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if prof.AppID() != "app-x" {
+		t.Errorf("app.bundleId 未生效：%q", prof.AppID())
+	}
+	if len(prof.Engines) != 1 || prof.Engines[0] != "claude" {
+		t.Errorf("engines 未生效：%+v", prof.Engines)
+	}
 }
 
-// TestWriteErrShape 错误一律以 {"error": "..."} 回，客户端只认这一种形状。
 func TestWriteErrShape(t *testing.T) {
+	rec := httptest.NewRecorder()
+	writeErr(rec, http.StatusBadRequest, "坏请求")
+	if rec.Code != http.StatusBadRequest {
+		t.Errorf("状态码 = %d", rec.Code)
+	}
+	var out struct {
+		Error string `json:"error"`
+	}
+	if err := json.Unmarshal(rec.Body.Bytes(), &out); err != nil {
+		t.Fatal(err)
+	}
+	if out.Error != "坏请求" {
+		t.Errorf("error = %q", out.Error)
+	}
+}
+
+func TestSessionDeleteRemovesRunNamedLog(t *testing.T) {
+	home := t.TempDir()
+	t.Setenv(session.EnvDir, home)
+	t.Setenv("HOME", home)
+	logDir := filepath.Join(home, ".magic-agent", "sessions")
+	if err := os.MkdirAll(logDir, 0o700); err != nil {
+		t.Fatal(err)
+	}
+
+	now := time.Now()
+	rec := session.Record{
+		RunID: "run-keep", SessionID: "sess-keep", Engine: "codex",
+		State: session.StateDone, StartedAt: now, UpdatedAt: now,
+	}
+	body, _ := json.Marshal(rec)
+	if err := os.WriteFile(filepath.Join(home, "run-keep.json"), body, 0o600); err != nil {
+		t.Fatal(err)
+	}
+	// 日志只落在 run_id 名下（引擎整轮没吐 id → 没改名）。
+	logPath := filepath.Join(logDir, "run-keep.jsonl")
+	if err := os.WriteFile(logPath, []byte(`{"seq":1,"kind":"user","text":"hi"}`+"\n"), 0o600); err != nil {
+		t.Fatal(err)
+	}
+
 	svc := newTestService(t, fakeCore(t, goodContract))
 	srv := httptest.NewServer(svc.Handler())
 	defer srv.Close()
 
-	req, _ := http.NewRequest(http.MethodPost, srv.URL+"/desk/ask", strings.NewReader(`{"engine":"claude"}`))
+	req, _ := http.NewRequest(http.MethodDelete, srv.URL+"/desk/session/sess-keep", nil)
+	req.Header.Set("X-Magic-Token", "tok")
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer resp.Body.Close()
+	if resp.StatusCode != http.StatusOK {
+		msg, _ := io.ReadAll(resp.Body)
+		t.Fatalf("删会话应 200，实际 %d（%s）", resp.StatusCode, msg)
+	}
+	var out struct {
+		RecordsRemoved int `json:"recordsRemoved"`
+	}
+	if err := json.NewDecoder(resp.Body).Decode(&out); err != nil {
+		t.Fatal(err)
+	}
+	if out.RecordsRemoved != 1 {
+		t.Errorf("应删掉 1 条登记记录，实际 %d", out.RecordsRemoved)
+	}
+
+	// 按 session_id 删，run_id 名下的登记记录与日志都必须一起消失。
+	if _, err := os.Stat(filepath.Join(home, "run-keep.json")); !os.IsNotExist(err) {
+		t.Error("登记记录 run-keep.json 应已删除")
+	}
+	if _, err := os.Stat(logPath); !os.IsNotExist(err) {
+		t.Error("日志文件 run-keep.jsonl 应已删除（只删 <session_id>.jsonl 会留下孤儿）")
+	}
+}
+
+// fakeResumeCore 发两段之间停一下、随后自然退出的假 core：用来模拟
+// 「客户端在流中途断线，但服务端把 core 跑完」的断线续传场景。
+func fakeResumeCore(t *testing.T, contract string) string {
+	t.Helper()
+	dir := t.TempDir()
+	path := filepath.Join(dir, "magic-agent")
+	script := `#!/bin/sh
+case "$*" in
+  *--contract*)
+    echo '` + contract + `'
+    exit 0
+    ;;
+  *--engines*)
+    echo '[{"engine":"claude","ok":true,"capabilities":["session.stream"]}]'
+    exit 0
+    ;;
+esac
+echo '{"v":1,"seq":1,"type":"ready","engine":"claude"}'
+echo '{"v":1,"seq":2,"type":"text","text":"前半"}'
+sleep 2
+echo '{"v":1,"seq":3,"type":"text","text":"后半"}'
+echo '{"v":1,"seq":4,"type":"result","text":"前半后半"}'
+`
+	if err := os.WriteFile(path, []byte(script), 0o755); err != nil {
+		t.Fatal(err)
+	}
+	return path
+}
+
+// askEvents 拉一次 /desk/ask/{id}/events?after= 并解出响应。
+type askEventsResp struct {
+	ID               string           `json:"id"`
+	Events           []map[string]any `json:"events"`
+	Count            int              `json:"count"`
+	After            uint64           `json:"after"`
+	LastSeq          uint64           `json:"lastSeq"`
+	Done             bool             `json:"done"`
+	Code             *int             `json:"code"`
+	SnapshotRequired bool             `json:"snapshotRequired"`
+}
+
+func getAskEvents(t *testing.T, base, token, id string, after uint64) askEventsResp {
+	t.Helper()
+	req, _ := http.NewRequest(http.MethodGet,
+		fmt.Sprintf("%s/desk/ask/%s/events?after=%d", base, url.PathEscape(id), after), nil)
+	req.Header.Set("X-Magic-Token", token)
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer resp.Body.Close()
+	if resp.StatusCode != http.StatusOK {
+		msg, _ := io.ReadAll(resp.Body)
+		t.Fatalf("/desk/ask/{id}/events 应 200，实际 %d（%s）", resp.StatusCode, msg)
+	}
+	var out askEventsResp
+	if err := json.NewDecoder(resp.Body).Decode(&out); err != nil {
+		t.Fatal(err)
+	}
+	return out
+}
+
+// TestAskEventsResumeAfterCursor 断线续传的服务端半场：
+//  1. 连接还在时，游标能拿到「之后」的事件，且不会重发已看过的；
+//  2. 客户端断连后 core 继续跑完，事件仍然进回放缓冲；
+//  3. core 结束后 done/code 可补拉，运行中列表不再包含它。
+func TestAskEventsResumeAfterCursor(t *testing.T) {
+	svc := newTestService(t, fakeResumeCore(t, goodContract))
+	srv := httptest.NewServer(svc.Handler())
+	defer srv.Close()
+
+	sse := openSSE(t, srv.URL, "tok", askRequest{Engine: "claude", Prompt: "讲两句"})
+	opened := sse.next(t)
+	askID, _ := opened["id"].(string)
+	if askID == "" {
+		t.Fatalf("open 事件应带 ask id，实际 %v", opened)
+	}
+	ready := sse.next(t)
+	if ready["type"] != "ready" {
+		t.Fatalf("应先收到 ready，实际 %v", ready)
+	}
+	first := sse.next(t)
+	if first["type"] != "text" || first["seq"] != float64(2) {
+		t.Fatalf("应收到 seq=2 的 text，实际 %v", first)
+	}
+
+	// 游标 = 2：此刻还没有新事件，接口应返回空集且未结束。
+	cur := getAskEvents(t, srv.URL, "tok", askID, 2)
+	if cur.Count != 0 || cur.Done {
+		t.Fatalf("after=2 时不该有新事件且未结束，实际 count=%d done=%v", cur.Count, cur.Done)
+	}
+	if cur.LastSeq != 2 {
+		t.Errorf("lastSeq = %d want 2", cur.LastSeq)
+	}
+
+	// 断开 SSE（模拟手机锁屏 / 切后台），core 不受影响，继续跑完后半段。
+	sse.close()
+
+	deadline := time.Now().Add(10 * time.Second)
+	var last askEventsResp
+	for time.Now().Before(deadline) {
+		last = getAskEvents(t, srv.URL, "tok", askID, 2)
+		if last.Done {
+			break
+		}
+		time.Sleep(200 * time.Millisecond)
+	}
+	if !last.Done {
+		t.Fatalf("core 结束后应能补拉到 done，实际 %+v", last)
+	}
+	if last.Code == nil || *last.Code != 0 {
+		t.Errorf("补拉终态应带 code=0，实际 %v", last.Code)
+	}
+	if last.LastSeq != 4 {
+		t.Errorf("lastSeq = %d want 4", last.LastSeq)
+	}
+	var types []string
+	for _, ev := range last.Events {
+		s, _ := ev["type"].(string)
+		types = append(types, s)
+	}
+	if strings.Join(types, ",") != "text,result" {
+		t.Errorf("断点之后应只补回 text(seq3) 与 result(seq4)，实际 %v", types)
+	}
+	if txt, _ := last.Events[0]["text"].(string); txt != "后半" {
+		t.Errorf("补回的第二段正文应为「后半」，实际 %q", txt)
+	}
+
+	// 已结束的 ask 不该再出现在「正在跑」列表里（它只在内存里留一段补拉窗口）。
+	reqList, _ := http.NewRequest(http.MethodGet, srv.URL+"/desk/asks", nil)
+	reqList.Header.Set("X-Magic-Token", "tok")
+	respList, err := http.DefaultClient.Do(reqList)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer respList.Body.Close()
+	var asks []map[string]any
+	if err := json.NewDecoder(respList.Body).Decode(&asks); err != nil {
+		t.Fatal(err)
+	}
+	if len(asks) != 0 {
+		t.Errorf("结束的 ask 不应出现在运行中列表，实际 %+v", asks)
+	}
+
+	// 未知 id 诚实报 404（不是空列表，免得客户端以为「还在跑」）。
+	req, _ := http.NewRequest(http.MethodGet, srv.URL+"/desk/ask/ask-nope/events?after=0", nil)
 	req.Header.Set("X-Magic-Token", "tok")
 	resp, err := http.DefaultClient.Do(req)
 	if err != nil {
 		t.Fatal(err)
 	}
 	defer resp.Body.Close()
-	if resp.StatusCode != http.StatusBadRequest {
-		t.Fatalf("空 prompt 应 400，实际 %d", resp.StatusCode)
+	if resp.StatusCode != http.StatusNotFound {
+		t.Errorf("未知 ask 应 404，实际 %d", resp.StatusCode)
 	}
-	var m map[string]string
-	if err := json.NewDecoder(resp.Body).Decode(&m); err != nil {
+}
+
+// TestAskEventsIncludesSyntheticPrompt 断点续传要把「用户问的那句」补回来：
+// core 的 stdout 事件流里只有 ready/text/result，从不发 user（user 只进会话日志），
+// 所以网关在 /desk/ask 启动前把 prompt 合成一条 type:"user" 塞进回放缓冲（appendPrompt）。
+// 三条约束逐条钉住：
+//  1. after=0 的首条就是它：text/attachments 与请求一致，带 prompt_id，**不带 seq**；
+//  2. 它**不进** SSE 直播流（第一帧仍是 core 的 ready），否则实时端会画出两个用户气泡；
+//  3. after>0 的增量补拉不再给（否则每补一次就重复一个气泡）。
+func TestAskEventsIncludesSyntheticPrompt(t *testing.T) {
+	svc := newTestService(t, fakeResumeCore(t, goodContract))
+	srv := httptest.NewServer(svc.Handler())
+	defer srv.Close()
+
+	att := filepath.Join(t.TempDir(), "note.png")
+	if err := os.WriteFile(att, []byte("png"), 0o600); err != nil {
 		t.Fatal(err)
 	}
-	if !strings.Contains(m["error"], "prompt") {
-		t.Errorf("错误信息应提到 prompt，实际 %q", m["error"])
+	sse := openSSE(t, srv.URL, "tok", askRequest{
+		Engine: "claude", Prompt: "讲两句", Attachments: []string{att},
+	})
+	defer sse.close()
+	opened := sse.next(t)
+	askID, _ := opened["id"].(string)
+	if askID == "" {
+		t.Fatalf("open 事件应带 ask id，实际 %v", opened)
+	}
+
+	// 约束 2：直播流第一帧必须还是 core 的 ready。
+	ready := sse.next(t)
+	if ready["type"] != "ready" {
+		t.Fatalf("直播流首帧应仍是 ready（合成 user 不该进直播流），实际 %v", ready)
+	}
+
+	// 约束 1：从头补（after=0）时先给合成的提问。
+	cur := getAskEvents(t, srv.URL, "tok", askID, 0)
+	if cur.Count == 0 {
+		t.Fatal("after=0 应至少补回合成的 user 事件")
+	}
+	user := cur.Events[0]
+	if user["type"] != "user" {
+		t.Fatalf("补回的首条应是 user，实际 %v", user)
+	}
+	if txt, _ := user["text"].(string); txt != "讲两句" {
+		t.Errorf("合成 user 的 text = %q want 讲两句", txt)
+	}
+	if pid, _ := user["prompt_id"].(string); pid == "" {
+		t.Error("合成 user 应带 prompt_id（客户端去重的键）")
+	}
+	if _, has := user["seq"]; has {
+		t.Errorf("合成 user 不该带 seq（不能推进客户端游标），实际 %v", user)
+	}
+	atts, _ := user["attachments"].([]any)
+	if len(atts) != 1 {
+		t.Fatalf("合成 user 应带 1 个附件，实际 %v", user["attachments"])
+	}
+	if m, _ := atts[0].(map[string]any); m["path"] != att {
+		t.Errorf("附件 path = %v want %s", atts[0], att)
 	}
+
+	// 约束 3：带游标的增量补拉不再重复给。
+	inc := getAskEvents(t, srv.URL, "tok", askID, 1)
+	for _, ev := range inc.Events {
+		if ev["type"] == "user" {
+			t.Errorf("after>0 的增量补拉不该再给合成 user，实际 %v", ev)
+		}
+	}
+}
+
+// multipartWrite 把 content 写成一个 multipart/form-data 请求体，返回 Content-Type。
+func multipartWrite(buf *bytes.Buffer, field, name string, content []byte) string {
+	w := multipart.NewWriter(buf)
+	fw, _ := w.CreateFormFile(field, name)
+	_, _ = fw.Write(content)
+	_ = w.Close()
+	return w.FormDataContentType()
 }