dsh-todo-time-log 0.6.1 → 0.6.2

package/lib/client.js

@@ -260,6 +260,42 @@
       "notice.serverError": "服务器返回了错误。",
       "toast.undo": "撤销",
       "toast.dismiss": "关闭提示",
+      "transfer.open": "数据",
+      "transfer.title": "导入 / 导出",
+      "transfer.close": "关闭",
+      "transfer.exportTitle": "导出",
+      "transfer.exportHint": "导出全部待办。JSON 无损、可回导；CSV 适合用 Excel 统计耗时。",
+      "transfer.exportJson": "导出 JSON",
+      "transfer.exportCsv": "导出 CSV",
+      "transfer.exported": "已导出 {count} 条待办（{format}）",
+      "transfer.importTitle": "导入",
+      "transfer.importHint": "支持本插件 JSON（v1–v5）、待办数组或 CSV；导入前会自动备份当前数据。",
+      "transfer.chooseFile": "选择文件",
+      "transfer.noFile": "未选择文件",
+      "transfer.reading": "读取中…",
+      "transfer.readError": "读取文件失败：{message}",
+      "transfer.emptyFile": "文件内容为空。",
+      "transfer.noPreview": "选择文件后先显示预览，确认后才写入。",
+      "transfer.previewTitle": "导入预览",
+      "transfer.previewAdded": "新增 {count}",
+      "transfer.previewUpdated": "更新 {count}",
+      "transfer.previewSkipped": "跳过 {count}",
+      "transfer.previewRemoved": "移除 {count}",
+      "transfer.previewTotal": "合计 {count}",
+      "transfer.previewRows": "共读取 {count} 行",
+      "transfer.previewInvalid": "非法 {count} 行",
+      "transfer.rowError": "第 {row} 行：{message}",
+      "transfer.modeLabel": "冲突处理",
+      "transfer.modeMerge": "合并（推荐）",
+      "transfer.modeMergeHint": "同 ID 以更新时间较新的为准；新 ID 追加为待办。",
+      "transfer.modeAdd": "仅新增",
+      "transfer.modeAddHint": "已存在的 ID 直接跳过，不修改现有待办。",
+      "transfer.modeReplace": "覆盖全部",
+      "transfer.modeReplaceHint": "先自动备份，再用文件内容替换全部待办。",
+      "transfer.confirm": "开始导入",
+      "transfer.importing": "导入中…",
+      "transfer.imported": "导入完成",
+      "transfer.undone": "已撤销导入",
       "error.panel": "待办时间日志面板出现异常",
       "error.panelHint": "请关闭后重新打开面板；如果问题持续存在，请检查插件日志。",
       "error.detail": "详情：{message}"
@@ -515,6 +551,42 @@
       "notice.serverError": "The server returned an error.",
       "toast.undo": "Undo",
       "toast.dismiss": "Dismiss message",
+      "transfer.open": "Data",
+      "transfer.title": "Import / Export",
+      "transfer.close": "Close",
+      "transfer.exportTitle": "Export",
+      "transfer.exportHint": "Exports every todo. JSON is lossless and re-importable; CSV suits Excel time analysis.",
+      "transfer.exportJson": "Export JSON",
+      "transfer.exportCsv": "Export CSV",
+      "transfer.exported": "Exported {count} todo(s) ({format})",
+      "transfer.importTitle": "Import",
+      "transfer.importHint": "Accepts this plugin JSON (v1–v5), a todo array or CSV; the current data is backed up first.",
+      "transfer.chooseFile": "Choose file",
+      "transfer.noFile": "No file selected",
+      "transfer.reading": "Reading…",
+      "transfer.readError": "Could not read the file: {message}",
+      "transfer.emptyFile": "The file is empty.",
+      "transfer.noPreview": "Pick a file to preview; nothing is written until you confirm.",
+      "transfer.previewTitle": "Import preview",
+      "transfer.previewAdded": "Add {count}",
+      "transfer.previewUpdated": "Update {count}",
+      "transfer.previewSkipped": "Skip {count}",
+      "transfer.previewRemoved": "Remove {count}",
+      "transfer.previewTotal": "Total {count}",
+      "transfer.previewRows": "{count} row(s) read",
+      "transfer.previewInvalid": "{count} invalid row(s)",
+      "transfer.rowError": "Row {row}: {message}",
+      "transfer.modeLabel": "Conflict handling",
+      "transfer.modeMerge": "Merge (recommended)",
+      "transfer.modeMergeHint": "Same id keeps the newer update; new ids are appended.",
+      "transfer.modeAdd": "Add only",
+      "transfer.modeAddHint": "Existing ids are skipped; current todos stay untouched.",
+      "transfer.modeReplace": "Replace all",
+      "transfer.modeReplaceHint": "Backs up first, then replaces every todo with the file contents.",
+      "transfer.confirm": "Start import",
+      "transfer.importing": "Importing…",
+      "transfer.imported": "Import finished",
+      "transfer.undone": "Import undone",
       "error.panel": "The todo time log panel crashed",
       "error.panelHint": "Close and reopen the panel; check the plugin logs if it keeps happening.",
       "error.detail": "Details: {message}"
