Add Markdown and ZIP notebook import

README.md

@@ -34,6 +34,7 @@ docker run -d --name rawmark \
 - `--user` 让容器以宿主机用户身份读写数据目录；不指定时容器以 UID 65532 运行，需要该用户对目录有写权限。
 - 请通过 HTTPS 反向代理（Caddy、Nginx 等）访问，并转发 WebSocket（`/api/v1/events`）。
 - 分享：命令面板（F1）中「分享当前笔记」生成只读链接 `/s/…`，可设访问密码与有效期；「管理分享链接」查看与撤销。
+- 导入：侧栏顶部或文件夹右键菜单选择「导入」，支持多选 UTF-8 `.md` 文件或单个 ZIP（总上传上限 100 MB）。ZIP 新建同名文件夹并保留层级，本地图片转换为笔记独立附件，原附件保留；同名内容不覆盖，缺失的本地链接会提示，外部图片不会自动下载。
 - 自动化：「API 令牌」中创建只读或读写令牌，以 `Authorization: Bearer <令牌>` 调用 REST API，接口说明见 `/api/v1/openapi.json`。
 
 | 环境变量 | 默认值 | 说明 |

internal/api/api.go

@@ -84,6 +84,7 @@ func (s *Server) routes() []route {
 		{"DELETE /api/v1/files/{path...}", authed, s.deleteFile},
 		{"POST /api/v1/move", authed, s.move},
 		{"POST /api/v1/folders", authed, s.mkdir},
+		{"POST /api/v1/import", authed, s.importNotes},
 		{"POST /api/v1/assets", authed, s.uploadAsset},
 		{"POST /api/v1/assets/import", authed, s.importAsset},
 		{"GET /api/v1/raw/{path...}", authed, s.raw},
@@ -492,7 +493,7 @@ func vaultError(w http.ResponseWriter, r *http.Request, err error) {
 	switch {
 	case errors.As(err, &conflict):
 		writeJSON(w, 412, map[string]string{"error": err.Error(), "rev": conflict.Rev})
-	case errors.Is(err, vault.ErrInvalidPath):
+	case errors.Is(err, vault.ErrInvalidPath), errors.Is(err, vault.ErrInvalidImport):
 		writeError(w, 400, err.Error())
 	case errors.Is(err, vault.ErrNotFound):
 		writeError(w, 404, err.Error())

internal/api/import_notes.go

@@ -0,0 +1,44 @@
+package api
+
+import (
+	"errors"
+	"net/http"
+
+	"rawmark/internal/vault"
+)
+
+func (s *Server) importNotes(w http.ResponseWriter, r *http.Request) {
+	// 总请求上限包含表单开销，文件总量另由 vault 校验。
+	r.Body = http.MaxBytesReader(w, r.Body, vault.MaxImportBytes+(1<<20))
+	if err := r.ParseMultipartForm(8 << 20); err != nil {
+		var limit *http.MaxBytesError
+		if errors.As(err, &limit) {
+			writeError(w, 413, "导入文件总量不能超过 100 MB")
+		} else {
+			writeError(w, 400, "无法读取导入表单")
+		}
+		return
+	}
+	defer r.MultipartForm.RemoveAll()
+	headers := r.MultipartForm.File["files"]
+	if len(headers) == 0 || len(headers) > 10_000 {
+		writeError(w, 400, "请选择 Markdown 文件或一个 ZIP")
+		return
+	}
+	files := make([]vault.ImportFile, 0, len(headers))
+	for _, h := range headers {
+		f, err := h.Open()
+		if err != nil {
+			internalError(w, r, err)
+			return
+		}
+		defer f.Close()
+		files = append(files, vault.ImportFile{Name: h.Filename, Reader: f, Size: h.Size})
+	}
+	result, err := s.vault.Import(r.Context(), r.FormValue("dir"), r.FormValue("folder"), files)
+	if err != nil {
+		vaultError(w, r, err)
+		return
+	}
+	writeJSON(w, http.StatusCreated, result)
+}

internal/api/import_notes_test.go

@@ -0,0 +1,117 @@
+package api
+
+import (
+	"archive/zip"
+	"bytes"
+	"encoding/json"
+	"io"
+	"mime/multipart"
+	"net/http"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"rawmark/internal/vault"
+)
+
+func TestImportNotesAPI(t *testing.T) {
+	f := newFixture(t)
+	send := func(client *http.Client, token, dir, folder, name string, data []byte) *http.Response {
+		t.Helper()
+		var body bytes.Buffer
+		form := multipart.NewWriter(&body)
+		if err := form.WriteField("dir", dir); err != nil {
+			t.Fatal(err)
+		}
+		if err := form.WriteField("folder", folder); err != nil {
+			t.Fatal(err)
+		}
+		file, err := form.CreateFormFile("files", name)
+		if err != nil {
+			t.Fatal(err)
+		}
+		if _, err := file.Write(data); err != nil {
+			t.Fatal(err)
+		}
+		if err := form.Close(); err != nil {
+			t.Fatal(err)
+		}
+		req, err := http.NewRequest("POST", f.url+"/api/v1/import", &body)
+		if err != nil {
+			t.Fatal(err)
+		}
+		req.Header.Set("Content-Type", form.FormDataContentType())
+		if token != "" {
+			req.Header.Set("Authorization", "Bearer "+token)
+		}
+		res, err := client.Do(req)
+		if err != nil {
+			t.Fatal(err)
+		}
+		return res
+	}
+	readToken := decode[struct{ Token string }](t, f.do(f.admin, "POST", "/api/v1/tokens", `{"name":"只读","scope":"read"}`, nil)).Token
+	for _, tc := range []struct {
+		client *http.Client
+		token  string
+		status int
+	}{{newClient(), "", 401}, {newClient(), readToken, 403}} {
+		res := send(tc.client, tc.token, "", "", "n.md", []byte("正文"))
+		res.Body.Close()
+		if res.StatusCode != tc.status {
+			t.Fatalf("权限状态不符: %d", res.StatusCode)
+		}
+	}
+	res := send(f.admin, "", "", "", "n.md", []byte("正文"))
+	if res.StatusCode != 201 {
+		t.Fatalf("导入失败: %d", res.StatusCode)
+	}
+	var result vault.ImportResult
+	if err := json.NewDecoder(res.Body).Decode(&result); err != nil {
+		t.Fatal(err)
+	}
+	res.Body.Close()
+	if result.Notes != 1 || len(result.Paths) != 1 || result.Paths[0] != "n.md" || result.Warnings == nil {
+		t.Fatalf("响应不符: %+v", result)
+	}
+	res = send(f.admin, "", "", "", "n.md", []byte("覆盖"))
+	res.Body.Close()
+	if res.StatusCode != 409 {
+		t.Fatalf("应拒绝冲突: %d", res.StatusCode)
+	}
+	data, err := os.ReadFile(filepath.Join(f.root, "n.md"))
+	if err != nil || string(data) != "正文" {
+		t.Fatal("原文被覆盖", err)
+	}
+	writeToken := decode[struct{ Token string }](t, f.do(f.admin, "POST", "/api/v1/tokens", `{"name":"写入","scope":"write"}`, nil)).Token
+	var b bytes.Buffer
+	zw := zip.NewWriter(&b)
+	zf, err := zw.Create("子目录/笔记.md")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if _, err := io.WriteString(zf, "# ZIP"); err != nil {
+		t.Fatal(err)
+	}
+	if err := zw.Close(); err != nil {
+		t.Fatal(err)
+	}
+	res = send(newClient(), writeToken, "", "知识库", "export.md.zip", b.Bytes())
+	res.Body.Close()
+	if res.StatusCode != 201 {
+		t.Fatalf("写入令牌导入失败: %d", res.StatusCode)
+	}
+	for _, tc := range []struct {
+		dir, folder, name, data string
+		status                  int
+	}{
+		{"", "", "x.zip", "invalid", 400}, {"不存在", "", "x.md", "x", 404}, {"n.md", "", "x.md", "x", 400}, {"", "", "x.md", strings.Repeat("a", (20<<20)+1), 413},
+	} {
+		res := send(f.admin, "", tc.dir, tc.folder, tc.name, []byte(tc.data))
+		res.Body.Close()
+		if res.StatusCode != tc.status {
+			t.Fatalf("%s 状态不符: %d", tc.name, res.StatusCode)
+		}
+	}
+}

internal/api/openapi.json

@@ -2180,6 +2180,102 @@
           }
         ]
       }
