@sparkelf/dsh-plugin-backup 0.1.0-rc.9 → 0.2.0-rc.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/plus/backup/README.md
-README.md: c4406cb9fcdc6c17fda28c087f287416c52adaa9
-README.zh.md: e7c3d7f6ed809f530772b6eeca23d8f363706c65
+README.md: 9779790a882ee3c85bda21914a77bf9048ec76b0
+README.zh.md: 9570b2eee62259f48ec41e9f0229b7116547dbbf

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-This complete Host and Client plugin exports a file-backed DSH home as a ZIP archive, validates and restores an uploaded archive, reopens Workspace storage, and contributes the localized Backup Settings section. Export, upload, and import stream through Host temporary files with bounded NDJSON progress; import validates the manifest, paths, and expanded byte total before Workspace mutation.
+This complete Host and Client plugin exports and restores three explicit user-data subsets: everything, configuration only, or sessions only. Configuration contains the active Settings document, credentials, optional `.env`, and anonymous identity; sessions contain Session logs, attachments, and storage-backed Workspace/projection state. Export, upload, and import stream through Host temporary files with bounded NDJSON progress; import validates the versioned manifest, scope, paths, and expanded byte total before mutation.
 
 ## Table of Contents
 
@@ -25,9 +25,11 @@ This complete Host and Client plugin exports a file-backed DSH home as a ZIP arc
 
 Mount the Host entry after `connection`, `webServer`, `settings`, and `workspaceRegistry`, and mount the Client entry after locale and Settings. The file-backed Settings provider supplies `settings.documentPath`; `maxUploadBytes` defaults to 2147483648 bytes.
 
-The authenticated routes are POST `/api/backup.export.prepare`, GET/HEAD `/api/backup.export`, POST `/api/backup.upload`, and POST `/api/backup.import`. Every route applies Connection Host, Origin, and browser-authentication policy before request data. Tokens expire after ten minutes and are single-use, except HEAD metadata inspection.
+The Settings section uses a three-way segmented control. **Everything** is the union of configuration and sessions; it does not archive generated profiles, releases, logs, Supervisor files, cached packages, or other runtime output. **Configuration** restores only configuration files and leaves Session/Workspace storage open. **Sessions** restores `sessions`, `attachments`, and `storages` together inside the Workspace storage-restore transaction. The archive manifest records the scope and active Settings filename; configuration-bearing archives require the same Settings filename at import.
 
-Once restore writes begin, closing the page does not interrupt replacement. Workspace storage closes around file replacement and reopens before completion; the UI then offers one explicit reload. Client failures remain visible in the Backup section without browser console errors.
+The authenticated routes are POST `/api/backup.export.prepare?scope=all|configuration|sessions`, GET/HEAD `/api/backup.export`, POST `/api/backup.upload`, and POST `/api/backup.import`. Every route applies Connection Host, Origin, and browser-authentication policy before request data. Browser cancellation settles only the active route and never terminates the Harness Host. Tokens expire after ten minutes and are single-use, except HEAD metadata inspection.
+
+Once restore writes begin, closing the page does not interrupt replacement. Workspace storage closes around file replacement and reopens before completion; the Client releases the completed progress stream reader before the UI offers one explicit reload. Client failures remain visible in the Backup section without browser console errors.
 
 -----
 
@@ -52,7 +54,8 @@ Independent. Export, import, progress, and reload do not change a model request
 
 <a id="known-limitations-and-deferred-work"></a>
 
-- **Overwrite without rollback**: restore replaces same-name files, retains files absent from the archive, and creates no rollback copy if a disk write fails after mutation begins.
+- **Overwrite without rollback**: restore replaces same-name files within the declared scope, retains files absent from the archive, and creates no rollback copy if a disk write fails after mutation begins.
+- **Current archive format only**: scoped archives use manifest version 2; pre-release version 1 archives are rejected instead of being guessed into a scope.
 
 <a id="dev-note"></a>
 ### Dev Note
@@ -63,5 +66,6 @@ Independent. Export, import, progress, and reload do not change a model request
 This Dev Note is working context for maintainers; shipped behavior, limits, and rationale live in the sections above, the package code, and the linked Agent Note.
 
 - The [Backup Agent Note](../../../.agents/notes/proposed/architecture/2026-08-30-plus-backup-plugin.md) owns archive, route, restore, and progress decisions; `src/index.ts` and `src/client/BackupSection.tsx` own current behavior.
+- No runtime invariant companion is published because WebServer owns route registration and Workspace owns filesystem state; Backup has no independent second observation of either relationship.
 
 </details>

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-该完整Host及Client plugin把file-backed DSH home导出为ZIP archive，验证并恢复uploaded archive，重新打开Workspace storage，并贡献localized Backup Settings section。Export、upload和import通过Host temporary files stream并提供bounded NDJSON progress；import会在Workspace mutation前验证manifest、paths及expanded byte total。
+该完整Host及Client plugin导出并恢复三种明确的user-data subset：全部、仅配置或仅会话。配置包含active Settings document、credentials、可选`.env`及anonymous identity；会话包含Session logs、attachments及storage-backed Workspace/projection state。Export、upload和import通过Host temporary files stream并提供bounded NDJSON progress；import会在mutation前验证versioned manifest、scope、paths及expanded byte total。
 
 ## 目录
 
@@ -25,9 +25,11 @@ kind: "package-reference"
 
 Host entry需mount在`connection`、`webServer`、`settings`及`workspaceRegistry`之后，Client entry需mount在locale及Settings之后。file-backed Settings provider提供`settings.documentPath`；`maxUploadBytes`默认为2147483648 bytes。
 
-authenticated routes为POST `/api/backup.export.prepare`、GET/HEAD `/api/backup.export`、POST `/api/backup.upload`及POST `/api/backup.import`。每条route会在读取request data前应用Connection Host、Origin及browser-authentication policy。Token在十分钟后过期并且single-use，HEAD metadata inspection除外。
+Settings section使用三段segmented control。**全部**是配置与会话的并集；它不归档generated profiles、releases、logs、Supervisor files、cached packages或其他runtime output。**配置**只恢复配置文件，不关闭Session/Workspace storage。**会话**把`sessions`、`attachments`及`storages`一起放进Workspace storage-restore transaction恢复。Archive manifest记录scope与active Settings filename；含配置的archive在import时要求相同Settings filename。
 
-一旦restore开始写入，关闭page不会中断replacement。Workspace storage会在file replacement期间关闭并在completion前重新打开；UI随后提供一次explicit reload。Client failure保留在Backup section可见状态，不产生browser console error。
+authenticated routes为POST `/api/backup.export.prepare?scope=all|configuration|sessions`、GET/HEAD `/api/backup.export`、POST `/api/backup.upload`及POST `/api/backup.import`。每条route会在读取request data前应用Connection Host、Origin及browser-authentication policy。Browser cancellation只结算当前route，绝不会终止Harness Host。Token在十分钟后过期并且single-use，HEAD metadata inspection除外。
+
+一旦restore开始写入，关闭page不会中断replacement。Workspace storage会在file replacement期间关闭并在completion前重新打开；Client会先释放completed progress stream reader，再由UI提供一次explicit reload。Client failure保留在Backup section可见状态，不产生browser console error。
 
 -----
 
