dsh-archived-chats 0.6.0 → 0.7.0

package/README.md

@@ -16,7 +16,7 @@ Restart DSH once after installing, then open **Settings → Archived Chats**.
 
 ## Compatibility
 
-Version 0.6.0 is tested against DeepSeek Harness `0.1.0-rc.7`. The plugin registers a top-level `settings.section`, so the rc.7 keyed-slot change for `settings.plugin.item` does not apply to it. Future Harness releases should still be checked with the smoke suite and a real-host UI pass before publishing a plugin update, because client slot and design-token contracts may evolve.
+Version 0.7.0 is tested against DeepSeek Harness `0.1.0-rc.7`. The plugin registers a top-level `settings.section`, so the rc.7 keyed-slot change for `settings.plugin.item` does not apply to it. Future Harness releases should still be checked with the smoke suite and a real-host UI pass before publishing a plugin update, because client slot and design-token contracts may evolve.
 
 ## Features
 
@@ -24,7 +24,8 @@ Version 0.6.0 is tested against DeepSeek Harness `0.1.0-rc.7`. The plugin regist
 - **Search and sort** by title, workspace title, tags, and note text; filter by type (all / regular / subagent), project, and tag; then order results by newest, oldest, or title.
 - **Tags and notes**: open an editor from any row to attach up to 8 tags (24 Unicode characters each) and a note (2,000 Unicode characters). Tag chips render per row, overflowing past three into a `+N` indicator, and the tag filter narrows the list case-insensitively.
 - **Storage insights**: a summary strip reports the archived count, total measured size, and how many sessions could not be measured; each row shows its own size. Measurement never follows symbolic links and skips sessions whose directories are unreadable.
-- **Flexible multi-select**: select individual chats, every visible result, or an entire project. The selection bar can unarchive or permanently delete the chosen chats in one action, while selections hidden by another filter remain intact.
+- **JSON + Markdown backups**: export one row, the current selection, or every archived chat as a ZIP. Each package has a versioned manifest, a lossless machine-readable session record, and a human-readable transcript for every included session.
+- **Flexible multi-select**: select individual chats, every visible result, or an entire project. The selection bar can export, unarchive, or permanently delete the chosen chats in one action, while selections hidden by another filter remain intact.
 - **Unarchive** a single chat or a whole project group from the group's `⋯` menu — restored chats reappear in the sidebar immediately.
 - **Delete** one chat, a project group, or everything (**Delete All**), each behind a confirmation dialog. Deletion is thorough: the session log is removed from disk, the session is detached from its workspace record, and the registry's in-memory header index is purged, so the sidebar drops the rows live.
 - Sessions still resident in the background are **deleted in place too**: the plugin disposes the session through the official lifecycle teardown order (cancel → quiesce → flush → fiber teardown → registry detach), the persistence layer releases the write path, and the physical delete completes within the same request — no restart. If the running DSH build does not expose the required internal seams, the plugin falls back to "park permanently + delete on the next start", with parked sessions staying hidden meanwhile.
@@ -34,9 +35,24 @@ Version 0.6.0 is tested against DeepSeek Harness `0.1.0-rc.7`. The plugin regist
 
 Tags and notes live **only on your machine** in `$DSH_HOME/plugin-data/archived-chats/metadata.json` — they are never uploaded, synced, or sent anywhere else. Unarchiving a session keeps its metadata; a completed physical deletion removes it, while a deferred or failed deletion keeps it intact. Metadata and statistics failures are always non-blocking: the list, unarchive, and deletion keep working even when the metadata store is unreadable or a session directory cannot be measured.
 
+## Export and backup
+
+Every export is a local browser download. A single session and a batch use the same ZIP format:
+
+```text
+manifest.json
+sessions/001-<safe-title>-<id>/session.json
+sessions/001-<safe-title>-<id>/transcript.md
+```
+
+`session.json` is the authoritative backup record: it contains the complete metadata and event values returned by Harness persistence plus the archive title, workspace, timestamps, origin, tags, note, and storage facts. `transcript.md` is a readable companion derived with Harness's canonical message projection. ZIP paths are sanitized and collision-safe, and batches are generated one session at a time instead of buffering every transcript together.
+
+Attachment references remain in JSON, but **attachment bytes and descendant sessions are not included**. Use Harness's official Session log export when you need its attachment-complete conversation-tree package. Version 0.7.0 exports only; validated import/restore and conflict handling are planned for 0.8.0.
+
 ## How it works
 
-- **Host half** (`lib/index.js`) registers the `/plugins/dsh-archived-chats/*` routes on the DSH web server: `GET /state`, `GET /stats`, `POST /metadata`, `POST /unarchive`, `POST /unarchive-all`, `POST /delete`, `POST /delete-all`. `/state` joins tags, notes, and `metadataUpdatedAt` onto every row and reports `metadataStatus`; `/stats` returns per-session byte/file totals and a summary. Unarchiving writes through the workspace registry's own state path, so every connected client receives the `host/archived-sessions-changed` push. Mutating routes require a custom `x-dsh-archived-chats: 1` header as CSRF hardening.
+- **Host half** (`lib/index.js`) registers the `/plugins/dsh-archived-chats/*` routes on the DSH web server: `GET /state`, `GET /stats`, `POST /export`, `POST /metadata`, `POST /unarchive`, `POST /unarchive-all`, `POST /delete`, `POST /delete-all`. `/state` joins tags, notes, and `metadataUpdatedAt` onto every row; `/stats` returns byte/file totals; `/export` streams a ZIP response from a bounded native-form request. Unarchiving writes through the workspace registry's own state path, so every connected client receives the `host/archived-sessions-changed` push. Mutating routes require a custom `x-dsh-archived-chats: 1` header as CSRF hardening; read-only export does not mutate plugin or Harness state.
+- **Export writer** (`lib/export.js`): owns format-versioned records, safe filenames, Harness transcript projection, and sequential ZIP entries. It preflights the first session before response headers and keeps at most one inspected session payload during a batch.
 - **Metadata store** (`lib/metadata.js`): a versioned, atomic JSON store. Writes serialize through a queue and replace the file via a temp-file rename, so simultaneous saves cannot interleave; unreadable or unsupported files are never overwritten.
 - **Storage statistics** (`lib/stats.js`): measures session directories at concurrency 4, skips symbolic links, caches results for 30 seconds, and reports unavailable rows instead of failing the request. Delete invalidates the cached row.
 - **In-place live deletion**: deleting a resident session replays the agent factory's own disposer sequence — `cancel({ kind: 'disposed' })` → `whenIdle` → `flush` → `agent.scope.dispose()` → detach of the `agents` and `sessions` store entries. The session detach emits `session/disposed`, the persistence coordinator retires (drains and releases) the write path, and the ordinary cold delete completes in the same request. The store entries are internal surfaces, so every step is feature-detected; anything missing falls back to park-and-defer.