+    },
+    "/import": {
+      "post": {
+        "summary": "导入 Markdown 文件或 ZIP 知识库",
+        "tags": [
+          "文件"
+        ],
+        "description": "多选 .md 或单个 ZIP，总上传不超过 100 MB；ZIP 必须指定新建文件夹名称。目标目录必须存在，冲突不覆盖。解压及整理后上限 512 MiB、10,000 项，单篇笔记 20 MiB、附件 50 MiB。Markdown 与 ZIP 文件名须为 UTF-8。ZIP 层级保留，本地图片生成笔记独立附件，原附件保留；外部链接不下载，缺失本地目标以警告返回。",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "multipart/form-data": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "files"
+                ],
+                "properties": {
+                  "dir": {
+                    "type": "string",
+                    "description": "目标目录，空字符串为根目录"
+                  },
+                  "folder": {
+                    "type": "string",
+                    "description": "ZIP 的新建文件夹名称；普通 Markdown 留空"
+                  },
+                  "files": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "format": "binary"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "导入成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "paths",
+                    "notes",
+                    "assets",
+                    "warnings"
+                  ],
+                  "properties": {
+                    "paths": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "notes": {
+                      "type": "integer"
+                    },
+                    "assets": {
+                      "type": "integer",
+                      "description": "附件文件总数，包含原始附件和独立副本"
+                    },
+                    "warnings": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "格式、路径或编码无效"
+          },
+          "401": {
+            "description": "未登录或令牌无效"
+          },
+          "403": {
+            "description": "只读令牌不能导入"
+          },
+          "404": {
+            "description": "目标目录不存在"
+          },
+          "409": {
+            "description": "目标已存在，不覆盖"
+          },
+          "413": {
+            "description": "超过上传、解压、文件数量或单文件大小限制"
+          }
+        }
+      }
     }
   },
   "components": {

internal/vault/import.go

@@ -0,0 +1,289 @@
+package vault
+
+import (
+	"archive/zip"
+	"bytes"
+	"compress/flate"
+	"context"
+	"errors"
+	"fmt"
+	"io"
+	"io/fs"
+	"os"
+	"path"
+	"path/filepath"
+	"sort"
+	"strings"
+	"syscall"
+	"unicode/utf8"
+)
+
+const (
+	MaxImportBytes    = 100_000_000
+	maxImportExpanded = 512 << 20
+	maxImportEntries  = 10_000
+	importNoteLimit   = 20 << 20
+	importAssetLimit  = 50 << 20
+)
+
+var ErrInvalidImport = errors.New("导入内容无效")
+
+// ImportFile 的读取范围是单个上传文件，ZIP 与普通 Markdown 共用这一输入边界。
+type ImportFile struct {
+	Name   string
+	Reader io.ReaderAt
+	Size   int64
+}
+
+type ImportResult struct {
+	Paths    []string `json:"paths"`
+	Notes    int      `json:"notes"`
+	Assets   int      `json:"assets"`
+	Warnings []string `json:"warnings"`
+}
+
+// Import 在隐藏目录内整理完整内容，提交前统一检查冲突，绝不覆盖已有文件。
+func (v *Vault) Import(ctx context.Context, dir, folder string, files []ImportFile) (result ImportResult, err error) {
+	result = ImportResult{Paths: []string{}, Warnings: []string{}}
+	if len(files) == 0 || len(files) > maxImportEntries {
+		return result, fmt.Errorf("%w：请选择 Markdown 文件或一个 ZIP", ErrInvalidImport)
+	}
+	zipped := len(files) == 1 && strings.EqualFold(path.Ext(files[0].Name), ".zip")
+	if zipped {
+		if _, err := CleanPath(folder); err != nil || strings.Contains(folder, "/") || strings.HasSuffix(folder, AssetsExt) {
+			return result, fmt.Errorf("%w：导入文件夹名称无效", ErrInvalidImport)
+		}
+	} else if folder != "" {
+		return result, fmt.Errorf("%w：普通 Markdown 不使用外层文件夹", ErrInvalidImport)
+	}
+	if dir != "" {
+		if _, err := CleanPath(dir); err != nil {
+			return result, err
+		}
+	}
+	var uploadBytes int64
+	for _, f := range files {
+		if f.Size < 0 || f.Size > MaxImportBytes-uploadBytes {
+			return result, ErrTooLarge
+		}
+		uploadBytes += f.Size
+	}
+	stage, err := os.MkdirTemp(v.root, tmpPrefix+"import-")
+	if err != nil {
+		return result, err
+	}
+	defer func() {
+		if cleanup := os.RemoveAll(stage); cleanup != nil {
+			err = errors.Join(err, fmt.Errorf("清理导入临时目录失败：%w", cleanup))
+		}
+	}()
+	staged := &Vault{root: stage}
+	entries := map[string]struct{}{}
+	var total int64
+	var notes []string
+	// 每个来源文件只写一次；目录与文件重名也会在暂存阶段报错。
+	write := func(name string, isDir bool, reader io.Reader) error {
+		if err := ctx.Err(); err != nil {
+			return err
+		}
+		if _, err := CleanPath(name); err != nil || !utf8.ValidString(name) {
+			return fmt.Errorf("%w：ZIP 含有非法路径", ErrInvalidImport)
+		}
+		if _, exists := entries[name]; exists {
+			return fmt.Errorf("%w：存在重复路径", ErrInvalidImport)
+		}
+		entries[name] = struct{}{}
+		dest := filepath.Join(stage, filepath.FromSlash(name))
+		if isDir {
+			err := os.MkdirAll(dest, 0o755)
+			if errors.Is(err, fs.ErrExist) || errors.Is(err, syscall.ENOTDIR) {
+				return fmt.Errorf("%w：文件与目录路径冲突", ErrInvalidImport)
+			}
+			return err
+		}
+		if err := os.MkdirAll(filepath.Dir(dest), 0o755); err != nil {
+			if errors.Is(err, syscall.ENOTDIR) || errors.Is(err, fs.ErrExist) {
+				return fmt.Errorf("%w：文件与目录路径冲突", ErrInvalidImport)
+			}
+			return err
+		}
+		f, err := os.OpenFile(dest, os.O_WRONLY|os.O_CREATE|os.O_EXCL, 0o644)
+		if err != nil {
+			if errors.Is(err, fs.ErrExist) || errors.Is(err, syscall.ENOTDIR) {
+				return fmt.Errorf("%w：文件与目录路径冲突", ErrInvalidImport)
+			}
+			return err
+		}
+		limit := int64(importAssetLimit)
+		if IsNote(name) {
+			limit = importNoteLimit
+			notes = append(notes, name)
+		}
+		limit = min(limit, maxImportExpanded-total)
+		n, copyErr := io.Copy(f, io.LimitReader(reader, limit+1))
+		closeErr := f.Close()
+		total += n
+		if n > limit {
+			return ErrTooLarge
+		}
+		return errors.Join(copyErr, closeErr)
+	}
+	if zipped {
+		z, err := zip.NewReader(files[0].Reader, files[0].Size)
+		if err != nil {
+			return result, fmt.Errorf("%w：无法读取 ZIP：%w", ErrInvalidImport, err)
+		}
+		if len(z.File) > maxImportEntries {
+			return result, ErrTooLarge
+		}
+		for _, f := range z.File {
+			if !f.Mode().IsRegular() && !f.Mode().IsDir() {
+				return result, fmt.Errorf("%w：ZIP 不允许符号链接或特殊文件", ErrInvalidImport)
+			}
+			name := strings.TrimSuffix(f.Name, "/")
+			r, err := f.Open()
+			if err != nil {
+				return result, fmt.Errorf("%w：无法读取 ZIP 条目：%w", ErrInvalidImport, err)
+			}
+			err = write(name, f.FileInfo().IsDir(), r)
+			err = errors.Join(err, r.Close())
+			if err != nil {
+				var corrupt flate.CorruptInputError
+				if errors.Is(err, zip.ErrChecksum) || errors.Is(err, io.ErrUnexpectedEOF) || errors.As(err, &corrupt) {
+					err = fmt.Errorf("%w：ZIP 内容损坏：%w", ErrInvalidImport, err)
+				}
+				return result, err
+			}
+		}
+	} else {
+		for _, f := range files {
+			if !IsNote(f.Name) || strings.Contains(f.Name, "/") {
+				return result, fmt.Errorf("%w：只接受 .md 文件或单个 ZIP", ErrInvalidImport)
+			}
+			if err := write(f.Name, false, io.NewSectionReader(f.Reader, 0, f.Size)); err != nil {
+				return result, err
+			}
+		}
+	}
+	if len(notes) == 0 {
+		return result, fmt.Errorf("%w：没有可导入的 Markdown 笔记", ErrInvalidImport)
+	}
+	sort.Strings(notes)
+	for _, note := range notes {
+		if err := ctx.Err(); err != nil {
+			return result, err
+		}
+		for _, seg := range strings.Split(path.Dir(note), "/") {
+			if strings.HasSuffix(seg, AssetsExt) {
+				return result, fmt.Errorf("%w：笔记不能放在 .assets 附件目录内", ErrInvalidImport)
+			}
+		}
+		content, _, err := staged.Read(note)
+		if err != nil {
+			return result, err
+		}
+		if !utf8.Valid(content) || bytes.IndexByte(content, 0) >= 0 {
+			return result, fmt.Errorf("%w：Markdown 必须是 UTF-8 文本", ErrInvalidImport)
+		}
+		content = bytes.TrimPrefix(content, []byte{0xef, 0xbb, 0xbf})
+		updated, warnings, err := staged.importLinks(ctx, note, content, &total)
+		if err != nil {
+			return result, err
+		}
+		result.Warnings = append(result.Warnings, warnings...)
+		if len(updated) > importNoteLimit || total+int64(len(updated)-len(content)) > maxImportExpanded {
+			return result, ErrTooLarge
+		}
+		total += int64(len(updated) - len(content))
+		if err := os.WriteFile(filepath.Join(stage, filepath.FromSlash(note)), updated, 0o644); err != nil {
+			return result, err
+		}
+	}
+	result.Notes = len(notes)
+	// 附件数量包含原始附件及为各笔记生成的独立副本。
+	count := 0
+	err = filepath.WalkDir(stage, func(p string, d fs.DirEntry, err error) error {
+		if err != nil {
+			return err
+		}
+		count++
+		if count > maxImportEntries+1 {
+			return ErrTooLarge
+		}
+		if !d.IsDir() && !IsNote(d.Name()) {
+			result.Assets++
+		}
+		return nil
+	})
+	if err != nil {
+		return result, err
+	}
+	top, err := os.ReadDir(stage)
+	if err != nil {
+		return result, err
+	}
+	targets := []string{}
+	if zipped {
+		targets = append(targets, path.Join(dir, folder))
+	} else {
+		for _, f := range top {
+			targets = append(targets, path.Join(dir, f.Name()))
+		}
+	}
+	v.mu.Lock()
+	defer v.mu.Unlock()
+	parent := v.root
+	if dir != "" {
+		parent, err = v.abs(dir)
+		if err != nil {
+			return result, err
+		}
+	}
+	info, err := os.Stat(parent)
+	if errors.Is(err, fs.ErrNotExist) {
+		return result, ErrNotFound
+	}
+	if err != nil {
+		return result, err
+	}
+	if !info.IsDir() {
+		return result, fmt.Errorf("%w：目标不是文件夹", ErrInvalidImport)
+	}
+	for _, target := range targets {
+		dest, err := v.abs(target)
+		if err != nil {
+			return result, err
+		}
+		if _, err := os.Lstat(dest); err == nil {
+			return result, fmt.Errorf("%w：%s，请修改名称", ErrExists, target)
+		} else if !errors.Is(err, fs.ErrNotExist) {
+			return result, err
+		}
+	}
+	if err := ctx.Err(); err != nil {
+		return result, err
+	}
+	if zipped {
+		// 暂存目录与仓库位于同一文件系统，整个 ZIP 一次 rename 发布。
+		err = os.Rename(stage, filepath.Join(parent, folder))
+	} else {
+		var published []string
+		for _, f := range top {
+			name := f.Name()
+			if err = os.Rename(filepath.Join(stage, name), filepath.Join(parent, name)); err != nil {
+				for _, prev := range published {
+					if rollback := os.Rename(filepath.Join(parent, prev), filepath.Join(stage, prev)); rollback != nil {
+						err = errors.Join(err, fmt.Errorf("回滚导入失败：%w", rollback))
+					}
+				}
+				break
+			}
+			published = append(published, name)
+		}
+	}
+	if err != nil {
+		return result, err
+	}
+	result.Paths = targets
+	return result, nil
+}

internal/vault/import_links.go

@@ -0,0 +1,211 @@
+package vault
+
+import (
+	"bytes"
+	"context"
+	"fmt"
+	"html"
+	"net/url"
+	"os"
+	"path"
+	"path/filepath"
+	"regexp"
+	"sort"
+	"strconv"
+	"strings"
+)
+
+var importRef = regexp.MustCompile(`^ {0,3}\[[^\]\r\n]+\]:[ \t]*`)
+var importSrc = regexp.MustCompile(`(?i)<(?:img|source|video|audio)\b[^>]*?\bsrc\s*=\s*["']([^"']*)["']`)
+var markdownEscape = regexp.MustCompile("\\\\([!\"#$%&'()*+,\\-./:;<=>?@\\[\\]\\\\^_`{|}~])")
+
+type importLink struct {
+	start, end int
+	html       bool
+}
+
+// linkDestination 返回目的地址本身的区间，不含尖括号、标题或闭合括号。
+func linkDestination(text []byte, start int) (int, int) {
+	for start < len(text) && (text[start] == ' ' || text[start] == '\t') {
+		start++
+	}
+	if start == len(text) {
+		return start, start
+	}
+	if text[start] == '<' {
+		end := start + 1
+		for end < len(text) && text[end] != '>' && text[end] != '\n' && text[end] != '\r' {
+			if text[end] == '\\' && end+1 < len(text) {
+				end++
+			}
+			end++
+		}
+		if end < len(text) && text[end] == '>' {
+			return start + 1, end
+		}
+		return start, start
+	}
+	depth := 0
+	end := start
+	for end < len(text) {
+		c := text[end]
+		if c == '\\' && end+1 < len(text) {
+			end += 2
+			continue
+		}
+		if c == '(' {
+			depth++
+		}
+		if c == ')' {
+			if depth == 0 {
+				break
+			}
+			depth--
+		}
+		if c == ' ' || c == '\t' || c == '\n' || c == '\r' {
+			break
+		}
+		end++
+	}
+	if depth != 0 {
+		return start, start
+	}
+	return start, end
+}
+
+func importLinkSpans(text []byte) []importLink {
+	var spans []importLink
+	if m := importRef.FindIndex(text); m != nil {
+		start, end := linkDestination(text, m[1])
+		if end > start {
+			spans = append(spans, importLink{start, end, false})
+		}
+	}
+	for pos := 0; pos < len(text); {
+		i := bytes.Index(text[pos:], []byte("]("))
+		if i < 0 {
+			break
+		}
+		i += pos
+		// 转义的闭括号不是链接语法。
+		escapes := 0
+		for j := i - 1; j >= 0 && text[j] == '\\'; j-- {
+			escapes++
+		}
+		start, end := linkDestination(text, i+2)
+		if escapes%2 == 0 && end > start {
+			spans = append(spans, importLink{start, end, false})
+		}
+		pos = max(i+2, end)
+	}
+	for _, m := range importSrc.FindAllSubmatchIndex(text, -1) {
+		spans = append(spans, importLink{m[2], m[3], true})
+	}
+	return spans
+}
+
+func (v *Vault) importLinks(ctx context.Context, note string, content []byte, total *int64) ([]byte, []string, error) {
+	var failure error
+	missing := map[string]bool{}
+	replacements := map[string]string{}
+	transform := func(text []byte) []byte {
+		spans := importLinkSpans(text)
+		// 区间可能来自 HTML 或 Markdown，按原始顺序替换，保持其他字节不变。
+		sort.Slice(spans, func(i, j int) bool { return spans[i].start < spans[j].start })
+		var out []byte
+		last := 0
+		for _, span := range spans {
+			if span.start < last || failure != nil {
+				continue
+			}
+			raw := string(text[span.start:span.end])
+			target := raw
+			if span.html {
+				target = html.UnescapeString(target)
+			} else {
+				target = markdownEscape.ReplaceAllString(target, "$1")
+			}
+			u, err := url.Parse(target)
+			if err != nil || u.IsAbs() || u.Host != "" || strings.HasPrefix(target, "/") || u.Path == "" {
+				continue
+			}
+			rel := path.Clean(path.Join(path.Dir(note), u.Path))
+			if _, err := CleanPath(rel); err != nil {
+				missing[rel] = true
+				continue
+			}
+			info, err := os.Stat(filepath.Join(v.root, filepath.FromSlash(rel)))
+			if os.IsNotExist(err) {
+				missing[rel] = true
+				continue
+			}
+			if err != nil {
+				failure = err
+				continue
+			}
+			if !info.Mode().IsRegular() {
+				continue
+			}
+			switch strings.ToLower(path.Ext(rel)) {
+			case ".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg", ".avif", ".apng", ".bmp", ".ico", ".tif", ".tiff":
+			default:
+				continue
+			}
+			replacement, found := replacements[rel]
+			if !found {
+				if err := ctx.Err(); err != nil {
+					failure = err
+					continue
+				}
+				data, err := os.ReadFile(filepath.Join(v.root, filepath.FromSlash(rel)))
+				if err != nil {
+					failure = err
+					continue
+				}
+				// 只统计新生成的副本；已有同名附件必须与哈希对应的内容一致。
+				dest := filepath.Join(v.root, filepath.FromSlash(AssetsDir(note)), assetName(data, path.Base(rel)))
+				existing, readErr := os.ReadFile(dest)
+				if readErr != nil && !os.IsNotExist(readErr) {
+					failure = readErr
+					continue
+				}
+				if readErr == nil && !bytes.Equal(data, existing) {
+					failure = fmt.Errorf("%w：附件名称与内容冲突", ErrInvalidImport)
+					continue
+				}
+				if os.IsNotExist(readErr) {
+					if int64(len(data)) > maxImportExpanded-*total {
+						failure = ErrTooLarge
+						continue
+					}
+					*total += int64(len(data))
+				}
+				replacement, err = v.SaveAsset(note, path.Base(rel), bytes.NewReader(data), importAssetLimit)
+				if err != nil {
+					failure = err
+					continue
+				}
+				replacements[rel] = replacement
+			}
+			if u.RawQuery != "" {
+				replacement += "?" + u.RawQuery
+			}
+			if u.Fragment != "" {
+				replacement += "#" + u.EscapedFragment()
+			}
+			if span.html {
+				replacement = html.EscapeString(replacement)
+			}
+			out = append(out, text[last:span.start]...)
+			out = append(out, replacement...)
+			last = span.end
+		}
+		return append(out, text[last:]...)
+	}
+	updated := transformMarkdownLines(content, importRef, func(line []byte) []byte { return transformOutsideCode(line, transform) })
+	warnings := []string{}
+	if len(missing) > 0 {
+		warnings = append(warnings, note+"："+strconv.Itoa(len(missing))+" 个本地链接的目标不在导入内容中，已保留原链接")
+	}
+	return updated, warnings, failure
+}

internal/vault/import_test.go

@@ -0,0 +1,204 @@
+package vault
+
+import (
+	"archive/zip"
+	"bytes"
+	"context"
+	"errors"
+	"io/fs"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+)
+
+type zipEntry struct {
+	name, content string
+	mode          fs.FileMode
+}
+
+func importZip(t *testing.T, entries ...zipEntry) ImportFile {
+	t.Helper()
+	var b bytes.Buffer
+	w := zip.NewWriter(&b)
+	for _, e := range entries {
+		h := &zip.FileHeader{Name: e.name, Method: zip.Deflate}
+		if e.mode != 0 {
+			h.SetMode(e.mode)
+		}
+		f, err := w.CreateHeader(h)
+		if err != nil {
+			t.Fatal(err)
+		}
+		if _, err := f.Write([]byte(e.content)); err != nil {
+			t.Fatal(err)
+		}
+	}
+	if err := w.Close(); err != nil {
+		t.Fatal(err)
+	}
+	data := b.Bytes()
+	return ImportFile{Name: "知识库.md.zip", Reader: bytes.NewReader(data), Size: int64(len(data))}
+}
+
+func markdownFile(name, content string) ImportFile {
+	return ImportFile{Name: name, Reader: strings.NewReader(content), Size: int64(len(content))}
+}
+
+func TestImportZipAssetsAndMove(t *testing.T) {
+	v := newVault(t)
+	content := "# 标题\n\n![图](<assets/图 (1).png> \"说明\")\n\n![引用][图]\n\n[图]: assets/图%20(1).png\n\n<img src=\"assets/图%20(1).png\">\n\n[子笔记](子目录/子笔记.md)\n\n![外链](https://example.com/a.png)\n\n![缺失](assets/missing.png)\n\n`![代码](assets/图%20(1).png)`\n\n```md\n![代码块](assets/图%20(1).png)\n```\n\n> ```\n> ![引用代码](assets/图%20(1).png)\n> ```\n\n    ![缩进代码](assets/图%20(1).png)\n"
+	source := importZip(t, zipEntry{name: "目录/笔记.md", content: content}, zipEntry{name: "目录/子目录/子笔记.md", content: "# 子笔记"}, zipEntry{name: "目录/assets/图 (1).png", content: "image"}, zipEntry{name: "未引用.txt", content: "附件"})
+	result, err := v.Import(context.Background(), "", "知识库", []ImportFile{source})
+	if err != nil {
+		t.Fatal(err)
+	}
+	if result.Notes != 2 || result.Assets != 3 || len(result.Warnings) != 1 || len(result.Paths) != 1 || result.Paths[0] != "知识库" {
+		t.Fatalf("结果不符: %+v", result)
+	}
+	body, _, err := v.Read("知识库/目录/笔记.md")
+	if err != nil {
+		t.Fatal(err)
+	}
+	link := EscapeLinkPath("笔记.assets") + "/" + assetName([]byte("image"), "x.png")
+	expected := strings.Replace(content, "<assets/图 (1).png>", "<"+link+">", 1)
+	expected = strings.Replace(expected, "[图]: assets/图%20(1).png", "[图]: "+link, 1)
+	expected = strings.Replace(expected, "src=\"assets/图%20(1).png\"", "src=\""+link+"\"", 1)
+	if string(body) != expected {
+		t.Fatalf("正文变更不符:\n%s", body)
+	}
+	if err := v.Mkdir("移动目标"); err != nil {
+		t.Fatal(err)
+	}
+	if _, err := v.Move("知识库/目录/笔记.md", "移动目标/改名.md"); err != nil {
+		t.Fatal(err)
+	}
+	moved, _, err := v.Read("移动目标/改名.md")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !strings.Contains(string(moved), "改名.assets/") {
+		t.Fatal("图片链接未跟随改名")
+	}
+	if _, err := os.Stat(filepath.Join(v.root, "移动目标/改名.assets", assetName([]byte("image"), "x.png"))); err != nil {
+		t.Fatal("附件未跟随", err)
+	}
+	original, err := os.ReadFile(filepath.Join(v.root, "知识库/目录/assets/图 (1).png"))
+	if err != nil || string(original) != "image" {
+		t.Fatal("原始附件丢失", err)
+	}
+}
+
+func TestImportRejectsInvalidWithoutPublishing(t *testing.T) {
+	for _, tc := range []struct {
+		name    string
+		entries []zipEntry
+		want    error
+	}{
+		{"越界", []zipEntry{{name: "../outside.md", content: "x"}}, ErrInvalidImport},
+		{"隐藏路径", []zipEntry{{name: ".rawmark/x.md", content: "x"}}, ErrInvalidImport},
+		{"重复路径", []zipEntry{{name: "a.md", content: "x"}, {name: "a.md", content: "y"}}, ErrInvalidImport},
+		{"符号链接", []zipEntry{{name: "a.md", content: "x", mode: os.ModeSymlink | 0o777}}, ErrInvalidImport},
+		{"目录文件冲突", []zipEntry{{name: "a/"}, {name: "a", content: "x"}, {name: "b.md", content: "x"}}, ErrInvalidImport},
+		{"文件目录冲突反向", []zipEntry{{name: "a", content: "x"}, {name: "a/"}, {name: "b.md", content: "x"}}, ErrInvalidImport},
+		{"无笔记", []zipEntry{{name: "a.png", content: "x"}}, ErrInvalidImport},
+		{"非法编码", []zipEntry{{name: "a.md", content: "\xff"}}, ErrInvalidImport},
+		{"附件目录内笔记", []zipEntry{{name: "a.assets/a.md", content: "x"}}, ErrInvalidImport},
+		{"文件目录冲突", []zipEntry{{name: "a", content: "x"}, {name: "a/b.md", content: "y"}}, ErrInvalidImport},
+	} {
+		t.Run(tc.name, func(t *testing.T) {
+			v := newVault(t)
+			_, err := v.Import(context.Background(), "", "导入", []ImportFile{importZip(t, tc.entries...)})
+			if !errors.Is(err, tc.want) {
+				t.Fatalf("错误不符: %v", err)
+			}
+			entries, err := os.ReadDir(v.root)
+			if err != nil {
+				t.Fatal(err)
+			}
+			if len(entries) != 1 || entries[0].Name() != metaDir {
+				t.Fatal("失败后留下可见内容或临时目录")
+			}
+		})
+	}
+}
+
+func TestImportBatchConflictAndCancellation(t *testing.T) {
+	v := newVault(t)
+	if _, err := v.Write("b.md", []byte("原文"), Precondition{}); err != nil {
+		t.Fatal(err)
+	}
+	sources := []ImportFile{markdownFile("a.md", "新文"), markdownFile("b.md", "覆盖")}
+	if _, err := v.Import(context.Background(), "", "", sources); !errors.Is(err, ErrExists) {
+		t.Fatal(err)
+	}
+	if _, _, err := v.Read("a.md"); !errors.Is(err, ErrNotFound) {
+		t.Fatal("批量冲突产生了半成品", err)
+	}
+	body, _, _ := v.Read("b.md")
+	if string(body) != "原文" {
+		t.Fatal("原文件被覆盖")
+	}
+	ctx, cancel := context.WithCancel(context.Background())
+	cancel()
+	if _, err := v.Import(ctx, "", "", sources[:1]); !errors.Is(err, context.Canceled) {
+		t.Fatal(err)
+	}
+	if _, err := v.Import(context.Background(), "不存在", "", sources[:1]); !errors.Is(err, ErrNotFound) {
+		t.Fatal(err)
+	}
+	result, err := v.Import(context.Background(), "", "", []ImportFile{markdownFile("a.md", "\xef\xbb\xbf正文"), markdownFile("c.md", "![缺图](local.png)")})
+	if err != nil || result.Notes != 2 || len(result.Warnings) != 1 {
+		t.Fatalf("结果不符: %+v %v", result, err)
+	}
+	body, _, _ = v.Read("a.md")
+	if string(body) != "正文" {
+		t.Fatal("UTF-8 BOM 未处理")
+	}
+}
+
+func TestImportLimitsAndCorruptZip(t *testing.T) {
+	v := newVault(t)
+	source := markdownFile("large.md", strings.Repeat("a", importNoteLimit+1))
+	if _, err := v.Import(context.Background(), "", "", []ImportFile{source}); !errors.Is(err, ErrTooLarge) {
+		t.Fatal(err)
+	}
+	source.Size = MaxImportBytes + 1
+	if _, err := v.Import(context.Background(), "", "", []ImportFile{source}); !errors.Is(err, ErrTooLarge) {
+		t.Fatal(err)
+	}
+	broken := markdownFile("broken.zip", "not zip")
+	if _, err := v.Import(context.Background(), "", "导入", []ImportFile{broken}); !errors.Is(err, ErrInvalidImport) {
+		t.Fatal(err)
+	}
+}
+
+func TestImportCorruptZipContent(t *testing.T) {
+	v := newVault(t)
+	var buffer bytes.Buffer
+	writer := zip.NewWriter(&buffer)
+	f, err := writer.CreateHeader(&zip.FileHeader{Name: "n.md", Method: zip.Store})
+	if err != nil {
+		t.Fatal(err)
+	}
+	payload := []byte("unique markdown payload")
+	if _, err := f.Write(payload); err != nil {
+		t.Fatal(err)
+	}
+	if err := writer.Close(); err != nil {
+		t.Fatal(err)
+	}
+	data := buffer.Bytes()
+	offset := bytes.Index(data, payload)
+	if offset < 0 {
+		t.Fatal("找不到测试负载")
+	}
+	data[offset] ^= 1
+	_, err = v.Import(context.Background(), "", "损坏", []ImportFile{{Name: "broken.zip", Reader: bytes.NewReader(data), Size: int64(len(data))}})
+	if !errors.Is(err, ErrInvalidImport) {
+		t.Fatalf("应拒绝 CRC 损坏: %v", err)
+	}
+	if _, err := os.Stat(filepath.Join(v.root, "损坏")); !os.IsNotExist(err) {
+		t.Fatal("损坏内容被发布", err)
+	}
+}

internal/vault/links.go

@@ -16,6 +16,14 @@ func RewriteAssetLinks(content []byte, oldBase, newBase string) []byte {
 	refDef := regexp.MustCompile(`^( {0,3}\[[^\]]+\]:\s*<?)` + target)
 	repl := []byte("${1}${2}" + strings.ReplaceAll(EscapeLinkPath(newBase+AssetsExt), "$", "$$") + "/")
 
+	return transformMarkdownLines(content, refDef, func(line []byte) []byte {
+		line = refDef.ReplaceAll(line, repl)
+		return transformOutsideCode(line, func(text []byte) []byte { return inline.ReplaceAll(text, repl) })
+	})
+}
+
+// transformMarkdownLines 复用链接改写的容器与代码块识别，避免导入时修改代码示例。
+func transformMarkdownLines(content []byte, refDef *regexp.Regexp, transform func([]byte) []byte) []byte {
 	lines := bytes.SplitAfter(content, []byte("\n"))
 	var fence []byte // 当前所在围栏代码块的围栏字符串，nil 表示不在代码块中
 	var containers []linkContainer
@@ -111,8 +119,7 @@ func RewriteAssetLinks(content []byte, oldBase, newBase string) []byte {
 			continue
 		}
 		paragraph = !paragraphBoundary.Match(trimmed) && !refDef.Match(trimmed)
-		line = refDef.ReplaceAll(line, repl)
-		lines[i] = replaceOutsideCode(line, inline, repl)
+		lines[i] = transform(line)
 	}
 	return bytes.Join(lines, nil)
 }