@@ -577,6 +649,11 @@
     { value: "comfortable", labelKey: "board.densityComfortable" },
     { value: "compact", labelKey: "board.densityCompact" }
   ];
+  var TRANSFER_MODES = [
+    { value: "merge", labelKey: "transfer.modeMerge", hintKey: "transfer.modeMergeHint" },
+    { value: "add", labelKey: "transfer.modeAdd", hintKey: "transfer.modeAddHint" },
+    { value: "replace", labelKey: "transfer.modeReplace", hintKey: "transfer.modeReplaceHint" }
+  ];
   var BOARD_COMPLETED_LIMIT = 10;
   var CALENDAR_BASES = [
     { value: "createdAt", labelKey: "calendar.basisCreated" },
@@ -2204,6 +2281,163 @@
 .ttl-board-card-files { display: flex; flex-wrap: wrap; gap: 4px; margin-top: 2px; }
 .ttl-calendar-entry-files { display: flex; flex: 1 1 100%; flex-wrap: wrap; gap: 4px; }
 .ttl-detail-files { display: flex; flex-wrap: wrap; gap: 4px; }
+
+/* 导入 / 导出：轻量浮层对话框，内容超高时只滚动对话框主体。 */
+.ttl-download-anchor {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+  clip: rect(0 0 0 0);
+  white-space: nowrap;
+}
+.ttl-overlay {
+  position: absolute;
+  inset: 0;
+  z-index: 30;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 24px;
+  background: var(--dsw-alias-bg-mask-1);
+}
+.ttl-dialog {
+  display: flex;
+  flex-direction: column;
+  width: min(560px, 100%);
+  max-height: 100%;
+  border: 0.5px solid var(--dsw-alias-border-l2);
+  border-radius: var(--dsw-radius-lg);
+  background: var(--dsw-alias-bg-base);
+  box-shadow: var(--dsw-shadow-lv3);
+  overflow: hidden;
+}
+.ttl-dialog-head {
+  display: flex;
+  flex: none;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 14px 16px;
+  border-bottom: 0.5px solid var(--dsw-alias-border-l1);
+}
+.ttl-dialog-title {
+  margin: 0;
+  font-size: 15px;
+  font-weight: 600;
+  line-height: 22px;
+  color: var(--dsw-alias-label-primary);
+}
+.ttl-dialog-close {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 26px;
+  height: 26px;
+  padding: 0;
+  border: 0;
+  border-radius: var(--dsw-radius-sm);
+  background: none;
+  color: var(--dsw-alias-label-tertiary);
+  font: inherit;
+  font-size: 18px;
+  line-height: 1;
+  cursor: pointer;
+}
+.ttl-dialog-close:hover { background: var(--dsw-alias-interactive-bg-hover); color: var(--dsw-alias-label-primary); }
+.ttl-dialog-body {
+  display: flex;
+  flex-direction: column;
+  gap: 18px;
+  padding: 16px;
+  overflow-y: auto;
+}
+.ttl-dialog-footer {
+  display: flex;
+  flex: none;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 8px;
+  padding: 12px 16px;
+  border-top: 0.5px solid var(--dsw-alias-border-l1);
+  background: var(--dsw-alias-bg-base);
+}
+.ttl-transfer-section { display: flex; flex-direction: column; gap: 8px; }
+.ttl-transfer-heading {
+  margin: 0;
+  font-size: 13px;
+  font-weight: 600;
+  line-height: 20px;
+  color: var(--dsw-alias-label-primary);
+}
+.ttl-transfer-hint { margin: 0; font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-tertiary); }
+.ttl-dialog-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; }
+.ttl-dialog-actions-end { justify-content: flex-end; padding-top: 4px; }
+.ttl-transfer-file {
+  max-width: 100%;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--dsw-alias-label-secondary);
+}
+.ttl-file-input { display: none; }
+.ttl-transfer-error {
+  margin: 0;
+  padding: 8px 10px;
+  border-radius: var(--dsw-radius-sm);
+  background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 10%, transparent);
+  color: var(--dsw-alias-state-error-primary);
+  font-size: 12px;
+  line-height: 18px;
+}
+.ttl-transfer-preview {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  padding: 12px;
+  border: 0.5px solid var(--dsw-alias-border-l2);
+  border-radius: var(--dsw-radius-md);
+  background: var(--dsw-alias-bg-layer-1);
+}
+.ttl-transfer-preview-title { font-size: 12px; font-weight: 600; line-height: 18px; color: var(--dsw-alias-label-primary); }
+.ttl-transfer-counts { display: flex; flex-wrap: wrap; gap: 6px; }
+.ttl-transfer-count {
+  padding: 2px 8px;
+  border-radius: 999px;
+  background: var(--dsw-alias-bg-module-platform);
+  color: var(--dsw-alias-label-secondary);
+  font-size: 12px;
+  line-height: 18px;
+  font-variant-numeric: tabular-nums;
+}
+.ttl-transfer-rows { margin: 0; font-size: 11px; line-height: 16px; color: var(--dsw-alias-label-tertiary); }
+.ttl-transfer-invalid {
+  margin: 0;
+  padding-left: 16px;
+  color: var(--dsw-alias-state-error-primary);
+  font-size: 11px;
+  line-height: 17px;
+}
+.ttl-transfer-mode { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; font-size: 12px; color: var(--dsw-alias-label-tertiary); }
+.ttl-transfer-mode select {
+  height: 28px;
+  padding: 0 6px;
+  border: 0.5px solid var(--dsw-alias-border-l3);
+  border-radius: var(--dsw-radius-sm);
+  background: var(--dsw-alias-bg-layer-1);
+  color: var(--dsw-alias-label-secondary);
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+.ttl-transfer-mode-hint { margin: 0; font-size: 11px; line-height: 16px; color: var(--dsw-alias-label-tertiary); }
+.ttl-transfer-empty { margin: 0; font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-tertiary); }
+.ttl-overlay .ttl-button { height: 28px; font-size: 12px; }
+@media (max-width: 560px) {
+  .ttl-overlay { align-items: flex-start; padding: 12px; }
+}
 @media (prefers-reduced-motion: reduce) {
   .ttl-input,
   .ttl-button,
@@ -4369,6 +4603,245 @@
     return renderTableView;
   }
 