@@ -50,7 +66,7 @@ Tags and notes live **only on your machine** in `$DSH_HOME/plugin-data/archived-
 npm test
 ```
 
-The suite (`test/*.test.mjs`) covers the metadata store, the statistics service, and a host-and-browser smoke test. It uses an isolated temporary DSH home plus mocked host and browser runtimes; it never reads or changes real sessions.
+The suite (`test/*.test.mjs`) covers export records and real ZIP decoding, the metadata store, the statistics service, and host-and-browser smoke tests. It uses an isolated temporary DSH home plus mocked host and browser runtimes; it never reads or changes real sessions.
 
 ## Uninstall
 

package/README.zh.md

@@ -16,7 +16,7 @@ dsh plugin --profile web add dsh-archived-chats
 
 ## 兼容性
 
-0.6.0 版本以 DeepSeek Harness `0.1.0-rc.7` 为验证基线。插件注册的是顶层 `settings.section`，因此 rc.7 针对 `settings.plugin.item` 的 keyed-slot 变更不影响本插件。以后 Harness 发布新版本时，仍应在发布插件更新前重跑冒烟测试并检查真实宿主页面，因为客户端插槽和设计令牌契约仍可能演进。
+0.7.0 版本以 DeepSeek Harness `0.1.0-rc.7` 为验证基线。插件注册的是顶层 `settings.section`，因此 rc.7 针对 `settings.plugin.item` 的 keyed-slot 变更不影响本插件。以后 Harness 发布新版本时，仍应在发布插件更新前重跑冒烟测试并检查真实宿主页面，因为客户端插槽和设计令牌契约仍可能演进。
 
 ## 功能
 
@@ -24,7 +24,8 @@ dsh plugin --profile web add dsh-archived-chats
 - **搜索与排序**：按标题、项目名、标签和备注内容搜索，用类型（全部 / 普通会话 / 子代理会话）、项目和标签筛选，并按最新、最早或标题排序。
 - **标签与备注**：任意行打开编辑器即可添加最多 8 个标签（每个最多 24 个 Unicode 字符）和一条备注（最多 2,000 个 Unicode 字符）。每行渲染标签小徽章，超过 3 个折叠为 `+N`，标签筛选不区分大小写。
 - **存储统计**：概览条显示归档数量、已统计总大小与无法统计的会话数；每行显示各自占用。统计不会跟随符号链接，无法读取的会话目录显示为「无法统计」而非让请求失败。
-- **灵活多选**：逐条选择、选择当前筛选结果或选择整个项目；选中后可一次取消归档或永久删除，隐藏在其他筛选结果中的选择不会丢失。
+- **JSON + Markdown 备份**：可导出单条、当前选中项或全部归档会话。每个 ZIP 都包含带版本的清单、用于机器恢复的完整会话 JSON，以及方便阅读的 Markdown 对话稿。
+- **灵活多选**：逐条选择、选择当前筛选结果或选择整个项目；选中后可一次导出、取消归档或永久删除，隐藏在其他筛选结果中的选择不会丢失。
 - **取消归档**单个聊天，或从分组的 `⋯` 菜单整组取消——恢复的聊天会立刻回到侧边栏。
 - **删除**单个聊天、某个项目分组或全部（**全部删除**），均有确认弹窗。删除是彻底的：会话日志从磁盘移除、从工作区记录中摘除、注册表内存索引同步清理，主侧边栏的条目也会立即消失。
 - 仍驻留后台的会话也**当场删除**：插件按官方生命周期的拆除顺序原地停用并注销会话（取消 → 静默 → 落盘 → 拆纤程 → 摘出注册表），持久层随之释放写入通道，同一次请求内即完成物理删除——无需重启。若当前 DSH 版本不提供所需内部接口，则自动回退为「永久停用 + 下次启动完成删除」，停用期间会话保持隐藏。
@@ -34,9 +35,24 @@ dsh plugin --profile web add dsh-archived-chats
 
 标签和备注**只保存在本机**的 `$DSH_HOME/plugin-data/archived-chats/metadata.json` 中——不会被上传、同步或发送到任何其他地方。取消归档会保留元数据；物理删除完成后会移除它，而延后或失败的删除会保留它。元数据与统计失败永远不阻塞：即使元数据存储无法读取或某个会话目录无法统计，列表、取消归档和删除仍然可用。
 
+## 导出与备份
+
+导出只会触发本地浏览器下载。单条和批量使用同一种 ZIP 格式：
+
+```text
+manifest.json
+sessions/001-<安全标题>-<id>/session.json
+sessions/001-<安全标题>-<id>/transcript.md
+```
+
+`session.json` 是权威备份记录：原样保存 Harness 持久层返回的完整元数据和事件，并附带归档标题、工作区、时间、来源、标签、备注和存储统计。`transcript.md` 是通过 Harness 官方消息投影生成的可读副本。ZIP 路径会净化并处理重名，批量导出逐个会话生成，不会同时把所有会话内容堆进内存。
+
+JSON 会保留附件引用，但**本版不复制附件二进制，也不包含子会话**。需要带完整附件的会话树时，请使用 Harness 官方的 Session log 导出。0.7.0 只负责导出；经过校验的导入/恢复与冲突策略留到 0.8.0。
+
 ## 实现原理
 