@@ -161,8 +168,8 @@ func fenceOpen(line []byte) []byte {
 	return rest[:n]
 }
 
-// replaceOutsideCode 只在行内代码 `…` 之外的片段上做替换
-func replaceOutsideCode(line []byte, re *regexp.Regexp, repl []byte) []byte {
+// transformOutsideCode 只在行内代码 `…` 之外的片段上做转换。
+func transformOutsideCode(line []byte, transform func([]byte) []byte) []byte {
 	var out []byte
 	for len(line) > 0 {
 		start := bytes.IndexByte(line, '`')
@@ -178,9 +185,9 @@ func replaceOutsideCode(line []byte, re *regexp.Regexp, repl []byte) []byte {
 			break
 		}
 		codeEnd := start + n + end + n
-		out = append(out, re.ReplaceAll(line[:start], repl)...)
+		out = append(out, transform(line[:start])...)
 		out = append(out, line[start:codeEnd]...)
 		line = line[codeEnd:]
 	}
-	return append(out, re.ReplaceAll(line, repl)...)
+	return append(out, transform(line)...)
 }

internal/vault/vault.go

@@ -696,12 +696,7 @@ func (v *Vault) SaveAsset(note, origName string, r io.Reader, limit int64) (stri
 	if int64(len(data)) > limit {
 		return "", ErrTooLarge
 	}
-	ext := strings.ToLower(filepath.Ext(origName))
-	if !extPattern.MatchString(ext) {
-		ext = sniffExt(data)
-	}
-	sum := sha256.Sum256(data)
-	name := hex.EncodeToString(sum[:8]) + ext
+	name := assetName(data, origName)
 	dir := AssetsDir(p)
 	v.mu.Lock()
 	defer v.mu.Unlock()
@@ -722,6 +717,15 @@ func (v *Vault) SaveAsset(note, origName string, r io.Reader, limit int64) (stri
 	return EscapeLinkPath(path.Base(AssetsDir(note))) + "/" + name, nil
 }
 
+func assetName(data []byte, origName string) string {
+	ext := strings.ToLower(filepath.Ext(origName))
+	if !extPattern.MatchString(ext) {
+		ext = sniffExt(data)
+	}
+	sum := sha256.Sum256(data)
+	return hex.EncodeToString(sum[:8]) + ext
+}
+
 func sniffExt(data []byte) string {
 	switch http.DetectContentType(data) {
 	case "image/png":

web/src/app/Icon.vue

@@ -3,6 +3,7 @@
 const paths = {
   menu: 'M4 6h16M4 12h16M4 18h16',
   noteAdd: 'M14 3H6a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V9zM14 3v6h6M12 12v6M9 15h6',
+  import: 'M12 3v12m-5-5 5 5 5-5M4 15v5h16v-5',
   folderAdd: 'M3 7a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2zM12 10v6M9 13h6',
   folder: 'M3 7a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z',
   note: 'M14 3H6a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V9zM14 3v6h6',

web/src/app/ImportDialog.vue

@@ -0,0 +1,114 @@
+<script setup lang="ts">
+import { computed, onMounted, ref } from 'vue'
+import { ApiError, type ImportResult } from './api'
+import Icon from './Icon.vue'
+import { dirname } from './paths'
+import { expanded } from './tree'
+import { importNotes } from './workspace'
+
+const props = defineProps<{ dir: string }>()
+const emit = defineEmits<{ close: [] }>()
+const files = ref<File[]>([])
+const folder = ref('')
+const names = ref<string[]>([])
+const busy = ref(false)
+const error = ref('')
+const result = ref<ImportResult | null>(null)
+const zipped = computed(() => files.value.length === 1 && /\.zip$/i.test(files.value[0].name))
+
+const dialog = ref<HTMLElement>()
+const validation = computed(() => {
+  if (!zipped.value && files.value.some((f) => !f.name.endsWith('.md'))) return '请选择 .md 文件，或单独选择一个 ZIP'
+  if (files.value.reduce((sum, file) => sum + file.size, 0) > 100_000_000) return '导入文件总量不能超过 100 MB'
+  return ''
+})
+onMounted(() => dialog.value?.focus())
+
+function choose(event: Event) {
+  const input = event.target as HTMLInputElement
+  files.value = [...(input.files ?? [])]
+  names.value = files.value.map((f) => f.name)
+  error.value = ''
+  result.value = null
+  if (zipped.value) folder.value = files.value[0].name.replace(/(?:\.md)?\.zip$/i, '')
+  else folder.value = ''
+}
+
+function close() {
+  if (!busy.value) emit('close')
+}
+
+async function submit() {
+  if (busy.value || !files.value.length || validation.value || result.value) return
+  if (zipped.value && !folder.value.trim()) { error.value = '请输入导入文件夹名称'; return }
+  busy.value = true
+  error.value = ''
+  try {
+    // 支持修改普通 Markdown 的目标文件名，以便处理同名冲突。
+    const uploads = zipped.value ? files.value : files.value.map((file, i) => new File([file], names.value[i], { type: file.type }))
+    result.value = await importNotes(props.dir, zipped.value ? folder.value.trim() : '', uploads)
+    for (const p of result.value.paths) {
+      for (let d = zipped.value ? p : dirname(p); d; d = dirname(d)) expanded.add(d)
+    }
+    // 导入文件成功后释放浏览器持有的文件，结果仍保留在弹窗中。
+    files.value = []
+  } catch (err) {
+    error.value = err instanceof ApiError ? err.message : '网络错误，导入结果尚未确认，请检查目标目录后再重试'
+  } finally {
+    busy.value = false
+  }
+}
+</script>
+
+<template>
+  <div class="rm-dialog-backdrop" @click.self="close" @keydown.esc.stop.prevent="close">
+    <section ref="dialog" class="rm-dialog" tabindex="-1" role="dialog" aria-modal="true" aria-label="导入 Markdown" :aria-busy="busy">
+      <div class="rm-dialog-head">
+        <h2>导入 Markdown</h2>
+        <button class="rm-icon-btn" title="关闭" :disabled="busy" @click="close"><Icon name="close" /></button>
+      </div>
+      <form class="rm-import-body" @submit.prevent="submit">
+        <p class="rm-import-target">导入到：{{ dir || '根目录' }}</p>
+        <template v-if="!result">
+          <label>选择 Markdown 文件或一个 ZIP
+            <input type="file" accept=".md,.zip" multiple :disabled="busy" @change="choose" />
+          </label>
+          <label v-if="zipped">新建文件夹名称
+            <input v-model="folder" :disabled="busy" required @input="error = ''" />
+          </label>
+          <div v-else-if="files.length" class="rm-import-files">
+            <label v-for="(file, i) in files" :key="i">{{ file.name }}
+              <input v-model="names[i]" :disabled="busy" required aria-label="导入文件名称" @input="error = ''" />
+            </label>
+          </div>
+          <p class="rm-import-hint">总上传上限 100 MB。ZIP 保留目录层级，本地图片转为笔记独立附件；不覆盖已有内容。单独导入 Markdown 不包含本地附件。</p>
+        </template>
+        <div v-if="result" role="status">
+          <p>导入完成：{{ result.notes }} 篇笔记，{{ result.assets }} 个附件（含独立副本）。</p>
+          <details v-if="result.warnings.length" class="rm-import-warnings">
+            <summary>{{ result.warnings.length }} 篇笔记有链接提示</summary>
+            <ul><li v-for="warning in result.warnings" :key="warning">{{ warning }}</li></ul>
+          </details>
+        </div>
+        <p v-if="error || validation" class="rm-auth-error" role="alert">{{ error || validation }}</p>
+        <p v-if="busy" role="status">正在上传并整理，请勿关闭页面…</p>
+        <div class="rm-import-actions">
+          <button type="button" class="rm-btn" :disabled="busy" @click="close">{{ result ? '完成' : '取消' }}</button>
+          <button v-if="!result" type="submit" class="rm-btn rm-btn-primary" :disabled="busy || !files.length || !!validation">{{ busy ? '导入中…' : '导入' }}</button>
+        </div>
+      </form>
+    </section>
+  </div>
+</template>
+
+<style scoped>
+.rm-import-body { display: flex; flex-direction: column; gap: 16px; padding: 8px 20px 20px; overflow-y: auto; font-size: 14px; }
+.rm-import-body p { margin: 0; }
+.rm-import-body label { display: flex; flex-direction: column; gap: 8px; overflow-wrap: anywhere; }
+.rm-import-body input { min-width: 0; padding: 8px; border: 1px solid var(--rm-divider); border-radius: 6px; background: var(--rm-bg); color: var(--rm-text); font: inherit; }
+.rm-import-target, .rm-import-hint { color: var(--rm-text-muted); overflow-wrap: anywhere; }
+.rm-import-hint { font-size: 12px; line-height: 1.6; }
+.rm-import-files { display: flex; flex-direction: column; gap: 12px; }
+.rm-import-actions { display: flex; justify-content: flex-end; gap: 8px; }
+.rm-import-warnings { line-height: 1.6; overflow-wrap: anywhere; }
+</style>

web/src/app/Sidebar.vue

@@ -39,6 +39,7 @@ function onRootDrop(e: DragEvent) {
       </button>
       <button class="rm-icon-btn" title="新建笔记" @click="createNote('')"><Icon name="noteAdd" /></button>
       <button class="rm-icon-btn" title="新建文件夹" @click="createFolder('')"><Icon name="folderAdd" /></button>
+      <button class="rm-icon-btn" title="导入" @click="ws.importing = ''"><Icon name="import" /></button>
     </div>
     <nav v-if="sidebarViews.size" class="rm-plugin-tabs" aria-label="侧栏视图">
       <button class="rm-btn" :class="{ on: !currentView }" @click="selectedView = ''">文件</button>

web/src/app/TreeNode.vue

@@ -70,13 +70,14 @@ function commitRename() {
   if (target && target !== props.node.path) void move(props.node.path, target)
 }
 
-function runMenu(action: 'note' | 'folder' | 'rename' | 'move' | 'share' | 'delete') {
+function runMenu(action: 'note' | 'folder' | 'import' | 'rename' | 'move' | 'share' | 'delete') {
   menuOpen.value = false
   const path = props.node.path
   if (action === 'note' || action === 'folder') {
     expanded.add(path)
     void (action === 'note' ? createNote(path) : createFolder(path))
-  } else if (action === 'rename') ws.renaming = path
+  } else if (action === 'import') ws.importing = path
+  else if (action === 'rename') ws.renaming = path
   else if (action === 'share') ws.sharing = path
   else if (action === 'move') ws.moving = path
   else void remove(path)
@@ -147,6 +148,7 @@ function onDrop(e: DragEvent) {
         <template v-if="node.dir">
           <button @click="runMenu('note')"><Icon name="noteAdd" />新建笔记</button>
           <button @click="runMenu('folder')"><Icon name="folderAdd" />新建文件夹</button>
+          <button @click="runMenu('import')"><Icon name="import" />导入</button>
         </template>
         <button @click="runMenu('rename')"><Icon name="edit" />重命名</button>
         <button @click="runMenu('move')"><Icon name="folder" />移动到…</button>

web/src/app/Workspace.vue

@@ -6,6 +6,7 @@ import EditorPane from './EditorPane.vue'
 import Icon from './Icon.vue'
 import MobileToolbar from './MobileToolbar.vue'
 import MoveDialog from './MoveDialog.vue'
+import ImportDialog from './ImportDialog.vue'
 import NoteBanner from './NoteBanner.vue'
 import OutlinePanel from './OutlinePanel.vue'
 import QuickSwitcher from './QuickSwitcher.vue'
@@ -120,6 +121,7 @@ onBeforeUnmount(() => {
     <QuickSwitcher v-if="ws.switcher !== null" />
     <SettingsDialog v-if="ws.settings" />
     <ShareDialog v-if="ws.sharing" :path="ws.sharing" @close="ws.sharing = null" />
+    <ImportDialog v-if="ws.importing !== null" :dir="ws.importing" @close="ws.importing = null" />
     <MoveDialog v-if="ws.moving" :path="ws.moving" @close="ws.moving = null" />
   </div>
 </template>

web/src/app/api.ts

@@ -7,6 +7,13 @@ export interface Entry {
   mtime: number
 }
 
+export interface ImportResult {
+  paths: string[]
+  notes: number
+  assets: number
+  warnings: string[]
+}
+
 export interface Theme {
   id: string
   name: string
@@ -127,6 +134,14 @@ export const api = {
   // 按顶层键合并，值为 null 的键被删除
   patchSettings: (patch: Record<string, unknown>) => json<Record<string, unknown>>(request('PATCH', '/api/v1/settings', { json: patch })),
 
+  importNotes: (dir: string, folder: string, files: File[]) => {
+    const body = new FormData()
+    body.append('dir', dir)
+    body.append('folder', folder)
+    for (const file of files) body.append('files', file)
+    return json<ImportResult>(request('POST', '/api/v1/import', { body }))
+  },
+
   tree: async () => (await json<{ entries: Entry[] }>(request('GET', '/api/v1/tree'))).entries,
   search: async (q: string) => (await json<{ results: SearchResult[] }>(request('GET', '/api/v1/search?q=' + encodeURIComponent(q)))).results,
 

web/src/app/workspace.test.ts

@@ -6,7 +6,7 @@ import { api, ApiError } from './api'
 import { drafts, type Draft } from './drafts'
 import { connectEvents } from './events'
 import { pluginEvents } from '../plugins/registry'
-import { attachView, closeTab, editorStateOf, flush, keepLocalVersion, move, openNote, refreshTree, startWorkspace, stopWorkspace, storeViewState, ws } from './workspace'
+import { attachView, closeTab, editorStateOf, flush, keepLocalVersion, importNotes, move, readyToReload, openNote, refreshTree, startWorkspace, stopWorkspace, storeViewState, ws } from './workspace'
 
 vi.mock('./events', () => ({ connectEvents: vi.fn(() => () => {}) }))
 
@@ -248,3 +248,30 @@ describe('保存与关闭', () => {
     await closeTab('draft-move.md')
   })
 })
+
+describe('导入', () => {
+  it('上传期间阻止刷新，成功后刷新目录，并保留真实的成功结果', async () => {
+    ws.tabs = []
+    const result = { paths: ['导入'], notes: 1, assets: 0, warnings: [] }
+    let finish!: (value: typeof result) => void
+    vi.spyOn(api, 'importNotes').mockImplementation(() => new Promise((resolve) => { finish = resolve }))
+    vi.spyOn(api, 'tree').mockResolvedValue([{ path: '导入', dir: true, size: 0, mtime: 0 }])
+    const importing = importNotes('', '导入', [new File(['正文'], 'test.md')])
+    expect(readyToReload()).toBe(false)
+    finish(result)
+    expect(await importing).toEqual(result)
+    expect(ws.entries.some((e) => e.path === '导入')).toBe(true)
+    expect(readyToReload()).toBe(true)
+    vi.mocked(api.importNotes).mockResolvedValueOnce(result)
+    vi.mocked(api.tree).mockRejectedValueOnce(new ApiError(500, '目录读取失败'))
+    expect(await importNotes('', '导入', [])).toEqual(result)
+    expect(ws.toasts.some((t) => t.text.includes('导入已完成，目录刷新失败'))).toBe(true)
+  })
+
+  it('失败保留错误并释放操作占用', async () => {
+    ws.tabs = []
+    vi.spyOn(api, 'importNotes').mockRejectedValue(new ApiError(409, '目标已存在'))
+    await expect(importNotes('', '导入', [])).rejects.toMatchObject({ status: 409, message: '目标已存在' })
+    expect(readyToReload()).toBe(true)
+  })
+})

web/src/app/workspace.ts

@@ -62,6 +62,8 @@ export const ws = reactive({
   sharing: null as string | null,
   // 「移动到…」对话框（笔记或文件夹路径）
   moving: null as string | null,
+  // 导入目标目录，空字符串为根目录
+  importing: null as string | null,
   // 电脑上侧栏折叠
   sidebarCollapsed: layout.sidebarCollapsed ?? false,
   // 大纲面板（电脑上在右侧常驻，手机上为浮层）
@@ -664,6 +666,18 @@ async function createNoteFile(path: string): Promise<boolean> {
   })
 }
 
+export async function importNotes(dir: string, folder: string, files: File[]) {
+  // refreshTree 必须等 withOp 结束，否则会等待自身释放操作计数。
+  const result = await withOp(() => api.importNotes(dir, folder, files))
+  ws.searchOpen = false
+  try {
+    await refreshTree()
+  } catch (err) {
+    toast('导入已完成，目录刷新失败：' + errorText(err))
+  }
+  return result
+}
+
 export async function createFolder(dir: string) {
   const path = uniqueName(dir, '新建文件夹', '')
   ws.entries.push({ path, dir: true, size: 0, mtime: Date.now() })