+  // src/client/transfer.js
+  function makeDownload(content, filename, mime) {
+    const text = typeof content === "string" ? content : "";
+    const name = typeof filename === "string" && filename !== "" ? filename : "todos.json";
+    const type = typeof mime === "string" && mime !== "" ? mime : "application/octet-stream";
+    try {
+      if (typeof Blob !== "undefined" && typeof URL !== "undefined" && typeof URL.createObjectURL === "function") {
+        return { url: URL.createObjectURL(new Blob([text], { type })), name };
+      }
+    } catch {
+    }
+    return { url: `data:${type},${encodeURIComponent(text)}`, name };
+  }
+  function readFileText(file) {
+    if (file && typeof file.text === "function") {
+      return file.text().then((text) => String(text ?? ""));
+    }
+    return new Promise((resolve, reject) => {
+      const reader = new FileReader();
+      reader.onload = () => resolve(String(reader.result ?? ""));
+      reader.onerror = () => reject(new Error("读取文件失败"));
+      reader.readAsText(file, "utf-8");
+    });
+  }
+  function countChip(labelKey, count) {
+    const value = Number(count);
+    return h(
+      "span",
+      { className: "ttl-transfer-count", key: labelKey },
+      t(labelKey, { count: Number.isFinite(value) && value > 0 ? Math.floor(value) : 0 })
+    );
+  }
+  function TransferDialog(props) {
+    const {
+      open,
+      busy,
+      applying,
+      fileName,
+      mode,
+      preview,
+      error,
+      fileInputRef,
+      onClose,
+      onExport,
+      onPickFile,
+      onFileChange,
+      onModeChange,
+      onConfirm
+    } = props;
+    if (open !== true) return null;
+    const record = isRecord(preview) ? preview : null;
+    const summary = record !== null && isRecord(record.summary) ? record.summary : null;
+    const invalid = record !== null && Array.isArray(record.invalid) ? record.invalid.slice(0, 5) : [];
+    const invalidCount = record !== null && typeof record.invalidCount === "number" ? record.invalidCount : 0;
+    const rowCount = record !== null && typeof record.rowCount === "number" ? record.rowCount : 0;
+    const activeMode = TRANSFER_MODES.find((option) => option.value === mode) ?? TRANSFER_MODES[0];
+    const canConfirm = summary !== null && busy !== true && applying !== true;
+    const backdrop = (event) => {
+      if (event && event.target === event.currentTarget) onClose();
+    };
+    return h(
+      "div",
+      { className: "ttl-overlay", role: "presentation", onMouseDown: backdrop },
+      h(
+        "div",
+        {
+          className: "ttl-dialog",
+          role: "dialog",
+          "aria-modal": "true",
+          "aria-labelledby": "ttl-transfer-title",
+          onKeyDown: (event) => {
+            if (event && event.key === "Escape") {
+              event.stopPropagation();
+              onClose();
+            }
+          }
+        },
+        h(
+          "div",
+          { className: "ttl-dialog-head" },
+          h("h2", { id: "ttl-transfer-title", className: "ttl-dialog-title" }, t("transfer.title")),
+          h(
+            "button",
+            {
+              type: "button",
+              className: "ttl-dialog-close",
+              onClick: onClose,
+              disabled: busy === true,
+              "aria-label": t("transfer.close"),
+              autoFocus: true
+            },
+            "×"
+          )
+        ),
+        h(
+          "div",
+          { className: "ttl-dialog-body" },
+          // 导出
+          h(
+            "section",
+            { className: "ttl-transfer-section" },
+            h("h3", { className: "ttl-transfer-heading" }, t("transfer.exportTitle")),
+            h("p", { className: "ttl-transfer-hint" }, t("transfer.exportHint")),
+            h(
+              "div",
+              { className: "ttl-dialog-actions" },
+              h(
+                "button",
+                {
+                  type: "button",
+                  className: "ttl-button ttl-button-outline",
+                  disabled: busy === true,
+                  onClick: () => onExport("json")
+                },
+                t("transfer.exportJson")
+              ),
+              h(
+                "button",
+                {
+                  type: "button",
+                  className: "ttl-button ttl-button-outline",
+                  disabled: busy === true,
+                  onClick: () => onExport("csv")
+                },
+                t("transfer.exportCsv")
+              )
+            )
+          ),
+          // 导入
+          h(
+            "section",
+            { className: "ttl-transfer-section" },
+            h("h3", { className: "ttl-transfer-heading" }, t("transfer.importTitle")),
+            h("p", { className: "ttl-transfer-hint" }, t("transfer.importHint")),
+            h(
+              "div",
+              { className: "ttl-dialog-actions" },
+              h(
+                "button",
+                {
+                  type: "button",
+                  className: "ttl-button ttl-button-outline",
+                  disabled: busy === true,
+                  onClick: onPickFile
+                },
+                t("transfer.chooseFile")
+              ),
+              h(
+                "span",
+                { className: "ttl-transfer-file", title: typeof fileName === "string" ? fileName : "" },
+                typeof fileName === "string" && fileName !== "" ? fileName : t("transfer.noFile")
+              )
+            ),
+            h("input", {
+              ref: fileInputRef,
+              className: "ttl-file-input",
+              type: "file",
+              accept: ".json,.csv,application/json,text/csv",
+              tabIndex: -1,
+              "aria-label": t("transfer.chooseFile"),
+              onChange: onFileChange
+            }),
+            typeof error === "string" && error !== "" ? h("p", { className: "ttl-transfer-error", role: "alert" }, error) : null,
+            summary !== null ? h(
+              "div",
+              { className: "ttl-transfer-preview" },
+              h("div", { className: "ttl-transfer-preview-title" }, t("transfer.previewTitle")),
+              h(
+                "div",
+                { className: "ttl-transfer-counts" },
+                countChip("transfer.previewAdded", summary.added),
+                countChip("transfer.previewUpdated", summary.updated),
+                countChip("transfer.previewSkipped", summary.skipped),
+                Number(summary.removed) > 0 ? countChip("transfer.previewRemoved", summary.removed) : null,
+                countChip("transfer.previewTotal", summary.total)
+              ),
+              rowCount > 0 || invalidCount > 0 ? h(
+                "p",
+                { className: "ttl-transfer-rows" },
+                t("transfer.previewRows", { count: rowCount }),
+                invalidCount > 0 ? ` · ${t("transfer.previewInvalid", { count: invalidCount })}` : ""
+              ) : null,
+              invalid.length > 0 ? h(
+                "ul",
+                { className: "ttl-transfer-invalid" },
+                invalid.map((item, index) => h(
+                  "li",
+                  { key: `invalid-${index}` },
+                  t("transfer.rowError", {
+                    row: isRecord(item) ? Number(item.row) || 0 : 0,
+                    message: isRecord(item) && typeof item.message === "string" ? item.message : ""
+                  })
+                ))
+              ) : null,
+              h(
+                "div",
+                { className: "ttl-transfer-mode" },
+                h("span", { className: "ttl-transfer-mode-label" }, t("transfer.modeLabel")),
+                h(
+                  "select",
+                  {
+                    value: typeof mode === "string" ? mode : "merge",
+                    disabled: busy === true,
+                    "aria-label": t("transfer.modeLabel"),
+                    onChange: (event) => onModeChange(event.target.value)
+                  },
+                  TRANSFER_MODES.map((option) => h(
+                    "option",
+                    { key: option.value, value: option.value },
+                    t(option.labelKey)
+                  ))
+                )
+              ),
+              h("p", { className: "ttl-transfer-mode-hint" }, t(activeMode.hintKey))
+            ) : h(
+              "p",
+              { className: "ttl-transfer-empty" },
+              busy === true ? t("transfer.reading") : t("transfer.noPreview")
+            )
+          )
+        ),
+        h(
+          "div",
+          { className: "ttl-dialog-footer" },
+          h(
+            "button",
+            {
+              type: "button",
+              className: "ttl-button ttl-button-primary",
+              disabled: canConfirm !== true,
+              onClick: onConfirm
+            },
+            applying === true ? t("transfer.importing") : t("transfer.confirm")
+          )
+        )
+      )
+    );
+  }
+
   // src/client/panel.js
   function TodoPanel() {
     const [todos, setTodos] = React.useState([]);
@@ -4387,6 +4860,15 @@
     const [editTitle, setEditTitle] = React.useState("");
     const [confirmId, setConfirmId] = React.useState(null);
     const [notice, setNotice] = React.useState(null);
+    const [transferOpen, setTransferOpen] = React.useState(false);
+    const [transferBusy, setTransferBusy] = React.useState(false);
+    const [transferApplying, setTransferApplying] = React.useState(false);
+    const [transferError, setTransferError] = React.useState("");
+    const [transferFileName, setTransferFileName] = React.useState("");
+    const [transferContent, setTransferContent] = React.useState("");
+    const [transferMode, setTransferMode] = React.useState("merge");
+    const [transferPreview, setTransferPreview] = React.useState(null);
+    const [download, setDownload] = React.useState({ url: "", name: "" });
     const [expandedIds, setExpandedIds] = React.useState({});
     const [view, setView] = React.useState("table");
     const [range, setRange] = React.useState("all");
@@ -4447,6 +4929,8 @@
     const projectSeqRef = React.useRef(0);
     const suggestKindRef = React.useRef("file");
     const createBlurTimerRef = React.useRef(null);
+    const transferInputRef = React.useRef(null);
+    const downloadRef = React.useRef(null);
     React.useEffect(() => {
       mountedRef.current = true;
       return () => {
@@ -4472,6 +4956,21 @@
       }, delay);
       return () => clearTimeout(timer);
     }, [notice]);
