From 51dd5695ec30773204317028837bcafdeab2e3da Mon Sep 17 00:00:00 2001
From: teknium1 <127238744+teknium1@users.noreply.github.com>
Date: Tue, 7 Jul 2026 05:25:56 -0700
Subject: [PATCH] docs(i18n): add zh-Hans docs for Markdown/QMD session export

---
 .../current/user-guide/sessions.md            | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/sessions.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/sessions.md
index 60a6ab78f69..bcaac1277bf 100644
--- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/sessions.md
+++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/sessions.md
@@ -284,6 +284,29 @@ hermes sessions export session.jsonl --session-id 20250305_091523_a1b2c3d4
 
 导出文件每行包含一个 JSON 对象，包含完整的 session 元数据和所有消息。
 
+### 导出 Session 为 Markdown/QMD
+
+当你想在隐藏或删除旧 session 之前保留一份可读的文件归档时，传入 `--format md` 或 `--format qmd`。Markdown/QMD 导出会为每个 session 写入一个文件到目录中（默认：`~/.hermes/session-exports`）。
+
+```bash
+# 将单个 session 导出为 Markdown
+hermes sessions export --format md --session-id 20250305_091523_a1b2c3d4
+
+# 将压缩链（compression lineage）导出为一个逻辑文档
+hermes sessions export --format md --session-id 20250305_091523_a1b2c3d4 --lineage logical
+
+# 预览 90 天前已结束的 session，不写入文件
+hermes sessions export --format md --older-than 90 --dry-run
+
+# 将 30 天前已结束的 Telegram session 导出为 QMD 文件
+hermes sessions export --format qmd --older-than 30 --source telegram
+
+# 导出并在校验通过后删除一个明确指定的 session
+hermes sessions export --format md --session-id 20250305_091523_a1b2c3d4 --delete-after-verified --yes
+```
+
+Markdown/QMD 导出为每个 session 写入一个 `.md` 或 `.qmd` 文件，并附带一个 `manifest.jsonl`，记录文件路径、消息数量、lineage id 和 SHA-256。批量导出必须带过滤条件（如 `--older-than` 或 `--source`），不带过滤条件的批量导出会被拒绝。`--delete-after-verified` 仅限与 `--session-id` 搭配使用，且必须加 `--yes`。
+
 ### 删除 Session
 
 ```bash