-- **Host 半**（`lib/index.js`）在 DSH Web 服务器上注册 `/plugins/dsh-archived-chats/*` 路由：`GET /state`、`GET /stats`、`POST /metadata`、`POST /unarchive`、`POST /unarchive-all`、`POST /delete`、`POST /delete-all`。`/state` 会把标签、备注和 `metadataUpdatedAt` 拼到每一行，并上报 `metadataStatus`；`/stats` 返回每个会话的字节数/文件数与汇总。取消归档走 workspace registry 自身的状态写入通道，所有已连接的客户端都会收到 `host/archived-sessions-changed` 推送。写操作路由要求自定义请求头 `x-dsh-archived-chats: 1` 作为 CSRF 加固。
+- **Host 半**（`lib/index.js`）在 DSH Web 服务器上注册 `/plugins/dsh-archived-chats/*` 路由：`GET /state`、`GET /stats`、`POST /export`、`POST /metadata`、`POST /unarchive`、`POST /unarchive-all`、`POST /delete`、`POST /delete-all`。`/state` 拼接标签与备注，`/stats` 返回字节数/文件数，`/export` 从有界的原生表单请求流式返回 ZIP。取消归档走 workspace registry 自身的状态写入通道，所有已连接的客户端都会收到 `host/archived-sessions-changed` 推送。会改变状态的路由要求 `x-dsh-archived-chats: 1` 作为 CSRF 加固；只读导出不会修改插件或 Harness 状态。
+- **导出生成器**（`lib/export.js`）：负责带版本的备份记录、安全文件名、Harness 对话投影和顺序 ZIP 条目。首个会话会在发送响应头前预检，批量过程中最多保留一个已检查会话的载荷。
 - **元数据存储**（`lib/metadata.js`）：带版本号的原子 JSON 存储。写入通过队列串行化，并以临时文件重命名的方式替换原文件，因此并发保存不会互相交叠；无法读取或不支持的版本绝不被覆盖。
 - **存储统计**（`lib/stats.js`）：以并发 4 测量会话目录，跳过符号链接，结果缓存 30 秒，无法统计的会话上报为「不可用」而不是让请求失败。删除会使对应缓存失效。
 - **活会话原地删除**：删除仍驻留后台的会话时，插件复刻 agent 工厂自身 disposer 的顺序——`cancel({ kind: 'disposed' })` → `whenIdle` → `flush` → `agent.scope.dispose()` → 依次 detach `agents` 与 `sessions` 两个 store 条目；session detach 发出 `session/disposed`，持久化协调器随之 retire（排空并释放）该会话的写入通道，之后冷删除路径在同一请求内完成。所涉 store 条目属于内部接口，每一步都做特性探测，探测失败即回退为停用+延后。