+    React.useEffect(() => {
+      if (download.url === "" || downloadRef.current === null) return void 0;
+      downloadRef.current.click();
+      const url = download.url;
+      const timer = setTimeout(() => {
+        try {
+          if (typeof URL !== "undefined" && typeof URL.revokeObjectURL === "function") {
+            URL.revokeObjectURL(url);
+          }
+        } catch {
+        }
+        if (mountedRef.current) setDownload({ url: "", name: "" });
+      }, 2e3);
+      return () => clearTimeout(timer);
+    }, [download]);
     const loadList = React.useCallback(
       async (nextFilter, nextSortBy, nextDirection, nextProject, options) => {
         const quiet = Boolean(options && options.quiet);
@@ -5549,6 +6048,128 @@
         if (mountedRef.current) setBusyId(null);
       }
     };
+    const openTransfer = () => {
+      if (transferBusy) return;
+      setTransferError("");
+      setTransferPreview(null);
+      setTransferFileName("");
+      setTransferContent("");
+      setTransferMode("merge");
+      setTransferOpen(true);
+    };
+    const closeTransfer = () => {
+      if (transferBusy) return;
+      setTransferOpen(false);
+    };
+    const runImportPreview = async (content, mode) => {
+      setTransferBusy(true);
+      setTransferError("");
+      try {
+        const value = await request("/import", { content, mode, dryRun: true });
+        if (!mountedRef.current) return;
+        setTransferPreview(value);
+      } catch (error) {
+        if (!mountedRef.current) return;
+        setTransferPreview(null);
+        setTransferError(messageOf(error));
+      } finally {
+        if (mountedRef.current) setTransferBusy(false);
+      }
+    };
+    const handleTransferModeChange = (nextMode) => {
+      if (transferBusy || transferContent === "") return;
+      setTransferMode(nextMode);
+      void runImportPreview(transferContent, nextMode);
+    };
+    const handleExport = async (format) => {
+      if (transferBusy) return;
+      setTransferBusy(true);
+      setTransferError("");
+      try {
+        const value = await request("/export", { format });
+        if (!mountedRef.current) return;
+        setDownload(makeDownload(value.content, value.filename, value.mime));
+        showNotice("success", t("transfer.exported", {
+          count: Number(value.count) || 0,
+          format: String(value.format || format).toUpperCase()
+        }));
+        setTransferOpen(false);
+      } catch (error) {
+        if (!mountedRef.current) return;
+        setTransferError(messageOf(error));
+      } finally {
+        if (mountedRef.current) setTransferBusy(false);
+      }
+    };
+    const handlePickFile = () => {
+      const input = transferInputRef.current;
+      if (input && typeof input.click === "function") input.click();
+    };
+    const handleImportFileChange = async (event) => {
+      const target = event && event.target ? event.target : null;
+      const files = target && target.files ? target.files : null;
+      const file = files && files.length > 0 ? files[0] : null;
+      if (target) target.value = "";
+      if (file === null) return;
+      let content = "";
+      try {
+        content = await readFileText(file);
+      } catch (error) {
+        if (mountedRef.current) setTransferError(t("transfer.readError", { message: messageOf(error) }));
+        return;
+      }
+      if (!mountedRef.current) return;
+      if (content.trim() === "") {
+        setTransferPreview(null);
+        setTransferError(t("transfer.emptyFile"));
+        return;
+      }
+      setTransferFileName(typeof file.name === "string" ? file.name : "");
+      setTransferContent(content);
+      void runImportPreview(content, transferMode);
+    };
+    const handleRestoreBackup = async (backupFile) => {
+      if (typeof backupFile !== "string" || backupFile === "") return;
+      try {
+        const value = await request("/restore", { file: backupFile });
+        if (!mountedRef.current) return;
+        showNotice("success", notifyText(value, "transfer.undone"));
+        void fetchProjectSuggestions(workspaceRef.current, true);
+        await reload(true);
+      } catch (error) {
+        showNotice("error", messageOf(error));
+      }
+    };
+    const handleImportConfirm = async () => {
+      if (transferBusy || transferContent === "") return;
+      setTransferBusy(true);
+      setTransferApplying(true);
+      setTransferError("");
+      try {
+        const value = await request("/import", { content: transferContent, mode: transferMode });
+        if (!mountedRef.current) return;
+        setTransferOpen(false);
+        setTransferPreview(null);
+        setTransferContent("");
+        setTransferFileName("");
+        const backup = value && typeof value.backup === "string" ? value.backup : "";
+        showNotice("success", notifyText(value, "transfer.imported"), backup === "" ? void 0 : {
+          onClick: () => {
+            void handleRestoreBackup(backup);
+          }
+        });
+        void fetchProjectSuggestions(workspaceRef.current, true);
+        await reload(true);
+      } catch (error) {
+        if (!mountedRef.current) return;
+        setTransferError(messageOf(error));
+      } finally {
+        if (mountedRef.current) {
+          setTransferBusy(false);
+          setTransferApplying(false);
+        }
+      }
+    };
     const shiftCalendarMonth = (delta) => {
       const total = calendarYear * 12 + calendarMonth + delta;
       setCalendarYear(Math.floor(total / 12));
@@ -5898,6 +6519,15 @@
       "div",
       { className: "ttl-root", "data-dsh-todo-time-log": "panel", onKeyDown: handlePanelKeyDown },
       h(StyleSheet),
+      // 下载锚点：makeDownload() 生成 blob URL 后由 effect 通过 ref 点击。
+      h("a", {
+        ref: downloadRef,
+        className: "ttl-download-anchor",
+        href: download.url === "" ? void 0 : download.url,
+        download: download.name === "" ? void 0 : download.name,
+        "aria-hidden": "true",
+        tabIndex: -1
+      }),
       h(
         "div",
         { className: "ttl-scroll" },
@@ -5917,6 +6547,35 @@
             h(
               "div",
               { className: "ttl-heading-actions" },
+              h(
+                "button",
+                {
+                  type: "button",
+                  className: "ttl-ghost-button",
+                  "aria-haspopup": "dialog",
+                  "aria-expanded": transferOpen ? "true" : "false",
+                  title: t("transfer.open"),
+                  onClick: openTransfer
+                },
+                h(
+                  "svg",
+                  {
+                    className: "ttl-ghost-button-icon",
+                    width: 12,
+                    height: 12,
+                    viewBox: "0 0 16 16",
+                    fill: "none",
+                    stroke: "currentColor",
+                    strokeWidth: 1.4,
+                    strokeLinecap: "round",
+                    strokeLinejoin: "round",
+                    "aria-hidden": "true",
+                    focusable: "false"
+                  },
+                  h("path", { d: "M8 2v7m0 0l3-3m-3 3L5 6M3 12v1.5a.5.5 0 0 0 .5.5h9a.5.5 0 0 0 .5-.5V12" })
+                ),
+                t("transfer.open")
+              ),
               h(
                 "button",
                 {
@@ -6099,7 +6758,23 @@
             "×"
           )
         )
-      )
+      ),
+      h(TransferDialog, {
+        open: transferOpen,
+        busy: transferBusy,
+        applying: transferApplying,
+        fileName: transferFileName,
+        mode: transferMode,
+        preview: transferPreview,
+        error: transferError,
+        fileInputRef: transferInputRef,
+        onClose: closeTransfer,
+        onExport: handleExport,
+        onPickFile: handlePickFile,
+        onFileChange: handleImportFileChange,
+        onModeChange: handleTransferModeChange,
+        onConfirm: handleImportConfirm
+      })
     );
   }
   function createPanel() {