@@ -52,7 +54,8 @@ authenticated routes为POST `/api/backup.export.prepare`、GET/HEAD `/api/backup
 
 <a id="known-limitations-and-deferred-work"></a>
 
-- **Overwrite without rollback**：restore会替换same-name files，保留archive中不存在的files，并且在mutation开始后disk write失败时不创建rollback copy。
+- **Overwrite without rollback**：restore会替换declared scope内的same-name files，保留archive中不存在的files，并且在mutation开始后disk write失败时不创建rollback copy。
+- **只接受当前archive format**：scoped archive使用manifest version 2；pre-release version 1 archive会被拒绝，不猜测其scope。
 
 <a id="dev-note"></a>
 ### 开发备注
@@ -63,5 +66,6 @@ authenticated routes为POST `/api/backup.export.prepare`、GET/HEAD `/api/backup
 该开发备注是maintainer working context；shipped behavior、limits及rationale以以上sections、package code及linked Agent Note为准。
 
 - [Backup Agent Note](../../../.agents/notes/proposed/architecture/2026-08-30-plus-backup-plugin.zh.md)持有archive、route、restore及progress decisions；`src/index.ts`和`src/client/BackupSection.tsx`持有current behavior。
+- 该package不发布`./invariant` companion，因为WebServer持有route registration，Workspace持有filesystem state；Backup没有对任一relation的independent second observation。
 
 </details>

package/lib/client.js

@@ -8,7 +8,7 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		let _deepseek_ai_dsh_client_store = require("@deepseek-ai/dsh-client-store");
 		//#region \0dsh-css:/home/runner/work/deepseek-harness-plus/deepseek-harness-plus/packages/plus/backup/src/client/BackupSection.module.css.mjs
-		const css = ".cY-W_a_section{flex-direction:column;gap:16px;display:flex}.cY-W_a_title{color:var(--dsw-alias-label-primary);margin:0;font-size:16px;font-weight:600}.cY-W_a_desc{color:var(--dsw-alias-label-secondary);margin:0;font-size:13px}.cY-W_a_actions{flex-wrap:wrap;align-items:center;gap:12px;display:flex}.cY-W_a_button{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);cursor:pointer;border-radius:8px;padding:8px 14px;font-size:13px}.cY-W_a_button:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.cY-W_a_button:disabled{opacity:.6;cursor:default}.cY-W_a_fileInput{display:none}.cY-W_a_progress{flex-direction:column;gap:8px;width:min(100%,480px);display:flex}.cY-W_a_progressLabel,.cY-W_a_progressDetail{margin:0;font-size:13px}.cY-W_a_progressLabel{color:var(--dsw-alias-label-primary);font-weight:500}.cY-W_a_progressDetail{color:var(--dsw-alias-label-secondary)}.cY-W_a_progressTrack{width:100%;height:8px;accent-color:var(--dsw-alias-state-business-primary);border:0}.cY-W_a_progressTrack::-webkit-progress-bar{background:var(--dsw-alias-border-l2);border-radius:4px}.cY-W_a_progressTrack::-webkit-progress-value{background:var(--dsw-alias-state-business-primary);border-radius:4px}.cY-W_a_progressTrack::-moz-progress-bar{background:var(--dsw-alias-state-business-primary);border-radius:4px}.cY-W_a_status{color:var(--dsw-alias-state-success-primary);margin:0;font-size:13px}.cY-W_a_error{color:var(--dsw-alias-state-error-primary);margin:0;font-size:13px}.cY-W_a_warning{color:var(--dsw-alias-state-warn-primary);margin:0;font-size:12px}";
+		const css = ".cY-W_a_section{flex-direction:column;gap:16px;display:flex}.cY-W_a_title{color:var(--dsw-alias-label-primary);margin:0;font-size:16px;font-weight:600}.cY-W_a_desc{color:var(--dsw-alias-label-secondary);margin:0;font-size:13px}.cY-W_a_scopeGroup{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);border-radius:6px;align-self:flex-start;padding:2px;display:inline-flex}.cY-W_a_scopeButton{min-width:72px;height:28px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:0;border-radius:4px;padding:0 10px;font-size:13px}.cY-W_a_scopeButton:hover:not(:disabled){color:var(--dsw-alias-label-primary)}.cY-W_a_scopeButton[aria-checked=true]{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1);box-shadow:0 1px 2px #0000001f}.cY-W_a_scopeButton:focus-visible{outline:1px solid var(--dsw-alias-state-business-primary);outline-offset:1px}.cY-W_a_scopeButton:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}.cY-W_a_actions{flex-wrap:wrap;align-items:center;gap:12px;display:flex}.cY-W_a_button{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);cursor:pointer;border-radius:8px;padding:8px 14px;font-size:13px}.cY-W_a_button:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.cY-W_a_button:disabled{opacity:.6;cursor:default}.cY-W_a_fileInput{display:none}.cY-W_a_progress{flex-direction:column;gap:8px;width:min(100%,480px);display:flex}.cY-W_a_progressLabel,.cY-W_a_progressDetail{margin:0;font-size:13px}.cY-W_a_progressLabel{color:var(--dsw-alias-label-primary);font-weight:500}.cY-W_a_progressDetail{color:var(--dsw-alias-label-secondary)}.cY-W_a_progressTrack{width:100%;height:8px;accent-color:var(--dsw-alias-state-business-primary);border:0}.cY-W_a_progressTrack::-webkit-progress-bar{background:var(--dsw-alias-border-l2);border-radius:4px}.cY-W_a_progressTrack::-webkit-progress-value{background:var(--dsw-alias-state-business-primary);border-radius:4px}.cY-W_a_progressTrack::-moz-progress-bar{background:var(--dsw-alias-state-business-primary);border-radius:4px}.cY-W_a_status{color:var(--dsw-alias-state-success-primary);margin:0;font-size:13px}.cY-W_a_error{color:var(--dsw-alias-state-error-primary);margin:0;font-size:13px}.cY-W_a_warning{color:var(--dsw-alias-state-warn-primary);margin:0;font-size:12px}";
 		const tagId = "@sparkelf/dsh-plugin-backup/BackupSection.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -27,6 +27,8 @@ window.__ModuleLoader__.load({
 			"progressDetail": "cY-W_a_progressDetail",
 			"progressLabel": "cY-W_a_progressLabel",
 			"progressTrack": "cY-W_a_progressTrack",
+			"scopeButton": "cY-W_a_scopeButton",
+			"scopeGroup": "cY-W_a_scopeGroup",
 			"section": "cY-W_a_section",
 			"status": "cY-W_a_status",
 			"title": "cY-W_a_title",