@@ -50,7 +66,7 @@ dsh plugin --profile web add dsh-archived-chats
 npm test
 ```
 
-测试套件（`test/*.test.mjs`）覆盖元数据存储、统计服务以及宿主+浏览器的冒烟测试，使用隔离的临时 DSH 主目录和模拟的宿主/浏览器运行时，不会读取或修改真实会话。
+测试套件（`test/*.test.mjs`）覆盖导出记录与真实 ZIP 解包、元数据存储、统计服务以及宿主+浏览器冒烟测试，使用隔离的临时 DSH 主目录和模拟运行时，不会读取或修改真实会话。
 
 ## 卸载
 

package/lib/client.js

@@ -47,8 +47,12 @@ window.__ModuleLoader__.load({
 		const zh = {
 			"locale.intl": "zh-CN",
 			"nav": "已归档的聊天",
-			"page.title": "已归档的聊天",
-			"delete.all": "全部删除",
+				"page.title": "已归档的聊天",
+				"delete.all": "全部删除",
+				"export.all": "全部导出",
+				"export.selected": "导出选中项",
+				"export.row": "导出备份",
+				"export.started": "已开始下载备份",
 			"search.placeholder": "搜索已归档聊天",
 			"filter.allChats": "全部聊天",
 			"filter.normal": "普通会话",
@@ -99,8 +103,12 @@ window.__ModuleLoader__.load({
 		const en = {
 			"locale.intl": "en-US",
 			"nav": "Archived Chats",
-			"page.title": "Archived Chats",
-			"delete.all": "Delete All",
+				"page.title": "Archived Chats",
+				"delete.all": "Delete All",
+				"export.all": "Export all",
+				"export.selected": "Export selected",
+				"export.row": "Export backup",
+				"export.started": "Backup download started",
 			"search.placeholder": "Search archived chats",
 			"filter.allChats": "All chats",
 			"filter.normal": "Regular chats",
@@ -319,6 +327,10 @@ window.__ModuleLoader__.load({
 .dac-page{position:relative;display:flex;flex-direction:column;gap:14px;padding:4px 0 28px;font-family:inherit}
 .dac-head{display:flex;align-items:center;justify-content:space-between;gap:12px}
 .dac-title{margin:0;color:var(--dsw-alias-label-primary);font-size:18px;font-weight:500;line-height:28px;outline:none}
+.dac-head-actions{display:flex;align-items:center;justify-content:flex-end;gap:6px;flex-wrap:wrap}
+.dac-exportall{display:inline-flex;align-items:center;gap:6px;border:none;border-radius:999px;padding:6px 12px;background:transparent;color:var(--dsw-alias-label-secondary);font:inherit;font-size:13px;line-height:20px;cursor:pointer;transition:background .15s,color .15s}
+.dac-exportall:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover,rgba(127,127,127,.12));color:var(--dsw-alias-label-primary)}
+.dac-exportall:disabled{opacity:.45;cursor:default}
 .dac-deleteall{display:inline-flex;align-items:center;gap:6px;border:none;border-radius:999px;padding:6px 14px;background:transparent;color:var(--dsw-alias-state-error-primary);font:inherit;font-size:13px;line-height:20px;cursor:pointer;transition:background .15s}
 .dac-deleteall:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-danger)}
 .dac-deleteall:disabled{opacity:.45;cursor:default}
@@ -421,7 +433,7 @@ window.__ModuleLoader__.load({
 .dac-btn-primary{border:1px solid var(--dsw-alias-interactive-primary,#6e6ef7);border-radius:9px;background:var(--dsw-alias-interactive-primary,#6e6ef7);color:var(--dsw-alias-bg-layer-1);font:inherit;font-size:13px;line-height:20px;padding:5px 14px;cursor:pointer}
 .dac-btn-primary:hover:not(:disabled){opacity:.9}
 .dac-btn-primary:disabled{opacity:.5;cursor:default}
-@media (max-width:640px){[role="dialog"][data-dac-section-active="1"]>nav{display:none}[role="dialog"][data-dac-section-active="1"]>nav+div{width:100%;min-width:0}.dac-selection-toggle{margin-left:0}.dac-bulkbar{align-items:flex-start;flex-direction:column}.dac-bulk-actions{width:100%;flex-wrap:wrap}.dac-row{align-items:flex-start}.dac-row-actions{gap:4px}.dac-unarchive{padding:5px 10px}.dac-summary{gap:6px}.dac-row-meta{gap:4px}}
+@media (max-width:640px){[role="dialog"][data-dac-section-active="1"]>nav{display:none}[role="dialog"][data-dac-section-active="1"]>nav+div{width:100%;min-width:0}.dac-head{align-items:flex-start}.dac-head-actions{max-width:65%}.dac-selection-toggle{margin-left:0}.dac-bulkbar{align-items:flex-start;flex-direction:column}.dac-bulk-actions{width:100%;flex-wrap:wrap}.dac-row{align-items:flex-start}.dac-row-actions{gap:4px}.dac-unarchive{padding:5px 10px}.dac-summary{gap:6px}.dac-row-meta{gap:4px}}
 `;
 
 		function ensureStyle() {
@@ -519,9 +531,30 @@ window.__ModuleLoader__.load({
 			return res.json();
 		}
 
-		async function saveMetadata(sessionId, tags, note) {
-			return post("/metadata", { sessionId, tags, note });
-		}
+			async function saveMetadata(sessionId, tags, note) {
+				return post("/metadata", { sessionId, tags, note });
+			}
+
+			function submitExport(sessionIds) {
+				if (typeof document === "undefined") return false;
+				const ids = [...new Set((Array.isArray(sessionIds) ? sessionIds : [])
+					.filter((id) => typeof id === "string" && id !== ""))];
+				if (ids.length === 0) return false;
+				const form = document.createElement("form");
+				form.method = "POST";
+				form.action = `${API_BASE}/export`;
+				form.enctype = "application/x-www-form-urlencoded";
+				form.hidden = true;
+				const input = document.createElement("input");
+				input.type = "hidden";
+				input.name = "sessionIds";
+				input.value = JSON.stringify(ids);
+				form.appendChild(input);
+				document.body.appendChild(form);
+				form.submit();
+				setTimeout(() => form.remove(), 0);
+				return true;
+			}
 
 		async function post(path, body) {
 			const res = await fetch(`${API_BASE}${path}`, {
@@ -564,9 +597,12 @@ window.__ModuleLoader__.load({
 		function IconClose({ size = 12 }) {
 			return (0, jsx.jsx)("svg", { ...svgProps(size), children: (0, jsx.jsx)("path", { d: "M6 6l12 12M18 6 6 18" }) });
 		}
-		function IconCheckCircle({ size = 15 }) {
-			return (0, jsx.jsxs)("svg", { ...svgProps(size), children: [(0, jsx.jsx)("circle", { cx: 12, cy: 12, r: 9 }), (0, jsx.jsx)("path", { d: "m8.5 12.2 2.4 2.4 4.6-5" })] });
-		}
+			function IconCheckCircle({ size = 15 }) {
+				return (0, jsx.jsxs)("svg", { ...svgProps(size), children: [(0, jsx.jsx)("circle", { cx: 12, cy: 12, r: 9 }), (0, jsx.jsx)("path", { d: "m8.5 12.2 2.4 2.4 4.6-5" })] });
+			}
+			function IconDownload({ size = 15 }) {
+				return (0, jsx.jsxs)("svg", { ...svgProps(size), children: [(0, jsx.jsx)("path", { d: "M12 3v12" }), (0, jsx.jsx)("path", { d: "m7 10 5 5 5-5" }), (0, jsx.jsx)("path", { d: "M5 20h14" })] });
+			}
 		const EDIT_ICON_SPEC = {
 			size: 16,
 			viewBox: "0 0 1024 1024",
@@ -805,7 +841,7 @@ window.__ModuleLoader__.load({
 			});
 		}
 
-		function GroupSection({ group, t, collapsed, onToggleCollapsed, menuOpen, onToggleMenu, onUnarchive, onDelete, busy, selected, onToggleSelected, stats, metadataStatus, onEditMetadata }) {
+			function GroupSection({ group, t, collapsed, onToggleCollapsed, menuOpen, onToggleMenu, onUnarchive, onDelete, onExport, busy, selected, onToggleSelected, stats, metadataStatus, onEditMetadata }) {
 			const wrapRef = _react.useRef(null);
 			_react.useEffect(() => {
 				if (!menuOpen) return void 0;
@@ -926,6 +962,14 @@ window.__ModuleLoader__.load({
 											onClick: () => onEditMetadata(session),
 											children: (0, jsx.jsx)(IconEdit, {})
 										}),
+										(0, jsx.jsx)("button", {
+											type: "button",
+											className: "dac-iconbtn",
+											"aria-label": t("export.row"),
+											disabled: busy[session.id] === true,
+											onClick: () => onExport([session.id]),
+											children: (0, jsx.jsx)(IconDownload, {})
+										}),
 										(0, jsx.jsx)("button", {
 											type: "button",
 											className: "dac-iconbtn dac-danger",
@@ -1139,7 +1183,7 @@ window.__ModuleLoader__.load({
 				setMetadataEdit(session);
 			};
 
-			const saveMetadataFor = async (sessionId, tags, note) => {
+				const saveMetadataFor = async (sessionId, tags, note) => {
 				setNotice(null);
 				setMetaBusy(true);
 				try {
@@ -1158,7 +1202,12 @@ window.__ModuleLoader__.load({
 				} finally {
 					setMetaBusy(false);
 				}
-			};
+				};
+
+				const exportSessions = (ids) => {
+					if (!submitExport(ids)) return;
+					setNotice({ kind: "ok", text: t("export.started") });
+				};
 
 			const projects = _react.useMemo(() => {
 				const seen = new Map();
@@ -1238,8 +1287,9 @@ window.__ModuleLoader__.load({
 			const selectedVisibleCount = visibleIds.filter((id) => selected.has(id)).length;
 			const allVisibleSelected = visibleIds.length > 0 && selectedVisibleCount === visibleIds.length;
 			const someVisibleSelected = selectedVisibleCount > 0 && !allVisibleSelected;
-			const selectedBusy = selectedIds.some((id) => busy[id] === true);
-			const visibleBusy = visibleIds.some((id) => busy[id] === true);
+				const selectedBusy = selectedIds.some((id) => busy[id] === true);
+				const visibleBusy = visibleIds.some((id) => busy[id] === true);
+				const allBusy = allIds.some((id) => busy[id] === true);
 				const filtering = query.trim() !== "" || projectFilter !== "all" || typeFilter !== "all" || tagFilter !== "";
 
 			return (0, jsx.jsxs)("div", {
@@ -1250,19 +1300,31 @@ window.__ModuleLoader__.load({
 						className: "dac-head",
 						children: [
 							(0, jsx.jsx)("h2", { ref: pageHeadingRef, tabIndex: -1, className: "dac-title", children: t("page.title") }),
-							(0, jsx.jsxs)("button", {
-								type: "button",
-								className: "dac-deleteall",
-								disabled: allIds.length === 0,
-								onClick: () => askDelete(allIds, void 0),
-								children: [(0, jsx.jsx)(IconTrash, {}), (0, jsx.jsx)("span", { children: t("delete.all") })]
-							})
+								(0, jsx.jsxs)("div", {
+									className: "dac-head-actions",
+									children: [
+										selectedIds.length === 0 && (0, jsx.jsxs)("button", {
+											type: "button",
+											className: "dac-exportall",
+											disabled: allIds.length === 0 || allBusy,
+											onClick: () => exportSessions(allIds),
+											children: [(0, jsx.jsx)(IconDownload, {}), (0, jsx.jsx)("span", { children: t("export.all") })]
+										}),
+										(0, jsx.jsxs)("button", {
+											type: "button",
+											className: "dac-deleteall",
+											disabled: allIds.length === 0,
+											onClick: () => askDelete(allIds, void 0),
+											children: [(0, jsx.jsx)(IconTrash, {}), (0, jsx.jsx)("span", { children: t("delete.all") })]
+										})
+									]
+								})
 						]
 					}),
 					(0, jsx.jsxs)("div", {
 						className: "dac-summary",
-						role: "status",
-						children: [
+							role: "status",
+							children: [
 							(0, jsx.jsx)("span", { children: chatsCount(t, (sessions ?? []).length) }),
 							(0, jsx.jsx)("span", { className: "dac-summary-sep", "aria-hidden": "true", children: "·" }),
 							(0, jsx.jsx)("span", { children: summarySizeText(t, stats) }),
@@ -1349,8 +1411,15 @@ window.__ModuleLoader__.load({
 						children: [
 							(0, jsx.jsx)("span", { className: "dac-bulk-count", children: selectedCount(t, selectedIds.length) }),
 							(0, jsx.jsxs)("div", {
-								className: "dac-bulk-actions",
-								children: [
+									className: "dac-bulk-actions",
+									children: [
+										(0, jsx.jsx)("button", {
+											type: "button",
+											className: "dac-bulk-btn",
+											disabled: selectedBusy,
+											onClick: () => exportSessions(selectedIds),
+											children: t("export.selected")
+										}),
 									(0, jsx.jsx)("button", {
 										type: "button",
 										className: "dac-bulk-btn",
@@ -1407,8 +1476,9 @@ window.__ModuleLoader__.load({
 						onToggleCollapsed: toggleCollapsed,
 						menuOpen: menuFor === group.key,
 						onToggleMenu: setMenuFor,
-						onUnarchive: unarchive,
-						onDelete: askDelete,
+							onUnarchive: unarchive,
+							onDelete: askDelete,
+							onExport: exportSessions,
 						busy,
 						selected,
 						onToggleSelected: toggleSelected,
@@ -1471,7 +1541,7 @@ window.__ModuleLoader__.load({
 		//#endregion
 
 		exports.SETTINGS_NS = SETTINGS_NS;
-		exports.__test = { formatBytes, matchesArchivedSession, filterByTag, sortArchivedSessions, setVisibleSelection, reconcileSelection, markArchiveDialog, editIconSpec: EDIT_ICON_SPEC };
+		exports.__test = { formatBytes, matchesArchivedSession, filterByTag, sortArchivedSessions, setVisibleSelection, reconcileSelection, markArchiveDialog, submitExport, editIconSpec: EDIT_ICON_SPEC };
 		exports.apply = apply;
 		exports.inject = inject;
 		return module.exports;

package/lib/export.js

@@ -0,0 +1,349 @@
+import {
+  deriveEventMessage,
+  isAppendSurfaceEvent,
+} from '@deepseek-ai/dsh-session';
+import ZipStream from 'zip-stream';
+
+const EXPORT_FORMAT = 'dsh-archived-chats/export';
+const SESSION_FORMAT = 'dsh-archived-chats/session';
+const TRANSCRIPT_FORMAT = 'dsh-archived-chats/transcript';
+const FORMAT_VERSION = 1;
+const RESERVED_BASENAME = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/i;
+
+function codePoints(value) {
+  return [...value];
+}
+
+/** Normalize untrusted text into one cross-platform archive path segment. */
+export function safeSegment(value, fallback = 'untitled', maxLength = 80) {
+  const limit = Number.isInteger(maxLength) && maxLength > 0 ? maxLength : 80;
+  let segment = typeof value === 'string' ? value.normalize('NFKC') : '';
+  segment = segment
+    .replace(/[\u0000-\u001f\u007f<>:"/\\|?*\s]+/g, '-')
+    .replace(/\.{2,}/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^[. -]+|[. -]+$/g, '');
+
+  if (segment === '') segment = String(fallback).normalize('NFKC');
+  if (RESERVED_BASENAME.test(segment)) segment = `${segment}-file`;
+
+  segment = codePoints(segment).slice(0, limit).join('')
+    .replace(/^[. -]+|[. -]+$/g, '');
+  if (segment === '') return 'untitled';
+  if (RESERVED_BASENAME.test(segment)) return `${segment}-file`;
+  return segment;
+}
+
+function nullableString(value) {
+  return typeof value === 'string' ? value : null;
+}
+
+function nullableNumber(value) {
+  return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+
+function normalizeStorage(storage) {
+  if (storage?.status === 'ready'
+    && Number.isFinite(storage.sizeBytes)
+    && Number.isFinite(storage.fileCount)) {
+    return {
+      status: 'ready',
+      sizeBytes: storage.sizeBytes,
+      fileCount: storage.fileCount,
+    };
+  }
+  return { status: 'unavailable', sizeBytes: null, fileCount: null };
+}
+
+function normalizeDescriptor(descriptor) {
+  return {
+    id: descriptor.id,
+    title: nullableString(descriptor.title),
+    workspace: {
+      id: nullableString(descriptor.workspaceId),
+      title: nullableString(descriptor.workspaceTitle),
+    },
+    createdAt: nullableNumber(descriptor.createdAt),
+    origin: nullableString(descriptor.origin),
+    metadataUpdatedAt: nullableString(descriptor.metadataUpdatedAt),
+    tags: Array.isArray(descriptor.tags)
+      ? descriptor.tags.filter((tag) => typeof tag === 'string')
+      : [],
+    note: nullableString(descriptor.note),
+    storage: normalizeStorage(descriptor.storage),
+  };
+}
+
+function safeIdSuffix(id) {
+  const safe = safeSegment(id, 'session', 160);
+  return codePoints(safe).slice(-8).join('');
+}
+
+function uniqueDirectory(base, used) {
+  let candidate = base;
+  let suffix = 2;
+  while (used.has(candidate.toLocaleLowerCase('en-US'))) {
+    candidate = `${base}-${suffix}`;
+    suffix += 1;
+  }
+  used.add(candidate.toLocaleLowerCase('en-US'));
+  return candidate;
+}
+
+/** Build stable filenames and normalized descriptors for an export request. */
+export function planExport(descriptors, exportedAt = new Date()) {
+  const instant = exportedAt instanceof Date ? exportedAt : new Date(exportedAt);
+  if (Number.isNaN(instant.getTime())) throw new TypeError('exportedAt must be a valid date');
+
+  const seenIds = new Set();
+  const usedDirectories = new Set();
+  const items = [];
+  for (const descriptor of Array.isArray(descriptors) ? descriptors : []) {
+    if (descriptor === null || typeof descriptor !== 'object' || typeof descriptor.id !== 'string') continue;
+    if (seenIds.has(descriptor.id)) continue;
+    seenIds.add(descriptor.id);
+
+    const archive = normalizeDescriptor(descriptor);
+    const index = String(items.length + 1).padStart(3, '0');
+    const title = safeSegment(archive.title, 'untitled', 80);
+    const leaf = uniqueDirectory(`${index}-${title}-${safeIdSuffix(archive.id)}`, usedDirectories);
+    const directory = `sessions/${leaf}`;
+    items.push({
+      ...archive,
+      directory,
+      files: {
+        json: `${directory}/session.json`,
+        markdown: `${directory}/transcript.md`,
+      },
+    });
+  }
+
+  const date = instant.toISOString().slice(0, 10);
+  const filename = items.length === 1
+    ? `dsh-archived-chat-${safeSegment(items[0].title, 'untitled', 60)}-${date}.zip`
+    : `dsh-archived-chats-${items.length}-${date}.zip`;
+  return { exportedAt: instant.toISOString(), filename, items };
+}
+
+function manifestSession(item) {
+  return {
+    id: item.id,
+    title: item.title,
+    workspace: item.workspace,
+    createdAt: item.createdAt,
+    origin: item.origin,
+    metadataUpdatedAt: item.metadataUpdatedAt,
+    tags: item.tags,
+    note: item.note,
+    storage: item.storage,
+    files: item.files,
+  };
+}
+
+/** Create the authoritative inventory for one ZIP package. */
+export function createManifest(plan, generatorVersion) {
+  return {
+    format: EXPORT_FORMAT,
+    version: FORMAT_VERSION,
+    exportedAt: plan.exportedAt,
+    generator: { name: 'dsh-archived-chats', version: generatorVersion },
+    sessionCount: plan.items.length,
+    attachmentsIncluded: false,
+    sessions: plan.items.map(manifestSession),
+  };
+}
+
+/** Create one lossless session record around Harness persistence output. */
+export function createSessionRecord(item, inspected, exportedAt) {
+  return {
+    format: SESSION_FORMAT,
+    version: FORMAT_VERSION,
+    exportedAt,
+    archive: manifestSession(item),
+    source: {
+      meta: inspected?.meta ?? null,
+      events: inspected?.events ?? [],
+    },
+  };
+}
+
+function yamlValue(value) {
+  return value === null || value === undefined ? 'null' : JSON.stringify(value);
+}
+
+function jsonText(value) {
+  try {
+    const rendered = JSON.stringify(value, null, 2);
+    return rendered === undefined ? String(value) : rendered;
+  } catch {
+    return String(value);
+  }
+}
+
+function fenced(language, value) {
+  const text = String(value);
+  const runs = text.match(/`+/g) ?? [];
+  const width = Math.max(3, ...runs.map((run) => run.length + 1));
+  const fence = '`'.repeat(width);
+  return `${fence}${language}\n${text}\n${fence}`;
+}
+
+function renderImage(block) {
+  const attachment = block?.attachment ?? {};
+  const name = typeof attachment.name === 'string' && attachment.name !== ''
+    ? attachment.name
+    : 'unnamed image';
+  const details = [
+    attachment.mediaType,
+    Number.isFinite(attachment.width) && Number.isFinite(attachment.height)
+      ? `${attachment.width}x${attachment.height}`
+      : null,
+    Number.isFinite(attachment.bytes) ? `${attachment.bytes} bytes` : null,
+    attachment.attachmentId,
+  ].filter((value) => value !== null && value !== undefined && value !== '');
+  return `[Image: ${name}${details.length > 0 ? ` - ${details.join(', ')}` : ''}]`;
+}
+
+function renderContentBlock(block) {
+  if (block === null || typeof block !== 'object') return fenced('json', jsonText(block));
+  switch (block.type) {
+    case 'text':
+      return typeof block.text === 'string' ? block.text : fenced('json', jsonText(block));
+    case 'reasoning':
+      return `### Reasoning\n\n${fenced('text', typeof block.text === 'string' ? block.text : jsonText(block))}`;
+    case 'image':
+      return renderImage(block);
+    case 'tool-call': {
+      const name = typeof block.name === 'string' && block.name !== '' ? block.name : 'unknown';
+      const args = typeof block.arguments === 'string' ? block.arguments : jsonText(block.arguments);
+      return `### Tool call: ${name}\n\nCall ID: \`${String(block.id ?? 'unknown')}\`\n\n${fenced('json', args)}`;
+    }
+    case 'tool-result': {
+      const status = block.isError === true ? ' (error)' : '';
+      const nested = Array.isArray(block.content)
+        ? block.content.map(renderContentBlock).filter(Boolean).join('\n\n')
+        : fenced('json', jsonText(block.content));
+      return `### Tool result \`${String(block.toolCallId ?? 'unknown')}\`${status}\n\n${nested}`;
+    }
+    default:
+      return fenced('json', jsonText(block));
+  }
+}
+
+function messageLabel(message) {
+  if (message?.source?.kind === 'tool') return 'Tool result';
+  if (message?.role === 'assistant') return 'Assistant';
+  if (message?.role === 'user') return 'User';
+  return 'System';
+}
+
+/** Render the durable human transcript from append-origin Harness messages. */
+export function renderTranscript(item, events, exportedAt) {
+  const lines = [
+    '---',
+    `format: ${yamlValue(TRANSCRIPT_FORMAT)}`,
+    `version: ${FORMAT_VERSION}`,
+    `exportedAt: ${yamlValue(exportedAt)}`,
+    `id: ${yamlValue(item.id)}`,
+    `title: ${yamlValue(item.title)}`,
+    `workspaceId: ${yamlValue(item.workspace.id)}`,
+    `workspaceTitle: ${yamlValue(item.workspace.title)}`,
+    `createdAt: ${yamlValue(item.createdAt)}`,
+    `origin: ${yamlValue(item.origin)}`,
+    `tags: ${yamlValue(item.tags)}`,
+    `note: ${yamlValue(item.note)}`,
+    `metadataUpdatedAt: ${yamlValue(item.metadataUpdatedAt)}`,
+    '---',
+    '',
+    `# ${item.title ?? 'Untitled archived chat'}`,
+  ];
+
+  for (const event of Array.isArray(events) ? events : []) {
+    if (!isAppendSurfaceEvent(event)) continue;
+    const message = deriveEventMessage(event);
+    if (message === null) continue;
+    const timestamp = Number.isFinite(event.time)
+      ? ` - ${new Date(event.time).toISOString()}`
+      : '';
+    const content = Array.isArray(message.content)
+      ? message.content.map(renderContentBlock).filter(Boolean).join('\n\n')
+      : fenced('json', jsonText(message.content));
+    lines.push('', `## ${messageLabel(message)}${timestamp}`, '', content);
+  }
+
+  return `${lines.join('\n').replace(/\n{4,}/g, '\n\n\n')}\n`;
+}
+
+function formattedJson(value) {
+  return `${JSON.stringify(value, null, 2)}\n`;
+}
+
+function addZipEntry(archive, source, name, date) {
+  return new Promise((resolve, reject) => {
+    archive.entry(source, { name, date }, (error) => {
+      if (error) reject(error);
+      else resolve();
+    });
+  });
+}
+
+/**
+ * Create a sequential ZIP stream. The first inspection happens before the
+ * stream is returned so HTTP callers can still send an ordinary error status.
+ */
+export async function createExportZip({ plan, inspect, generatorVersion }) {
+  if (!Array.isArray(plan?.items) || plan.items.length === 0) {
+    throw new TypeError('export plan must contain at least one session');
+  }
+  if (typeof inspect !== 'function') throw new TypeError('inspect must be a function');
+
+  let firstInspection = await inspect(plan.items[0].id);
+  const archive = new ZipStream({ level: 9 });
+  const entryDate = new Date(plan.exportedAt);
+
+  const completion = new Promise((resolve, reject) => {
+    archive.once('end', resolve);
+    archive.once('error', reject);
+  });
+
+  const write = async () => {
+    await addZipEntry(
+      archive,
+      formattedJson(createManifest(plan, generatorVersion)),
+      'manifest.json',
+      entryDate,
+    );
+
+    for (let index = 0; index < plan.items.length; index += 1) {
+      const item = plan.items[index];
+      let inspected = index === 0 ? firstInspection : await inspect(item.id);
+      await addZipEntry(
+        archive,
+        formattedJson(createSessionRecord(item, inspected, plan.exportedAt)),
+        item.files.json,
+        entryDate,
+      );
+      await addZipEntry(
+        archive,
+        renderTranscript(item, inspected?.events, plan.exportedAt),
+        item.files.markdown,
+        entryDate,
+      );
+      inspected = null;
+      if (index === 0) firstInspection = null;
+    }
+    archive.finalize();
+  };
+
+  void write().catch((error) => {
+    archive.destroy(error);
+  });
+
+  return {
+    stream: archive,
+    completion,
+    abort(error = new Error('export aborted')) {
+      archive.destroy(error);
+    },
+  };
+}

package/lib/index.js

@@ -10,6 +10,8 @@
  *                                                     store are excluded).
  *   GET  /plugins/dsh-archived-chats/stats          → storage totals for
  *                                                     visible archived sessions.
+ *   POST /plugins/dsh-archived-chats/export         → streamed JSON + Markdown
+ *                                                     backup ZIP.
  *   POST /plugins/dsh-archived-chats/metadata       → { sessionId, tags, note }
  *   POST /plugins/dsh-archived-chats/unarchive      → { sessionId }
  *   POST /plugins/dsh-archived-chats/unarchive-all  → { sessionIds: [...] }
@@ -69,6 +71,7 @@ import { dirname, join } from 'node:path';
 import { homedir } from 'node:os';
 import { createMetadataStore, MetadataStoreError } from './metadata.js';
 import { createStatsService } from './stats.js';
+import { createExportZip, planExport } from './export.js';
 
 /** Cordis plugin name. */
 export const name = 'archived-chats';
@@ -83,6 +86,7 @@ const PERSISTENCE_KEYS = ['sessionPersistence'];
 const ROUTE_PREFIX = '/plugins/dsh-archived-chats';
 /** Custom header required on POSTs: cheap CSRF hardening for a loopback UI. */
 const GUARD_HEADER = 'x-dsh-archived-chats';
+const PLUGIN_VERSION = '0.7.0';
 
 //#region wire helpers
 /** Read and JSON-parse a request body (empty body → {}). */
@@ -100,6 +104,61 @@ function readBody(req) {
     });
 }
 
+const EXPORT_BODY_LIMIT = 512 * 1024;
+const EXPORT_SESSION_LIMIT = 2000;
+
+/** Parse a bounded native-form export selection and preserve first-seen order. */
+function readExportSelection(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let bytes = 0;
+        let settled = false;
+        const fail = (message, status = 400) => {
+            if (settled) return;
+            settled = true;
+            reject(Object.assign(new Error(message), { status }));
+        };
+        req.on('data', (chunk) => {
+            if (settled) return;
+            const bytesChunk = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+            bytes += bytesChunk.length;
+            if (bytes > EXPORT_BODY_LIMIT) {
+                fail('export request body is too large', 413);
+                return;
+            }
+            chunks.push(bytesChunk);
+        });
+        req.on('end', () => {
+            if (settled) return;
+            try {
+                const params = new URLSearchParams(Buffer.concat(chunks).toString('utf8'));
+                const encoded = params.get('sessionIds');
+                if (encoded === null) throw new Error('sessionIds is required');
+                const submitted = JSON.parse(encoded);
+                if (!Array.isArray(submitted) || submitted.length === 0) {
+                    throw new Error('sessionIds must be a non-empty array');
+                }
+                if (submitted.some((id) => typeof id !== 'string' || id === '')) {
+                    throw new Error('sessionIds must contain non-empty strings');
+                }
+                const ids = [...new Set(submitted)];
+                if (ids.length > EXPORT_SESSION_LIMIT) {
+                    throw new Error(`sessionIds cannot contain more than ${EXPORT_SESSION_LIMIT} unique ids`);
+                }
+                settled = true;
+                resolve(ids);
+            } catch (error) {
+                fail(String(error?.message ?? error));
+            }
+        });
+        req.on('error', (error) => {
+            if (settled) return;
+            settled = true;
+            reject(error);
+        });
+    });
+}
+
 /** Send one JSON response. */
 function send(res, status, value) {
     res.writeHead(status, {
@@ -109,6 +168,24 @@ function send(res, status, value) {
     res.end(JSON.stringify(value));
 }
 
+function sendText(res, status, text) {
+    res.writeHead(status, {
+        'content-type': 'text/plain; charset=utf-8',
+        'cache-control': 'no-store',
+        'x-content-type-options': 'nosniff',
+    });
+    res.end(text);
+}
+
+function contentDisposition(filename) {
+    const ascii = filename
+        .replace(/[^\x20-\x7e]/g, '_')
+        .replace(/["\\]/g, '_');
+    const encoded = encodeURIComponent(filename)
+        .replace(/['()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`);
+    return `attachment; filename="${ascii}"; filename*=UTF-8''${encoded}`;
+}
+
 /** Guard mutating routes behind a custom header (cross-site forms cannot set one). */
 function guard(req, res) {
     if (req.method !== 'POST') {
@@ -512,6 +589,84 @@ function registerRoutes(ctx, webServer, registry, persistence, titleCache, metad
         },
     }), 'archived-chats: stats route');
 
+    ctx.effect(() => webServer.register({
+        kind: 'exact',
+        path: `${ROUTE_PREFIX}/export`,
+        handler: async (req, res) => {
+            if (req.method !== 'POST') {
+                sendText(res, 405, 'method-not-allowed');
+                return;
+            }
+            try {
+                const ids = await readExportSelection(req);
+                const pending = await pendingStore.load();
+                const visible = new Set(registry.archivedSessionIds
+                    .map(String)
+                    .filter((id) => !pending.has(id)));
+                if (ids.some((id) => !visible.has(id))) {
+                    sendText(res, 404, 'session-not-archived');
+                    return;
+                }
+                const state = await listArchived(ctx, registry, persistence, titleCache, metadataStore, pendingStore);
+                const rows = new Map(state.sessions.map((row) => [row.id, row]));
+                if (ids.some((id) => !rows.has(id))) {
+                    sendText(res, 404, 'session-not-archived');
+                    return;
+                }
+                let stats;
+                try {
+                    stats = await statsService.measure(ids);
+                } catch (error) {
+                    ctx.logger.warn(`archived-chats: export storage measurement unavailable: ${String(error?.code ?? error?.name ?? 'Error')}`);
+                    stats = { sessions: {} };
+                }
+                const descriptors = ids.map((id) => ({
+                    ...rows.get(id),
+                    storage: stats.sessions?.[id] ?? {
+                        status: 'unavailable',
+                        sizeBytes: null,
+                        fileCount: null,
+                    },
+                }));
+                const plan = planExport(descriptors, new Date());
+                const zip = await createExportZip({
+                    plan,
+                    inspect: (id) => persistence.inspect(id),
+                    generatorVersion: PLUGIN_VERSION,
+                });
+                let aborted = false;
+                const abort = () => {
+                    aborted = true;
+                    zip.abort(Object.assign(new Error('export client disconnected'), { code: 'export-aborted' }));
+                };
+                req.once?.('aborted', abort);
+                res.writeHead(200, {
+                    'content-type': 'application/zip',
+                    'content-disposition': contentDisposition(plan.filename),
+                    'cache-control': 'no-store',
+                    'x-content-type-options': 'nosniff',
+                });
+                zip.stream.pipe(res);
+                try {
+                    await zip.completion;
+                } finally {
+                    req.off?.('aborted', abort);
+                }
+                if (aborted) return;
+            } catch (error) {
+                if (res.headersSent || res.status === 200) {
+                    ctx.logger.warn(`archived-chats: export stream failed: ${String(error?.code ?? error?.name ?? 'Error')}`);
+                    res.destroy?.();
+                    return;
+                }
+                const status = error.status ?? (error instanceof SyntaxError || error instanceof TypeError ? 400 : 500);
+                sendText(res, status, status === 413
+                    ? 'request-too-large'
+                    : (status === 400 ? 'invalid-export-request' : 'export-failed'));
+            }
+        },
+    }), 'archived-chats: export route');
+
     ctx.effect(() => webServer.register({
         kind: 'exact',
         path: `${ROUTE_PREFIX}/metadata`,

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

@@ -1,8 +1,8 @@
 /**
  * Browser client entry — the Archived Chats settings section. Renders the
  * summary strip, tag/type/project filters, per-row tag chips and storage
- * sizes, and an accessible tags/note editor, all localized in English and
- * 中文.
+ * sizes, single/batch backup actions, and an accessible tags/note editor,
+ * all localized in English and 中文.
  */
 export declare const SETTINGS_NS: string;
 export declare function apply(ctx: unknown): void;

package/lib/types/index.d.ts

@@ -1,9 +1,9 @@
 /**
- * Host loader entry — registers the seven `/plugins/dsh-archived-chats/*`
- * routes (state, stats, metadata, unarchive, unarchive-all, delete,
- * delete-all) and wires archive insights: per-session tags/notes joined into
- * `/state`, storage statistics from `/stats`, and guarded metadata mutation
- * through `/metadata`.
+ * Host loader entry — registers the eight `/plugins/dsh-archived-chats/*`
+ * routes (state, stats, export, metadata, unarchive, unarchive-all, delete,
+ * delete-all), streams JSON/Markdown backup ZIPs, and wires archive insights:
+ * per-session tags/notes joined into `/state`, storage statistics from
+ * `/stats`, and guarded metadata mutation through `/metadata`.
  */
 export declare function apply(ctx: unknown): void;
 export declare const name: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-archived-chats",
-  "version": "0.6.0",
-  "description": "DeepSeek Harness 已归档会话管理页：标签、备注与存储统计，加上搜索、排序、批量选择、取消归档和删除。An Archived Chats settings page for DeepSeek Harness with tags, notes, storage insights, search, sorting, bulk selection, unarchive, and delete.",
+  "version": "0.7.0",
+  "description": "DeepSeek Harness 已归档会话管理页：JSON/Markdown ZIP 备份、标签、备注、存储统计、搜索、批量操作、取消归档和删除。Archived Chats management with JSON/Markdown ZIP backups, metadata, storage insights, search, bulk actions, unarchive, and delete.",
   "license": "MIT",
   "author": "Ultronen",
   "repository": {
@@ -39,6 +39,7 @@
   "files": [
     "lib/index.js",
     "lib/client.js",
+    "lib/export.js",
     "lib/metadata.js",
     "lib/stats.js",
     "lib/types",
@@ -58,7 +59,14 @@
     }
   },
   "peerDependencies": {
-    "react": "^18.2.0",
-    "@deepseek-ai/cordis": "^4.0.1"
+    "@deepseek-ai/cordis": "^4.0.1",
+    "react": "^18.2.0"
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.7",
+    "zip-stream": "^7.0.5"
+  },
+  "devDependencies": {
+    "fflate": "^0.8.3"
   }
 }