@@ -85,10 +87,18 @@ window.__ModuleLoader__.load({
 		/** Map one transport or archive rejection to product copy. */
 		function localize(caught, kind) {
 			const message = caught instanceof Error ? caught.message : String(caught);
-			if (message.includes("missing backup-manifest.json")) return "notBackup";
+			if (message.includes("backup-manifest.json")) return "notBackup";
 			if (message.includes("unsafe path")) return "unsafe";
 			return kind === "export" ? "exportFailed" : "importFailed";
 		}
+		function resultTextKey(result) {
+			if (result.kind === "exported") {
+				if (result.scope === "all") return "exportedAll";
+				return result.scope === "configuration" ? "exportedConfiguration" : "exportedSessions";
+			}
+			if (result.scope === "all") return "importedAll";
+			return result.scope === "configuration" ? "importedConfiguration" : "importedSessions";
+		}
 		/**
 		* The Backup section body.
 		* @param props - runtime owner props, locale, store seat, and streamed operation callbacks.
@@ -96,11 +106,12 @@ window.__ModuleLoader__.load({
 		*/
 		function BackupSection(props) {
 			const { t, actions } = props;
+			const scope = props.useStore((state) => state.scope);
 			const operation = props.useStore((state) => state.operation);
-			const status = props.useStore((state) => state.status);
+			const result = props.useStore((state) => state.result);
 			const error = props.useStore((state) => state.error);
 			const cancelling = props.useStore((state) => state.cancelling);
-			const reloadRequired = status === "imported";
+			const reloadRequired = result?.kind === "imported";
 			const fileRef = (0, react.useRef)(null);
 			const runExport = async () => {
 				actions.begin({
@@ -108,17 +119,20 @@ window.__ModuleLoader__.load({
 					progress: { phase: "scan" }
 				});
 				try {
-					const { downloadUrl } = await props.exportArchive((progress) => {
+					const exported = await props.exportArchive(scope, (progress) => {
 						actions.progress({
 							kind: "export",
 							progress
 						});
 					});
 					const anchor = document.createElement("a");
-					anchor.href = downloadUrl;
-					anchor.download = "deepseek-harness-backup.zip";
+					anchor.href = exported.downloadUrl;
+					anchor.download = exported.filename;
 					anchor.click();
-					actions.complete("exported");
+					actions.complete({
+						kind: "exported",
+						scope: exported.scope
+					});
 				} catch (caught) {
 					if (isCancellation(caught)) {
 						actions.cancelled();
@@ -141,13 +155,16 @@ window.__ModuleLoader__.load({
 				});
 				(async () => {
 					try {
-						await props.importArchive(file, (progress) => {
+						const imported = await props.importArchive(file, (progress) => {
 							actions.progress({
 								kind: "import",
 								progress
 							});
 						});
-						actions.complete("imported");
+						actions.complete({
+							kind: "imported",
+							scope: imported.scope
+						});
 					} catch (caught) {
 						if (isCancellation(caught)) {
 							actions.cancelled();
@@ -170,6 +187,26 @@ window.__ModuleLoader__.load({
 						className: BackupSection_module_css_default.desc,
 						children: t("desc")
 					}),
+					(0, react_jsx_runtime.jsx)("div", {
+						className: BackupSection_module_css_default.scopeGroup,
+						role: "radiogroup",
+						"aria-label": t("scopeLabel"),
+						children: [
+							"all",
+							"configuration",
+							"sessions"
+						].map((value) => (0, react_jsx_runtime.jsx)("button", {
+							type: "button",
+							role: "radio",
+							"aria-checked": scope === value,
+							className: BackupSection_module_css_default.scopeButton,
+							disabled: operation !== null || reloadRequired,
+							onClick: () => {
+								actions.selectScope(value);
+							},
+							children: t(value === "all" ? "scopeAll" : value === "configuration" ? "scopeConfiguration" : "scopeSessions")
+						}, value))
+					}),
 					(0, react_jsx_runtime.jsxs)("div", {
 						className: BackupSection_module_css_default.actions,
 						children: [
@@ -236,10 +273,10 @@ window.__ModuleLoader__.load({
 							})
 						]
 					}) : null,
-					status !== null ? (0, react_jsx_runtime.jsx)("p", {
+					result !== null ? (0, react_jsx_runtime.jsx)("p", {
 						className: BackupSection_module_css_default.status,
 						role: "status",
-						children: t(status)
+						children: t(resultTextKey(result))
 					}) : null,
 					reloadRequired ? (0, react_jsx_runtime.jsx)("button", {
 						type: "button",
@@ -263,7 +300,6 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region lib/types/client/store.js
-		/** Remount-surviving state for the Settings Backup slot registration. */
 		/**
 		* Declare the Backup section operation and result state.
 		* @returns the root-scoped store handle.
@@ -271,15 +307,21 @@ window.__ModuleLoader__.load({
 		function createBackupSectionStore() {
 			return (0, _deepseek_ai_dsh_client_store.defineStore)({
 				init: () => ({
+					scope: "all",
 					operation: null,
-					status: null,
+					result: null,
 					error: null,
 					cancelling: false
 				}),
 				actions: {
+					selectScope: (draft, scope) => {
+						draft.scope = scope;
+						draft.result = null;
+						draft.error = null;
+					},
 					begin: (draft, operation) => {
 						draft.operation = operation;
-						draft.status = null;
+						draft.result = null;
 						draft.error = null;
 						draft.cancelling = false;
 					},
@@ -293,15 +335,15 @@ window.__ModuleLoader__.load({
 						draft.operation = null;
 						draft.cancelling = false;
 					},
-					complete: (draft, status) => {
+					complete: (draft, result) => {
 						draft.operation = null;
-						draft.status = status;
+						draft.result = result;
 						draft.error = null;
 						draft.cancelling = false;
 					},
 					fail: (draft, error) => {
 						draft.operation = null;
-						draft.status = null;
+						draft.result = null;
 						draft.error = error;
 						draft.cancelling = false;
 					}
@@ -314,9 +356,13 @@ window.__ModuleLoader__.load({
 		const zh = {
 			nav: "备份",
 			title: "备份与恢复",
-			desc: "把用户设置和数据导出为一个 zip 压缩包，或从备份压缩包恢复。",
-			exportButton: "导出备份压缩包",
-			importButton: "选择压缩包并导入",
+			desc: "导出全部数据、仅配置或仅会话，也可以从对应备份包恢复。",
+			scopeLabel: "备份内容",
+			scopeAll: "全部",
+			scopeConfiguration: "配置",
+			scopeSessions: "会话",
+			exportButton: "导出所选内容",
+			importButton: "选择备份包并导入",
 			busyExport: "正在生成备份…",
 			busyImport: "正在导入备份…",
 			cancelButton: "取消",
@@ -327,11 +373,15 @@ window.__ModuleLoader__.load({
 			importUpload: "正在上传备份",
 			importValidate: "正在校验备份完整性…",
 			importRestore: "正在恢复备份",
-			importReload: "正在加载会话与工作区…",
+			importReload: "正在加载恢复的数据…",
 			importProgressLabel: "备份恢复进度",
 			progressDetail: "数据较多时可能需要几分钟，请保持此页面打开。",
-			exported: "备份已生成，浏览器已开始下载。",
-			imported: "备份已导入。重新加载页面后，会话和工作区将使用恢复后的数据。",
+			exportedAll: "完整备份已生成，浏览器已开始下载。",
+			exportedConfiguration: "配置备份已生成，浏览器已开始下载。",
+			exportedSessions: "会话备份已生成，浏览器已开始下载。",
+			importedAll: "完整备份已导入。重新加载后将使用恢复的配置、会话和工作区。",
+			importedConfiguration: "配置备份已导入。重新加载后将使用恢复的设置和凭据。",
+			importedSessions: "会话备份已导入。重新加载后将使用恢复的会话、附件和工作区。",
 			reloadButton: "重新加载页面",
 			notBackup: "所选压缩包不是 DeepSeek Harness 备份文件。",
 			unsafe: "备份压缩包包含不安全的条目路径。",
@@ -343,9 +393,13 @@ window.__ModuleLoader__.load({
 		const en = {
 			nav: "Backup",
 			title: "Backup and restore",
-			desc: "Export user settings and data as one zip archive, or restore them from a backup archive.",
-			exportButton: "Export backup archive",
-			importButton: "Choose archive and import",
+			desc: "Export everything, configuration only, or sessions only, and restore the corresponding archive.",
+			scopeLabel: "Backup contents",
+			scopeAll: "Everything",
+			scopeConfiguration: "Configuration",
+			scopeSessions: "Sessions",
+			exportButton: "Export selected contents",
+			importButton: "Choose backup and import",
 			busyExport: "Generating backup…",
 			busyImport: "Importing backup…",
 			cancelButton: "Cancel",
@@ -356,11 +410,15 @@ window.__ModuleLoader__.load({
 			importUpload: "Uploading backup",
 			importValidate: "Validating backup integrity…",
 			importRestore: "Restoring backup",
-			importReload: "Loading sessions and workspaces…",
+			importReload: "Loading restored data…",
 			importProgressLabel: "Backup restore progress",
 			progressDetail: "Large data sets may take several minutes; keep this page open.",
-			exported: "Backup generated; the browser download has started.",
-			imported: "Backup imported. Reload to apply the restored session and workspace data.",
+			exportedAll: "Complete backup generated; the browser download has started.",
+			exportedConfiguration: "Configuration backup generated; the browser download has started.",
+			exportedSessions: "Session backup generated; the browser download has started.",
+			importedAll: "Complete backup imported. Reload to apply the restored configuration, sessions, and workspaces.",
+			importedConfiguration: "Configuration backup imported. Reload to apply the restored settings and credentials.",
+			importedSessions: "Session backup imported. Reload to apply the restored sessions, attachments, and workspaces.",
 			reloadButton: "Reload page",
 			notBackup: "The selected archive is not a DeepSeek Harness backup file.",
 			unsafe: "The backup archive contains unsafe entry paths.",
@@ -391,6 +449,10 @@ window.__ModuleLoader__.load({
 			if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) throw new Error("invalid backup progress count");
 			return value;
 		}
+		function parseScope(value) {
+			if (value === "all" || value === "configuration" || value === "sessions") return value;
+			throw new Error("invalid backup scope");
+		}
 		/** Parse one Host-authored phase update from the exact-route stream. */
 		function parseHostProgress(value) {
 			const record = parseRecord(value);
@@ -416,14 +478,18 @@ window.__ModuleLoader__.load({
 			};
 			if (record.type === "export-ready") {
 				if (typeof record.downloadUrl !== "string" || record.downloadUrl === "") throw new Error("invalid backup export download URL");
+				if (typeof record.filename !== "string" || record.filename === "") throw new Error("invalid backup export filename");
 				return {
 					type: "export-ready",
 					downloadUrl: record.downloadUrl,
+					filename: record.filename,
+					scope: parseScope(record.scope),
 					entries: parseCount(record.entries)
 				};
 			}
 			if (record.type === "import-complete") return {
 				type: "import-complete",
+				scope: parseScope(record.scope),
 				entries: parseCount(record.entries)
 			};
 			if (record.type === "error" && typeof record.message === "string") return {
@@ -441,20 +507,24 @@ window.__ModuleLoader__.load({
 			let pending = "";
 			let terminal;
 			let terminalError;
-			while (true) {
-				const { done, value } = await reader.read();
-				pending += decoder.decode(value, { stream: !done });
-				const lines = pending.split(String.fromCharCode(10));
-				if (done) pending = "";
-				else pending = lines.pop();
-				for (const line of lines) {
-					if (line === "") continue;
-					const message = parseProgressLine(line);
-					if (message.type === "progress") report(message.progress);
-					else if (message.type === "error") terminalError = message.message;
-					else terminal = message;
+			try {
+				while (true) {
+					const { done, value } = await reader.read();
+					pending += decoder.decode(value, { stream: !done });
+					const lines = pending.split(String.fromCharCode(10));
+					if (done) pending = "";
+					else pending = lines.pop();
+					for (const line of lines) {
+						if (line === "") continue;
+						const message = parseProgressLine(line);
+						if (message.type === "progress") report(message.progress);
+						else if (message.type === "error") terminalError = message.message;
+						else terminal = message;
+					}
+					if (done) break;
 				}
-				if (done) break;
+			} finally {
+				reader.releaseLock();
 			}
 			if (terminalError !== void 0) throw new Error(terminalError);
 			if (terminal === void 0) throw new Error("backup progress response ended without a result");
@@ -543,14 +613,16 @@ window.__ModuleLoader__.load({
 				}
 			};
 			const injected = () => ({
-				exportArchive: (report) => runAbortable(async (signal) => {
-					const terminal = await readProgressResponse(await fetch(browserHostUrl("/api/backup.export.prepare"), {
+				exportArchive: (scope, report) => runAbortable(async (signal) => {
+					const terminal = await readProgressResponse(await fetch(browserHostUrl("/api/backup.export.prepare?scope=" + encodeURIComponent(scope)), {
 						method: "POST",
 						signal
 					}), report);
 					if (terminal.type !== "export-ready") throw new Error("backup export returned an import result");
 					return {
 						downloadUrl: browserHostUrl(terminal.downloadUrl),
+						filename: terminal.filename,
+						scope: terminal.scope,
 						entries: terminal.entries
 					};
 				}),
@@ -561,7 +633,10 @@ window.__ModuleLoader__.load({
 						signal
 					}), report);
 					if (terminal.type !== "import-complete") throw new Error("backup import returned an export result");
-					return { entries: terminal.entries };
+					return {
+						entries: terminal.entries,
+						scope: terminal.scope
+					};
 				}),
 				cancelOperation: () => {
 					activeController?.abort();

package/lib/index.js

@@ -1,9 +1,9 @@
-import { dirname, join } from "node:path";
+import { basename, dirname, join } from "node:path";
 import Schema from "@deepseek-ai/schemastery";
 import { randomUUID } from "node:crypto";
 import { once } from "node:events";
 import { createReadStream, createWriteStream } from "node:fs";
-import { mkdir, mkdtemp, readdir, rm, stat } from "node:fs/promises";
+import { mkdir, mkdtemp, readFile, readdir, rm, stat } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { Transform } from "node:stream";
 import { finished, pipeline } from "node:stream/promises";
@@ -18,8 +18,18 @@ import { open } from "yauzl";
 */
 /** Manifest entry at the archive root; import validation uses it as the marker. */
 const BACKUP_MANIFEST_ENTRY = "backup-manifest.json";
-/** Runtime-generated harness-home directories that are not user configuration or data. */
-const GENERATED_DIRECTORIES = new Set(["profiles", "supervisor"]);
+/** Optional configuration files stored beside the active Settings document. */
+const CONFIGURATION_FILES = [
+	".credentials.yaml",
+	".env",
+	".anonymous-user-id"
+];
+/** Durable Session data that must move together to preserve history and grouping. */
+const SESSION_DIRECTORIES = [
+	"sessions",
+	"attachments",
+	"storages"
+];
 /** File read and restore write size. */
 const BACKUP_CHUNK_BYTES = 64 * 1024;
 const EMPTY_BYTES = new Uint8Array(0);
@@ -38,7 +48,6 @@ async function planDirectory(rootPath, relativePath, entries, signal) {
 	for (const child of children) {
 		signal.throwIfAborted();
 		const entryRelative = relativePath === "" ? child.name : relativePath + "/" + child.name;
-		if (relativePath === "" && (GENERATED_DIRECTORIES.has(child.name) || child.name === BACKUP_MANIFEST_ENTRY)) continue;
 		if (child.isDirectory()) {
 			entries.push({
 				kind: "directory",
@@ -60,21 +69,48 @@ async function planDirectory(rootPath, relativePath, entries, signal) {
 /**
 * Build the stable file list and source-byte total used by one export.
 * @param dshHome - harness user data directory.
+* @param scope - selected user-data subset.
+* @param settingsFile - active Settings document basename.
 * @param signal - caller or response cancellation.
 * @returns the planned entries, manifest bytes, and measurable byte total.
 */
-async function planUserBackup(dshHome, signal) {
-	const manifest = strToU8(JSON.stringify({
+async function planUserBackup(dshHome, scope, settingsFile, signal) {
+	const manifestRecord = {
 		app: "deepseek-harness",
 		kind: "user-data-backup",
-		version: 1,
+		version: 2,
+		scope,
+		settingsFile,
 		exportedAt: (/* @__PURE__ */ new Date()).toISOString()
-	}, null, 2) + String.fromCharCode(10));
+	};
+	const manifest = strToU8(JSON.stringify(manifestRecord, null, 2) + String.fromCharCode(10));
 	const entries = [];
+	const topLevel = new Map((await readdir(dshHome, { withFileTypes: true })).map((entry) => [entry.name, entry]));
+	const names = [...scope === "all" || scope === "configuration" ? [settingsFile, ...CONFIGURATION_FILES] : [], ...scope === "all" || scope === "sessions" ? SESSION_DIRECTORIES : []];
+	let fileBytes = 0;
+	for (const name of new Set(names)) {
+		signal.throwIfAborted();
+		const entry = topLevel.get(name);
+		if (entry?.isDirectory()) {
+			entries.push({
+				kind: "directory",
+				relativePath: name
+			});
+			fileBytes += await planDirectory(dshHome, name, entries, signal);
+		} else if (entry?.isFile()) {
+			const { size } = await stat(join(dshHome, name));
+			entries.push({
+				kind: "file",
+				relativePath: name,
+				size
+			});
+			fileBytes += size;
+		}
+	}
 	return {
 		entries,
 		manifest,
-		totalBytes: await planDirectory(dshHome, "", entries, signal) + manifest.length
+		totalBytes: fileBytes + manifest.length
 	};
 }
 /**
@@ -118,13 +154,15 @@ async function addFileToZip(zip, rootPath, entry, waitForOutput, signal, onBytes
 * its partial archive.
 * @param dshHome - harness user data directory (settings.yaml parent).
 * @param targetPath - absolute file path the archive is written to.
+* @param scope - selected user-data subset.
+* @param settingsFile - active Settings document basename.
 * @param signal - caller or response cancellation.
 * @param report - ordered progress writer.
 * @returns the number of zip entries including the manifest marker.
 */
-async function writeUserBackup(dshHome, targetPath, signal, report) {
+async function writeUserBackup(dshHome, targetPath, scope, settingsFile, signal, report) {
 	await report({ phase: "scan" });
-	const plan = await planUserBackup(dshHome, signal);
+	const plan = await planUserBackup(dshHome, scope, settingsFile, signal);
 	let completedBytes = 0;
 	let lastPercent = -1;
 	const reportCompression = async () => {
@@ -200,6 +238,22 @@ async function writeUserBackup(dshHome, targetPath, signal, report) {
 		}
 	}
 }
+function isBackupScope(value) {
+	return value === "all" || value === "configuration" || value === "sessions";
+}
+function requireBackupManifest(value, settingsFile) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new Error("Backup archive has an invalid backup-manifest.json");
+	const manifest = value;
+	if (manifest.app !== "deepseek-harness" || manifest.kind !== "user-data-backup" || manifest.version !== 2 || !isBackupScope(manifest.scope) || typeof manifest.settingsFile !== "string" || typeof manifest.exportedAt !== "string") throw new Error("Backup archive has an unsupported backup-manifest.json");
+	if ((manifest.scope === "all" || manifest.scope === "configuration") && manifest.settingsFile !== settingsFile) throw new Error("Backup archive backup-manifest.json Settings filename does not match this DSH profile");
+	return manifest;
+}
+function scopeAllowsPath(scope, settingsFile, relativePath) {
+	const top = relativePath.split("/", 1)[0];
+	const configuration = relativePath === settingsFile || CONFIGURATION_FILES.includes(relativePath);
+	const sessions = SESSION_DIRECTORIES.includes(top);
+	return scope === "all" ? configuration || sessions : scope === "configuration" ? configuration : sessions;
+}
 function openArchive(path) {
 	return new Promise((resolveOpen, reject) => {
 		open(path, {
@@ -258,10 +312,11 @@ function requireSafeArchivePath(name) {
 * @param archivePath - disk-staged raw upload.
 * @param stagingRoot - temporary extraction root outside the harness home.
 * @param maxExpandedBytes - aggregate expanded-byte limit shared with upload admission.
+* @param settingsFile - active Settings document basename used to validate configuration archives.
 * @param signal - response cancellation honored until DSH-home mutation begins.
 * @returns the validated staged entry plan.
 */
-async function validateUserBackup(archivePath, stagingRoot, maxExpandedBytes, signal) {
+async function validateUserBackup(archivePath, stagingRoot, maxExpandedBytes, settingsFile, signal) {
 	const zip = await openArchive(archivePath);
 	const entries = [];
 	const names = /* @__PURE__ */ new Set();
@@ -309,11 +364,17 @@ async function validateUserBackup(archivePath, stagingRoot, maxExpandedBytes, si
 		zip.close();
 	}
 	if (!manifestSeen) throw new Error("Not a DeepSeek Harness user data backup: missing backup-manifest.json");
+	const manifest = requireBackupManifest(JSON.parse(await readFile(join(stagingRoot, BACKUP_MANIFEST_ENTRY), "utf8")), settingsFile);
+	for (const entry of entries) {
+		if (entry.relativePath === BACKUP_MANIFEST_ENTRY) continue;
+		if (!scopeAllowsPath(manifest.scope, settingsFile, entry.relativePath)) throw new Error(`Backup archive contains an unsafe path for its ${manifest.scope} scope: ${entry.relativePath}`);
+	}
 	return {
 		stagingRoot,
 		entries,
 		count: entries.length,
-		totalBytes
+		totalBytes,
+		scope: manifest.scope
 	};
 }
 /**
@@ -368,12 +429,14 @@ var BackupUploadTooLargeError = class extends Error {};
 /** Own one-use Host temp-file tokens and delete every file when its ownership ends. */
 var BackupTokenStore = class {
 	entries = /* @__PURE__ */ new Map();
-	mintDownload(path, size) {
+	mintDownload(path, size, filename, scope) {
 		this.sweep();
 		return this.mint({
 			kind: "download",
 			path,
 			size,
+			filename,
+			scope,
 			expiresAt: Date.now() + BACKUP_TOKEN_TTL_MS
 		});
 	}
@@ -469,7 +532,17 @@ function registerProtectedRoute(ctx, path, handler) {
 				response.end(rejection === 401 ? "unauthorized" : "forbidden");
 				return;
 			}
-			await handler(request, response);
+			try {
+				await handler(request, response);
+			} catch (error) {
+				if (request.destroyed || response.destroyed) {
+					console.info("[plus-backup] request cancelled", { path }, error);
+					return;
+				}
+				console.error("[plus-backup] route failed", { path }, error);
+				if (!response.headersSent) response.writeHead(500);
+				if (!response.writableEnded) response.end("backup request failed");
+			}
 		}
 	};
 	ctx.effect(() => ctx.webServer.register(route), `plus-backup: ${path} route`);
@@ -484,6 +557,17 @@ function tokenFromRequest(request) {
 	const token = new URL(request.url ?? "", "http://localhost").searchParams.get("token");
 	return token === null || token === "" ? void 0 : token;
 }
+function scopeFromRequest(request) {
+	const scope = new URL(request.url ?? "", "http://localhost").searchParams.get("scope");
+	return scope === "all" || scope === "configuration" || scope === "sessions" ? scope : void 0;
+}
+function backupFilename(scope) {
+	switch (scope) {
+		case "all": return "deepseek-harness-backup.zip";
+		case "configuration": return "deepseek-harness-configuration.zip";
+		case "sessions": return "deepseek-harness-sessions.zip";
+	}
+}
 async function writeProgressLine(response, line) {
 	if (response.destroyed) throw new Error("backup progress response closed");
 	if (!response.write(JSON.stringify(line) + String.fromCharCode(10))) await once(response, "drain");
@@ -502,7 +586,7 @@ function beginProgressResponse(response) {
 	return controller.signal;
 }
 function publicOperationError(error, operation) {
-	if (error instanceof Error && (error.message.includes("missing backup-manifest.json") || error.message.includes("unsafe path"))) return error.message;
+	if (error instanceof Error && (error.message.includes("backup-manifest.json") || error.message.includes("unsafe path"))) return error.message;
 	return "backup " + operation + " failed";
 }
 /** Stream one upload to disk; both declared and observed bytes share this ingress limit owner. */
@@ -536,22 +620,31 @@ async function stageUpload(request, response, tokens, maxUploadBytes) {
 		response.end(error instanceof BackupUploadTooLargeError ? "backup upload too large" : "backup upload failed");
 	}
 }
-async function prepareExport(request, response, tokens, dshHome) {
+async function prepareExport(request, response, tokens, dshHome, settingsFile) {
 	if (!requireMethod(request, response, ["POST"])) return;
+	const scope = scopeFromRequest(request);
+	if (scope === void 0) {
+		response.writeHead(400);
+		response.end("missing or invalid backup scope");
+		return;
+	}
 	const signal = beginProgressResponse(response);
 	const path = join(await mkdtemp(join(tmpdir(), "dsh-backup-export-")), "backup.zip");
 	let tokenMinted = false;
 	try {
-		const { entries } = await writeUserBackup(dshHome, path, signal, (progress) => writeProgressLine(response, {
+		const { entries } = await writeUserBackup(dshHome, path, scope, settingsFile, signal, (progress) => writeProgressLine(response, {
 			type: "progress",
 			progress
 		}));
 		const { size } = await stat(path);
-		const token = tokens.mintDownload(path, size);
+		const filename = backupFilename(scope);
+		const token = tokens.mintDownload(path, size, filename, scope);
 		tokenMinted = true;
 		await writeProgressLine(response, {
 			type: "export-ready",
 			downloadUrl: "/api/backup.export?token=" + token,
+			filename,
+			scope,
 			entries
 		});
 		response.end();
@@ -582,7 +675,7 @@ async function downloadExport(request, response, tokens) {
 	}
 	response.writeHead(200, {
 		"content-type": "application/zip",
-		"content-disposition": "attachment; filename=\"deepseek-harness-backup.zip\"",
+		"content-disposition": `attachment; filename="${entry.filename}"`,
 		"content-length": String(entry.size)
 	});
 	if (request.method === "HEAD") {
@@ -599,7 +692,7 @@ async function downloadExport(request, response, tokens) {
 	}
 }
 /** Validate before mutation, then complete restore even when the browser closes mid-write. */
-async function importBackup(ctx, request, response, tokens, dshHome, maxExpandedBytes) {
+async function importBackup(ctx, request, response, tokens, dshHome, maxExpandedBytes, settingsFile) {
 	if (!requireMethod(request, response, ["POST"])) return;
 	const token = tokenFromRequest(request);
 	if (token === void 0) {
@@ -634,17 +727,19 @@ async function importBackup(ctx, request, response, tokens, dshHome, maxExpanded
 	try {
 		signal.throwIfAborted();
 		await report({ phase: "validate" });
-		const validated = await validateUserBackup(staged.path, join(dirname(staged.path), "validated"), maxExpandedBytes, signal);
+		const validated = await validateUserBackup(staged.path, join(dirname(staged.path), "validated"), maxExpandedBytes, settingsFile, signal);
 		signal.throwIfAborted();
-		const { entries } = await ctx.workspaceRegistry.withStorageRestore(async () => {
+		const restore = async () => {
 			const restored = await restoreUserBackup(validated, dshHome, report);
 			await report({ phase: "reload" });
 			return restored;
-		});
+		};
+		const { entries } = validated.scope === "configuration" ? await restore() : await ctx.workspaceRegistry.withStorageRestore(restore);
 		if (response.destroyed) return;
 		await writeProgressLine(response, {
 			type: "import-complete",
-			entries
+			entries,
+			scope: validated.scope
 		});
 		response.end();
 	} catch (error) {
@@ -670,9 +765,9 @@ function registerBackupRoutes(ctx, config, dshHome) {
 	const tokens = new BackupTokenStore();
 	ctx.effect(() => () => tokens.dispose(), "plus-backup: temp files");
 	registerProtectedRoute(ctx, "/api/backup.upload", (request, response) => stageUpload(request, response, tokens, config.maxUploadBytes));
-	registerProtectedRoute(ctx, "/api/backup.export.prepare", (request, response) => prepareExport(request, response, tokens, dshHome));
+	registerProtectedRoute(ctx, "/api/backup.export.prepare", (request, response) => prepareExport(request, response, tokens, dshHome, config.settingsFile));
 	registerProtectedRoute(ctx, "/api/backup.export", (request, response) => downloadExport(request, response, tokens));
-	registerProtectedRoute(ctx, "/api/backup.import", (request, response) => importBackup(ctx, request, response, tokens, dshHome, config.maxUploadBytes));
+	registerProtectedRoute(ctx, "/api/backup.import", (request, response) => importBackup(ctx, request, response, tokens, dshHome, config.maxUploadBytes, config.settingsFile));
 }
 //#endregion
 //#region lib/types/index.js
@@ -695,7 +790,10 @@ const Config = Schema.object({ maxUploadBytes: Schema.number().step(1).min(1).de
 function apply(ctx, config = {}) {
 	const documentPath = ctx.settings.documentPath;
 	if (documentPath === void 0) throw new Error("plus-backup requires a file-backed settings provider");
-	registerBackupRoutes(ctx, { maxUploadBytes: config.maxUploadBytes ?? DEFAULT_MAX_UPLOAD_BYTES }, dirname(documentPath));
+	registerBackupRoutes(ctx, {
+		maxUploadBytes: config.maxUploadBytes ?? DEFAULT_MAX_UPLOAD_BYTES,
+		settingsFile: basename(documentPath)
+	}, dirname(documentPath));
 }
 //#endregion
 export { Config, apply, inject, name };

package/lib/types/archive.d.ts

@@ -5,17 +5,20 @@
  * while publishing restored-byte progress.
  */
 import type { BackupProgressReporter } from './protocol.ts';
+import type { BackupScope } from './types.ts';
 /**
  * Pack the harness home's user configuration and data into a zip archive,
  * publishing scan and source-byte compression progress. A failed export removes
  * its partial archive.
  * @param dshHome - harness user data directory (settings.yaml parent).
  * @param targetPath - absolute file path the archive is written to.
+ * @param scope - selected user-data subset.
+ * @param settingsFile - active Settings document basename.
  * @param signal - caller or response cancellation.
  * @param report - ordered progress writer.
  * @returns the number of zip entries including the manifest marker.
  */
-export declare function writeUserBackup(dshHome: string, targetPath: string, signal: AbortSignal, report: BackupProgressReporter): Promise<{
+export declare function writeUserBackup(dshHome: string, targetPath: string, scope: BackupScope, settingsFile: string, signal: AbortSignal, report: BackupProgressReporter): Promise<{
     entries: number;
 }>;
 /** One validated archive entry staged outside the harness home. */
@@ -37,16 +40,19 @@ export interface ValidatedUserBackup {
     count: number;
     /** Total regular-file bytes restored into the harness home. */
     totalBytes: number;
+    /** User-data subset declared by the validated manifest. */
+    scope: BackupScope;
 }
 /**
  * Validate and extract one staged zip without retaining archive or entry bodies in memory.
  * @param archivePath - disk-staged raw upload.
  * @param stagingRoot - temporary extraction root outside the harness home.
  * @param maxExpandedBytes - aggregate expanded-byte limit shared with upload admission.
+ * @param settingsFile - active Settings document basename used to validate configuration archives.
  * @param signal - response cancellation honored until DSH-home mutation begins.
  * @returns the validated staged entry plan.
  */
-export declare function validateUserBackup(archivePath: string, stagingRoot: string, maxExpandedBytes: number, signal: AbortSignal): Promise<ValidatedUserBackup>;
+export declare function validateUserBackup(archivePath: string, stagingRoot: string, maxExpandedBytes: number, settingsFile: string, signal: AbortSignal): Promise<ValidatedUserBackup>;
 /**
  * Write a validated staged archive over the harness home while publishing restored bytes.
  * Once file mutation begins the operation completes rather than honoring a late response

package/lib/types/client/BackupSection.d.ts

@@ -6,6 +6,7 @@ import type { ReactNode } from 'react';
 import type { InjectFace, PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
 import type { BackupSectionStore } from './store.ts';
 import type { BackupSectionProgress } from './types.ts';
+import type { BackupScope } from '../types.ts';
 /** Registration-side business face for the two streamed backup operations. */
 export interface BackupSectionInjected {
     /**
@@ -13,8 +14,10 @@ export interface BackupSectionInjected {
      * @param report - receives ordered progress updates.
      * @returns the single-use browser download URL and entry count.
      */
-    exportArchive(report: (progress: BackupSectionProgress) => void): Promise<{
+    exportArchive(scope: BackupScope, report: (progress: BackupSectionProgress) => void): Promise<{
         downloadUrl: string;
+        filename: string;
+        scope: BackupScope;
         entries: number;
     }>;
     /**
@@ -25,6 +28,7 @@ export interface BackupSectionInjected {
      */
     importArchive(file: File, report: (progress: BackupSectionProgress) => void): Promise<{
         entries: number;
+        scope: BackupScope;
     }>;
     /** Cancel the active operation while its current phase still permits cancellation. */
     cancelOperation(): void;

package/lib/types/client/locales.d.ts

@@ -2,9 +2,13 @@
 export declare const zh: {
     readonly nav: "备份";
     readonly title: "备份与恢复";
-    readonly desc: "把用户设置和数据导出为一个 zip 压缩包，或从备份压缩包恢复。";
-    readonly exportButton: "导出备份压缩包";
-    readonly importButton: "选择压缩包并导入";
+    readonly desc: "导出全部数据、仅配置或仅会话，也可以从对应备份包恢复。";
+    readonly scopeLabel: "备份内容";
+    readonly scopeAll: "全部";
+    readonly scopeConfiguration: "配置";
+    readonly scopeSessions: "会话";
+    readonly exportButton: "导出所选内容";
+    readonly importButton: "选择备份包并导入";
     readonly busyExport: "正在生成备份…";
     readonly busyImport: "正在导入备份…";
     readonly cancelButton: "取消";
@@ -15,11 +19,15 @@ export declare const zh: {
     readonly importUpload: "正在上传备份";
     readonly importValidate: "正在校验备份完整性…";
     readonly importRestore: "正在恢复备份";
-    readonly importReload: "正在加载会话与工作区…";
+    readonly importReload: "正在加载恢复的数据…";
     readonly importProgressLabel: "备份恢复进度";
     readonly progressDetail: "数据较多时可能需要几分钟，请保持此页面打开。";
-    readonly exported: "备份已生成，浏览器已开始下载。";
-    readonly imported: "备份已导入。重新加载页面后，会话和工作区将使用恢复后的数据。";
+    readonly exportedAll: "完整备份已生成，浏览器已开始下载。";
+    readonly exportedConfiguration: "配置备份已生成，浏览器已开始下载。";
+    readonly exportedSessions: "会话备份已生成，浏览器已开始下载。";
+    readonly importedAll: "完整备份已导入。重新加载后将使用恢复的配置、会话和工作区。";
+    readonly importedConfiguration: "配置备份已导入。重新加载后将使用恢复的设置和凭据。";
+    readonly importedSessions: "会话备份已导入。重新加载后将使用恢复的会话、附件和工作区。";
     readonly reloadButton: "重新加载页面";
     readonly notBackup: "所选压缩包不是 DeepSeek Harness 备份文件。";
     readonly unsafe: "备份压缩包包含不安全的条目路径。";

package/lib/types/client/store.d.ts

@@ -1,12 +1,14 @@
-/** Remount-surviving state for the Settings Backup slot registration. */
 import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
-import type { BackupErrorKey, BackupOperation, BackupSectionState, BackupStatusKey } from './types.ts';
+import type { BackupScope } from '../types.ts';
+import type { BackupErrorKey, BackupOperation, BackupResult, BackupSectionState } from './types.ts';
+/** Remount-surviving state for the Settings Backup slot registration. */
 type BackupSectionActions = {
+    selectScope: (draft: BackupSectionState, scope: BackupScope) => void;
     begin: (draft: BackupSectionState, operation: BackupOperation) => void;
     progress: (draft: BackupSectionState, operation: BackupOperation) => void;
     requestCancel: (draft: BackupSectionState) => void;
     cancelled: (draft: BackupSectionState) => void;
-    complete: (draft: BackupSectionState, status: BackupStatusKey) => void;
+    complete: (draft: BackupSectionState, result: BackupResult) => void;
     fail: (draft: BackupSectionState, error: BackupErrorKey) => void;
 };
 /** Store handle shared by each remount of the root-scoped Backup section. */

package/lib/types/client/types.d.ts

@@ -1,3 +1,4 @@
+import type { BackupScope } from '../types.ts';
 /** Browser presentation progress after parsing Host lines or upload events. */
 export type BackupSectionProgress = {
     /** Phase without a measurable byte total. */
@@ -15,14 +16,18 @@ export type BackupOperation = {
     kind: 'export' | 'import';
     progress: BackupSectionProgress;
 };
-/** Successful operation copy selected by the current locale. */
-export type BackupStatusKey = 'exported' | 'imported';
+/** Successful operation and the archive subset it affected. */
+export type BackupResult = {
+    kind: 'exported' | 'imported';
+    scope: BackupScope;
+};
 /** Failed operation copy selected by the current locale. */
 export type BackupErrorKey = 'notBackup' | 'unsafe' | 'exportFailed' | 'importFailed';
 /** Remount-surviving presentation state owned by the Backup slot registration. */
 export type BackupSectionState = {
+    scope: BackupScope;
     operation: BackupOperation | null;
-    status: BackupStatusKey | null;
+    result: BackupResult | null;
     error: BackupErrorKey | null;
     cancelling: boolean;
 };

package/lib/types/protocol.d.ts

@@ -1,4 +1,6 @@
 /** Host progress and terminal records for Plus user-data Backup routes. */
+import type { BackupScope } from './types.ts';
+export type { BackupScope } from './types.ts';
 /** Progress without a stable byte total while scanning, validating, or reloading. */
 type BackupOpenProgress = {
     phase: 'scan' | 'validate' | 'reload';
@@ -20,13 +22,15 @@ export type BackupProgressLine = {
 } | {
     type: 'export-ready';
     downloadUrl: string;
+    filename: string;
+    scope: BackupScope;
     entries: number;
 } | {
     type: 'import-complete';
+    scope: BackupScope;
     entries: number;
 } | {
     type: 'error';
     message: string;
 };
-export {};
 //# sourceMappingURL=protocol.d.ts.map

package/lib/types/routes.d.ts

@@ -9,6 +9,7 @@ export type BackupHostContext = Context & {
 /** Backup route resource policy. */
 export interface BackupRouteConfig {
     maxUploadBytes: number;
+    settingsFile: string;
 }
 /**
  * Register the complete authenticated Backup route set and its temp-file lifecycle.

package/lib/types/types.d.ts

@@ -0,0 +1,3 @@
+/** User-data subset represented by one Backup archive and restore operation. */
+export type BackupScope = 'all' | 'configuration' | 'sessions';
+//# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,83 +1,77 @@
 {
-  "name": "@sparkelf/dsh-plugin-backup",
+  "dependencies": {
+    "@deepseek-ai/schemastery": ">=3.18.1",
+    "fflate": "^0.8.2",
+    "yauzl": "^3.2.0"
+  },
   "description": "Full-stack Plus user-data Backup plugin with streamed Host archive routes and Settings UI",
-  "version": "0.1.0-rc.9",
-  "publishConfig": {
-    "access": "public"
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-workspace": "^0.1.5-rc.2",
+    "@types/react": "~18.3.1",
+    "@types/yauzl": "^2.10.3",
+    "react": "^18.2.0"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/SparkElf/deepseek-harness-plus.git",
-    "directory": "packages/plus/backup"
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-renderer"
+      ],
+      "platform": "web"
+    }
   },
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/types/index.d.ts",
   "exports": {
     ".": {
-      "types": "./lib/types/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
+      "default": "./lib/index.js",
+      "types": "./lib/types/index.d.ts"
     },
     "./client": {
-      "types": "./lib/types/client/index.d.ts",
-      "default": "./lib/client.js"
+      "default": "./lib/client.js",
+      "types": "./lib/types/client/index.d.ts"
     },
     "./package.json": "./package.json"
   },
   "files": [
     "lib/index.js",
-    "lib/invariant.js",
     "lib/client.js",
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
-  "dependencies": {
-    "@deepseek-ai/schemastery": ">=3.18.1",
-    "fflate": "^0.8.2",
-    "yauzl": "^3.2.0"
-  },
+  "main": "lib/index.js",
+  "name": "@sparkelf/dsh-plugin-backup",
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.2-alpha.1",
-    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.2-alpha.1",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.2-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.2-alpha.1",
-    "@deepseek-ai/dsh-host-webserver": ">=0.1.2-alpha.1",
-    "@deepseek-ai/dsh-invariants": ">=0.1.2-alpha.1",
-    "@deepseek-ai/dsh-settings": ">=0.1.2-alpha.1",
-    "@deepseek-ai/dsh-workspace": ">=0.1.2-alpha.1"
+    "@deepseek-ai/dsh-client-locale": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-host-webserver": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-settings": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-workspace": ">=0.1.5-rc.2"
   },
-  "devDependencies": {
-    "@types/react": "~18.3.1",
-    "@types/yauzl": "^2.10.3",
-    "react": "^18.2.0",
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.1",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.1",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.1",
-    "@deepseek-ai/dsh-workspace": "^0.1.2-alpha.1"
+  "publishConfig": {
+    "access": "public"
   },
-  "dsh": {
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-client-ui-renderer"
-      ],
-      "platform": "web"
-    }
+  "repository": {
+    "directory": "packages/plus/backup",
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git"
   },
   "scripts": {
     "bundle": "tsdown",
     "watch": "tsdown --watch"
-  }
-}
+  },
+  "type": "module",
+  "types": "lib/types/index.d.ts",
+  "version": "0.2.0-rc.1"
+}

package/lib/invariant.js

@@ -1,18 +0,0 @@
-//#region lib/types/invariant.js
-/** Package invariant companion for `@sparkelf/dsh-plugin-backup`. */
-const PACKAGE_NAME = "@sparkelf/dsh-plugin-backup";
-const name = "plus-backup-invariant";
-const inject = ["invariants"];
-/**
-* No runtime invariant: WebServer owns route registration, Workspace owns its
-* durable/cache relation, and the browser settings slot has no Host projection.
-*/
-const install = () => {};
-/**
-* Register this package's invariant companion.
-* @param ctx - Host context carrying the invariant registry.
-* @returns the registration disposer.
-*/
-const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//#endregion
-export { apply, inject, name };

package/lib/types/invariant.d.ts

@@ -1,11 +0,0 @@
-/** Package invariant companion for `@sparkelf/dsh-plugin-backup`. */
-import type { Context } from '@deepseek-ai/cordis';
-export declare const name = "plus-backup-invariant";
-export declare const inject: string[];
-/**
- * Register this package's invariant companion.
- * @param ctx - Host context carrying the invariant registry.
- * @returns the registration disposer.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map